--- Hal Burgiss <hal@...> wrote:
> Mark, a quick run down ...
> The source for all the docs is stored docbook sgml
> text, in current/doc/source/*sgml.
> When doc building time comes, the pdfs, htmls, and
> txts, all are generated from the same sources.
thanks, hal. that is pretty slick.
> We tend not to re-build docs between releases that
> often, but there are always exceptions. The User
> Manaul particularly is tied to a specific release
> is distributed with core project files, so its bit
> to re-release that. But we can update the project
> home page, and of course keep cvs updated. FAQ
> is not tied to any release, so its cleaner to keep
> that updated.
i was watching cvs fairly closely during the 3.0.7 and
3.0.8 releases and noticed how much activity was being
done with the documentation, so it does appear
in any event, i do not think that these doc changes
warrant any immediate release. it is just good to
have them in place for the next release.
> There has been recent discussion about a major
> revamp of the documentation since docbook
> can be very obtuse and has made more than
> enemy. Fabian has made it clear he wants to
> move a way from it.
sounds good to me. what are the other options?
> Anyway, for 3.0.8 and for the time being its the
> docbook sgml sources.
fair enough.. i can work with that.
> If its a simple change, and you'd rather focus
> elsewhere, I can take care of it. I do much of
> the doc building stuff anyway.
thank, hal. that is good to know.
i just finished the patches, though. ;-)
i have attached them to this email.
Be a better friend, newshound, and
know-it-all with Yahoo! Mobile. Try it now. http://mobile.yahoo.com/;_ylt=Ahu06i62sR8HDtDypao8Wcj9tAcJ