cvs commit: doc/en_US.ISO8859-1/articles/committers-guide article.sgml

[Ceri Davies]

On Sun, Feb 27, 2005 at 02:12:55PM +0100, Simon L. Nielsen wrote:
> On 2005.02.27 13:58:08 +0100, Kirill Ponomarew wrote:
> > On Sun, Feb 27, 2005 at 12:56:02PM +0000, Simon L. Nielsen wrote:
> > > simon       2005-02-27 12:56:02 UTC
> > > 
> > >   FreeBSD doc repository
> > > 
> > >   Modified files:
> > >     en_US.ISO8859-1/articles/committers-guide article.sgml 
> > >   Log:
> > >   * Remove obsolete and confusing question "I added a new port.
> > >     Do I need to add it to the INDEX?" (ports/INDEX file is really dead)
> > 
> > Please backout it and mention fetchindex/index targets insteads.
> > This info can useful for novices.
> 
> I really don't think that kind of information belong in the committers
> guide, but I don't care enough to discuss it further.
> 
> What do you think about the attached patch?

Since it seems that portmgr want it, here's a review:

> --- article.sgml	27 Feb 2005 12:56:02 -0000	1.220
> +++ article.sgml	27 Feb 2005 13:12:41 -0000
> @@ -2856,6 +2856,22 @@
>  
>  	<qandaentry>
>  	  <question>
> +	    <para>I added a new port.  Do I need to add it to the
> +	      <filename>INDEX</filename>?</para>
> +	  </question>
> +
> +	  <answer>
> +	    <para>No.  The <filename>INDEX</filename> file is
> +	      generated when needed, either by users generating it
> +	      them self, by running <quote><command>make
> +	      index</command></quote>, or by users fetch the
> +	      pre-generated version, using <quote><command>make
> +	      fetchindex</command></quote>.</para>
> +	  </answer>
> +	</qandaentry>

Way too many commas there.  Perhaps:

  No, <filename>INDEX</filename> is no longer stored in the CVS
  repository.  The file can either be generated by the <command>make
  index</command>, or a pre-generated version can be downloaded
  with <command>make fetchindex</command>.

Ceri
-- 
Only two things are infinite, the universe and human stupidity, and I'm
not sure about the former.			  -- Einstein (attrib.)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-all/attachments/20050227/08b386ef/attachment.bin