mandoc/TODO - diff

Return to TODO CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/TODO between version 1.99 and 1.104

version 1.99, 2011/04/12 23:54:12

version 1.104, 2011/04/30 10:18:24

Line 20

* formatter bugs

************************************************************************

- tbl(7): Horizontal and vertical lines are formatted badly:

With the box option, there is too much white space at the end of cells.

Horizontal lines from "=" lines are a bit too long.

yuri dot pankov at gmail dot com Thu, 14 Apr 2011 05:45:26 +0400

************************************************************************

* missing features

************************************************************************

Line 91

Line 96

- explicitly disallow nested `Bl -column', which would clobber internal

flags defined for struct mdoc_macro

- In .Bl -column .It, the end of the line probably has to be regarded

as an implicit .Ta, if there could be one, see the following mildly

ugly code from login.conf(5):

.Bl -column minpasswordlen program xetcxmotd

.It path Ta path Ta value of Dv _PATH_DEFPATH

.br

Default search path.

reported by Michal Mazurek <akfaew at jasminek dot net>

via jmc@ Thu, 7 Apr 2011 16:00:53 +0059

- inside `.Bl -column' phrases, punctuation is handled like normal

text, e.g. `.Bl -column .It Fl x . Ta ...' should give "-x -."

Line 108

Line 123

--- missing man features -----------------------------------------------

- .RS/.RE can be nested, see e.g. the x11/fluxbox manuals

noticed by dcoppa@ Wed, Apr 13, 2011 at 04:58:14PM +0200:

- groff an-ext.tmac macros (.UR, .UE) occur in xine(5)

reported by brad@ Sat, 15 Jan 2011 15:45:23 -0500

Line 183

Line 201

reminded by jmc@ Thu, 23 Sep 2010 18:13:39 +0059

************************************************************************

* formatting issues: gratuitious differences

* formatting issues: gratuitous differences

************************************************************************

- .Rv (and probably .Ex) print different text if an `Nm' has been named

Line 206

Line 224

Also have `It' complain if `Pp' is invoked at certain times (not

-compact?).

- .Pp between two .It in .Bl -column should produce one,

not two blank lines, see e.g. login.conf(5).

reported by jmc@ Sun, 17 Apr 2011 14:04:58 +0059

- If the *first* line after .It is .Pp, break the line right after

the tag, do not pad with space characters before breaking.

See the description of the a, c, and i commands in sed(1).

Line 319

Line 341

************************************************************************

* error reporting issues

************************************************************************

- In man(7), an empty subsection (.SS) should not be an error, probably

not even a warning. For example, in ExtUtils::CChecker(3p), this is

used in a way similar to empty .It -tag in mdoc(7), that is, explaining

two commands (both presented with .SS markup) in one paragraph of text.

Reported by Gleydson Soares <gsoares at trusted dot com dot br>

on ports@ Tue, 12 Apr 2011 15:39:26 -0300

************************************************************************

* performance issues

CVSweb