Duncan Gibson wrote:
> STR #2149: Add a Makefile example for multi-module build using fltk-config
> involved adding a small amount of text to basics.dox and committing it.
> However fltk.pdf, also under subversion, was regenerated in the process,
> but I did not commit this as I think that adding 5Mb for small changes is
> a bit excessive. I assume that this will only be commited before releases.
> 
> Was this discussed before? If so, what was the outcome?

AFAICT there was no real discussion/decision about this.

The current habit was to generate the docs (pdf + html) from time to time
and commit the pdf to svn after greater changes only. I think that we
should keep that, because someone complained that the big fltk.pdf file
would be updated everytime when he rolled his svn working copy back and
forward for test reasons.

But there is more to do: The pdf _and_ html versions should also be
committed to the web site from time to time.

IIRC, the only one who did this until now was Fabien, who has the most
recent doxygen and LaTeX versions installed. My versions are older, and
I can't create the pdf file correctly (and there are also some diffs in
the html docs). But if you have working new versions ...

BTW.: I'm not keen on having the pdf file in the source distribution at
all, but we discussed this already, and until we have a better solution,
this is okay for me. For the release version I can imagine that we
would better have a separate fltk-docs package (with pdf and html docs).
Just my 2 ct.

Albrecht
_______________________________________________
fltk-dev mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-dev

Reply via email to