mandoc/TODO - diff

Return to TODO CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/TODO between version 1.79 and 1.82

version 1.79, 2011/01/22 20:24:53

version 1.82, 2011/01/23 15:35:10

Line 7

* parser bugs

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

- .TP before .SH is still FATAL in man(7)

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

- the roff parser doesn't tolerate additional characters between

a macro and the \} terminating a conditional block, e.g.

.if n \{

Line 23

Line 26

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

- pod2man expects `tr' to be implemented for \*(-- to work

- .ad (adjust margins)

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

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

.ad c -- center text on line

.ad b -- adjust both margins (alias: .ad n)

.na -- temporarily disable adjustment without changing the mode

.ad -- re-enable adjustment without changing the mode

Adjustment mode is ignored while in no-fill mode (.nf).

- implement `rm' - it is easy to do and used in the pod2man preamble

- .it (line traps) occur in mysql(1), yasm_arch(7)

reminded by brad@ Sun, Jan 09, 2011 at 09:45:58PM -0500

generated by DocBook XSL Stylesheets v1.71.1 <http://docbook.sf.net/>

reported by brad@ Sat, 15 Jan 2011 15:48:18 -0500

- .ns (no-space mode) occurs in xine-config(1)

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

- xloadimage(1) wants .ti (temporary indent), rep by naddy@

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

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

- pod2man expects `tr' to be implemented for \*(-- to work

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

- fix bad block nesting involving multiple identical explicit blocks

Line 53

Line 72

because libmdoc does not yet use mandoc_getarg().

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

- .Bd -filled should not be the same as .Bd -ragged, but align both

the left and right margin. In groff, it is implemented in terms

of .ad b, which we don't have either. Found in cksum(1).

- implement blank `Bl -column', such as

.Bl -column

.It foo Ta bar

Line 84

Line 107

should either just work or be a warning

reported by naddy@

- groff an-ext.tmac macros (.UR, .UE) occur in xine(5)

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

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

- implement basic non-parametric .de to support e.g. sox(1)

Line 102

Line 128

- look at pages generated from reStructeredText, e.g. devel/mercurial hg(1)

These are a weird mixture of man(7) and custom autogenerated low-level

roff stuff. Figure out to what extent we can cope.

For details, see http://docutils.sourceforge.net/rst.html

noted by stsp@ Sat, 24 Apr 2010 09:17:55 +0200

reminded by nicm@ Mon, 3 May 2010 09:52:41 +0100

CVSweb