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
