version 1.282, 2019/01/04 03:39:01 |
version 1.289, 2019/03/04 13:01:57 |
Line 62 are mere guesses, and some may be wrong. |
|
Line 62 are mere guesses, and some may be wrong. |
|
needed for Tcl_NewStringObj(3) via wiz@ Wed, 5 Mar 2014 22:27:43 +0100 |
needed for Tcl_NewStringObj(3) via wiz@ Wed, 5 Mar 2014 22:27:43 +0100 |
loc ** exist *** algo *** size * imp *** |
loc ** exist *** algo *** size * imp *** |
|
|
- \\ in high-level macro arguments |
|
Currently, \\ is expanded in two situations: |
|
1) macro and string definition (roff.c setstrn()) |
|
2) macro argument parsing (mandoc.c mandoc_getarg()) |
|
For user defined macros, the second happens in time because of ROFF_REPARSE. |
|
But for standard high-level macros, it only happens after entering the |
|
high level parsers, which is too late because the code doesn't get |
|
back to roff.c roff_res() from that point. Because this requires |
|
distinguishing requests, user-defined macros and standard macros |
|
on the roff_res() level, it is hard to solve without the parser reorg. |
|
Found by naddy@ in devel/cutils cobfusc(1) Mon, 16 Feb 2015 19:10:52 +0100 |
|
loc *** exist *** algo *** size ** imp * |
|
|
|
--- missing mdoc features ---------------------------------------------- |
--- missing mdoc features ---------------------------------------------- |
|
|
- .Bl -column .Xo support is missing |
- .Bl -column .Xo support is missing |
Line 166 are mere guesses, and some may be wrong. |
|
Line 153 are mere guesses, and some may be wrong. |
|
loc *** exist ** algo *** size ** imp *** |
loc *** exist ** algo *** size ** imp *** |
|
|
- look at the POSIX manuals in the books/man-pages-posix port, |
- look at the POSIX manuals in the books/man-pages-posix port, |
they use some unsupported tbl(7) features. |
they use some unsupported tbl(7) features, mostly macros in tbl(7). |
loc * exist ** algo ** size ** imp *** |
loc * exist ** algo ** size ** imp *** |
|
|
- look what Joerg Schilling manual pages use |
- look what Joerg Schilling manual pages use |
Line 175 are mere guesses, and some may be wrong. |
|
Line 162 are mere guesses, and some may be wrong. |
|
--- missing eqn features ----------------------------------------------- |
--- missing eqn features ----------------------------------------------- |
|
|
- In a matrix, break the output line after each matrix line. |
- In a matrix, break the output line after each matrix line. |
Found in the discussion at CDBUG 2015. |
Found in the discussion at CDBUG 2015. Suggested by Avi Weinstock. |
Suggested by Avi Weinstock. |
This may not be the ideal solution after all: eqn(7) matrices |
loc * exist * algo * size * imp ** |
are lists of columns, so Avi's proposal would show each *column* |
|
on its own *line*, which is likely to cause confusion. |
|
A better solution, but much harder to implement, would be to |
|
actually show the coordinates of column vectors on different |
|
terminal output lines, using the clumnated output facilities |
|
developed for .Bl -tag, .Bl -column, and also used for tbl(7). |
|
loc * exist * algo ** size ** imp ** |
|
|
- The "size" keyword is parsed, but ignored by the formatter. |
- The "size" keyword is parsed, but ignored by the formatter. |
loc * exist * algo * size * imp * |
loc * exist * algo * size * imp * |
Line 334 are mere guesses, and some may be wrong. |
|
Line 327 are mere guesses, and some may be wrong. |
|
|
|
- a line starting with "\fB something" counts as starting with whitespace |
- a line starting with "\fB something" counts as starting with whitespace |
and triggers a line break; found in audio/normalize-mp3(1) |
and triggers a line break; found in audio/normalize-mp3(1) |
|
This will become easier once escape sequences are represented |
|
by syntax tree nodes. |
loc ** exist * algo ** size * imp ** |
loc ** exist * algo ** size * imp ** |
|
|
- formatting /usr/local/man/man1/latex2man.1 with groff and mandoc |
- formatting /usr/local/man/man1/latex2man.1 with groff and mandoc |
Line 355 are mere guesses, and some may be wrong. |
|
Line 350 are mere guesses, and some may be wrong. |
|
|
|
--- HTML issues -------------------------------------------------------- |
--- HTML issues -------------------------------------------------------- |
|
|
- wrap Sh and Ss content into <div> |
|
Laura Morales <lauretas at mail dot com> 21 Apr 2018 18:10:48 +0200 |
|
(Evaluate whether this is really useful and has no adverse |
|
side effects before implementing; if it is possible, |
|
it does seem cleaner.) |
|
loc ** exist ** algo * size * imp *** |
|
|
|
- .IP wants vertical spacing before itself; |
|
currently, it is formatted like .Bl -compact. |
|
Fixing this requires getting rid of the "float" |
|
in the CSS for .Bl-tag first. |
|
Reminded by Pali Rohar 25 Oct 2018 10:10:35 +0200. |
|
|
|
- format multiple subsequent .IP as a single list |
|
rather than opening a new list for each item |
|
Pali Rohar 25 Nov 2018 14:34:26 +0100 |
|
loc * exist ** algo * size * imp *** |
|
|
|
- format ".IP *" etc. as <ul> rather than <dl> |
|
https://github.com/Debian/debiman/issues/67 |
|
reminded by Pali Rohar 25 Nov 2018 14:34:26 +0100 |
|
loc ** exist ** algo ** size * imp *** |
|
|
|
- .Bf at the beginning of a paragraph inserts a bogus 1ex horizontal |
- .Bf at the beginning of a paragraph inserts a bogus 1ex horizontal |
space, see for example random(3). Introduced in |
space, see for example random(3). Introduced in |
http://mdocml.bsd.lv/cgi-bin/cvsweb/mdoc_html.c.diff?r1=1.91&r2=1.92 |
http://mdocml.bsd.lv/cgi-bin/cvsweb/mdoc_html.c.diff?r1=1.91&r2=1.92 |
Line 474 are mere guesses, and some may be wrong. |
|
Line 446 are mere guesses, and some may be wrong. |
|
* warning issues |
* warning issues |
************************************************************************ |
************************************************************************ |
|
|
- When a man(1) command returns no result and there was an -S |
|
argument, check the -S argument against the list of valid |
|
architectures and say "Unknown architecture AAA" rather than |
|
"No entry for NNN in the manual" if there is no match. |
|
Requires moving the lists of valid architectures out of |
|
mdoc_validate.c such that they can be used by main.c. |
|
Discussed with jmc@ 10 Aug 2018 19:20:12 +0100. |
|
loc ** exist * algo * size * imp ** |
|
|
|
- warn about duplicate .Sh/.Ss heads |
- warn about duplicate .Sh/.Ss heads |
gre(4): Rename duplicate sections 20 Apr 2018 15:27:33 +0200 |
gre(4): Rename duplicate sections 20 Apr 2018 15:27:33 +0200 |
loc * exist * algo * size * imp ** |
loc * exist * algo * size * imp ** |
Line 513 are mere guesses, and some may be wrong. |
|
Line 476 are mere guesses, and some may be wrong. |
|
all over mdoc_macro.c and all subtly different. |
all over mdoc_macro.c and all subtly different. |
loc ** exist ** algo ** size ** imp ** |
loc ** exist ** algo ** size ** imp ** |
|
|
- style message about suspicious uses of - vs. \- vs. \(mi |
|
e.g. -1 is likely wrong (from the mdoclint TODO) |
|
|
|
- warn about punctuation - e.g. ',' and ';' - at the beginning |
- warn about punctuation - e.g. ',' and ';' - at the beginning |
of a text line, if it is likely intended to follow the preceding |
of a text line, if it is likely intended to follow the preceding |
output without intervening whitespace, in particular after a |
output without intervening whitespace, in particular after a |
Line 529 are mere guesses, and some may be wrong. |
|
Line 489 are mere guesses, and some may be wrong. |
|
* documentation issues |
* documentation issues |
************************************************************************ |
************************************************************************ |
|
|
- dashes, hyphens, and minus signs in manual pages |
|
jmc@ Fri, 28 Mar 2014 07:19:27 +0000 |
|
|
|
- mark macros as: page structure domain, manual domain, general text domain |
- mark macros as: page structure domain, manual domain, general text domain |
is this useful? |
is this useful? |
|
|
Line 557 are mere guesses, and some may be wrong. |
|
Line 514 are mere guesses, and some may be wrong. |
|
Found by Aaron M. Ucko in the GNU Hurd via Bdale Garbee, |
Found by Aaron M. Ucko in the GNU Hurd via Bdale Garbee, |
https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=829624 |
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 |
|
with user-defined macros, leading to random breakage. |
|
|
|
- Is it possible to further simplify ENDBODY_SPACE? |
- Is it possible to further simplify ENDBODY_SPACE? |
|
|
- Find better ways to prevent endless loops |
- Find better ways to prevent endless loops |
Line 580 are mere guesses, and some may be wrong. |
|
Line 533 are mere guesses, and some may be wrong. |
|
output through libz. |
output through libz. |
- Privilege separation (see OpenSSH). |
- Privilege separation (see OpenSSH). |
- Enable caching support via HTTP 304 and If-Modified-Since. |
- Enable caching support via HTTP 304 and If-Modified-Since. |
- Have Mac OSX systems automatically disable -static compilation of the |
|
CGI: -static isn't supported. |
|
|
|
************************************************************************ |
************************************************************************ |
* to improve in the groff_mdoc(7) macros |
* to improve in the groff_mdoc(7) macros |