Subject: bin/5205: ksh manual page formatting ... is not so good in some places.
To: None <>
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
>Originator:     Chris G. Demetriou
Kernel Hackers 'r' Us
>Release:        NetBSD-current as of Wed Mar 25 21:00:48 PST 1998
System: NetBSD 1.3E NetBSD 1.3E (BRICK) #47: Sun Mar 22 15:13:37 PST 1998 i386

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

	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
                                                  [ 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-)