Commit Graph

93 Commits

Author SHA1 Message Date
Albrecht Schlosser
2098d8bfd8 Generate Doxyfile and Doxybook from common source file Doxyfile.in.
Now we have less files to edit, and Doxyfile.in is shared with the
CMake generation of Doxyfile and Doxybook.

Besides that two files with FLTK version numbers are now removed (less
work for future version updates).


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10762 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2015-06-16 13:18:28 +00:00
Albrecht Schlosser
b02747d157 Simplify documentation generation, remove obsolete file.
Doxybook and Doxyfile have been compared and differences have
been adjusted so there are only _relevant_ differences now.

The dependency on fltk-book.tex in html generation has been removed.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10718 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2015-04-25 17:23:21 +00:00
Albrecht Schlosser
0663c45e9c Documentation: move PDF creation from Makefile to new script 'make_pdf'.
The new script make_pdf can be used in the Makefile and in the CMake
PDF generation process. CMake update will follow in a later step.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10702 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2015-04-13 20:33:46 +00:00
Albrecht Schlosser
a1c0b1b08c Add html doc dependency on (unused) src/fltk-book.tex for doxygen.
This is not intended and could also be removed from Doxyfile, but
currently this is the best way - more changes to come...


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10361 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2014-10-05 22:39:31 +00:00
Albrecht Schlosser
7aa27859a5 Improve documentation generation (pdf only).
Add file VERSION that includes the FLTK version number (only), generate
fltk.pdf with automatic copyright year and doxygen version.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10352 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2014-10-04 23:42:17 +00:00
Greg Ercolano
6d4c2a2e22 Introducing a FAQ to the FLTK docs.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@9146 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-10-25 02:17:29 +00:00
Greg Ercolano
4f4a8fc3c7 Modifications to all LGPL headers for STR #2685.
(to clarify static exception LGPL by changing license references)



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8864 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-07-19 04:49:30 +00:00
Albrecht Schlosser
128636292a Added refman.pdf to clean target in documentation/Makefile.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8195 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-01-05 23:00:33 +00:00
Albrecht Schlosser
3d470e8c0d Modified documentation/Makefile to correctly generate docs.
Generating HTML and PDF docs is now independent, order doesn't matter.

New and modified make targets:

 - html: generate HTML docs only
 - pdf:  generate PDF docs only
 - dist: generate HTML and PDF docs (use for distribution files)
 - html-online: HTML docs with "stripping" modification dates
 - alldocs: retained as synonym for 'dist'

To do: README file must be updated...


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8191 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-01-05 12:55:10 +00:00
Albrecht Schlosser
09d7842f86 Documentation: fixed copying of tiny.png to documentation directory.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8158 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2011-01-01 14:12:10 +00:00
yuri
181492b446 fix install without building fltk.pdf
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8145 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2010-12-30 21:08:01 +00:00
Greg Ercolano
3a9d8a11f9 Removing unused doc dependencies on images.
Mods as per conversation on fltk.development today, 
    subject: "Re: Remove image dependencies ?  [was: Re: [Library] r8091 - in branches/branch-1.3:FLdocumentation/src]"




git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8116 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2010-12-27 00:20:28 +00:00
Greg Ercolano
5a2b5dcf1b New image added to documentation dependencies.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8095 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2010-12-21 17:07:14 +00:00
Greg Ercolano
ea3cb98f4f IMAGEFILES macro: gif -> png
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7986 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2010-12-09 01:03:59 +00:00
Greg Ercolano
9e2d044caa As per thread on fltk.development: "RFC: Docs - getting rid of .eps files"
Summary:
    Get rid of eps files, 
    change all doxygen '\image latex' references to eps files to png/jpeg instead,
    convert doxygen images from gif -> png (to support html+latex).

Actual operations:

		1) svn remove *.eps
		2) convert all gifs ->  png
		3) svn remove *.gif
		4) svn add *.png
		5) For jpeg/png images, change all \image latex foo.eps .. ->  \image latex foo.[jpg,png] ..
		6) For gif images, change all \image html foo.gif .. ->  \image html foo.png
		   and (harder to do): change \image latex foo.eps .. ->  \image latex foo.png ..
		7) Remove EPSFILES macro from documentation/Makefile 
		   and remove eps related dependencies that were added recently



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7981 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2010-12-08 23:53:04 +00:00
Greg Ercolano
41c28597b9 Added rules to create eps files (if they don't exist) using ImageMagick convert(1).
This would probably allow us to remove the documentation/src/*.eps files from svn at some point.



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7958 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2010-12-06 03:00:06 +00:00
Greg Ercolano
81dd665b46 Removed unused FL.eps (see today's thread on fltk.development: "RFC docs")
Adjusted documentation/Makefile: in IMAGEFILES and EPSFILES: removed duplicates, added missing, sorted all.



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7957 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2010-12-06 02:47:27 +00:00
Greg Ercolano
4abadf9df5 Fixed tree-elements image
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7955 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2010-12-05 16:07:55 +00:00
Albrecht Schlosser
3226204369 Fixed one doxygen warning and cleaned up documentation/Makefile.
Removed unused statements and old comment.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7953 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2010-12-05 14:45:06 +00:00
Greg Ercolano
65d02841c2 Added latex \image refs to tree+table docs,
and eps image filenames to documentation/Makefile.



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7952 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2010-12-05 09:50:59 +00:00
Matthias Melcher
903107bca9 Fixed yet more Copyright to 2010.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7905 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2010-11-28 21:22:55 +00:00
yuri
ca3984892f fix generated manpages cleaning
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6778 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2009-04-24 09:20:17 +00:00
engelsman
c95505b462 removed numbering from doxygen chapters and navigation bars,
moved class/function reference pages to end of index table,
swapped editor/drawing chapters in Doxybook for PDF version



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6721 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2009-03-25 23:12:48 +00:00
Albrecht Schlosser
825f33c05a Moved the stripping of date comments (strip_tags) to its own target
"html-dist", just like it has been done for pdf-dist.

Stripping the date comments roughly doubled the time of html generation
for daily use, although it is only needed before a web update.

*** Please use "make html-dist" before updating the web docs. ***

Just for reference: Measurement values on my Windows system with cygwin:
 - make html	1:01 minutes
 - strip_tags	1:05 minutes
 - strip_tags	0:49 minutes after removal of cat

Todo:
 - Why do we need the external script strip_tags, are there reasons not to
   integrate it in the Makefile?
 - If it would be in the Makefile, should we use ${RM} instead of literally
   using "rm" ?


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6702 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2009-03-21 10:29:42 +00:00
Fabien Costantini
3ed30905a9 Updated the make html process, adding a new strip functionality that removes the date in each and every html autogenerated files. Now a constant message is displayed thus reducing drastically the size of future web updates.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6686 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2009-03-14 20:29:11 +00:00
Matthias Melcher
167d767e0f Changed the copyright to 2009 for header files. Still todo: src and test directory.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6614 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2009-01-01 16:11:32 +00:00
Albrecht Schlosser
609f519533 Fixed documentation dependencies and changed Doxybook (for latex/pdf gen.)
to _not_ generate the html files.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6557 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2008-12-07 13:35:10 +00:00
Fabien Costantini
73a2fa5b99 Doxygen documentation:
- Fixed recent documentation update problems in fl_draw.cxx : \ and @ char must be doubled otherwise interpreted as doxygen keywords
- Fixed some doxygenized parameters problems in Fl_Preferences.cxx
- Added the treeview mode, now featuring a vertical left tree browser in html doc
- Splitted html configuration file from pdf configuration file, now a new Doxybook config file permits to customize independtly both html and pdf modes without risking side effects and also without assuming an fltk user will have the Tex tools installed to generate the html doc. Now only pdf generation will need LaTex tools.
- Updated the doxygen based documentation to revison 9 and added new significant contributors to index.dox in alphabetical order.



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6539 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2008-12-03 01:02:10 +00:00
Albrecht Schlosser
587a23b3bb Minor documentation Makefile tweaks.
Removed fltk.pdf from svn:ignore and make distclean.
Added svn:ignore for man pages in documentation/src.
Added *.log to make clean in documentation.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6465 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2008-10-19 09:46:08 +00:00
Fabien Costantini
83c49f6fba Documentation makefile: Fixed make install would return an error if html folder does not exist.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6455 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2008-10-17 20:46:27 +00:00
Fabien Costantini
6ff84799a3 Moved latex related files to src, man files to src, updated Makefile and Doxyfile accordingly.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6453 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2008-10-17 12:42:28 +00:00
Fabien Costantini
ee1db2a27c Doxygen documentation: Fixes obsolete install data when using make install. Now fltk.pdf and all potential html files are installed in the fltk docdir.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6443 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2008-10-16 11:41:58 +00:00
Fabien Costantini
4f60171ba6 documentation Makefile:
+ Added all eps files to pdf gen dependencies.
+ Added Doxyfile to html and latex/pdf deps
+ Added a new pdf-dist target to please mum & dad there in heaven.



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6441 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2008-10-15 17:35:39 +00:00
Fabien Costantini
14ca02ffff Doxygen documentation: commented out the 1.5.7 specific doc options, updated README for pdf and html use. Now minimum version required is 1.5.5
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6440 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2008-10-15 15:58:04 +00:00
Fabien Costantini
7735c1b42c Doxygen documentation: added svn properties to ignore temp files, set pdf file mime-type to octet stream. Created a custom output log that captures all pdflatex output and makeindex output as we could loose some of them in the standard refman.log because of the iterating crazy nature of these latex tools. Now make pdf file generates the full baby (including ToC) in one shot.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6435 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2008-10-15 08:09:33 +00:00
Fabien Costantini
9701852f48 Doxygen pdf documentation: made pdflatex run in batchmode. This is non verbose and nonstopmode is, but pdflatex also furthers refman.log containing all the error report...
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6434 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2008-10-15 06:58:38 +00:00
Fabien Costantini
7592d7c588 Doxygen makefile: added new html and pdf targets, to use it run : make html, make pdf. for the last case, when an error is detected, the gen stops and you may have to run manually pdflatex again to have a correct toc ...
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6432 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2008-10-14 23:00:13 +00:00
Fabien Costantini
497afccb07 Doxygen pdf man: First version added in documentation/fltk.pdf, old doc removed, images, dox files moved to a new src directory.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6431 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2008-10-14 22:12:25 +00:00
Michael R Sweet
44b2ff35cf Use install command instead of CHMOD, CP, and MKDIR.
Drop all POSTBUILD stuff as it is no longer used.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@5663 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2007-02-06 19:35:28 +00:00
Matthias Melcher
84ad997529 Typo. Likely more to come.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@5622 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2007-01-18 23:15:09 +00:00
Matthias Melcher
8e7e416783 Added chapter 10 with documentation about multithreading
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@5621 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2007-01-18 22:48:19 +00:00
Michael R Sweet
40846ea887 Add examples.html to list of documentation files.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@5382 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2006-08-29 23:27:58 +00:00
Michael R Sweet
f27180b7cd Do some rearranging of image and desktop support files.
Add new Block Attack! game...


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@5358 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2006-08-25 06:58:33 +00:00
Matthias Melcher
6167376e2b Added two missing html files to the Makefile based installation process (STR #1339)
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@5244 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2006-06-27 11:55:20 +00:00
Michael R Sweet
115d539691 More packaging fun.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@4756 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2006-01-15 18:36:16 +00:00
Michael R Sweet
2eb4d42349 Move docdir definition to makeinclude.in (STR #824)
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@4294 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2005-04-21 11:24:18 +00:00
Michael R Sweet
1c399af444 Update source file headers with STR web page.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@4288 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2005-04-16 00:13:17 +00:00
Michael R Sweet
b41cf28662 Update "clean" targets to properly handle core files, remove backup files,
etc.

Add "install" target to test directory which installs the example programs.

Install the config.h file in the examples directory.

Make sure the example programs compile outside the FLTK source dir.

Add example programs to fltk.list.in.

Fix missing redraw() in x_cb() in FLUID...


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@4287 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2005-04-16 00:01:49 +00:00
Michael R Sweet
6d65dcba88 Change Fl_Spinner to use double values instead of ints.
Update FLUID dependencies.

The # copies spinner was just a bit too small for 100 copies.

Didn't set the menu divider if there were exactly 10 files in the history.

Add documentation for Fl_Spinner.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@4186 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2005-03-25 02:39:25 +00:00
Michael R Sweet
62721060db Using the layout alignment controls on a menu widget would cause
FLUID to crash (STR #742)

The Fl_Input_Choice documentation was not installed (STR #745)

documentation/Makefile:
    - Add Fl_Input_Choice.html to list of doco files.

fluid/align_widget.cxx:
    - Only do a full resize if the widget is not a menu button.
    - Also set modflag when making changes.



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@4060 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2005-03-05 15:09:59 +00:00