Re: [PATCH] docbook: Added support for generating man files

Andries Brouwer
2003-07-18T22:36:27Z

On Sat, Jul 19, 2003 at 08:36:27AM +1000, Michael Still wrote:

> > IS there any chance it could incorporate the GPL by a slightly smaller
> > reference or even a link for the HTML one, it looks great except that
> > 90% of the manual page is a GPL each time 8)

> Well, the only part which comes from this patch is:
> ... Michael Still (mikal\@stillhq.com) ...
> ... This documentation was generated with kernel version $ARGV[2]. ...
> I can shorten this if people would like.

Commenting on the man page (nroff) version:

Please put the mikal\@stillhq.com in a comment.
Please leave the kernel version.

> The GPL bit people have commented on is actually extracted from the front
> matter of the SGML file being converted inside
> <legalnotice></legalnotice>. Therefore, if the SGML kerneldoc output we
> already have includes the GPL, then so does the man page. I have not
> imposed new license conditions on the documentation.
>
> If people are comfortable with dropping the legal notice, or perhaps
> inserting a line saying "refer to file X for the license on this
> documentation", then I'll do that and send a new patch.

Please put all legalities in comments - behind .\" we do not have to read
them, but they are there if anyone cares.

Andries