source: soft/build_system/build_system/mkcd/trunk/mkcd.xml @ 1

Last change on this file since 1 was 1, checked in by fasma, 12 years ago

Initial Import from Mandriva's soft revision 224062 and package revision 45733

File size: 6.3 KB
Line 
1<?xml version="1.0" encoding="utf-8"?>
2<!DOCTYPE book
3  PUBLIC "-//Norman Walsh//DTD DocBk XML V4.1.2//EN"
4  "/usr/share/sgml/docbook/xml-dtd-4.1.2/docbookx.dtd">
5
6<!-- Linux-Mandrake policy document -->
7
8<book><title>MKCD</title>
9  <bookinfo>
10    <title>MKCD</title>
11    <subtitle>MKCD distribution disc builder</subtitle>
12    <authorgroup>
13      <author><firstname>Florent</firstname><surname>Villard</surname></author>
14    </authorgroup>
15    <legalnotice>
16      <copyright><year>2001</year><year>2002</year><holder>Florent Villard, MandrakeSoft</holder></copyright>
17      <para>
18        This manual is free software; you may redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.
19        </para>
20      <para>
21        This is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See the GNU General Public License for more details.
22        </para>
23      <para>
24        A copy of the GNU General Public License is available as /usr/share/common-licences/GPL in the Debian GNU/Linux distribution or on the World Wide Web at The GNU Public Licence. You can also obtain it by writing to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
25        </para>
26    </legalnotice>
27    <pubdate>Jul. 08, 2002</pubdate>
28  </bookinfo>
29 
30  <part>
31    <docinfo>
32                <title>Prerequisites</title>
33        </docinfo>
34    <title>Prerequisites</title>
35    <partintro>
36      <title>Introduction</title>
37      <para>This part explain how the install works, and why mkcd is needed to create the installation discs.
38                        </para>
39    </partintro>
40
41    <chapter>
42      <docinfo><title>Installation</title><subtitle>Short description of the install and important files.</subtitle>
43        </docinfo><title>Installation</title>
44     
45      <sect1><title>Required files for an installation</title>
46        <para>I will focused on disc based installation, there are some few differences for network and other type of installation medias.
47The required files to make a installation disc are located in /Mandrake/mdkinst and /Mandrake/base/
48        </para>
49      </sect1>
50      <sect1><title>Optional files</title>
51        <para>
52        </para>
53      </sect1>
54      <sect1><title>Configuration files</title>
55        <para>in /:
56<itemizedlist>
57<listitem>VERSION</listitem>
58</itemizedlist>
59
60in Mandrake/base/
61<itemizedlist>
62<listitem>compssUser</listitem>
63<listitem>compss</listitem>
64<listitem>compssUsers</listitem>
65<listitem>depslist.ordered</listitem>
66<listitem>filelist</listitem>
67<listitem>hdlist.cz</listitem>
68<listitem>hdlists</listitem>
69<listitem>mdkinst_stage2.bz2</listitem>
70<listitem>pkglist.cooker</listitem>
71<listitem>pkglist.cooker.bz2</listitem>
72<listitem>provides</listitem>
73<listitem>rescue_stage2.bz2</listitem>
74<listitem>rpmslist</listitem>
75<listitem>rpmsrate</listitem>
76<listitem>srclist.cooker</listitem>
77<listitem>srclist.cooker.bz2</listitem>
78</itemizedlist>
79
80        </para>
81      </sect1>
82    </chapter>
83   
84   
85    <chapter>
86      <docinfo><title>Building a distribution by hand</title><subtitle>Steps to build manually a set of installation discs</subtitle>
87        </docinfo><title>Building a distribution by hand</title>
88        <para>Building a distribution by hand is kind of easy in theory, just have to
89copy the required installation files in a repository, populate /Mandrake/RPMS with packages,
90write some config files about how many packages directories will be used, generate
91the dependencies files with gendistrib, build the ISO images and that's it.
92        </para>
93     
94      <sect1><title>Set up the fixed part</title>
95      <para>
96                </para>
97      </sect1>
98      <sect1><title>Split the packages</title>
99        <para>
100        </para>
101      </sect1>
102      <sect1><title>Generate dependencies files</title>
103        <para>
104        </para>
105      </sect1>
106    </chapter>
107
108    <chapter>
109      <docinfo><title>Automatization</title><subtitle>Part that can be done automatically</subtitle>
110        </docinfo><title>Automatization</title>
111      <para>
112                </para>
113      <sect1><title>Package sorting</title>
114        <para>
115        </para>
116      </sect1>
117      <sect1><title>Package splitting</title>
118        <para>
119        </para>
120      </sect1>
121    </chapter>
122
123  </part>
124
125  <part>
126    <docinfo>
127                <title>Basic use</title>
128        </docinfo>
129    <title>Basic use</title>
130
131    <chapter>
132      <docinfo><title>Standard discs set</title><subtitle></subtitle>
133        </docinfo><title>Standard discs set</title>
134      <para>
135                </para>
136      <sect1><title>One standard installation disc</title>
137        <para>
138<programlisting>
139Cooker
140LIST 1 input/cooker/main
141/cooker/i586/Mandrake/base/RPMS /cooker/SRPMS
142
143DISC 1 681000000 COOKER0101 DISC 1 Installation CD (x86)
144dir rpms Mandrake/RPMS
145generic --synthesis rpms 1
146advertising en/image1.png en/image2.png en/image3.png
147advertising -l de de/image1.png de/image2.png de/image3.png
148advertising -l fr fr/image1.png fr/image2.png fr/image3.png
149installation -o 50,3,0.1 --synthesis -l fr,en,de -t Cooker-i586 -i /cooker/i586/ 1/rpms
150boot -b -d Boot images/cdrom.img -f /cooker/i586/images
151</programlisting>
152        </para>
153
154<para>
155<programlisting>
156INSTALL section,force
157SYSTEM section,rate 20
158MySQL-bench exclude
159svgalib limit,regexp
160netscape-navigator noalternatives,ignore,nosrc
161netscape regexp,nosrc
162mandrake_doc regexp,nosrc
163kdebase force
164kde-i18n rate 10,regexp,nosrc
165koffice-i18n rate 10,regexp,nosrc
166koffice force
167.*drake regexp,rate 20
168drak.* regexp,rate 20
169abiword rate 10
170tuxracer rate 10
171vim-minimal force
172drakfirsttime force
173kdebase-nsplugins rate 4
174locales force,regexp
175kernel(.*(linus|mosix|xfs)) regexp,noalternatives
176kernel(?!.*(source)) regexp,force
177kernel-source rate 10
178.* regexp
179</programlisting>
180</para>
181      </sect1>
182      <sect1><title>Several disc set</title>
183        <para>
184        </para>
185      </sect1>
186    </chapter>
187
188    <chapter>
189      <docinfo><title>Update discs</title><subtitle>Standard distribution with updated packages</subtitle>
190        </docinfo><title>Update discs</title>
191      <para>
192                </para>
193      <sect1><title>Basic disc without installation</title>
194        <para>
195        </para>
196      </sect1>
197      <sect1><title>Installation updates disc</title>
198        <para>
199        </para>
200      </sect1>
201    </chapter>
202
203
204  </part>
205  <part>
206    <docinfo>
207                <title>Advanced Use</title>
208        </docinfo>
209    <title>Advanced Use</title>
210  </part>
211
212  <part>
213    <docinfo>
214                <title>Work to do</title>
215        </docinfo>
216    <title>Work to do</title>
217  </part>
218
219</book>
Note: See TracBrowser for help on using the repository browser.