From nobody@FreeBSD.org  Sat Aug 24 07:19:12 2002
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id CD13437B400
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 24 Aug 2002 07:19:12 -0700 (PDT)
Received: from www.freebsd.org (www.FreeBSD.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 8CC0143E42
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 24 Aug 2002 07:19:12 -0700 (PDT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.12.4/8.12.4) with ESMTP id g7OEJCOT032270
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 24 Aug 2002 07:19:12 -0700 (PDT)
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.12.4/8.12.4/Submit) id g7OEJCaM032269;
	Sat, 24 Aug 2002 07:19:12 -0700 (PDT)
Message-Id: <200208241419.g7OEJCaM032269@www.freebsd.org>
Date: Sat, 24 Aug 2002 07:19:12 -0700 (PDT)
From: Yoshiteru Kageyama <yt-kage@cb3.so-net.ne.jp>
To: freebsd-gnats-submit@FreeBSD.org
Subject: A statement in ftpusers.5 can't be output correctly with the current groff application
X-Send-Pr-Version: www-1.0

>Number:         41972
>Category:       docs
>Synopsis:       A statement in ftpusers.5 can't be output correctly with the current groff application
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Aug 24 07:20:03 PDT 2002
>Closed-Date:    Sat Dec 14 15:47:08 PST 2002
>Last-Modified:  Sat Dec 14 15:47:08 PST 2002
>Originator:     Yoshiteru Kageyama
>Release:        4-STABLE
>Organization:
>Environment:
>Description:
In a manual file ftpusers.5, there is a statement which can't be displayed properly with the groff application currently installed in FreeBSD 4-STABLE, groff 1.17.2:
(In line 160-166)
.Pp
The syntax is similar to
.Nm "" ,
except that the  
.Sy class
argument is ignored.

When you process these lines with the groff 1.17.2, you will find the .Nm macro line processed wrong. The output is:
"The syntax is similar to , except that the class argument is ignored. "
It is similar to what?


>How-To-Repeat:
groff -Tascii -mdoc ftpusers.5
>Fix:
--- ftpusers.5  Sat Aug 24 23:14:48 2002
+++ ftpusers.5.new      Sat Aug 24 23:16:00 2002
@@ -159,7 +159,7 @@
 If the file does not exist, the root directory change is not performed.
 .Pp
 The syntax is similar to
-.Nm "" ,
+.Nm ,
 except that the
 .Sy class
 argument is ignored.

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->analyzed 
State-Changed-By: keramida 
State-Changed-When: Sat Aug 24 17:31:05 PDT 2002 
State-Changed-Why:  
I've emailed lukem, and will take care of the PR when he replies. 


Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Sat Aug 24 17:31:05 PDT 2002 
Responsible-Changed-Why:  

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

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Yoshiteru Kageyama <yt-kage@cb3.so-net.ne.jp>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/41972: A statement in ftpusers.5 can't be output correctly with the current groff application
Date: Sun, 25 Aug 2002 03:34:27 +0300

 On 2002-08-24 07:19 +0000, Yoshiteru Kageyama wrote:
 > >Synopsis:       A statement in ftpusers.5 can't be output correctly with the current groff application
 
 ftpusers.5 is installed from the ftpd sources.  The ftpd sources are
 part of contrib/lukemftpd which is contributed software.  I've emailed
 the author of the FTP server software and asked him to change this in
 the official source.  This way, when a newer version is cleanly
 imported to FreeBSD we'll get this fix too.
 
 Thanks for submitting this :)
 
 - Giorgos

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Yoshiteru Kageyama <yt-kage@cb3.so-net.ne.jp>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/41972: A statement in ftpusers.5 can't be output correctly with the current groff application
Date: Mon, 26 Aug 2002 05:48:42 +0300

 > From: Giorgos Keramidas <keramida@FreeBSD.org>
 > Date: Sun, 25 Aug 2002 03:34:27 +0300
 >
 >  ftpusers.5 is installed from the ftpd sources.  The ftpd sources are
 >  part of contrib/lukemftpd which is contributed software.  I've emailed
 >  the author of the FTP server software and asked him to change this in
 >  the official source.  This way, when a newer version is cleanly
 >  imported to FreeBSD we'll get this fix too.
 
 Apparently, NetBSD's groff is version 1.16 and the canonical way to
 use .Nm is (according to Luke Mewburn, the author of lukemftpd):
 
 	.Nm "" ,
 
 in this case.  FreeBSD's version of groff is 1.17 and the behavior of
 the .Nm macro has changed.  This is why the ftpusers.5 manpage seems
 to have a "wrong" behavior.
 
 - Giorgos

From: Yoshiteru Kageyama <yt-kage@cb3.so-net.ne.jp>
To: Giorgos Keramidas <keramida@FreeBSD.org>
Cc: Yoshiteru Kageyama <yt-kage@cb3.so-net.ne.jp>,
	bug-followup@FreeBSD.org
Subject: Re: docs/41972: A statement in ftpusers.5 can't be output correctly with the current groff application
Date: Wed, 28 Aug 2002 01:20:51 +0900

 Hi, Giorgos san,
 
 Thank you for dealing with my PR.
 
 At Mon, 26 Aug 2002 05:48:42 +0300,
 Giorgos Keramidas wrote:
 
 > Apparently, NetBSD's groff is version 1.16 and the canonical way to
 > use .Nm is (according to Luke Mewburn, the author of lukemftpd):
 > 
 > 	.Nm "" ,
 > 
 > in this case.  FreeBSD's version of groff is 1.17 and the behavior of
 > the .Nm macro has changed.  This is why the ftpusers.5 manpage seems
 > to have a "wrong" behavior.
 
 O.K. I understand what the root cause of this problem is.
 Anyway, what are we going to do then to improve this behavior?
 Is it better for us to modify the portion of .Nm macro only for
 FreeBSD, or to keep it as it is?
 
 Regards,
 Kageyama

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Yoshiteru Kageyama <yt-kage@cb3.so-net.ne.jp>
Cc: bug-followup@FreeBSD.org, "David O'Brien" <obrien@FreeBSD.org>
Subject: Re: docs/41972: A statement in ftpusers.5 can't be output correctly with the current groff application
Date: Tue, 27 Aug 2002 23:26:14 +0300

 On 2002-08-28 01:20 +0000, Yoshiteru Kageyama wrote:
 > At Mon, 26 Aug 2002 05:48:42 +0300,
 > Giorgos Keramidas wrote:
 > > in this case.  FreeBSD's version of groff is 1.17 and the behavior
 > > of the .Nm macro has changed.  This is why the ftpusers.5 manpage
 > > seems to have a "wrong" behavior.
 >
 > O.K. I understand what the root cause of this problem is.
 
 David O' Brien has imported lukemftpd to our CVS repository.
 
 David, is it okay to commit changes to this file?  It's still in the
 vendor branch, so I wouldn't want to cause trouble for future imports
 without asking first.
 
 -- 
 FreeBSD: The Power to Serve -- http://www.FreeBSD.org

From: "David O'Brien" <obrien@FreeBSD.org>
To: Giorgos Keramidas <keramida@FreeBSD.org>, ru@FreeBSD.org
Cc: Yoshiteru Kageyama <yt-kage@cb3.so-net.ne.jp>,
	bug-followup@FreeBSD.org
Subject: Re: docs/41972: A statement in ftpusers.5 can't be output correctly with the current groff application
Date: Tue, 27 Aug 2002 22:13:28 -0700

 I would like to see RU comment about the groff 1.6 vs. 1.7 issue first.
 
 On Tue, Aug 27, 2002 at 11:26:14PM +0300, Giorgos Keramidas wrote:
 > David, is it okay to commit changes to this file?  It's still in the
 > vendor branch, so I wouldn't want to cause trouble for future imports
 > without asking first.

From: "David O'Brien" <obrien@FreeBSD.org>
To: Yoshiteru Kageyama <yt-kage@cb3.so-net.ne.jp>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/41972: A statement in ftpusers.5 can't be output correctly with the current groff application
Date: Tue, 27 Aug 2002 22:15:35 -0700

 "serious" severity, and "medium" priority for a minor one-line doc bug.
 Give me a break!!!  severity and priority set to appropriate values.

From: Ruslan Ermilov <ru@FreeBSD.org>
To: "David O'Brien" <obrien@FreeBSD.org>
Cc: Giorgos Keramidas <keramida@FreeBSD.org>,
	Yoshiteru Kageyama <yt-kage@cb3.so-net.ne.jp>,
	bug-followup@FreeBSD.org
Subject: Re: docs/41972: A statement in ftpusers.5 can't be output correctly with the current groff application
Date: Mon, 16 Sep 2002 13:20:51 +0300

 --xo44VMWPx7vlQ2+2
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On Tue, Aug 27, 2002 at 10:13:28PM -0700, David O'Brien wrote:
 > I would like to see RU comment about the groff 1.6 vs. 1.7 issue first.
 >=20
 > On Tue, Aug 27, 2002 at 11:26:14PM +0300, Giorgos Keramidas wrote:
 > > David, is it okay to commit changes to this file?  It's still in the
 > > vendor branch, so I wouldn't want to cause trouble for future imports
 > > without asking first.
 >=20
 Yep, these should be taken out of the vendor branch.
 
 
 Cheers,
 --=20
 Ruslan Ermilov		Sysadmin and 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
 
 --xo44VMWPx7vlQ2+2
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.0.7 (FreeBSD)
 
 iD8DBQE9hbCDUkv4P6juNwoRAmeLAJwMmy1j8A3wAlLIMP+t64quUu+E/ACeOKbE
 YHHUvTDMZdDkxgeC3ki3yVY=
 =3+k8
 -----END PGP SIGNATURE-----
 
 --xo44VMWPx7vlQ2+2--
State-Changed-From-To: analyzed->closed 
State-Changed-By: keramida 
State-Changed-When: Sat Dec 14 15:46:14 PST 2002 
State-Changed-Why:  
The change has been committed to 5.0-CURRENT. 
I also updated ftpd.conf.5 which has similar problems with .Nm usage. 

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