FLTK 1.4.3 released on April 29, 2025

58 views
Skip to first unread message

Albrecht Schlosser

unread,
Apr 29, 2025, 9:21:11 AM4/29/25
to fltkg...@googlegroups.com, fltkc...@googlegroups.com

We are pleased to announce the release of FLTK 1.4.3

This is a maintenance release with bug fixes and improvements. Its ABI and API are 100% backwards compatible with FLTK 1.4.0. We recommend all users of FLTK 1.3.x and previous 1.4 releases to upgrade to FLTK 1.4.2.

For details (changelog) please see CHANGES.txt [5].

Since FLTK 1.4.1 FLTK releases are exclusively hosted on GitHub [3]. Links to all releases can be found on FLTK's download page [4] as usual, all recent releases can be found on [3].

For more information on the new release please go to the GitHub "Releases" page [3].

Links

[1] https://www.fltk.org/doc-1.4/ (HTML)
    https://www.fltk.org/doc-1.4/fltk.pdf (PDF)
[2] https://github.com/fltk/fltk.git
[3] https://github.com/fltk/fltk/releases/
[4] https://www.fltk.org/software.php
[5] https://raw.githubusercontent.com/fltk/fltk/refs/tags/release-1.4.3/CHANGES.txt

Eric Sokolowsky

unread,
Apr 29, 2025, 9:43:19 AM4/29/25
to fltk.general
When I tried to build the release 1.4.3 on my Rocky 8 system, I get the following error messages.
It appears that there is a file 'refman.tex' that is missing from the tarball distribution.

----------

make[4]: Leaving directory '/home/esokolow/rpmbuild/BUILD/fltk-1.4.3'
make  -f documentation/CMakeFiles/pdf.dir/build.make documentation/CMakeFiles/pdf.dir/build
make[4]: Entering directory '/home/esokolow/rpmbuild/BUILD/fltk-1.4.3'
Converting Doxybook to doxygen version 1.8.14
cd /home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation && /home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/convert_doxyfile /usr/bin/doxygen Doxybook.in Doxybook /home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/Doxybook_error.log
Generating PDF documentation
cd /home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation && /home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/make_header /usr/bin/doxygen /home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/fltk-title.tex /home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/fltk-book.tex
cd /home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation && /usr/bin/doxygen Doxybook
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/preface.dox:82: warning: expected whitespace after { command
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/osissues.dox:1016: warning: Unsupported xml/html tag <u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/osissues.dox:1016: warning: Unsupported xml/html tag </u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/osissues.dox:1032: warning: Unsupported xml/html tag <u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/osissues.dox:1032: warning: Unsupported xml/html tag </u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/wayland.dox:168: warning: Unsupported xml/html tag <u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/wayland.dox:168: warning: Unsupported xml/html tag </u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/wayland.dox:876: warning: Unsupported xml/html tag <u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/wayland.dox:876: warning: Unsupported xml/html tag </u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/wayland.dox:883: warning: Unsupported xml/html tag <u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/wayland.dox:883: warning: Unsupported xml/html tag </u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/wayland.dox:1007: warning: Unsupported xml/html tag <u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/wayland.dox:1007: warning: Unsupported xml/html tag </u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/src/Fl_compose.cxx:69: warning: Unsupported xml/html tag <u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/src/Fl_compose.cxx:69: warning: Unsupported xml/html tag </u> found
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/FL/Fl_Terminal.H:833: warning: unable to resolve reference to `Fl_Scrollbar::value(void)' for \ref command
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/index.dox:14: warning: expected whitespace after { command
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/src/index.dox:99: warning: expected whitespace after { command
cd /home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation && /home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/make_pdf
cd /home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation && cp -f latex/refman.pdf fltk.pdf
cp: cannot stat 'latex/refman.pdf': No such file or directory
make[4]: *** [documentation/CMakeFiles/pdf.dir/build.make:80: documentation/fltk.pdf] Error 1
make[4]: Leaving directory '/home/esokolow/rpmbuild/BUILD/fltk-1.4.3'
make[3]: *** [CMakeFiles/Makefile2:439: documentation/CMakeFiles/pdf.dir/all] Error 2
make[3]: Leaving directory '/home/esokolow/rpmbuild/BUILD/fltk-1.4.3'
make[2]: *** [CMakeFiles/Makefile2:473: documentation/CMakeFiles/docs.dir/rule] Error 2
make[2]: Leaving directory '/home/esokolow/rpmbuild/BUILD/fltk-1.4.3'
make[1]: *** [Makefile:211: docs] Error 2
make[1]: Leaving directory '/home/esokolow/rpmbuild/BUILD/fltk-1.4.3'
error: Bad exit status from /var/tmp/rpm-tmp.N2hXjL (%build)


RPM build errors:
    Macro expanded in comment on line 212: %{_libdir}/cmake/fltk/

    Bad exit status from /var/tmp/rpm-tmp.N2hXjL (%build)
make: *** [Makefile:37: rpm] Error 1


-----

Here is the contents of pdfall.log:

/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/make_pdf: line 34: cd: latex: No such file or directory
This is pdfTeX, Version 3.14159265-2.6-1.40.19 (TeX Live 2018) (preloaded format=pdflatex)
 restricted \write18 enabled.
entering extended mode
LaTeX2e <2017-04-15>
Babel <3.17> and hyphenation patterns for 3 language(s) loaded.

! LaTeX Error: File `refman.tex' not found.

Type X to quit or <RETURN> to proceed,
or enter new name. (Default extension: tex)

Enter file name:
! Emergency stop.
<read *>

<*> ...dDate(D:20250429132713Z)}\input{refman.tex}
                                                  ^^M
!  ==> Fatal error occurred, no output PDF file produced!
Transcript written on texput.log.
/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/make_pdf: line 36: makeindex: command not found
This is pdfTeX, Version 3.14159265-2.6-1.40.19 (TeX Live 2018) (preloaded format=pdflatex)
 restricted \write18 enabled.
entering extended mode
LaTeX2e <2017-04-15>
Babel <3.17> and hyphenation patterns for 3 language(s) loaded.

! LaTeX Error: File `refman.tex' not found.

Type X to quit or <RETURN> to proceed,
or enter new name. (Default extension: tex)

Enter file name:
! Emergency stop.
<read *>

<*> ...dDate(D:20250429132713Z)}\input{refman.tex}
                                                  ^^M
!  ==> Fatal error occurred, no output PDF file produced!
Transcript written on texput.log.
 ---------


Any suggestions?

Eric

Albrecht Schlosser

unread,
Apr 29, 2025, 10:31:33 AM4/29/25
to fltkg...@googlegroups.com
Hi Eric,

thank you for the quick feedback. On my Debian 12/Bookworm system I can build the documentation with both configure/make and cmake, I just checked it with the uploaded release tarball. There is no file named `refman.tex` in the fltk repo (git), and therefore this file is not in the tarball. This file is obviously generated by doxygen or latex when building the PDF documentation.

However, I see another issue in your logfile:
```

/home/esokolow/rpmbuild/BUILD/fltk-1.4.3/documentation/make_pdf: line 36: makeindex: command not found
```

This *seems* to indicate that your LaTeX installation is incomplete. On my Debian system this file is part of the `texlive-binaries` package:
```
$ apt-file search /usr/bin/makeindex
texlive-binaries: /usr/bin/makeindex      
```

Please check if you installed all required packages for documentation generation. On Ubuntu and Debian systems it should be sufficient to install the package `doxygen-latex` but I can't help with `Rocky 8`. Maybe someone else can help with this system though.

If you need more help (after installing the needed LaTeX software packages) we may need the following information to help you further:

1) Did you successfully build a previous release or releases on your system? If yes, which one was the latest? Was it 1.3.x, or was it 1.4.x?

2) How exactly do you try "to build the release 1.4.3" on your system? Please post the full commands, but note that I'm not familiar with "rpmbuild" if that's what you are using (I'm guessing). Please be as precise as possible.

3) If it is possible, can you please try to exclude the (PDF) docs from the build? I assume that this could work (if there are no other issues like missing development packages on your system).
--
You received this message because you are subscribed to the Google Groups "fltk.general" group.
To unsubscribe from this group and stop receiving emails from it, send an email to fltkgeneral...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/fltkgeneral/f8d4b9e6-f32f-46f5-abc1-27afd342c92dn%40googlegroups.com.

Albrecht Schlosser

unread,
Apr 29, 2025, 11:11:55 AM4/29/25
to fltkg...@googlegroups.com
Update: Building the FLTK PDF docs with doxygen version 1.8.14 (the same version the OP used) does indeed fail on my system as well:
$ cmake --build . --target pdf
Converting Doxybook to doxygen version 1.8.14
Generating PDF documentation
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/preface.dox:82: warning: expected whitespace after { command
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/osissues.dox:1016: warning: Unsupported xml/html tag <u> found
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/osissues.dox:1016: warning: Unsupported xml/html tag </u> found
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/osissues.dox:1032: warning: Unsupported xml/html tag <u> found
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/osissues.dox:1032: warning: Unsupported xml/html tag </u> found
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/wayland.dox:168: warning: Unsupported xml/html tag <u> found
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/wayland.dox:168: warning: Unsupported xml/html tag </u> found
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/wayland.dox:876: warning: Unsupported xml/html tag <u> found
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/wayland.dox:876: warning: Unsupported xml/html tag </u> found
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/wayland.dox:883: warning: Unsupported xml/html tag <u> found
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/wayland.dox:883: warning: Unsupported xml/html tag </u> found
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/wayland.dox:1007: warning: Unsupported xml/html tag <u> found
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/wayland.dox:1007: warning: Unsupported xml/html tag </u> found
/home/albrecht/temp/fltk/fltk-1.4.3/src/Fl_compose.cxx:69: warning: Unsupported xml/html tag <u> found
/home/albrecht/temp/fltk/fltk-1.4.3/src/Fl_compose.cxx:69: warning: Unsupported xml/html tag </u> found
/home/albrecht/temp/fltk/fltk-1.4.3/FL/Fl_Terminal.H:833: warning: unable to resolve reference to `Fl_Scrollbar::value(void)' for \ref command
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/index.dox:14: warning: expected whitespace after { command
/home/albrecht/temp/fltk/fltk-1.4.3/documentation/src/index.dox:99: warning: expected whitespace after { command
cp: cannot stat 'latex/refman.pdf': No such file or directory
gmake[3]: *** [documentation/CMakeFiles/pdf.dir/build.make:77: documentation/fltk.pdf] Error 1
gmake[2]: *** [CMakeFiles/Makefile2:436: documentation/CMakeFiles/pdf.dir/all] Error 2
gmake[1]: *** [CMakeFiles/Makefile2:443: documentation/CMakeFiles/pdf.dir/rule] Error 2
gmake: *** [Makefile:195: pdf] Error 2

The warnings (blue color, normal text) are the same as when generating the HTML docs, which works w/o errors. The error messages (red color, bold italics) appear only when building the PDF docs with doxygen 1.8.14.

@Eric: can you try to use a newer doxygen version? Doxygen 1.8.14 is now about 6 1/2 years old (release date 25-12-2017 according to the website). I'm not sure if we can "fix" this in our code, it can either be a bug in doxygen or we are using a feature that has been introduced in a later version. I'll check this, but please don't hold your breath and don't *expect* a (quick) fix on our side.

I'm regularly building my own doxygen versions for testing, and IIRC the build is not very complicated, but it takes its time. Anyway, I found a short recipe for doing this in a stackoverflow answer, and I hope this helps: https://stackoverflow.com/questions/45431868/doxygen-usage-of-includedoc

This post is related to the issue that's most likely causing the fail: we are using `include{doc}` in doxygen at several places.

BTW: the other warnings about Unsupported xml/html tag <u> seem to be benign. I don't know if/when recognition of this tag has been introduced in doxygen, or if it is another doxygen bug in version 1.8.14.

I hope this helps.

Albrecht

Albrecht Schlosser

unread,
Apr 29, 2025, 11:20:34 AM4/29/25
to fltkg...@googlegroups.com

Yet another update:

Building the PDF docs with doxygen 1.9.1 (release date 08-01-2021) works with a single warning:

```
$ cmake --build . --target pdf
Converting Doxybook to doxygen version 1.9.1
Generating PDF documentation
[...]/fltk-1.4.3/FL/Fl_Terminal.H:832: warning: unable to resolve reference to 'Fl_Scrollbar::value(void)' for \ref command
Built target pdf
```

I'll check this warning ...

Albrecht Schlosser

unread,
Apr 29, 2025, 2:34:14 PM4/29/25
to fltkg...@googlegroups.com
FTR: I checked the remaining warning, and it has been fixed in a later Doxygen version (supposedly 1.9.4, but I'm not sure). Doxygen 1.9.4 and 1.9.5 are known to be buggy or to create unpleasant output anyway, therefore the recommendation is to use Doxygen 1.9.6 or higher. Older versions may work or not...

That said, I fixed the "warning: unable to resolve reference to 'Fl_Scrollbar::value(void)'" in our code by removing the 'void' keyword in the parameter list, for both branch-1.4 and master. This minor fix will be included in the next patch release (1.4.4), whenever that comes.

@Eric: That's all I can do for today, the "unsupported <u> tag" and other warnings will not be fixed shortly (*maybe* later though). The workaround is to use a more recent Doxygen version or to disable PDF generation.

Clark Williams

unread,
May 2, 2025, 5:40:37 PM5/2/25
to fltk.general
H
Reply all
Reply to author
Forward
0 new messages