mandoc/TODO - diff

Return to TODO CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/TODO between version 1.144 and 1.156

version 1.144, 2012/10/31 09:20:23

version 1.156, 2013/09/22 23:21:23

Line 4

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

* crashes

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

- .Bl -tag followed by a text node preceding the first .It should not

throw a FATAL error, but only a normal ERROR. Putting this into the

HEAD of an implicit .It might be cleanest, inserting an implicit .Pp

or just dumping the orphan stuff directly into the BODY of the .Bl

might be easier to implement, and all options can no doubt be made

to yield correct (i.e. groff bug-compatible) rendering.

Anthony J. Bentley on discuss@ Sun, 22 Sep 2013 16:33:21 -0600

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

* missing features

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

Line 23

Line 35

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

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

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

- .as (append to string)

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

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

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

- .ce (center N lines)

found by naddy@ in xloadimage(1)

found by Juan Francisco Cantero Hurtado <iam at juanfra dot info>

in lang/racket(1) Thu, 20 Jun 2013 03:19:11 +0200

- .fc (field control)

found by naddy@ in xloadimage(1)

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

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

also uses .ce (center N lines) and .fc (field control)

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

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

- .ti (temporary indent)

found by naddy@ in xloadimage(1)

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

- .while and .shift

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

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

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

also found in cclive(1) - DocBook output

- \h horizontal move

found in cclive(1) DocBook output

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

- using undefined strings or macros defines them to be empty

wl@ Mon, 14 Nov 2011 14:37:01 +0000

Line 132

Line 159

--- missing misc features ----------------------------------------------

- The whatis(1) utility looks for whole words in Nm.

If the file name of a page does not agree with the contents of any

of its Nm macros (e.g. pool(9)), add the file name as an Nm entry

to the mandoc.db as well, such that whatis(1) finds it.

If there is a page with a file name that does not appear as a substring

neither in Nm nor in Nd, the same fix would allow finding that page

with apropos(1) using the file name as a key, as well.

Issue reported by tedu@ Fri, 05 Jul 2013 21:15:23 -0400

- clean up escape sequence handling, creating three classes:

(1) fully implemented, or parsed and ignored without loss of content

(2) unimplemented, potentially causing loss of content

Line 139

Line 175

see textproc/mgdiff(1) for nice examples

(3) undefined, just output the character -> perhaps WARNING

- The \t escape sequence is the same as a literal tab, see for example

the ASCII table in hexdump(1) where

.Bl -column \&000_nu \&001_so \&002_st \&003_et \&004_eo

.It \&000\ nul\t001\ soh\t002\ stx\t003\ etx\t004\ eot\t005\ enq

produces

000 nul 001 soh 002 stx 003 etx 004 eot 005 enq

and the example in oldrdist(1)

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

Line 190

Line 218

of in_line() - put trailing punctuation out of scope.

Found in mount_nfs(8) and exports(5), search for "Appendix".

- Trailing punctuation after .%T triggers EOS spacing, at least

outside .Rs (eek!). Simply setting ARGSFL_DELIM for .%T is not

the right solution, it sends mandoc into an endless loop.

reported by Nicolas Joly Sat, 17 Nov 2012 11:49:54 +0100

- in enclosures, mandoc sometimes fancies a bogus end of sentence

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

- Trailing isolated dots lack EOS for some macros.

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

This cannot use mandoc_eos() because groff only does EOS

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

for isolated dots at least in some of these cases.

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

Affected macros included those using in_line_eoln().

Make sure to fix open(2)

without breaking fstat(1), ksh(1), tzset(3) and UKC(8).

reported by Nicolas Joly Fri, 12 Oct 2012 17:00:36 +0200

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

* formatting issues: gratuitous differences

Line 225

Line 254

- If the first line after .It is .D1, do not assert a blank line

in between, see for example tmux(1).

reported by nicm@ 13 Jan 2011 00:18:57 +0000

- Trailing punctuation after .It should trigger EOS spacing.

reported by Nicolas Joly Sat, 17 Nov 2012 11:49:54 +0100

Probably, this should be fixed somewhere in termp_it_pre(), not sure.

- .Nx 1.0a

should be "NetBSD 1.0A", not "NetBSD 1.0a",

CVSweb