************************************************************************
* Official mandoc TODO.
-* $Id: TODO,v 1.213 2015/08/29 15:10:28 schwarze Exp $
+* $Id: TODO,v 1.219 2016/07/19 21:31:55 schwarze Exp $
************************************************************************
Many issues are annotated for difficulty as follows:
see also matthew@ Fri, 18 Jul 2014 19:25:12 -0700
loc * exist * algo ** size * imp ***
+- In -man -Thtml, .nf does not preserve indentation.
+ It should either convert blanks to
+ or use <pre> rather than <div> (like .Bd -literal does).
+ Reported by afresh1@ 12 Apr 2016 14:35:45 -0700
+
+- .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
+ reported by deraadt@ Mon, 28 Sep 2015 20:14:13 -0600 (MDT)
+ loc ** exist ** algo ** size * imp *
+
- jsg on icb, Nov 3, 2014:
try to guess Xr in man(7) for hyperlinking
* 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
- loc * exist * algo * size * imp *
-
- systems having UTF-8 but not en_US.UTF-8
call locale(1) from ./configure, select a UTF-8-locale,
and use that for test-wchar.c and term_ascii.c
* warning issues
************************************************************************
+- provide a way in mandoc(1) to warn about broken .Xr links;
+ 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
+
- Report errors in -O suboption parsing.
loc * exist * algo * size * imp **
to tech@mdocml, naddy@ Wed, 28 Sep 2011 11:21:46 +0200
wait! kristaps@ Sun, 02 Oct 2011 17:12:52 +0200
-- for system errors, use errno/strerror/warn/err
-
************************************************************************
* documentation issues
************************************************************************
************************************************************************
- 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
Several areas can be cleaned up to make mandoc even faster. These are
* structural issues
************************************************************************
-- Use libz directly instead of forking gunzip(1).
- Suggested by bapt at FreeBSD among others.
-
- 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.
- struct mparse refactoring
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
************************************************************************