Update installation instructions

diff --git a/ChangeLog b/ChangeLog
index ecc2637..2bcfa4b 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,220 @@
+commit 39cbcfb55eb391a008c0571e8ad67fc703bac759
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Tue Sep 26 18:42:37 2017 +0100
+
+    Do not send debug data to terminal
+    
+    When running Geeqie from the terminal, a user sees irrelevant messages
+    and when debugging the window gets clogged with unnecessary data.
+    The log window - or log file - contains all debug output anyway.
+
+commit e014563ac8cf2dc36950e1893cf63ab83bb56883
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Tue Sep 26 11:27:32 2017 +0100
+
+    Bug fix: Initialise map coordinates to gdouble
+
+commit 8fc4a35a59fe001fa33fa9c09283fd44f29320d9
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Sat Sep 23 11:35:02 2017 +0100
+
+    Addl Fix #508: Copy and Move windows scale incorrectly
+    
+    https://github.com/BestImageViewer/geeqie/issues/508
+
+commit 86405b9df271184c9feb49e2e9a73b0205d0d87d
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Sat Sep 23 11:01:45 2017 +0100
+
+    Bug fix: Failed editor call blocks further actions
+    
+    When a call to an external editor fails, cancel the action so that
+    further editors can be called
+
+commit b517279681b4da40a17cf63278585c90c483f9e1
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Sat Sep 23 10:53:10 2017 +0100
+
+    Fix #518: [raw file] -> External Editor -> RawTerapee can't be started
+    
+    https://github.com/BestImageViewer/geeqie/issues/518
+    
+    Additional mime types
+
+commit b801467db508b8708d98a27a810d0c266f62b076
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Fri Sep 22 17:43:07 2017 +0100
+
+    Slideshow delay in hrs-mins-secs
+
+commit 44b347085e7fa40d0d6d8facb6adf9a0519ffb4d
+Author: ilexiris <>
+Date:   Thu Sep 21 11:30:39 2017 +0100
+
+    Fix #517: Fix checkbox falling out of sync
+    
+    https://github.com/BestImageViewer/geeqie/pull/517
+
+commit 79917d0d883e50e77960f016a1f9816137c4c0de
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Tue Sep 19 09:51:20 2017 +0100
+
+    Bug fix: Segfault in pan view
+    
+    If an image is double-clicked in pan view, Geeqie crashes
+
+commit 776d9f6b72bcca6de52a53b33285b38b5e75ec85
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Mon Sep 18 12:00:54 2017 +0100
+
+    Fix #512: The "Back" button does not operate correctly
+    
+    https://github.com/BestImageViewer/geeqie/issues/512
+    
+    Include a Forward button also
+
+commit a685bfbc38ddf9b08b9213ab09dcc5130368422f
+Author: Klaus Ethgen <Klaus@Ethgen.de>
+Date:   Sun Sep 17 15:53:47 2017 +0100
+
+    Fix the implicit-fallthrough stuff in code
+    
+    First, this flag was not supported by older gcc.
+    
+    And second and more important, there _was_ a bug with a lost break in
+    9643a2546bcc. Combined with a unreachable code segment.
+
+commit f6566dd20a51228bb293a303a9298c0e495828b2
+Author: Klaus Ethgen <Klaus@Ethgen.de>
+Date:   Sun Sep 17 15:12:21 2017 +0100
+
+    Fix writing to meta files
+    
+    Some time ago, this seemed to break. It should never have worked as it
+    took the image extension and compare it to "...meta".
+
+commit 1f007a8cf9b8d48bffac59d6b87e3917ab95a15e
+Author: Klaus Ethgen <Klaus@Ethgen.de>
+Date:   Sun Sep 17 13:45:42 2017 +0100
+
+    Remove some stuff that is throwing errors in gcc-7
+    
+    New gcc warns (and errors with -Werror) if there are unused functions or
+    variables.
+    
+    - Remove two leftover functions from ae34634113b2
+    - Remove definition made to much in 035c3253ded5
+    - Remove two variable definitions made in b0b11291d2c9
+    - Remove not really used function in 15917d4063ce
+    - Remove two variable definitions made in 5ed2574fb8cc
+    - Remove variable definition made in efe0e6a38273
+    - Remove variable definition made in c95bd6996583 and since then removed
+      usage
+    - Remove unused variable definition made in bc02fd0eb0d9
+    - Remove unused variable definition made in 324129463b17
+    - Remove two variables left over from fe69cac65ad4 (Pretty old code from
+      John Ellis)
+    - Remove some functions not used anymore with one obsolete variable
+    - Remove Variables introduced in 8746b22d3ed1 and 51a9455bd33f
+    - Fix missed change in definition in 6e3b2edff8cf
+    - Remove unused function from 63a96f8504a2
+    - Remove unused function from c6bdbaa559c7 (Pretty old code)
+
+commit 286b68b24417f9290353189c4795dc381318f1c3
+Author: Klaus Ethgen <Klaus@Ethgen.de>
+Date:   Sun Sep 17 13:37:10 2017 +0100
+
+    Fix configure error with gcc-7
+
+commit 2a4c92c70bbf16fb4de1e0d105ac8b0f12f31d06
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Sun Sep 17 10:33:08 2017 +0100
+
+    Revise DEBUG_0() usage
+    
+    Replace all DEBUG_0() calls with log_printf() or another debug level.
+    This will stop the user seeing irrelevant debug output
+    when the debug level is set to the default of 0.
+
+commit 05b71bc25f0b232d2d95594a111c7f70e4237342
+Author: Matthias Andree <matthias.andree@gmx.de>
+Date:   Sat Sep 16 18:23:08 2017 +0200
+
+    Fix out-of-path (VPATH) builds.
+
+commit 989a7a609ac3cf6584324cc6d1319457b186003d
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Sat Sep 16 20:30:53 2017 +0100
+
+    Update log window output
+    
+    Implement message text colors in GTK3
+    
+    For log_printf(), if the first word of the message is "error" or
+    "warning" (case insensitive), display the message with the appropriate
+    color-coding
+
+commit f6831eee50823092bfbc63d45d90286371623300
+Author: Tomasz Golinski <tomaszg@math.uwb.edu.pl>
+Date:   Sat Sep 16 20:18:35 2017 +0100
+
+    Bug fix #509: Increase number of marks to 10
+    
+    https://github.com/BestImageViewer/geeqie/issues/509
+
+commit db9a2d6055de1f5203ee899a83dbd2c9b40c2d91
+Author: Tomasz Golinski <tomaszg@math.uwb.edu.pl>
+Date:   Sat Sep 16 20:12:22 2017 +0100
+
+    Bug fix: Marks checkboxes in iconview
+    
+    The width of the marks checkboxes was not taken into account in icon view mode
+
+commit 9be75e3431104d6a3a0c80324a8e3ac60316be13
+Author: Tomasz Golinski <tomaszg@math.uwb.edu.pl>
+Date:   Thu Sep 14 10:38:09 2017 +0100
+
+    Addl #510: Rudimentary video support
+    
+    https://github.com/BestImageViewer/geeqie/issues/510
+    
+    Add video files extension to default file filter (disabled by default).
+    Use recorded format_class in fd in metadata.c
+    Do not try to generate/read thumb for files which are not images.
+
+commit d33e0f6aaf3be452f96a68c7424fe05a433d3144
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Wed Sep 13 11:21:58 2017 +0100
+
+    Ref #510: Rudimentary video support
+    
+    https://github.com/BestImageViewer/geeqie/issues/510
+    
+    Implement icons for FORMAT_CLASS
+
+commit bc02fd0eb0d94c078621c59ae23ce8b70da0efd6
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Mon Sep 11 18:19:46 2017 +0100
+
+    Optional timer data in log window
+
+commit babefee67961a4c6c9dd8e66c5bca4a6fd979e07
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Sun Sep 10 19:24:20 2017 +0100
+
+    Save Collection window geometry
+    
+    Previously collection window geometry was preserved only when an
+    explicit save was made.
+    This patch ensures the window position is always saved, unless the
+    window has unsaved data.
+
+commit a7c22f9fa47e177876dc13318f9f5142421e24da
+Author: Colin Clark <colin.clark@cclark.uk>
+Date:   Sun Sep 10 11:11:00 2017 +0100
+
+    Update documentation for autogen.sh options
+
 commit 876de3dbfdc0f72d3ac245cb35837118b7af6c2d
 Author: Colin Clark <colin.clark@cclark.uk>
 Date:   Sun Sep 10 10:57:20 2017 +0100

diff --git a/ChangeLog.html b/ChangeLog.html
index 38995b8..4b193d1 100644 (file)
--- a/ChangeLog.html
+++ b/ChangeLog.html
@@ -1,3 +1,26 @@
+<li>2017-09-26  <a href="http://github.com/BestImageViewer/Geeqie/commit/39cbcfb55eb391a008c0571e8ad67fc703bac759">view commit </a> Do not send debug data to terminal </li> 
+<li>2017-09-26  <a href="http://github.com/BestImageViewer/Geeqie/commit/e014563ac8cf2dc36950e1893cf63ab83bb56883">view commit </a> Bug fix: Initialise map coordinates to gdouble </li> 
+<li>2017-09-23  <a href="http://github.com/BestImageViewer/Geeqie/commit/8fc4a35a59fe001fa33fa9c09283fd44f29320d9">view commit </a> Addl Fix #508: Copy and Move windows scale incorrectly </li> 
+<li>2017-09-23  <a href="http://github.com/BestImageViewer/Geeqie/commit/86405b9df271184c9feb49e2e9a73b0205d0d87d">view commit </a> Bug fix: Failed editor call blocks further actions </li> 
+<li>2017-09-23  <a href="http://github.com/BestImageViewer/Geeqie/commit/b517279681b4da40a17cf63278585c90c483f9e1">view commit </a> Fix #518: [raw file] -> External Editor -> RawTerapee can't be started </li> 
+<li>2017-09-22  <a href="http://github.com/BestImageViewer/Geeqie/commit/b801467db508b8708d98a27a810d0c266f62b076">view commit </a> Slideshow delay in hrs-mins-secs </li> 
+<li>2017-09-21  <a href="http://github.com/BestImageViewer/Geeqie/commit/44b347085e7fa40d0d6d8facb6adf9a0519ffb4d">view commit </a> Fix #517: Fix checkbox falling out of sync </li> 
+<li>2017-09-19  <a href="http://github.com/BestImageViewer/Geeqie/commit/79917d0d883e50e77960f016a1f9816137c4c0de">view commit </a> Bug fix: Segfault in pan view </li> 
+<li>2017-09-18  <a href="http://github.com/BestImageViewer/Geeqie/commit/776d9f6b72bcca6de52a53b33285b38b5e75ec85">view commit </a> Fix #512: The "Back" button does not operate correctly </li> 
+<li>2017-09-17  <a href="http://github.com/BestImageViewer/Geeqie/commit/a685bfbc38ddf9b08b9213ab09dcc5130368422f">view commit </a> Fix the implicit-fallthrough stuff in code </li> 
+<li>2017-09-17  <a href="http://github.com/BestImageViewer/Geeqie/commit/f6566dd20a51228bb293a303a9298c0e495828b2">view commit </a> Fix writing to meta files </li> 
+<li>2017-09-17  <a href="http://github.com/BestImageViewer/Geeqie/commit/1f007a8cf9b8d48bffac59d6b87e3917ab95a15e">view commit </a> Remove some stuff that is throwing errors in gcc-7 </li> 
+<li>2017-09-17  <a href="http://github.com/BestImageViewer/Geeqie/commit/286b68b24417f9290353189c4795dc381318f1c3">view commit </a> Fix configure error with gcc-7 </li> 
+<li>2017-09-17  <a href="http://github.com/BestImageViewer/Geeqie/commit/2a4c92c70bbf16fb4de1e0d105ac8b0f12f31d06">view commit </a> Revise DEBUG_0() usage </li> 
+<li>2017-09-16  <a href="http://github.com/BestImageViewer/Geeqie/commit/05b71bc25f0b232d2d95594a111c7f70e4237342">view commit </a> Fix out-of-path (VPATH) builds. </li> 
+<li>2017-09-16  <a href="http://github.com/BestImageViewer/Geeqie/commit/989a7a609ac3cf6584324cc6d1319457b186003d">view commit </a> Update log window output </li> 
+<li>2017-09-16  <a href="http://github.com/BestImageViewer/Geeqie/commit/f6831eee50823092bfbc63d45d90286371623300">view commit </a> Bug fix #509: Increase number of marks to 10 </li> 
+<li>2017-09-16  <a href="http://github.com/BestImageViewer/Geeqie/commit/db9a2d6055de1f5203ee899a83dbd2c9b40c2d91">view commit </a> Bug fix: Marks checkboxes in iconview </li> 
+<li>2017-09-14  <a href="http://github.com/BestImageViewer/Geeqie/commit/9be75e3431104d6a3a0c80324a8e3ac60316be13">view commit </a> Addl #510: Rudimentary video support </li> 
+<li>2017-09-13  <a href="http://github.com/BestImageViewer/Geeqie/commit/d33e0f6aaf3be452f96a68c7424fe05a433d3144">view commit </a> Ref #510: Rudimentary video support </li> 
+<li>2017-09-11  <a href="http://github.com/BestImageViewer/Geeqie/commit/bc02fd0eb0d94c078621c59ae23ce8b70da0efd6">view commit </a> Optional timer data in log window </li> 
+<li>2017-09-10  <a href="http://github.com/BestImageViewer/Geeqie/commit/babefee67961a4c6c9dd8e66c5bca4a6fd979e07">view commit </a> Save Collection window geometry </li> 
+<li>2017-09-10  <a href="http://github.com/BestImageViewer/Geeqie/commit/a7c22f9fa47e177876dc13318f9f5142421e24da">view commit </a> Update documentation for autogen.sh options </li> 
 <li>2017-09-10  <a href="http://github.com/BestImageViewer/Geeqie/commit/876de3dbfdc0f72d3ac245cb35837118b7af6c2d">view commit </a> Add Collections to Shortcuts bar </li> 
 <li>2017-09-10  <a href="http://github.com/BestImageViewer/Geeqie/commit/435f7c0f0b85c97cb25c50ef4e842692e08210f3">view commit </a> Addl Fix #508: Copy and Move windows scale incorrectly </li> 
 <li>2017-09-09  <a href="http://github.com/BestImageViewer/Geeqie/commit/ba8b5dd931b939dda5becc944b36a399966906fe">view commit </a> Reverse autogen.sh default map option </li> 

diff --git a/README.html b/README.html
index ba346ac..3bea311 100644 (file)
--- a/README.html
+++ b/README.html
@@ -101,12 +101,26 @@ open an issue on <a href="https://github.com/BestImageViewer/geeqie/issues">Geeq
 <p>Common options:
 <code>./autogen.sh --disable-gtk3</code>,</p>
 
-<p>Compilation: <code>./autogen.sh [options]; make</code></p>
+<p>Compilation: <code>./autogen.sh [options]; make -j&lt;no. of cpu cores&gt;</code></p>
 
 <p>Install: <code>[sudo] make install</code></p>
 
 <p>Removal: <code>[sudo] make uninstall</code></p>
 
+<h4>Note:</h4>
+
+<p>The zip files at GitHub contain only the sources - they cannot, by themselves, be used to install Geeqie.</p>
+
+<p>It is recommended to always use <code>git clone  git://www.geeqie.org/geeqie.git</code> to download Geeqie. After installing Geeqie you may delete the folder you have cloned Geeqie into.</p>
+
+<p>However if you leave the folder intact, whenever new features or patches are available, execute:</p>
+
+<p><code>git pull; sudo make uninstall; sudo make distclean; ./autogen.sh; make -j&lt;no. of cpu cores&gt;; sudo make install</code></p>
+
+<p>Only the changed sources are downloaded, which makes this a quick operation.</p>
+
+<p>Your configuration file, history file and desktop files are not affected by this process.</p>
+
 <h2>Notes and changes for the latest release</h2>
 
 <p>See the NEWS file in the installation folder, or <a href="https://github.com/BestImageViewer/geeqie/blob/master/NEWS">Geeqie News at GitHub</a></p>

diff --git a/README.md b/README.md
index 96fb62f..e89198e 100644 (file)
--- a/README.md
+++ b/README.md
@@ -119,12 +119,26 @@ List compile options: `./autogen.sh --help`
 Common options:
 `./autogen.sh --disable-gtk3`,
 
-Compilation: `./autogen.sh [options]; make`
+Compilation: `./autogen.sh [options]; make -j<no. of cpu cores> `
 
 Install: `[sudo] make install`
 
 Removal: `[sudo] make uninstall`
 
+#### Note:
+The zip files at GitHub contain only the sources - they cannot, by themselves, be used to install Geeqie.
+
+It is recommended to always use `git clone  git://www.geeqie.org/geeqie.git` to download Geeqie. After installing Geeqie you may delete the folder you have cloned Geeqie into.
+
+However if you leave the folder intact, whenever new features or patches are available, execute:
+
+`git pull; sudo make uninstall; sudo make distclean; ./autogen.sh; make -j<no. of cpu cores>; sudo make install`
+
+Only the changed sources are downloaded, which makes this a quick operation.
+
+Your configuration file, history file and desktop files are not affected by this process.
+
+
 
 ## Notes and changes for the latest release