os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Lots of tagging and sgml'ification.

Browse source
This commit is contained in:
Giorgos Keramidas 2002-09-08 00:45:37 +00:00
parent ab606601e4
commit 3961e184b2
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=14206
1 changed files with 14 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
en_US.ISO8859-1/articles/releng-packages/article.sgml
View file

@ -179,7 +179,7 @@
<listitem><para>This script removes lines from an <filename>INDEX</filename> file <listitem><para>This script removes lines from an <filename>INDEX</filename> file
for packages that aren't present. It also removes the for packages that aren't present. It also removes the
XFree86 dependencies. NOTE: you'll need to tweak the value XFree86 dependencies. NOTE: you'll need to tweak the value
of the xdep variable to make sure the version number is of the <varname>xdep</varname> variable to make sure the version number is
correct.</para></listitem> correct.</para></listitem>
</varlistentry> </varlistentry>
@ -201,7 +201,7 @@
them want to contain packages, distfiles, both, or them want to contain packages, distfiles, both, or
neither.</para></listitem> neither.</para></listitem>
<listitem><para>Make sure you remove the gen directory if <listitem><para>Make sure you remove the <varname>gen</varname> directory if
there's an old one laying around. This directory contains there's an old one laying around. This directory contains
working files that will only be valid for the current working files that will only be valid for the current
split.</para></listitem> split.</para></listitem>
@ -210,9 +210,9 @@
fake the copying of packages and distfiles. This will save fake the copying of packages and distfiles. This will save
both time and diskspace while you do a couple of trial runs to both time and diskspace while you do a couple of trial runs to
make sure things fit, etc. In the make sure things fit, etc. In the
<filename>oneshot.pl</filename> set the fake variable <filename>oneshot.pl</filename> set the <varname>fake</varname> variable
to 1 and instead of actually copying the files it will to 1 and instead of actually copying the files it will
&man.touch.1; them. Be sure you turn this off or set fake to &man.touch.1; them. Be sure you turn this off or set <varname>fake</varname> to
0 before you give the resultant discs to the person that will 0 before you give the resultant discs to the person that will
be mastering the discs otherwise they'll get a directory full be mastering the discs otherwise they'll get a directory full
of zero-sized files.</para></listitem> of zero-sized files.</para></listitem>
@ -236,7 +236,7 @@
<orderedlist> <orderedlist>
<listitem><para>Grab a copy of <filename>ports.tar.gz</filename> <listitem><para>Grab a copy of <filename>ports.tar.gz</filename>
and extract it into the ports directory alongside and extract it into the <filename>ports</filename> directory alongside
<filename>doit.sh</filename> and the <filename>doit.sh</filename> and the
<Filename>scripts</filename> directory.</para></listitem> <Filename>scripts</filename> directory.</para></listitem>
@ -276,8 +276,8 @@
non-cdromable packages/distfiles. Most of the time you'll non-cdromable packages/distfiles. Most of the time you'll
want to answer (y)es here.</para></listitem> want to answer (y)es here.</para></listitem>
<listitem><para>Copies the <filename>INDEX</filename> from the ports directory to the <listitem><para>Copies the <filename>INDEX</filename> from the <filename>ports</filename> directory to the
gen directory. In doing so it removes the lines for ports <filename>gen</filename> directory. In doing so it removes the lines for ports
where the packages don't exist. It also checks to make sure where the packages don't exist. It also checks to make sure
that all of the required dependency packages are that all of the required dependency packages are
present.</para></listitem> present.</para></listitem>
@ -288,7 +288,7 @@
<listitem><para>Asks you if you'd like to populate the discs. <listitem><para>Asks you if you'd like to populate the discs.
After populating each disc it will check for missing After populating each disc it will check for missing
dependencies, scrub the <filename>INDEX</filename> file, and create the dependencies, scrub the <filename>INDEX</filename> file, and create the
CHECKSUM.MD5 file.</para></listitem> <filename>CHECKSUM.MD5</filename> file.</para></listitem>
<listitem><para>Check to make sure the required packages made it <listitem><para>Check to make sure the required packages made it
on each disc and gives you a summary of the sizes of each on each disc and gives you a summary of the sizes of each
@ -297,18 +297,18 @@
<para>After going through this the first time if you are lucky <para>After going through this the first time if you are lucky
enough that all of the required packages built and fit on each enough that all of the required packages built and fit on each
disc. All you need to do is set fake to 0 in disc. All you need to do is set <varname>fake</varname> to 0 in
<Filename>oneshot.pl</filename> and re-run <Filename>oneshot.pl</filename> and re-run
<command>./doit.sh</command>. The second and subsequent times <command>./doit.sh</command>. The second and subsequent times
around it will skip steps 1-5 above. If you want to re-run any around it will skip steps 1-5 above. If you want to re-run any
of those steps refer to doit.sh for which files need to be of those steps refer to <filename>doit.sh</filename> for which files need to be
removed to not short-circuit those steps. If you want to repeat removed to not short-circuit those steps. If you want to repeat
all of these steps then the easiest way is to <command>rm -rf all of these steps then the easiest way is to <command>rm -rf
gen</command>.</para> gen</command>.</para>
<para>Upon successful completion the packages/distfiles will be in <para>Upon successful completion the packages/distfiles will be in
the <filename>disc*</filename> directories and the leftover will the <filename>disc*</filename> directories and the leftover will
be in the scratch directory.</para> be in the <filename>scratch</filename> directory.</para>
<para>What to do if things go wrong? Here's some common gotchas <para>What to do if things go wrong? Here's some common gotchas
and workarounds.</para> and workarounds.</para>
@ -320,7 +320,7 @@
<listitem><para>This is a pretty common occurrence. You'll <listitem><para>This is a pretty common occurrence. You'll
either need to wait for a new set of packages where the either need to wait for a new set of packages where the
missing packages were built or get someone to re-start the missing packages were built or get someone to re-start the
package build for you. DO NOT attempt to build the missing package build for you. <emphasis>Do not</emphasis> attempt to build the missing
packages on your own machine and add them into the fray. packages on your own machine and add them into the fray.
While you might be able to get away with this if you are While you might be able to get away with this if you are
extremely careful the vast majority of the time you'll miss extremely careful the vast majority of the time you'll miss
@ -333,9 +333,9 @@
<term>Required packages won't fit</term> <term>Required packages won't fit</term>
<listitem><para>This happens on occasion too and is relatively <listitem><para>This happens on occasion too and is relatively
easy to fix. Simply edit print-cdrom-packages.sh to move easy to fix. Simply edit <filename>print-cdrom-packages.sh</filename> to move
packages around until they fit. Yes this is an iterative packages around until they fit. Yes this is an iterative
process and one of the reasons why you should enable fake in process and one of the reasons why you should enable <varname>fake</varname> in
<filename>oneshot.pl</filename> until you have gotten <filename>oneshot.pl</filename> until you have gotten
things the way you want them. Re-run things the way you want them. Re-run
<command>./doit.sh</command> after you made your <command>./doit.sh</command> after you made your