Package: debian-policy Version: 3.5.2.0 Severity: wishlist * /usr/X11R6 is part of the FHS, so it is wrong for Debian Policy to imply that it isn't; this fixes that * this still tells packages to get out of /usr/X11R6 if they can * this makes an exemption for imake-using packages explicit, and explains why in a footnote --- policy.sgml Sun Mar 25 01:34:33 2001 +++ policy.sgml.x-and-fhs Sun Mar 25 03:34:00 2001 @@ -6172,36 +6172,45 @@ </p> <p> - <em>Packages using the X Window System should abide by the FHS - standard whenever possible</em>; they should install binaries, - libraries, manual pages, and other files in FHS-mandated - locations wherever possible. This means that files must - not be installed into <tt>/usr/X11R6/bin/</tt>, - <tt>/usr/X11R6/lib/</tt>, or <tt>/usr/X11R6/man/</tt> unless - this is necessary for the package to operate properly. + <em>Packages using the X Window System should not be configured + to install files under the <tt>/usr/X11R6/</tt> directory unless + they use <tt>imake</tt>.</em> The <tt>/usr/X11R6/</tt> directory + hierarchy should be regarded as deprecated for all packages + except the X Window System itself, and those which use the + <tt>imake</tt> program it provides. + <footnote> + Imake-using programs are exempt because -- if they are + written correctly -- the pathnames they use to locate + resources and install themselves are derived wholly from + the X Window System configuration. Thus, in the event that + the X Window System moves to <tt>/usr/X11R7/</tt>, + <tt>/usr/X12/</tt>, or just plain <tt>/usr/</tt>, all that + is required for these programs is a recompile against the + corresponding X Window System library development packages. + </footnote> + Programs that use GNU autoconf and automake are usually easily + configured at compile time to use <tt>/usr/</tt> instead of + <tt>/usr/X11R6/</tt>, and this should be done whenever possible. Configuration files for window managers and display managers should be placed in a subdirectory of <tt>/etc/X11/</tt> - corresponding to the package name due to these programs' - tight integration with the mechanisms of the X Window - System. Application-level programs should use the - <tt>/etc/</tt> directory unless otherwise mandated by - policy. The installation of files into subdirectories of - <tt>/usr/X11R6/include/X11/</tt> and - <tt>/usr/X11R6/lib/X11/</tt> is permitted but discouraged; + corresponding to the package name due to these programs' tight + integration with the mechanisms of the X Window System. + Application-level programs should use the <tt>/etc/</tt> + directory unless otherwise mandated by policy. The installation + of files into subdirectories of <tt>/usr/X11R6/include/X11/</tt> + and <tt>/usr/X11R6/lib/X11/</tt> is permitted but discouraged; package maintainers should determine if subdirectories of - <tt>/usr/lib/</tt> and <tt>/usr/share/</tt> can be used - instead (symlinks from the X11R6 directories to - FHS-compliant locations is encouraged if the program is not - easily configured to look elsewhere for its files). - Packages must not provide -- or install files into -- the - directories <tt>/usr/bin/X11/</tt>, - <tt>/usr/include/X11/</tt>, or <tt>/usr/lib/X11/</tt>. - Files within a package should, however, make reference to - these directories, rather than their X11R6-named - counterparts <tt>/usr/X11R6/bin/</tt>, - <tt>/usr/X11R6/include/X11/</tt>, and - <tt>/usr/X11R6/lib/X11/</tt>, if the resources being - referred to have not been moved to FHS-compliant locations. + <tt>/usr/lib/</tt> and <tt>/usr/share/</tt> can be used instead + (symlinks from the X11R6 directories to other FHS-compliant + locations is encouraged if the program is not easily configured + to look elsewhere for its files). Packages must not provide -- + or install files into -- the directories <tt>/usr/bin/X11/</tt>, + <tt>/usr/include/X11/</tt>, or <tt>/usr/lib/X11/</tt>. Files + within a package should, however, make reference to these + directories, rather than their X11R6-named counterparts + <tt>/usr/X11R6/bin/</tt>, <tt>/usr/X11R6/include/X11/</tt>, and + <tt>/usr/X11R6/lib/X11/</tt>, if the resources being referred to + have not been moved to other FHS-compliant locations. </p> <p> -- G. Branden Robinson | Any man who does not realize that he is Debian GNU/Linux | half an animal is only half a man. branden@deadbeast.net | -- Thornton Wilder http://deadbeast.net/~branden/ |
Attachment:
pgpLpDXp6B2KO.pgp
Description: PGP signature