Subject: bin/5205: ksh manual page formatting ... is not so good in some places.
To: None <gnats-bugs@gnats.netbsd.org>
From: None <cgd@NetBSD.ORG>
List: netbsd-bugs
Date: 03/25/1998 22:33:22
>Number:         5205
>Category:       bin
>Synopsis:       ksh manual page formatting ... is not so good in some places.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people (Utility Bug People)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Mar 25 22:35:01 1998
>Last-Modified:
>Originator:     Chris G. Demetriou
>Organization:
Kernel Hackers 'r' Us
>Release:        NetBSD-current as of Wed Mar 25 21:00:48 PST 1998
>Environment:
System: NetBSD brick.int.demetriou.com 1.3E NetBSD 1.3E (BRICK) #47: Sun Mar 22 15:13:37 PST 1998 cgd@brick.int.demetriou.com:/usr/src/sys/arch/i386/compile/BRICK i386


>Description:
	The ksh manual page looks ugly, and is badly formatted in
	some places.

>How-To-Repeat:
	Read the ksh manual page.  In particular, 'man ksh' then search
	for 'test evaluates the'.  Note that the text around there
	looks like:

       [ expression ]
              test evaluates the expression and returns zero sta-
              tus if true, and 1 status if false and greater than
              1 if there was an error.  It is  normally  used  as
              the  condition  command of if and while statements.
              The following basic expressions are available:

               str                  str  has  non-zero   length.
                                    Note   that   there  is  the
                                    potential  for  problems  if
                                    str turns out to be an oper-
                                    ator (e.g., -r) - it is gen-
                                    erally  better to use a test
                                    like
                                                  [ X"str" !=  X
                                                  ]
                                           instead       (double
                                           quotes  are  used  in
                                           case   str   contains
                                           spaces or file  glob-
                                           ing characters).


	While the indentation of the "str has non-zero" bit isn't
	great, it turns to downright buggy at "instead".  8-)

>Fix:
	Unknown.
>Audit-Trail:
>Unformatted: