From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jonathan Nieder Subject: Re: user-manual.html invalid HTML Date: Fri, 20 Aug 2010 00:04:02 -0500 Message-ID: <20100820050401.GC25013@burratino> References: <20081212023003.GD23128@sigill.intra.peff.net> <87hc5ahzy8.fsf@jidanni.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: QUOTED-PRINTABLE Cc: peff@peff.net, git@vger.kernel.org To: jidanni@jidanni.org X-From: git-owner@vger.kernel.org Fri Aug 20 07:06:05 2010 Return-path: Envelope-to: gcvg-git-2@lo.gmane.org Received: from vger.kernel.org ([209.132.180.67]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OmJno-0004L2-Rp for gcvg-git-2@lo.gmane.org; Fri, 20 Aug 2010 07:06:05 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751227Ab0HTFFr convert rfc822-to-quoted-printable (ORCPT ); Fri, 20 Aug 2010 01:05:47 -0400 Received: from mail-yx0-f174.google.com ([209.85.213.174]:49547 "EHLO mail-yx0-f174.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751207Ab0HTFFp convert rfc822-to-8bit (ORCPT ); Fri, 20 Aug 2010 01:05:45 -0400 Received: by yxg6 with SMTP id 6so1070182yxg.19 for ; Thu, 19 Aug 2010 22:05:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:date:from:to:cc:subject :message-id:references:mime-version:content-type:content-disposition :content-transfer-encoding:in-reply-to:user-agent; bh=guiw/jeQldVhWjqp+GhFsI4jhX3f9tziLLwlI3lXREM=; b=Fu/cHAe9rMbun2eF5AV2sSBM9B2ry58+/5kmrIKAZRX23pbmjXpsfL8QNtyvJpwmnX R8vaO7aEGYLFne4iRpEC54l+1IV7hAN2WknuFAaU4wj4FgnZA1GTsA+w5gECkPtmayHz DhjmCQlRY93aY40pVlXo1a2TwX6CXa1+QOmdE= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=date:from:to:cc:subject:message-id:references:mime-version :content-type:content-disposition:content-transfer-encoding :in-reply-to:user-agent; b=glcwxo+/HtzePUatDWoPqy96gHQnaFmKDIrCbVyibPybOxXfnOnd55chsTdWcJXo6N EF9VB4xEv1RBUDtB+JeEIRhCJ9rPh5KPHz8hALPLE9ImoKyIofBRUauK68ycqcKAPI0f 0yZjBA9YYteo+ehs9lg/b9Kk0IYRWkeMCd28s= Received: by 10.150.157.7 with SMTP id f7mr383618ybe.153.1282280744622; Thu, 19 Aug 2010 22:05:44 -0700 (PDT) Received: from burratino (dhcp-11-17.cs.uchicago.edu [128.135.11.176]) by mx.google.com with ESMTPS id 36sm410794ybr.20.2010.08.19.22.05.43 (version=SSLv3 cipher=RC4-MD5); Thu, 19 Aug 2010 22:05:43 -0700 (PDT) Content-Disposition: inline In-Reply-To: <87hc5ahzy8.fsf@jidanni.org> User-Agent: Mutt/1.5.20 (2009-06-14) Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: Hi, Sorry for the long silence. Jeff King wrote: > On Fri, Dec 12, 2008 at 04:32:15AM +0800, jidanni@jidanni.org wrote: [user-manual.html lacks a !DOCTYPE declaration] >=20 > The versions I build locally have: >=20 > "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> >=20 > in each HTML file, which is added by asciidoc. Maybe the package you > are looking at was built with an older version of asciidoc that doesn= 't > do this (I don't actually know the history of this feature, but it se= ems > to me that this is something asciidoc should be doing, not git). It looks like the HTML for user-manual.html (unlike the reference manual and other articles) is not generated by asciidoc after all; instead, the rule in Documentation/Makefile uses xsltproc directly to convert the asciidoc-generated XML to HTML. Apparently the caller is supposed to set the chunker.output.doctype-public parameter. http://www.sagehill.net/docbookxsl/Chunking.html#OutputDoctype Maybe something as simple as this would work. -- 8< -- Subject: Documentation: set a !DOCTYPE for user manual asciidoc already takes care of including a doctype for most of the HTML documentation, but the user manual which is processed with docbook-xsl directly lacks one (at least with Debian docbook-xsl 1.75.2+dfsg-5). This makes it harder to automatically validate the HTML. Reported-by: =E7=A9=8D=E4=B8=B9=E5=B0=BC Signed-off-by: Jonathan Nieder --- diff --git a/Documentation/docbook.xsl b/Documentation/docbook.xsl index 9a6912c..da8b05b 100644 --- a/Documentation/docbook.xsl +++ b/Documentation/docbook.xsl @@ -1,5 +1,8 @@ - + --=20