| | 30 | |
| | 31 | == Documentation == |
| | 32 | |
| | 33 | If a package "foo" provides documentation (which it should, of course), in many cases that can be provided in different formats: |
| | 34 | |
| | 35 | * html documentation is preferred and should be installed into <prefix>/documentation/html/foo |
| | 36 | * man-pages is the preferred format for terminal and should be installed into the corresponding folders in <prefix>/documentation/man/ |
| | 37 | * info files are provided by many packages, if at all desirable, they should be installed into <prefix>documentation/info/. |
| | 38 | One problem with info files is that all packages currently contain a file named <prefix>/documentation/info/dir, which supposedly is the list of all available info files, but since each package provides an instance of this file containing only its own info files, an arbitrary dir file is made visible via packagefs. |
