===================================================================
RCS file: /cvs/mandoc/TODO,v
retrieving revision 1.285
retrieving revision 1.290
diff -u -p -r1.285 -r1.290
--- mandoc/TODO	2019/03/01 10:57:17	1.285
+++ mandoc/TODO	2019/04/01 15:57:29	1.290
@@ -1,6 +1,6 @@
 ************************************************************************
 * Official mandoc TODO.
-* $Id: TODO,v 1.285 2019/03/01 10:57:17 schwarze Exp $
+* $Id: TODO,v 1.290 2019/04/01 15:57:29 schwarze Exp $
 ************************************************************************
 
 Many issues are annotated for difficulty as follows:
@@ -162,9 +162,15 @@ are mere guesses, and some may be wrong.
 --- missing eqn features -----------------------------------------------
 
 - In a matrix, break the output line after each matrix line.
-  Found in the discussion at CDBUG 2015.
-  Suggested by Avi Weinstock.
-  loc *  exist *  algo *  size *  imp **
+  Found in the discussion at CDBUG 2015.  Suggested by Avi Weinstock.
+  This may not be the ideal solution after all: eqn(7) matrices
+  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.
   loc *  exist *  algo *  size *  imp *
@@ -190,6 +196,30 @@ are mere guesses, and some may be wrong.
 
 --- missing misc features ----------------------------------------------
 
+- man 3am readline
+  does not work because man(1) only accepts digit + one letter,
+  otherwise explicit -s is currently required
+  https://github.com/void-linux/void-packages/issues/9868
+  loc *  exist *  algo *  size *  imp ***
+
+- man 3 readline may show readline(3m)
+  because in manpage_compare, "3" and "3am" compare equal
+  https://github.com/void-linux/void-packages/issues/9868
+  probably requires putting string version of section into struct manpage
+  loc *  exist **  algo *  size *  imp ***
+
+- restore flags for result ordering, but only for man(1), not for apropos(1)
+  such that man 3 syslog show syslog.3 not klogctl.3
+  and such that man 3p acosl shows acosl.3p not acos.3p
+  https://github.com/void-linux/void-packages/issues/9868
+  loc *  exist **  algo *  size *  imp ***
+
+- dead .so links should be entered into the database to avoid:
+  man -M. lvm-config
+  man: outdated mandoc.db lacks lvm-config(8) entry, run makewhatis /co/void-man
+  https://github.com/void-linux/void-packages/issues/9868
+  loc *  exist **  algo *  size *  imp **
+
 - man -ks 1,8 route; kn@ Jul 13, 2018 orally
 
 - italic correction (\/) in PostScript mode
@@ -321,6 +351,8 @@ are mere guesses, and some may be wrong.
 
 - a line starting with "\fB something" counts as starting with whitespace
   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 **
 
 - formatting /usr/local/man/man1/latex2man.1 with groff and mandoc
@@ -342,11 +374,6 @@ are mere guesses, and some may be wrong.
 
 --- HTML issues --------------------------------------------------------
 
-- 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
   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
@@ -443,15 +470,6 @@ 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
   loc *  exist *  algo *  size *  imp **
@@ -519,10 +537,6 @@ are mere guesses, and some may be wrong.
   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
-  with user-defined macros, leading to random breakage.
 
 - Is it possible to further simplify ENDBODY_SPACE?