Duncan Gibson wrote:
>
>> But there is more to do: The pdf _and_ html versions should also be
>> committed to the web site from time to time.
>
> Hmm. I noticed that the current 1.3.x html links are not working a few
> days ago, but I've never investigated how to keep them up to date...
I don't know what to do with the links "with comments", but the docs
are in the subversion repository ("www"). You can check them out and
copy the generated html docs to the doc-1.3 directory [1] and check
that in. Then log in on the FLTK web site, go to "Web Site" and click
on "Update the web site from the Subversion repository". That's it.
The same can be done for the pdf file, but there is also the file
documentation.php that may need an update.
-----
[1] svn-add new files, svn-rm old files, or delete and replace the
entire directory ?
> [...] IIRC newer versions can add options to the Doxyfile that the older
> ones don't like, so we have to be careful here.
Yes, don't run doxygen -u. The current version seems to be fine for all
developers (compatible with doxygen 1.5.5).
> As I can generate both the html and latex/pdf docs it doesn't cause
> me problems, but I can understand that not everyone who wants to try
> fltk will want the hassle of installing doxygen, graphviz and latex
Yes, that's the reason why the pdf docs are in the repository.
> and a pre-generated documentation tarball might help here.
That's what I think, too. Someone who downloads the sources can either
generate the docs himself or download the docs from the FLTK web site
as well. That's currently easy with the pdf file, but not as easy for
the html docs (unless you use wget or similar). Thus, IMHO we need a
html docs download anyway.
> Maybe this ties in with what is needed for the web site and we can
> kill two birds with one stone...
Probably not for the online version, but certainly for a downloadable
(html only?) documentation tarball.
What about adding such a beast to the doc-1.3 directory and offering it
with a link from documentation.php as an alternative to the online
docs and the pdf version?
Albrecht
_______________________________________________
fltk-dev mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-dev
