[geany/geany] cfdedf: Remove sentence from documentation that doesn't apply anymore

[Matthew Brush]

Branch:      refs/heads/document-messages
Author:      Matthew Brush <matt at geany.org>
Committer:   Matthew Brush <matt at geany.org>
Date:        Mon, 04 Jun 2012 21:07:41
Commit:      cfdedf4e678a19f157f981de0777491c97098f2d
             https://github.com/geany/geany/commit/cfdedf4e678a19f157f981de0777491c97098f2d

Log Message:
-----------
Remove sentence from documentation that doesn't apply anymore

With newer GTK+ releases, leaving this field blank causes the "Recent
Files" "feature" to be used rather the the expected current working
directory. No replacement text added to explain the new behaviour since
it would be incorrect with older GTK+ versions, would likely be incorrect
on Windows with native dialogs and it will possibly be reverted in GTK+
in the future.

Recenerate HTML manual, including previous changes from other commits.


Modified Paths:
--------------
    data/geany.glade
    doc/geany.html
    doc/geany.txt

Modified: data/geany.glade
2 files changed, 1 insertions(+), 1 deletions(-)
===================================================================
@@ -997,7 +997,7 @@
                                   <object class="GtkEntry" id="startup_path_entry">
                                     <property name="visible">True</property>
                                     <property name="can_focus">True</property>
-                                    <property name="tooltip_text" translatable="yes">Path to start in when opening or saving files. Must be an absolute path. Leave blank to use the current working directory.</property>
+                                    <property name="tooltip_text" translatable="yes">Path to start in when opening or saving files. Must be an absolute path.</property>
                                     <property name="invisible_char">•</property>
                                     <property name="primary_icon_activatable">False</property>
                                     <property name="secondary_icon_activatable">False</property>


Modified: doc/geany.html
23 files changed, 17 insertions(+), 6 deletions(-)
===================================================================
@@ -2159,8 +2159,7 @@ <h2 class="subtitle" id="a-fast-light-gtk-ide">A fast, light, GTK+ IDE</h2>
 <dl class="docutils">
 <dt>Startup path</dt>
 <dd>Path to start in when opening or saving files.
-It must be an absolute path.
-Leave it blank to use the current working directory.</dd>
+It must be an absolute path.</dd>
 <dt>Project files</dt>
 <dd>Path to start in when opening project files.</dd>
 <dt>Extra plugin path</dt>
@@ -5982,17 +5981,29 @@ <h2 class="subtitle" id="a-fast-light-gtk-ide">A fast, light, GTK+ IDE</h2>
 <p>This document (<tt class="docutils literal">geany.txt</tt>) is written in <a class="reference external" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a>
 (or "reST"). The source file for it is located in Geany's <tt class="docutils literal">doc</tt>
 subdirectory.  If you intend on making changes, you should grab the
-source right from SVN to make sure you've got the newest version. After
+source right from Git to make sure you've got the newest version. After
 editing the file, to build the HTML document to see how your changes
 look, run "<tt class="docutils literal">make doc</tt>" in the subdirectory <tt class="docutils literal">doc</tt> of Geany's source
 directory. This regenerates the <tt class="docutils literal">geany.html</tt> file. To generate a PDF
 file, use the command "<tt class="docutils literal">make pdf</tt>" which should generate a file called
 geany-1.22.pdf.</p>
-<p>After you are happy with your changes, create a patch:</p>
+<p>After you are happy with your changes, create a patch e.g. by using:</p>
 <pre class="literal-block">
-% svn diff geany.txt > foo.patch
+% git diff geany.txt > foo.patch
+</pre>
+<p>or even better, by creating a Git-formatted patch which will keep authoring
+and description data, by first committing your changes (doing so in a fresh
+new branch is recommended for <cite>matser</cite> not to diverge from upstream) and then
+using git format-patch:</p>
+<pre class="literal-block">
+% git checkout -b my-documentation-changes # create a fresh branch
+% git commit geany.txt
+Write a good commit message...
+% git format-patch HEAD^
+% git checkout master # go back to master
 </pre>
 <p>and then submit that file to the mailing list for review.</p>
+<p>Also you can clone the Geany repository at GitHub and send a pull request.</p>
 <p>Note, you will need the Python docutils software package installed
 to build the docs. The package is named <tt class="docutils literal"><span class="pre">python-docutils</span></tt> on Debian
 and Fedora systems.</p>
@@ -6776,7 +6787,7 @@ <h2 class="subtitle" id="a-fast-light-gtk-ide">A fast, light, GTK+ IDE</h2>
 <div class="footer">
 <hr class="footer" />
 <a class="reference external" href="geany.txt">View document source</a>.
-Generated on: 2012-04-25 14:39 UTC.
+Generated on: 2012-06-04 21:07 UTC.
 Generated by <a class="reference external" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference external" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.
 
 </div>


Modified: doc/geany.txt
1 files changed, 0 insertions(+), 1 deletions(-)
===================================================================
@@ -1763,7 +1763,6 @@ Paths
 Startup path
     Path to start in when opening or saving files.
     It must be an absolute path.
-    Leave it blank to use the current working directory.
 
 Project files
     Path to start in when opening project files.


@@ Diff output truncated at 100000 characters. @@


--------------
This E-Mail was brought to you by github_commit_mail.py (Source: TBD).