From owner-freebsd-doc@FreeBSD.ORG  Wed Dec 29 20:50:35 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 97DDF16A5E5
	for <freebsd-doc@freebsd.org>; Wed, 29 Dec 2004 20:50:35 +0000 (GMT)
Received: from kane.otenet.gr (kane.otenet.gr [195.170.0.27])
	by mx1.FreeBSD.org (Postfix) with ESMTP id CDEE743D58
	for <freebsd-doc@freebsd.org>; Wed, 29 Dec 2004 20:50:34 +0000 (GMT)
	(envelope-from keramida@freebsd.org)
Received: from gothmog.gr (patr530-a191.otenet.gr [212.205.215.191])
	iBTKoWhX002783
	for <freebsd-doc@freebsd.org>; Wed, 29 Dec 2004 22:50:32 +0200
Received: from gothmog.gr (gothmog [127.0.0.1])
	by gothmog.gr (8.13.1/8.13.1) with ESMTP id iBTKoWMt038638
	for <freebsd-doc@freebsd.org>; Wed, 29 Dec 2004 22:50:32 +0200 (EET)
	(envelope-from keramida@freebsd.org)
Received: (from giorgos@localhost)
	by gothmog.gr (8.13.1/8.13.1/Submit) id iBTKoVQc038637
	for freebsd-doc@freebsd.org; Wed, 29 Dec 2004 22:50:32 +0200 (EET)
	(envelope-from keramida@freebsd.org)
Date: Wed, 29 Dec 2004 22:50:31 +0200
From: Giorgos Keramidas <keramida@freebsd.org>
To: freebsd-doc@freebsd.org
Message-ID: <20041229205031.GC38432@gothmog.gr>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Subject: [RFC] Smaller line length for FORMAT="txt"
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 29 Dec 2004 20:50:35 -0000

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