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

Expand contractions.

Browse source
This commit is contained in:
Giorgos Keramidas 2002-09-08 00:52:47 +00:00
parent 3961e184b2
commit a311df7b45
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=14207
1 changed files with 30 additions and 30 deletions

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

@ -125,8 +125,8 @@
given disc. The first column is the disc name. It must be
of the form <literal>disc[0-9a-z]</literal>. Currently it is setup to allow
for 10 discs (4 for the release set and 6 for the toolkit).
There's an implied extra disc called <quote>scratch</quote> where all of
the remaining distfiles/packages land if they don't fit
There is an implied extra disc called <quote>scratch</quote> where all of
the remaining distfiles/packages land if they do not fit
elsewhere. The second column can be either a 1 or 0, where 1
says that it is okay to place packages on this disc. The
third column works the same way, but it controls
@ -177,8 +177,8 @@
<term><filename>scrubindex.pl</filename></term>
<listitem><para>This script removes lines from an <filename>INDEX</filename> file
for packages that aren't present. It also removes the
XFree86 dependencies. NOTE: you'll need to tweak the value
for packages that are not present. It also removes the
XFree86 dependencies. NOTE: you will need to tweak the value
of the <varname>xdep</varname> variable to make sure the version number is
correct.</para></listitem>
</varlistentry>
@ -192,7 +192,7 @@
</varlistentry>
</variablelist>
<para>Here's a checklist of things you'll need to check or
<para>Here is a checklist of things you will need to check or
configure before going any further.</para>
<orderedlist>
@ -202,7 +202,7 @@
neither.</para></listitem>
<listitem><para>Make sure you remove the <varname>gen</varname> directory if
there's an old one laying around. This directory contains
there is an old one laying around. This directory contains
working files that will only be valid for the current
split.</para></listitem>
@ -214,7 +214,7 @@
to 1 and instead of actually copying the files it will
&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
be mastering the discs otherwise they'll get a directory full
be mastering the discs otherwise they will get a directory full
of zero-sized files.</para></listitem>
<listitem><para>Make sure you have a recent copy of the
@ -223,15 +223,15 @@
<listitem><para>Check to make sure the XFree86 dependency in
<filename>scrubindex.pl</filename> has the correct
version number. You'll also need to make sure this value is
version number. You will also need to make sure this value is
correct in <filename>doit.sh</filename> as
well.</para></listitem>
</orderedlist>
<para>Next you'll need to get a copy of the ports tree, packages,
<para>Next you will need to get a copy of the ports tree, packages,
and distfiles from a recent build on the package cluster. See
the <filename>setup.sh</filename> for a working example
but essentially here's what needs to be done.</para>
but essentially here is what needs to be done.</para>
<orderedlist>
@ -241,8 +241,8 @@
<Filename>scripts</filename> directory.</para></listitem>
<listitem><para>Remove the packages/distfiles directories or
symlinks. Bento has these as symlinks and you'll have mixed
results if you don't get rid of them before
symlinks. Bento has these as symlinks and you will have mixed
results if you do not get rid of them before
proceeding.</para></listitem>
<listitem><para>Create a new ports/packages directory and copy
@ -251,41 +251,41 @@
<listitem><para>Create a new ports/distfiles directory and copy
the distfiles from the package building cluster. NOTE: if you
don't want any distfiles simply create the directory and leave
it empty. This directory must be present even if it doesn't
do not want any distfiles simply create the directory and leave
it empty. This directory must be present even if it does not
contain anything.</para></listitem>
</orderedlist>
<para>Now we're finally ready for the fun task of actually
<para>Now we are finally ready for the fun task of actually
splitting the packages. You start the processing by running
<command>./doit.sh</command>. The first time you run it here's
<command>./doit.sh</command>. The first time you run it here is
what it does.</para>
<orderedlist>
<listitem><para>Create a list of the restricted (can't be on the
<listitem><para>Create a list of the restricted (can not be on the
master FTP site) ports.</para></listitem>
<listitem><para>Asks you if you'd like to remove the restricted
ports. Most of the time you'll want to answer (y)es
<listitem><para>Asks you if you would like to remove the restricted
ports. Most of the time you will want to answer (y)es
here.</para></listitem>
<listitem><para>Create a list of the packages/distfiles that
can't be put on the discs.</para></listitem>
can not be put on the discs.</para></listitem>
<listitem><para>Asks you if you'd like to remove the
non-cdromable packages/distfiles. Most of the time you'll
<listitem><para>Asks you if you would like to remove the
non-cdromable packages/distfiles. Most of the time you will
want to answer (y)es here.</para></listitem>
<listitem><para>Copies the <filename>INDEX</filename> from the <filename>ports</filename> directory to the
<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 do not exist. It also checks to make sure
that all of the required dependency packages are
present.</para></listitem>
<listitem><para>Create a list of packages that are required on
each disc.</para></listitem>
<listitem><para>Asks you if you'd like to populate the discs.
<listitem><para>Asks you if you would like to populate the discs.
After populating each disc it will check for missing
dependencies, scrub the <filename>INDEX</filename> file, and create the
<filename>CHECKSUM.MD5</filename> file.</para></listitem>
@ -310,27 +310,27 @@
the <filename>disc*</filename> directories and the leftover will
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 is some common gotchas
and workarounds.</para>
<variablelist>
<varlistentry>
<term>Missing required packages</term>
<listitem><para>This is a pretty common occurrence. You'll
<listitem><para>This is a pretty common occurrence. You will
either need to wait for a new set of packages where the
missing packages were built or get someone to re-start the
package build for you. <emphasis>Do not</emphasis> attempt to build the missing
packages on your own machine and add them into the fray.
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 will miss
some little detail and the simple process of adding a
package could make hundreds of others come up mysteriously
broken.</para></listitem>
</varlistentry>
<varlistentry>
<term>Required packages won't fit</term>
<term>Required packages will not fit</term>
<listitem><para>This happens on occasion too and is relatively
easy to fix. Simply edit <filename>print-cdrom-packages.sh</filename> to move
@ -345,7 +345,7 @@
<varlistentry>
<term>Required packages not on the right (or any) disc</term>
<listitem><para>This usually means you didn't add them to
<listitem><para>This usually means you did not add them to
<filename>print-cdrom-packages.sh</filename> or you put them
on the wrong disc. This script is the gospel by which this
whole process determines where a package must be. If you
@ -355,7 +355,7 @@
</varlistentry>
</variablelist>
<para>If you get completely stuck and can't figure out why things
<para>If you get completely stuck and can not figure out why things
are borked or how to fix them then email &a.steve; for
assistance.</para>