Re: [PATCH v4 00/11] Transform documentation into POD

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

 



Akira Yokosawa <akiyks@xxxxxxxxx> writes:

> Apparently, users of ./scripts/kernel-doc are who run "make htmldocs" or
> "make pdfdocs", a relatively small portion of Linux kernel development
> community, I guess.  Note that they don't have direct interactions with
> ./scripts/kernel-doc in most (>95% ??) cases.
>
> Normal Linux end-users don't bother with kernel-doc, I guess.

In my experience, directly running kernel-doc is usually part of the
process of trying to figure out why kerneldoc comments aren't rendering
as expected; otherwise it's completely hidden.  I do think that these
changes can be helpful in that use case, and they bring the script a bit
closer to contemporary Perl standards.  Overall, I think it's a
worthwhile change.

Thanks,

jon



[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