=================================================================== RCS file: /cvs/mandoc/TODO,v retrieving revision 1.259 retrieving revision 1.270 diff -u -p -r1.259 -r1.270 --- mandoc/TODO 2018/08/10 04:41:25 1.259 +++ mandoc/TODO 2018/09/23 05:34:58 1.270 @@ -1,6 +1,6 @@ ************************************************************************ * Official mandoc TODO. -* $Id: TODO,v 1.259 2018/08/10 04:41:25 schwarze Exp $ +* $Id: TODO,v 1.270 2018/09/23 05:34:58 schwarze Exp $ ************************************************************************ Many issues are annotated for difficulty as follows: @@ -38,15 +38,6 @@ are mere guesses, and some may be wrong. --- missing roff features ---------------------------------------------- -- .ft CB selects constant-width bold font - see groff_out(7) for examples - -- \*(.T prints the device being used, - see groff_char(7) for an example - -- \[charNN], \[charNNN] prints a single-byte codepoint - see groff_char(7) for examples - - .ad (adjust margins) .ad l -- adjust left margin only (flush left) .ad r -- adjust right margin only (flush right) @@ -66,10 +57,6 @@ are mere guesses, and some may be wrong. reported by brad@ Sat, 15 Jan 2011 15:45:23 -0500 loc *** exist *** algo *** size ** imp * -- .while and .shift - found by jca@ in ratpoison(1) Sun, 30 Jun 2013 12:01:09 +0200 - loc * exist ** algo ** size ** imp ** - - \w'' improve width measurements would not be very useful without an expression parser, see below needed for Tcl_NewStringObj(3) via wiz@ Wed, 5 Mar 2014 22:27:43 +0100 @@ -171,15 +158,6 @@ are mere guesses, and some may be wrong. --- 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. @@ -199,9 +177,6 @@ are mere guesses, and some may be wrong. 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; @@ -234,6 +209,9 @@ are mere guesses, and some may be wrong. --- missing eqn features ----------------------------------------------- +- Use a Unicode character for sqrt() in eqn output? + Suggested by an attendee during EuroBSDCon 2018. + - In a matrix, break the output line after each matrix line. Found in the discussion at CDBUG 2015. Suggested by Avi Weinstock. @@ -338,9 +316,6 @@ 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 @@ -418,6 +393,17 @@ are mere guesses, and some may be wrong. --- HTML issues -------------------------------------------------------- +- table of content at the top of HTML (and perhaps ps/pdf) pages + only if there are at least two (or three?) non-standard sections + only if the new option -O toc is given + suggested by an attendee during EuroBSDCon 2018 + +- support -O man with two arguments, typically using the first for + a local tree (like the release pages on mandoc.bsd.lv) and the + second for a remote tree (e.g. man.openbsd.org). + Probable syntax: -O man=first;second + Suggested by kristaps@ during EuroBSDCon 2018. + - wrap Sh and Ss content into
Laura Morales 21 Apr 2018 18:10:48 +0200 (Evaluate whether this is really useful and has no adverse @@ -524,6 +510,15 @@ are mere guesses, and some may be wrong. ************************************************************************ * 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 gre(4): Rename duplicate sections 20 Apr 2018 15:27:33 +0200