source: template/template.xml@ 6375ab4

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
Last change on this file since 6375ab4 was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 18 months ago

Remove sect1info tags

They only contain a date tag that is nowhere used.
  • Property mode set to 100644
File size: 15.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!-- Place this in the packages.ent file
8 <!ENTITY TEMPLATE-version "">
9 -->
10
11 <!ENTITY TEMPLATE-download-http "http://">
12 <!ENTITY TEMPLATE-download-ftp "ftp://">
13 <!ENTITY TEMPLATE-md5sum "MD5 sum">
14 <!ENTITY TEMPLATE-size "?? MB">
15 <!ENTITY TEMPLATE-buildsize "?? MB">
16 <!ENTITY TEMPLATE-time "?? SBU">
17<!-- SBU should be rounded to nearer integer if greater than 10, to one
18 decimal if less than 10, and should be "less than 0.1 SBU" if
19 less than 0.1. If the SBU without parallelisation is too long,
20 it is acceptable to give the value "with parallelism=N", where
21 N is the number of threads used. Note that some build systems
22 automatically fix N equal to the number of available CPU cores
23 on the machine. -->
24]>
25
26<!-- Try to keep the indentation used in this file-->
27<sect1 id="TEMPLATE" xreflabel="TEMPLATE-&TEMPLATE-version;">
28 <?dbhtml filename="TEMPLATE.html"?>
29
30
31 <!-- No other tags inside any title.
32 Use Title Case in All Titles
33 (i.e., Capitalize Everything
34 *Except* Articles, Short Prepositions,
35 and Coordinating Conjunctions.-->
36 <title>TEMPLATE-&TEMPLATE-version;</title>
37
38 <indexterm zone="TEMPLATE">
39 <primary sortas="a-TEMPLATE">TEMPLATE</primary>
40 </indexterm>
41
42 <!--Required section-->
43 <sect2 role="package">
44 <title>Introduction to TEMPLATE</title>
45
46 <para>
47 The <application>TEMPLATE</application> package contains...
48 This is useful for...
49 </para>
50
51 <!-- if it builds but hasn't been tested: -->
52 &lfs1?_built;
53 <!-- if it works: -->
54 &lfs1?_checked;
55
56 <bridgehead renderas="sect3">Package Information</bridgehead>
57 <itemizedlist spacing="compact">
58 <listitem>
59 <para>
60 Download (HTTP): <ulink url="&TEMPLATE-download-http;"/>
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download (FTP): <ulink url="&TEMPLATE-download-ftp;"/>
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Download MD5 sum: &TEMPLATE-md5sum;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Download size: &TEMPLATE-size;
76 </para>
77 </listitem>
78 <listitem>
79 <para>
80 Estimated disk space required: &TEMPLATE-buildsize;
81 </para>
82 </listitem>
83 <listitem>
84 <para>
85 Estimated build time: &TEMPLATE-time;
86 </para>
87 </listitem>
88 </itemizedlist>
89
90 <!-- As required -->
91 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
92 <itemizedlist spacing="compact">
93 <listitem>
94 <para>
95 Required patch:
96 <ulink url="&patch-root;/TEMPLATE-&TEMPLATE-version;-patch_name-patch_version.patch"/>
97 </para>
98 </listitem>
99 </itemizedlist>
100
101 <bridgehead renderas="sect3">TEMPLATE Dependencies</bridgehead>
102
103 <bridgehead renderas="sect4">Required</bridgehead>
104 <para role="required">
105 <xref linkend="BLFS_DEPENDENCY"/> <!-- notice no period as this is not
106 a sentence. If there are more than two, they must be separated by commas
107 with the last member having "and" in front of it. The use of a serial
108 comma is preferred (a comma after the next to last member before the
109 "and"). BLFS_DEPENDENCY should be an "id" attribute defined somewhere
110 in the book (usually in a <sect1>). -->
111 <xref role="runtime" linkend="RUNTIME_DEPENDENCY"/> (runtime)
112 <!-- Specifying that a dependency is a runtime one may avoid circular
113 dependencies. Add role="runtime" to help jhalfs -->
114 </para>
115
116 <!-- It may be nice to have a separate section for runtime dependencies.
117 Do it as follows. -->
118 <bridgehead renderas="sect4">Required at runtime</bridgehead>
119 <para role="required">
120 <xref role="runtime" linkend="RUNTIME_DEPENDENCY"/>
121 </para>
122
123 <!-- As required -->
124 <bridgehead renderas="sect4">Recommended</bridgehead>
125 <para role="recommended">
126 <xref linkend="BLFS_DEPENDENCY"/> <!-- notice no period as this is not
127 a sentence. See above for the use of "and" and commas. Normally, neither
128 required nor recommended dependencies should be <ulink>. -->
129 <xref linkend="ANOTHER_RECOMMENDED_DEP"/> (required if building
130 <xref role="nodep" linkend="SOME_FANCY_PACKAGE"/>) <!-- You may need
131 to refer to another package, which is not a dependency. Use the role
132 attibute with value "nodep". -->
133 <!-- See above for runtime dependencies -->
134 </para>
135
136 <!-- As required -->
137 <bridgehead renderas="sect4">Optional</bridgehead>
138 <para role="optional">
139 <xref linkend="BLFS_DEPENDENCY"/> and
140 <ulink url="http://www.some.url/">EXTERNAL DEPENDENCY</ulink>
141 <!-- notice no period as this is not a sentence. See above for the use
142 of commas and "and". The order should be <xref> before <ulink>.-->
143 <!-- See above for references to another package which is not a
144 dependency. -->
145 </para>
146
147 <para condition="html" role="usernotes">
148 User Notes: <ulink url="&blfs-wiki;/TEMPLATE"/>
149 </para>
150 </sect2>
151
152 <!-- Optional section for packages that need a specific kernel
153 configuration-->
154 <sect2 role="kernel" id="TEMPLATE-kernel">
155 <title>Kernel Configuration</title>
156
157 <para>
158 Enable the following options in the kernel configuration and recompile the
159 kernel if necessary:
160 </para>
161
162<!-- Spaces are significant in <screen> sections -->
163<screen><literal>Master section ---&gt;
164 Subsection ---&gt;
165 [*] Required parameter [CONFIG_REQU_PAR]
166 &lt;*&gt; Required parameter (not as module) [CONFIG_REQU_PAR_NMOD]
167 &lt;*/M&gt; Required parameter (could be a module) [CONFIG_REQU_PAR_MOD]
168 &lt;*/M/ &gt; Optional parameter [CONFIG_OPT_PAR]
169 [ ] Incompatible parameter [CONFIG_INCOMP_PAR]
170 &lt; &gt; Incompatible parameter (even as module) [CONFIG_INCOMP_PAR_MOD]</literal></screen>
171
172 <para>
173 Select the appropriate sub-options that appear when the above options are
174 selected. As much as possible, the layout should be the same as in
175 kernel configuration menus.
176 </para>
177
178 <indexterm zone="TEMPLATE TEMPLATE-kernel">
179 <primary sortas="d-TEMPLATE">TEMPLATE</primary>
180 </indexterm>
181 </sect2>
182
183 <!--Required section-->
184 <sect2 role="installation">
185 <title>Installation of TEMPLATE</title>
186
187 <para>
188 Install <application>TEMPLATE</application> by running the following
189 commands:
190 </para>
191
192<!-- Spaces are significant in <screen> sections -->
193<screen><userinput>./configure --prefix=/usr --disable-static &amp;&amp;
194make</userinput></screen>
195
196 <!-- Optional paragraph. Add it when some instructions for building
197 documentation need optional or external packages. The remap="doc"
198 attribute signals that kind of instructions. Note: instructions
199 for generating documentation that can be built with
200 recommended/required/LFS book packages may be included in the
201 same block as configure and make. -->
202
203 <para>
204 If you have installed <xref linkend="optional-dep"/>, you can build
205 the documentation (or additional formats of the documentation) by issuing: </para>
206
207<screen remap="doc"><userinput>make -C doc pdf</userinput></screen>
208
209 <!-- adjust the instructions as needed. -->
210
211 <!-- Optional paragraph. Use one of the two formats below about the test
212 suite; delete the line that is not applicable. Of course, if the
213 test suite uses syntax other than 'make check', revise the
214 line to reflect the actual syntax to run the test suite -->
215
216 <para>
217 This package does not come with a test suite.
218 </para>
219
220 <para>
221 To test the results, issue: <command>make check</command>.
222 </para>
223
224 <!-- Sometimes, more complex instructions are needed for running tests, or
225 they need to be run as root. They can then be put inside screen
226 tags using the remap="test" attribute as in the following example: -->
227
228 <para>
229 If you want to run the tests, first create some needed files:
230 </para>
231
232<screen remap="test"><userinput>make prepare-tests</userinput></screen>
233
234 <para>
235 Then run the tests as the <systemitem class="username">root</systemitem>
236 user:
237 </para>
238
239<screen role="root" remap="test"><userinput>make tests</userinput></screen>
240
241 <para>
242 Now, as the <systemitem class="username">root</systemitem> user:
243 </para>
244
245<screen role="root"><userinput>make install</userinput></screen>
246 </sect2>
247
248 <!-- Optional paragraph for documentation that has been generated using
249 optional/external packages: -->
250
251 <para>
252 If you have built the optional documentation, install it as the
253 <systemitem class="username">root</systemitem> user:
254 </para>
255
256<screen role="root"
257 remap="doc"><userinput>install -vdm 755 /usr/share/doc/template-&template-version; &amp;&amp;
258mv doc/* /usr/share/doc/template-&template-version;</userinput></screen>
259
260 <!--Optional section-->
261 <sect2 role="commands">
262 <title>Command Explanations</title>
263
264 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
265 href="../../xincludes/static-libraries.xml"/>
266
267 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
268 href="../../xincludes/gtk-doc-rebuild.xml"/>
269
270 <para>
271 <command>COMMAND</command>: This command does something.
272 </para>
273
274 <para>
275 <parameter>--PARAMETER</parameter>: This parameter does something
276 mandatory for BLFS purposes. It will be in the instructions above. It is
277 not optional and is why it is listed as a parameter and not an option.
278 </para>
279
280 <para>
281 <option>--OPTION</option>: This option does something optionally per the
282 user's desires. It is not listed in the instructions above, but instead,
283 is listed here because many (some) readers may want to include it.
284 </para>
285 </sect2>
286
287 <sect2 role="using">
288 <title>Using TEMPLATE</title>
289
290 <para>
291 Stuff about how to use TEMPLATE to do something. This section is rarely
292 used.
293 </para>
294 </sect2>
295
296 <!--Optional section-->
297 <sect2 role="configuration">
298 <title>Configuring TEMPLATE</title>
299
300 <sect3 id="TEMPLATE-config">
301 <title>Config Files</title>
302 <para>
303 <filename>~/.Configfilename1</filename> and
304 <filename>/etc/path/Configfilename2</filename> <!-- notice no period as this is not a sentence-->
305 </para>
306
307 <indexterm zone="TEMPLATE TEMPLATE-config">
308 <primary sortas="e-AA.Configfilename1">~/.Configfilename1</primary>
309 </indexterm>
310
311 <indexterm zone="TEMPLATE TEMPLATE-config">
312 <primary
313 sortas="e-etc-path-Configfilename2">/etc/path/Configfilename2</primary>
314 </indexterm>
315 </sect3>
316
317 <sect3><title>Configuration Information</title>
318
319 <para>
320 Blah blah blah about config.
321 </para>
322
323<screen><userinput>USER CONFIG COMMANDS</userinput></screen>
324
325<screen role="root"><userinput>ROOT CONFIG COMMANDS</userinput></screen>
326
327 <!-- File creation. Add the appropriate <indexterm> block if needed.-->
328 <para>
329 Create the file .... for ...
330 </para>
331
332<screen role="root"><userinput>cat &gt;&gt; /PATH/FILENAME &lt;&lt; "EOF"
333<literal># Begin FILENAME
334
335TEXT
336
337# End FILENAME</literal>
338EOF</userinput></screen>
339 </sect3>
340
341 <sect3 id="TEMPLATE-init">
342 <title>Boot Script</title>
343
344 <para>
345 To automatically start the <command>TEMPLATE</command> daemon when the
346 system is rebooted, install the
347 <filename>/etc/rc.d/init.d/TEMPLATE</filename> bootscript from the
348 <xref linkend="bootscripts" revision="sysv"/>
349 <xref linkend="systemd-units" revision="systemd"/> package as the
350 <systemitem class="username">root</systemitem> user:
351 </para>
352
353 <indexterm zone="TEMPLATE TEMPLATE-init">
354 <primary sortas="f-TEMPLATE">TEMPLATE</primary>
355 </indexterm>
356
357<screen role="root"><userinput>make install-TEMPLATE</userinput></screen>
358 </sect3>
359 </sect2>
360
361 <!--Required section-->
362 <sect2 role="content">
363 <title>Contents</title>
364
365 <segmentedlist>
366 <segtitle>Installed Program(s)</segtitle>
367 <segtitle>Installed Librar(y,ies)</segtitle>
368 <segtitle>Installed Director(y,ies)</segtitle>
369
370 <!-- If there were no programs, libraries, or directories created, then
371 we would list the section as "None". However, a decision must have
372 been made to change the "None" to just removing the whole section
373 because I've noticed that many packages have had the "None"
374 removed and the section completely removed as well. The reasoning
375 was that by putting "None", it appears as if we know there are none.
376 Without anything it appears as we are not sure. -->
377
378 <seglistitem>
379 <seg>
380 PROGRAM1, PROGRAM2 and PROGRAM3<!-- no period here since it is not
381 a sentence -->
382 </seg>
383 <seg>
384 libLIBRARY1.so, libLIBRARY2.so and libLIBRARY3.so<!-- no period here
385 since it is not a sentence -->
386 </seg>
387 <seg>
388 /etc/TEMPLATE, /usr/include/TEMPLATE, /usr/lib/TEMPLATE,
389 /usr/share/TEMPLATE-&TEMPLATE-version;,
390 /usr/share/doc/TEMPLATE-&TEMPLATE-version; and
391 /var/lib/TEMPLATE<!-- no period here
392 since it is not a sentence -->
393 </seg>
394 </seglistitem>
395 </segmentedlist>
396
397 <variablelist>
398 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
399 <?dbfo list-presentation="list"?>
400 <?dbhtml list-presentation="table"?>
401
402 <!-- If the program or library name conflicts with (is the same as) the
403 package name, add -prog or -lib to the varlistentry entity id
404 and the 2nd entry of the indexterm zone entity -->
405
406 <varlistentry id="PROGRAM1">
407 <term><command>PROGRAM1</command></term>
408 <listitem>
409 <para>
410 does this ..... (no period at the end)
411 </para>
412 <indexterm zone="TEMPLATE PROGRAM1">
413 <primary sortas="b-PROGRAM1">PROGRAM1</primary>
414 </indexterm>
415 </listitem>
416 </varlistentry>
417
418 <varlistentry id="PROGRAM2">
419 <term><command>PROGRAM2</command></term>
420 <listitem>
421 <para>
422 does this ..... (no period at the end)
423 </para>
424 <indexterm zone="TEMPLATE PROGRAM2">
425 <primary sortas="b-PROGRAM2">PROGRAM2</primary>
426 </indexterm>
427 </listitem>
428 </varlistentry>
429
430 <varlistentry id="libLIBRARY1">
431 <term><filename class="libraryfile">libLIBRARY1.so</filename></term>
432 <listitem>
433 <para>
434 contains functions that ..... (no period at the end)
435 </para>
436 <indexterm zone="TEMPLATE libLIBRARY1">
437 <primary sortas="c-libLIBRARY1">libLIBRARY1.so</primary>
438 </indexterm>
439 </listitem>
440 </varlistentry>
441 </variablelist>
442 </sect2>
443</sect1>
Note: See TracBrowser for help on using the repository browser.