mandoc/TODO - diff

Return to TODO CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/TODO between version 1.251 and 1.261

version 1.251, 2018/04/20 14:02:32

version 1.261, 2018/08/10 22:12:44

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

--- missing roff features ----------------------------------------------

- \*(.T prints the device being used,

see groff_char(7) for an example

This is slightly hard because -Tlocale only decides to use ascii or

utf8 when initializing the formatter, so the information is not

yet available to the preprocessor at the parsing stage.

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

- .ad (adjust margins)

.ad l -- adjust left margin only (flush left)

.ad r -- adjust right margin only (flush right)

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

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

Found by naddy@ in devel/cutils cobfusc(1) Mon, 16 Feb 2015 19:10:52 +0100

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

- check for missing roff escape sequences, implement those that are

trivial even if not usually appearing in manual pages, gracefully

ignore the non-trivial ones, document what they are supposed to do

and what mandoc does instead

loc * exist ** algo * size * imp *

--- missing mdoc features ----------------------------------------------

- .Bl -column .Xo support is missing

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

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

is not safe, e.g. `.Bl -column .It Pf a b .' gives "ab."

but should give "ab ."

- check whether it is correct that `D1' uses INDENT+1;

does it need its own constant?

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

- prohibit `Nm' from having non-text HEAD children

(e.g., NetBSD mDNSShared/dns-sd.1)

(mdoc_html.c and mdoc_term.c `Nm' handlers can be slightly simplified)

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

Line 167 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 -----------------------------------------------

- .SY and .YS,

used by many groff manual pages

- preserve punctuation following .ME,

see ditroff(7) for an example

- .TQ tagged paragraph continuation,

see groff_diff(7) for examples

- groff_www(7) .MTO and .URL

These macros were used by the GNU grep(1) man page.

The groff_www(7) manual page itself uses them, too.

We should probably *not* add them to mandoc.

Just mentioning this here to keep track of the abuse.

Laura Morales <lauretas at mail dot com> 20 Apr 2018 07:33:02 +0200

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

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

- the "s" layout column specifier is used for placement of data

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

Line 193 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 **

- vertical centering in cells vertically spanned with ^

pali dot rohar at gmail dot com 16 Jul 2018 13:03:35 +0200

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

- support .ds requests inside tbl(7) code,

see tbl(1) for an example

- support mdoc(7) and man(7) macros inside tbl(7) code;

probably requires the parser reorg and letting tbl(7)

use roff_node such that macro sets can mix;

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

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

suggested by bentley@ Tue, 14 Oct 2014 04:10:55 -0600

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

- implement horizontal and vertical alignment in HTML output

pali dot rohar at gmail dot com 16 Jul 2018 13:03:35 +0200

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

- implement cell spanning in HTML output

pali dot rohar at gmail dot com 16 Jul 2018 13:03:35 +0200

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

- implement table borders in HTML output

pali dot rohar at gmail dot com 16 Jul 2018 13:03:35 +0200

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

--- missing eqn features -----------------------------------------------

- In a matrix, break the output line after each matrix line.

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

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

surrounded by blanks, not when it is part of an unquoted word.

Also, check whether there are more such cases (e.g., +?).

reported by bentley@ 20 Jun 2017 02:04:29 -0600

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

- Primes, opprime, and '

bentley@ Thu, 13 Jul 2017 23:14:20 -0600

--- missing misc features ----------------------------------------------

- man -ks 1,8 route; kn@ Jul 13, 2018 orally

- italic correction (\/) in PostScript mode

Werner LEMBERG on groff at gnu dot org Sun, 10 Nov 2013 12:47:46

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

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

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

* formatting issues: ugly output

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

- .UR can nest inside .TP,

see roff(7) for examples

- revisit empty in-line macros

look at the difference between "Em x Em ." and "Sq x Em ."

Carsten Kunze Fri, 12 Dec 2014 00:15:41 +0100

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

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

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

- duplicate names generate duplicate href="#..." anchor attributes

- wrap Sh and Ss content into <div>

possibly use "#..._<N>" suffixes?

Laura Morales <lauretas at mail dot com> 21 Apr 2018 18:10:48 +0200

Jakub Klinkovsky <j dot l dot k at gmx dot com> 3 Oct 2017 21:23:36 +0200

(Evaluate whether this is really useful and has no adverse

see also the thread: gre(4): Rename duplicate sections

side effects before implementing; if it is possible,

up to 20 Apr 2018 15:27:33 +0200

it does seem cleaner.)

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

- format ".IP *" etc. as <ul> rather than <dl>

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

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

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

- warn about duplicate .Sh/.Ss heads

gre(4): Rename duplicate sections 20 Apr 2018 15:27:33 +0200

loc * exist * algo * size * imp **

- style message about macros inside .Bd -literal and .Dl, in particular

font changing macros like .Cm, .Ar, .Fa (from the mdoclint TODO)

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

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

but just the overall format

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

- makewhatis -p complains about language subdirectories:

/usr/local/man//ru: Unknown directory part

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

* documentation issues

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

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

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

- Enable HTTP compression by detecting gzip encoding and filtering

output through libz.

- Sandbox (see OpenSSH).

- Privilege separation (see OpenSSH).

- 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.

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

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

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

* to improve in the groff_mdoc(7) macros

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

- .Cd # arch1, arch2 in section 4 pages:

find better way to indicate multiple architectures, maybe:

allow .Dt vgafb 4 "macppc sparc64"

already shown as "Device Drivers Manual (macppc sparc64)"

for apropos, make that "vgafb(4) - macppc # sparc64" instead of "- all"

groff can be made to show multiple arches, too, but it is

tedious to do the string parsing in roff code...

jmc@ 23 Apr 2018 07:24:52 +0100 [man for vgafb(4)...]

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

- use uname(1) to set doc-default-operating-system at install time

tobimensch Mon, 1 Dec 2014 00:25:07 +0100

CVSweb