From cperciva@hexahedron.daemonology.net  Fri Aug 12 19:02:30 2005
Return-Path: <cperciva@hexahedron.daemonology.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 56F3716A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 12 Aug 2005 19:02:30 +0000 (GMT)
	(envelope-from cperciva@hexahedron.daemonology.net)
Received: from hexahedron.daemonology.net (S0106006067227a4a.vc.shawcable.net [24.87.209.6])
	by mx1.FreeBSD.org (Postfix) with SMTP id 9BDA843D45
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 12 Aug 2005 19:02:29 +0000 (GMT)
	(envelope-from cperciva@hexahedron.daemonology.net)
Received: (qmail 33760 invoked by uid 1001); 12 Aug 2005 19:02:28 -0000
Message-Id: <20050812190228.33759.qmail@hexahedron.daemonology.net>
Date: 12 Aug 2005 19:02:28 -0000
From: Colin Percival <cperciva@freebsd.org>
Reply-To: Colin Percival <cperciva@freebsd.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Misplaced apostrophe in "FreeBSD Porter's Handbook"
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         84851
>Category:       docs
>Synopsis:       Misplaced apostrophe in "FreeBSD Porter's Handbook"
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    jcamou
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Aug 12 19:10:18 GMT 2005
>Closed-Date:    Mon Aug 15 00:38:18 GMT 2005
>Last-Modified:  Mon Aug 15 00:38:18 GMT 2005
>Originator:     Colin Percival
>Release:        FreeBSD 5.4-SECURITY i386
>Organization:
dis-
>Environment:
System: FreeBSD hexahedron.daemonology.net 5.4-SECURITY FreeBSD 5.4-SECURITY #0: Wed Jul 20 08:57:11 UTC 2005 root@builder.daemonology.net:/usr/obj/usr/src/sys/GENERIC i386

>Description:

The title "FreeBSD Porter's Handbook" implies that there is only one 
FreeBSD Porter (or at very least, that there is only one Porter who 
uses said Handbook).

>How-To-Repeat:
>Fix:

s/'s/s'/

"FreeBSD Porter's Handbook" -> "FreeBSD Porters' Handbook"
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->jcamou  
Responsible-Changed-By: jcamou 
Responsible-Changed-When: Fri Aug 12 21:14:01 GMT 2005 
Responsible-Changed-Why:  
Grab it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=84851 

From: Pav Lucistnik <pav@FreeBSD.org>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/84851: Misplaced apostrophe in "FreeBSD Porter's Handbook"
Date: Sat, 13 Aug 2005 00:12:12 +0200

 I believe this is incorrect. Look around, it's always
 
 Hitchhiker's Guide To The Galaxy
 
 not
 
 Hitchhikers' Guide To The Galaxy
 
 ...
 
 -- 
 Pav Lucistnik <pav@oook.cz>
               <pav@FreeBSD.org>
 

From: garys@opusnet.com (Gary W. Swearingen)
To: Colin Percival <cperciva@FreeBSD.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/84851: Misplaced apostrophe in "FreeBSD Porter's Handbook"
Date: Fri, 12 Aug 2005 16:47:27 -0700

 Colin Percival <cperciva@FreeBSD.org> writes:
 
 >>Description:
 >
 > The title "FreeBSD Porter's Handbook" implies that there is only one 
 > FreeBSD Porter (or at very least, that there is only one Porter who 
 > uses said Handbook).
 
 The fact that people will infer that is enough reason to change it,
 but it doesn't imply what you say.  The handbook is for each FreeBSD
 porter; it is a porter's handbook -- and so it may be called The
 FreeBSD Porter's Handbook.  See two similar examples of commercial
 book titles below.
 
 This issue is bikeshed-color issue, unless the FDP has settled on 
 something different, which, based on http://www.freebsd.org/docs.html
 and (the) "FreeBSD Handbook", it has not.
 
 (BTW, these titles should start with "The", IMO.)
 
 >From intro(1) manpage:
 -- "the BSD user environment"
    Change to "the BSD users' environment"?
 
 >From (the) "FreeBSD Handbook":
 
 -- "User group" and "Users Groups"
    Change to "Users' group"?
 
 -- "Alpha User's Questions"
    Change to "Users' Questions"?
 
 -- * The FreeBSD Corporate Networker's Guide, published by
      Addison-Wesley, 2000. ISBN: 0201704811
    A book title -- Can't be changed.
 
 -- * Ferraro, Richard F. Programmer's Guide to the EGA, VGA, and
        Super VGA Cards. 3rd ed. Reading, Mass. : Addison-Wesley,
        1995. ISBN 0-201-62490-7
    A book title -- Can't be changed.
 
 
 Similar arguments have been held for the names of groups of users.
 
 Sorry, but a reasonable case could be made for any of these
 The FreeBSD Porter Handbook
 The FreeBSD Porters Handbook
 The FreeBSD Porter's Handbook
 The FreeBSD Porters' Handbook
 
 But since I prefer the latter I'm not really opposing the change;
 just the need for it.

From: garys@opusnet.com (Gary W. Swearingen)
To: Colin Percival <cperciva@FreeBSD.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/84851: Misplaced apostrophe in "FreeBSD Porter's Handbook"
Date: Fri, 12 Aug 2005 17:21:19 -0700

 Colin Percival <cperciva@FreeBSD.org> writes:
 
 >>Description:
 >
 > The title "FreeBSD Porter's Handbook" implies that there is only one 
 > FreeBSD Porter (or at very least, that there is only one Porter who 
 > uses said Handbook).
 
 The fact that people will infer that is enough reason to change it,
 but the title doesn't imply that.  The handbook is for each FreeBSD
 porter; it is a porter's handbook -- and so it may be called The
 FreeBSD Porter's Handbook.  See two similar examples of commercial
 book titles below.
 
 This issue is bikeshed-color issue, unless the FDP has settled on 
 something different, which, based on http://www.freebsd.org/docs.html
 and (the) "FreeBSD Handbook", it has not.
 
 (BTW, these titles should start with "The", IMO.)
 
 > From intro(1) manpage:
 -- "the BSD user environment"
    Change to "the BSD users' environment"?
 
 > From (the) "FreeBSD Handbook":
 
 -- "User group" and "Users Groups"
    Change to "Users' group"?
 
 -- "Alpha User's Questions"
    Change to "Users' Questions"?
 
 -- * The FreeBSD Corporate Networker's Guide, published by
      Addison-Wesley, 2000. ISBN: 0201704811
    A book title -- Can't be changed.
 
 -- * Ferraro, Richard F. Programmer's Guide to the EGA, VGA, and
        Super VGA Cards. 3rd ed. Reading, Mass. : Addison-Wesley,
        1995. ISBN 0-201-62490-7
    A book title -- Can't be changed.
 
 
 Similar arguments have been held for the names of groups of users.
 
 Sorry, but a reasonable case could be made for any of these
 The FreeBSD Porter Handbook
 The FreeBSD Porters Handbook
 The FreeBSD Porter's Handbook
 The FreeBSD Porters' Handbook
 
 But since I prefer the latter I'm not really opposing the change;
 just the need for it.

From: Ceri Davies <ceri@submonkey.net>
To: Colin Percival <cperciva@FreeBSD.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/84851: Misplaced apostrophe in "FreeBSD Porter's Handbook"
Date: Sat, 13 Aug 2005 10:54:27 +0100

 On 12 Aug 2005, at 20:02, Colin Percival wrote:
 
 > The title "FreeBSD Porter's Handbook" implies that there is only one
 > FreeBSD Porter (or at very least, that there is only one Porter who
 > uses said Handbook).
 
  > "FreeBSD Porter's Handbook" -> "FreeBSD Porters' Handbook"
 
 It's fine as it is.  It's a handbook for a FreeBSD Porter.
 
 The bookshelf in this room has "The Robot Builder's Bonanza" and  
 "PostgreSQL Developer's Handbook" on it. There is nothing of the form  
 of "Porters'" there.
 Collins make a set of books called "Rambler's Guides".
 
 Really, it's good.
 
 Ceri
 -- 
 Only two things are infinite, the universe and human stupidity, and I'm
 not sure about the former.                        -- Einstein (attrib.)
 
 

From: garys@opusnet.com (Gary W. Swearingen)
To: "Jesus R. Camou" <jcamou@FreeBSD.org>
Cc: Colin Percival <cperciva@FreeBSD.org>, bug-followup@FreeBSD.org
Subject: Re: docs/84851: Misplaced apostrophe in "FreeBSD Porter's Handbook"
Date: Sat, 13 Aug 2005 14:36:57 -0700

 Sorry if you've gotten this before; I seem to have an e-mail problem.
 
 Colin Percival <cperciva@FreeBSD.org> writes:
 
 >>Description:
 >
 > The title "FreeBSD Porter's Handbook" implies that there is only one 
 > FreeBSD Porter (or at very least, that there is only one Porter who 
 > uses said Handbook).
 
 The fact that people will infer that is enough reason to change it,
 but the title doesn't imply that.  The handbook is for each FreeBSD
 porter; it is a porter's handbook -- and so it may be called The
 FreeBSD Porter's Handbook.  See two similar examples of commercial
 book titles below.
 
 This issue is bikeshed-color issue, unless the FDP has settled on 
 something different, which, based on http://www.freebsd.org/docs.html
 and (the) "FreeBSD Handbook", it has not.
 
 (BTW, these titles should start with "The", IMO.)
 
 > From intro(1) manpage:
 -- "the BSD user environment"
    Change to "the BSD users' environment"?
 
 > From (the) "FreeBSD Handbook":
 
 -- "User group" and "Users Groups"
    Change to "Users' group"?
 
 -- "Alpha User's Questions"
    Change to "Users' Questions"?
 
 -- * The FreeBSD Corporate Networker's Guide, published by
      Addison-Wesley, 2000. ISBN: 0201704811
    A book title -- Can't be changed.
 
 -- * Ferraro, Richard F. Programmer's Guide to the EGA, VGA, and
        Super VGA Cards. 3rd ed. Reading, Mass. : Addison-Wesley,
        1995. ISBN 0-201-62490-7
    A book title -- Can't be changed.
 
 
 Similar arguments have been held for the names of groups of users.
 
 Sorry, but a reasonable case could be made for any of these
 The FreeBSD Porter Handbook
 The FreeBSD Porters Handbook
 The FreeBSD Porter's Handbook
 The FreeBSD Porters' Handbook
 
 As if it matters, I like the change, and am just noting that change is
 not needed and that the title will need to be changed in several documents.

From: garys@opusnet.com (Gary W. Swearingen)
To: "Jesus R. Camou" <jcamou@FreeBSD.org>
Cc: bug-followup@FreeBSD.org, freebsd-doc@FreeBSD.org,
        Colin Percival
 <cperciva@FreeBSD.org>
Subject: Re: docs/84851: Misplaced apostrophe in "FreeBSD Porter's Handbook"
Date: Sat, 13 Aug 2005 14:40:59 -0700

 Sorry if you've gotten this before; I have a mailer problem here.
 
 Colin Percival <cperciva@FreeBSD.org> writes:
 
 >>Description:
 >
 > The title "FreeBSD Porter's Handbook" implies that there is only one 
 > FreeBSD Porter (or at very least, that there is only one Porter who 
 > uses said Handbook).
 
 The fact that people will infer that is enough reason to change it,
 but the title doesn't imply that.  The handbook is for each FreeBSD
 porter; it is a porter's handbook -- and so it may be called The
 FreeBSD Porter's Handbook.  See two similar examples of commercial
 book titles below.
 
 This issue is bikeshed-color issue, unless the FDP has settled on 
 something different, which, based on http://www.freebsd.org/docs.html
 and (the) "FreeBSD Handbook", it has not.
 
 (BTW, these titles should start with "The", IMO.)
 
 > From intro(1) manpage:
 -- "the BSD user environment"
    Change to "the BSD users' environment"?
 
 > From (the) "FreeBSD Handbook":
 
 -- "User group" and "Users Groups"
    Change to "Users' group"?
 
 -- "Alpha User's Questions"
    Change to "Users' Questions"?
 
 -- * The FreeBSD Corporate Networker's Guide, published by
      Addison-Wesley, 2000. ISBN: 0201704811
    A book title -- Can't be changed.
 
 -- * Ferraro, Richard F. Programmer's Guide to the EGA, VGA, and
        Super VGA Cards. 3rd ed. Reading, Mass. : Addison-Wesley,
        1995. ISBN 0-201-62490-7
    A book title -- Can't be changed.
 
 
 Similar arguments have been held for the names of groups of users.
 
 Sorry, but a reasonable case could be made for any of these
 The FreeBSD Porter Handbook
 The FreeBSD Porters Handbook
 The FreeBSD Porter's Handbook
 The FreeBSD Porters' Handbook
 
 As if it matters, I like the change, and am just noting that change is
 not needed and that the title will need to be changed in several documents.
State-Changed-From-To: open->closed  
State-Changed-By: jcamou 
State-Changed-When: Mon Aug 15 00:35:58 GMT 2005 
State-Changed-Why:  
cperciva agrees to close this pr.  No changes were made. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=84851 
>Unformatted:
