From owner-freebsd-doc@FreeBSD.ORG Wed Sep 3 16:00:40 2003 Return-Path: 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 1E81416A4BF for ; Wed, 3 Sep 2003 16:00:40 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0D81143F75 for ; Wed, 3 Sep 2003 16:00:39 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 4043010BF8C; Thu, 4 Sep 2003 01:00:37 +0200 (CEST) Date: Thu, 4 Sep 2003 01:00:37 +0200 From: "Simon L. Nielsen" To: freebsd-doc@freebsd.org Message-ID: <20030903230035.GB386@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="ctP54qlpMx3WjD+/" Content-Disposition: inline User-Agent: Mutt/1.5.4i Subject: Tidy options X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 03 Sep 2003 23:00:40 -0000 --ctP54qlpMx3WjD+/ Content-Type: multipart/mixed; boundary="kORqDWCi7qDJ0mEj" Content-Disposition: inline --kORqDWCi7qDJ0mEj Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hello In the DocBook documentation with HTML output when using a package reference preceded by a character (with no space in between) there are often inserted spaces which looks odd. E.g from http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/video-playback.ht= ml ... codec with MPEG3 audio encoding ( audio/lame is required): The HTML that gives this problem is: the MPEG4 codec with MPEG3 audio encoding ( audio/lame is The problem is that Tidy is a bit too agressive when trying to make the HTML look nice, so it inserts newline where it really shouldn't, since it tries to keep the lines at max 68 characters (the Tidy default default). To fix this I propose to remove the -i flag (which indents the HTML) =66rom the default Tidy arguments and add '-wrap 90'. This makes the HTML more "ugly", but I don't really think this matters, since it's still correct and of course the browsers doesn't care. If anybody for some reason still like to generate more readable HTML, they can just use the TIDYFLAG make variable to override the defaults. I should also mention that these options make book.html (the complete handbook in one HTML file) go from 3 986 799 to 3 002 354 bytes. Any objection to changing this? --=20 Simon L. Nielsen FreeBSD Documentation Team --kORqDWCi7qDJ0mEj Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="docmake-tidy.patch" ==== //depot/user/simon/doc/share/mk/doc.docbook.mk#2 - /home/simon/freebsd/p4/simon/doc/share/mk/doc.docbook.mk ==== @@ -226,7 +226,7 @@ PDFTEX?= ${PREFIX}/bin/pdftex GROFF?= groff TIDY?= ${PREFIX}/bin/tidy -TIDYOPTS?= -i -m -raw -preserve -f /dev/null -asxml ${TIDYFLAGS} +TIDYOPTS?= -wrap 90 -m -raw -preserve -f /dev/null -asxml ${TIDYFLAGS} HTML2TXT?= ${PREFIX}/bin/links HTML2TXTOPTS?= -dump ${HTML2TXTFLAGS} HTML2PDB?= ${PREFIX}/bin/iSiloBSD --kORqDWCi7qDJ0mEj-- --ctP54qlpMx3WjD+/ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (FreeBSD) iD8DBQE/VnKTh9pcDSc1mlERAm8CAKCf9+8sSqaa8LerN5xZGF5SZyPavQCfY1XB 96hXU4PU9+6rsZvFP+O6/2s= =5rHc -----END PGP SIGNATURE----- --ctP54qlpMx3WjD+/--