[kde-doc-english] [kxstitch] /: Move docs to the standard KDE level (to translate them), update man page

Yuri Chornoivan yurchor at ukr.net
Sun May 25 13:13:26 UTC 2014


Git commit b961dcaf3048c1544e2155dc7fd9a3f9f8adddfc by Yuri Chornoivan.
Committed on 25/05/2014 at 13:13.
Pushed by yurchor into branch 'master'.

Move docs to the standard KDE level (to translate them), update man page

M  +0    -1    CMakeLists.txt
M  +2    -1    doc/CMakeLists.txt
R  +-    --    doc/add-page-icon.png [from: doc/en/add-page-icon.png - 100% similarity]
R  +-    --    doc/calibrate-color-dialog.png [from: doc/en/calibrate-color-dialog.png - 100% similarity]
R  +0    -0    doc/commands.docbook [from: doc/en/commands.docbook - 100% similarity]
R  +-    --    doc/configuration-dialog.png [from: doc/en/configuration-dialog.png - 100% similarity]
R  +0    -0    doc/credits.docbook [from: doc/en/credits.docbook - 100% similarity]
R  +-    --    doc/delete-page-icon.png [from: doc/en/delete-page-icon.png - 100% similarity]
R  +0    -0    doc/dialogs.docbook [from: doc/en/dialogs.docbook - 100% similarity]
R  +-    --    doc/editor-context-menu.png [from: doc/en/editor-context-menu.png - 100% similarity]
R  +-    --    doc/element-resize-handle.png [from: doc/en/element-resize-handle.png - 100% similarity]
R  +-    --    doc/element-resize.png [from: doc/en/element-resize.png - 100% similarity]
D  +0    -2    doc/en/CMakeLists.txt
R  +-    --    doc/extend-pattern-dialog.png [from: doc/en/extend-pattern-dialog.png - 100% similarity]
R  +0    -0    doc/faq.docbook [from: doc/en/faq.docbook - 100% similarity]
R  +0    -0    doc/features.docbook [from: doc/en/features.docbook - 100% similarity]
R  +-    --    doc/file-properties-dialog.png [from: doc/en/file-properties-dialog.png - 100% similarity]
R  +-    --    doc/import-image-dialog.png [from: doc/en/import-image-dialog.png - 100% similarity]
R  +0    -0    doc/index.docbook [from: doc/en/index.docbook - 100% similarity]
R  +-    --    doc/insert-page-icon.png [from: doc/en/insert-page-icon.png - 100% similarity]
R  +0    -0    doc/install.docbook [from: doc/en/install.docbook - 100% similarity]
R  +0    -0    doc/introduction.docbook [from: doc/en/introduction.docbook - 100% similarity]
R  +-    --    doc/key-element-icon.png [from: doc/en/key-element-icon.png - 100% similarity]
R  +-    --    doc/key-element-properties-dialog.png [from: doc/en/key-element-properties-dialog.png - 100% similarity]
R  +-    --    doc/key-element.png [from: doc/en/key-element.png - 100% similarity]
R  +-    --    doc/library-manager-dialog.png [from: doc/en/library-manager-dialog.png - 100% similarity]
R  +-    --    doc/library-pattern-properties-dialog.png [from: doc/en/library-pattern-properties-dialog.png - 100% similarity]
A  +140  -0    doc/man-kxstitch.1.docbook
R  +-    --    doc/map-element.png [from: doc/en/map-element.png - 100% similarity]
R  +-    --    doc/new-color-dialog.png [from: doc/en/new-color-dialog.png - 100% similarity]
R  +-    --    doc/page-properties-dialog.png [from: doc/en/page-properties-dialog.png - 100% similarity]
R  +-    --    doc/palette-context-menu.png [from: doc/en/palette-context-menu.png - 100% similarity]
R  +-    --    doc/palette-manager-dialog.png [from: doc/en/palette-manager-dialog.png - 100% similarity]
R  +-    --    doc/pattern-element-icon.png [from: doc/en/pattern-element-icon.png - 100% similarity]
R  +-    --    doc/pattern-element-properties-dialog.png [from: doc/en/pattern-element-properties-dialog.png - 100% similarity]
R  +-    --    doc/pattern-element-selection.png [from: doc/en/pattern-element-selection.png - 100% similarity]
R  +0    -0    doc/patterns.docbook [from: doc/en/patterns.docbook - 100% similarity]
R  +-    --    doc/print-setup-dialog.png [from: doc/en/print-setup-dialog.png - 100% similarity]
R  +-    --    doc/printer-template.png [from: doc/en/printer-template.png - 100% similarity]
R  +0    -0    doc/printing.docbook [from: doc/en/printing.docbook - 100% similarity]
R  +-    --    doc/select-element-icon.png [from: doc/en/select-element-icon.png - 100% similarity]
R  +-    --    doc/symbol-selector-dialog.png [from: doc/en/symbol-selector-dialog.png - 100% similarity]
R  +-    --    doc/text-element-icon.png [from: doc/en/text-element-icon.png - 100% similarity]
R  +-    --    doc/text-element-properties-dialog.png [from: doc/en/text-element-properties-dialog.png - 100% similarity]
R  +-    --    doc/text-tool-dialog.png [from: doc/en/text-tool-dialog.png - 100% similarity]
R  +-    --    doc/text-tool-pattern.png [from: doc/en/text-tool-pattern.png - 100% similarity]
R  +0    -0    doc/ui.docbook [from: doc/en/ui.docbook - 100% similarity]
R  +-    --    doc/user-interface.png [from: doc/en/user-interface.png - 100% similarity]
D  +-    --    kxstitch.1.gz

http://commits.kde.org/kxstitch/b961dcaf3048c1544e2155dc7fd9a3f9f8adddfc

diff --git a/CMakeLists.txt b/CMakeLists.txt
index d5d9d35..5879024 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -144,7 +144,6 @@ install (TARGETS kxstitch DESTINATION ${BIN_INSTALL_DIR})
 install (FILES kxstitchui.rc DESTINATION ${DATA_INSTALL_DIR}/kxstitch)
 install (FILES kxstitch.kcfg DESTINATION ${KCFG_INSTALL_DIR})
 install (FILES kxstitch.desktop DESTINATION ${XDG_APPS_INSTALL_DIR})
-install (FILES kxstitch.1.gz DESTINATION ${MAN_INSTALL_DIR}/man1)
 
 IF (SHARED_MIME_INFO_FOUND AND IS_DIRECTORY ${XDG_MIME_INSTALL_DIR})
     install (FILES kxstitch.xml DESTINATION ${XDG_MIME_INSTALL_DIR})
diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt
index 3276587..9bce320 100644
--- a/doc/CMakeLists.txt
+++ b/doc/CMakeLists.txt
@@ -1 +1,2 @@
-add_subdirectory(en)
+KDE4_CREATE_HANDBOOK(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kxstitch)
+KDE4_CREATE_MANPAGE(man-kxstitch.1.docbook 1 INSTALL_DESTINATION ${MAN_INSTALL_DIR})
diff --git a/doc/en/add-page-icon.png b/doc/add-page-icon.png
similarity index 100%
rename from doc/en/add-page-icon.png
rename to doc/add-page-icon.png
diff --git a/doc/en/calibrate-color-dialog.png b/doc/calibrate-color-dialog.png
similarity index 100%
rename from doc/en/calibrate-color-dialog.png
rename to doc/calibrate-color-dialog.png
diff --git a/doc/en/commands.docbook b/doc/commands.docbook
similarity index 100%
rename from doc/en/commands.docbook
rename to doc/commands.docbook
diff --git a/doc/en/configuration-dialog.png b/doc/configuration-dialog.png
similarity index 100%
rename from doc/en/configuration-dialog.png
rename to doc/configuration-dialog.png
diff --git a/doc/en/credits.docbook b/doc/credits.docbook
similarity index 100%
rename from doc/en/credits.docbook
rename to doc/credits.docbook
diff --git a/doc/en/delete-page-icon.png b/doc/delete-page-icon.png
similarity index 100%
rename from doc/en/delete-page-icon.png
rename to doc/delete-page-icon.png
diff --git a/doc/en/dialogs.docbook b/doc/dialogs.docbook
similarity index 100%
rename from doc/en/dialogs.docbook
rename to doc/dialogs.docbook
diff --git a/doc/en/editor-context-menu.png b/doc/editor-context-menu.png
similarity index 100%
rename from doc/en/editor-context-menu.png
rename to doc/editor-context-menu.png
diff --git a/doc/en/element-resize-handle.png b/doc/element-resize-handle.png
similarity index 100%
rename from doc/en/element-resize-handle.png
rename to doc/element-resize-handle.png
diff --git a/doc/en/element-resize.png b/doc/element-resize.png
similarity index 100%
rename from doc/en/element-resize.png
rename to doc/element-resize.png
diff --git a/doc/en/CMakeLists.txt b/doc/en/CMakeLists.txt
deleted file mode 100644
index fedc053..0000000
--- a/doc/en/CMakeLists.txt
+++ /dev/null
@@ -1,2 +0,0 @@
-KDE4_CREATE_HANDBOOK(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kxstitch)
- 
diff --git a/doc/en/extend-pattern-dialog.png b/doc/extend-pattern-dialog.png
similarity index 100%
rename from doc/en/extend-pattern-dialog.png
rename to doc/extend-pattern-dialog.png
diff --git a/doc/en/faq.docbook b/doc/faq.docbook
similarity index 100%
rename from doc/en/faq.docbook
rename to doc/faq.docbook
diff --git a/doc/en/features.docbook b/doc/features.docbook
similarity index 100%
rename from doc/en/features.docbook
rename to doc/features.docbook
diff --git a/doc/en/file-properties-dialog.png b/doc/file-properties-dialog.png
similarity index 100%
rename from doc/en/file-properties-dialog.png
rename to doc/file-properties-dialog.png
diff --git a/doc/en/import-image-dialog.png b/doc/import-image-dialog.png
similarity index 100%
rename from doc/en/import-image-dialog.png
rename to doc/import-image-dialog.png
diff --git a/doc/en/index.docbook b/doc/index.docbook
similarity index 100%
rename from doc/en/index.docbook
rename to doc/index.docbook
diff --git a/doc/en/insert-page-icon.png b/doc/insert-page-icon.png
similarity index 100%
rename from doc/en/insert-page-icon.png
rename to doc/insert-page-icon.png
diff --git a/doc/en/install.docbook b/doc/install.docbook
similarity index 100%
rename from doc/en/install.docbook
rename to doc/install.docbook
diff --git a/doc/en/introduction.docbook b/doc/introduction.docbook
similarity index 100%
rename from doc/en/introduction.docbook
rename to doc/introduction.docbook
diff --git a/doc/en/key-element-icon.png b/doc/key-element-icon.png
similarity index 100%
rename from doc/en/key-element-icon.png
rename to doc/key-element-icon.png
diff --git a/doc/en/key-element-properties-dialog.png b/doc/key-element-properties-dialog.png
similarity index 100%
rename from doc/en/key-element-properties-dialog.png
rename to doc/key-element-properties-dialog.png
diff --git a/doc/en/key-element.png b/doc/key-element.png
similarity index 100%
rename from doc/en/key-element.png
rename to doc/key-element.png
diff --git a/doc/en/library-manager-dialog.png b/doc/library-manager-dialog.png
similarity index 100%
rename from doc/en/library-manager-dialog.png
rename to doc/library-manager-dialog.png
diff --git a/doc/en/library-pattern-properties-dialog.png b/doc/library-pattern-properties-dialog.png
similarity index 100%
rename from doc/en/library-pattern-properties-dialog.png
rename to doc/library-pattern-properties-dialog.png
diff --git a/doc/man-kxstitch.1.docbook b/doc/man-kxstitch.1.docbook
new file mode 100644
index 0000000..bfa582d
--- /dev/null
+++ b/doc/man-kxstitch.1.docbook
@@ -0,0 +1,140 @@
+<?xml version="1.0" ?>
+<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+<!ENTITY % English "INCLUDE">
+]>
+
+<refentry lang="&language;">
+<refentryinfo>
+<title>KDE User's Manual</title>
+<author><firstname>Eric</firstname>
+<surname>Pareja</surname>
+<contrib>First version of KXStitch man page for Debian project.</contrib>
+<email>xenos at upm.edu.ph</email></author>
+<author><firstname>Yuri</firstname>
+<surname>Chornoivan</surname>
+<contrib>Updated man page.</contrib>
+<email>yurchor at ukr.net</email></author>
+<date>2014-05-25</date>
+<productname>K Desktop Environment</productname>
+</refentryinfo>
+
+<refmeta>
+<refentrytitle><command>kxstitch</command></refentrytitle>
+<manvolnum>1</manvolnum>
+</refmeta>
+
+<refnamediv>
+<refname><command>kxstitch</command></refname>
+<refpurpose>cross stitch pattern creator and editor for &kde;</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>kxstitch</command> <arg choice="opt
+">&kde; Generic Options</arg> <arg choice="opt">&Qt; Generic Options</arg> <arg choice="opt
+"><option><replaceable>file</replaceable></option></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1>
+<title>Description</title>
+<para>KXStitch is a program that lets you create cross stitch patterns and charts. Patterns can be created from scratch on a user defined size of grid, which can be enlarged or reduced in size as your pattern progresses. Alternatively you can import images from many graphics formats which will allow you to reduce the number of colors and to restrict the conversion to full stitches or optionally use fractional stitches. You may also use an image as a background. These imported images can then be modified using the supplied tools to produce your final design.</para>
+
+<para>There are many tools to aid designing your pattern, from open and filled rectangles and ellipses, filled polygons and lines and backstitching. Additionally cut, copy and paste can be used to duplicate selected areas. Selected areas can also be rotated 90, 180 and 270 degrees anti clockwise, or mirrored horizontally or vertically.</para>
+
+<para>There is also a pattern library that can be used to store small and not so small portions of patterns that can then be reused in other patterns. The patterns in these library are stored in a hierarchical list that makes it easy to sort and navigate them to find the ones you want. These pattern libraries can also be used as alphabets by assigning a character to each one. By using the Alphabet tool, each key press is searched for in the current library and if present, the associated pattern will be inserted in the pattern.</para>
+
+<para>When your ready, you can print out your design in several formats. There are options to print out cover sheets, instructions and a floss key including amount of thread used and number of stitches.</para>
+</refsect1>
+
+<refsect1>
+<title>Options</title>
+
+<variablelist>
+<varlistentry>
+<term><option>--author</option></term>
+<listitem>
+<para>Show author information</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>--help</option></term>
+<listitem>
+<para>Show help about options</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>--help-qt</option></term>
+<listitem>
+<para>Show Qt specific options</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>--help-kde</option></term>
+<listitem>
+<para>Show &kde; specific options</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>--help-all</option></term>
+<listitem>
+<para>Show all options</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>--license</option></term>
+<listitem>
+<para>Show license information</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>-v</option>, <option>--version</option></term>
+<listitem>
+<para>Show version information and exit.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</refsect1>
+
+<refsect1>
+<title>Arguments</title>
+
+<variablelist>
+<varlistentry>
+  <term><replaceable>file</replaceable></term>
+<listitem>
+<para>Cross stitch document to open.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</refsect1>
+
+<refsect1>
+<title>See Also</title>
+<para>More detailed user documentation is available from <ulink
+url="help:/kxstitch">help:/kxstitch</ulink>
+(either enter this <acronym>URL</acronym> into &konqueror;, or run
+<userinput><command>khelpcenter</command>
+<parameter>help:/kxstitch</parameter></userinput>).</para>
+
+<para>There is also further information available at the <ulink
+url="http://sourceforge.net/apps/mediawiki/kxstitch/index.php">KXStitch home page</ulink>.</para>
+</refsect1>
+
+<refsect1>
+<title>Authors</title>
+<para>KXStitch was written by
+<personname><firstname>Stephen</firstname><surname>Allewell</surname></personname>
+<email>sallewell at users.sourceforge.net</email>.</para>
+</refsect1>
+
+</refentry>
diff --git a/doc/en/map-element.png b/doc/map-element.png
similarity index 100%
rename from doc/en/map-element.png
rename to doc/map-element.png
diff --git a/doc/en/new-color-dialog.png b/doc/new-color-dialog.png
similarity index 100%
rename from doc/en/new-color-dialog.png
rename to doc/new-color-dialog.png
diff --git a/doc/en/page-properties-dialog.png b/doc/page-properties-dialog.png
similarity index 100%
rename from doc/en/page-properties-dialog.png
rename to doc/page-properties-dialog.png
diff --git a/doc/en/palette-context-menu.png b/doc/palette-context-menu.png
similarity index 100%
rename from doc/en/palette-context-menu.png
rename to doc/palette-context-menu.png
diff --git a/doc/en/palette-manager-dialog.png b/doc/palette-manager-dialog.png
similarity index 100%
rename from doc/en/palette-manager-dialog.png
rename to doc/palette-manager-dialog.png
diff --git a/doc/en/pattern-element-icon.png b/doc/pattern-element-icon.png
similarity index 100%
rename from doc/en/pattern-element-icon.png
rename to doc/pattern-element-icon.png
diff --git a/doc/en/pattern-element-properties-dialog.png b/doc/pattern-element-properties-dialog.png
similarity index 100%
rename from doc/en/pattern-element-properties-dialog.png
rename to doc/pattern-element-properties-dialog.png
diff --git a/doc/en/pattern-element-selection.png b/doc/pattern-element-selection.png
similarity index 100%
rename from doc/en/pattern-element-selection.png
rename to doc/pattern-element-selection.png
diff --git a/doc/en/patterns.docbook b/doc/patterns.docbook
similarity index 100%
rename from doc/en/patterns.docbook
rename to doc/patterns.docbook
diff --git a/doc/en/print-setup-dialog.png b/doc/print-setup-dialog.png
similarity index 100%
rename from doc/en/print-setup-dialog.png
rename to doc/print-setup-dialog.png
diff --git a/doc/en/printer-template.png b/doc/printer-template.png
similarity index 100%
rename from doc/en/printer-template.png
rename to doc/printer-template.png
diff --git a/doc/en/printing.docbook b/doc/printing.docbook
similarity index 100%
rename from doc/en/printing.docbook
rename to doc/printing.docbook
diff --git a/doc/en/select-element-icon.png b/doc/select-element-icon.png
similarity index 100%
rename from doc/en/select-element-icon.png
rename to doc/select-element-icon.png
diff --git a/doc/en/symbol-selector-dialog.png b/doc/symbol-selector-dialog.png
similarity index 100%
rename from doc/en/symbol-selector-dialog.png
rename to doc/symbol-selector-dialog.png
diff --git a/doc/en/text-element-icon.png b/doc/text-element-icon.png
similarity index 100%
rename from doc/en/text-element-icon.png
rename to doc/text-element-icon.png
diff --git a/doc/en/text-element-properties-dialog.png b/doc/text-element-properties-dialog.png
similarity index 100%
rename from doc/en/text-element-properties-dialog.png
rename to doc/text-element-properties-dialog.png
diff --git a/doc/en/text-tool-dialog.png b/doc/text-tool-dialog.png
similarity index 100%
rename from doc/en/text-tool-dialog.png
rename to doc/text-tool-dialog.png
diff --git a/doc/en/text-tool-pattern.png b/doc/text-tool-pattern.png
similarity index 100%
rename from doc/en/text-tool-pattern.png
rename to doc/text-tool-pattern.png
diff --git a/doc/en/ui.docbook b/doc/ui.docbook
similarity index 100%
rename from doc/en/ui.docbook
rename to doc/ui.docbook
diff --git a/doc/en/user-interface.png b/doc/user-interface.png
similarity index 100%
rename from doc/en/user-interface.png
rename to doc/user-interface.png
diff --git a/kxstitch.1.gz b/kxstitch.1.gz
deleted file mode 100644
index db58eb3..0000000
Binary files a/kxstitch.1.gz and /dev/null differ


More information about the kde-doc-english mailing list