From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jonathan Nieder Subject: Re: [PATCH] Documentation/Notes: Remove 'footnote:' warning Date: Mon, 18 Jul 2011 02:13:08 -0500 Message-ID: <20110718071308.GA4745@elie.gateway.2wire.net> References: <1310855420-21183-1-git-send-email-pavan.sss1991@gmail.com> <1310908271.21563.17.camel@drew-northup.unet.maine.edu> <20110717215858.GA9906@elie> <20110718055108.GA4254@elie.gateway.2wire.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: Drew Northup , git@vger.kernel.org To: Pavan Kumar Sunkara X-From: git-owner@vger.kernel.org Mon Jul 18 09:13:28 2011 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 1Qii16-00086D-PP for gcvg-git-2@lo.gmane.org; Mon, 18 Jul 2011 09:13:25 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751933Ab1GRHNS (ORCPT ); Mon, 18 Jul 2011 03:13:18 -0400 Received: from mail-iw0-f174.google.com ([209.85.214.174]:50912 "EHLO mail-iw0-f174.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751577Ab1GRHNR (ORCPT ); Mon, 18 Jul 2011 03:13:17 -0400 Received: by iwn6 with SMTP id 6so2843380iwn.19 for ; Mon, 18 Jul 2011 00:13:16 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=date:from:to:cc:subject:message-id:references:mime-version :content-type:content-disposition:in-reply-to:user-agent; bh=Wmw/lSxL8jV/R/gtas6Xl9sC1rCgwrlDFXRFtWQxtog=; b=JSgkEbH0pI7xP7feZ34UOrC0YPzIRCZ1n5m1HCMsYODrSyapmQLfnzXrmgo+vG8a0R urfjK10eqBltB8x7HLyIlMWkTIXjk0NtZa+vY7s5j636CeaY/9gK7nC/uBdGwq/OEnS/ e7Az4HsoBQ+wbFMRAC5UER6E4wuBa5MpVlBvI= Received: by 10.42.19.69 with SMTP id a5mr7120363icb.184.1310973195264; Mon, 18 Jul 2011 00:13:15 -0700 (PDT) Received: from elie.gateway.2wire.net (adsl-69-209-74-225.dsl.chcgil.ameritech.net [69.209.74.225]) by mx.google.com with ESMTPS id o1sm4621854ict.20.2011.07.18.00.13.13 (version=SSLv3 cipher=OTHER); Mon, 18 Jul 2011 00:13:14 -0700 (PDT) Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21+46 (b01d63af6fea) (2011-07-01) Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: Pavan Kumar Sunkara wrote: > Currently the documentation at > http://www.kernel.org/pub/software/scm/git/docs/git-notes.html is > showing the footnote wrongly. This workaround will solve that. (For reference, the linked-to page was generated with asciidoc 8.4.5 and renders the footnote as
[Permitted pathnames have the [...] rest of the object ID.]
. inline instead of a nicely labelled link like "[1]" that one might expect.) Weird. That's not the Docbook XSL bug I pointed to --- the HTML documentation is generated by asciidoc directly, without any help from Docbook XSL. And I can't reproduce it locally, either. *digs around in asciidoc changelog* Ah, Asciidoc 8.5.1 introduced styling of footnotes: * Styled HTML footnotes. * Added links to HTML footnote refs. Until the kernel.org toolchain gains that feature, wouldn't a simpler workaround be to put the footnote after the period, so it renders there as a simple line in brackets? Barring that, it should be possible to put this information in the discussion section without disrupting the flow of the text so much, for example by putting it in parentheses or making it the last paragraph of the discussion section. A patch with such a change and mentioning in the commit message the two bugs you're working around would seem sane to me. Thanks, Jonathan