Bug 77926

Comment 1 Marc Fonvieille 2005-02-22 14:15:41 UTC

On Tue, Feb 22, 2005 at 06:53:18AM -0700, Jesus R. Camou wrote:
> 
> >Number:         77926
> >Category:       docs
> >Synopsis:       [PATCH] update FDP Primer book word list
> >Confidential:   no
> >Severity:       non-critical
> >Priority:       medium
> >Responsible:    freebsd-doc
> >State:          open
> >Quarter:        
> >Keywords:       
> >Date-Required:
> >Class:          update
> >Submitter-Id:   current-users
> >Arrival-Date:   Tue Feb 22 14:00:22 GMT 2005
> >Closed-Date:
> >Last-Modified:
> >Originator:     Jesus R. Camou
> >Release:        FreeBSD 4.11-STABLE i386
> >Organization:
> >Environment:
> System: FreeBSD opensea.mephis.org 4.11-STABLE FreeBSD 4.11-STABLE #0: Sun Feb 13 21:22:53 MST 2005 jcamou@opensea.mephis.org:/usr/obj/usr/src/sys/HACKED i386
> 
> >Description:
> 
> 	Update the word list in the FDP Primer with the
> 	capitalization of the Ports Collection.
> 
> >How-To-Repeat:
> >Fix:
> 
> --- writingstyle.diff begins here ---
> Index: chapter.sgml
> ===================================================================
> RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.sgml,v
> retrieving revision 1.43
> diff -u -r1.43 chapter.sgml
> --- chapter.sgml	20 Feb 2005 16:57:00 -0000	1.43
> +++ chapter.sgml	22 Feb 2005 01:29:17 -0000
> @@ -456,7 +456,7 @@
>        </listitem>
>  
>        <listitem>
> -	<para>ports collection</para>
> +	<para>Ports Pollection</para>
>        </listitem>
>

This seems to be redundant with the "FreeBSD Ports Collection" entry,
ealier in the document.  And I wonder about the revision 1.16 of this
list where both "FreeBSD Ports Collection" and ""ports collection" have
been added, maybe Murray and/or Chern may say something on that.
This is another example of docproj history, I mean, as with CDROM which
came from Walnut Creeks CDROM boxes (have a look to freebsdmall CD sets
too), this is not a typo but a choice.

Marc

On Tue, Feb 22, 2005 at 03:15:41PM +0100, Marc Fonvieille wrote:
> On Tue, Feb 22, 2005 at 06:53:18AM -0700, Jesus R. Camou wrote:
> > 
> > >Number:         77926
> > >Category:       docs
> > >Synopsis:       [PATCH] update FDP Primer book word list
> > >Confidential:   no
> > >Severity:       non-critical
> > >Priority:       medium
> > >Responsible:    freebsd-doc
> > >State:          open
> > >Quarter:        
> > >Keywords:       
> > >Date-Required:
> > >Class:          update
> > >Submitter-Id:   current-users
> > >Arrival-Date:   Tue Feb 22 14:00:22 GMT 2005
> > >Closed-Date:
> > >Last-Modified:
> > >Originator:     Jesus R. Camou
> > >Release:        FreeBSD 4.11-STABLE i386
> > >Organization:
> > >Environment:
> > System: FreeBSD opensea.mephis.org 4.11-STABLE FreeBSD 4.11-STABLE #0: Sun Feb 13 21:22:53 MST 2005 jcamou@opensea.mephis.org:/usr/obj/usr/src/sys/HACKED i386
> > 
> > >Description:
> > 
> > 	Update the word list in the FDP Primer with the
> > 	capitalization of the Ports Collection.
> > 
> > >How-To-Repeat:
> > >Fix:
> > 
> > --- writingstyle.diff begins here ---
> > Index: chapter.sgml
> > ===================================================================
> > RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.sgml,v
> > retrieving revision 1.43
> > diff -u -r1.43 chapter.sgml
> > --- chapter.sgml	20 Feb 2005 16:57:00 -0000	1.43
> > +++ chapter.sgml	22 Feb 2005 01:29:17 -0000
> > @@ -456,7 +456,7 @@
> >        </listitem>
> >  
> >        <listitem>
> > -	<para>ports collection</para>
> > +	<para>Ports Pollection</para>
> >        </listitem>
> >
> 
> This seems to be redundant with the "FreeBSD Ports Collection" entry,
> ealier in the document.  And I wonder about the revision 1.16 of this
> list where both "FreeBSD Ports Collection" and ""ports collection" have
> been added, maybe Murray and/or Chern may say something on that.
> This is another example of docproj history, I mean, as with CDROM which
> came from Walnut Creeks CDROM boxes (have a look to freebsdmall CD sets
> too), this is not a typo but a choice.

I requested this change to have an order of how words should be spelled.
Both ways are used throughout the doc/ tree, it would look better if
there were only one way of writing it from now on.  Some replacements has
been made lately for the capitalization way.  Plus, oh my, there's a
typo on my patch.  I'll attach a corrected patch just in case it is 
decided to be committed.  

-- 
Jesus R. Camou <jcamou@COX.net>
jcamou@es.FreeBSD.org

Comment 3 Tom Rhodes 2005-02-23 07:35:32 UTC

State Changed
From-To: open->closed

While I've read the follow ups to this PR, there is one fact that has not been brough up. 

Ports Collection is a name, a proper noun, and in both MLA and Chicago writing styles, 
proper nouns are capitalized.  I agree with the submitters change and have adjusted 
the document accordingly.  Thank you for the submission. 

Comment 4 Tom Rhodes 2005-02-23 07:35:32 UTC

Responsible Changed
From-To: freebsd-doc->trhodes

Over to me.