diff options
author | Giorgos Keramidas <keramida@FreeBSD.org> | 2002-09-08 01:01:42 +0000 |
---|---|---|
committer | Giorgos Keramidas <keramida@FreeBSD.org> | 2002-09-08 01:01:42 +0000 |
commit | eecc7b09b2a17fe614724c551d6e3f00e55b1763 (patch) | |
tree | 916577a61dea8dba78d98dd9012e6a65b4029a52 /en_US.ISO8859-1 | |
parent | 17cc9c98a8b73e67ff8c52eff285a54d2ad274ca (diff) | |
download | doc-eecc7b09b2a17fe614724c551d6e3f00e55b1763.tar.gz doc-eecc7b09b2a17fe614724c551d6e3f00e55b1763.zip |
Wrap long lines, and remove eol-whitespace.
Translators please ignore this change.
Notes
Notes:
svn path=/head/; revision=14209
Diffstat (limited to 'en_US.ISO8859-1')
-rw-r--r-- | en_US.ISO8859-1/articles/releng-packages/article.sgml | 74 |
1 files changed, 38 insertions, 36 deletions
diff --git a/en_US.ISO8859-1/articles/releng-packages/article.sgml b/en_US.ISO8859-1/articles/releng-packages/article.sgml index 72bbeb1098..05216d8f23 100644 --- a/en_US.ISO8859-1/articles/releng-packages/article.sgml +++ b/en_US.ISO8859-1/articles/releng-packages/article.sgml @@ -42,8 +42,8 @@ </abstract> </articleinfo> - - <!-- Introduction + + <!-- Introduction <sect1 id="introduction"> <title>Introduction</title> @@ -62,7 +62,7 @@ is responsible for maintaining a consistent ports tree that can be used to create the binary packages that accompany a given FreeBSD release.</para> - + <sect2> <title>The Ports Cluster</title> @@ -79,7 +79,7 @@ generate packages that might work on some systems and not on others depending on what software was previously installed.</para> - + <para>The <quote>Ports Cluster</quote> for the x86 architecture currently consists of a master node (Dual Pentium III 733MHz) and 8 slave nodes (Pentium III 800MHz) to do the actual @@ -87,7 +87,7 @@ build takes over 24 hours. These machines are co-located with the other FreeBSD Project equipment at Yahoo's corner of Exodus in Santa Clara, CA.</para> - + <para>The <quote>Ports Cluster</quote> for the Alpha architecture consists of 7 PWS 500A machines donated by Compaq and also co-located with Yahoo's facilities.</para> @@ -123,10 +123,10 @@ <listitem><para>This file contains the free space on each disc and whether packages, distfiles, or both are allowed on any 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 is an implied extra disc called <quote>scratch</quote> where all of - the remaining distfiles/packages land if they do not fit + 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 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 @@ -150,8 +150,8 @@ <term><filename>checkdeps.pl</filename></term> <listitem><para>Makes sure all packages dependencies are - satisfied given an <filename>INDEX</filename> file and a directory of - packages.</para></listitem> + satisfied given an <filename>INDEX</filename> file and a directory + of packages.</para></listitem> </varlistentry> <varlistentry> @@ -176,11 +176,11 @@ <varlistentry> <term><filename>scrubindex.pl</filename></term> - <listitem><para>This script removes lines from an <filename>INDEX</filename> file - 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> + <listitem><para>This script removes lines from an + <filename>INDEX</filename> file 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> <varlistentry> @@ -201,21 +201,21 @@ them want to contain packages, distfiles, both, or neither.</para></listitem> - <listitem><para>Make sure you remove the <varname>gen</varname> directory if - there is an old one laying around. This directory contains - working files that will only be valid for the current + <listitem><para>Make sure you remove the <varname>gen</varname> + directory if there is an old one laying around. This directory + contains working files that will only be valid for the current split.</para></listitem> <listitem><para>On your first pass through a split it is best to fake the copying of packages and distfiles. This will save both time and diskspace while you do a couple of trial runs to make sure things fit, etc. In the - <filename>oneshot.pl</filename> set the <varname>fake</varname> variable - 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 will get a directory full - of zero-sized files.</para></listitem> + <filename>oneshot.pl</filename> set the <varname>fake</varname> + variable 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 will get a + directory full of zero-sized files.</para></listitem> <listitem><para>Make sure you have a recent copy of the <filename>print-cdrom-packages.sh</filename> and that it is @@ -276,8 +276,9 @@ 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 + <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 do not exist. It also checks to make sure that all of the required dependency packages are present.</para></listitem> @@ -301,9 +302,9 @@ <Filename>oneshot.pl</filename> and re-run <command>./doit.sh</command>. The second and subsequent times around it will skip steps 1-5 above. If you want to re-run any - 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 - all of these steps then the easiest way is to <command>rm -rf + 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 all of these steps then the easiest way is to <command>rm -rf gen</command>.</para> <para>Upon successful completion the packages/distfiles will be in @@ -320,8 +321,8 @@ <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. + 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 will miss some little detail and the simple process of adding a @@ -333,11 +334,12 @@ <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 + easy to fix. Simply edit + <filename>print-cdrom-packages.sh</filename> to move packages around until they fit. Yes this is an iterative - process and one of the reasons why you should enable <varname>fake</varname> in - <filename>oneshot.pl</filename> until you have gotten - things the way you want them. Re-run + process and one of the reasons why you should enable + <varname>fake</varname> in <filename>oneshot.pl</filename> until you + have gotten things the way you want them. Re-run <command>./doit.sh</command> after you made your adjustments.</para></listitem> </varlistentry> |