From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1426371AbcBRNBN (ORCPT ); Thu, 18 Feb 2016 08:01:13 -0500 Received: from tex.lwn.net ([70.33.254.29]:33556 "EHLO vena.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1425384AbcBRNBL (ORCPT ); Thu, 18 Feb 2016 08:01:11 -0500 Date: Thu, 18 Feb 2016 06:01:08 -0700 From: Jonathan Corbet To: Daniel Vetter Cc: Jani Nikula , Keith Packard , LKML , linux-doc@vger.kernel.org Subject: Re: Kernel docs: muddying the waters a bit Message-ID: <20160218060108.2107ffe9@lwn.net> In-Reply-To: References: <20160213145317.247c63c7@lwn.net> <86fuwwcdmd.fsf@hiro.keithp.com> <20160217151401.3cb82f65@lwn.net> <874md6fkna.fsf@intel.com> Organization: LWN.net X-Mailer: Claws Mail 3.12.0 (GTK+ 2.24.28; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Thu, 18 Feb 2016 10:24:04 +0100 Daniel Vetter wrote: > > Worth noting is that, AFAICT, in all of the proposals, including the > > original where kernel-doc produces docbook, this autoreferencing only > > works within parts processed by kernel-doc. Not in the template > > documents themselves. (You can still use the markup's more verbose cross > > referencing keywords.) > > It works everywhere, even in the docbook template, as long as you mark > it up correctly. Which in docbook means func. In Sphinx that's :func:`function_name`. Not a thing of beauty, but it works. jon