From owner-freebsd-doc@FreeBSD.ORG Wed Jan 25 01:24:37 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B50D7106564A; Wed, 25 Jan 2012 01:24:37 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (gatekeeper-int.allbsd.org [IPv6:2001:2f0:104:e002::2]) by mx1.freebsd.org (Postfix) with ESMTP id 358F28FC12; Wed, 25 Jan 2012 01:24:37 +0000 (UTC) Received: from alph.allbsd.org ([IPv6:2001:2f0:104:e010:862b:2bff:febc:8956]) (authenticated bits=128) by mail.allbsd.org (8.14.4/8.14.4) with ESMTP id q0P1ONFY057609; Wed, 25 Jan 2012 10:24:33 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (localhost [IPv6:::1]) (authenticated bits=0) by alph.allbsd.org (8.14.4/8.14.4) with ESMTP id q0P1OLuV001629; Wed, 25 Jan 2012 10:24:23 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Wed, 25 Jan 2012 10:24:16 +0900 (JST) Message-Id: <20120125.102416.1750641662631373497.hrs@allbsd.org> To: wblock@wonkity.com From: Hiroki Sato In-Reply-To: References: <4F1B4767.5070105@FreeBSD.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 6.4 on Emacs 23.3 / Mule 6.0 (HANACHIRUSATO) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Wed_Jan_25_10_24_16_2012_500)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: clamav-milter 0.97 at gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.3 (mail.allbsd.org [IPv6:2001:2f0:104:e001::32]); Wed, 25 Jan 2012 10:24:35 +0900 (JST) X-Spam-Status: No, score=-104.6 required=13.0 tests=BAYES_00, CONTENT_TYPE_PRESENT, RDNS_NONE, SPF_SOFTFAIL, USER_IN_WHITELIST autolearn=no version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on gatekeeper.allbsd.org Cc: freebsd-doc@FreeBSD.org, gabor@FreeBSD.org Subject: Re: Tidy and HTML tab spacing X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 25 Jan 2012 01:24:37 -0000 ----Security_Multipart(Wed_Jan_25_10_24_16_2012_500)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Warren Block wrote in : wb> On Sun, 22 Jan 2012, Gabor Kovesdan wrote: wb> wb> > On 2012.01.18. 23:49, Warren Block wrote: wb> >> 5. Don't tidy HTML files at all (suggested as an option by Benedict wb> >> Reuschling). The unprocessed HTML is ugly, but few people are going wb> >> to look at it directly. Files that haven't been through tidy are a wb> >> little larger, about 4% in the case of the Porter's Handbook. wb> > I also think tidy should be removed. As hrs wrote, new standards wb> > should be evaluated and probably they are much better. (I think they wb> > are.) If there are some nits, then we should process it with a custom wb> > script or something, instead of this crapware. wb> wb> Tidy does a lot; it would be a lot of work to recreate. wb> wb> There's a default choice I didn't mention earlier: wb> wb> 0. Leave it alone. wb> wb> (Maybe this will all change with the DocBook XML changeover. I don't wb> know when that is supposed to happen, but if it's not too long, this wb> could be the right way to go.) wb> wb> Finally, there's one last choice: wb> wb> 6. A pretty good case could be made for using instead of tabs in wb> the source blocks. The more I think about it, the wb> more technically-correct that seems. In that case, tidy should be wb> fine as it is now. Hmm, I suggest to disable tab expansion or do replacement in Tidy based on your patch for the meantime. One thing I concerned about is how outside elements like 
 works.  If it is
 harmless in major www browsers (this should be treated as a
 whitespace) and it can mitigate the issue, I think there is no
 problem with it.

 I agree with migrating our documents to newer XML standards will
 solve this in more consistent manner as Gabor said.  I said it (and
 SVN repo migration) would happen within last October but I could not
 handle that nicely.  Sorry for that, but it is now in progress.  I
 believe Tidy can be removed after that.

-- Hiroki

----Security_Multipart(Wed_Jan_25_10_24_16_2012_500)--
Content-Type: application/pgp-signature
Content-Transfer-Encoding: 7bit

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (FreeBSD)

iEYEABECAAYFAk8fWcAACgkQTyzT2CeTzy3X1wCdGTE+dJuigydNGYxhpzzBjlMX
Bu8Amwd6SOGzDwAssPiJFiiWlAqHae/g
=I4ZK
-----END PGP SIGNATURE-----

----Security_Multipart(Wed_Jan_25_10_24_16_2012_500)----