Changeset 1e9ccfa
- Timestamp:
- 10/07/2022 04:58:29 PM (19 months ago)
- Branches:
- 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18, xry111/xf86-video-removal
- Children:
- f2ae6ba8
- Parents:
- 1f1f2230
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
introduction/welcome/conventions.xml
r1f1f2230 r1e9ccfa 17 17 <sect2> 18 18 <title>Typographical Conventions</title> 19 <para>To make things easy to follow, there are a number of conventionsused20 throughout the book. Followingare some examples:</para>19 <para>To make things easy to follow, a number of conventions are used 20 throughout the book. Here are some examples:</para> 21 21 22 22 <screen><userinput>./configure --prefix=/usr</userinput></screen> 23 23 24 24 <blockquote> 25 <para>This form of text is designed to be typed exactly as seen unless25 <para>This form of text should be typed exactly as shown unless 26 26 otherwise noted in the surrounding text. It is also used to identify 27 27 references to specific commands.</para> … … 32 32 33 33 <blockquote> 34 <para>This form of text (fixed width text) is showingscreen35 output, probably a result fromissuing a command. It is also used to34 <para>This form of text (fixed width font) shows screen 35 output, probably the result of issuing a command. It is also used to 36 36 show filenames such as <filename>/boot/grub/grub.conf</filename></para> 37 37 </blockquote> … … 40 40 41 41 <blockquote> 42 <para>This form of text is used for several purposes in the43 b ook but mainly to emphasize important points or to give examples as to42 <para>This form of text is used for several purposes, 43 but mainly to emphasize important points, or to give examples of 44 44 what to type.</para> 45 45 </blockquote> … … 49 49 <blockquote> 50 50 <para>This form of text is used for hypertext links external to 51 the book such as HowTos, download locations, websites, etc.</para>51 the book, such as HowTos, download locations, websites, etc.</para> 52 52 </blockquote> 53 53 … … 56 56 <blockquote> 57 57 <para>This form of text is used for links internal to 58 the book such as another section describing a different package.</para>58 the book, such as another section describing a different package.</para> 59 59 </blockquote> 60 60 … … 66 66 67 67 <blockquote> 68 <para>This type of section is used mainlywhen creating configuration68 <para>This style is mainly used when creating configuration 69 69 files. The first command (in bold) tells the system to create 70 70 the file <filename>$LFS/etc/group</filename> from whatever is typed on the 71 following lines until the sequence EOF is encountered. 72 Therefore, this whole section is generally typed as seen.</para> 71 following lines, until the sequence EOF is encountered. 72 Therefore, this whole section is usually typed exactly as shown. 73 Remember, copy and paste is your friend!</para> 73 74 </blockquote> 74 75 … … 77 78 <blockquote> 78 79 <para>This form of text is used to encapsulate text that should be 79 modified and is not to be typed as seen, or copy and pasted. Note that80 the square brackets are not part of the text, but should be substituted81 for as well.</para>80 modified, and is not to be typed as shown, or copied and pasted. 81 The angle brackets are not part of the literal text; they are part of the 82 substitution.</para> 82 83 </blockquote> 83 84 … … 89 90 </blockquote> 90 91 92 <para> </para> <!-- add extra white space to improve readability --> 91 93 </sect2> 92 94 … … 94 96 <title>Conventions Used for Package Dependencies</title> 95 97 96 <para>When packages are created, theauthors depend on prior work. In97 order to build a package in BLFS, these dependencies must be built prior to98 the desired package . For each package, any prerequisite packages are listed98 <para>When new packages are created, the software's authors depend on prior work. In 99 order to build a package in BLFS, these dependencies must be built before 100 the desired package can be compiled. For each package, prerequisites are listed 99 101 in one or more separate sections: Required, Recommended, and Optional.</para> 100 102 101 103 <bridgehead renderas="sect3">Required Dependencies</bridgehead> 102 104 103 <para>These dependencies are the minimum prerequisite packages required to 104 build the package. Omitted from the list are packages in LFS and required 105 dependencies of other required packages.</para> 105 <para>These dependencies are the bare minimum needed to 106 build the package. Packages in LFS, and the required 107 dependencies of these required packages, are omitted from this list. 108 Always remember to check for nested dependencies.</para> 106 109 107 110 <bridgehead renderas="sect3">Recommended Dependencies</bridgehead> 108 111 109 <para>These dependencies are those thatthe BLFS editors have determined112 <para>These are dependencies the BLFS editors have determined 110 113 are important to give the package reasonable capabilities. Package 111 114 installation instructions assume they are installed. If a recommended 112 package is not desired, the instructions may need to be modifiedto115 package is not installed, the instructions may require modification, to 113 116 accommodate the missing package.</para> 114 117 115 118 <bridgehead renderas="sect3">Optional Dependencies</bridgehead> 116 119 117 <para>These dependencies are those that the package may use. Integration 118 of optional dependencies may be automatic by the package or may need 119 additional instructions not presented by BLFS. Optional packages may be 120 listed without corresponding BLFS instructions. In this case it is up to 121 the user to determine appropriate installation instructions. </para> 122 120 <para>These are dependencies the package <emphasis>may</emphasis> use. Integration 121 of optional dependencies may be automatic by the package, or 122 additional steps not presented by BLFS may be necessary. Optional dependencies are 123 sometimes listed without explicit BLFS instructions. In this case you must 124 determine how to perform the installation yourself. </para> 125 126 <para> </para> <!-- add extra white space to improve readability --> 123 127 </sect2> 124 128 … … 126 130 <title>Conventions Used for Kernel Configuration Options</title> 127 131 128 <para>Some packages have specific needs regarding the kernel configuration.129 The general layout is the following:</para>132 <para>Some packages require specific kernel configuration options. 133 The general layout for these looks like this:</para> 130 134 131 135 <screen><literal>Master section ---> … … 139 143 140 144 <para>[CONFIG_...] on the right gives the name of the option, so you can 141 easily check whether it is set in your <filename> config</filename> file.145 easily check whether it is set in your <filename>.config</filename> file. 142 146 The meaning of the various entries is: 143 147 … … 157 161 <emphasis role="bold">Required parameter</emphasis></entry> 158 162 <entry> 159 the option c ould be either built-inor not selected: it must be163 the option can either be built-in, or not selected: it must be 160 164 selected 161 165 </entry> … … 167 171 </entry> 168 172 <entry> 169 the option c ould be either built-in, module, or not selected:173 the option can be built-in, a module, or not selected (tri-state): 170 174 it must be selected as built-in 171 175 </entry> … … 177 181 </entry> 178 182 <entry> 179 the option c ould be either built-in,module, or not selected:180 it must be selected, either as built-in or module183 the option can be built-in, a module, or not selected: 184 it must be selected, either as built-in or as a module 181 185 </entry> 182 186 </row> … … 186 190 </entry> 187 191 <entry> 188 rarely used: the option c ould be either built-in,module, or not189 selected: it may be se lected at will192 rarely used: the option can be built-in, a module, or not 193 selected: it may be set any way you wish 190 194 </entry> 191 195 </row> … … 195 199 </entry> 196 200 <entry> 197 the option c ould be eitherbuilt-in or not selected: it must201 the option can either be built-in or not selected: it must 198 202 <emphasis>not</emphasis> be selected 199 203 </entry> … … 204 208 </entry> 205 209 <entry> 206 the option c ould be either built-in,module, or not selected:210 the option can be built-in, a module, or not selected: 207 211 it must <emphasis>not</emphasis> be selected 208 212 </entry> … … 213 217 214 218 <para>Note that, depending on other selections, the angle brackets 215 (<>) may appear as braces ({}),if the option cannot be unselected,216 or even dashes (-*- or -M-), when the choice is imposed.217 The help text aboutthe option specifies the other selections on which this219 (<>) in the configuration menu may appear as braces ({}) if the option cannot be unselected, 220 or even as dashes (-*- or -M-), when the choice is imposed. 221 The help text describing the option specifies the other selections on which this 218 222 option relies, and how those other selections are set.</para> 219 223 224 <para> </para> <!-- add extra white space to improve readability --> 220 225 </sect2> 221 226 … … 225 230 <para>As in LFS, each package in BLFS has a build time listed in Standard 226 231 Build Units (SBUs). These times are relative to the time it took to build 227 binutils in LFS and are intended to provide some insight into how long it232 binutils in LFS, and are intended to provide some insight into how long it 228 233 will take to build a package. Most times listed are for a single processor 229 234 or core to build the package. In some cases, large, long running builds … … 232 237 multiple cores. Note that while this speeds up the build on systems with 233 238 the appropriate hardware, the speedup is not linear and to some extent 234 depends on the individual package and specific hardware used. </para>235 236 <para>For packages which use ninja ( e.g.anything using meson) or rust, by237 default all cores are used sosimilar comments will be seen on such packages239 depends on the individual package and the specific hardware used. </para> 240 241 <para>For packages which use ninja (i.e., anything using meson) or rust, by 242 default all cores are used; similar comments will be seen on such packages 238 243 even when the build time is minimal.</para> 239 244 … … 241 246 machines the time may be considerably greater even when the build does not 242 247 use swap. In particular, different micro-architectures will build some 243 files at different relative speeds and this can introduce delays when248 files at different relative speeds, and this can introduce delays when 244 249 certain make targets wait for another file to be created. Where a large 245 250 build uses a lot of C++ files, processors with Simultaneous Multi Threading … … 248 253 other cores idle).</para> 249 254 250 <para>Some packages do not support parallel builds and using -j1 forthe251 make command is required. Packages that are known to have such limits are252 marked as suchin the text.</para>255 <para>Some packages do not support parallel builds; for these, the 256 make command must specify -j1. Packages that are known to impose such limits are 257 so marked in the text.</para> 253 258 254 259 </sect2>
Note:
See TracChangeset
for help on using the changeset viewer.