mandoc/TODO - diff

Return to TODO CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/TODO between version 1.213 and 1.229

version 1.213, 2015/08/29 15:10:28

version 1.229, 2017/01/28 22:32:51

Line 33 Obviously, as the issues have not been solved yet, the

are mere guesses, and some may be wrong.

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

* crashes

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

- The abort() in bufcat(), html.c, can be triggered via buffmt_includes()

by running -Thtml -Oincludes on a file containing a long .In argument.

Fixing this will probably require reworking the whole bufcat() concept.

loc ** exist * algo * size ** imp **

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

* missing features

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

Line 202 are mere guesses, and some may be wrong.

Line 193 are mere guesses, and some may be wrong.

uqs@ Thu, 2 Jun 2011 11:33:35 +0200

loc * exist ** algo *** size * imp **

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

- -T[x]html doesn't stipulate non-collapsing spaces in literal mode

--- missing tbl features -----------------------------------------------

- horizontal lines in the layout still consume data cells

Line 213 are mere guesses, and some may be wrong.

Line 200 are mere guesses, and some may be wrong.

synaptics(4) found by tedu@ Mon, 17 Aug 2015 21:17:42 -0400

loc ** exist ** algo ** size ** imp ***

- break long text into lines inside cells

net/lftp(1) from jirib via bentley@ Sep 13, 2016

- layout l1 for a column of max text width 3 reduces the following

inter-column spacing for groff, but not for mandoc

net/lftp(1) from jirib via bentley@ Sep 13, 2016

- the "w" layout option is ignored

synaptics(4) found by tedu@ Mon, 17 Aug 2015 21:17:42 -0400

loc * exist * algo * size * imp **

Line 265 are mere guesses, and some may be wrong.

Line 259 are mere guesses, and some may be wrong.

even for apropos title line output; req by bapt@

loc * exist * algo * size * imp ***

- makewhatis(8) for preformatted pages:

parse the section number from the header line

and compare to the section number from the directory name

loc * exist * algo * size * imp **

- Does makewhatis(8) detect missing NAME sections, missing names,

and missing descriptions in all the file formats?

loc * exist * algo * size * imp ***

- clean up escape sequence handling, creating three classes:

(1) fully implemented, or parsed and ignored without loss of content

(2) unimplemented, potentially causing loss of content

Line 410 are mere guesses, and some may be wrong.

Line 395 are mere guesses, and some may be wrong.

--- HTML issues --------------------------------------------------------

- <dl><dt><dd> formatting is ugly

- .Bf at the beginning of a paragraph inserts a bogus 1ex horizontal

hints are easy to find on the web, e.g.

space, see for example random(3). Introduced in

http://stackoverflow.com/questions/1713048/

http://mdocml.bsd.lv/cgi-bin/cvsweb/mdoc_html.c.diff?r1=1.91&r2=1.92

see also matthew@ Fri, 18 Jul 2014 19:25:12 -0700

reported by deraadt@ Mon, 28 Sep 2015 20:14:13 -0600 (MDT)

loc * exist * algo ** size * imp ***

loc ** exist ** algo ** size * imp *

- jsg on icb, Nov 3, 2014:

try to guess Xr in man(7) for hyperlinking

and render them with <a class="Xr" href=...>

https://github.com/Debian/debiman/issues/15

loc * exist * algo ** size ** imp **

- The tables used to render the three-part page headers actually force

the width of the <body> to the max-width given for <html>.

Line 518 are mere guesses, and some may be wrong.

Line 506 are mere guesses, and some may be wrong.

loc ** exist ** algo ** size * imp **

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

* portability

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

- word boundaries in regular expressions for whatis(1)

set up config tests to use [[:<:]], \<, or nothing

Svyatoslav Mishyn Wed, 17 Dec 2014 11:07:10 +0200

reminded by Peter Bray Fri, 03 Apr 2015 23:02:16 +1100

loc * exist * algo * size * imp *

- systems having UTF-8 but not en_US.UTF-8

call locale(1) from ./configure, select a UTF-8-locale,

and use that for test-wchar.c and term_ascii.c

to Markus Waldeck Sat, 18 Jul 2015 01:55:37 +0200

loc * exist * algo * size * imp *

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

* warning issues

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

- Report errors in -O suboption parsing.

- provide a way in mandoc(1) to warn about broken .Xr links;

loc * exist * algo * size * imp **

probably cannot be on by default in -Tlint because it needs

to access the manpath and mandoc.db(3) after parsing.

asked for by jmc@ Fri, 4 Dec 2015 22:39:40 +0000

- warn when .Sh or .Ss contain other macros

Steffen Nurpmeso, savannah.gnu.org/bugs/index.php?45034

loc * exist * algo * size * imp **

- check that MANDOCERR_BADTAB is thrown in the right cases,

i.e. when finding a literal tab character in fill mode,

and possibly change the wording of the warning message

to refer to fill mode, not literal mode

See the mail from Werner LEMBERG on the groff list,

Fri, 14 Feb 2014 18:54:42 +0100 (CET)

loc * exist ** algo ** size * imp **

- warn about attempts to call non-callable macros

Steffen Nurpmeso Tue, 11 Nov 2014 22:55:16 +0100

Note that formatting is inconsistent in groff.

Line 578 are mere guesses, and some may be wrong.

Line 544 are mere guesses, and some may be wrong.

to tech@mdocml, naddy@ Wed, 28 Sep 2011 11:21:46 +0200

wait! kristaps@ Sun, 02 Oct 2011 17:12:52 +0200

- for system errors, use errno/strerror/warn/err

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

* documentation issues

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

Line 604 are mere guesses, and some may be wrong.

Line 568 are mere guesses, and some may be wrong.

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

- Why are we using MAP_SHARED, not MAP_PRIVATE for mmap(2)?

How does SQLITE_CONFIG_PAGECACHE actually work? Document it!

from kristaps@ Sat, 09 Aug 2014 13:51:36 +0200

Several areas can be cleaned up to make mandoc even faster. These are

Line 623 Several areas can be cleaned up to make mandoc even fa

Line 586 Several areas can be cleaned up to make mandoc even fa

* structural issues

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

- Use libz directly instead of forking gunzip(1).

- POSIX says in the documentation of sysconf(3) that PATH_MAX

Suggested by bapt at FreeBSD among others.

is allowed to be so large that it is a bad idea to use it

for sizing static buffers. So use dynamic buffers throughout.

See the file test-PATH_MAX.c for details.

Found by Aaron M. Ucko in the GNU Hurd via Bdale Garbee,

https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=829624

- We use the input line number at several places to distinguish

same-line from different-line input. That plainly doesn't work

Line 640 Several areas can be cleaned up to make mandoc even fa

Line 607 Several areas can be cleaned up to make mandoc even fa

- struct mparse refactoring

Steffen Nurpmeso Thu, 04 Sep 2014 12:50:00 +0200

- Consider creating some views that will make the database more

readable from the sqlite3 shell. Consider using them to

abstract from the database structure, too.

suggested by espie@ Sat, 19 Apr 2014 14:52:57 +0200

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

* CGI issues

CVSweb