Reorganize documentation source directories

- move all images (screenshots) to new folder documentation/images/
- move documentation/src/fltk-title.tex.in to documentation/
- fix .gitignore files (remove obsolete entries etc.)
- FL/Fl_Tooltip.H: fix '\image latex' reference
- documentation/CMakeLists.txt: update ref. to fltk-title.tex.in
- documentation/Doxyfile.in: adjust image path (IMAGE_PATH)

.gitignore

@@ -4,54 +4,36 @@
 
 # Ignore everywhere, also in subdirectories
 
+*.bak
 *.bck
 *.exe
+*.log
 *.o
 **/.DS_Store
 
-# CMake build artifacts if built in source - strongly discouraged!
+# CMake build artifacts if built in source - forbidden since FLTK 1.5.0.
-# We may disallow this later...
+# However, the following artifacts would be created by an attempt to
+# execute `cmake` in-source:
 
-bin/
-**/cmake_install.cmake
 **/CMakeCache.txt
 **/CMakeFiles/
-cmake_uninstall.cmake
-FLTK.sln
-FLTK-Targets.cmake
-FLTKConfig.cmake
-etc/FLTKConfig.cmake
-/CMakeSettings.json
-/CppProperties.json
 
-# Visual Studio (MSVC) build artifacts
+# VS Code (Visual Studio Code) Editor is a user generated folder
-
+# that must not be committed
-*.tlog
-.vs/
-/out
-
-# VS Code (Visual Studio Code) Editor
 
 .vscode/
 
-# /
+# default build folder `build` and more ...
 
 /build
-/fltk-config
-/fltk.list
-/fltk.spec
 /TAGS
 
-# /FL
+# /FL - this should not happen, but anyway ...
 
 /FL/fl_config.h
 
-# /lib/
+# executables manually built in /misc/
-
+# todo: maybe move the source files to folder /util/ ?
-/lib/lib*
-/lib/*.lib
-/lib/*.a
-
-# /misc/
 
 /misc/doxystar
+/misc/fromdos

FL/Fl_Tooltip.H

@@ -28,7 +28,7 @@
   all FLTK widgets. It contains only static methods.
 
   \image html tooltip-options.png "Fl_Tooltip Options"
-  \image latex src/tooltip-options.png "Fl_Tooltip Options" width=6cm
+  \image latex tooltip-options.png "Fl_Tooltip Options" width=10cm
 
 */
 class FL_EXPORT Fl_Tooltip {

documentation/.gitignore

@@ -1,45 +1,11 @@
 #
 # Files to be ignored by Git (do not commit)
 #
+# Note: since FLTK 1.5 building FLTK in-source is no longer allowed.
+#   Therefore we don't need to "ignore" generated files anymore
+#   because generated files are stored in the build tree.
 
 # /documentation/
-.xvpics
-blocks.0
-blocks.6
-blocks.z
-checkers.0
-checkers.6
-checkers.z
-copyright.dox
-Doxybook
-Doxyfile
-fltk.0
-fltk.3
-fltk-config.0
-fltk-config.1
-fltk-config.z
-fltk.d
-fltk.pdf
-fltk.z
-fluid.0
-fluid.1
-fluid.z
-generated.dox
-html
-latex
-sudoku.0
-sudoku.6
-sudoku.z
 *.bck
 *.bak
 *.log
-
-# /documentation/src/
-src/*.0
-src/*.1
-src/*.3
-src/*.6
-src/*.z
-src/fltk-book.tex
-src/fltk-book.tex.in
-src/fltk-title.tex

documentation/CMakeLists.txt

@@ -1,7 +1,7 @@
 #
 # CMakeLists.txt to build docs for the FLTK project using CMake (www.cmake.org)
 #
-# Copyright 1998-2024 by Bill Spitzak and others.
+# Copyright 1998-2025 by Bill Spitzak and others.
 #
 # This library is free software. Distribution and use rights are outlined in
 # the file "COPYING" which should have been included with this file.  If this
@@ -191,7 +191,7 @@ if(FLTK_BUILD_PDF_DOCS)
   # generate LaTeX title fltk-title.tex and make_pdf script
 
   configure_file(
-    ${CMAKE_CURRENT_SOURCE_DIR}/src/fltk-title.tex.in
+    ${CMAKE_CURRENT_SOURCE_DIR}/fltk-title.tex.in
     ${CMAKE_CURRENT_BINARY_DIR}/fltk-title.tex
     @ONLY
   )
@@ -209,8 +209,8 @@ if(FLTK_BUILD_PDF_DOCS)
   set(_deps)
   set(image_input_sources
       ${CMAKE_CURRENT_SOURCE_DIR}/src/unicode.dox
-      # ${CMAKE_CURRENT_SOURCE_DIR}/src/cmp.dox
+      # ${CMAKE_CURRENT_SOURCE_DIR}/src/cmp.dox   # more documentation files
-      # ${FLTK_SOURCE_DIR}/src/Fl.cxx # example source file
+      # ${FLTK_SOURCE_DIR}/src/Fl.cxx             # example source file
   )
 
   # Generate one custom command and one timestamp per input file

documentation/Doxyfile.in

@@ -921,7 +921,7 @@ EXAMPLE_RECURSIVE      = NO
 # that contain images that are to be included in the documentation (see the
 # \image command).
 
-IMAGE_PATH             = @CMAKE_CURRENT_SOURCE_DIR@/src \
+IMAGE_PATH             = @CMAKE_CURRENT_SOURCE_DIR@/images \
                          @CMAKE_CURRENT_BINARY_DIR@/generated
 
 # The INPUT_FILTER tag can be used to specify a program that doxygen should