Script 'mail_helper' called by obssrc Hello community, here is the log from the commit of package amtk for openSUSE:Factory checked in at 2022-06-25 10:24:01 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Comparing /work/SRC/openSUSE:Factory/amtk (Old) and /work/SRC/openSUSE:Factory/.amtk.new.1548 (New) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "amtk" Sat Jun 25 10:24:01 2022 rev:11 rq:984838 version:5.4.1 Changes: -------- --- /work/SRC/openSUSE:Factory/amtk/amtk.changes 2022-05-17 17:24:56.399198525 +0200 +++ /work/SRC/openSUSE:Factory/.amtk.new.1548/amtk.changes 2022-06-25 10:24:09.894665418 +0200 @@ -1,0 +2,8 @@ +Thu Jun 23 10:52:26 UTC 2022 - Dominique Leuenberger <dims...@opensuse.org> + +- Update to version 5.4.1: + + Build system: check if compiler supports --version-script + linker option. + + Documentation improvements. + +------------------------------------------------------------------- Old: ---- amtk-5.4.0.tar.xz New: ---- amtk-5.4.1.tar.xz ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Other differences: ------------------ ++++++ amtk.spec ++++++ --- /var/tmp/diff_new_pack.WX0Eef/_old 2022-06-25 10:24:10.334666046 +0200 +++ /var/tmp/diff_new_pack.WX0Eef/_new 2022-06-25 10:24:10.338666052 +0200 @@ -20,7 +20,7 @@ %define api_ver 5 %define libamtk libamtk-%{api_ver}-0 Name: amtk -Version: 5.4.0 +Version: 5.4.1 Release: 0 Summary: An Actions, Menus and Toolbars Kit License: LGPL-3.0-or-later ++++++ amtk-5.4.0.tar.xz -> amtk-5.4.1.tar.xz ++++++ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/amtk-5.4.0/NEWS new/amtk-5.4.1/NEWS --- old/amtk-5.4.0/NEWS 2022-05-02 14:52:00.000000000 +0200 +++ new/amtk-5.4.1/NEWS 2022-05-25 07:38:19.000000000 +0200 @@ -1,3 +1,8 @@ +News in 5.4.1, 2022-05-25 +------------------------- +* Build system: check if compiler supports --version-script linker option. +* Documentation improvements. + News in 5.4.0, 2022-05-02 ------------------------- * Nothing. diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/amtk-5.4.0/amtk/meson.build new/amtk-5.4.1/amtk/meson.build --- old/amtk-5.4.0/amtk/meson.build 2022-05-02 14:52:00.000000000 +0200 +++ new/amtk-5.4.1/amtk/meson.build 2022-05-25 07:38:19.000000000 +0200 @@ -62,20 +62,16 @@ dependencies: AMTK_DEPS ) -amtk_lib_link_args = [] -amtk_lib_link_depends = [] - -if meson.get_compiler('c').get_argument_syntax() != 'msvc' - symbol_map = meson.current_source_dir() / 'symbol.map' - amtk_lib_link_args = '-Wl,--version-script,' + symbol_map - amtk_lib_link_depends = symbol_map -endif +symbol_map = 'symbol.map' +amtk_lib_link_args = c_compiler.get_supported_link_arguments([ + '-Wl,--version-script,@0@/@1@'.format(meson.current_source_dir(), symbol_map), +]) amtk_lib = library( 'amtk-@0@'.format(AMTK_API_VERSION), dependencies: AMTK_DEPS, link_args: amtk_lib_link_args, - link_depends: amtk_lib_link_depends, + link_depends: symbol_map, # link_whole is not supported with MSVC, so we use extract_all_objects(). objects: amtk_static_lib.extract_all_objects(), version: AMTK_LT_VERSION, diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/amtk-5.4.0/docs/dev-notes new/amtk-5.4.1/docs/dev-notes --- old/amtk-5.4.0/docs/dev-notes 2022-05-02 14:52:00.000000000 +0200 +++ new/amtk-5.4.1/docs/dev-notes 2022-05-25 07:38:19.000000000 +0200 @@ -1,8 +1,5 @@ -Amtk notes -========== - -Possible things to do ---------------------- +Amtk notes - possible things to do or to investigate +==================================================== - When calling amtk_menu_item_set_icon_name(), do not have a large margin on the left. GtkUIManager was able to put the icon without the large margin (in @@ -15,22 +12,33 @@ placeholder). Or create a Placeholder object that contains the list of items, so when the Placeholder object is modified, the menu/toolbar is updated accordingly. + Or, the application can re-generate the whole submenu or a toolbar each time + that it is needed. Or a submenu could be created on-the-fly, upon receiving a + signal to open the submenu (?). In these cases, a full-blown placeholder + mechanism is not needed, but perhaps a few utility functions would help. + A good test-bed for this is the gnome-latex application. - Add one more sanity check: check that a GAction is *implemented* when (or after) creating a menu or toolbar item for that action? Because currently when the GAction is not implemented, the menu/toolbar item is just - insensitive, there is no warning. + insensitive, there is no warning, no way to know if the menu/toolbar item was + set as insensitive explicitly/intentionally or not. - An AmtkActionInfo could have a field for the default AmtkFactoryFlags (or to force some flags). For example setting AMTK_FACTORY_IGNORE_ACCELS_FOR_APP for the tepl-cut/copy/paste/select-all actions. + But it's perhaps a bit messy. - To prevent apps from modifying ActionInfos of libs, maybe seal an ActionInfo when it is added to a store, except for mark_as_used(). But it's maybe a bit - too paranoid. Or instead of sealing, have a builder, see: + too paranoid. Or instead of sealing, have a builder class that creates an + immutable ActionInfo, see: https://blogs.gnome.org/otte/2018/02/03/builders/ - ActionInfo and ActionInfoEntry could have one more field for an identifier, - because when using a detailed GAction name the name is less "greppable" and - less easy to understand. The detailed GAction name would be the equivalent of - the callback in a GtkActionEntry. + because when using a detailed GAction name the name can become a bit hairy + (small tip / side note: to "git grep" it the `--fixed-strings` argument is + needed). The detailed GAction name would be the equivalent of the callback in + a GtkActionEntry. + Because currently, to avoid such hairy names, more GActions need to be + implemented, that can in turn call common functions. diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/amtk-5.4.0/docs/more-information.md new/amtk-5.4.1/docs/more-information.md --- old/amtk-5.4.0/docs/more-information.md 2022-05-02 14:52:00.000000000 +0200 +++ new/amtk-5.4.1/docs/more-information.md 2022-05-25 07:38:19.000000000 +0200 @@ -31,4 +31,6 @@ Development and maintenance --------------------------- -The project is in low-maintenance state. +If you want to see Amtk improved, you are encouraged to contribute. The +maintainer will do its best at reviewing merge requests. However, contributions +need to follow the roadmap of Amtk or the general philosophy of the project. diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/amtk-5.4.0/docs/reference/amtk-docs.xml new/amtk-5.4.1/docs/reference/amtk-docs.xml --- old/amtk-5.4.0/docs/reference/amtk-docs.xml 2022-05-02 14:52:00.000000000 +0200 +++ new/amtk-5.4.1/docs/reference/amtk-docs.xml 2022-05-25 07:38:19.000000000 +0200 @@ -13,6 +13,7 @@ </bookinfo> <xi:include href="amtk-intro.xml"/> + <xi:include href="gradual-porting.xml"/> <part id="api-reference"> <title>Amtk API Reference</title> diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/amtk-5.4.0/docs/reference/amtk-intro.xml new/amtk-5.4.1/docs/reference/amtk-intro.xml --- old/amtk-5.4.0/docs/reference/amtk-intro.xml 2022-05-02 14:52:00.000000000 +0200 +++ new/amtk-5.4.1/docs/reference/amtk-intro.xml 2022-05-25 07:38:19.000000000 +0200 @@ -30,14 +30,20 @@ <link linkend="GtkToolbar">GtkToolbar</link> and a <link linkend="GtkStatusbar">GtkStatusbar</link>). Amtk is now suitable for both a traditional UI and for a new UI with a - <link linkend="GtkHeaderBar">GtkHeaderBar</link> and a ???hamburger menu???. + <link linkend="GtkHeaderBar">GtkHeaderBar</link> and a ???sandwich menu???. </para> <para> With Amtk, menus, toolbars or other objects like <link linkend="GtkShortcutsWindow">GtkShortcutsWindow</link> are created programmatically (not with a *.ui file), but with convenient APIs. The support - for an XML format will maybe be added in the future, contributions welcome. + for an XML format will maybe be added in the future. +</para> + +<para> + Note that the heavy-lifting is still done by GTK of course (and GIO for + <link linkend="GAction">GAction</link>), this library is just a small layer on + top, providing an alternative way of doing things. </para> <refsect1> diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/amtk-5.4.0/docs/reference/gradual-porting.xml new/amtk-5.4.1/docs/reference/gradual-porting.xml --- old/amtk-5.4.0/docs/reference/gradual-porting.xml 1970-01-01 01:00:00.000000000 +0100 +++ new/amtk-5.4.1/docs/reference/gradual-porting.xml 2022-05-25 07:38:19.000000000 +0200 @@ -0,0 +1,59 @@ +<?xml version="1.0"?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" + "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" +[ + <!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'"> + <!ENTITY % gtkdocentities SYSTEM "xml/gtkdocentities.ent"> + %gtkdocentities; +]> + +<refentry id="gradual-porting"> +<refmeta> + <refentrytitle>Gradual Porting</refentrytitle> +</refmeta> + +<refnamediv> + <refname>Gradual Porting</refname> + <refpurpose> + Gradually porting away from <link linkend="GtkAction">GtkAction</link> and + <link linkend="GtkUIManager">GtkUIManager</link>. + </refpurpose> +</refnamediv> + +<para> + Even if you don't want to use Amtk in the end, Amtk can help to gradually move + away from <link linkend="GtkAction">GtkAction</link> and + <link linkend="GtkUIManager">GtkUIManager</link>. +</para> + +<refsect1> + <title>Moving gradually to <link linkend="GAction">GAction</link></title> + <para> + Amtk provides the following functions that can help: + </para> + <itemizedlist> + <listitem> + <para> + <link linkend="amtk-utils-bind-g-action-to-gtk-action">amtk_utils_bind_g_action_to_gtk_action()</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="amtk-utils-create-gtk-action">amtk_utils_create_gtk_action()</link> + </para> + </listitem> + </itemizedlist> +</refsect1> + +<refsect1> + <title>Moving gradually away from <link linkend="GtkUIManager">GtkUIManager</link></title> + <para> + For example if you have already ported a submenu, but not the whole menu, + you can use the + <link linkend="gtk-ui-manager-get-widget">gtk_ui_manager_get_widget()</link> + function to get a <link linkend="GtkMenuItem">GtkMenuItem</link>, and then + set the submenu with + <link linkend="gtk-menu-item-set-submenu">gtk_menu_item_set_submenu()</link>. + </para> +</refsect1> +</refentry> diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/amtk-5.4.0/docs/reference/meson.build new/amtk-5.4.1/docs/reference/meson.build --- old/amtk-5.4.0/docs/reference/meson.build 2022-05-02 14:52:00.000000000 +0200 +++ new/amtk-5.4.1/docs/reference/meson.build 2022-05-25 07:38:19.000000000 +0200 @@ -30,6 +30,7 @@ ], content_files: [ 'amtk-intro.xml', + 'gradual-porting.xml', ], install: true ) diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/amtk-5.4.0/docs/roadmap.md new/amtk-5.4.1/docs/roadmap.md --- old/amtk-5.4.0/docs/roadmap.md 1970-01-01 01:00:00.000000000 +0100 +++ new/amtk-5.4.1/docs/roadmap.md 2022-05-25 07:38:19.000000000 +0200 @@ -0,0 +1,7 @@ +Amtk roadmap +============ + +- See the dev-notes file for possible tasks. + +- Port to GTK 4, see if creating a traditional UI with GTK 4 is still (easily) + possible. If some features are missing wrt GTK 3, fill the gap. diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/amtk-5.4.0/meson.build new/amtk-5.4.1/meson.build --- old/amtk-5.4.0/meson.build 2022-05-02 14:52:00.000000000 +0200 +++ new/amtk-5.4.1/meson.build 2022-05-25 07:38:19.000000000 +0200 @@ -6,7 +6,7 @@ project( 'amtk', 'c', meson_version: '>= 0.53', - version: '5.4.0', + version: '5.4.1', default_options: ['warning_level=2'] )