Fix some igor warnings:

- Overlong lines
- Indentations
- Use <litera> tags within a title
- Add commas after i.e. and e.g.
This commit is contained in:
Benedict Reuschling 2020-12-28 18:40:30 +00:00
parent 7d0cc33a0e
commit 1e298eef9f

View file

@ -252,8 +252,8 @@
&prompt.root; <userinput>make install clean</userinput></screen> &prompt.root; <userinput>make install clean</userinput></screen>
<para>Either of these installations results in the complete <para>Either of these installations results in the complete
<application>&xorg;</application> system being installed. Binary packages <application>&xorg;</application> system being installed.
are the best option for most users.</para> Binary packages are the best option for most users.</para>
<para>A smaller version of the X system suitable for experienced <para>A smaller version of the X system suitable for experienced
users is available in <package>x11/xorg-minimal</package>. Most users is available in <package>x11/xorg-minimal</package>. Most
@ -267,13 +267,13 @@
<info> <info>
<authorgroup> <authorgroup>
<author> <author>
<personname> <personname>
<firstname>Warren</firstname> <firstname>Warren</firstname>
<surname>Block</surname> <surname>Block</surname>
</personname> </personname>
<contrib>Originally contributed by </contrib> <contrib>Originally contributed by </contrib>
</author> </author>
</authorgroup> </authorgroup>
</info> </info>
@ -308,8 +308,8 @@
<para>Add the user who will run <para>Add the user who will run
<application>&xorg;</application> to the <application>&xorg;</application> to the
<systemitem class="groupname">video</systemitem> or <systemitem class="groupname">video</systemitem> or
<systemitem class="groupname">wheel</systemitem> group to enable 3D acceleration <systemitem class="groupname">wheel</systemitem> group to
when available. To add user enable 3D acceleration when available. To add user
<replaceable>jru</replaceable> to whichever group is <replaceable>jru</replaceable> to whichever group is
available:</para> available:</para>
@ -317,8 +317,8 @@
</step> </step>
<step> <step>
<para>The <application>twm</application> window manager is included <para>The <application>twm</application> window manager is
by default. It is started when included by default. It is started when
<application>&xorg;</application> starts:</para> <application>&xorg;</application> starts:</para>
<screen>&prompt.user; <userinput>startx</userinput></screen> <screen>&prompt.user; <userinput>startx</userinput></screen>
@ -338,13 +338,15 @@
<para>Access to <filename>/dev/dri</filename> is needed to allow <para>Access to <filename>/dev/dri</filename> is needed to allow
3D acceleration on video cards. It is usually simplest to add 3D acceleration on video cards. It is usually simplest to add
the user who will be running X to either the the user who will be running X to either the <systemitem
<systemitem class="groupname">video</systemitem> or <systemitem class="groupname">wheel</systemitem> group. class="groupname">video</systemitem> or <systemitem
Here, &man.pw.8; is used to add user class="groupname">wheel</systemitem> group. Here,
&man.pw.8; is used to add user
<replaceable>slurms</replaceable> to the <replaceable>slurms</replaceable> to the
<systemitem class="groupname">video</systemitem> group, or to the <systemitem class="groupname">video</systemitem> group, or to
<systemitem class="groupname">wheel</systemitem> group if there is no the <systemitem class="groupname">wheel</systemitem> group if
<systemitem class="groupname">video</systemitem> group:</para> there is no <systemitem class="groupname">video</systemitem>
group:</para>
<screen>&prompt.root; <userinput>pw groupmod video -m <replaceable>slurms</replaceable> || pw groupmod wheel -m <replaceable>slurms</replaceable></userinput></screen> <screen>&prompt.root; <userinput>pw groupmod video -m <replaceable>slurms</replaceable> || pw groupmod wheel -m <replaceable>slurms</replaceable></userinput></screen>
</sect2> </sect2>
@ -464,7 +466,7 @@
<para>Driver name: <literal>intel</literal></para> <para>Driver name: <literal>intel</literal></para>
<para>For reference, see <link <para>For reference, see <link
xlink:href="https://en.wikipedia.org/wiki/List_of_Intel_graphics_processing_units"/>.</para> xlink:href="https://en.wikipedia.org/wiki/List_of_Intel_graphics_processing_units"/>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -991,13 +993,13 @@ EndSection</programlisting>
on this, see the &man.X.7; manual page or <xref on this, see the &man.X.7; manual page or <xref
linkend="truetype"/>.</para> linkend="truetype"/>.</para>
<para>To install the above Type1 font collections from binary packages, <para>To install the above Type1 font collections from binary
run the following commands:</para> packages, run the following commands:</para>
<screen>&prompt.root; <userinput>pkg install urwfonts</userinput></screen> <screen>&prompt.root; <userinput>pkg install urwfonts</userinput></screen>
<para>Alternatively, to build from the Ports Collection, run the following <para>Alternatively, to build from the Ports Collection, run the
commands:</para> 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>
@ -1347,11 +1349,12 @@ EndSection</programlisting>
<entry><filename>Xaccess</filename></entry> <entry><filename>Xaccess</filename></entry>
<entry>The protocol for connecting to <entry>The protocol for connecting to
<application>XDM</application> is called the X Display <application>XDM</application> is called the X Display
Manager Connection Protocol (<acronym>XDMCP</acronym>). Manager Connection Protocol
This file is a client authorization ruleset for (<acronym>XDMCP</acronym>). This file is a client
controlling <acronym>XDMCP</acronym> connections from authorization ruleset for controlling
remote machines. By default, this file does not allow <acronym>XDMCP</acronym> connections from remote
any remote clients to connect.</entry> machines. By default, this file does not allow any
remote clients to connect.</entry>
</row> </row>
<row> <row>
@ -1627,16 +1630,17 @@ hald_enable="YES"</programlisting>
<programlisting>exec ck-launch-session startplasma-x11</programlisting> <programlisting>exec ck-launch-session startplasma-x11</programlisting>
<para>A third method for starting <application>KDE Plasma</application> <para>A third method for starting <application>KDE
is through <application>XDM</application>. To do so, create Plasma</application> is through
<application>XDM</application>. To do so, create
an executable <filename>~/.xsession</filename> as an executable <filename>~/.xsession</filename> as
follows:</para> follows:</para>
<screen>&prompt.user; <userinput>echo "exec ck-launch-session startplasma-x11" &gt; ~/.xsession</userinput></screen> <screen>&prompt.user; <userinput>echo "exec ck-launch-session startplasma-x11" &gt; ~/.xsession</userinput></screen>
<para>Once <application>KDE Plasma</application> is started, refer to <para>Once <application>KDE Plasma</application> is started,
its built-in help system for more information on how to use refer to its built-in help system for more information on how
its various menus and applications.</para> to use its various menus and applications.</para>
</sect2> </sect2>
<sect2 xml:id="x11-wm-xfce"> <sect2 xml:id="x11-wm-xfce">
@ -1731,7 +1735,7 @@ hald_enable="YES"</programlisting>
<note> <note>
<para>To immediately load the kernel module into the running <para>To immediately load the kernel module into the running
kernel issue a command like <command>kldload kernel issue a command like <command>kldload
nvidia</command>. However, it has been noted that some nvidia</command>. However, it has been noted that some
versions of <application>&xorg;</application> will not versions of <application>&xorg;</application> will not
function properly if the driver is not loaded at boot time. function properly if the driver is not loaded at boot time.
After editing <filename>/boot/loader.conf</filename>, a After editing <filename>/boot/loader.conf</filename>, a
@ -1756,7 +1760,8 @@ hald_enable="YES"</programlisting>
</sect2> </sect2>
<sect2 xml:id="xorg-configuration"> <sect2 xml:id="xorg-configuration">
<title>Configuring xorg.conf for Desktop Effects</title> <title>Configuring <literal>xorg.conf</literal> for Desktop
Effects</title>
<para>To enable <application>Compiz&nbsp;Fusion</application>, <para>To enable <application>Compiz&nbsp;Fusion</application>,
<filename>/etc/X11/xorg.conf</filename> needs to be <filename>/etc/X11/xorg.conf</filename> needs to be
@ -1817,7 +1822,7 @@ EndSubSection</programlisting>
<package>x11/nvidia-xconfig</package> by running (as <package>x11/nvidia-xconfig</package> by running (as
<systemitem class="username">root</systemitem>):</para> <systemitem class="username">root</systemitem>):</para>
<screen>&prompt.root; <userinput>nvidia-xconfig --add-argb-glx-visuals</userinput> <screen>&prompt.root; <userinput>nvidia-xconfig --add-argb-glx-visuals</userinput>
&prompt.root; <userinput>nvidia-xconfig --composite</userinput> &prompt.root; <userinput>nvidia-xconfig --composite</userinput>
&prompt.root; <userinput>nvidia-xconfig --depth=24</userinput></screen> &prompt.root; <userinput>nvidia-xconfig --depth=24</userinput></screen>
</sect2> </sect2>
@ -1838,15 +1843,15 @@ EndSubSection</programlisting>
&prompt.user; <userinput>emerald --replace &amp;</userinput></screen> &prompt.user; <userinput>emerald --replace &amp;</userinput></screen>
<para>Your screen will flicker for a few seconds, as your window <para>Your screen will flicker for a few seconds, as your window
manager (e.g. <application>Metacity</application> if you are manager (e.g., <application>Metacity</application> if you are
using <application>GNOME</application>) is replaced by using <application>GNOME</application>) is replaced by
<application>Compiz&nbsp;Fusion</application>. <application>Compiz&nbsp;Fusion</application>.
<application>Emerald</application> takes care of the window <application>Emerald</application> takes care of the window
decorations (i.e. close, minimize, maximize buttons, title decorations (i.e., close, minimize, maximize buttons, title
bars and so on).</para> bars and so on).</para>
<para>You may convert this to a trivial script and have it run <para>You may convert this to a trivial script and have it run
at startup automatically (e.g. by adding to at startup automatically (e.g., by adding to
<quote>Sessions</quote> in a <application>GNOME</application> <quote>Sessions</quote> in a <application>GNOME</application>
desktop):</para> desktop):</para>