[gimp-help-2] Complete preferences

From: Julien Hardlin <jhardlin src gnome org>
To: commits-list gnome org
Cc:
Subject: [gimp-help-2] Complete preferences
Date: Wed, 22 Feb 2017 16:30:18 +0000 (UTC)
commit 8c418ee7b4d9ce430a5e1b02baeddba4e46ab782
Author: Julien Hardelin <jhardlin orange fr>
Date:   Wed Feb 22 17:29:35 2017 +0100

    Complete preferences

 images/C/preferences/prefs-dialog-defaults.png     |  Bin 0 -> 41195 bytes
 images/C/preferences/prefs-help.png                |  Bin 18708 -> 52356 bytes
 images/C/preferences/prefs-icon-theme.png          |  Bin 0 -> 28650 bytes
 images/C/preferences/prefs-image-import-export.png |  Bin 0 -> 16870 bytes
 .../C/preferences/prefs-image-window-snapping.png  |  Bin 0 -> 40476 bytes
 images/C/preferences/prefs-list.png                |  Bin 44732 -> 49312 bytes
 images/C/preferences/prefs-toolbox.png             |  Bin 10410 -> 44252 bytes
 images/C/preferences/prefs-window-management.png   |  Bin 45578 -> 43065 bytes
 src/using/preferences/preferences_introduction.xml |    3 +
 src/using/preferences/prefs-default-image.xml      |    4 +-
 src/using/preferences/prefs-dialog-defaults.xml    |   30 +++++++++
 src/using/preferences/prefs-help.xml               |   66 ++++++++++----------
 src/using/preferences/prefs-icon-theme.xml         |   32 ++++++++++
 .../preferences/prefs-image-window-snapping.xml    |   39 ++++++++++++
 src/using/preferences/prefs-image-window-title.xml |    8 +--
 src/using/preferences/prefs-input-controllers.xml  |   12 ++--
 src/using/preferences/prefs-input-devices.xml      |   23 +++++--
 src/using/preferences/prefs-theme.xml              |   41 ++----------
 18 files changed, 171 insertions(+), 87 deletions(-)
---
diff --git a/images/C/preferences/prefs-dialog-defaults.png b/images/C/preferences/prefs-dialog-defaults.png
new file mode 100644
index 0000000..2bcf752
Binary files /dev/null and b/images/C/preferences/prefs-dialog-defaults.png differ
diff --git a/images/C/preferences/prefs-help.png b/images/C/preferences/prefs-help.png
index 79a5940..9263edc 100644
Binary files a/images/C/preferences/prefs-help.png and b/images/C/preferences/prefs-help.png differ
diff --git a/images/C/preferences/prefs-icon-theme.png b/images/C/preferences/prefs-icon-theme.png
new file mode 100644
index 0000000..70bcec6
Binary files /dev/null and b/images/C/preferences/prefs-icon-theme.png differ
diff --git a/images/C/preferences/prefs-image-import-export.png 
b/images/C/preferences/prefs-image-import-export.png
new file mode 100644
index 0000000..a4f6e88
Binary files /dev/null and b/images/C/preferences/prefs-image-import-export.png differ
diff --git a/images/C/preferences/prefs-image-window-snapping.png 
b/images/C/preferences/prefs-image-window-snapping.png
new file mode 100644
index 0000000..432e649
Binary files /dev/null and b/images/C/preferences/prefs-image-window-snapping.png differ
diff --git a/images/C/preferences/prefs-list.png b/images/C/preferences/prefs-list.png
index 269354d..99b1f09 100644
Binary files a/images/C/preferences/prefs-list.png and b/images/C/preferences/prefs-list.png differ
diff --git a/images/C/preferences/prefs-toolbox.png b/images/C/preferences/prefs-toolbox.png
old mode 100755
new mode 100644
index bdc0018..97933f7
Binary files a/images/C/preferences/prefs-toolbox.png and b/images/C/preferences/prefs-toolbox.png differ
diff --git a/images/C/preferences/prefs-window-management.png 
b/images/C/preferences/prefs-window-management.png
index 29b31df..6f5d252 100644
Binary files a/images/C/preferences/prefs-window-management.png and 
b/images/C/preferences/prefs-window-management.png differ
diff --git a/src/using/preferences/preferences_introduction.xml 
b/src/using/preferences/preferences_introduction.xml
index 33000a7..6d32c83 100644
--- a/src/using/preferences/preferences_introduction.xml
+++ b/src/using/preferences/preferences_introduction.xml
@@ -53,13 +53,16 @@
   <xi:include href="prefs-default-grid.xml"/>
   <xi:include href="prefs-interface.xml"/>
   <xi:include href="prefs-theme.xml"/>
+  <xi:include href="prefs-icon-theme.xml"/>
   <xi:include href="prefs-toolbox.xml"/>
+  <xi:include href="prefs-dialog-defaults.xml"/>
   <xi:include href="prefs-help.xml"/>
   <xi:include href="prefs-display.xml"/>
   <xi:include href="prefs-window-management.xml"/>
   <xi:include href="prefs-image-window.xml"/>
   <xi:include href="prefs-image-window-appearance.xml"/>
   <xi:include href="prefs-image-window-title.xml"/>
+  <xi:include href="prefs-image-window-snapping.xml"/>
   <xi:include href="prefs-input-devices.xml"/>
   <xi:include href="prefs-input-controllers.xml"/>
   <xi:include href="prefs-folders.xml"/>
diff --git a/src/using/preferences/prefs-default-image.xml b/src/using/preferences/prefs-default-image.xml
index 2f160a4..aa67531 100644
--- a/src/using/preferences/prefs-default-image.xml
+++ b/src/using/preferences/prefs-default-image.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+                       "http://www.docbook.org/xml/4.5/docbookx.dtd";>
 <!--  section history:
   2017-02-09 j.h Update
 -->
diff --git a/src/using/preferences/prefs-dialog-defaults.xml b/src/using/preferences/prefs-dialog-defaults.xml
new file mode 100644
index 0000000..28e82bf
--- /dev/null
+++ b/src/using/preferences/prefs-dialog-defaults.xml
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+                       "http://www.docbook.org/xml/4.5/docbookx.dtd";>
+<!-- section history
+  2017-12-17 j.h Created 
+-->
+<sect2 id="gimp-prefs-dialog-defaults">
+  <title>Dialog Defaults</title>
+
+  <indexterm>
+    <primary>Preferences</primary>
+    <secondary>Dialog defaults</secondary>
+  </indexterm>
+
+  <figure>
+    <title>Dialog Default</title>
+    <mediaobject>
+      <imageobject>
+        <imagedata format="PNG"
+          fileref="images/preferences/prefs-dialog-defaults.png"/>
+      </imageobject>
+      <caption>
+        <para>
+          This page lets you customize the default parameters of dialogs.
+        </para>
+      </caption>
+    </mediaobject>
+  </figure>
+  
+</sect2>
\ No newline at end of file
diff --git a/src/using/preferences/prefs-help.xml b/src/using/preferences/prefs-help.xml
index e1a45e3..b771b62 100644
--- a/src/using/preferences/prefs-help.xml
+++ b/src/using/preferences/prefs-help.xml
@@ -1,13 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+                       "http://www.docbook.org/xml/4.5/docbookx.dtd";>
 <!--  section history:
-  2009-03-19 j.h: added "User manual"
-  2008-04-09 Mr.Dust : added 'ko'
-  2007-09-29 AntI: Added 'es'
-  2007-03-23 KoSt: added 'no'
-  2006-11-01 lexa: made the file docbook compliant
-  2008-01-28 jpl: update text & images
+  2017-02-17 j.h: Update
 -->
 <sect2 id="gimp-prefs-help">
   <title>Help System</title>
@@ -63,30 +58,7 @@
           </para>
         </listitem>
       </varlistentry>
-<!--
-      <varlistentry>
-        <term>Show tips on start-up</term>
-        <listitem>
-          <para>
-            Start-up tips are helpful hints that appear each time you start
-            GIMP. You can switch them on or off here. If you have switched
-            them off by unchecking
-            <quote>Show tip next time GIMP starts</quote>
-            in the tip window, you can switch them back on by checking here.
-            Whatever you decide to do, at some point you should take the time
-            to go through the list of tips: they are considered to be very
-            useful, and the things they tell you are not easy to discover by
-            experimenting. If you prefer, you can read them at any time by
-            choosing
-            <menuchoice>
-              <guimenu>Help</guimenu>
-              <guimenuitem>Tip of the Day</guimenuitem>
-            </menuchoice>
-            in the image menu.
-          </para>
-        </listitem>
-      </varlistentry>
--->
+
       <varlistentry>
         <term>User manual</term>
         <listitem>
@@ -124,5 +96,35 @@
         </listitem>
       </varlistentry>
     </variablelist>
+    
+    <variablelist>
+      <title>Action Search</title>
+      <varlistentry>
+        <term>Maximum History Size</term>
+        <listitem>
+          <para>
+            Default value is 100 (0-1000) items in the history.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Show unavailable actions</term>
+        <listitem>
+          <para>
+            When this check-box is enabled, a search of actions will also 
+            return inactive actions.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Clear Action History</term>
+        <listitem>
+          <para>
+            Self-explanatory.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+      
   </sect3>
 </sect2>
diff --git a/src/using/preferences/prefs-icon-theme.xml b/src/using/preferences/prefs-icon-theme.xml
new file mode 100644
index 0000000..90650cc
--- /dev/null
+++ b/src/using/preferences/prefs-icon-theme.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
+"http://www.docbook.org/xml/4.5/docbookx.dtd";>
+<!--Section History
+  2017-02-21 j.h: created
+-->
+<sect2 id="gimp-prefs-icon-theme">
+  <title>Theme</title>
+  <indexterm>
+    <primary>Preferences</primary>
+    <secondary>Icon Theme</secondary>
+  </indexterm>
+  <indexterm>
+    <primary>Icon Theme</primary>
+  </indexterm>
+
+  <figure>
+    <title>Icon Theme Preference</title>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="images/preferences/prefs-icon-theme.png" 
+format="PNG"/>
+      </imageobject>
+    </mediaobject>
+  </figure>
+  
+  <para>
+    This page lets you select a theme for the icons of the GIMP user interface. 
+    Test them: you will see the result instantly in this preference dialog.
+  </para>
+  
+</sect2>
diff --git a/src/using/preferences/prefs-image-window-snapping.xml 
b/src/using/preferences/prefs-image-window-snapping.xml
new file mode 100644
index 0000000..4f91873
--- /dev/null
+++ b/src/using/preferences/prefs-image-window-snapping.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
+"http://www.docbook.org/xml/4.5/docbookx.dtd";>
+<!--  section history:
+  2017-02-18  j.h: created
+-->
+<sect2 id="gimp-prefs-image-window-snapping">
+  <title>Image Window Snapping Behavior</title>
+  <indexterm>
+    <primary>Preferences</primary>
+    <secondary>Snapping</secondary>
+  </indexterm>
+  <indexterm>
+    <primary>Snapping</primary>
+  </indexterm>
+
+  <figure>
+    <title>Image Window Title and Statusbar formats</title>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="images/preferences/prefs-image-window-snapping.png" 
+format="PNG"/>
+      </imageobject>
+    </mediaobject>
+  </figure>
+
+  <para>
+    This page allows you to customize snapping in the image. Only 
+    <guilabel>Snap to Guides</guilabel> is activated by default. You can also 
+    check <guilabel>Snap to Grid</guilabel>, <guilabel>Snap to 
+    Canvas Edges</guilabel> and <guilabel>Snap to Active Path</guilabel>, 
+    in normal mode and fullscreen mode.
+  </para>
+  <para>
+    <guilabel>Snapping distance</guilabel> is the activation distance of 
+    snapping, in pixels. Default value is 8 pixels (1-255).
+  </para>
+   
+</sect2>
\ No newline at end of file
diff --git a/src/using/preferences/prefs-image-window-title.xml 
b/src/using/preferences/prefs-image-window-title.xml
index edae214..2802dbe 100644
--- a/src/using/preferences/prefs-image-window-title.xml
+++ b/src/using/preferences/prefs-image-window-title.xml
@@ -1,10 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
+"http://www.docbook.org/xml/4.5/docbookx.dtd";>
 <!--  section history:
-  2008-04-27 Mr.Dust : added 'ko'
-  2007-09-30 AntI: Added 'es'
-  2007-03-24 KoSt: added 'no'
-  2006-11-01 lexa: made the file docbook compliant
+  2017-02-18  Nothing to do
 -->
 <sect2 id="gimp-prefs-image-window-title">
   <title>Image Window Title and Statusbar</title>
diff --git a/src/using/preferences/prefs-input-controllers.xml 
b/src/using/preferences/prefs-input-controllers.xml
index aa4eca3..b7c2d53 100644
--- a/src/using/preferences/prefs-input-controllers.xml
+++ b/src/using/preferences/prefs-input-controllers.xml
@@ -1,11 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
+"http://www.docbook.org/xml/4.5/docbookx.dtd";>
 <!--Version history
-  2008-07-15 Mr.Dust : added 'ko'
-  2008-02-04 Vérification + compléments par jpl in french
-  2007-03-25 KoSt: added 'no'
-  2006-08-18 added italian translation by ciampix
-  2006-04-16 Created by j.h
+  2017-02-19 j.h : updateh
 -->
 <sect2 id="gimp-prefs-input-controllers">
   <title>Input Controllers</title>
@@ -28,7 +25,8 @@
   <para>
     This dialog has two lists of additional input controllers:
     <guilabel>Available Controllers</guilabel> on the left,
-    <guilabel>Active Controllers</guilabel> on the right.
+    <guilabel>Active Controllers</guilabel> on the right. It is used to 
+    enable or disable an input device and configure it.
   </para>
   <para>
     A click on an item will highlight it and you can move the controller from
diff --git a/src/using/preferences/prefs-input-devices.xml b/src/using/preferences/prefs-input-devices.xml
index 1d6b50b..aafdf13 100644
--- a/src/using/preferences/prefs-input-devices.xml
+++ b/src/using/preferences/prefs-input-devices.xml
@@ -1,12 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
+"http://www.docbook.org/xml/4.5/docbookx.dtd";>
 <!--Version history
-  2008-07-15 Mr.Dust : added 'ko'
-  2007-09-29 AntI: Added 'es'
-  2007-03-25 KoSt: added 'no'
-  2006-09-18 lexa: added de translation
-  2006-08-19 Added italian translation by ciampix
-  2006-04-16 Created by j.h
+  2017-02-19 j.h : update
 -->
 <sect2 id="gimp-prefs-input-devices">
   <title>Input Devices</title>
@@ -30,6 +26,17 @@
   <variablelist>
     <title>Extended Input Devices</title>
     <varlistentry>
+      <term>Share tool and tool options between input devices</term>
+      <listitem>
+        <para>
+          When enabled, the same tool and tool options will be used for all 
+          input devices. No tool switching will occur when the input device 
+          changes.
+        </para>
+      </listitem>
+    </varlistentry>
+    
+    <varlistentry>
       <term>Configure Extended Input Devices</term>
       <listitem>
         <para>
@@ -47,6 +54,7 @@
         </figure>
       </listitem>
     </varlistentry>
+    
     <varlistentry>
       <term>Save input device settings on exit</term>
       <listitem>
@@ -62,6 +70,7 @@
         <para>Self explanatory.</para>
       </listitem>
     </varlistentry>
+    
     <varlistentry>
       <term>
         Reset Saved Input Device Settings to Default Values
diff --git a/src/using/preferences/prefs-theme.xml b/src/using/preferences/prefs-theme.xml
index ba3f6ab..5a8b734 100644
--- a/src/using/preferences/prefs-theme.xml
+++ b/src/using/preferences/prefs-theme.xml
@@ -1,17 +1,14 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
+"http://www.docbook.org/xml/4.5/docbookx.dtd";>
 <!--Section History
-  2008-04-09 Mr.Dust : added 'ko'
-  2007-09-29 AntI: Added 'es'
-  2006-01-02: fixed image scaling and made the file docbook compliant by lexa
-  2008-01-28 jpl: update text & images
+  2017-02-21 j.h: update
 -->
 <sect2 id="gimp-prefs-theme">
   <title>Theme</title>
   <indexterm>
-    <primary>Dialogs</primary>
-    <secondary>Preferences</secondary>
-    <tertiary>Theme</tertiary>
+    <primary>Preferences</primary>
+    <secondary>Theme</secondary>
   </indexterm>
   <indexterm>
     <primary>Theme</primary>
@@ -27,33 +24,9 @@
   </figure>
   <para>
     This page lets you select a theme, which determines many aspects of
-    the appearance of the GIMP user interface, including the set of
-    icons used, their sizes, fonts, spacing allowed in dialogs, etc.
-    Two themes are supplied with GIMP: <guilabel>Default</guilabel>,
-    which is probably best for most people, and
-    <guilabel>Small</guilabel>, which may be preferable for those with
-    small or low-resolution monitors.  Clicking on a theme in the list
+    the appearance of the GIMP user interface. Clicking on a theme in the list
     causes it to be applied immediately, so it is easy to see the result
     and change your mind if you don't like it.
   </para>
-  <para>
-    You can also use custom themes, either by downloading them from the
-    net, or by copying one of the supplied themes and modifying it.
-    Custom themes should be places in the <filename>themes</filename>
-    subdirectory of your personal GIMP directory:  if they are, they
-    will appear in the list here.  Each theme is actually a directory
-    containing ASCII files that you can edit.  They are pretty
-    complicated, and the meaning of the contents goes beyond the scope
-    of this documentation, but you should feel free to experiment:  in
-    the worst case, if you mess things up completely, you can always
-    revert back to one of the supplied themes.
-  </para>
-  <para>
-    You cannot edit the supplied themes unless you have administrator
-    permissions, and even if you do, you shouldn't:  if you want to
-    customize a theme, make a copy in your personal directory and work
-    on it.  If you make a change and would like to see the result <quote>on
-    the fly</quote>, you can do so by saving the edited theme file and then
-    pressing <guilabel>Reload Current Theme</guilabel>.
-  </para>
+  
 </sect2>
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]