>
> FYI, there are already some kernel-doc rules in
> Documentation/kernel-doc-nano-HOWTO.txt. These rules work with the
> doc. generator in the kernel tree (scripts/kernel-doc).
> Do you have suggestions for how to make them (the rules) better?
> so that the in-tree kernel doc. will improve...
These rules seem to be good. I will try to use the generator
(scripts/kernel-doc) and check the result.
But the bigger problem is that many headers are not documented at all.
And some code is documented but not complying the rules.
>
> Q2: what do I get when I download one of the tarballs from kernel-api.org?
>
Each tarball contains exactly the same as can be browsed online at
kernel-api.org. There is no difference.
> Q3: Can we see your sed scripts?
>
Yes, here it is (it's really small and mindless):
--- sed script begin ---
/^\(\s\)*#endif/ {
s/\/\*/\/\//
s/\*\///
}
/^\(\s\)*\/\*.*\*\/\(\s\)*$/ {
s/\/\*/\/\/\//
s/\*\///
}
/^.*\/\*.*\*\/\(\s\)*$/ {
s/\/\*/\/\/\/</
s/\*\///
}
s/^\(\s\)*\/\*/\/\*\*\n/
s/^.*\*\//\n\*\//
--- sed script end ---
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/
[Index of Archives]
[Kernel Newbies]
[Netfilter]
[Bugtraq]
[Photo]
[Stuff]
[Gimp]
[Yosemite News]
[MIPS Linux]
[ARM Linux]
[Linux Security]
[Linux RAID]
[Video 4 Linux]
[Linux for the blind]
[Linux Resources]
