[RFC] Smaller line length for FORMAT="txt"

Giorgos Keramidas keramida at freebsd.org
Wed Dec 29 20:50:35 UTC 2004


Any objections to the following minor change to the doc makefiles?

% Index: doc.docbook.mk
% ===================================================================
% RCS file: /home/ncvs/doc/share/mk/doc.docbook.mk,v
% retrieving revision 1.117
% diff -u -r1.117 doc.docbook.mk
% --- doc.docbook.mk      2 Sep 2004 17:12:14 -0000       1.117
% +++ doc.docbook.mk      29 Dec 2004 09:31:22 -0000
% @@ -260,7 +260,7 @@
%  GROFF?=                groff
%  TIDYOPTS?=     -wrap 90 -m -raw -preserve -f /dev/null -asxml ${TIDYFLAGS}
%  HTML2TXT?=     ${PREFIX}/bin/links
% -HTML2TXTOPTS?= -dump ${HTML2TXTFLAGS}
% +HTML2TXTOPTS?= -dump -width 72 ${HTML2TXTFLAGS}
%  HTML2PDB?=     ${PREFIX}/bin/iSiloBSD
%  HTML2PDBOPTS?= -y -d0 -Idef ${HTML2PDBFLAGS}
%  DVIPS?=                ${PREFIX}/bin/dvips
% Index: doc.project.mk
% ===================================================================
% RCS file: /home/ncvs/doc/share/mk/doc.project.mk,v
% retrieving revision 1.23
% diff -u -r1.23 doc.project.mk
% --- doc.project.mk      7 Sep 2004 11:56:03 -0000       1.23
% +++ doc.project.mk      29 Dec 2004 09:31:34 -0000
% @@ -79,7 +79,7 @@
%  RM?=           /bin/rm
%  MV?=           /bin/mv
%  HTML2TXT?=     ${PREFIX}/bin/links
% -HTML2TXTOPTS?= -dump ${HTML2TXTFLAGS}
% +HTML2TXTOPTS?= -dump -width 72 ${HTML2TXTFLAGS}
%  ISPELL?=       ispell
%  ISPELLOPTS?=   -l -p /usr/share/dict/freebsd ${ISPELLFLAGS}
%  .if exists(/usr/bin/perl)

Committing this will resolve the problems described in a _very_ old
freebsd-doc PR, which I was discussing with the original submitter
last night.

The problem described in the PR is caused by the ``large'' line-width of
the ASCII text format.  Currently, this is set to 78 characters, but in
sysinstall's dialogs we have at least 2 characters less in each line
because of the dialog decorations.

I completed a full doc/ build today with this patch.  I don't think it
breaks anything very important, so I would be glad if this was committed
some day.

- Giorgos



More information about the freebsd-doc mailing list