Messages in this thread | | | Date | Wed, 23 Feb 2022 13:55:48 +0100 | From | Tomasz Warniełło <> | Subject | Re: [PATCH v4 00/11] Transform documentation into POD |
| |
Hi Akira,
Take a look at `man perl` and you will find a synopsis also. It's simply better in depicting grammar relations than a flat switch list. Especially when the grammar gets complex. I dislike it also. And I don't think it looks good. Rather creepy and overwhelming.
> > I don't see much point for such a non-user-facing script having nice-looking > > well-structured documentation in the first place.
You're touching the very essence of kernel-doc here. What and who is it for? Not just the script - all of it.
Regards,
Tomasz
| |