>Number:         3625
>Category:       misc
>Synopsis:       [dM] nroff -mandoc lists broken
>Confidential:   no
>Severity:       serious
>Priority:       low
>Responsible:    misc-bug-people (Misc Bug People)
>State:          open
>Class:          sw-bug
>Submitter-Id:   net
>Arrival-Date:   Wed May 14 14:20:01 1997
>Last-Modified:
>Originator:     der Mouse
>Organization:
	Dis-
>Release:        1.2_BETA
>Environment:
Verified present on these systems:
	NetBSD Twig.Rodents.Montreal.QC.CA 1.2_BETA NetBSD 1.2_BETA (TWIG) #0: Tue Sep 3 00:45:26 EDT 1996 mouse@Twig.Rodents.Montreal.QC.CA:/mouse/sources/working-usr-src/sys/arch/sun3/compile/TWIG sun3
	NetBSD Callisto.McRCIM.McGill.EDU 1.2 NetBSD 1.2 (GENERIC) #2: Fri Apr 18 12:47:55 EDT 1997     mouse@Callisto.McRCIM.McGill.EDU:/sources/working-usr-src/sys/arch/sparc/compile/GENERIC sparc
	NetBSD netbsd1 1.2A NetBSD 1.2A (HOMEWORLD) #1: Wed Aug 28 23:29:37 PDT 1996     thorpej@netbsd1:/local/NetBSD/src/sys/arch/i386/compile/HOMEWORLD i386
>Description:
	Certain lists set with .Bl/.El end up walking off the right
	side of the page.  I don't know what provokes it, but I have a
	small example.
>How-To-Repeat:
% cat dumpi.8
.Dd May 14, 1997
.Dt DUMPI 8
.Sh NAME
.Nm dumpi
.Nd dump info about an inode in a filesystem
.Sh SYNOPSIS
.Nm
.Op Fl dDbpf
.Ar filesystem
.Ar inumber
.Sh DESCRIPTION
.Nm
dumps out information about inode
.Ar inumber
in
.Ar filesystem
(which can be a disk partition or a file containing a filesystem
image).
.Nm
normally prints out info about the inode, followed (for inode types
that have data) by the inode's data.  The options are:
.\" What the _hell_ is the matter with .Bl here?!
.\"  The list walks off the right edge of the page!
.Bl -tag -offset indent
.It Fl d
Suppresses the display of the inode's info.  This is useful for dumping
the contents of a file for which you have the inumber but no path
(possibly because no path to it exists).
.It Fl D
Suppresses the display of the inode's data (if any).
.It Fl b
Prints block numbers of the file's data blocks.  The numbers of
indirect blocks themselves are not shown here; the data blocks pointed
to are printed with parentheses around them (with nested parentheses
for multiple levels of indirection).  The data blocks' contents are not
shown.  This option overrides
.Fl D .
.It Fl p
When used with
.Fl b ,
prints block numbers in terms of disk sectors; normally, they are
printed in terms of filesystem fragments.  Without
.Fl b ,
.Fl p
does nothing.
.Fl f
Treat all types as if they were plain files for purposes of dumping
their data.  Normally, directories are unpacked and printed as
.Aq inumber,path
pairs; with this option, the contents are output directly.
.El
.Sh EXAMPLES
.Li dumpi /dev/rsd3a 2
.Sh SEE ALSO
.Xr fs 5 ,
.Xr newfs 8 ,
.Xr fsck 8 ,
.Xr ipath 8
.Sh AUTHOR
.Li der Mouse <mouse@rodents.montreal.qc.ca>
% md5 dumpi.8
c3717b0623b744405657609b20fece3e
% nroff -mandoc < dumpi.8 > dumpi.0
% less -s dumpi.0
....
     have data) by the inode's data.  The options are:

           -d
             Suppresses the display of the inode's info.  This is useful for
             dumping the contents of a file for which you have the inumber but
             no path (possibly because no path to it exists).

                   -D
                     Suppresses the display of the inode's data (if any).

                           -b
                             Prints block numbers of the file's data blocks.
                             The numbers of indirect blocks themselves are not
....
>Fix:
	I have no clue, but I'd love to see one, even if it takes the
	form of "dummy, you misused .Bl, go reread the manpage"
	(provided it says _which_ manpage to read :-).  I have been
	unable to see any essential difference between this and another
	(larger) manpage that works Just Fine.

					der Mouse

			       mouse@rodents.montreal.qc.ca
		     7D C8 61 52 5D E7 2D 39  4E F1 31 3E E8 B3 27 4B
>Audit-Trail:
>Unformatted: