os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Favour <programlisting> over <screen> in some cases. Make sure that the

Browse source 
<programlisting> is outside of any enclosing paragraphs.
This commit is contained in:
Nik Clayton 2001-07-12 10:14:36 +00:00
parent d528fae271
commit 2a890510dc
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=9859
1 changed files with 61 additions and 55 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

116
en_US.ISO8859-1/books/handbook/x11/chapter.sgml
View file

@ -1,7 +1,7 @@
<!-- <!--
The FreeBSD Documentation Project The FreeBSD Documentation Project
$FreeBSD: doc/en_US.ISO8859-1/books/handbook/x11/chapter.sgml,v 1.24 2001/07/11 16:07:50 murray Exp $ $FreeBSD: doc/en_US.ISO8859-1/books/handbook/x11/chapter.sgml,v 1.25 2001/07/11 19:13:52 nik Exp $
--> -->
<chapter id="x11"> <chapter id="x11">
@ -1459,7 +1459,8 @@ EndSection</programlisting>
<para>The <varname>DefaultColorDepth</varname> keyword describes <para>The <varname>DefaultColorDepth</varname> keyword describes
the color depth the user wishes to run at by default. This can the color depth the user wishes to run at by default. This can
be overridden with the <command>-bpp</command> command line be overridden with the <command>-bpp</command> command line
switch to &man.XFree86.1;. The Modes keyword describes the switch to <citerefentry><refentrytitle>XFree86</refentrytitle>
<manvolnum>1</manvolnum></citerefentry>. The Modes keyword describes the
resolution the user wishes to run at for the given color depth. resolution the user wishes to run at for the given color depth.
In the example above, the default color depth is twenty four In the example above, the default color depth is twenty four
bits per pixel. At this color depth, the accepted resolution is bits per pixel. At this color depth, the accepted resolution is
@ -1479,7 +1480,8 @@ EndSection</programlisting>
<para>Finally, the user can write out the configuration file and <para>Finally, the user can write out the configuration file and
test it using the test mode given above. If all is well, then test it using the test mode given above. If all is well, then
the configuration file needs to be installed in a common the configuration file needs to be installed in a common
location where &man.XFree86.1; can source it in the future. location where <citerefentry><refentrytitle>XFree86</refentrytitle>
<manvolnum>1</manvolnum></citerefentry> can source it in the future.
This is typically <filename>/etc/X11/XF86Config</filename> or This is typically <filename>/etc/X11/XF86Config</filename> or
<filename>/usr/X11R6/etc/X11/XF86Config</filename>.</para> <filename>/usr/X11R6/etc/X11/XF86Config</filename>.</para>
@ -1487,8 +1489,9 @@ EndSection</programlisting>
<para>Once the configuration file has been placed in a common <para>Once the configuration file has been placed in a common
location, XFree86 can then be used through &man.xdm.1;. In location, XFree86 can then be used through &man.xdm.1;. In
order to use &man.startx.1; the user will have to install the order to use <citerefentry><refentrytitle>startx</refentrytitle>
<filename>X11/wrapper</filename> port.</para> <manvolnum>1</manvolnum></citerefentry> the user will have to install
the <filename>X11/wrapper</filename> port.</para>
</sect2> </sect2>
@ -1551,24 +1554,28 @@ EndSection</programlisting>
TrueType fonts with a minimum of effort: see the TrueType fonts with a minimum of effort: see the
<link linkend="truetype">section on TrueType fonts</link> later.</para> <link linkend="truetype">section on TrueType fonts</link> later.</para>
<para>To install the above Type1 font collections, all you have <para>To install the above Type1 font collections from the ports
to do is collection you can run the following commands.</para>
<screen>
&prompt.root; <userinput>cd /usr/ports/x11-fonts/urwfonts</userinput> <screen>&prompt.root; <userinput>cd /usr/ports/x11-fonts/urwfonts</userinput>
&prompt.root; <userinput>make install clean</userinput> </screen> &prompt.root; <userinput>make install clean</userinput></screen>
and likewise with the freefont or other collections. To tell the X server
<para>And likewise with the freefont or other collections. To tell the X server
that these fonts exist, you can add an appropriate line that these fonts exist, you can add an appropriate line
to your <filename>XF86Config</filename> file (in to your <filename>XF86Config</filename> file (in
<filename>/etc/</filename> for <application>XFree86</application> <filename>/etc/</filename> for <application>XFree86</application>
version 3, or in <filename>/etc/X11/</filename> for version 4), version 3, or in <filename>/etc/X11/</filename> for version 4),
which reads which reads:</para>
<screen> FontPath "/usr/X11R6/lib/X11/fonts/URW/" </screen>
Alternatively, at the command line in your X session you can write <programlisting>FontPath "/usr/X11R6/lib/X11/fonts/URW/"</programlisting>
<screen>
&prompt.user; <userinput>xset fp+ /usr/X11R6/lib/X11/fonts/URW</userinput> <para>Alternatively, at the command line in your X session you can
&prompt.user; <userinput>xset fp rehash</userinput> write:</para>
</screen>
This will work but will be lost when you log out from this <screen>&prompt.user; <userinput>xset fp+ /usr/X11R6/lib/X11/fonts/URW</userinput>
&prompt.user; <userinput>xset fp rehash</userinput></screen>
<para>This will work but will be lost when you log out from this
session, unless you add it to your startup file session, unless you add it to your startup file
(<filename>~/.xinitrc</filename> for a normal startx session, (<filename>~/.xinitrc</filename> for a normal startx session,
or <filename>~/.xsession</filename> when logging in through a or <filename>~/.xsession</filename> when logging in through a
@ -1588,9 +1595,9 @@ EndSection</programlisting>
in this example because it is more consistent with the other font in this example because it is more consistent with the other font
rendering backends. To enable the freetype module just add the rendering backends. To enable the freetype module just add the
following line to the module section of your following line to the module section of your
<filename>/etc/X11/XF86Config</filename> file. <filename>/etc/X11/XF86Config</filename> file.</para>
<screen>Load "freetype"</screen>
</para> <programlisting>Load "freetype"</programlisting>
<para>For <application>XFree86</application> 3.3.X you will need <para>For <application>XFree86</application> 3.3.X you will need
to run a separate TrueType font to run a separate TrueType font
@ -1646,9 +1653,11 @@ EndSection</programlisting>
<para>First, you need to tell the X server about the fonts which you <para>First, you need to tell the X server about the fonts which you
want anti-aliased. To do that, for each font directory you have want anti-aliased. To do that, for each font directory you have
a line, which looks like a line, which looks like this:</para>
<screen>dir "/usr/X11R6/lib/X11/Type1"</screen>
and likewise for the other font directories (URW, truetype, etc) <programlisting>dir "/usr/X11R6/lib/X11/Type1"</programlisting>
<para>And likewise for the other font directories (URW, truetype, etc)
containing fonts you'd like anti-aliased. Anti-aliasing makes containing fonts you'd like anti-aliased. Anti-aliasing makes
sense only for scalable fonts (basically, Type1 and TrueType) so sense only for scalable fonts (basically, Type1 and TrueType) so
don't include bitmap font directories here. The don't include bitmap font directories here. The
@ -1659,47 +1668,45 @@ EndSection</programlisting>
(Antialiasing makes borders slightly fuzzy, which makes very (Antialiasing makes borders slightly fuzzy, which makes very
small text more readable and removes "staircases" from large text, small text more readable and removes "staircases" from large text,
but can cause eyestrain if applied to normal text.) To exclude but can cause eyestrain if applied to normal text.) To exclude
point sizes between 9 and 13 from anti-aliasing, include the point sizes between 9 and 13 from anti-aliasing, include these
lines lines:</para>
<screen>
match <programlisting>match
any size > 8 any size > 8
any size < 14 any size < 14
edit edit
antialias = false; antialias = false;</programlisting>
</screen>
You may also find that the spacing for some monospaced fonts <para>You may also find that the spacing for some monospaced fonts
gets messed up when you turn on anti-aliasing. This seems to gets messed up when you turn on anti-aliasing. This seems to
be an issue with KDE, in particular. One possible fix for this be an issue with KDE, in particular. One possible fix for this
is to force the spacing for such fonts to be 100: add the is to force the spacing for such fonts to be 100: add the
following lines following lines:</para>
<screen>
match any family == "fixed" edit family =+ "mono"; <programlisting>match any family == "fixed" edit family =+ "mono";
match any family == "console" edit family =+ "mono"; match any family == "console" edit family =+ "mono";</programlisting>
</screen>
(this aliases the other common names for fixed fonts as "mono"), <para>(this aliases the other common names for fixed fonts as "mono"),
and then and then add:</para>
<screen>
match any family == "mono" edit spacing = 100; <programlisting>match any family == "mono" edit spacing = 100;</programlisting>
</screen>
Supposing you want to use the Lucidux fonts whenever monospaced <para>Supposing you want to use the Lucidux fonts whenever monospaced
fonts are required (these look nice, and don't seem to suffer fonts are required (these look nice, and don't seem to suffer
from the spacing problem), you could replace that last line from the spacing problem), you could replace that last line
with with these:</para>
<screen>
match any family == "mono" edit family += "LuciduxMono"; <programlisting>match any family == "mono" edit family += "LuciduxMono";
match any family == "Lucidux Mono" edit family += "LuciduxMono"; match any family == "Lucidux Mono" edit family += "LuciduxMono";
match any family == "LuciduxMono" edit family =+ "Lucidux Mono"; match any family == "LuciduxMono" edit family =+ "Lucidux Mono";</programlisting>
</screen>
(the last lines alias different equivalent family names).</para> <para>(the last lines alias different equivalent family names).</para>
<para>Finally, you want to allow users to add commands to this <para>Finally, you want to allow users to add commands to this
file, via their personal <filename>.xftconfig</filename> file, via their personal <filename>.xftconfig</filename>
files. To do this, add a last line, files. To do this, add a last line:</para>
<screen>
includeif "~/.xftconfig" <programlisting>includeif "~/.xftconfig"</programlisting>
</screen>
</para>
<para>That's all; anti-aliasing should be enabled the next <para>That's all; anti-aliasing should be enabled the next
time you start the X server. However, note that your programs must time you start the X server. However, note that your programs must
@ -1713,7 +1720,6 @@ includeif "~/.xftconfig"
<para>Anti-aliasing is still new to FreeBSD and XFree86; <para>Anti-aliasing is still new to FreeBSD and XFree86;
configuring it should get easier with time, and it will soon be configuring it should get easier with time, and it will soon be
supported by many more applications.</para> supported by many more applications.</para>
</sect2> </sect2>
</sect1> </sect1>