On 2015-09-11, Rob Pierce <r...@2keys.ca> wrote:
>    <li><b>src</b> - Houses all source code for the OpenBSD Operating System.
>    <li><b>ports</b> - Houses the <a href="faq/ports/index.html">OpenBSD 
> Ports</a>.
> -  <li><b>www</b> - Houses all OpenBSD web pages. (Including this one).
> +  <li><b>www</b> - Houses all OpenBSD web pages (including this one).

I like that

>    <li><b>xenocara</b> - Houses OpenBSD's active X.org v7 source tree.
>    <li><b>X11</b> and <b>XF4</b> - Houses OpenBSD's adaptation of the
>        <a href="http://www.XFree86.org/";>XFree86-3</a> and XFree86-4
> @@ -122,7 +122,7 @@ with only one part of the tree.  The two
>  which contains the files used to create the kernel, and <tt>src.tar.gz</tt>
>  which contains all the other "userland" utilities.
>  In general, however, you will usually want both of them installed.
> -Assuming the downloaded files, <tt>src.tar.gz</tt>,
> +Assuming the downloaded files <tt>src.tar.gz</tt>,
> <tt>sys.tar.gz</tt> and <tt>xenocara.tar.gz</tt> are in <tt>/usr</tt>:

I think this was OK as it was

> <p>
> -Not all people will wish to unpack all the file sets, but as the system
> +Not all people will wish to unpack all the source file, but as the system
>  must be kept in sync, you will generally need to set up all trees.

and this (and the new sentence doesn't quite make sense)

> <p>
> -You can also just use cvs(1) to "<b>checkout</b>" the source repository
> +You can also just use
> +<a 
> href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&amp;sektion=1&amp;format=html";>cvs(1)</a>
> +to "<b>checkout</b>" the source repository
>  for you. This is discussed in the <a href="#using">next section</a>.

OK I guess, though I don't think we need to hyperlink every instance of
a program name

> @@ -160,16 +162,12 @@ from the <a href="errata.html">errata</a
>  For more information on these "flavors" of OpenBSD, see 
> <a href="faq/faq5.html#Flavors">here</a>.
>  
> -<p>Once you have decided which tree to follow, you must choose which 
> Anonymous
> -CVS server you are going to use.  A list of these servers is
> -<a href="#CVSROOT">below</a>.
> -
> <p>
> -Once you have chosen which <a href="#CVSROOT">Anonymous CVS Server</a> you 
> will
> -use, you can start using cvs. For those of you
> +Once you have decided which tree to follow, and which <a 
> href="#CVSROOT">Anonymous CVS Server</a> you will

Please try and keep <80 columns in the source file where sensible

> +use, you can start using <a 
> href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&amp;sektion=1&amp;format=html";>cvs(1)</a>.
>  For those of you
>  who have CDs you can start with the CVS checkout that is on the CD by using
>  the method <a href="#starting">above</a> to get the sources onto your system.
> -If you don't have a CD handy, use the method below to checkout the sources.
> +If you don't have a CD handy, use the method below to checkout the sources:
>  
> <p>
> <ul><li>First, start out by `get'-ing an initial tree:
> @@ -210,9 +208,11 @@ Confirm this, and the fingerprint will t
>       ...
> </pre>
>  
> +<p>
>  Note that the above format with SHA256 fingerprints was added after the
>  release of OpenBSD 5.6; older versions only use MD5 fingerprints.
>  
> +<p>
> <li> Anytime afterwards, to `update' this tree:
> <p> (If you are following <i>current</i>):
> <pre>
> @@ -234,7 +234,7 @@ to merge changes in.
> <li> NOTE:
>  If you are updating a source tree that you initially fetched
>  from a different server, or from a CD, you <strong>must</strong>
> -add the <em>-d [cvsroot]</em> option to cvs.
> +add the <em>-d [cvsroot]</em> option to cvs:
> <pre>
>       # <strong>cd /usr/src</strong>
>       # <strong>cvs -d anon...@anoncvs.ca.openbsd.org:/cvs -q up -Pd</strong>
> @@ -295,11 +295,11 @@ directory, and a subsequent update will 
>  
> <p>
>  The anoncvs service gives fledgling developers a chance to learn CVS
> -operation and get thoroughly involved in the development process
> +operations and get thoroughly involved in the development process

"operation" already seem ok

>  before getting "commit" access -- as a result of showing useful
>  skills and high quality results they will naturally later be given
>  developer access.
> -As well, people providing patches can create their "diff"s relative
> +As well, people providing patches can create their diffs relative
>  to the CVS tree, which will ease integration.
>  
> <h3><a name="EXAMPLE"><font color="#0000e0">Example usages for cvs(1)</font>

Reply via email to