Bug 31260

Comment 1 dd 2001-10-14 23:57:04 UTC

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

Over to maintainer.

Comment 2 ru 2001-10-15 09:39:14 UTC

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

Comment 3 ru 2002-01-15 17:21:58 UTC

State Changed
From-To: open->closed

Fixed in 5.0-CURRENT and 4.5-RC.