version 1.211, 2015/07/14 19:40:05 |
version 1.229, 2017/01/28 22:32:51 |
Line 33 Obviously, as the issues have not been solved yet, the |
|
Line 33 Obviously, as the issues have not been solved yet, the |
|
are mere guesses, and some may be wrong. |
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 |
* 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 |
uqs@ Thu, 2 Jun 2011 11:33:35 +0200 |
loc * exist ** algo *** size * imp ** |
loc * exist ** algo *** size * imp ** |
|
|
--- missing man features ----------------------------------------------- |
--- missing tbl features ----------------------------------------------- |
|
|
- -T[x]html doesn't stipulate non-collapsing spaces in literal mode |
- horizontal lines in the layout still consume data cells |
|
and can be mixed with actual data on the same table line |
|
synaptics(4) found by tedu@ Mon, 17 Aug 2015 21:17:42 -0400 |
|
loc ** exist ** algo ** size ** imp *** |
|
|
--- missing tbl features ----------------------------------------------- |
- 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 ** |
|
|
|
- the "s" layout column specifier is used for placement of data |
|
into columns, but ignored during column width calculations |
|
synaptics(4) found by tedu@ Mon, 17 Aug 2015 21:17:42 -0400 |
|
loc * exist ** algo *** size * imp ** |
|
|
- support mdoc(7) and man(7) macros inside tbl(7) code; |
- support mdoc(7) and man(7) macros inside tbl(7) code; |
probably requires the parser reorg and letting tbl(7) |
probably requires the parser reorg and letting tbl(7) |
use roff_node such that macro sets can mix; |
use roff_node such that macro sets can mix; |
Line 251 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@ |
even for apropos title line output; req by bapt@ |
loc * exist * algo * size * imp *** |
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: |
- clean up escape sequence handling, creating three classes: |
(1) fully implemented, or parsed and ignored without loss of content |
(1) fully implemented, or parsed and ignored without loss of content |
(2) unimplemented, potentially causing loss of content |
(2) unimplemented, potentially causing loss of content |
Line 396 are mere guesses, and some may be wrong. |
|
Line 395 are mere guesses, and some may be wrong. |
|
|
|
--- HTML issues -------------------------------------------------------- |
--- 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: |
- jsg on icb, Nov 3, 2014: |
try to guess Xr in man(7) for hyperlinking |
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 tables used to render the three-part page headers actually force |
the width of the <body> to the max-width given for <html>. |
the width of the <body> to the max-width given for <html>. |
Line 504 are mere guesses, and some may be wrong. |
|
Line 506 are mere guesses, and some may be wrong. |
|
loc ** exist ** algo ** size * imp ** |
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 |
|
|
|
************************************************************************ |
|
* warning issues |
* 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 |
- warn when .Sh or .Ss contain other macros |
Steffen Nurpmeso, savannah.gnu.org/bugs/index.php?45034 |
Steffen Nurpmeso, savannah.gnu.org/bugs/index.php?45034 |
loc * exist * algo * size * imp ** |
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 |
- warn about attempts to call non-callable macros |
Steffen Nurpmeso Tue, 11 Nov 2014 22:55:16 +0100 |
Steffen Nurpmeso Tue, 11 Nov 2014 22:55:16 +0100 |
Note that formatting is inconsistent in groff. |
Note that formatting is inconsistent in groff. |
Line 557 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 |
to tech@mdocml, naddy@ Wed, 28 Sep 2011 11:21:46 +0200 |
wait! kristaps@ Sun, 02 Oct 2011 17:12:52 +0200 |
wait! kristaps@ Sun, 02 Oct 2011 17:12:52 +0200 |
|
|
- for system errors, use errno/strerror/warn/err |
|
|
|
************************************************************************ |
************************************************************************ |
* documentation issues |
* documentation issues |
************************************************************************ |
************************************************************************ |
Line 583 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)? |
- 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 |
from kristaps@ Sat, 09 Aug 2014 13:51:36 +0200 |
|
|
Several areas can be cleaned up to make mandoc even faster. These are |
Several areas can be cleaned up to make mandoc even faster. These are |
Line 602 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 |
* 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 |
- We use the input line number at several places to distinguish |
same-line from different-line input. That plainly doesn't work |
same-line from different-line input. That plainly doesn't work |
Line 619 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 |
- struct mparse refactoring |
Steffen Nurpmeso Thu, 04 Sep 2014 12:50:00 +0200 |
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 |
* CGI issues |