version 1.87, 2011/01/31 12:52:43 |
version 1.100, 2011/04/13 09:57:41 |
|
|
- .TP before .SH is still FATAL in man(7) |
- .TP before .SH is still FATAL in man(7) |
reported by brad@ Sat, 15 Jan 2011 15:54:54 -0500 |
reported by brad@ Sat, 15 Jan 2011 15:54:54 -0500 |
|
|
- The mdoc(7) parser should handle `\.' as punctuation: |
|
.Ql .if ${VAR} op something \. |
|
should produce |
|
`.if ${VAR} op something'. |
|
not |
|
`.if ${VAR} op something .' |
|
as seen in make(1). |
|
To escape the dot, one would use `\&.'. |
|
|
|
- the roff parser doesn't tolerate additional characters between |
- the roff parser doesn't tolerate additional characters between |
a macro and the \} terminating a conditional block, e.g. |
a macro and the \} terminating a conditional block, e.g. |
.if n \{ |
.if n \{ |
|
|
|
|
- \c (interrupted text) occurs in chat(8) |
- \c (interrupted text) occurs in chat(8) |
|
|
|
- \f(CW (constant width font) occurs in rsyncd.conf(5). |
|
I think we should treat unknown/unavailable fonts as \fR |
|
such that switching back with \fP works correctly - |
|
and doesn't revert the _previous_ \fP. |
|
|
--- missing mdoc features ---------------------------------------------- |
--- missing mdoc features ---------------------------------------------- |
|
|
- fix bad block nesting involving multiple identical explicit blocks |
- fix bad block nesting involving multiple identical explicit blocks |
|
|
|
|
--- missing man features ----------------------------------------------- |
--- missing man features ----------------------------------------------- |
|
|
- bashbug(1) complains "line scope broken" after |
|
.SM |
|
.B something |
|
should either just work or be a warning |
|
reported by naddy@ |
|
|
|
- groff an-ext.tmac macros (.UR, .UE) occur in xine(5) |
- groff an-ext.tmac macros (.UR, .UE) occur in xine(5) |
reported by brad@ Sat, 15 Jan 2011 15:45:23 -0500 |
reported by brad@ Sat, 15 Jan 2011 15:45:23 -0500 |
|
|
|
|
should be indented, see e.g. rpc(3); |
should be indented, see e.g. rpc(3); |
reported by jmc@ on discuss@ Fri, 29 Oct 2010 13:48:33 +0100 |
reported by jmc@ on discuss@ Fri, 29 Oct 2010 13:48:33 +0100 |
|
|
- .Ns should only be effective when called by another macro, |
|
not as a stand-alone macro at the beginning of a line; |
|
see for example the awk(1) SYNOPSIS. |
|
|
|
- .Ns should work when called at the end of an input line, see |
- .Ns should work when called at the end of an input line, see |
the following code in vi(1): |
the following code in vi(1): |
.It Xo |
.It Xo |
|
|
should have a blank line between the text and the beginning of the |
should have a blank line between the text and the beginning of the |
indented paragraph, see for example sudo(1). |
indented paragraph, see for example sudo(1). |
|
|
|
- In man(7), the sequence |
|
.SH HEADER |
|
<blank line> |
|
.PP |
|
regular text |
|
should not produce any blank lines between the header and the text, |
|
see for example rsync(1). |
|
Reported by naddy@ Mon, 28 Mar 2011 20:45:42 +0200 |
|
|
|
- In man(7), the sequence |
|
regular text |
|
.PP |
|
.RS |
|
indented text |
|
should produce one blank line between the regular and indented texts, |
|
see for example rsync(1), and |
|
.RE |
|
<blank line> |
|
.PP |
|
.RS |
|
should produce two,not one blank lines. |
|
Reported by naddy@ Mon, 28 Mar 2011 20:45:42 +0200 |
|
|
|
- In man(7), the sequence |
|
regular text |
|
.IP |
|
.IP "tag" |
|
indented text |
|
should produce one, not four blank lines between the regular text |
|
and the tag, see for example rsync(1). |
|
Likewise, |
|
regular text |
|
.IP |
|
indented text |
|
should produce one, not two blank lines in between, and |
|
regular text |
|
.IP |
|
.RS |
|
.IP tag |
|
indented text |
|
should produce one, not three blank lines. |
|
Reported by naddy@ Mon, 28 Mar 2011 20:45:42 +0200 |
|
|
- At least sometimes, .sp is ignored right after .SH; see named.conf(5). |
- At least sometimes, .sp is ignored right after .SH; see named.conf(5). |
|
|
- trailing whitespace must be ignored even when followed by a font escape, |
- trailing whitespace must be ignored even when followed by a font escape, |
Line 309 Several areas can be cleaned up to make mandoc even fa |
|
Line 338 Several areas can be cleaned up to make mandoc even fa |
|
|
|
- Find better ways to prevent endless loops |
- Find better ways to prevent endless loops |
in roff(7) macro and string expansion. |
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. |
|
Triggered by Tim van der Molen Tue, 22 Feb 2011 20:30:45 +0100 |