+ <item><p>
+ Support the command-line option <tt>-T
+ <var>title</var></tt>, which creates a new terminal
+ window with the window title <var>title</var>.
+ </p></item>
+ </list>
+ </p>
+ </sect1>
+
+ <sect1>
+ <heading>Packages providing a window manager</heading>
+
+ <p>
+ Packages that provide a window manager should declare in
+ their control data that they provide the virtual package
+ <tt>x-window-manager</tt>. They should also register
+ themselves as an alternative for
+ <tt>/usr/bin/x-window-manager</tt>, with a priority
+ calculated as follows:
+ <list compact="compact">
+ <item><p>Start with a priority of 20.</p></item>
+
+ <item>
+ <p>
+ If the window manager supports the Debian menu
+ system, add 20 points if this support is available
+ in the package's default configuration (i.e., no
+ configuration files belonging to the system or user
+ have to be edited to activate the feature); if
+ configuration files must be modified, add only 10
+ points.
+ </p>
+ </item>
+
+ <item>
+ <p>
+ If the window manager permits the X session to be
+ restarted using a <em>different</em> window manager
+ (without killing the X server) in its default
+ configuration, add 10 points; otherwise add none.
+ </p>
+ </item>
+ </list>
+ </p>
+ </sect1>
+
+ <sect1>
+ <heading>Packages providing fonts</heading>
+
+ <p>
+ Packages that provide fonts for the X Window
+ System<footnote>
+ <p>
+ For the purposes of Debian Policy, a "font for the X
+ Window System" is one which is accessed via X protocol
+ requests. Fonts for the Linux console, for PostScript
+ renderers, or any other purpose, do not fit this
+ definition. Any tool which makes such fonts available
+ to the X Window System, however, must abide by this
+ font policy.
+ </p>
+ </footnote>
+ must do a number of things to ensure that they are both
+ available without modification of the X or font server
+ configuration, and that they do not corrupt files used by
+ other font packages to register information about
+ themselves.
+ <enumlist>
+ <item>
+ <p>
+ Fonts of any type supported by the X Window System
+ must be be in a separate binary package from any
+ executables, libraries, or documentation (except
+ that specific to the fonts shipped, such as their
+ license information). If one or more of the fonts
+ so packaged are necessary for proper operation of
+ the package with which they are associated the font
+ package may be Recommended; if the fonts merely
+ provide an enhancement, a Suggests relationship may
+ be used. Packages must not Depend on font
+ packages.<footnote>
+ <p>
+ This is because the X server may retrieve fonts
+ from the local filesystem or over the network
+ from an X font server; the Debian package system
+ is empowered to deal only with the local
+ filesystem.
+ </p>
+ </footnote>
+ </p>
+ </item>
+
+ <item>
+ <p>
+ BDF fonts must be converted to PCF fonts with the
+ <prgn>bdftopcf</prgn> utility (available in the
+ <tt>xutils</tt> package, <tt>gzip</tt>ped, and
+ placed in a directory that corresponds to their
+ resolution:
+ <list compact="compact">
+ <item><p>
+ 100 dpi fonts must be placed in
+ <tt>/usr/X11R6/lib/X11/fonts/100dpi/</tt>.
+ </p></item>
+
+ <item><p>
+ 75 dpi fonts must be placed in
+ <tt>/usr/X11R6/lib/X11/fonts/75dpi/</tt>.
+ </p></item>
+
+ <item><p>
+ Character-cell fonts, cursor fonts, and other
+ low-resolution fonts must be placed in
+ <tt>/usr/X11R6/lib/X11/fonts/misc/</tt>.
+ </p></item>
+ </list>
+ </p>
+ </item>
+
+ <item><p>
+ Speedo fonts must be placed in
+ <tt>/usr/X11R6/lib/X11/fonts/Speedo/</tt>.
+ </p></item>
+
+ <item><p>
+ Type 1 fonts must be placed in
+ <tt>/usr/X11R6/lib/X11/fonts/Type1/</tt>. If font
+ metric files are available, they must be placed here
+ as well.
+ </p></item>
+
+ <item>
+ <p>
+ Subdirectories of <tt>/usr/X11R6/lib/X11/fonts/</tt>
+ other than those listed above must be neither
+ created nor used. (The <tt>PEX</tt>, <tt>CID</tt>,
+ and <tt>cyrillic</tt> directories are excepted for
+ historical reasons, but installation of files into
+ these directories remains discouraged.)
+ </p>
+ </item>
+
+ <item>
+ <p>
+ Font packages may, instead of placing files directly
+ in the X font directories listed above, provide
+ symbolic links in the font directory which point to
+ the files' actual location in the filesystem. Such
+ a location must comply with the FHS.
+ </p>
+ </item>
+
+ <item>
+ <p>
+ Font packages should not contain both 75dpi and
+ 100dpi versions of a font. If both are available,
+ they should be provided in separate binary packages
+ with <tt>-75dpi</tt> or <tt>-100dpi</tt> appended to
+ the names of the packages containing the
+ corresponding fonts.
+ </p>
+ </item>
+
+ <item>
+ <p>
+ Fonts destined for the <tt>misc</tt> subdirectory
+ should not be included in the same package as 75dpi
+ or 100dpi fonts; instead, they should be provided in
+ a separate package with <tt>-misc</tt> appended to
+ its name.
+ </p>
+ </item>
+
+ <item>
+ <p>
+ Font packages must not provide the files
+ <tt>fonts.dir</tt>, <tt>fonts.alias</tt>, or
+ <tt>fonts.scale</tt> in a font directory:
+ <list>
+ <item><p>
+ <tt>fonts.dir</tt> files must not be provided at all.
+ </p></item>
+
+ <item>
+ <p>
+ <tt>fonts.alias</tt> and <tt>fonts.scale</tt>
+ files, if needed, should be provided in the
+ directory
+ <tt>/etc/X11/fonts/<var>fontdir</var>/<var>package</var>.<var>extension</var></tt>,
+ where <var>fontdir</var> is the name of the
+ subdirectory of
+ <tt>/usr/X11R6/lib/X11/fonts/</tt> where the
+ package's corresponding fonts are stored
+ (e.g., <tt>75dpi</tt> or <tt>misc</tt>),
+ <var>package</var> is the name of the package
+ that provides these fonts, and
+ <var>extension</var> is either <tt>scale</tt>
+ or <tt>alias</tt>, whichever corresponds to
+ the file contents.
+ </p>
+ </item>
+ </list>
+ </p>
+ </item>
+
+ <item>
+ <p>
+ Font packages must declare a dependency on
+ <tt>xutils (>> 4.0.3)</tt> in their control
+ data.
+ </p>
+ </item>
+
+ <item>
+ <p>
+ Font packages that provide one or more
+ <tt>fonts.scale</tt> files as described above must
+ invoke <prgn>update-fonts-scale</prgn> on each
+ directory into which they installed fonts
+ <em>before</em> invoking
+ <prgn>update-fonts-dir</prgn> on that directory.
+ This invocation must occur in both the
+ <prgn>postinst</prgn> (for all arguments) and
+ <prgn>postrm</prgn> (for all arguments except
+ <tt>upgrade</tt>) scripts.
+ </p>
+ </item>
+
+ <item>
+ <p>
+ Font packages that provide one or more
+ <tt>fonts.alias</tt> files as described above must
+ invoke <prgn>update-fonts-alias</prgn> on each
+ directory into which they installed fonts. This
+ invocation must occur in both the
+ <prgn>postinst</prgn> (for all arguments) and
+ <prgn>postrm</prgn> (for all arguments except
+ <tt>upgrade</tt>) scripts.
+ </p>
+ </item>
+
+ <item>
+ <p>
+ Font packages must invoke
+ <prgn>update-fonts-dir</prgn> on each directory into
+ which they installed fonts. This invocation must
+ occur in both the <prgn>postinst</prgn> (for all
+ arguments) and <prgn>postrm</prgn> (for all
+ arguments except <tt>upgrade</tt>) scripts.
+ </p>
+ </item>
+
+ <item>
+ <p>
+ Font packages must not provide alias names for the
+ fonts they include which collide with alias names
+ already in use by fonts already packaged.
+ </p>
+ </item>
+
+ <item>
+ <p>
+ Font packages must not provide fonts with the same
+ XLFD registry name as another font already packaged.
+ </p>
+ </item>
+ </enumlist>
+ </p>
+ </sect1>
+
+ <sect1>
+ <heading>Application defaults files</heading>
+
+ <p>
+ Application defaults files must be installed in the
+ directory <tt>/etc/X11/app-defaults/</tt> (use of a
+ localized subdirectory of <tt>/etc/X11/</tt> as described
+ in the <em>X Toolkit Intrinsics - C Language
+ Interface</em> manual is also permitted). They must be
+ registered as <tt>conffile</tt>s or handled as
+ configuration files. Packages must not provide the
+ directory <tt>/usr/X11R6/lib/X11/app-defaults/</tt>.
+ </p>
+
+ <p>
+ Customization of programs' X resources may also be
+ supported with the provision of a file with the same name
+ as that of the package placed in the
+ <tt>/etc/X11/Xresources/</tt> directory, which must
+ registered as a <tt>conffile</tt> or handled as a
+ configuration file.<footnote>
+ <p>
+ Note that this mechanism is not the same as using
+ app-defaults; app-defaults are tied to the client
+ binary on the local filesystem, whereas X resources
+ are stored in the X server and affect all connecting
+ clients.
+ </p>
+ </footnote>
+ <em>Important:</em> packages that install files into the
+ <tt>/etc/X11/Xresources/</tt> directory must conflict with
+ <tt>xbase (<< 3.3.2.3a-2)</tt>; if this is not done
+ it is possible for the installing package to destroy a
+ previously-existing <tt>/etc/X11/Xresources</tt> file
+ which had been customized by the system administrator.
+ </p>
+ </sect1>
+
+ <sect1>
+ <heading>Installation directory issues</heading>
+
+ <p>
+ Packages using the X Window System should not be
+ configured to install files under the <tt>/usr/X11R6/</tt>
+ directory unless they use <prgn>imake</prgn>. 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
+ <prgn>imake</prgn> program it provides, in which case the
+ packages may transition out of the <tt>/usr/X11R6/</tt>
+ directory at the maintainer's discretion.<footnote>
+ <p>
+ <prgn>Imake</prgn>-using programs are exempt because,
+ as long as 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.
+ </p>
+ </footnote>
+ Programs that use GNU <prgn>autoconf</prgn> and
+ <prgn>automake</prgn> 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;
+ package maintainers should determine if subdirectories of
+ <tt>/usr/lib/</tt> and <tt>/usr/share/</tt> can be used
+ instead. (The use of symbolic links from the
+ <tt>X11R6</tt> 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 <tt>X11R6</tt>-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>
+ </sect1>
+
+ <sect1>
+ <heading>The OSF/Motif and OpenMotif libraries</heading>
+
+ <p>
+ <em>Programs that require the non-DFSG-compliant OSF/Motif or
+ OpenMotif libraries</em><footnote>
+ <p>
+ OSF/Motif and OpenMotif are collectively referred to as
+ "Motif" in this policy document.
+ </p>
+ </footnote>
+ should be compiled against and tested with LessTif (a free
+ re-implementation of Motif) instead. If the maintainer
+ judges that the program or programs do not work
+ sufficiently well with LessTif to be distributed and
+ supported, but do so when compiled against Motif, then two
+ versions of the package should be created; one linked
+ statically against Motif and with <tt>-smotif</tt>
+ appended to the package name, and one linked dynamically
+ against Motif and with <tt>-dmotif</tt> appended to the
+ package name. Both Motif-linked versions are dependent
+ upon non-DFSG-compliant software and thus cannot be
+ uploaded to the <em>main</em> distribution; if the
+ software is itself DFSG-compliant it may be uploaded to
+ the <em>contrib</em> distribution. While known existing
+ versions of Motif permit unlimited redistribution of
+ binaries linked against the library (whether statically or
+ dynamically), it is the package maintainer's
+ responsibility to determine whether this is permitted by
+ the license of the copy of Motif in his or her possession.
+ </p>
+ </sect1>