Messages in this thread | | | Date | Mon, 8 Apr 2019 15:45:43 -0600 | From | Jonathan Corbet <> | Subject | Re: [PATCH 1/4] kernel-doc: Revert "scripts/kernel-doc: Processing -nofunc for functions only" |
| |
On Fri, 5 Apr 2019 14:44:50 -0700 Sean Christopherson <sean.j.christopherson@intel.com> wrote:
> Now that Docbook has been deprecated in favor of Sphinx, the -nofunction > option in kernel-doc is defunct, e.g. Sphinx doesn't currently support > it. Furthermore, "functions only" behavior was used by Docproc to avoid > duplicating exported symbols, which is now handled by -export and > -internal. > > The end goal is to enable using :nofunction: in .rst files to split > documentation of structures into separate categories. > > This reverts commit 23aebb3c05f3b3fb06a68bf6b1539a05a5f8aaab. > > Signed-off-by: Sean Christopherson <sean.j.christopherson@intel.com>
It seems strange to express this as a revert - it's far from a clean revert of the original patch. I think it's probably better to just merge this series into a single patch that implements the functionality you're after.
As for the single/plural question, let's go with singular to match --function.
Thanks,
jon
| |