git: 1e298eef9f - main - Fix some igor warnings: - Overlong lines - Indentations - Use <litera> tags within a title - Add commas after i.e. and e.g.

Benedict Reuschling bcr at FreeBSD.org
Mon Dec 28 18:43:22 UTC 2020


The branch main has been updated by bcr:

URL: https://cgit.FreeBSD.org/doc/commit/?id=1e298eef9f850921a8ce1514eeaaea05d7a6a723

commit 1e298eef9f850921a8ce1514eeaaea05d7a6a723
Author:     Benedict Reuschling <bcr at FreeBSD.org>
AuthorDate: 2020-12-28 18:40:30 +0000
Commit:     Benedict Reuschling <bcr at FreeBSD.org>
CommitDate: 2020-12-28 18:40:30 +0000

    Fix some igor warnings:
    - Overlong lines
    - Indentations
    - Use <litera> tags within a title
    - Add commas after i.e. and e.g.
---
 en_US.ISO8859-1/books/handbook/x11/chapter.xml | 85 ++++++++++++++------------
 1 file changed, 45 insertions(+), 40 deletions(-)

diff --git a/en_US.ISO8859-1/books/handbook/x11/chapter.xml b/en_US.ISO8859-1/books/handbook/x11/chapter.xml
index 72656bc867..0ebd1bb20f 100644
--- a/en_US.ISO8859-1/books/handbook/x11/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/x11/chapter.xml
@@ -252,8 +252,8 @@
 &prompt.root; <userinput>make install clean</userinput></screen>
 
     <para>Either of these installations results in the complete
-      <application>&xorg;</application> system being installed.  Binary packages
-      are the best option for most users.</para>
+      <application>&xorg;</application> system being installed.
+      Binary packages are the best option for most users.</para>
 
     <para>A smaller version of the X system suitable for experienced
       users is available in <package>x11/xorg-minimal</package>.  Most
@@ -267,13 +267,13 @@
 
     <info>
       <authorgroup>
-      <author>
-	<personname>
-	  <firstname>Warren</firstname>
-	  <surname>Block</surname>
-	</personname>
-	<contrib>Originally contributed by </contrib>
-      </author>
+	<author>
+	  <personname>
+	    <firstname>Warren</firstname>
+	    <surname>Block</surname>
+	  </personname>
+	  <contrib>Originally contributed by </contrib>
+	</author>
       </authorgroup>
     </info>
 
@@ -308,8 +308,8 @@
 	  <para>Add the user who will run
 	    <application>&xorg;</application> to the
 	    <systemitem class="groupname">video</systemitem> or
-	    <systemitem class="groupname">wheel</systemitem> group to enable 3D acceleration
-	    when available.  To add user
+	    <systemitem class="groupname">wheel</systemitem> group to
+	    enable 3D acceleration when available.  To add user
 	    <replaceable>jru</replaceable> to whichever group is
 	    available:</para>
 
@@ -317,8 +317,8 @@
 	</step>
 
 	<step>
-	  <para>The <application>twm</application> window manager is included
-	    by default.  It is started when
+	  <para>The <application>twm</application> window manager is
+	    included by default.  It is started when
 	    <application>&xorg;</application> starts:</para>
 
 	  <screen>&prompt.user; <userinput>startx</userinput></screen>
@@ -338,13 +338,15 @@
 
       <para>Access to <filename>/dev/dri</filename> is needed to allow
 	3D acceleration on video cards.  It is usually simplest to add
-	the user who will be running X to either the
-	<systemitem class="groupname">video</systemitem> or <systemitem class="groupname">wheel</systemitem> group.
-	Here, &man.pw.8; is used to add user
+	the user who will be running X to either the <systemitem
+	  class="groupname">video</systemitem> or <systemitem
+	  class="groupname">wheel</systemitem> group.  Here,
+	&man.pw.8; is used to add user
 	<replaceable>slurms</replaceable> to the
-	<systemitem class="groupname">video</systemitem> group, or to the
-	<systemitem class="groupname">wheel</systemitem> group if there is no
-	<systemitem class="groupname">video</systemitem> group:</para>
+	<systemitem class="groupname">video</systemitem> group, or to
+	the <systemitem class="groupname">wheel</systemitem> group if
+	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>
     </sect2>
@@ -464,7 +466,7 @@
 	    <para>Driver name: <literal>intel</literal></para>
 
 	    <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>
 	</varlistentry>
 
@@ -991,13 +993,13 @@ EndSection</programlisting>
 	on this, see the &man.X.7; manual page or <xref
 	  linkend="truetype"/>.</para>
 
-      <para>To install the above Type1 font collections from binary packages,
-	run the following commands:</para>
+      <para>To install the above Type1 font collections from binary
+	packages, run the following commands:</para>
 
       <screen>&prompt.root; <userinput>pkg install urwfonts</userinput></screen>
 
-      <para>Alternatively, to build from the Ports Collection, run the following
-	commands:</para>
+      <para>Alternatively, to build from the Ports Collection, run the
+	following commands:</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/x11-fonts/urwfonts</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
@@ -1347,11 +1349,12 @@ EndSection</programlisting>
 	      <entry><filename>Xaccess</filename></entry>
 	      <entry>The protocol for connecting to
 		<application>XDM</application> is called the X Display
-		Manager Connection Protocol (<acronym>XDMCP</acronym>).
-		This file is a client authorization ruleset for
-		controlling <acronym>XDMCP</acronym> connections from
-		remote machines.  By default, this file does not allow
-		any remote clients to connect.</entry>
+		Manager Connection Protocol
+		(<acronym>XDMCP</acronym>).  This file is a client
+		authorization ruleset for controlling
+		<acronym>XDMCP</acronym> connections from remote
+		machines.  By default, this file does not allow any
+		remote clients to connect.</entry>
 	    </row>
 
 	    <row>
@@ -1627,16 +1630,17 @@ hald_enable="YES"</programlisting>
 
       <programlisting>exec ck-launch-session startplasma-x11</programlisting>
 
-      <para>A third method for starting <application>KDE Plasma</application>
-	is through <application>XDM</application>.  To do so, create
+      <para>A third method for starting <application>KDE
+	  Plasma</application> is through
+	<application>XDM</application>.  To do so, create
 	an executable <filename>~/.xsession</filename> as
 	follows:</para>
 
       <screen>&prompt.user; <userinput>echo "exec ck-launch-session startplasma-x11" > ~/.xsession</userinput></screen>
 
-      <para>Once <application>KDE Plasma</application> is started, refer to
-	its built-in help system for more information on how to use
-	its various menus and applications.</para>
+      <para>Once <application>KDE Plasma</application> is started,
+	refer to its built-in help system for more information on how
+	to use its various menus and applications.</para>
     </sect2>
 
     <sect2 xml:id="x11-wm-xfce">
@@ -1731,7 +1735,7 @@ hald_enable="YES"</programlisting>
       <note>
 	<para>To immediately load the kernel module into the running
 	  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
 	  function properly if the driver is not loaded at boot time.
 	  After editing <filename>/boot/loader.conf</filename>, a
@@ -1756,7 +1760,8 @@ hald_enable="YES"</programlisting>
     </sect2>
 
     <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 Fusion</application>,
 	<filename>/etc/X11/xorg.conf</filename> needs to be
@@ -1817,7 +1822,7 @@ EndSubSection</programlisting>
 	<package>x11/nvidia-xconfig</package> by running (as
 	 <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 --depth=24</userinput></screen>
     </sect2>
@@ -1838,15 +1843,15 @@ EndSubSection</programlisting>
 &prompt.user; <userinput>emerald --replace &</userinput></screen>
 
       <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
 	<application>Compiz Fusion</application>.
 	<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>
 
       <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>
 	desktop):</para>
 


More information about the dev-commits-doc-all mailing list