From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from krisdoz.my.domain (schwarze@localhost [127.0.0.1]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id o7FGca8v009933 for ; Sun, 15 Aug 2010 12:38:36 -0400 (EDT) Received: (from schwarze@localhost) by krisdoz.my.domain (8.14.3/8.14.3/Submit) id o7FGcZfB029327; Sun, 15 Aug 2010 12:38:35 -0400 (EDT) Date: Sun, 15 Aug 2010 12:38:35 -0400 (EDT) Message-Id: <201008151638.o7FGcZfB029327@krisdoz.my.domain> X-Mailinglist: mdocml-source Reply-To: source@mdocml.bsd.lv MIME-Version: 1.0 From: schwarze@mdocml.bsd.lv To: source@mdocml.bsd.lv Subject: mdocml: OpenBSD src/bin was used as a tool to hunt bugs in mandoc. X-Mailer: activitymail 1.26, http://search.cpan.org/dist/activitymail/ Content-Type: text/plain; charset=utf-8 Log Message: ----------- OpenBSD src/bin was used as a tool to hunt bugs in mandoc. Modified Files: -------------- mdocml: TODO Revision Data ------------- Index: TODO =================================================================== RCS file: /usr/vhosts/mdocml.bsd.lv/cvs/mdocml/TODO,v retrieving revision 1.37 retrieving revision 1.38 diff -LTODO -LTODO -u -p -r1.37 -r1.38 --- TODO +++ TODO @@ -84,7 +84,40 @@ * formatting issues: gratuitious differences ************************************************************************ -- none reported right now (yet schwarze@ knows of some) +- .%T should be quoted, not underlined, when .%J is also present, + to better distinguish the contents of .%T and .%J, + see for example OpenBSD cat(1) + +- .It ${name Ns [ selector ] Ns } + should be "${name[selector]}" not "${name [selector]}" + This is parsed as + text("${name") text("[") Ns() text(selector)... + Opening punctuation should not fall out of .Ns. + see for example OpenBSD csh(1) + +- .%A should append the last author with " and " (if there are two) + or ", and " (if there are more), not ", " + see for example OpenBSD csh(1) + +- In .Bl -bullet, the groff bullet is "+\b+\bo\bo", the mandoc bullet + is just "o\bo". + see for example OpenBSD ksh(1) + +- .No text No ) is "text )", not "text)" + see the terrible example + case word in [[(] pattern [| pattern] ... ) list ;; ] ... esac + in OpenBSD ksh(1) + +- .Sm should *not* produce as a blank line in .Bd -literal + see for example "Brace expansion" in OpenBSD ksh(1) + +- The characters "|" and "\*(Ba" should never be bold, + not even in the middle of a word, e.g. ".Cm b\*(Bac" in + "mknod [-m mode] name b|c major minor" + in OpenBSD ksh(1) + +- A bogus .Pp between two .It must not produce a double blank line, + see between -R and -r in OpenBSD rm(1). ************************************************************************ * performance issues @@ -106,3 +139,9 @@ Several areas can be cleaned up to make not for strings containing escape sequences. For example, this hinders calculation of the indent required for .Nm \&[ in text(1). comments from kristaps@ Wed, 21 Jul 2010 23:26:08 +0200 + +- another example of the same problem: + .Bl -tag -width "\eD{format}XX" -compact + in OpenBSD ksh(1) gives the wrong width + because "\e" is one character in groff, two in mandoc + -- To unsubscribe send an email to source+unsubscribe@mdocml.bsd.lv