Re: [patch] kernel API documentation system

Ed Grimm (tgape@bigfoot.com)
Sun, 26 Sep 1999 13:28:58 -0500 (CDT)


On 26 Sep 1999, Jes Sorensen wrote:

> >>>>> "Jeff" == Jeff Garzik <jgarzik@pobox.com> writes:
>
> Jeff> The current "make apidocs" command creates
> Jeff> Documentation/kernel-api.html, containing all documentation.
> Jeff> Eventually this system should generate individual man pages, one
> Jeff> per kernel API function, in addition to the existing
> Jeff> kernel-api.html file.
>
> Putting auto generated documents in the same directory as the static
> ones is a bad idea imho. It makes it hard for people to keep track of
> what can be deleted and what cannot.

Wouldn't the fact that 'make clean' removes it be good enough? How
about adding a Documentation/Makefile, which also has a make clean to
get rid of them?

That is, use the same mechanism that many packages that use yacc or
other C code generators use to specify which files can and cannot be
removed.

Ed Grimm

-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.rutgers.edu
Please read the FAQ at http://www.tux.org/lkml/