Skip to content

Latest commit

 

History

History
199 lines (159 loc) · 13.8 KB

CHANGELOG.md

File metadata and controls

199 lines (159 loc) · 13.8 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 dev] 2024-11-05

Fixed

  • cfwrapper: Variant and GVariantType types are now correctly used when declared with a double * in C. Issue #289.

[gtk-fortran 3.24.41] 2024-05-08

Offers Fortran interfaces to the latests GTK 3.24.41, GLib 2.80.0, Cairo 1.18.0... (generated with Fedora 40)

Added

  • gtk-3-fortran can now be used as a simple fpm dependency. See the gtkzero_fpm example (gtk3 branch). It implied some changes:
    • gtk-auto.f90 and gtkenums-auto.f90 are renamed with the .in 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/.
  • 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.
  • 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.
    • c_f_string_copy_alloc() backported from gtk4: creates a default character deferred length allocatable copy of the value of a C string. This function should be preferred to c_f_string_copy() when using a Fortran>=2008 compiler. An advantage is that the trim() function will generally not be needed.

Changed

  • examples/tests.f90: latest version backported from gtk4 branch.
  • plplot/README.md: latest version backported from gtk4 branch.
  • src/cfwrapper/ backported from gtk4 (2023-08-23 version).
    • src/cfwrapper/enums.py: prepared for GLib >=2.74. Two regex were modified to remove correctly three constants. See issue #266.
    • 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.
    • src/cfwrapper/cleaning.py: code cleaning and improved layout.
    • 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.
      • New types (enums) in src/cfwrapper/scan_types_and_enums.py, useful for other GNOME libraries.
    • 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/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).
    • Initializes types_enums.gtk_funptr list in src/cfwrapper/scan_types_and_enums.py with a few funptr types, and removes possibly duplicated ones.
    • 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.
  • src/build.sh (backported from gtk4 branch) 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.
  • cmake/cmake_uninstall.cmake.in: improved the code layout (backported from gtk4 branch).
  • CMakeLists.txt: backported GTK_SEMANTIC_VERSION and GLIB_SEMANTIC_VERSION from gtk4 branch.

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).
  • src/CMakeLists.txt: fixes issue #283 that was breaking the installation of gtk-fortran in MSYS2.
  • A few other 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 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 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 [email protected]: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.