Skip to content

Latest commit

 

History

History
329 lines (255 loc) · 21.9 KB

CHANGELOG.md

File metadata and controls

329 lines (255 loc) · 21.9 KB
Raw

Changelog

All notable changes to the gtk-fortran project are documented in this file. The format is based on Keep a Changelog.

[gtk-fortran 4.7.0] 2024-11-05

This release offers interfaces to GTK 4.16 and GLib 2.82 (generated under Fedora 41 with GTK 4.16.3 and GLib 2.82.2).

Added

  • src/gtk-hl-dialog.f90: can now manage the logo via gtk_about_dialog_set_logo(). Contributed by Florian Ober.
  • cfwrapper.py: the gtk3 branch now also uses gtkenums-auto.in and gtk-auto.in, following the fpm feature backport.

Fixed

  • cfwrapper: Variant and GVariantType types are now correctly used when declared with a double * in C. Issue #289.
  • src/gtk-hl-dialog.f90: if providing artists or documenters, the cptr length was erroneously calculated from the number of authors. Contributed by Florian Ober.

[gtk-fortran 4.6.0] 2024-04-19

This release offers interfaces to GTK 4.14 and GLib 2.80 (generated under Fedora 40 with GTK 4.14.2 and GLib 2.80.0).

Added

  • The examples/bazaar.f90 program plays a little melody demo_sound.ogg when you click on Button1, by using a GtkMediaStream. The GTK 4 GStreamer backend must be installed (libgtk-4-media-gstreamer package in Ubuntu). It was tested with .ogg, .wav and .mid files.

Changed

  • cmake/cmake_uninstall.cmake.in: improved the code layout.

Fixed

  • src/gtk-fortran.pc.in: the line Libs: was modified to fix a problem with the macOS linker (which is not GNU ld and does not accept the -R option).

[gtk-fortran 4.5.0] 2023-11-08

This release offers interfaces to GTK 4.12 and GLib 2.78 (generated under Fedora 39 with GTK 4.12.3 and GLib 2.78.1).

Added

  • In gtk-sup.f90: the function convert_f_string_aa() (interface f_c_string) converts a fortran string array into an array of null-terminated C strings.

[gtk-fortran 4.4.1] 2023-08-31

Added

  • New types (enums) in src/cfwrapper/scan_types_and_enums.py, useful for other GNOME libraries.
  • Initializes types_enums.gtk_funptr list in src/cfwrapper/scan_types_and_enums.py with a few funptr types, and removes possibly duplicated ones.
  • examples/menubar.f90: an accelerator <Ctrl>q was added for quitting the application.

Changed

  • examples/bazaar.f90: modified the font and background of the textview.

Fixed

  • src/cfwrapper/fortran.py: declarations like const char * const * must be declared in Fortran as type(c_ptr), dimension(*) ::, as they are arrays of C strings (previously, only ** was considered).

[gtk-fortran 4.4.0] 2023-05-02

This release offers interfaces to GTK 4.10.3 and GLib 2.76.2.

Added

  • examples/cairo-tests.f90 now draws the circle period-2 bulb and the main cardioid over the Mandelbrot set. More text is also put in the figure.
  • examples/cairo-basics.f90 now also saves the drawing in a SVG file and a PDF file.
  • screenshots/hl_cairo_viewer-fedora38.png: showing "modern Fortran" written with a New Alphabet font.
  • a new example has been added in the gtk-fortran-extra repository (MIT license). It is a gtk-fortran application to encode a text using Peter Saville's color code.
  • src/test_extra.sh: an interactive script to test projects gtk-fortran-extra and gtkzero_fpm before gtk-fortran release.
  • src/cfwrapper/ can be used more easily with other C libraries (see the tutorial):
    • added a -l option to add the directories containing the header files and a -m option to add the corresponding Fortran modules.
    • added a -s option to add a suffix to the functions names.
  • src/cfwrapper/run_tests.py: for testing some functions of the cfwrapper.
  • src/scan_types_and_enums.py: the pass 1 was refactored in that class.
  • src/gtk-fortran_types.csv: list of all the GLib / GTK types used in the prototypes of the C functions. Generated by the cfwrapper/cfwrapper.py script.
  • src/gtk-fortran_funptr.csv: list of all the funptr types used in the prototypes of the C functions. Generated by the cfwrapper/cfwrapper.py script, which will also print the number of funptr in its statistics.
  • LICENSE_EXCEPTION: the text of the GCC Runtime Library Exception, version 3.1. Note that this exception was chosen in 2011 and was already cited in the header of each source file with the URL of the GNU licenses. Putting the text in the repository is a better practice.

Changed

  • logo/: the blue color of the GTK cube, whose HSL (hue, saturation, lightness) values are (211, 49, 63), was replaced by a purple whose hue (270) is the same as the hue of the Fortran logo.
  • src/build.sh is now an interactive script proposing to build, test and install gtk-fortran. It uses the default Fortran compiler, then build and test with Intel ifx.
  • src/cfwrapper/cleaning.py: code cleaning and improved layout.

Fixed

  • examples/hl_cairo_viewer.f90: the image is now redrawn when the window is resized. And the "Next>" button becomes sensitive when a second file is added.
  • examples/menubar.f90: the compilation was failing on 32 bits systems, due to an int64 kind used instead of c_size_t (for gssize).
  • examples/gio_demo.f90: a _c_size_t suffix added (for a gssize).
  • implicit none was added in all C/Fortran interfaces, as the implicit none of the modules do no apply to the interfaces blocks. It will harden the code by allowing the compiler to verify more deeply the coherence of the interfaces generated by the Python wrapper.

[gtk-fortran 4.3.0] 2022-11-10

This release offers interfaces to GTK 4.8.2 and GLib 2.74.1.

Added

  • screenshots/Julia_gtk-fortran_animated.gif: four Julia sets in four OS (Fedora, macOS, FreeBSD, MSYS2/Windows).
  • CITATION.cff file, used by the GitHub interface.
  • src/extract_hl_doc.py: generates markdown files for the HL gtk-fortran documentation. Fixes issue #259.
  • Intel ifx compiler is now supported by CMake (>=3.20), with the id IntelLLVM.
  • examples/tests_gtk_sup.f90: for testing functions of the gtk_sup module.
  • examples/notebooks.f90: notebooks are now scrollable. And a popup menu appears when clicking with the right button on tabs.
  • A new example has been added in the gtk-fortran-extra repository (MIT license). It demonstrates how you can use modern Fortran parallel features (coarrays, events, teams, collective routines) with gtk-fortran. It computes a Buddhabrot.
  • A new How to start my own project from a gtk-fortran example? tutorial, including license considerations.

Changed

  • The Python scripts received minor code improvements suggested by pylint.
  • CMakeLists.txt files: several minor improvements.
  • examples/notebooks.f90 improved: notebooks are now scrollable, added a popup menu when clicking with the right button on tabs.
  • The examples/gtkbuilder.glade UI file has been regenerated with Cambalache (gtkbuilder.cmb file) and renamed gtkbuilder.ui. The widgets were also improved (tooltips, URL link...).
  • gtk-auto.inc and gtkenums-auto.inc are renamed with the .in extension because GitHub believes .inc is C++. Fixes issue #263.
  • Improved code layout in some files, code cleaning, improvements.
  • Uses allocatable strings instead of long strings.
  • The HL gtk-fortran documentation has been fully reviewed and updated.
  • The Wiki documentation has been fully reviewed and refactored: it now uses the Diátaxis framework (Tutorials, How-to, Reference, Explanation).

Fixed

  • src/cfwrapper/enums.py: prepared for GTK 4.8 and GLib 2.74. Two regex were modified to remove correctly three constants. See issue #266.
  • cmake/DefaultFlags.cmake: release and debug flags for non-GFortran compilers were inverted.

[gtk-fortran 4.2.1] 2022-04-24

Fixed

  • Issue #257: examples/tests.f90, examples/bazaar.f90 and src/gtk-fortran.f90 were crashing (segmentation fault) on macOS because the GLib g_get_os_info() function returns NULL on that OS.

[gtk-fortran 4.2] 2022-04-23

This release offers interfaces to GTK 4.6.2 and GLib 2.72.1.

Added

  • gtk-fortran can now be used as a simple fpm dependency (gtk4 branch only). See the gtkzero_fpm example. It implied some changes:
    • gtk-auto.f90 and gtkenums-auto.f90 are renamed with the .inc extension.
    • Removed mswindowsonly-auto.f90 and unixonly-auto.f90, and added api_compatibility.f90 with the module gtk_os_dependent to keep API compatibility.
    • plplot/plplot_extra_ndef.f90 renamed plplot_extra.f90 and moved to src/.
  • examples/bazaar.f90: the About button credits the authors of that file. The call to gtk_about_dialog_set_license() is replaced by the more convenient gtk_about_dialog_set_license_type().
  • A tutorials/ directory contains the GTK 4 sources used in the Wiki first tutorial.
  • src/gtk-fortran.f90: prints the GTK and GLib version of the release.
  • A conda repository for gtk-4-fortran.

Changed

  • Better handling of default compiler flags, using flags like CMAKE_Fortran_FLAGS_RELEASE_INIT (CMake>=3.7 required). A file cmake/DefaultFlags.cmake was added. Backported to gtk3 branch.
  • gtkbuilder2.f90: replaced gtk_builder_add_from_file() by gtk_builder_new_from_file().
  • The syntax was modernized in many places (Fortran 2008).

Fixed

  • g_application_run() should be called with an array [c_null_ptr] as third argument instead of c_null_ptr. Needed with the NAG Fortran compiler. Backported to gtk3 branch.
  • examples/tests.f90: loop undefined with ifort. And now uses g_variant_unref().
  • Various bug fixes.

[gtk-fortran 3.24.31] 2022-04-21

  • The gtk-3-fortran library offers interfaces to GTK 3.24.31 and GLib 2.72.1 (generated with Fedora 36).

Changed

  • Better handling of default compiler flags, using flags like CMAKE_Fortran_FLAGS_RELEASE_INIT (CMake>=3.7 required). A file cmake/DefaultFlags.cmake was added.

Fixed

  • g_application_run() should be called with an array [c_null_ptr] as third argument instead of c_null_ptr. Needed with the NAG Fortran compiler.

[gtk-fortran 4.1] 2021-10-22

The gtk-4-fortran library has been generated from GTK 4.4.0 and GLib 2.70.0 under Fedora 35.

Added

  • The cfwrapper has a new required parameter -v to set the gtk-fortran semantic version (major.minor.patch). It is written in the VERSIONS file (used by CMake, src/extract_events.pl, src/alt_build_test.sh) and codemeta.json. Backported to the gtk3 branch.

Changed

  • The compiler flags for release is now -O3 instead of -O3 -mtune=native -march=native.
  • The -warn nounused flag was added for ifort.
  • The Fortran / C interfaces now use the import :: statement instead of use, intrinsic :: iso_c_binding, only:.
  • In some examples, a module was added to contain the scientific subroutines: julia_pixbuf.f90, mandelbrot_pixbuf.f90, cairo-tests.f90.

Removed

  • examples/gtkbuilder.f90: gtk_builder_connect_signals_full being removed from GTK 4, this example has become identical to gtkbuilder2.f90.

[gtk-fortran 3.24.30] 2021-09-08

  • The gtk-3-fortran library has been generated from GTK 3.24.30 and GLib 2.68.4 under Fedora 34.

Added

  • The cfwrapper has a new required parameter -v to set the gtk-fortran semantic version (major.minor.patch). It is written in the VERSIONS file (used by CMake, src/extract_events.pl, src/alt_build_test.sh) and codemeta.json.
  • A tutorials/ directory contains the sources and screenshots used in the Wiki new tutorials.

Changed

  • The compiler flags for release is now -O3 instead of -O3 -mtune=native -march=native.
  • The Fortran / C interfaces now use the import :: statement instead of use, intrinsic :: iso_c_binding, only:.

[gtk-fortran 4.0] 2021-04-28

  • The gtk-4-fortran library has been generated from GTK 4.2.0 and GLib 2.68.1 under Fedora 34.
  • Starting from this 4.0 release, the project will adhere to Semantic Versioning.
  • All the improvements included in the simultaneously released gtk-fortran 3.24.28 (gtk3 branch) are also in the gtk4 branch.

Added

  • GTK 4 now includes the GSK and graphene libraries: src/gsk-auto.f90 and src/graphene-auto.f90 (see https://developer.gnome.org/gtk4/stable/gtk.html)
  • src/gtk.f90: historically, in gtk-fortran g_signal_connect() was declared as a subroutine, because the handler_id returned by the GLib function is usually never used. Here we define both a g_signal_connect() function and a subroutine. You will generally use the subroutine in your programs. The function_g_signal_connect_swapped and g_signal_connect_swapped procedure were also added.
  • examples/menubar.f90: a new menu example based on GMenu and GAction.

Changed

  • examples/gtkzero_gapp.f90 is now working.
  • examples/gtkhello.f90: new version using GtkApplication.
  • Most examples are now using GtkApplication.
  • sketcher/sketcher.f90 has been ported to GTK 4, but some problems remains due to deprecated functions: it can not detect signals in the UI file and the toplevel widget detection need improvement.

Removed

  • examples/gtkzero.f90: replaced by gtkzero_gapp.f90.
  • examples/gtkhello2.f90: replaced by gtkhello.f90.
  • examples/menu.f90 & menu2.f90: based on deprecated APIs.
  • examples/hl_radio.f90: based on the GtkRadioButton deprecated API.
  • src/atk-auto.f90: removed from GTK 4 (deprecated API).
  • src/gtk-hl-accelerator.f90: deprecated API.
  • src/gtk-hl-menu.f90 and examples/hl_menu.f90: deprecated API.
  • src/gtk-hl-chooser.f90, bazaar.f90, hl_choosers.f90: GtkFileChooserButton has been removed from GTK 4.
  • meson.build experimental files were removed. They are now apart in the gtk4-dev-meson branch.

[gtk-fortran 3.24.28] - 2021-04-28

Added

  • examples/regex.f90: a new example demonstrating GLib regular expressions functions.
  • src/gtk-fortran.f90: a gtk-?-fortran command to show information about the library.
  • examples/pixbuf_without_gui.f90: a new example drawing a Sierpinski triangle in a PNG file, without using a GUI.

Changed

  • cfwrapper.py is now writing the path and name of each C header file in the *-auto.f90 files.
  • cfwrapper.py is now systematically launching extract_events.pl.
  • cfwrapper.py is now updating the codemeta.json file (dateModified field).
  • VERSIONS: the name of the distribution used to generate gtk-fortran is now automatically found.

Fixed

  • src/CMakeLists.txt: added unix-print-auto.f90 which was missing.

Security

  • For intrinsic modules, all the use statements have been replaced by use, intrinsic ::.

[gtk-fortran 20.04] - 2020-05-07

The main objective of this release was to clean up the code and prepare it for the future GTK 4 branch.

Changed

  • gtk3 branch based on GTK 3.24.18, GLib 2.64.2, generated under Lubuntu 20.04 x86_64.
  • CMake>=3.4 required.
  • cmake/cmake_uninstall.cmake.in: updated with the latest code from https://gitlab.kitware.com/cmake/community/-/wikis/FAQ#can-i-do-make-uninstall-with-cmake
  • CMake now uses GNUInstallDirs for the lib dir. On some systems, like Fedora, it will be lib64, on others lib.
  • bash scripts syntax has been improved, using shellcheck.
  • test.sh has been renamed alt_build_test.sh
  • The master branch has been renamed gtk2.
  • src/gdkevents-auto3.f90: no reason to indicate the GTK version for that file. The "3" was removed.
  • src/gtk-3-fortran.pc.in => src/gtk-fortran.pc.in: improved pkg-config file.
  • README-high-level now using Markdown: README-high-level.md
  • src/usemodules.pl: can now be used directly from that directory, without make install.
  • Examples: code clean up. Some deprecated GTK 3 functions have been removed to prepare for GTK 4.

Added

  • Experimental and uncomplete meson.build files have been added. Meson>=0.53 is needed. Commands are meson buildmeson and ninja -C buildmeson. The gtk-fortran library can be inst alled using sudo ninja -C buildmeson install, but there is still some problems for installing the .mod files (see mesonbuild/meson#5374). Please use CMake for production !
  • examples/menu2.f90: the menu.f90 example is based on deprecated functions.
  • examples/gtkzero_gapp.f90: an empty GTK window based on GtkApplication and GApplication.
  • CMake -D NO_BUILD_HL=true option to disable building the High Level sub-library (which includes PLplot and sketcher).
  • VERSIONS: a CSV file with the gtk-fortran, GTK, GLib and Ubuntu versions. Automatically created by the cfwrapper.py script. It will be used by the building system of the project.

Removed

  • Gtkextra directory: that directory was not maintained for 9 years, the gtkextra library is not maintained anymore and is based on GTK 2. The gtksheet part was forked (https://github.com/fpaquet/gtksheet), but it is necessary to reduce the amount of work to maintain gtk-fortran. So it was removed from the gtk3 branch.
  • Doxygen dependence. It was introduced at the beginning of the gtk-fortran project but never used.
  • win32_install.bat: this file was last updated in 2013 and may be brokken. You should instead install MSYS2 under Windows and follow the instructions on the wiki.
  • cmake/FindPlplotF95.cmake: deprecated module to find the PLplot library (does not work with PLplot>=5.11 released the 2015-04-12).
  • cmake/CheckFortranSourceCompiles.cmake: this macro is included in CMake since 3.1 version.
  • cmake/FindGTK3.cmake: PkgConfig is used instead.
  • test.bat: a deprecated script to build gtk-fortran (GTK 2) under Windows.
  • The test/ directory containing the run_all.pl script. You can use CTest instead (see the wiki).
  • Deprecated functions, to be ready for GTK 4.
  • gtk-*hl-*-tmpl.f90 files: the gtk-*hl-*.f90 will be fully managed by git, instead of being generated from these templates.
  • mk_gtk_hl.pl: that script was used to manage GTK 2 & 3 differences in the gtk-*hl-*.f90 files.

Fixed

  • src/usemodules.py was printing false deprecated functions alerts in the hl files of the src directory.
  • Updated gtkbuilder.glade to use GTK 3 interface.

[gtk-fortran 19.04] - 2019-04-24

Added

  • The cfwrapper.py detects the status of each function (AVAILABLE or DEPRECATED) and writes it in the *-auto.f90 files and in gtk-fortran-index.csv. It will help to remove deprecated functions during the GTK 4 migration. Developers can use the -d argument to remove DEPRECATED functions from the library: using make -i will then show errors for each deprecated function used in the project.
  • The usemodules.py script prints warnings when deprecated functions are found in Fortran files, and tries to split USE lines cleanly.
  • A show_versions.sh script that shows the versions of the main tools and libraries used in gtk-fortran. Useful for gtk-fortran developers or for reporting bugs.
  • A README file in each directory, explaining the role of each file.
  • Parallel building (gtk3) using make -j or make --jobs. On some systems, like FreeBSD, the number of jobs must be given: make -j 4 for example. By @ChinouneMehdi.
  • A video quickstart guide on the Wiki.
  • A is_UNIX_OS() function in gtk-sup.f90.
  • This CHANGELOG.md file.
  • gtk-fortran can now be cited: Vincent MAGNIN, James TAPPIN, Jens HUNGER, Jerry DE LISLE, "gtk-fortran: a GTK+ binding to build Graphical User Interfaces in Fortran", Journal of Open Source Software, 4(34), 1109, 12th January 2019, https://doi.org/10.21105/joss.01109

Changed

  • gtk3 branch based on GTK 3.24.8, GLib 2.60.0, generated with Ubuntu 19.04 x86_64, PLplot>=5.13.
  • master (GTK 2) branch based on GTK 2.24.32, GLib 2.60.0, generated with Ubuntu 19.04 x86_64, PLplot<=5.10.
  • The cfwrapper.py script has been moved in the src/cfwrapper directory, and splitted in several modules to ease maintenance.
  • Major revision of the PLplot part (code and documentation) in the gtk3 branch: PLplot>=5.13 is now required. And it runs under MSYS2/Windows. The gtk2 branch will keep PLplot<=5.10.
  • Major update of the Wiki documentation.
  • New examples: gtkzero.f90 (just a window) and gtkhello.f90 (two buttons).
  • Updated examples.
  • The default branch is now gtk3. The master (gtk2) branch should not be used for new projects.
  • The gtk-fortran repository URL is now https://github.com/vmagnin/gtk-fortran. The URL https://github.com/jerryd/gtk-fortran is automatically redirected to the new URL. So it is transparent to the user. You are not obliged to modify it in your git settings, but if you want, type: git remote set-url origin git@github.com:vmagnin/gtk-fortran.git
  • Doxygen (not yet used in the project) is optional.

Removed

  • old stuff in the plplot/ directory.
  • old-cfwrapper.py: a previous Python 2 version of the wrapper, last modified in 2013.

Deprecated

  • cmake/FindPlplotF95.cmake: deprecated module to find the PLplot<=5.10 library.

Fixed

  • The cfwrapper.py script can now scan the gstdio.h and giochannel.h files, except for the g_io_channel_win32_new_messages() function which can be declared with two different parameters types.
  • Less warnings in Debug mode.
  • Fixed some bugs in examples.
  • The PLplot examples now work under MSYS2.
  • gtkf-sketcher.f90 now works under MSYS2.

[gtk-fortran 17.10] - 2018-05-01

Changed

  • GTK 3.22.25, GLib 2.54.1
  • GTK 2.24.31, GLib 2.54.1

[gtk-fortran 16.10] - 2017-01-09

Changed

  • GTK 3.20.9, GLib 2.50.2
  • GTK 2.24.30, GLib 2.50.2
  • The code of the heart of gtk-fortran, the cfwrapper.py script, has been refactored and improved in order to ease maintenance.
  • CMake files have been unified in master (gtk2) and gtk3 branches.

[gtk-fortran 16.04] - 2016-06-15

Changed

  • GTK 3.18.9, GLib 2.48.0
  • GTK 2.24.30, GLib 2.48.0

[gtk-fortran 13.10]

Changed

  • GTK 3.10.1
  • GTK 2.24.22

[first commit] - 2011-01-10

Added

  • Creation of the github repository by @jerryd.