[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