Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 27 Feb 2005 13:21:27 +0000
From:      Ceri Davies <ceri@submonkey.net>
To:        "Simon L. Nielsen" <simon@FreeBSD.org>
Cc:        Kirill Ponomarew <krion@voodoo.oberon.net>
Subject:   Re: cvs commit: doc/en_US.ISO8859-1/articles/committers-guide article.sgml
Message-ID:  <20050227132127.GC3322@submonkey.net>
In-Reply-To: <20050227131254.GG826@arthur.nitro.dk>
References:  <200502271256.j1RCu2Pr095143@repoman.freebsd.org> <20050227125808.GF58447@voodoo.oberon.net> <20050227131254.GG826@arthur.nitro.dk>

next in thread | previous in thread | raw e-mail | index | archive | help

--EqVOK5mkaJAMmtSx
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

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
> > >=20
> > >   FreeBSD doc repository
> > >=20
> > >   Modified files:
> > >     en_US.ISO8859-1/articles/committers-guide article.sgml=20
> > >   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 de=
ad)
> >=20
> > Please backout it and mention fetchindex/index targets insteads.
> > This info can useful for novices.
>=20
> I really don't think that kind of information belong in the committers
> guide, but I don't care enough to discuss it further.
>=20
> 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 @@
> =20
>  	<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
--=20
Only two things are infinite, the universe and human stupidity, and I'm
not sure about the former.			  -- Einstein (attrib.)

--EqVOK5mkaJAMmtSx
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.0 (FreeBSD)

iD8DBQFCIclXocfcwTS3JF8RAoyfAJ4mkBHQ31uqihU3Vl8BnMQfVoskHwCgu0ue
/OZMGFEqXWs6kmgdboivXbo=
=CpV2
-----END PGP SIGNATURE-----

--EqVOK5mkaJAMmtSx--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20050227132127.GC3322>