From swear@blarg.net  Sun Oct 14 10:55:03 2001
Return-Path: <swear@blarg.net>
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id A940737B635
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Oct 2001 10:54:56 -0700 (PDT)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP id 49B91BD48
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Oct 2001 10:54:56 -0700 (PDT)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id KAA00916
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 14 Oct 2001 10:54:55 -0700
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id f9EHs8a56864;
	Sun, 14 Oct 2001 10:54:08 -0700 (PDT)
	(envelope-from swear@blarg.net)
Message-Id: <diitdiqf9c.tdi@localhost.localdomain>
Date: 14 Oct 2001 10:54:07 -0700
From: "Gary W. Swearingen" <swear@aa.net>
Sender: swear@blarg.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: mdoc(7) has "resp.\&" for "or" 4 times.

>Number:         31260
>Category:       docs
>Synopsis:       mdoc(7) has "resp.\&" for "or" 4 times.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    ru
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Oct 14 11:00:01 PDT 2001
>Closed-Date:    Tue Jan 15 09:21:58 PST 2002
>Last-Modified:  Tue Jan 15 09:22:40 PST 2002
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.4-RELEASE i386
>Organization:
none
>Environment:
n/a
================
>Description:

mdoc(7) has "resp.\&" where "or" makes more sense -- 4 times.
================
>How-To-Repeat:
n/a
================
>Fix:

Note: The line numbers may be wrong below (patch made under 4.3-STABLE),
but I think "patch" doesn't care.  Take a look at the results, please.


patch -d "some unformated man/man7 dir" < this-PR

--- old-mdoc.7	Thu Aug  9 06:44:45 2001
+++ mdoc.7	Thu Aug  9 07:00:47 2001
@@ -415,7 +415,7 @@
 .Pp
 If the
 .Ql \e
-before the space resp.\& the double quotes were omitted,
+before the space or the double quotes were omitted,
 .Ql .Fn
 would see three arguments, and the result would be:
 .Pp
@@ -3090,7 +3090,7 @@
 .Em "En square" .
 This is approximately the width of the letter
 .Sq m
-resp.\& the letter
+or the letter
 .Sq n
 of the current font (for nroff output, both scale indicators give the same
 values).
@@ -3536,7 +3536,7 @@
 .Em "En square" .
 This is approximately the width of the letter
 .Sq m
-resp.\& the letter
+or the letter
 .Sq n
 of the current font (for nroff output, both scale indicators give the same
 values).
@@ -3629,7 +3629,7 @@
 .Em "En square" .
 This is approximately the width of the letter
 .Sq m
-resp.\& the letter
+or the letter
 .Sq n
 of the current font (for nroff output, both scale indicators give the same
 values).
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->ru 
Responsible-Changed-By: dd 
Responsible-Changed-When: Sun Oct 14 15:57:04 PDT 2001 
Responsible-Changed-Why:  
Over to maintainer. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=31260 

From: Ruslan Ermilov <ru@FreeBSD.ORG>
To: "Gary W. Swearingen" <swear@aa.net>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/31260: mdoc(7) has "resp.\&" for "or" 4 times.
Date: Mon, 15 Oct 2001 11:39:14 +0300

 Umm, in all these example, using the "resp." (for "respectively")
 is more correct that "or":
 
 : For example:
 : 
 :       fetch(char *str)  is created by `.Fn fetch char\ *str'
 : 
 :       fetch(char *str)  can also be created by `.Fn fetch "char *str"'
 : 
 : If the `\' before the space resp. the double quotes were omitted, `.Fn'
 : would see three arguments, and the result would be:
 : 
 :       fetch(char, *str)
 
 This means:
 
 If the '\' before the space in the first example, or the double quotes in
 the second example, respectively, were omitted, ...
 
 : The most useful scale indicators are `m' and `n', specifying the so-
 : called Em and En square.  This is approximately the width of the
 : letter `m' resp. the letter `n' of the current font (for nroff output,
 : both scale indicators give the same values).
 
 The `m' for Em, and `n' for En, respectively.
 
 If it ever should be changed, it shouldn't be changed to "or".
 Any better ideas?
 
 On Sun, Oct 14, 2001 at 10:54:07AM -0700, Gary W. Swearingen wrote:
 > 
 > >Number:         31260
 > >Category:       docs
 > >Synopsis:       mdoc(7) has "resp.\&" for "or" 4 times.
 > >Confidential:   no
 > >Severity:       non-critical
 > >Priority:       low
 > >Responsible:    freebsd-doc
 > >State:          open
 > >Quarter:        
 > >Keywords:       
 > >Date-Required:
 > >Class:          doc-bug
 > >Submitter-Id:   current-users
 > >Arrival-Date:   Sun Oct 14 11:00:01 PDT 2001
 > >Closed-Date:
 > >Last-Modified:
 > >Originator:     Gary W. Swearingen
 > >Release:        FreeBSD 4.4-RELEASE i386
 > >Organization:
 > none
 > >Environment:
 > n/a
 > ================
 > >Description:
 > 
 > mdoc(7) has "resp.\&" where "or" makes more sense -- 4 times.
 > ================
 > >How-To-Repeat:
 > n/a
 > ================
 > >Fix:
 > 
 > Note: The line numbers may be wrong below (patch made under 4.3-STABLE),
 > but I think "patch" doesn't care.  Take a look at the results, please.
 > 
 > 
 > patch -d "some unformated man/man7 dir" < this-PR
 > 
 > --- old-mdoc.7	Thu Aug  9 06:44:45 2001
 > +++ mdoc.7	Thu Aug  9 07:00:47 2001
 > @@ -415,7 +415,7 @@
 >  .Pp
 >  If the
 >  .Ql \e
 > -before the space resp.\& the double quotes were omitted,
 > +before the space or the double quotes were omitted,
 >  .Ql .Fn
 >  would see three arguments, and the result would be:
 >  .Pp
 > @@ -3090,7 +3090,7 @@
 >  .Em "En square" .
 >  This is approximately the width of the letter
 >  .Sq m
 > -resp.\& the letter
 > +or the letter
 >  .Sq n
 >  of the current font (for nroff output, both scale indicators give the same
 >  values).
 > @@ -3536,7 +3536,7 @@
 >  .Em "En square" .
 >  This is approximately the width of the letter
 >  .Sq m
 > -resp.\& the letter
 > +or the letter
 >  .Sq n
 >  of the current font (for nroff output, both scale indicators give the same
 >  values).
 > @@ -3629,7 +3629,7 @@
 >  .Em "En square" .
 >  This is approximately the width of the letter
 >  .Sq m
 > -resp.\& the letter
 > +or the letter
 >  .Sq n
 >  of the current font (for nroff output, both scale indicators give the same
 >  values).
 
 -- 
 Ruslan Ermilov		Oracle Developer/DBA,
 ru@sunbay.com		Sunbay Software AG,
 ru@FreeBSD.org		FreeBSD committer,
 +380.652.512.251	Simferopol, Ukraine
 
 http://www.FreeBSD.org	The Power To Serve
 http://www.oracle.com	Enabling The Information Age
State-Changed-From-To: open->closed 
State-Changed-By: ru 
State-Changed-When: Tue Jan 15 09:21:58 PST 2002 
State-Changed-Why:  
Fixed in 5.0-CURRENT and 4.5-RC. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=31260 
>Unformatted:
