NetBSD Problem Report #39535

From www@NetBSD.org  Sat Sep 13 19:24:35 2008
Return-Path: <www@NetBSD.org>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by narn.NetBSD.org (Postfix) with ESMTP id C3F1B63B853
	for <gnats-bugs@gnats.netbsd.org>; Sat, 13 Sep 2008 19:24:34 +0000 (UTC)
Message-Id: <20080913192434.9714B63B11D@narn.NetBSD.org>
Date: Sat, 13 Sep 2008 19:24:34 +0000 (UTC)
From: ekamperi@gmail.com
Reply-To: ekamperi@gmail.com
To: gnats-bugs@NetBSD.org
Subject: groff -mdoc interprets C as markup inside a .Bd -literal .Ed block
X-Send-Pr-Version: www-1.0

>Number:         39535
>Category:       bin
>Synopsis:       groff -mdoc interprets C as markup inside a .Bd -literal .Ed block
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    bin-bug-people
>State:          closed
>Class:          sw-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Sep 13 19:25:00 +0000 2008
>Closed-Date:    Sun Nov 15 02:29:47 +0000 2009
>Last-Modified:  Sun Nov 15 02:29:47 +0000 2009
>Originator:     Stathis Kamperis
>Release:        NetBSD 4.99.72
>Organization:
>Environment:
NetBSD netbsd 4.99.72 NetBSD 4.99.72 (XEN3_DOM0) #0: Fri Aug 29 23:49:07 EEST 2008  root@netbsd:/usr/obj/sys/arch/i386/compile/XEN3_DOM0 i386

>Description:
Quoting from the fileassoc(9) man page under the EXAMPLES section:

void
myhook_cleanup(void *data)
{
    printf("Myhook: Removing entry for file.0);
    ...handle file entry removal...
    free(data, M_TEMP);
}

Where as the fileassoc.9 file in share/man/man9/ has:


.Bd -literal -offset indent
int
myhook_acl_add(struct vnode *vp, struct myhook_acl *acl)
{
        int error;

        error = fileassoc_add(vp, myhook_id, acl);
        if (error) {
                printf("Myhook: Could not add ACL.\n");
                ...handle error...
        }

        printf("Myhook: Added ACL.\n");

        return (0);
}
.Ed

Apparently groff -mdoc interprets C as markup inside the
.Bd -literal .Ed block which shouldn't.

There are more cases in the EXAMPLES section of this man page.

>How-To-Repeat:
man 9 fileassoc

>Fix:

>Release-Note:

>Audit-Trail:
From: "Valeriy E. Ushakov" <uwe@netbsd.org>
To: gnats-bugs@NetBSD.org
Cc: 
Subject: Re: bin/39535: groff -mdoc interprets C as markup inside a .Bd -literal .Ed block
Date: Sun, 14 Sep 2008 00:30:52 +0400

 I don't see that.  Have you ruled out the following:

 . catpage is out of date?

 . terminal setting are broken (wrong number of lines) and man doesn't
   show you complete text of the manpage?

 -uwe

From: "Stathis Kamperis" <ekamperi@gmail.com>
To: uwe@netbsd.org
Cc: gnats-bugs@netbsd.org, gnats-admin@netbsd.org, netbsd-bugs@netbsd.org
Subject: Re: bin/39535: groff -mdoc interprets C as markup inside a .Bd -literal .Ed block
Date: Sun, 14 Sep 2008 14:48:55 +0300

 >The following reply was made to PR bin/39535; it has been noted by GNATS.
 >
 >From: "Valeriy E. Ushakov" <uwe@netbsd.org>
 >To: gnats-bugs@NetBSD.org
 >Cc:
 >Subject: Re: bin/39535: groff -mdoc interprets C as markup inside a .Bd -literal .Ed block
 >Date: Sun, 14 Sep 2008 00:30:52 +0400
 >
 >I don't see that.  Have you ruled out the following:

 Have a look here:
 http://netbsd.gw.com/cgi-bin/man-cgi?fileassoc++NetBSD-current

 Look at the EXAMPLES section in the printf() calls. They are:
 printf("Myhook: Removing entry for file.0);
 printf("Myhook: Could not add ACL.0);
 printf("Myhook: Denying access based on ACL decision.0);
 printf("Myhook: Error occurred during fileassoc removal.0);

 >. catpage is out of date?
 >
 >. terminal setting are broken (wrong number of lines) and man doesn't
 >show you complete text of the manpage?
 >
 > -uwe

 I haven't checked upon these. I'll do it tomorrow afternoon, when I get home,
 as there is no netbsd box here available.

 Thanks for bothering

 Best regards,
 Stathis Kamperis

From: ITOH Yasufumi <itohy@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/39535 CVS commit: src/share/man/man9
Date: Sun, 14 Sep 2008 12:51:39 +0000 (UTC)

 Module Name:	src
 Committed By:	itohy
 Date:		Sun Sep 14 12:51:39 UTC 2008

 Modified Files:
 	src/share/man/man9: fileassoc.9

 Log Message:
 Escape "\" as "\e" in the example.
 Fix formatting problems reported by Stathis Kamperis on PR bin/39535.


 To generate a diff of this commit:
 cvs rdiff -r1.21 -r1.22 src/share/man/man9/fileassoc.9

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

From: ITOH Yasufumi <itohy@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/39535 CVS commit: src/share/man/man4/man4.amiga
Date: Sun, 14 Sep 2008 12:59:19 +0000 (UTC)

 Module Name:	src
 Committed By:	itohy
 Date:		Sun Sep 14 12:59:19 UTC 2008

 Modified Files:
 	src/share/man/man4/man4.amiga: afsc.4 mgnsc.4 wesc.4 zssc.4

 Log Message:
 Remove unneeded  \n"  found on fixing PR 39535.


 To generate a diff of this commit:
 cvs rdiff -r1.7 -r1.8 src/share/man/man4/man4.amiga/afsc.4
 cvs rdiff -r1.9 -r1.10 src/share/man/man4/man4.amiga/mgnsc.4 \
     src/share/man/man4/man4.amiga/wesc.4 src/share/man/man4/man4.amiga/zssc.4

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

From: "Valeriy E. Ushakov" <uwe@netbsd.org>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: bin/39535: groff -mdoc interprets C as markup inside a .Bd -literal .Ed block
Date: Sun, 14 Sep 2008 18:54:23 +0400

 On Sun, Sep 14, 2008 at 14:48:55 +0300, Stathis Kamperis wrote:

 > Have a look here:
 > http://netbsd.gw.com/cgi-bin/man-cgi?fileassoc++NetBSD-current
 > 
 > Look at the EXAMPLES section in the printf() calls. They are:
 > printf("Myhook: Removing entry for file.0);
 > printf("Myhook: Could not add ACL.0);
 > printf("Myhook: Denying access based on ACL decision.0);
 > printf("Myhook: Error occurred during fileassoc removal.0);

 Bah, my bad.  Sorry.  It's just that your description quoted different
 code snippets for the catpage (myhook_cleanup) and for the nroff
 source (myhook_acl_add) and I assumed you are reporting missing
 examples, I didn't realize you are reporting missing \n's.

 -uwe

State-Changed-From-To: open->feedback
State-Changed-By: dholland@NetBSD.org
State-Changed-When: Tue, 24 Mar 2009 22:45:53 +0000
State-Changed-Why:
Is this fixed?


State-Changed-From-To: feedback->closed
State-Changed-By: dholland@NetBSD.org
State-Changed-When: Sun, 15 Nov 2009 02:29:47 +0000
State-Changed-Why:
Yes, it appears to be fixed.


>Unformatted:

Home	PR Database Search