[nautilus-actions/file-manager-actions] Misc doc updates



commit f278a8f870ea449a7f69e7aee911cedefe97fef3
Author: Pierre Wieser <pwieser trychlos org>
Date:   Sun Nov 1 18:59:10 2015 +0100

    Misc doc updates

 TODO                      |  304 ++++++++++++++++++++++++++++----------------
 docs/README               |   11 +--
 fma_required_versions     |    6 +-
 maintainer/run-autogen.sh |    7 -
 4 files changed, 197 insertions(+), 131 deletions(-)
---
diff --git a/TODO b/TODO
index e5f0eb8..279aa9a 100644
--- a/TODO
+++ b/TODO
@@ -1,114 +1,103 @@
-TODO
-====
-
-- have all TODOs go to gnome bugzilla
-- update the supported environments
-- review the packaging rules
- (with or without gtk2, with or without gconf, ith or without doc, with which doc tool)
-
-N-A BUGS
-========
-- 2011-11-15: an action with one profile - if the action has a property set to empty
-  'folders=' and the profile does not have the property set, then set_defaults on the
-  profile set the default property (here, 'folders=/') instead of taking the action
-  value. On the UI, updating an action's property means updating the current profile.
-  This is ok as long as the action is also set  (...) there is one profile and the
-  action's property was not the default
-
-- 2011-11-28 import assistant: intro label should be wrappable
-
-- 2011-11-28 import assistant: importer ask format; long descriptions
-  should be a long wrappable line
-
-- 2011-11-28 have a padding (6) on top of gtkfilechooser (import & export assistants)
-  not gtk3 : gtk2 only
-
-- 2011-11-28 already existing item when importing should keep the same size
-  between invocations
-  2011-11-30 this is ok on f14 f16 ubu10 and almost on ubu11
-  (ubu11): z-order is ok the first time, but comes back to the previous
-  behavior starting with the second time (maybe a theme problem ?)
-
-- 2011-12-06: after unsuccessfully tried to import via dnd:
-   Gtk-CRITICAL **: gtk_tree_view_scroll_to_cell: assertion `tree_view->priv->tree != NULL' failed
-
-- 2011-12-22 export assistant
-  when exporting a menu, only desktop format is available ?
-
-Plan de test: NACT should be able to import all types of actions and menus,
-kindly fixing small errors.
-- for each and every released version, have an example of each available export format
-  with lists of items and at least two profiles if feature is available
-
-- 2011-12-22 export assistant
-  the items list should it be presented as a flat list ? or as an expanded one ?
-
-- 2012-01-12 environment tab
-  in the list of desktop checkboxes, the item which is not grayed is that which
-  would be selected if the list would be active -> but should be grayed
-  vubuntu10: exhibits the bug
-  fedora14, fedora16, vubuntu11: ok
-
-- 2012-01-16: (LXDE) unable to drag and drop to PcmanFM
-  na_core_utils_dir_is_writable_uri( "/tmp" ): is_writable=False
-  and desktop hangs
-
-- 2012-01-29: na-icontext.c:is_candidate_for_show_if_registered()
-  implement GDBus
-
-- 2012-01-29: NactTreeModel is not released at end when dnd
-
-- 2012-02-14: opening the menubar triggers the on_tree_view_focus_out, thus disabling
-  the edit items (this is not the desired behavior when we access a menu)
-  Fedora14: OK
-  Fedora16: bug exhibits
-  Ubuntu10: OK
-  Ubuntu11: bug exhibits
-  This may have something to do with the way we manage the GtkActions
-  Also see glade source.
-
-Plan de test: NACT should be able to import all types of actions and menus,
-kindly fixing small errors.
-- for each and every released version, have an example of each available export format
-  with lists of items and at least two profiles if feature is available
-
-- 20120625: unable to build NA-3.2.2 on Ubuntu 8 LTS
-       not even find GTK 2/3 libraries
-
-- 20120625: ubuntu 12 requires libtool (+ autotools-dev libltdl-dev)
-- 20120625: ubuntu 12 requires intltool (+ autoconf automake gettext libencode-locale-perl 
libfile-listing-perl
-  libfont-afm-perl libgettextpo0 libhtml-form-perl libhtml-format-perl
-  libhtml-parser-perl libhtml-tagset-perl libhtml-tree-perl
-  libhttp-cookies-perl libhttp-daemon-perl libhttp-date-perl
-  libhttp-message-perl libhttp-negotiate-perl libio-socket-inet6-perl
-  libio-socket-ssl-perl liblwp-mediatypes-perl liblwp-protocol-https-perl
-  libmailtools-perl libnet-http-perl libnet-ssleay-perl libsocket6-perl
-  libtimedate-perl libunistring0 liburi-perl libwww-perl
-  libwww-robotrules-perl libxml-parser-perl m4 patch)
-
-- 20121019: the last commit - to disable xml2po usage - has introduced a regression:
-  target are evaluated even if not built (and so there is an error if we do not know
-  any prerequisites)
-  reproduce by building from an empty tree with --disable-manuals
-
-TODO
-====
-- 2011-02-21: implement startup mode
-
-- 2011-02-21: implement execute as user
-
-- 2010-06-17: implement shortcut button in NactIPropertiesTab page
-
-- 2010-08-09: in v1.x until ??, %f used to be the basename!!
-
-- 2010-12-30: gtk-doc 1.15
-  "Use of uninitialized value within %DeclarationTypes in lc at /usr/bin/gtkdoc-mkdb line 929"
-  when building XML
-
-- 2011-02-07: is_level_zero_writable: should be monitored
-  for now, is only evaluated when NAUpdater is instanciated
-
-- 2011-02-07: are_preferences_locked: should be monitored
+FileManager-Actions - TODO
+
+ Summary
+ =======
+
+   TODO
+   DONE
+
+-----------------------------------------------------------------------
+ TODO
+ ====
+
+   2 2011-11-28 import assistant: intro label should be wrappable
+
+   3 2011-11-28 import assistant: importer ask format; long descriptions
+                should be a long wrappable line
+
+   4 2011-11-28 have a padding (6) on top of gtkfilechooser (import &
+                export assistants) not gtk3 : gtk2 only
+
+   5 2011-11-28 already existing item when importing should keep the same
+                size between invocations
+     2011-11-30 this is ok on f14 f16 ubu10 and almost on ubu11
+                (ubu11): z-order is ok the first time, but comes back to
+                the previous behavior starting with the second time
+                (maybe a theme problem ?)
+
+   6 2011-12-06 after unsuccessfully tried to import via dnd:
+                Gtk-CRITICAL **: gtk_tree_view_scroll_to_cell:
+                assertion `tree_view->priv->tree != NULL' failed
+
+   7 2011-12-22 export assistant
+                when exporting a menu, only desktop format is available
+
+   8 2011-12-22 export assistant
+                the items list should it be presented as a flat list ?
+                or as an expanded one ?
+
+   9 2012-01-12 environment tab
+                in the list of desktop checkboxes, the item which is not
+                grayed is that which would be selected if the list would
+                be active -> but should be grayed
+                vubuntu10: exhibits the bug
+                fedora14, fedora16, vubuntu11: ok
+
+  10 2012-01-16 LXDE: unable to drag and drop to PcmanFM
+                na_core_utils_dir_is_writable_uri( "/tmp" ):
+                is_writable=False
+                and desktop hangs
+
+  11 2012-01-29 na-icontext.c:is_candidate_for_show_if_registered()
+                implement GDBus
+
+  12 2012-01-29: NactTreeModel is not released at end when dnd
+
+  13 2012-02-14 opening the menubar triggers the on_tree_view_focus_out,
+                thus disabling the edit items (this is not the desired
+                behavior when we access a menu)
+                Fedora14: OK
+                Fedora16: bug exhibits
+                Ubuntu10: OK
+                Ubuntu11: bug exhibits
+                This may have something to do with the way we manage the
+                GtkActions
+                Also see glade source.
+
+  15 2012- 6-25 ubuntu 12 requires libtool (+ autotools-dev libltdl-dev)
+                20120625: ubuntu 12 requires intltool (+ autoconf automake
+                gettext libencode-locale-perl libfile-listing-perl
+                libfont-afm-perl libgettextpo0 libhtml-form-perl libhtml-format-perl
+                libhtml-parser-perl libhtml-tagset-perl libhtml-tree-perl
+                libhttp-cookies-perl libhttp-daemon-perl libhttp-date-perl
+                libhttp-message-perl libhttp-negotiate-perl libio-socket-inet6-perl
+                libio-socket-ssl-perl liblwp-mediatypes-perl liblwp-protocol-https-perl
+                libmailtools-perl libnet-http-perl libnet-ssleay-perl libsocket6-perl
+                libtimedate-perl libunistring0 liburi-perl libwww-perl
+                libwww-robotrules-perl libxml-parser-perl m4 patch)
+
+  16 2012-10-19 the last commit - to disable xml2po usage - has introduced
+                a regression
+                target are evaluated even if not built (and so there is an
+                error if we do not know any prerequisites)
+                reproduce by building from an empty tree with --disable-manuals
+
+  17 2011- 2-21 implement startup mode
+
+  18 2011- 2-21 implement execute as user
+
+  19 2010- 6-17 implement shortcut button in NactIPropertiesTab page
+
+  20 2010- 8- 9 in v1.x until ??, %f used to be the basename!!
+
+  21 2010-12-30 gtk-doc 1.15
+                "Use of uninitialized value within %DeclarationTypes in
+                lc at /usr/bin/gtkdoc-mkdb line 929" when building XML
+
+  22 2011- 2- 7 is_level_zero_writable: should be monitored
+                for now, is only evaluated when NAUpdater is instanciated
+
+  23 2011-02-07: are_preferences_locked: should be monitored
   for now, is only evaluated when NAUpdater is instanciated
 
 - 2011-02-12: should we have a NAKeyFile shared between i/o-desktop and settings ?
@@ -182,6 +171,99 @@ TODO
   --enable-gconf is auto
 
 - 2013- 9- 2: shouldn't check and require GConf if --disable-gconf
+xxxx 2014- 2-25 see if uuid is always relevant
+
+xxxx 2014- 2-25 NAUTILUS_ACTIONS_DEBUG: is it useful ?
+
+xxxx 2014- 4-29 base_gtk_utils_get_pixbuf: listen for icon theme changes
+
+xxxx 2014- 4-30 base-assistant/dialog/window shouldn't include
+                nact-application.h to have NACT_EXIT_CODE
+
+xxxx 2014- 5- 4 we (should) now have GDBus: get rid of HAVE_GDBUS and
+                HAVE_DBUS_GLIB conditionals
+
+xxxx 2014- 5- 4 fix docs generation, reviewing what must the options be
+
+xxxx 2014- 5- 4 restore menu item tooltips
+
+xxxx 2014- 5- 7 use GResource
+
+xxxx 2014- 5-11 Get rid of base_window_signal_xxx family
+
+xxxx 2014- 6- 2 base_gtk_utils_widget_set_color: to be written
+
+xxxx 2014- 6- 2 get rid of deprecated GtkAlignment
+
+xxxx 2014- 6- 4 use composite widget (template)
+
+xxxx 2015- 9- 7 review Preferences dialog box
+
+xxxx 2015- 9- 9 nautilus/nemo: have file_manager_file_info_create_for_uri ?
+                would replace FMASelectedInfo class
+
+xxxx 2015- 9-10 remove all GConf stuff:
+                - io-gconf i/o provider
+                - fma-print-schemas
+                - gconf-migration code
+
+xxxx 2015- 9-10 add json import/export
+
+xxxx 2015- 9-10 element formalpara: validity error : Element formalpara
+                content does not follow the DTD, expecting 
+                (title , indexterm* , para), got (title para para )
+
+xxxx 2015- 9-10 use AX_COMPILER_FLAGS
+
+xxxx 2015- 9-10 use AM_GNU_GETTEXT instead of AM_GLIB_GNU_GETTEXT
+
+xxxx 2015- 9-10 xmllint --noout --noent --path C:../../../../docs/user-manual/C --xinclude --postvalid 
../../../../docs/user-manual/C/fma-config-tool.xml
+                document does not validate
+
+xxxx 2015- 9-11 replace FMADataFactory with GVariant ?
+
+xxxx 2015- 9-11 replace fma_required_versions with a JSON file with some
+                perl snippets to transform for configure.ac and 
+                maintainer/run-autogen.sh
+
+xxxx 2015- 9-17 gtk-doc: usage of templates is deprecated
+
+xxxx 2015- 9-21 instead of:
+                  whether GConf is required... no
+                have:
+                  whether GConf is enabled... auto
+                  whether GConf is available... no|yes
+
+-----------------------------------------------------------------------
+ DONE
+ ====
+
+   1 2011-11-15 an action with one profile - if the action has a property
+                set to empty 'folders=' and the profile does not have the
+                property set, then set_defaults on the profile set the
+                default property (here, 'folders=/') instead of taking
+                the action value. On the UI, updating an action's property
+                means updating the current profile. This is ok as long as
+                the action is also set  (...) there is one profile and the
+                action's property was not the default
+     2015- 9-21 ok (obsolete) as of 3.4
+
+  14 2012- 6-25 unable to build NA-3.2.2 on Ubuntu 8 LTS
+                   not even find GTK 2/3 libraries
+        2015- 9-21 ok (obsolete) as of 3.4
+
+-----------------------------------------------------------------------
+ P. Wieser - Created on 2010, june 15th
+             Last updated on 2015, sept. 21st
+
+
+N-A BUGS
+========
+
+Plan de test: NACT should be able to import all types of actions and menus,
+kindly fixing small errors.
+- for each and every released version, have an example of each available export format
+  with lists of items and at least two profiles if feature is available
 
 N-A ENHANCEMENTS
 ================
diff --git a/docs/README b/docs/README
index 62f55db..dac0d69 100644
--- a/docs/README
+++ b/docs/README
@@ -7,14 +7,7 @@ main parts:
 - the FileManager-Actions Configuration Tool User's Manual.
 
 All the documentation, whether it targets users or developers, is made
-of architecture-independent files. More it needs some rather special
-tools to be built (msgfmt, xml2po, db2html, dblatex, Docbook
-stylesheets, and so on).
-So we want distribute it.
-
-There are so in the Makefiles some hacks so that:
-a) the built objects are distributed
-b) the distributed objects are installed without requiring to be
-   rebuilt.
+of architecture-independent files, and so default to be included in the
+distributed tarball.
 
 P. Wieser, last updated on sept. 2015
diff --git a/fma_required_versions b/fma_required_versions
index 8549177..d9922f1 100644
--- a/fma_required_versions
+++ b/fma_required_versions
@@ -12,19 +12,17 @@ REQUIRED_INTLTOOL_VERSION=${intltool_required}
 # distribution                       release date  end of life  GLib     Gtk+    Nautilus  Nemo
 # ---------------------------------  ------------  -----------  -------  ------  --------  -----
 # https://en.wikipedia.org/wiki/Debian
-# Debian 7.0 Wheezy                  2013-05-04    2018-05      2.33.12  3.4.2
 # Debian 8.0 Jessie                  2015-04-25    2020-05      2.42.1   3.14.5
 # https://en.wikipedia.org/wiki/List_of_Fedora_releases
 # Fedora 21                          2014-12-09   [2016-06]     2.42.1   3.14.9  3.14
-# Fedora 22                          2015-05-26   [2017-01]                      3.16.2    2.6.7
+# Fedora 22                          2015-05-26   [2017-01]     2.44.1   3.16.6  3.16.2    2.6.7
 # https://en.wikipedia.org/wiki/List_of_Ubuntu_releases
-# Ubuntu 12.04 LTS Precise Pangolin  2012-04-26    2017-04-26   2.32.1   3.4.2
 # Ubuntu 14.04 LTS Trusty Thar       2014-04-17    2019-04      2.40.0   3.10.8
 # Ubuntu 15.04 Vivid Vervet          2015-04-23    2016-01
 
 glib_required=2.32.1
 gtop_required=2.23.1
-gtk_required=3.4.2
+gtk_required=3.10
 xml_required=2.6
 
 # File-managers
diff --git a/maintainer/run-autogen.sh b/maintainer/run-autogen.sh
index 53e3ec9..521f64e 100755
--- a/maintainer/run-autogen.sh
+++ b/maintainer/run-autogen.sh
@@ -92,13 +92,6 @@ gtkdocize || exit 1
 echo "> Running autoreconf"
 autoreconf --verbose --force --install -Wno-portability || exit 1
 
-# pwi 2012-10-12
-# starting with FileManager-Actions 3.2.3, we let the GNOME-DOC-PREPARE do
-# its stuff, but get rid of the gnome-doc-utils.make standard file, as
-# we are using our own hacked version
-# (see full rationale in docs/nact/gnome-doc-utils-na.make)
-#rm -f gnome-doc-utils.make
-
 runconf="${top_srcdir}/run-configure.sh"
 echo "> Generating ${runconf}"
 cat <<EOF >${runconf}


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]