Changeset 89e6d61 for introduction/welcome/conventions.xml

Timestamp:

10/07/2014 02:27:15 AM (10 years ago)

Author:

Bruce Dubbs <bdubbs@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

a772d7e1

Parents:

ae5ad236

Message:

Update to libreoffice-4.3.1.2.

Clarify meaning of Required, Recommended, and Optional dependecies
by adding the definitions used. Added to 'Conventions Used in this Book'.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@14518 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• introduction/welcome/conventions.xml (modified) (2 diffs)

introduction/welcome/conventions.xml

@@ -16 +16 @@
   <title>Conventions Used in this Book</title>
 
+  <sect2>
+  <title>Typographical Conventions</title>
   <para>To make things easy to follow, there are a number of conventions used
   throughout the book.  Following are some examples:</para>
@@ -88 +90 @@
   </blockquote>
 
+  </sect2>
+
+  <sect2>
+  <title>Conventions Used for Package Dependencies</title>
+
+    <para>When packages are created, the authors depend on prior work.  In
+    order to build a package in BLFS, these dependencies must be built prior to
+    the desired package.  For each package, any prerequsite packages are listed
+    in one or more separate sections:  Required, Recommended, and Optional.</para>
+
+    <bridgehead renderas="sect3">Required Dependencies</bridgehead>
+
+    <para>These dependencies are the minimum prerequsite packages required to
+    build the package.  Omitted from the list are packages in LFS and required
+    dependencies of other required packages.</para>
+
+    <bridgehead renderas="sect3">Recommended Dependencies</bridgehead>
+    
+    <para>These dependencies are those that the BLFS editors have determined
+    are important to give the package reasonable capabilities.  Ppackage
+    installation instructions assume thay are installed.  If a recommended
+    package is not desired, the instructions may need to be modified to
+    accomodate the missing package.</para>
+    
+    <bridgehead renderas="sect3">Optional Dependencies</bridgehead>
+
+    <para>These dependencies are those that the package may use.  Integration
+    of optional dependencies may be automatic by the package or may need
+    additional instructions not presented by BLFS.  Optional packages may be
+    listed without corresponding BLFS instructions.  In this case it is up to
+    the user to determine appropriate installation instructions. </para>
+
+  </sect2>
+
 </sect1>