Permalink
Browse files

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.
  • Loading branch information...
1 parent 06c1b34 commit cfdedf4e678a19f157f981de0777491c97098f2d @codebrainz codebrainz committed Jun 4, 2012
Showing with 18 additions and 8 deletions.
  1. +1 −1 data/geany.glade
  2. +17 −6 doc/geany.html
  3. +0 −1 doc/geany.txt
View
@@ -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>
View
@@ -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 &quot;reST&quot;). 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 &quot;<tt class="docutils literal">make doc</tt>&quot; 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 &quot;<tt class="docutils literal">make pdf</tt>&quot; 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 &gt; foo.patch
+% git diff geany.txt &gt; 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>
View
@@ -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.

0 comments on commit cfdedf4

Please sign in to comment.