"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "TODO" between
mdocml-1.14.1rc1.tar.gz and mdocml-1.14.1rc2.tar.gz

About: mdocml is a suite of tools compiling "-mdoc", the roff macro package of choice for BSD manual pages, and "-man", the predominant historical package for UNIX manuals. Hint: The installed binary name is "mandoc". Release candidate.

TODO  (mdocml-1.14.1rc1):TODO  (mdocml-1.14.1rc2)
************************************************************************ ************************************************************************
* Official mandoc TODO. * Official mandoc TODO.
* $Id: TODO,v 1.233 2017/02/08 12:20:16 schwarze Exp $ * $Id: TODO,v 1.234 2017/02/18 11:53:33 schwarze Exp $
************************************************************************ ************************************************************************
Many issues are annotated for difficulty as follows: Many issues are annotated for difficulty as follows:
- loc = locality of the issue - loc = locality of the issue
* single file issue, affects file only, or very few * single file issue, affects file only, or very few
** single module issue, affects several files of one module ** single module issue, affects several files of one module
*** cross-module issue, significantly impacts multiple modules *** cross-module issue, significantly impacts multiple modules
and may require substantial changes to internal interfaces and may require substantial changes to internal interfaces
- exist = difficulty of the existing code in this area - exist = difficulty of the existing code in this area
skipping to change at line 388 skipping to change at line 388
from kristaps@ Tue, 08 Jun 2010 11:13:32 +0200 from kristaps@ Tue, 08 Jun 2010 11:13:32 +0200
- in enclosures, mandoc sometimes fancies a bogus end of sentence - in enclosures, mandoc sometimes fancies a bogus end of sentence
reminded by jmc@ Thu, 23 Sep 2010 18:13:39 +0059 reminded by jmc@ Thu, 23 Sep 2010 18:13:39 +0059
loc * exist ** algo *** size * imp *** loc * exist ** algo *** size * imp ***
- a line starting with "\fB something" counts as starting with whitespace - a line starting with "\fB something" counts as starting with whitespace
and triggers a line break; found in audio/normalize-mp3(1) and triggers a line break; found in audio/normalize-mp3(1)
loc ** exist * algo ** size * imp ** loc ** exist * algo ** size * imp **
- rendering of double quotes in -Tascii is ugly in both groff and mandoc
to improve, both would have to be changed
Carsten Kunze Fri, 12 Dec 2014 14:27:56 +0100
- formatting /usr/local/man/man1/latex2man.1 with groff and mandoc - formatting /usr/local/man/man1/latex2man.1 with groff and mandoc
reveals lots of bugs both in groff and mandoc... reveals lots of bugs both in groff and mandoc...
reported by bentley@ Wed, 22 May 2013 23:49:30 -0600 reported by bentley@ Wed, 22 May 2013 23:49:30 -0600
--- PostScript and PDF issues ------------------------------------------ --- PostScript and PDF issues ------------------------------------------
- PDF output doesn't use a monospaced font for .Bd -literal - PDF output doesn't use a monospaced font for .Bd -literal
Example: "mandoc -Tpdf afterboot.8 > output.pdf && pdfviewer output.pdf". Example: "mandoc -Tpdf afterboot.8 > output.pdf && pdfviewer output.pdf".
Search the text "Routing tables". Search the text "Routing tables".
Also check what PostScript mode does when fixing this. Also check what PostScript mode does when fixing this.
skipping to change at line 493 skipping to change at line 489
loc * exist *** algo ** size * imp ** loc * exist *** algo ** size * imp **
- When the -width string contains macros, the macros must be rendered - When the -width string contains macros, the macros must be rendered
before measuring the width, for example before measuring the width, for example
.Bl -tag -width ".Dv message" .Bl -tag -width ".Dv message"
in magic(5), located in src/usr.bin/file, is the same in magic(5), located in src/usr.bin/file, is the same
as -width 7n, not -width 11n. as -width 7n, not -width 11n.
The same applies to .Bl -column column widths; The same applies to .Bl -column column widths;
reported again by Nicolas Joly Thu, 1 Mar 2012 13:41:26 +0100 via wiz@ 5 Mar reported again by Nicolas Joly Thu, 1 Mar 2012 13:41:26 +0100 via wiz@ 5 Mar
reported again by Franco Fichtner Fri, 27 Sep 2013 21:02:28 +0200 reported again by Franco Fichtner Fri, 27 Sep 2013 21:02:28 +0200
reported again by Bruce Evans Fri, 17 Feb 2017 21:22:44 +0100 via bapt@
loc *** exist *** algo *** size ** imp *** loc *** exist *** algo *** size ** imp ***
An easy partial fix would be to just skip the first word if it starts An easy partial fix would be to just skip the first word if it starts
with a dot, including any following white space, when measuring. with a dot, including any following white space, when measuring.
loc * exist * algo * size * imp *** loc * exist * algo * size * imp ***
- The \& zero-width character counts as output. - The \& zero-width character counts as output.
That is, when it is alone on a line between two .Pp, That is, when it is alone on a line between two .Pp,
we want three blank lines, not two as in mandoc. we want three blank lines, not two as in mandoc.
loc ** exist ** algo ** size * imp ** loc ** exist ** algo ** size * imp **
 End of changes. 3 change blocks. 
5 lines changed or deleted 2 lines changed or added

Home  |  About  |  All  |  Newest  |  Fossies Dox  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTPS