mandoc/TODO - diff

Return to TODO CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/TODO between version 1.188 and 1.200

version 1.188, 2014/11/20 02:21:27

version 1.200, 2015/02/17 20:41:50

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

- .fc (field control)

found by naddy@ in xloadimage(1)

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

- .nr third argument (auto-increment step size, requires \n+)

found by bentley@ in sbcl(1) Mon, 9 Dec 2013 18:36:57 -0700

loc * exist * algo * size * imp **

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

reported by brad@ Sat, 15 Jan 2011 15:45:23 -0500

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

- .ta (tab settings) occurs in ircbug(1) and probably gnats(1)

- .ta (tab settings)

reported by brad@ Sat, 15 Jan 2011 15:50:51 -0500

#1 most important issue naddy@ Mon, 16 Feb 2015 20:59:17 +0100

ircbug(1) gnats(1) reported by brad@ Sat, 15 Jan 2011 15:50:51 -0500

also Tcl_NewStringObj(3) via wiz@ Wed, 5 Mar 2014 22:27:43 +0100

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

also posix2time(3) Carsten Kunze Mon, 1 Dec 2014 13:03:10 +0100

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

- .ti (temporary indent)

found by naddy@ in xloadimage(1)

found by naddy@ in xloadimage(1) [devel/libvstr] vstr(3)

found by bentley@ in nmh(1) Mon, 23 Apr 2012 13:38:28 -0600

loc ** exist ** algo ** size * imp ** (parser reorg helps a lot)

- .while and .shift

found by jca@ in ratpoison(1) Sun, 30 Jun 2013 12:01:09 +0200

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

- \c (interrupted text) should prevent the line break

even inside .Bd literal; that occurs in chat(8)

also found in cclive(1) - DocBook output

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

- \h horizontal move

found in cclive(1) DocBook output

#2 most important issue naddy@ Mon, 16 Feb 2015 20:59:17 +0100

Anthony J. Bentley on discuss@ Sat, 21 Sep 2013 22:29:34 -0600

found in cclive(1) nasm(1) bogofilter(1) asciidoc/DocBook output

loc ** exist ** algo ** size * imp ** (parser reorg helps a lot)

bentley@ on discuss@ Sat, 21 Sep 2013 22:29:34 -0600

naddy@ Thu, 4 Dec 2014 16:26:41 +0100

loc ** exist ** algo ** size * imp *** (parser reorg helps a lot)

- \n+ and \n- numerical register increment and decrement

found by bentley@ in sbcl(1) Mon, 9 Dec 2013 18:36:57 -0700

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

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

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

- fix bad block nesting involving multiple identical explicit blocks

see the OpenBSD mdoc_macro.c 1.47 commit message

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

- .Bl -column .Xo support is missing

ultimate goal:

restore .Xr and .Dv to

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

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

from jmc@ Wed, 14 Jul 2010 18:10:32 +0100

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

- \\ is now implemented correctly

* when defining strings and macros using .ds and .de

* when parsing roff(7) and man(7) macro arguments

It does not yet work in mdoc(7) macro arguments

because libmdoc does not yet use mandoc_getarg().

Also check what happens in plain text, it must be identical to \e.

- .Bd -centered implies -filled, not -unfilled, which is not

easy to implement; it requires code similar to .ce, which

we don't have either.

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

Line 160 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 ."

- set a meaningful default if no `Bl' list type is assigned

loc * exist * algo * size * imp ** (already done?)

- have a blank `It' head for `Bl -tag' not puke

loc * exist * algo * size * imp ** (already done?)

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

does it need its own constant?

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

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

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

--- compatibility checks -----------------------------------------------

- write a configure check for [[:<:]] support and provide some

fallback for whatis(1) when it doesn't work;

Svyatoslav Mishyn Wed, 17 Dec 2014 11:07:10 +0200

- is .Bk implemented correctly in modern groff?

sobrado@ Tue, 19 Apr 2011 22:12:55 +0200

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

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

* formatting issues: ugly output

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

- a column list with blank `Ta' cells triggers a spurrious

- 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

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

- a column list with blank `Ta' cells triggers a spurious

start-with-whitespace printing of a newline

- In .Bl -column, .It a<tab>"b<tab>c"

shows the quotes in groff, but not in mandoc

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

- In .Bl -column,

.It Em Authentication<tab>Key Length

ought to render "Key Length" with emphasis, too,

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

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

reminded by jmc@ Thu, 23 Sep 2010 18:13:39 +0059

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

- a line starting with "\fB something" counts as starting with whitespace

and triggers a line break; found in audio/normalize-mp3(1)

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

- formatting /usr/local/man/man1/latex2man.1 with groff and mandoc

reveals lots of bugs both in groff and mandoc...

reported by bentley@ Wed, 22 May 2013 23:49:30 -0600

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

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

Steffen Nurpmeso Sat, 08 Nov 2014 13:34:59 +0100

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

- .Rv (and probably .Ex) print different text if an `Nm' has been named

or not (run a manual without `Nm blah' to see this). I'm not sure

that this exists in the wild, but it's still an error.

loc * exist * algo * size * imp * (already done?)

- In .Bl -bullet, the groff bullet is "+\b+\bo\bo", the mandoc bullet

is just "o\bo". The problem is to not break ps/pdf when fixing.

see for example OpenBSD ksh(1)

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

- In .Bl -enum -width 0n, groff continues one the same line after

the number, mandoc breaks the line.

mail to kristaps@ Mon, 20 Jul 2009 02:21:39 +0200

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

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

loc * exist * algo * size * imp *

- trailing whitespace must be ignored even when followed by a font escape,

see for example

makes

\fBdig \fR

operate in batch mode

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

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

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

- improve hashing mechanism for macros (quite important: performance)

Line 557 Several areas can be cleaned up to make mandoc even fa

Line 546 Several areas can be cleaned up to make mandoc even fa

- the PDF file is HUGE: this can be reduced by using relative offsets

- instead of re-initialising the roff predefined-strings set before each

parse, create a read-only version the first time and copy it

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

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

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

- Find better ways to prevent endless loops

in roff(7) macro and string expansion.

- Finish cleanup of date handling.

Decide which formats should be recognized where.

Update both mdoc(7) and man(7) documentation.

Line 598 Several areas can be cleaned up to make mandoc even fa

Line 590 Several areas can be cleaned up to make mandoc even fa

- Have Mac OSX systems automatically disable -static compilation of the

CGI: -static isn't supported.

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

* to improve in the groff_mdoc(7) macros

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

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

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

CVSweb