Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 2 Mar 1999 01:07:54 -0500 (EST)
From:      robert@fledge.watson.org
To:        FreeBSD-gnats-submit@freebsd.org
Subject:   misc/10349: nroff mdoc formatting problem for long .Dt
Message-ID:  <199903020607.BAA07486@sleipnir.watson.org>

index | next in thread | raw e-mail


>Number:         10349
>Category:       misc
>Synopsis:       For long .Dt fields, rendering is broken-looking in mdoc
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Mar  1 22:10:00 PST 1999
>Closed-Date:
>Last-Modified:
>Originator:     Robert Watson
>Release:        FreeBSD 4.0-CURRENT i386
>Organization:
>Environment:

FreeBSD 4.0, writing new man pages for library functions.  The function name
aud_delete_event_info is really long--perhaps too long, but it is a POSIX
library name. 

>Description:

When setting the .Dt field in the man page, it is rendered incorrectly in
standard man on a boring xterm:

.Dt aud_delete_event_info 3

becomes:

 
This is ugly and unsightly.  I'm not sure what the right solution is,
other than to truncate function names?  And that doesn't seem write from
a documentation perspective :-).  If it were possible for nroff to truncate
and trail off with a '...' that would probably be best, but I'm not skilled
in nroff.

>How-To-Repeat:

Do as above.

>Fix:

None known, sorry!

>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-bugs" in the body of the message



home | help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199903020607.BAA07486>