[PATCH 0/5] Some kernel-doc-related cleanups

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi,

The main bit of this is readability cleanups in output_function_rst();
this should make it a lot easier to understand how the function
signature interacts with other elements in various cases
(macro/function/typedef/pre-3.x vs. 3.x sphinx) and formatting.

This whole series is functionally a no-op; scripts/kernel-doc output
should be byte-for-byte identical. I've verified this to the best of
my abilities with both pre-3.x and 3.x formats.

As a bonus, scripts/kernel-doc actually shrinks by 2 lines overall
(admittedly not much, but hey! Not bad for a readability cleanup).

This applies on top of the scripts/kernel-doc reindent patch.


Vegard


Vegard Nossum (5):
  scripts/kernel-doc: add modeline for vim users
  scripts/kernel-doc: simplify function printing
  scripts/kernel-doc: separate out function signature
  scripts/kernel-doc: simplify signature printing
  doc: kerneldoc.py: fix indentation

 Documentation/sphinx/kerneldoc.py |  6 +--
 scripts/kernel-doc                | 80 +++++++++++++++----------------
 2 files changed, 42 insertions(+), 44 deletions(-)

-- 
2.34.1





[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux