Branch: master

47234bdb 2019-08-24 01:57:30 Michele Calgaro
Kate docbook: updated section related to General options.

Signed-off-by: Michele Calgaro <michele.calgaro@...>
M doc/kate/configdialog01.png
M doc/kate/configdialog02.png
M doc/kate/configuring.docbook
M doc/kate/highlighting.docbook

doc/kate/configdialog01.png

diff --git a/doc/kate/configdialog01.png b/doc/kate/configdialog01.png
index 17e22d7..baf5e13 100644
--- a/doc/kate/configdialog01.png
+++ b/doc/kate/configdialog01.png
Binary files differ

doc/kate/configdialog02.png

diff --git a/doc/kate/configdialog02.png b/doc/kate/configdialog02.png
index 70a7eca..d0d8f41 100644
--- a/doc/kate/configdialog02.png
+++ b/doc/kate/configdialog02.png
Binary files differ

doc/kate/configuring.docbook

diff --git a/doc/kate/configuring.docbook b/doc/kate/configuring.docbook
index f7cd3bf..7cac747 100644
--- a/doc/kate/configuring.docbook
+++ b/doc/kate/configuring.docbook
@@ -82,23 +82,69 @@
 
 <sect2 id="config-dialog-general">
 <title>The General Page</title>
-<para>This section contains a few global options for &kate;</para>
+<para>This section contains a few global options for &kate;.</para>
 
 <variablelist>
 
 <varlistentry>
+<term><anchor id="config-general-appearance"/>
+<guilabel>Appearance</guilabel></term>
+<listitem>
+<variablelist>
+
+<varlistentry>
 <term><anchor id="config-dialog-general-show-full-path" />
-<guilabel>Show Full Path in Title</guilabel></term>
+<guilabel>Show full path in title</guilabel></term>
 <listitem><para>When enabled, Kate will display the full URL of your
 current document in the window title, rather than just the file name.</para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
+<term><anchor id="config-dialog-general-show-session-name" />
+<guilabel>Show session name in title</guilabel></term>
+<listitem><para>When enabled, Kate will display the name of the current
+session in the window title in addition to the file name.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><anchor id="config-dialog-general-sort-file-alphabetically" />
+<guilabel>Sort files alphabetically in the file list</guilabel></term>
+<listitem><para>If enabled, Kate will sort the files in the file list alphabetically.
+If disabled, the files will be listed in the order they were opened.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</listitem>
+</varlistentry><!-- /appearance group -->
+
+<varlistentry>
 <term><anchor id="config-general-behavior"/>
 <guilabel>Behavior</guilabel></term>
 <listitem>
 <variablelist>
+
+<varlistentry>
+<term>
+<anchor id="config-dialog-general-recent-files-number"/>
+<guibutton>Number of recent files</guibutton></term>
+<listitem><para>Sets the number of recent files remembered by &kate;.
+Note that if you set this field to a lower value than the current one, the list of files
+may get truncated and some items forgotten.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<anchor id="config-dialog-general-current-instance"/>
+<guibutton>Always use the current instance of kate to open new files</guibutton></term>
+<listitem><para>If enabled, all files opened from outside &kate; will reuse the
+current instance of Kate instead of starting a new one.</para>
+</listitem>
+</varlistentry>
+
 <varlistentry>
 <term>
 <anchor id="config-dialog-general-sync-konsole"/>
@@ -128,7 +174,7 @@
 
 <varlistentry>
 <term><anchor id="config-general-meta-data"/>
-<guilabel>Meta Data</guilabel></term>
+<guilabel>Meta Information</guilabel></term>
 <listitem>
 
 <variablelist>
@@ -151,7 +197,7 @@
 </variablelist>
 
 </listitem>
-</varlistentry><!-- /meta data group -->
+</varlistentry><!-- /meta information group -->
 
 </variablelist>
 </sect2>

doc/kate/highlighting.docbook

diff --git a/doc/kate/highlighting.docbook b/doc/kate/highlighting.docbook
index 3a64d9d..6c12a11 100644
--- a/doc/kate/highlighting.docbook
+++ b/doc/kate/highlighting.docbook
@@ -84,6 +84,12 @@
 mechanism in more detail. It is for you if you want to know about
 it, or if you want to change or create syntax definitions.</para>
 
+<mediaobject>
+<imageobject>
+<imagedata format="PNG" fileref="configdialog02.png"/>
+</imageobject>
+</mediaobject>
+
 <sect2 id="katehighlight-howitworks">
 
 <title>How it Works</title>