From 2c8add6824c35b94a0950426be78165a51e077bb Mon Sep 17 00:00:00 2001
From: Tiffany Antopolski <tiffany@antopolski.com>
Date: Fri, 8 Oct 2010 10:33:45 -0400
Subject: [PATCH] Interactive forms guides added.

---
 help/C/forms-saving.page | 75 ++++++++++++++++++++++++++++++++++++++++
 help/C/forms.page        | 22 ++++++++++--
 help/C/index.page        |  4 +++
 3 files changed, 99 insertions(+), 2 deletions(-)
 create mode 100644 help/C/forms-saving.page

diff --git a/help/C/forms-saving.page b/help/C/forms-saving.page
new file mode 100644
index 00000000..04880afa
--- /dev/null
+++ b/help/C/forms-saving.page
@@ -0,0 +1,75 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic" style="task"
+      id="forms-saving">
+
+  <info>
+    <link type="guide" xref="index#forms"/>
+    <desc>Saving a form with your information filled in.</desc>
+
+    <revision pkgversion="2.32.0" version="0.1" date="2010-05-06" status="review"/>
+    <credit type="author">
+      <name>Tiffany Antopolski</name>
+      <email>tiffany@antopolski.com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+<title>Saving a Form</title>
+
+<p>
+  You may wish to save your form after you have filled it out in one of two ways:
+</p>
+
+<list type = "numbered">
+<item><p>
+     To save a copy that can be edited in the future (form remains interactive):
+     </p>
+   <steps>
+    <item>
+      <p>
+      <guiseq><gui>File</gui><gui>Save a copy...</gui></guiseq>
+    </p>
+     </item>
+ <item>
+      <p>
+      Choose a name and folder to save the file in, then click <gui>Save</gui>. 
+      The PDF will be saved in the folder you chose.
+      </p>
+    </item>
+   </steps>
+</item>
+<item><p>
+    To save a copy that can no longer be edited (no longer interactive):
+      </p>
+   <steps>
+    <item>
+      <p>
+      Click <guiseq><gui>File</gui><gui>Print</gui></guiseq> and go to the 
+      <gui>General</gui> tab.
+      </p>
+    </item>
+    <item>
+      <p>
+      Select <gui>Print to File</gui> and choose PDF as the 
+      <gui>Output format</gui>.
+      </p>
+    </item>
+    <item>
+      <p>
+      Choose a name and folder to save the file in, then click <gui>Print</gui>. 
+      The PDF will be saved in the folder you chose.
+      </p>
+    </item>
+   </steps>
+</item>
+</list>
+
+<note style="bug">
+<p>
+  Copies of encrypted files can not be saved or printed.
+</p>
+</note>
+
+</page>
diff --git a/help/C/forms.page b/help/C/forms.page
index 95567d5b..cb2f6210 100644
--- a/help/C/forms.page
+++ b/help/C/forms.page
@@ -3,7 +3,7 @@
       id="forms">
 
   <info>
-    <link type="guide" xref="index#other"/>
+    <link type="guide" xref="index#forms"/>
     <desc>Working with fillable forms in <app>Evince Document Viewer</app>.</desc>
 
     <revision pkgversion="2.30.3" version="0.1" date="2010-09-28" status="review"/>
@@ -18,7 +18,25 @@
   </info>
 
 <title>Forms</title>
-
+<p>
+   When filling out an interactive form, you can navigate from field to field by clicking on a field with your mouse.  When you are finished filling out a text field, click <key>Enter</key>.
+</p>
+<note style = "bug">
+ <p>
+   Failure to click <key>Enter</key> after filling a text field will cause that field to not be saved when saving a copy of the document or printing the document.
+ </p>
+</note>
+<p>
+   Checkboxes can be checked/unchecked by clicking with your mouse.
+</p>
+<p>
+   You can make a selection in scrollable list box by clicking on the list box and scrolling to your choice with your mouse.
+</p>
+<note style = "tip">
+ <p>
+There may be some parts of a form that you may need to fill out by hand <em>after</em> you print the form.  For example, you might have to circle certain things, or sign the form in one or more places.  If you wish to do this electronically, you may want to try <link href = "http://www.g-loaded.eu/2008/05/03/how-to-annotate-pdf-files-in-linux-using-xournal/">Xournal</link>.
+</p>
+</note>
 
 
 </page>
diff --git a/help/C/index.page b/help/C/index.page
index 154fdf5a..f682472f 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -34,6 +34,10 @@ Evince Document Viewer</title>
     <title>Annotations</title>
 </section>
 
+<section id="forms" style="2column" groups="main">
+    <title>Interactive Forms</title>
+</section>
+
 <section id="problems" style="2column">
     <title>Problems and Common Questions</title>
 </section>
-- 
2.43.0