Imported Upstream version 0.9.10upstream/0.9.10

12 files changed, 258 insertions, 0 deletions

diff --git a/help/C/adf.page b/help/C/adf.page
new file mode 100644
index 0000000..8d8a3dc
--- /dev/null
+++ b/help/C/adf.page
@@ -0,0 +1,18 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="adf">
+
+    <info>
+        <link type="guide" xref="index#acquire"/>
+    </info>
+
+	<title>Using an Automatic Document Feeder</title>
+
+    <p>
+    If your scanner has an Automatic Document Feeder (ADF) you can scan all the pages by selecting the <guiseq><gui>Document</gui><gui>Scan</gui><gui>All Pages From Feeder</gui></guiseq> menu.
+    </p>
+    <p>
+    By default both sides of the paper will be scanned if your scanned supports this.
+    Single side scanning can be configured from the <guiseq><gui>Document</gui><gui>Preferences</gui></guiseq> menu.
+    </p>
+</page>
diff --git a/help/C/crop.page b/help/C/crop.page
new file mode 100644
index 0000000..4102c9d
--- /dev/null
+++ b/help/C/crop.page
@@ -0,0 +1,24 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="crop">
+
+    <info>
+        <link type="guide" xref="index#modify"/>
+    </info>
+  
+	<title>Cropping</title>
+
+    <p>
+    To use only part of the scanned page enable crop by selecting the crop button in the toolbar.
+    A mask will be shown over the current page with the area not being used shown in gray.
+    </p>
+    <p>
+    The crop area can be adjusted by clicking on the inside of the crop area border and dragging the mouse.
+    </p>
+    <p>
+    Fixed crop sizes can be chosen from the <guiseq><gui>Page</gui><gui>Crop</gui></guiseq> menu that match commonly used paper sizes.
+    </p>
+    <p>
+    Each new page that is scanned will use the previous crop.
+    </p>
+</page>
diff --git a/help/C/dpi.page b/help/C/dpi.page
new file mode 100644
index 0000000..a274bca
--- /dev/null
+++ b/help/C/dpi.page
@@ -0,0 +1,15 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="dpi">
+
+    <info>
+        <link type="guide" xref="index#acquire"/>
+    </info>
+  
+	<title>Setting the Scan Resolution</title>
+
+    <p>
+    By default text documents will be scanned at 200 dots per inch (dpi) and photos at 400 dpi.
+    To change these settings open the preferences from the <guiseq><gui>Document</gui><gui>Preferences</gui></guiseq> menu.
+    </p>
+</page>
diff --git a/help/C/edit.page b/help/C/edit.page
new file mode 100644
index 0000000..32d501d
--- /dev/null
+++ b/help/C/edit.page
@@ -0,0 +1,15 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="edit">
+
+    <info>
+        <link type="guide" xref="index#modify"/>
+    </info>
+  
+	<title>Editing a Document</title>
+
+    <p>
+    <app>Simple Scan</app> does not provide any editing functions.
+    To edit a document <link xref="save">save the document</link> and open it in your favourite editing application.
+    </p>
+</page>
diff --git a/help/C/email.page b/help/C/email.page
new file mode 100644
index 0000000..42540c2
--- /dev/null
+++ b/help/C/email.page
@@ -0,0 +1,21 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="email">
+
+    <info>
+        <link type="guide" xref="index#use"/>
+    </info>
+  
+	<title>Sending via Email</title>
+
+    <p>
+    To email the current document use the <guiseq><gui>Document</gui><gui>Email</gui></guiseq> menu (<keyseq><key>Ctrl</key><key>E</key></keyseq>).
+    Your email program will be opened with a new message containing the scanned document as an attachment.
+    </p>
+    <p>
+    If the document type is set to text the email will have a PDF attachment otherwise the email will have a JPEG attachment for each page.    
+    </p>
+    <p>
+    See <link xref="save"/> for more information about file formats.
+    </p>
+</page>
diff --git a/help/C/index.page b/help/C/index.page
new file mode 100644
index 0000000..6f5bff1
--- /dev/null
+++ b/help/C/index.page
@@ -0,0 +1,26 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="index">
+
+	<info>
+		<credit type="author">
+			<name>Robert Ancell</name>
+			<email>robert.ancell@gmail.com</email>
+		</credit>
+		<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" />
+	</info>
+
+	<title>Simple Scan Help</title>
+    
+    <section id="acquire" style="2column">
+        <title>Scanning Pages</title>
+    </section>
+
+    <section id="modify" style="2column">
+        <title>Modifying the Document</title>
+    </section>
+
+    <section id="use" style="2column">
+        <title>Using the Document</title>
+    </section>
+</page>
diff --git a/help/C/legal.xml b/help/C/legal.xml
new file mode 100644
index 0000000..86d6173
--- /dev/null
+++ b/help/C/legal.xml
@@ -0,0 +1,9 @@
+<license xmlns="http://projectmallard.org/1.0/"
+         href="http://creativecommons.org/licenses/by-sa/3.0/">
+<p>This work is licensed under a
+<link href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons
+Attribution-Share Alike 3.0 Unported License</link>.</p>
+<p>As a special exception, the copyright holders give you permission to copy,
+modify, and distribute the example code contained in this document under the
+terms of your choosing, without restriction.</p>
+</license>
diff --git a/help/C/print.page b/help/C/print.page
new file mode 100644
index 0000000..8f182ca
--- /dev/null
+++ b/help/C/print.page
@@ -0,0 +1,14 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="print">
+
+    <info>
+        <link type="guide" xref="index#use"/>
+    </info>
+  
+	<title>Printing</title>
+
+    <p>
+    To print the current document use the <guiseq><gui>Document</gui><gui>Print</gui></guiseq> menu (<keyseq><key>Ctrl</key><key>P</key></keyseq>).
+    </p>
+</page>
diff --git a/help/C/rotate.page b/help/C/rotate.page
new file mode 100644
index 0000000..caa8532
--- /dev/null
+++ b/help/C/rotate.page
@@ -0,0 +1,15 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="rotate">
+
+    <info>
+        <link type="guide" xref="index#modify"/>
+    </info>
+  
+	<title>Rotating Pages</title>
+
+    <p>
+    To rotate a page use the rotation buttons in the toolbar or the <key>[</key> and <key>]</key> keys.
+    Each new page that is scanned will use the previous rotation.
+    </p>
+</page>
diff --git a/help/C/save.page b/help/C/save.page
new file mode 100644
index 0000000..8c1a7b1
--- /dev/null
+++ b/help/C/save.page
@@ -0,0 +1,32 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="save">
+
+    <info>
+        <link type="guide" xref="index#use"/>
+    </info>
+  
+	<title>Saving to a File</title>
+
+    <p>
+    To save the current document to a file use the <guiseq><gui>Document</gui><gui>Save</gui></guiseq> menu (<keyseq><key>Ctrl</key><key>S</key></keyseq>).
+    When you save, there is a choice of three file types.
+    </p>
+    <terms>
+      <item>
+        <title>Portable Document Format (PDF)</title>
+        <p>A PDF can contain multiple pages (like a book) and is easy to distribute to other people.  Most people do not have software to modify PDF documents so this format is best used for archiving.</p>
+        <p>Use this type if you have scanned multiple pages of text.</p>
+      </item>
+      <item>
+        <title>JPEG</title>
+        <p>JPEG file is the file format used by digital cameras and is very small and so easy to distribute.  Most people have software to modify JPEG photos and this format is suitable for uploading to social networking sites.  If you have scanned multiple pages then a JPEG file will be written for each page.</p>
+        <p>Use this type if you want to modify or upload the scanned images.</p>
+      </item>
+      <item>
+        <title>PNG</title>
+        <p>PNG files contain the raw data from the scanner. This makes them much larger than JPEG files and not suitable for distributing. If you have scanned multiple pages then a PNG file will be written for each page.</p>
+        <p>Use this type if you need high resolution files for editing</p>
+      </item>
+    </terms>
+</page>
diff --git a/help/C/scanner.page b/help/C/scanner.page
new file mode 100644
index 0000000..d7decd2
--- /dev/null
+++ b/help/C/scanner.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="scanner">
+
+    <info>
+        <link type="guide" xref="index#acquire"/>
+    </info>
+  
+	<title>Selecting a Scanner</title>
+
+    <p>
+    If you have multiple scanners you can change which scanner is selected from the <guiseq><gui>Document</gui><gui>Preferences</gui></guiseq> menu.
+    </p>
+
+    <p>
+    Your local scanners are automatically detected each time you start <app>Simple Scan</app> and each time you plug in USB scanner.
+    If you have a network scanner you will need to restart <app>Simple Scan</app> for it to be detected.
+    </p>
+</page>
diff --git a/help/C/scanning.page b/help/C/scanning.page
new file mode 100644
index 0000000..5d0b470
--- /dev/null
+++ b/help/C/scanning.page
@@ -0,0 +1,50 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="scanning">
+
+    <info>
+        <title type="sort">0</title>
+        <link type="guide" xref="index#acquire"/>
+    </info>
+  
+	<title>Scanning a Page</title>
+
+    <p>
+    To scan a document from your scanner:
+    </p>
+    <steps>
+    <item>
+      <p>
+        Connect the scanner to your computer.
+      </p>
+    </item>
+    <item>
+      <p>
+        Open <app>Simple Scan</app>.
+      </p>
+    </item>
+    <item>
+      <p>
+        Press the scan button in the toolbar (or <keyseq><key>Ctrl</key><key>1</key></keyseq>).
+      </p>
+    </item>
+    </steps>
+
+    <p>
+    The page will be shown as it is scanned.
+    </p>
+
+    <p>
+    Each page you scan is added to the end of your document.  To start a new document select <guiseq><gui>Document</gui><gui>New</gui></guiseq>.
+    Individual pages can be deleted by right clicking a page or pressing the <key>Delete</key> key.
+    </p>
+
+    <p>
+    The type of scan can be changed from the <guiseq><gui>Document</gui><gui>Scan</gui></guiseq> menu.
+    Choose <gui>Text</gui> if you want the document to be quickly scanned in black and white or <gui>Photo</gui> for a high resolution color scan.
+    </p>
+
+    <p>
+    To stop the scan at any time press <key>Escape</key>.
+    </p>
+</page>