Hello again, much regrettably I am getting out of pace now, since I need to correct and add on myself. Doing code review for a misfeature and a bug, I have located several new keyboard shortcuts that need to go into the handbook. In addition the stylesheet for the manual page is being updated. Two changes deserve explicit mention here, but the additions go uncommented. - This panel is used for selecting actions. The available actions - can be classified into the following groups: + This panel is used for selecting actions, each of which is also + available via a keyboard shortcut. The available actions can be + classified into the following groups: A pointer forward to the list of keyboard shortcuts. The first use of "available" here, could it be changed to "accessible"? - Select the <emphasis>Paint</emphasis> mode. + Select <emphasis>Paint</emphasis> mode. There ought to be no definite article here. Right? The Docbook source needed to juxtapose <para> against <emphasis> in order to build consistent lists. This might distract when reading the difference file. Finally, in representing keystrokes, it is costumary to write Ctrl-C and Ctrl-Shift-C using a capital letter. Presently my text uses miniscules for solitary letter. Should this be mended? Best regards, Mats
diff --git a/manpage.xsl b/manpage.xsl
index 0fdb490..cbb2742 100644
--- a/manpage.xsl
+++ b/manpage.xsl
@@ -15,13 +15,14 @@
<xsl:param name="man.output.in.separate.dir">1</xsl:param>
<xsl:param name="man.output.subdirs.enabled">0</xsl:param>
<xsl:param name="man.output.lang.in.name.enabled">1</xsl:param>
+ <xsl:param name="man.authors.section.enabled">0</xsl:param>
<!-- Simplify text insertion when cross-referencing `refsect1' -->
<xsl:param name="local.l10n.xml" select="document('')"/>
<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0";>
<l:l10n language="en">
<l:context name="xref">
- <l:template name="refsect1" text="the section “%t”"/>
+ <l:template name="refsect1" text="the section ``%t''"/>
</l:context>
</l:l10n>
</l:i18n>
diff --git a/rgbpaint.xml b/rgbpaint.xml
index c8e2394..b96e975 100644
--- a/rgbpaint.xml
+++ b/rgbpaint.xml
@@ -218,8 +218,9 @@
<refsect1 id="task.panel.en" xreflabel="Tasks panel">
<title>The Tasks panel</title>
<para>
- This panel is used for selecting actions. The available actions
- can be classified into the following groups:
+ This panel is used for selecting actions, each of which is also
+ available via a keyboard shortcut. The available actions can be
+ classified into the following groups:
</para>
<itemizedlist spacing="compact">
<listitem>
@@ -456,15 +457,14 @@
<term><keycap>p</keycap></term>
<listitem>
<para>
- Select the <emphasis>Paint</emphasis> mode.
+ Select <emphasis>Paint</emphasis> mode.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><keycap>q</keycap></term>
<listitem>
- <para>
- <emphasis>Quit</emphasis> the program.
+ <para><emphasis>Quit</emphasis> the program.
</para>
</listitem>
</varlistentry>
@@ -484,7 +484,123 @@
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term>
+ <keycombo action="press">
+ <keycap>Ctrl</keycap>
+ <keycap>C</keycap>
+ </keycombo>
+ </term>
+ <listitem>
+ <para>
+ Make a <emphasis>Copy</emphasis> in memory of the marked area.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <keycombo action="press">
+ <keycap>Ctrl</keycap>
+ <keycap>N</keycap>
+ </keycombo>
+ </term>
+ <listitem>
+ <para>
+ Prepare a <emphasis>New image</emphasis>, including a sizeing
+ dialogue.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <keycombo action="press">
+ <keycap>Ctrl</keycap>
+ <keycap>O</keycap>
+ </keycombo>
+ </term>
+ <listitem>
+ <para><emphasis>Open</emphasis> a file dialogue for fetching an image.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <keycombo action="press">
+ <keycap>Ctrl</keycap>
+ <keycap>P</keycap>
+ </keycombo>
+ </term>
+ <listitem>
+ <para><emphasis>Paste</emphasis> the in-memory copy onto a marked area
+ at canvas middle.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <keycombo action="press">
+ <keycap>Ctrl</keycap>
+ <keycap>S</keycap>
+ </keycombo>
+ </term>
+ <listitem>
+ <para><emphasis>Save</emphasis> the image in a file, using the old name.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <keycombo action="press">
+ <keycap>Ctrl</keycap>
+ <keycap>Shift</keycap>
+ <keycap>S</keycap>
+ </keycombo>
+ </term>
+ <listitem>
+ <para>
+ Save the image in a file, choosing a <emphasis>new name</emphasis>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <keycombo action="press">
+ <keycap>Ctrl</keycap>
+ <keycap>X</keycap>
+ </keycombo>
+ </term>
+ <listitem>
+ <para><emphasis>Cut</emphasis> the selected portion out of
+ the canvas, expelling the contents.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <keycombo action="press">
+ <keycap>Ctrl</keycap>
+ <keycap>Y</keycap>
+ </keycombo>
+ </term>
+ <listitem>
+ <para><emphasis>Redo</emphasis> the most recently undone action.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <keycombo action="press">
+ <keycap>Ctrl</keycap>
+ <keycap>Z</keycap>
+ </keycombo>
+ </term>
+ <listitem>
+ <para><emphasis>Undo</emphasis> the most recently completed action.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
+
<variablelist>
<title>Movement</title>
<varlistentry>
Attachment:
manpage.xsl
Description: XML document
Attachment:
rgbpaint.xml
Description: XML document