From owner-freebsd-doc@FreeBSD.ORG Thu Sep 4 07:05:42 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 D424716A4BF for ; Thu, 4 Sep 2003 07:05:42 -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 9ABED43FA3 for ; Thu, 4 Sep 2003 07:05:41 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 7A72A10BFAA; Thu, 4 Sep 2003 16:05:39 +0200 (CEST) Date: Thu, 4 Sep 2003 16:05:39 +0200 From: "Simon L. Nielsen" To: Ceri Davies Message-ID: <20030904140539.GB385@FreeBSD.org> References: <20030903230035.GB386@FreeBSD.org> <20030904123441.GD25063@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="aM3YZ0Iwxop3KEKx" Content-Disposition: inline In-Reply-To: <20030904123441.GD25063@submonkey.net> User-Agent: Mutt/1.5.4i cc: freebsd-doc@freebsd.org Subject: Re: 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: Thu, 04 Sep 2003 14:05:42 -0000 --aM3YZ0Iwxop3KEKx Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.09.04 13:34:41 +0100, Ceri Davies wrote: > On Thu, Sep 04, 2003 at 01:00:37AM +0200, Simon L. Nielsen wrote: > > 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-playbac= k.html > >=20 > > ... codec with MPEG3 audio encoding ( audio/lame is required): > >=20 > > The HTML that gives this problem is: > >=20 > > the MPEG4 codec with MPEG3 audio encoding ( > href=3D"http://www.FreeBSD.org/cgi/url.cgi?ports/audio/lame= /pkg-descr"> > > audio/lame is > >=20 > > 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). > >=20 > > To fix this I propose to remove the -i flag (which indents the HTML) > > from 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. >=20 > Doesn't this simply decrease the chance of this happening, as opposed to > actually fixing the issue? Surely the above situation can still occur on > a 90 column boundary. Yes, I should have mentioned that. The chance that it actually happen is reduced a lot. It would have to be a very long package name for the problem to occur with the proposed settings. > > Any objection to changing this? >=20 > Not really, but it doesn't sound like a real fix, unless I'm misunderstan= ding > something. It is a workaround, and of course tidy should do it right in any case, but this will got us a long way without having to modify tidy. If somebody has the time to fix Tidy it would be great, but I don't at the moment. --=20 Simon L. Nielsen FreeBSD Documentation Team --aM3YZ0Iwxop3KEKx Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (FreeBSD) iD8DBQE/V0azh9pcDSc1mlERAoOOAJ4w7DYQ1jaWM9Tpq7If2cyWrIpd8wCgsitN iREifVNbaGcPpzBx1Eq9Pbc= =1CaJ -----END PGP SIGNATURE----- --aM3YZ0Iwxop3KEKx--