Re: documentation dir

[Dimitrie O. Paun]

On September 19, 2002 01:28 pm, Eric Pouech wrote:
> we mostly agree:

Yeap.
> - my point was to remove (mainly) the README and stuff like that from
>
> the module dir

I don't have a problem with that, but if it's general info for developers
working on that DLL, where do you put it?
> - I know quite a few places where the README (in the module) is pure
>
> end-user doc (winedbg, winedump to name a few).

True. I think those need to become man pages.
> - therefore, most of the DLL status (in terms of what's missing...)
>
> can well be IN the code (commctrl did it to some extent IIRC)

Indeed. As I said, commctrl is great in that regard.
> - perhaps, what we could add is a structured way to describe this
>
> "in code" documentation (so we can extract it later on if needed)

Yes, but it's getting complicated. I was just looking to clean up
things a bit :)
> - finally, what's also missing is automatic generation of online docs
>
> (for example, when a new Wine release comes out)

I've been toying with that idea for years...