Author: pierre
Date: Wed Feb 28 08:11:20 2018
New Revision: 19898

Log:
Reformat Which and make-ca to be closer to the template. Add the
lfs-checked tag to id3lib

Modified:
   trunk/BOOK/general/sysutils/which.xml
   trunk/BOOK/multimedia/libdriv/id3lib.xml
   trunk/BOOK/postlfs/security/make-ca.xml

Modified: trunk/BOOK/general/sysutils/which.xml
==============================================================================
--- trunk/BOOK/general/sysutils/which.xml       Wed Feb 28 06:00:10 2018        
(r19897)
+++ trunk/BOOK/general/sysutils/which.xml       Wed Feb 28 08:11:20 2018        
(r19898)
@@ -24,24 +24,29 @@
 
   <title>Which-&which-version; and Alternatives</title>
 
+  <para>
+    The presence or absence of the <command>which</command> program in the
+    main LFS book is probably one of the most contentious issues on the
+    mailing lists. It has resulted in at least one flame war in the past. To
+    hopefully put an end to this once and for all, presented here are two
+    options for equipping your system with <command>which</command>. The
+    question of which <quote><command>which</command></quote> is for you to
+    decide.
+  </para>
+
   <indexterm zone="which">
     <primary sortas="a-Which">Which</primary>
   </indexterm>
 
-  <para>The presence or absence of the <command>which</command> program
-  in the main LFS book is probably one of the most contentious issues on the
-  mailing lists. It has resulted in at least one flame war in the past. To 
hopefully
-  put an end to this once and for all, presented here are two options for 
equipping
-  your system with <command>which</command>. The question of which
-  <quote><command>which</command></quote> is for you to decide.</para>
-
-  <para>The first option is to install the actual GNU
-  <application>which</application> package.</para>
+  <sect2 role="package">
+    <title>Introduction to GNU Which</title>
 
-  &lfs82_checked;
+    <para>
+      The first option is to install the actual GNU
+      <application>which</application> package.
+    </para>
 
-  <sect2 role="package">
-    <title>Introduction to Which</title>
+    &lfs82_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">

Modified: trunk/BOOK/multimedia/libdriv/id3lib.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/id3lib.xml    Wed Feb 28 06:00:10 2018        
(r19897)
+++ trunk/BOOK/multimedia/libdriv/id3lib.xml    Wed Feb 28 08:11:20 2018        
(r19898)
@@ -32,6 +32,8 @@
     <para><application>id3lib</application> is a library for reading,
     writing and manipulating id3v1 and id3v2 multimedia data containers.</para>
 
+    &lfs82_checked;
+
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
@@ -84,7 +86,7 @@
 ./configure --prefix=/usr --disable-static &amp;&amp;
 make</userinput></screen>
 
-    <para>This packages does not come wiht a working test suite.</para>
+    <para>This packages does not come with a working test suite.</para>
 
     <para>Now, as the <systemitem class="username">root</systemitem> 
user:</para>
 

Modified: trunk/BOOK/postlfs/security/make-ca.xml
==============================================================================
--- trunk/BOOK/postlfs/security/make-ca.xml     Wed Feb 28 06:00:10 2018        
(r19897)
+++ trunk/BOOK/postlfs/security/make-ca.xml     Wed Feb 28 08:11:20 2018        
(r19898)
@@ -14,7 +14,7 @@
   <!ENTITY make-ca-md5sum        "4f180b9bf3b11f29d6a79e6022aeae23">
 ]>
 
-<sect1 id="make-ca" xreflabel="make-ca">
+<sect1 id="make-ca" xreflabel="make-ca-&make-ca-version;">
   <?dbhtml filename="make-ca.html"?>
 
   <sect1info>
@@ -22,28 +22,7 @@
     <date>$Date$</date>
   </sect1info>
 
-  <title>make-ca</title>
-
-  <para>Public Key Infrastructure (PKI) is a method to validate the
-  authenticity of an otherwise unknown entity across untrusted networks. PKI
-  works by establishing a chain of trust, rather than trusting each individual
-  host or entity explicitly. In order for a certificate presented by a remote
-  entity to be trusted, that certificate must present a complete chain of
-  certificates that can be validated using the root certificate of a
-  Certificate Authority (CA) that is trusted by the local machine.</para>
-  
-  <para>Establishing trust with a CA involves validating things like company
-  address, ownership, contact information, etc., and ensuring that the CA has
-  followed best practices, such as undergoing periodic security audits by
-  independent investigators and maintaining an always available certificate
-  revocation list. This is well outside the scope of BLFS (as it is for most
-  Linux distributions). The certificate store provided here is taken from the
-  Mozilla Foundation, who have established very strict inclusion policies
-  described
-  <ulink 
url="https://www.mozilla.org/en-US/about/governance/policies/security-group/certs/";>here</ulink>.</para>
-
-  &lfs82_checked;
-
+  <title>make-ca-&make-ca-version;</title>
   <indexterm zone="make-ca">
     <primary sortas="a-make-ca">make-ca</primary>
   </indexterm>
@@ -51,7 +30,31 @@
   <sect2 role="package">
     <title>Introduction to make-ca</title>
 
-   <bridgehead renderas="sect3">Package Information</bridgehead>
+    <para>
+      Public Key Infrastructure (PKI) is a method to validate the authenticity
+      of an otherwise unknown entity across untrusted networks. PKI works by
+      establishing a chain of trust, rather than trusting each individual host
+      or entity explicitly. In order for a certificate presented by a remote
+      entity to be trusted, that certificate must present a complete chain of
+      certificates that can be validated using the root certificate of a
+      Certificate Authority (CA) that is trusted by the local machine.
+    </para>
+  
+    <para>
+      Establishing trust with a CA involves validating things like company
+      address, ownership, contact information, etc., and ensuring that the CA
+      has followed best practices, such as undergoing periodic security audits
+      by independent investigators and maintaining an always available
+      certificate revocation list. This is well outside the scope of BLFS (as
+      it is for most Linux distributions). The certificate store provided here
+      is taken from the Mozilla Foundation, who have established very strict
+      inclusion policies described <ulink
+        
url="https://www.mozilla.org/en-US/about/governance/policies/security-group/certs/";>here</ulink>.
+    </para>
+
+  &lfs82_checked;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
         <para>Download (HTTP): <ulink url="&make-ca-download;"/></para>
-- 
http://lists.linuxfromscratch.org/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Reply via email to