Improved documentation/README, removed old and obsolete text, and

tried to clarify documentation generation.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7954 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
This commit is contained in:
Albrecht Schlosser
2010-12-05 15:49:48 +00:00
parent 3226204369
commit 0e49ecd3d3
+19 -16
View File
@@ -2,27 +2,30 @@ README
------ ------
The documentation in this directory is in PDF format. The documentation in this directory is in PDF format.
To read it, please open the fltk.pdf file in this directory To read it, please open the file "fltk.pdf" in this directory.
To generate the doxygen HTML documention, To generate the doxygen HTML documention, you should have Doxygen
you should have Doxygen version 1.5.5 min. version 1.5.7 or later. Use "make clean html" in the documentation
directory to generate the HTML documentation.
To read it, please open the "html/index.html" file. To read it, please open the file "html/index.html" with your browser.
A documentation version is also accessable at the FLTK web site, A documentation version is also available at the FLTK web site,
along with PostScript(tm) and PDF versions of the manual. along with the PDF version of the manual. The docs on the web site
are usually somewhat older (latest release).
You can generate your own (printable) copy of the manual by typing You can generate your own copy of the PDF manual by typing "make pdf"
"make pdf" in this directory. in this directory. The resulting file is "latex/refman.pdf". This is
so that "make pdf" does not overwrite the bundled file "fltk.pdf".
For future book gen alternative (TODO or CHECK): If you type "make pdf-dist" instead, the original file "fltk.pdf"
You will need to have the HTMLDOC software will be overwritten.
installed on your system. HTMLDOC can be downloaded from:
http://www.easysw.com/htmldoc
The default media size is 8.27x11.0" (210x279mm), which is the lesser Note that it is usually not necessary to create your own PDF version,
of A4 and US Letter sizes. You can change this in the makefile by if you use the release version of FLTK, because it comes with a current
uncommenting the corresponding media size or defining your own. "fltk.pdf" file. However, if you use subversion or a snapshot file,
then the included "fltk.pdf" file is likely to be outdated.
If you find any typos, things that are unclear, or would like to If you find any typos, things that are unclear, or would like to
contribute an example, section, or chapter to the FLTK manual, please contribute an example, section, or chapter to the FLTK manual, please
contact Michael Sweet (mike@easysw.com). post a question in the fltk newsgroup fltk.general or post a bug
report or feature request at http://www.fltk.org/str.php .