[nautilus-actions/file-manager-actions] docs/user-manual: generate user's manual
- From: Pierre Wieser <pwieser src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [nautilus-actions/file-manager-actions] docs/user-manual: generate user's manual
- Date: Thu, 10 Sep 2015 10:25:39 +0000 (UTC)
commit 3ed4e538c25a7c075e8d85d1aa830d78879d9e60
Author: Pierre Wieser <pwieser trychlos org>
Date: Wed Sep 9 22:15:46 2015 +0200
docs/user-manual: generate user's manual
though many messages 'validity error : ID already defined'..
Makefile.am | 6 +-
configure.ac | 2 +-
docs/README | 3 +-
docs/user-manual/C/articleinfo.xml | 19 ++-
docs/user-manual/C/fma-bugs.xml | 19 +-
docs/user-manual/C/fma-conditions.xml | 53 +++--
docs/user-manual/C/fma-config-tool.xml | 93 ++++---
docs/user-manual/C/fma-execution.xml | 36 ++--
docs/user-manual/C/fma-menus.xml | 2 +-
docs/user-manual/C/fma-misc.xml | 2 +-
docs/user-manual/C/fma-prefs.xml | 32 ++--
docs/user-manual/C/fma-profiles.xml | 2 +-
docs/user-manual/C/fma-properties.xml | 4 +-
docs/user-manual/C/fma-sorting.xml | 2 +-
docs/user-manual/C/fma-starting.xml | 44 ++--
docs/user-manual/C/fma-where.xml | 26 +-
docs/user-manual/C/legalnotice.xml | 2 +-
docs/user-manual/Makefile.am | 450 --------------------------------
maintainer/run-autogen.sh | 1 +
19 files changed, 193 insertions(+), 605 deletions(-)
---
diff --git a/Makefile.am b/Makefile.am
index 39b0cc6..1d711ba 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -27,14 +27,15 @@
ACLOCAL_AMFLAGS = -I m4
+# src/ must be built before maintainer/
SUBDIRS = \
data \
docs \
m4 \
+ src \
maintainer \
icons \
po \
- src \
$(NULL)
# - nautilus-extdir is a foo directory so that make distcheck has a vpath
@@ -46,7 +47,8 @@ SUBDIRS = \
# - GNOME_DOC_DEFINES tries to disable scrollkeeper, but the set is
# overriden but this one
DISTCHECK_CONFIGURE_FLAGS = \
- --with-nautilus-extdir='$${libdir}/nautilus/extensions-2.0-distcheck' \
+ --with-nautilus-extdir='$${libdir}/nautilus/extensions-3.0-distcheck' \
+ --with-nemo-extdir='$${libdir}/nemo/extensions-3.0-distcheck' \
--enable-silent-rules \
--enable-as-needed \
--disable-scrollkeeper \
diff --git a/configure.ac b/configure.ac
index b32cd1e..d6cd753 100644
--- a/configure.ac
+++ b/configure.ac
@@ -29,7 +29,7 @@ AC_PREREQ([2.53])
AC_INIT([FileManager-Actions],[3.4],[maintainer nautilus-actions org],,[http://www.nautilus-actions.org])
-m4_ifdef([AM_SILENT_RULES], [AM_SILENT_RULES([yes])])
+#m4_ifdef([AM_SILENT_RULES], [AM_SILENT_RULES([yes])])
AC_CANONICAL_TARGET
AM_INIT_AUTOMAKE
diff --git a/docs/README b/docs/README
index b6767b3..62f55db 100644
--- a/docs/README
+++ b/docs/README
@@ -8,7 +8,8 @@ main parts:
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 (db2html, dblatex, Docbook stylesheets, and so on).
+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:
diff --git a/docs/user-manual/C/articleinfo.xml b/docs/user-manual/C/articleinfo.xml
index 369b22e..ffbb013 100644
--- a/docs/user-manual/C/articleinfo.xml
+++ b/docs/user-manual/C/articleinfo.xml
@@ -7,12 +7,13 @@
<year>2012</year>
<year>2013</year>
<year>2014</year>
+ <year>2015</year>
<holder>Pierre Wieser</holder>
</copyright>
<abstract role="description">
<para>
- &prodname; is a &nautilus; extension whose principal function
+ &prodname; is a file manager extension whose principal function
is to allow the user to add arbitrary actions to the file manager
context menus. These actions may be organized in menus and submenus,
exported and shared with other desktop environments.
@@ -22,6 +23,10 @@
you may configure your menus and actions, making them be displayed
and applied depending on specific conditions.
</para>
+ <para>
+ Starting with its 3.4 version, &prodname; is compatible with both
+ &nautilus; and &nemo; Gnome file-managers.
+ </para>
</abstract>
<releaseinfo revision="&manrevision;" role="stub">
@@ -93,8 +98,18 @@
</para>
</revdescription>
</revision>
+ <revision>
+ <revnumber>&appnamex; User's Manual v 3.4</revnumber>
+ <date>September 2015</date>
+ <revdescription>
+ <para role="author">
+ Pierre Wieser
+ <email>pwieser trychlos org</email>
+ </para>
+ </revdescription>
+ </revision>
</revhistory>
- &legalnotice;
+ &elegalnotice;
</articleinfo>
diff --git a/docs/user-manual/C/fma-bugs.xml b/docs/user-manual/C/fma-bugs.xml
index 7ab2f0e..e48e64c 100644
--- a/docs/user-manual/C/fma-bugs.xml
+++ b/docs/user-manual/C/fma-bugs.xml
@@ -2,12 +2,12 @@
<title>Known bugs</title>
<para>
Known bugs are available on
- <ulink
url="https://bugzilla.gnome.org/buglist.cgi?product=nautilus-actions&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED";
type="http">Bugzilla summary page</ulink>.
+ <ulink
url="https://bugzilla.gnome.org/buglist.cgi?product=filemanager-actions&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED";
type="http">Bugzilla summary page</ulink>.
</para>
<para>
If you find some new bug in &prodname;, you are welcome to open it by pointing
your favorite browser to
- <ulink url="https://bugzilla.gnome.org/enter_bug.cgi?product=nautilus-actions"; type="http">Bugzilla web
site</ulink>.
+ <ulink url="https://bugzilla.gnome.org/enter_bug.cgi?product=filemanager-actions"; type="http">Bugzilla
web site</ulink>.
</para>
<formalpara>
@@ -28,7 +28,7 @@
<title>Execution mode</title>
<para>
As of version 3.0, execution mode may be configured in &appname; but is
- not yet honored by &nautilus; plugin.
+ not yet honored by known file-managers.
</para>
</formalpara>
<para>
@@ -40,7 +40,12 @@
<title>Suggested shortcut</title>
<para>
As of version 3.0, suggested shortcut, as described in &desema; cannot be
- configured in &appname;, and is not honored by &nautilus; plugin.
+ configured in &appname;, and is not honored by the menu plugin.
+ </para>
+ <para>
+ But, thanks to the tracker plugin, you are always able to define a shortcut
+ at the desktop level, assigning this shortcut to the fma-run program, making
+ it execute the action of your choice.
</para>
</formalpara>
@@ -48,11 +53,7 @@
<title>Menu separator</title>
<para>
As of version 3.0, menu separators cannot be
- configured in &appname;, and are not honored by &nautilus; plugin.
+ configured in &appname;, and are not honored by any known file-managers.
</para>
</formalpara>
- <para>
- One has to note that, for now, &nautilus; file manager does not
- allow its plugins to define separators in the context menu.
- </para>
</sect2>
\ No newline at end of file
diff --git a/docs/user-manual/C/fma-conditions.xml b/docs/user-manual/C/fma-conditions.xml
index e0a3ee4..7b7ecf1 100644
--- a/docs/user-manual/C/fma-conditions.xml
+++ b/docs/user-manual/C/fma-conditions.xml
@@ -1,7 +1,7 @@
<sect2 id="usage-conditions">
<title>Defining the conditions</title>
<para>
- Whether your action will eventually be displayed in &nautilus; file manager
+ Whether your action will eventually be displayed in the file manager
context menus or in its toolbar depends on the conditions you will have
defined for it.
</para>
@@ -15,6 +15,13 @@
against the new location and selection: all defined conditions must
be satisfied in order your action be actually displayed.
</para>
+ <note>
+ <para>
+ For now, all managed file managers have removed this API from their
+ extension library. The toolbar is still configurable in &prodname;,
+ but is will not be honored by any of the targeted file managers.
+ </para>
+ </note>
<sect3 id="usage-conditions-basenames">
<title>Basename-based conditions</title>
@@ -29,12 +36,12 @@
Click on the <guilabel>Basenames</guilabel> tab to show the page
which will permit you to configure your basename-based conditions.
</para>
- <figure id="nact-FIG-tab-basenames">
+ <figure id="fma-FIG-tab-basenames">
<title>Basename-based conditions</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-basenames-tab.png" format="PNG" />
+ <imagedata fileref="figures/fma-basenames-tab.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Shows the tab which lets you define basename-based conditions.</phrase>
@@ -173,12 +180,12 @@
Click on the <guilabel>Mimetypes</guilabel> tab to show the page
which will permit you to configure your mimetype-based conditions.
</para>
- <figure id="nact-FIG-tab-mimetypes">
+ <figure id="fma-FIG-tab-mimetypes">
<title>Mimetype-based conditions</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-mimetypes-tab.png" format="PNG"/>
+ <imagedata fileref="figures/fma-mimetypes-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Shows the tab which lets you define mimetype-based conditions.</phrase>
@@ -361,12 +368,12 @@
Click on the <guilabel>Folders</guilabel> tab to show the page
which will permit you to configure your folder-based conditions.
</para>
- <figure id="nact-FIG-tab-folders">
+ <figure id="fma-FIG-tab-folders">
<title>Folder-based conditions</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-folders-tab.png" format="PNG"/>
+ <imagedata fileref="figures/fma-folders-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Shows the tab which lets you define folder-based conditions.</phrase>
@@ -486,12 +493,12 @@
Click on the <guilabel>Schemes</guilabel> tab to show the page
which will permit you to configure your scheme-based conditions.
</para>
- <figure id="nact-FIG-tab-schemes">
+ <figure id="fma-FIG-tab-schemes">
<title>Scheme-based conditions</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-schemes-tab.png" format="PNG"/>
+ <imagedata fileref="figures/fma-schemes-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Shows the tab which lets you define scheme-based conditions.</phrase>
@@ -564,12 +571,12 @@
<guimenuitem>Preferences</guimenuitem>
</menuchoice>.
</para>
- <figure id="nact-FIG-add-scheme">
+ <figure id="fma-FIG-add-scheme">
<title>Selecting a scheme among predefined defaults</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-new-scheme.png" format="PNG"/>
+ <imagedata fileref="figures/fma-new-scheme.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Show the list of predefined schemes.</phrase>
@@ -642,12 +649,12 @@
Click on the <guilabel>Capabilities</guilabel> tab to show the page
which will permit you to configure your capability-based conditions.
</para>
- <figure id="nact-FIG-tab-capabilities">
+ <figure id="fma-FIG-tab-capabilities">
<title>Capability-based conditions</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-capabilities-tab.png" format="PNG"/>
+ <imagedata fileref="figures/fma-capabilities-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Shows the tab which lets you define capability-based conditions.</phrase>
@@ -709,12 +716,12 @@
to open the <guilabel>Adding a new capability</guilabel> dialog
box.
</para>
- <figure id="nact-FIG-add-capability">
+ <figure id="fma-FIG-add-capability">
<title>Managed capabilities</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-new-capability.png" format="PNG"/>
+ <imagedata fileref="figures/fma-new-capability.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Shows the list of managed capabilities.</phrase>
@@ -786,12 +793,12 @@
page which will permit you to configure your environment-based
conditions.
</para>
- <figure id="nact-FIG-tab-environment">
+ <figure id="fma-FIG-tab-environment">
<title>Environment-based conditions</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-environment-tab.png" format="PNG"/>
+ <imagedata fileref="figures/fma-environment-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>
@@ -811,12 +818,12 @@
<!-- i18n: "Appears if selection contains" is a UI label -->
<guilabel>Appears if selection contains</guilabel> frame.
</para>
- <figure id="nact-FIG-frame-count">
+ <figure id="fma-FIG-frame-count">
<title>Selection count condition frame</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-selection-count-frame.png" format="PNG"/>
+ <imagedata fileref="figures/fma-selection-count-frame.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>
@@ -905,12 +912,12 @@
<!-- i18n: "Desktop environment" is a UI label -->
<guilabel>Desktop environment</guilabel> frame.
</para>
- <figure id="nact-FIG-frame-desktop">
+ <figure id="fma-FIG-frame-desktop">
<title>Desktop selection frame</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-desktop-environment-frame.png" format="PNG"/>
+ <imagedata fileref="figures/fma-desktop-environment-frame.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>
@@ -976,12 +983,12 @@
<!-- i18n: "Execution environment" is a UI label -->
<guilabel>Execution environment</guilabel> frame.
</para>
- <figure id="nact-FIG-frame-execution-environment">
+ <figure id="fma-FIG-frame-execution-environment">
<title>Execution environment frame</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-execution-environment-frame.png" format="PNG"/>
+ <imagedata fileref="figures/fma-execution-environment-frame.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>
diff --git a/docs/user-manual/C/fma-config-tool.xml b/docs/user-manual/C/fma-config-tool.xml
index 22f3c40..151c9cc 100644
--- a/docs/user-manual/C/fma-config-tool.xml
+++ b/docs/user-manual/C/fma-config-tool.xml
@@ -3,16 +3,17 @@
<!-- name and version of the application -->
<!ENTITY prodname "<productname>FileManager-Actions</productname>">
- <!ENTITY appnamex "FileManager-Actions Configuration Tool">
+ <!ENTITY appnamex "FileManager-Actions configuration tool">
<!ENTITY appname "<application>&appnamex;</application>">
- <!ENTITY appversion "3.2">
+ <!ENTITY appversion "3.4">
<!-- revision number and release date of this manual -->
- <!ENTITY manrevision "3.2">
- <!ENTITY mandate "January 2012">
+ <!ENTITY manrevision "3.4">
+ <!ENTITY mandate "September 2015">
<!-- product name used -->
<!ENTITY nautilus "<productname>Nautilus</productname>">
+ <!ENTITY nemo "<productname>Nemo</productname>">
<!ENTITY windows "<productname>Windows</productname>">
<!ENTITY zenity "<productname>Zenity</productname>">
@@ -30,24 +31,24 @@
<!ENTITY must_not_match "«sp;must not match any of&spraquo;">
<!-- the synopsys of the document -->
- <!ENTITY articleinfo SYSTEM "articleinfo.xml">
- <!ENTITY legalnotice SYSTEM "legalnotice.xml">
- <!ENTITY starting SYSTEM "nact-starting.xml">
- <!ENTITY conditions SYSTEM "nact-conditions.xml">
- <!ENTITY where SYSTEM "nact-where.xml">
- <!ENTITY execution SYSTEM "nact-execution.xml">
- <!ENTITY profiles SYSTEM "nact-profiles.xml">
- <!ENTITY menus SYSTEM "nact-menus.xml">
- <!ENTITY sorting SYSTEM "nact-sorting.xml">
- <!ENTITY edit SYSTEM "nact-edit.xml">
- <!ENTITY save SYSTEM "nact-save.xml">
- <!ENTITY export SYSTEM "nact-export.xml">
- <!ENTITY import SYSTEM "nact-import.xml">
- <!ENTITY preferences SYSTEM "nact-prefs.xml">
- <!ENTITY properties SYSTEM "nact-properties.xml">
- <!ENTITY misc-infos SYSTEM "nact-misc.xml">
- <!ENTITY bugs SYSTEM "nact-bugs.xml">
- <!ENTITY gnu-fdl SYSTEM "appendix-gnu-fdl-1.3.xml">
+ <!ENTITY earticleinfo SYSTEM "articleinfo.xml">
+ <!ENTITY elegalnotice SYSTEM "legalnotice.xml">
+ <!ENTITY estarting SYSTEM "fma-starting.xml">
+ <!ENTITY econditions SYSTEM "fma-conditions.xml">
+ <!ENTITY ewhere SYSTEM "fma-where.xml">
+ <!ENTITY eexecution SYSTEM "fma-execution.xml">
+ <!ENTITY eprofiles SYSTEM "fma-profiles.xml">
+ <!ENTITY emenus SYSTEM "fma-menus.xml">
+ <!ENTITY esorting SYSTEM "fma-sorting.xml">
+ <!ENTITY eedit SYSTEM "fma-edit.xml">
+ <!ENTITY esave SYSTEM "fma-save.xml">
+ <!ENTITY eexport SYSTEM "fma-export.xml">
+ <!ENTITY eimport SYSTEM "fma-import.xml">
+ <!ENTITY epreferences SYSTEM "fma-prefs.xml">
+ <!ENTITY eproperties SYSTEM "fma-properties.xml">
+ <!ENTITY emisc-infos SYSTEM "fma-misc.xml">
+ <!ENTITY ebugs SYSTEM "fma-bugs.xml">
+ <!ENTITY egnu-fdl SYSTEM "appendix-gnu-fdl-1.3.xml">
]>
<!-- ========================= Document Header ======================== -->
@@ -56,12 +57,15 @@
<article id="index" lang="en">
- &articleinfo;
+ &earticleinfo;
<indexterm zone="index">
<primary>&nautilus;</primary>
</indexterm>
<indexterm zone="index">
+ <primary>&nemo;</primary>
+ </indexterm>
+ <indexterm zone="index">
<primary>&prodname;</primary>
</indexterm>
@@ -73,14 +77,15 @@
<sect1 id="introduction">
<title>Introduction</title>
<para>
- &prodname; is a &nautilus; extension whose principal function
+ &prodname; is a file manager extension whose principal function
is to allow the user to add arbitrary actions to the file manager
context menus. These actions may be organized in menus and submenus,
exported and shared with other desktop environments.
</para>
<para>
The &appname; application is the user interface which lets you precisely
- configure how, where and when your actions should appear in &nautilus;
+ configure how, where and when your actions should appear in the file
+ manager
context menus, and how they will be executed.
</para>
<para>
@@ -104,7 +109,7 @@
<itemizedlist>
<listitem>
<para>
- A &nautilus; plugin which exports in real time to D-Bus the currently
+ A tracker plugin which exports in real time to D-Bus the currently
selected files.
</para>
</listitem>
@@ -129,6 +134,10 @@
&prodname; documentation.
</para>
</note>
+ <para>
+ Starting with the version 3.4, &prodname; is compatible with both
+ &nautilus; and &nemo; file-managers.
+ </para>
</sect1>
<!-- ========================= Getting Started ======================== -->
@@ -142,7 +151,7 @@
<sect1 id="getting-started">
<title>Getting Started</title>
- &starting;
+ &estarting;
</sect1>
<!-- ============================== Usage ============================= -->
@@ -151,17 +160,17 @@
<sect1 id="usage">
<title>Using &appname;</title>
- &conditions;
- &where;
- &execution;
- &profiles;
- &menus;
- &sorting;
- &edit;
- &save;
- &export;
- &import;
- &preferences;
+ &econditions;
+ &ewhere;
+ &eexecution;
+ &eprofiles;
+ &emenus;
+ &esorting;
+ &eedit;
+ &esave;
+ &eexport;
+ &eimport;
+ &epreferences;
</sect1>
<!-- ============================ Misc ================================ -->
@@ -169,7 +178,7 @@
<sect1 id="misc">
<title>Miscellaneous informations</title>
- &misc-infos;
+ &emisc-infos;
</sect1>
<!-- ============================ Bugs ================================ -->
@@ -180,7 +189,7 @@
<sect1 id="bugs">
<title>Known Bugs and Limitations</title>
- &bugs;
+ &ebugs;
</sect1>
<!-- =========================== About ================================ -->
@@ -219,11 +228,11 @@
or you may prefer, at your convenience, directly open a bug
or a request for enhancement in
<ulink
- url="https://bugzilla.gnome.org/enter_bug.cgi?product=nautilus-actions";
+ url="https://bugzilla.gnome.org/enter_bug.cgi?product=filemanager-actions";
type="http">Bugzilla website</ulink>.
</para>
</sect1>
- &gnu-fdl;
+ &egnu-fdl;
</article>
diff --git a/docs/user-manual/C/fma-execution.xml b/docs/user-manual/C/fma-execution.xml
index 828d31b..98b2704 100644
--- a/docs/user-manual/C/fma-execution.xml
+++ b/docs/user-manual/C/fma-execution.xml
@@ -26,12 +26,12 @@
click on <guilabel>Legend</guilabel>
button to see the list of available parameters.
</para>
- <figure id="nact-FIG-legend">
+ <figure id="fma-FIG-legend">
<title>List of available parameters</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-legend.png" format="PNG"/>
+ <imagedata fileref="figures/fma-legend.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Shows the list of available parameters.</phrase>
@@ -83,12 +83,12 @@
on <guibutton>Browse</guibutton> to select a folder on the
filesystem.
</para>
- <figure id="nact-FIG-work-dir-frame">
+ <figure id="fma-FIG-work-dir-frame">
<title>Working directory frame</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-working-directory-frame.png" format="PNG"/>
+ <imagedata fileref="figures/fma-working-directory-frame.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Focus on the working directory selection frame.</phrase>
@@ -126,12 +126,12 @@
Click on the <guilabel>Execution</guilabel> tab to show the page
which configures the execution of your command.
</para>
- <figure id="nact-FIG-execution">
+ <figure id="fma-FIG-execution">
<title>Configuration of the execution modes</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-execution-tab.png" format="PNG"/>
+ <imagedata fileref="figures/fma-execution-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Shows how to configure the execution modes of a command.</phrase>
@@ -145,12 +145,12 @@
<sect4 id="usage-execution-how-mode">
<title>Execution mode</title>
- <figure id="nact-FIG-execution-mode">
+ <figure id="fma-FIG-execution-mode">
<title>Configuration of the execution mode</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-exec-mode-frame.png" format="PNG"/>
+ <imagedata fileref="figures/fma-exec-mode-frame.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Focus on the execution mode frame.</phrase>
@@ -196,10 +196,12 @@
Makes use of a special feature of the file manager which may allow
a terminal to be ran in it.
</para>
- <para>
- As &nautilus; does not have this feature, this option is strictly
- equivalent to <literal>Terminal</literal> option.
- </para>
+ <note>
+ <para>
+ As for now, none of the managed file managers implement this
+ feature.
+ </para>
+ </note>
</listitem>
</varlistentry>
<varlistentry>
@@ -224,12 +226,12 @@
<sect4 id="usage-execution-how-notify">
<title>Startup notification</title>
- <figure id="nact-FIG-startup-mode">
+ <figure id="fma-FIG-startup-mode">
<title>Configuration of the startup modes</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-startup-mode-frame.png" format="PNG"/>
+ <imagedata fileref="figures/fma-startup-mode-frame.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Focus on the Startup mode frame.</phrase>
@@ -276,12 +278,12 @@
<sect4 id="usage-execution-how-user">
<title>Owner of the execution</title>
- <figure id="nact-FIG-execute-as">
+ <figure id="fma-FIG-execute-as">
<title>Configuration of the owner of the run</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-execute-as-frame.png" format="PNG"/>
+ <imagedata fileref="figures/fma-execute-as-frame.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Focus on the <guilabel>Execute as</guilabel> frame.</phrase>
@@ -371,7 +373,7 @@
</para>
</listitem>
</itemizedlist>
- <table id="nact-TAB-multiple-execution" frame="all" tocentry="1">
+ <table id="fma-TAB-multiple-execution" frame="all" tocentry="1">
<title>Characterization of the parameters <abbrev>vs.</abbrev> multiple execution</title>
<tgroup cols="5">
<colspec align="center" colwidth="*" />
diff --git a/docs/user-manual/C/fma-menus.xml b/docs/user-manual/C/fma-menus.xml
index 5290cad..c9f5123 100644
--- a/docs/user-manual/C/fma-menus.xml
+++ b/docs/user-manual/C/fma-menus.xml
@@ -59,7 +59,7 @@
<para>
As an action, too, a menu requires a label, and may have an icon and
a tooltip. Also, you may define some conditions in order your menu
- be candidate to be displayed in &nautilus; context menu. If the
+ be candidate to be displayed in the file manager context menu. If the
defined conditions are not met at runtime, then your whole menu,
including its submenus, its actions and so on, will not be displayed.
</para>
diff --git a/docs/user-manual/C/fma-misc.xml b/docs/user-manual/C/fma-misc.xml
index 23bd8db..05ab7f3 100644
--- a/docs/user-manual/C/fma-misc.xml
+++ b/docs/user-manual/C/fma-misc.xml
@@ -3,7 +3,7 @@
list.
Red color is used as an indicator that the item is invalid,
that is that the item cannot be candidate to be displayed in
- a &nautilus; context menu because some of its informations are
+ a file manager context menu because some of its informations are
missing or erroneous.
Here, and though this newly inserted action has some suitable
defaults, it lacks a command to be executed to be considered
diff --git a/docs/user-manual/C/fma-prefs.xml b/docs/user-manual/C/fma-prefs.xml
index 93dd06b..a0d58ca 100644
--- a/docs/user-manual/C/fma-prefs.xml
+++ b/docs/user-manual/C/fma-prefs.xml
@@ -13,12 +13,12 @@
<sect3 id="usage-prefs-runtime">
<title>Runtime preferences</title>
- <figure id="nact-FIG-prefs-runtime">
+ <figure id="fma-FIG-prefs-runtime">
<title>Runtime preferences</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-preferences-runtime.png" format="PNG" />
+ <imagedata fileref="figures/fma-preferences-runtime.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Shows the tab which lets you define runtime preferences.</phrase>
@@ -33,12 +33,12 @@
<sect3 id="usage-prefs-execution">
<title>Runtime execution preferences</title>
- <figure id="nact-FIG-prefs-execution">
+ <figure id="fma-FIG-prefs-execution">
<title>Runtime execution preferences</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-preferences-execution.png" format="PNG" />
+ <imagedata fileref="figures/fma-preferences-execution.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Shows the tab which lets you define runtime execution preferences.</phrase>
@@ -50,12 +50,12 @@
</screenshot>
</figure>
- <figure id="nact-FIG-prefs-desktop">
+ <figure id="fma-FIG-prefs-desktop">
<title>Desktop selection</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-preferences-desktop.png" format="PNG" />
+ <imagedata fileref="figures/fma-preferences-desktop.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Let the user explicitely configure the current desktop.</phrase>
@@ -70,12 +70,12 @@
<sect3 id="usage-prefs-ui">
<title>User interface preferences</title>
- <figure id="nact-FIG-prefs-ui">
+ <figure id="fma-FIG-prefs-ui">
<title>UI preferences</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-preferences-ui.png" format="PNG" />
+ <imagedata fileref="figures/fma-preferences-ui.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Shows the tab which lets you define UI preferences.</phrase>
@@ -90,12 +90,12 @@
<sect3 id="usage-prefs-import">
<title>Import preferences</title>
- <figure id="nact-FIG-prefs-import">
+ <figure id="fma-FIG-prefs-import">
<title>Import preferences</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-preferences-import.png" format="PNG" />
+ <imagedata fileref="figures/fma-preferences-import.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Shows the tab which lets you define import preferences.</phrase>
@@ -112,12 +112,12 @@
<sect3 id="usage-prefs-export">
<title>Export preferences</title>
- <figure id="nact-FIG-prefs-export">
+ <figure id="fma-FIG-prefs-export">
<title>Export preferences</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-preferences-export.png" format="PNG" />
+ <imagedata fileref="figures/fma-preferences-export.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Shows the tab which lets you define export preferences.</phrase>
@@ -134,12 +134,12 @@
<sect3 id="usage-prefs-schemes">
<title>Schemes preferences</title>
- <figure id="nact-FIG-prefs-schemes">
+ <figure id="fma-FIG-prefs-schemes">
<title>Schemes preferences</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-preferences-schemes.png" format="PNG" />
+ <imagedata fileref="figures/fma-preferences-schemes.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Shows the tab which lets you define schemes preferences.</phrase>
@@ -156,12 +156,12 @@
<sect3 id="usage-prefs-providers">
<title>I/O providers preferences</title>
- <figure id="nact-FIG-prefs-io-providers">
+ <figure id="fma-FIG-prefs-io-providers">
<title>I/O providers preferences</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-preferences-io-providers.png" format="PNG" />
+ <imagedata fileref="figures/fma-preferences-io-providers.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Shows the tab which lets you define I/O providers preferences.</phrase>
diff --git a/docs/user-manual/C/fma-profiles.xml b/docs/user-manual/C/fma-profiles.xml
index c23c973..0b0d09c 100644
--- a/docs/user-manual/C/fma-profiles.xml
+++ b/docs/user-manual/C/fma-profiles.xml
@@ -73,7 +73,7 @@
<para>
Profiles of an action are ordered, and they are examined in that
order at runtime. The first profile whose conditions are met will
- be validated, and made selectable in the &nautilus; context menu.
+ be validated, and made selectable in the file manager context menu.
</para>
<para>
So, ordering of the profiles may be important for your action:
diff --git a/docs/user-manual/C/fma-properties.xml b/docs/user-manual/C/fma-properties.xml
index 2f7f72f..28a947c 100644
--- a/docs/user-manual/C/fma-properties.xml
+++ b/docs/user-manual/C/fma-properties.xml
@@ -4,12 +4,12 @@
An item has both editable and read-only properties.
</para>
- <figure id="nact-FIG-prefs-runtime">
+ <figure id="fma-FIG-prefs-runtime">
<title>Item properties</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-properties-tab.png" format="PNG" />
+ <imagedata fileref="figures/fma-properties-tab.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Shows the tab which lets you access both editable and read-only item properties.</phrase>
diff --git a/docs/user-manual/C/fma-sorting.xml b/docs/user-manual/C/fma-sorting.xml
index 1a820b5..239f397 100644
--- a/docs/user-manual/C/fma-sorting.xml
+++ b/docs/user-manual/C/fma-sorting.xml
@@ -31,7 +31,7 @@
In these modes, actions and menus are sorted depending of their
label, inside of their parent.
</para>
- <figure id="nact-FIG-sort-buttons">
+ <figure id="fma-FIG-sort-buttons">
<title>Sort buttons in the main window</title>
<screenshot>
<mediaobject>
diff --git a/docs/user-manual/C/fma-starting.xml b/docs/user-manual/C/fma-starting.xml
index 052df17..7f04809 100644
--- a/docs/user-manual/C/fma-starting.xml
+++ b/docs/user-manual/C/fma-starting.xml
@@ -24,7 +24,7 @@
To start &appname; from a command line, type the following command:
</para>
<para>
- <command><filename>nautilus-actions-config-tool</filename></command>
+ <command><filename>fma-config-tool</filename></command>
</para>
<para>
<!-- i18n: "Return" is a key name -->
@@ -36,7 +36,7 @@
</para>
<para>
<command>
- <filename>nautilus-actions-config-tool</filename>
+ <filename>fma-config-tool</filename>
<option>--help-all</option>
</command>
</para>
@@ -55,12 +55,12 @@
<para>
When you start &appname;, the following window is displayed.
</para>
- <figure id="nact-FIG-main-empty">
+ <figure id="fma-FIG-main-empty">
<title>&appname; Start Up Window</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-main-empty.png" format="PNG"/>
+ <imagedata fileref="figures/fma-main-empty.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>
@@ -284,7 +284,7 @@
</term>
<listitem>
<para>
- Define in which &nautilus; menus the item should
+ Define in which file manager menus the item should
appear, and how it will be displayed.
</para>
</listitem>
@@ -316,7 +316,7 @@
</term>
<listitem>
<para>
- Define the basename filters the &nautilus; selection
+ Define the basename filters the file manager selection
must satisfy in order the action or menu be candidate
for display.
</para>
@@ -328,7 +328,7 @@
</term>
<listitem>
<para>
- Define the mimetype filters the &nautilus; selection
+ Define the mimetype filters the file manager selection
must satisfy in order the action or menu be candidate
for display.
</para>
@@ -340,7 +340,7 @@
</term>
<listitem>
<para>
- Define the folder filters the &nautilus; selection
+ Define the folder filters the file manager selection
must satisfy in order the action or menu be candidate
for display.
</para>
@@ -352,7 +352,7 @@
</term>
<listitem>
<para>
- Define the scheme filters the &nautilus; selection
+ Define the scheme filters the file manager selection
must satisfy in order the action or menu be candidate
for display.
</para>
@@ -364,7 +364,7 @@
</term>
<listitem>
<para>
- Define the capability filters the &nautilus; selection
+ Define the capability filters the file manager selection
must satisfy in order the action or menu be candidate
for display.
</para>
@@ -376,7 +376,7 @@
</term>
<listitem>
<para>
- Define some environment conditions the &nautilus;
+ Define some environment conditions the file manager
selection must satisfy in order the action or menu
be candidate for display.
</para>
@@ -472,12 +472,12 @@
The label of the currently edited action (this one) is added
to the application name in the title bar.
</para>
- <figure id="nact-FIG-tab-action">
+ <figure id="fma-FIG-tab-action">
<title>Default properties of a new action</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-action-tab.png" format="PNG"/>
+ <imagedata fileref="figures/fma-action-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>
@@ -592,12 +592,12 @@
Click on the <guilabel>Command</guilabel> tab to show the page
which will permit you to enter the command.
</para>
- <figure id="nact-FIG-tab-command">
+ <figure id="fma-FIG-tab-command">
<title>Command page</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-command-tab.png" format="PNG"/>
+ <imagedata fileref="figures/fma-command-tab.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>
@@ -692,31 +692,31 @@
</para>
</formalpara>
<para>
- &nautilus; automatically takes into account your new action,
+ The file manager automatically takes into account your new action,
and displays it in its context menu.
</para>
- <figure id="nact-FIG-start-nautilus-context">
- <title>Your first action in the &nautilus; context menu</title>
+ <figure id="fma-FIG-start-nautilus-context">
+ <title>Your first action in the file manager context menu</title>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="figures/start-context-menu-nautilus.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase>Shows the first action in the &nautilus; context menu.
+ <phrase>Shows the first action in the file manager context menu.
</phrase>
</textobject>
<caption>
- <para>Your first action in the &nautilus; context menu</para>
+ <para>Your first action in the file manager context menu</para>
</caption>
</mediaobject>
</screenshot>
</figure>
<para>
- Cliking of the item in the &nautilus; context menu activates it,
+ Cliking of the item in the file manager context menu activates it,
and executes the corresponding command.
</para>
- <figure id="nact-FIG-start-zenity">
+ <figure id="fma-FIG-start-zenity">
<title>The result of the execution of your first action</title>
<screenshot>
<mediaobject>
diff --git a/docs/user-manual/C/fma-where.xml b/docs/user-manual/C/fma-where.xml
index 4b94df9..40cba77 100644
--- a/docs/user-manual/C/fma-where.xml
+++ b/docs/user-manual/C/fma-where.xml
@@ -1,11 +1,11 @@
<sect2 id="usage-where">
<title>Locating the action</title>
- <figure id="nact-FIG-target-location-where">
+ <figure id="fma-FIG-target-location-where">
<title>Target configuration</title>
<screenshot>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/nact-target-location.png" format="PNG" />
+ <imagedata fileref="figures/fma-target-location.png" format="PNG" />
</imageobject>
<textobject>
<phrase>Shows the three fields which let you configure the target of your action.</phrase>
@@ -17,7 +17,7 @@
</screenshot>
</figure>
<para>
- &nautilus; file manager may display your action in different places,
+ The file manager may display your action in different places,
depending on what you will request here, and if some item is currently
selected (or not).
</para>
@@ -33,18 +33,18 @@
<para>
When <guilabel>Display item in selection context menu</guilabel>
is checked, then your action will be a candidate to be displayed in
- &nautilus;' context menu as soon as at least one item is selected in
+ the file manager context menu as soon as at least one item is selected in
the file manager. Your action will so deal with currently selected
item(s).In order to be
actually displayed, all the conditions defined in
your candidate action must be met by each item currently selected
- in the &nautilus; file manager.
+ in the file manager.
</para>
<tip>
<para>
When an action targets the selection context menu, and is actually
- displayed in &nautilus;' context menu, then it is also displayed
- in &nautilus;' <guimenu>Edit</guimenu> menu.
+ displayed in the file manager context menu, then it is also displayed
+ in file manager' <guimenu>Edit</guimenu> menu.
</para>
</tip>
<para>
@@ -57,18 +57,18 @@
<para>
When <guilabel>Display item in location context menu</guilabel> checkbox
is activated, then your action will be a candidate to be displayed in
- &nautilus;' context menu when the file manager selection is empty.
+ file manager' context menu when the file manager selection is empty.
Your action will so deal with currently displayed location.
In order to be
actually displayed, all the conditions defined in
your candidate action must be met by the location currently displayed
- in the &nautilus; file manager.
+ in the file manager.
</para>
<tip>
<para>
When an action targets the location context menu, and is actually
- displayed in &nautilus;' context menu, then it is also displayed
- in &nautilus;' <guimenu>File</guimenu> menu.
+ displayed in file manager' context menu, then it is also displayed
+ in file manager' <guimenu>File</guimenu> menu.
</para>
</tip>
</sect3>
@@ -78,7 +78,7 @@
<para>
When <guilabel>Display item in the toolbar</guilabel> checkbox
is activated, then your action will be a candidate to be displayed in
- &nautilus;' toolbar.
+ file manager;' toolbar.
</para>
<para>
Actions displayed in the toolbar only deal with the location which
@@ -96,7 +96,7 @@
<title>If your action is to be displayed in a context menu</title>
<para>
Whether it is the selection context menu or the location
- context menu, and both in &nautilus;' context menus and in
+ context menu, and both in file manager' context menus and in
<guimenu>File</guimenu> or <guimenu>Edit</guimenu> menus, it
will be displayed as
</para>
diff --git a/docs/user-manual/C/legalnotice.xml b/docs/user-manual/C/legalnotice.xml
index 3e3d133..376c91e 100644
--- a/docs/user-manual/C/legalnotice.xml
+++ b/docs/user-manual/C/legalnotice.xml
@@ -3,7 +3,7 @@
Please do not change any of this.
-->
-<legalnotice id="legalnotice">
+<legalnotice id="idlegalnotice">
<para>
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation
diff --git a/docs/user-manual/Makefile.am b/docs/user-manual/Makefile.am
index d63cb89..dc54667 100644
--- a/docs/user-manual/Makefile.am
+++ b/docs/user-manual/Makefile.am
@@ -137,453 +137,3 @@ DOC_FIGURES = \
#DOC_LINGUAS = $(patsubst $(srcdir)/%,%,$(shell find $(srcdir) -mindepth 1 -maxdepth 1 -type d | $(GREP) -v
$(srcdir)/C))
DOC_LINGUAS = de el es fr sl
-
-if ENABLE_MANUALS
-# _DOC_LC_DOCS is the list of the translated (not C) DOC_MODULE.xml files
-# we so are sure that they exist and are up to date
-# (path is .po ->[msgfmt]-> .mo ->[xml2po]-> .xml)
-MANUALS_XML = C/$(DOC_MODULE).xml $(_DOC_LC_DOCS)
-endif
-
-EXTRA_DIST = \
- gnome-doc-utils-na.make \
- $(NULL)
-
-MAINTAINERCLEANFILES = \
- gnome-doc-utils-na.make \
- $(NULL)
-
-pkgdocdir = $(datarootdir)/doc/@PACKAGE -@VERSION@
-
-# set to '-v' to be verbose (much verbose!)
-opt_verbose =
-
-all-local: all-manuals
-
-all-manuals: install-C-xml all-html-manuals all-pdf-manuals
-
-install-data-local: install-manuals
-
-install-manuals: install-html-manuals install-pdf-manuals
-
-uninstall-local: uninstall-manuals
-
-uninstall-manuals: uninstall-html-manuals uninstall-pdf-manuals
-
-# doc-dist-hook is the dist hook from gnome-doc-utils.make
-# it distributes both C (original) and generated (translated) .xml files,
-# but not generated .omf files which so will have to be re-generated from
-# the distributed .omf.in file
-dist-hook: doc-dist-hook dist-manuals-hook dist-omf-hook
-
-dist-manuals-hook: dist-html-manuals-hook dist-pdf-manuals-hook
-
-# when building the manuals, C source files are in srcdir, while all
-# other xml files are in builddir - installing C xml sources in builddir
-# so that all rules apply
-install-C-xml:
-if ENABLE_MANUALS
- @if ! test -f C/$(DOC_MODULE).xml; then \
- echo "Installing C xml source files in $(abs_builddir)"; \
- $(MKDIR_P) C; cp -v $(srcdir)/C/*.xml C/; \
- fi
-endif
-
-remove-C-xml:
-if ENABLE_MANUALS
- @echo "Removing C xml source files from $(abs_builddir)"
- @if test "$(abs_srcdir)" != "$(abs_builddir)"; then \
- rm -vf C/*.xml; \
- fi
-endif
-
-# Build HTML manuals as $(builddir)/<lang>/<module>.html
-#
-# We have two alternative for generating HTML manual:
-# - gnome-doc-tool (from gnome-doc-utils package)
-# - db2html (from docbook-utils package)
-# The actual tool to be used may be specified as an argument of
-# --enable-html-manuals configure option. It defaults to gnome-doc-tool.
-#
-# gnome-doc-tool <format> -o <dir> -d0 nautilus-actions-config-tool.xml
-# - format: output format (html)
-# - dir: output directory
-# -d0: nochunks
-#
-# The produced output is very close of what Yelp gives, with in particular
-# a summary in each chapter while db2html does not produce it.
-#
-# As of v 0.20.1:
-# - does not produce the legal and abstract sections in top of the document
-# - does not honor external links: they are converted to simple links
-# which target the same frame window.
-# - embeds references to 'admon-xxx' images (which are the equivalent
-# of db2html's 'stylesheet-images' ones), but does not provide them
-# (see https://bugzilla.gnome.org/show_bug.cgi?id=636175)
-# and so we 'manually' copy them as a "admon/" subdirectory
-# the same way db2html does
-# - does not honor the base directory of the source document, only
-# searching for extern entities in the current working directory
-# (see https://bugzilla.gnome.org/show_bug.cgi?id=664784)
-#
-# gnome-doc-tool is so our preferred tool for its proximity with Yelp
-# and the summary in top of the chapters.
-#
-# db2html --nochunks nautilus-actions-config-tool.xml
-# Generate the html document(s).
-#
-# As of 0.6.14.29:
-# - does produce the legal and abstract sections in top of the document
-# - creates a stylesheet-images/ subdirectory
-# - does not honor external links: they are converted to simple links
-# which target the same frame window
-# - may create docbook2html-dir(.junk) subdirectories when it is run
-# without argument
-# (see https://bugzilla.redhat.com/show_bug.cgi?id=756930)
-# - begins by emptying the target directory, even if it also contains
-# the source file
-#
-# When building HTML and PDF formats from XML sources, note that the
-# .xml documents default to be read from <srcdir> for the C version,
-# and from <builddir> for translated ones.
-
-if ENABLE_HTML_MANUALS
-MANUALS_HTML = $(MANUALS_XML:%.xml=%.html)
-
-MAINTAINERCLEANFILES += $(MANUALS_HTML)
-
-all-html-manuals: $(MANUALS_HTML)
-else
-all-html-manuals:
-endif
-
-# The rule here is: only rebuild html/ files if corresponding xml has changed
-# .xml themselves are distributed, so are not modified when building from a
-# distributed package.
-
-$(MANUALS_HTML): %.html: %.xml
- @ftarget=$@; \
- if test "$(opt_verbose)" = ""; then echo " HTML $$ftarget building..."; fi; \
- lc=$${ftarget%/*}; \
- if test "x$(WITH_DB2HTML)" = "xyes"; then $(call exec_db2html,$$lc); fi; \
- if test "x$(WITH_GDT)" = "xyes"; then $(call exec_g_d_t,$$lc); fi; \
- if test "$(opt_verbose)" = ""; then echo " HTML $$ftarget done"; fi
-
-# execute gnome-doc-tool
-# 1. locale
-exec_g_d_t = \
- fxml=$(DOC_MODULE).xml; \
- (cd $(1); \
- cmd="gnome-doc-tool html -o . -d0 $$fxml"; \
- if test "$(opt_verbose)" != ""; then echo "$$cmd"; fi; \
- eval $$cmd >/dev/null; \
- fhtml=$(DOC_MODULE).html; \
- if test -f $$fhtml; then \
- sed -i -e 's?url("admon?url("admon/admon?' $$fhtml; \
- admon_dir=/usr/share/gnome-doc-utils/icons/hicolor/48x48/status; \
- if test -d $$admon_dir; then \
- $(MKDIR_P) admon; \
- cmd="cp $(opt_verbose) $$admon_dir/*.png admon/"; eval $$cmd; \
- fi; \
- fi; \
- )
-
-# execute db2html
-# 1. locale
-exec_db2html = \
- cddir="$(1)"; \
- output="."; \
- fxml=$(DOC_MODULE).xml; \
- cmd="(cd $$cddir && db2html --output $$output --nochunks $$fxml)"; \
- if test "$(opt_verbose)" != ""; then echo "$$cmd"; fi; \
- eval $$cmd >/dev/null; \
- find . -type d -name '*.junk' | xargs rm -fr
-
-# install source .xml docs in builddir to be able to build C locale
-# 1. locale
-# 2. "yes" if build in source
-#install_xml = \
-# if test "$(1)" = "C" -a "$(2)" = "no"; then $(MKDIR_P) C; cp $(srcdir)/C/*.xml C/; fi
-
-# remove .xml docs from builddir after having built C locale
-# 1. locale
-# 2. "yes" if build in source
-#remove_xml = \
-# if test "$(1)" = "C" -a "$(2)" = "no"; then rm -f C/*.xml; fi
-
-# Install HTML manuals in <htmldir>/<lang>/nact/ subdirectory;
-# where <htmldir> defaults to <pkgdocdir>/html
-#
-# Note: we do honor here --htmldir autotools configuration option.
-#
-# Manuals may be installed from builddir, if they just have been built,
-# or from srcdir, if they were not built but come from distribution.
-
-install-html-manuals:
- @if test "x$(htmldir)" = "x$(docdir)"; then \
- _instd="$(DESTDIR)$(pkgdocdir)/html"; \
- else \
- _instd="$(DESTDIR)$(htmldir)"; \
- fi; \
- echo " Installing in $$_instd ..."; \
- for lc in C $(DOC_LINGUAS); do \
- _instdir="$$_instd/$$lc/nact"; \
- if test -f "$(builddir)/$$lc/$(DOC_MODULE).html"; then \
- d="$(builddir)"; \
- elif test -f "$(srcdir)/$$lc/$(DOC_MODULE).html"; then \
- d="$(srcdir)"; \
- fi; \
- if test -f "$$d/$$lc/$(DOC_MODULE).html"; then \
- $(call install_html_doc,$$d,$$lc,$$_instdir); \
- $(call install_html_images,$$d,$$lc,$$_instdir,"stylesheet-images"); \
- $(call install_html_images,$$d,$$lc,$$_instdir,"admon"); \
- $(call install_html_figs,$$d,$$lc,$$_instdir); \
- fi; \
- done
-
-# installing html document
-# 1: source dir
-# 2: locale
-# 3: target dir
-install_html_doc = \
- if test "$(opt_verbose)" = ""; then echo " $(2)/nact/$(DOC_MODULE).html"; fi; \
- $(MKDIR_P) $(3); \
- cp -p $(opt_verbose) "$(1)/$(2)/$(DOC_MODULE).html" $(3)/
-
-# installing html images
-# 1: source dir
-# 2: locale
-# 3: target dir
-# 4: stylesheet-images or admon
-install_html_images = \
- if grep -lq $(4) "$(1)/$(2)/$(DOC_MODULE).html"; then \
- if test -d "$(1)/$(2)/$(4)"; then \
- if test "$(opt_verbose)" = ""; then echo " $(2)/nact/$(4)"; fi; \
- cmd="cp -rp $(opt_verbose) \"$(1)/$(2)/$(4)\" $(3)/"; eval $$cmd; \
- if test "$(opt_verbose)" != ""; then echo $$cmd; fi; \
- fi; \
- fi
-
-# installing user's manual figures
-# rebuilding list of figures here because I'm unable to pass it as a parameter
-# (it comes here as a single string in which I cannot walk through)
-# 1: source dir
-# 2: locale
-# 3: target dir
-install_html_figs = \
- if test "$(opt_verbose)" = ""; then echo " $(2)/nact/figures"; fi; \
- figdir="$(3)/figures"; \
- if ! test -d "$$figdir"; then $(MKDIR_P) "$$figdir"; fi; \
- for fig in $(DOC_FIGURES); do \
- figsrc=$(srcdir)/$(2)/$$fig; \
- if test -f $${figsrc} -a ! -h $${figsrc}; then \
- cmd="$(INSTALL_DATA) $${figsrc} $${figdir}/"; \
- else \
- cmd="(cd $${figdir} && $(LN_S) -f ../../../C/nact/$$fig)"; \
- fi; \
- if test "$(opt_verbose)" != ""; then echo $$cmd; fi; \
- eval $$cmd; \
- done
-
-uninstall-html-manuals:
- @if test "x$(htmldir)" = "x$(docdir)"; then \
- _instdir="$(DESTDIR)$(pkgdocdir)/html"; \
- else \
- _instdir="$(DESTDIR)$(htmldir)"; \
- fi; \
- if test -d $$_instdir; then \
- chmod -R u+w $$_instdir; \
- find $$_instdir -type d -name 'admon' | xargs rm -fr $(opt_verbose); \
- find $$_instdir -type d -name 'figures' | xargs rm -fr $(opt_verbose); \
- find $$_instdir -type d -name 'stylesheet-images' | xargs rm -fr $(opt_verbose); \
- find $$_instdir -type f -name '*.html' | xargs rm -f $(opt_verbose); \
- find $$_instdir -type d | sort -r | xargs rmdir $(opt_verbose); \
- fi
-
-# locale figures (_DOC_LC_FIGURES) are distributed by gnome-doc-utils
-# when they exist
-# - distribute admon/ or stylesheet-images/ icons
-# - distribute *.html manuals
-
-dist-html-manuals-hook:
- @for lc in C $(DOC_LINGUAS); do \
- if test -f "$(builddir)/$$lc/$(DOC_MODULE).html"; then d=$(builddir); \
- elif test -f "$(srcdir)/$$lc/$(DOC_MODULE).html"; then d=$(srcdir); fi; \
- if test -f "$$d/$$lc/$(DOC_MODULE).html"; then \
- if test "$(opt_verbose)" = ""; then echo " Distributing $$lc/$(DOC_MODULE).html";
fi; \
- cmd="cp $(opt_verbose) $$d/$$lc/$(DOC_MODULE).html $(distdir)/$$lc/"; eval $$cmd; \
- $(call dist_html_images,$$d,$$lc,"stylesheet-images"); \
- $(call dist_html_images,$$d,$$lc,"admon"); \
- fi; \
- done
-
-# distribute html images
-# 1. source dir
-# 2. locale
-# 3. image type (stylesheet-images or admon)
-dist_html_images = \
- if grep -lq $(3) "$(1)/$(2)/$(DOC_MODULE).html"; then \
- if test -d "$(1)/$(2)/$(3)"; then \
- if test "$(opt_verbose)" = ""; then echo " Distributing $(2)/$(3)"; fi; \
- cmd="cp -rp $(opt_verbose) \"$(1)/$(2)/$(3)\" $(distdir)/$(2)/"; eval $$cmd; \
- fi; \
- fi
-
-# Build pdf manuals as $(srcdir)/<lang>/<module>.pdf
-#
-# The rule here is: only rebuild .pdf files if corresponding xml has changed
-# .xml themselves are distributed, so are not modified when compiling from a
-# distribution
-#
-# We only use dblatex for now
-
-MANUALS_PDF = $(MANUALS_XML:%.xml=%.pdf)
-
-MAINTAINERCLEANFILES += $(MANUALS_PDF)
-
-if ENABLE_PDF_MANUALS
-all-pdf-manuals: $(MANUALS_PDF)
-else
-all-pdf-manuals:
-endif
-
-# workaround against l10n bug #664768
-# pdflatex cannot generate some localized pdf
-#
-# As of dblatex 0.3.3:
-# - always create the output pdf in the same directory that the
-# source xml
-# (but we need to cd $$lc to mkdir figures)
-
-$(MANUALS_PDF): %.pdf: %.xml
- @ftarget=$@; \
- if test "$(opt_verbose)" = ""; then echo " PDF $$ftarget building..."; fi; \
- lc=$${ftarget%/*}; \
- list='$(DOC_FIGURES)'; \
- (cd $$lc; \
- $(MKDIR_P) figures; \
- for fig in $$list; do \
- if test -f "$(srcdir)/$$lc/$$fig"; then d=$$lc; else d="C"; fi; \
- cmd="(cd figures && $(LN_S) -f $(srcdir)/$$d/$$fig)"; eval $$cmd; \
- done; \
- cmd="dblatex $(DOC_MODULE).xml"; eval $$cmd >/dev/null; \
- if ! test -f $(DOC_MODULE).pdf; then \
- echo " PDF $$ftarget recovering from dblatex error..."; \
- tmpdir=`dblatex -d $(DOC_MODULE).xml 2>&1 | grep 'not removed' | awk '{ print $$1 }'`; \
- cp $$tmpdir/$(DOC_MODULE).pdf . || :; \
- rm -fr $$tmpdir; \
- fi; \
- ); \
- if test "$(opt_verbose)" = ""; then \
- if test -f $$lc/$(DOC_MODULE).pdf; then \
- echo " PDF $$ftarget done"; \
- else \
- echo " PDF unable to build $$ftarget"; \
- fi; \
- fi
-
-# if --pdfdir has not been specified, then we default to PKGDOCDIR/pdf
-# in all case, we append the locale as a subdirectory level
-#
-# as pdf are monobloc documents, we do not create a per-document subdir
-
-install-pdf-manuals:
- @if test "$(pdfdir)" = "$(docdir)"; then \
- _instdir=$(DESTDIR)$(pkgdocdir)/pdf; \
- else \
- _instdir=$(DESTDIR)$(pdfdir); \
- fi; \
- echo " Installing in $$_instdir ... "; \
- for lc in C $(DOC_LINGUAS); do \
- if test -f $(srcdir)/$$lc/$(DOC_MODULE).pdf; then d=$(srcdir); fi; \
- if test -f $(builddir)/$$lc/$(DOC_MODULE).pdf; then d=$(builddir); fi; \
- if test -f $$d/$$lc/$(DOC_MODULE).pdf; then \
- if test "$(opt_verbose)" = ""; then echo " $$lc/$(DOC_MODULE).pdf"; fi; \
- if ! test -d $$_instdir/$$lc; then cmd="$(MKDIR_P) $$_instdir/$$lc"; eval $$cmd; fi; \
- cmd="$(INSTALL_DATA) \"$$d/$$lc/$(DOC_MODULE).pdf\" \"$$_instdir/$$lc/\""; eval
$$cmd; \
- if test "$(opt_verbose)" != ""; then echo $$cmd; fi; \
- fi; \
- done
-
-uninstall-pdf-manuals:
- @if test "$(pdfdir)" = "$(docdir)"; then \
- _instdir=$(DESTDIR)$(pkgdocdir)/pdf; \
- else \
- _instdir=$(DESTDIR)$(pdfdir); \
- fi; \
- if test -d $$_instdir; then \
- chmod -R u+w $$_instdir; \
- find $$_instdir -name '*.pdf' | xargs rm -f $(opt_verbose); \
- find $$_instdir -type d | sort -r | xargs rmdir $(opt_verbose); \
- fi
-
-dist-pdf-manuals-hook:
- @for lc in C $(DOC_LINGUAS); do \
- if test -f $(builddir)/$$lc/$(DOC_MODULE).pdf; then d=$(builddir); \
- elif test -f $(srcdir)/$$lc/$(DOC_MODULE).pdf; then d=$(srcdir); fi; \
- if test -f "$$d/$$lc/$(DOC_MODULE).pdf"; then \
- if test "$(opt_verbose)" = ""; then echo " Distributing $$lc/$(DOC_MODULE).pdf"; fi;
\
- cmd="cp $$d/$$lc/$(DOC_MODULE).pdf $(distdir)/$$lc/"; eval $$cmd; \
- if test "$(opt_verbose)" != ""; then echo $$cmd; fi; \
- fi; \
- done
-
-# Distributing .omf files is required if we want the user be able to
-# get rid of gnome-doc-utils
-dist-omf-hook:
- @for lc in C $(DOC_LINGUAS); do \
- omf="$(DOC_MODULE)-$$lc.omf"; \
- if test -f $(builddir)/$$omf; then d=$(builddir); \
- elif test -f $(srcdir)/$$lc/$$omf; then d=$(srcdir)/$$lc; fi; \
- if test -f "$$d/$$omf"; then \
- if test "$(opt_verbose)" = ""; then echo " Distributing $$omf"; fi; \
- cmd="cp $$d/$$omf $(distdir)/$$lc/"; eval $$cmd; \
- if test "$(opt_verbose)" != ""; then echo $$cmd; fi; \
- fi; \
- done
-
-# According to GNU Make manual (ยง 13 What Gets Cleaned):
-#
-# - mostlyclean deletes files we typically want to rebuild
-# - clean deletes other files built with make
-# - distclean deletes files built by configure (none here)
-##
-## None of these target should delete any distributed file
-##
-# - maintainer-clean should delete other files
-clean-local: remove-C-xml
- rm -f *~
- rm -f *.stamp
- for lc in C $(DOC_LINGUAS); do \
- (cd $$lc; \
- find figures -type l | xargs rm -f; \
- rmdir figures 2>/dev/null || :; \
- ); \
- done
-
-distclean-local: distclean-html distclean-pdf
-
-distclean-html:
-
-distclean-pdf:
-
-maintainer-clean-local: maintainer-clean-html maintainer-clean-pdf
-
-maintainer-clean-html:
- find $(srcdir) -type d -name 'admon' | xargs rm -fr
- find $(builddir) -type l -name 'admon' | xargs rm -f
- find $(srcdir) -type d -name 'stylesheet-images' | xargs rm -fr
- find $(builddir) -type d -name 'stylesheet-images' | xargs rm -fr
-
-maintainer-clean-pdf:
-
-# we have to override gnome-doc-utils.make:clean-doc-dir recipe
-# as it tries to remove directories which are not empty as we have
-# not yet deleted the files we putted on
-clean-doc-dir:
- @:
-
-.PHONY: \
- all-manuals install-manuals uninstall-manuals dist-manuals-hook \
- all-html-manuals install-html-manuals uninstall-html-manuals dist-html-manuals-hook \
- all-pdf-manuals install-pdf-manuals uninstall-pdf-manuals dist-pdf-manuals-hook
diff --git a/maintainer/run-autogen.sh b/maintainer/run-autogen.sh
index 9e1e961..50f8bfb 100755
--- a/maintainer/run-autogen.sh
+++ b/maintainer/run-autogen.sh
@@ -146,6 +146,7 @@ conf_args="\${conf_args} --sysconfdir=/etc"
conf_args="\${conf_args} --with-nautilus-extdir=\${heredir}/_install/lib/nautilus"
conf_args="\${conf_args} --with-nemo-extdir=\${heredir}/_install/lib/nemo"
conf_args="\${conf_args} --enable-maintainer-mode"
+conf_args="\${conf_args} --disable-scrollkeeper"
conf_args="\${conf_args} $*"
conf_args="\${conf_args} \$*"
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
