source: template/template.xml@ 3b4a48a

10.0 10.1 11.0 6.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 3b4a48a was 3b4a48a, checked in by Randy McMurchy <randy@…>, 17 years ago

Modified template skeleton to include building as one user and installing as the root user

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

  • Property mode set to 100644
File size: 5.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!-- Place this in the general.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]>
18
19<sect1 id="TEMPLATE-package" xreflabel="TEMPLATE-&TEMPLATE-version;">
20<sect1info>
21<othername>$LastChangedBy$</othername>
22<date>$Date$</date>
23</sect1info>
24<?dbhtml filename="TEMPLATE.html"?>
25<title><application>TEMPLATE</application>-&TEMPLATE-version;</title>
26<indexterm zone="TEMPLATE-package">
27<primary sortas="a-TEMPLATE">TEMPLATE</primary></indexterm>
28
29<sect2>
30<title>Introduction to <application>TEMPLATE</application></title>
31
32<para>The <application>TEMPLATE</application> package contains...
33This is useful for...</para>
34
35<sect3><title>Package information</title>
36<itemizedlist spacing="compact">
37<listitem><para>Download (HTTP):
38<ulink url="&TEMPLATE-download-http;"/></para></listitem>
39<listitem><para>Download (FTP):
40<ulink url="&TEMPLATE-download-ftp;"/></para></listitem>
41<listitem><para>Download MD5 sum:
42&TEMPLATE-md5sum;</para></listitem>
43<listitem><para>Download size:
44&TEMPLATE-size;</para></listitem>
45<listitem><para>Estimated disk space required:
46&TEMPLATE-buildsize;</para></listitem>
47<listitem><para>Estimated build time:
48&TEMPLATE-time;</para></listitem></itemizedlist>
49</sect3>
50
51<sect3><title>Additional downloads</title>
52<itemizedlist spacing="compact">
53<listitem><para>Required patch: <ulink
54url="&patch-root;/TEMPLATE-&TEMPLATE-version;-patch_name-patch_version.patch"/></para>
55</listitem></itemizedlist>
56</sect3>
57
58<sect3><title><application>TEMPLATE</application> dependencies</title>
59<sect4><title>Required</title>
60<para><xref linkend="BLFS DEPENDENCY"/></para>
61</sect4>
62
63<sect4><title>Optional</title>
64<para><ulink url="http://www.some.url/">EXTERNAL DEPENDENCY</ulink></para>
65</sect4>
66</sect3>
67
68</sect2>
69
70<sect2>
71<title>Installation of <application>TEMPLATE</application></title>
72
73<para>Install <application>TEMPLATE</application> by running the following
74commands:</para>
75
76<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
77make</command></userinput></screen>
78
79<para>Now, as the root user:</para>
80
81<screen><userinput><command>make install</command></userinput></screen>
82
83</sect2>
84
85<sect2>
86<title>Command explanations</title>
87
88<para><command>COMMAND</command>: This command does something.</para>
89
90<para><parameter>--SWITCH=PARAMETER</parameter>: This parameter does
91something mandatory for BLFS purposes.</para>
92
93<para><option>--OPTION</option>: This option does something optionally
94per the user's desires.</para>
95
96</sect2>
97
98<sect2>
99<title>Configuring <application>TEMPLATE</application></title>
100
101<sect3 id="TEMPLATE-config"><title>Config files</title>
102<para><filename>~/.Configfilename1</filename> and
103<filename>/etc/path/Configfilename2</filename></para>
104
105<indexterm zone="TEMPLATE-package TEMPLATE-config">
106<primary sortas="e-AA.Configfilename1">~/.Configfilename1</primary>
107</indexterm>
108<indexterm zone="TEMPLATE-package TEMPLATE-config">
109<primary sortas="e-etc-path-Configfilename2">/etc/path/Configfilename2</primary>
110</indexterm>
111</sect3>
112
113<sect3><title>Configuration information</title>
114
115<para><userinput>USERINPUT GOES HERE</userinput> Blah blah blah about config.
116</para>
117
118<para id="TEMPLATE-init">To automatically start the
119<command>TEMPLATE</command> daemon when the system is rebooted, install the
120<filename>/etc/rc.d/init.d/TEMPLATE</filename> bootscript from the
121<xref linkend="intro-important-bootscripts"/> package.</para>
122<indexterm zone="TEMPLATE-package TEMPLATE-init">
123<primary sortas="f-TEMPLATE">TEMPLATE</primary></indexterm>
124
125<screen><userinput><command>make install-TEMPLATE</command></userinput></screen>
126</sect3>
127
128</sect2>
129
130<sect2>
131<title>Contents</title>
132
133<segmentedlist>
134<segtitle>Installed Program(s)</segtitle>
135<segtitle>Installed Librar(y,ies)</segtitle>
136<segtitle>Installed Director(y,ies)</segtitle>
137<seglistitem>
138<seg>PROGRAM1, PROGRAM2 and PROGRAM3</seg>
139<seg>libLIBRARY1, libLIBRARY2 and libLIBRARY3</seg>
140<seg>/etc/TEMPLATE, /usr/include/TEMPLATE, /usr/lib/TEMPLATE,
141/usr/share/TEMPLATE-&TEMPLATE-version;,
142/usr/share/doc/TEMPLATE-&TEMPLATE-version; and
143/var/lib/TEMPLATE</seg>
144</seglistitem>
145</segmentedlist>
146
147<variablelist>
148<bridgehead renderas="sect3">Short Descriptions</bridgehead>
149<?dbfo list-presentation="list"?>
150
151<varlistentry id="PROGRAM1">
152<term><command>PROGRAM1</command></term>
153<listitem><para>does this .....</para>
154<indexterm zone="TEMPLATE-package PROGRAM1">
155<primary sortas="b-PROGRAM1">PROGRAM1</primary></indexterm>
156</listitem>
157</varlistentry>
158
159<varlistentry id="PROGRAM2">
160<term><command>PROGRAM2</command></term>
161<listitem><para>does this .....</para>
162<indexterm zone="TEMPLATE-package PROGRAM2">
163<primary sortas="d-PROGRAM2">PROGRAM2</primary></indexterm>
164</listitem>
165</varlistentry>
166
167<varlistentry id="libLIBRARY1">
168<term><filename class='libraryfile'>libLIBRARY1.[so,a]</filename></term>
169<listitem><para>contains functions that .....</para>
170<indexterm zone="TEMPLATE-package libLIBRARY1">
171<primary sortas="c-libLIBRARY1">libLIBRARY1.[so,a]</primary></indexterm>
172</listitem>
173</varlistentry>
174</variablelist>
175
176</sect2>
177
178</sect1>
179
Note: See TracBrowser for help on using the repository browser.