[gnome-dictionary/mallard-help] Review print* help pages



commit 9330ceb7204ef657e96c77d14cde1ff997ea2ba7
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Fri Mar 29 15:39:57 2013 +0000

    Review print* help pages

 help/C/print-font.page |   38 +++++++++-------
 help/C/print.page      |  110 ++++++++++++++++++-----------------------------
 2 files changed, 63 insertions(+), 85 deletions(-)
---
diff --git a/help/C/print-font.page b/help/C/print-font.page
index 88cc8fb..9b62cce 100644
--- a/help/C/print-font.page
+++ b/help/C/print-font.page
@@ -3,52 +3,56 @@
       id="print-font">
 
   <info>
-    <revision version="0.1" date="2013-03-28" status="review"/>
+    <revision pkgversion="3.6" version="0.1" date="2013-03-29" status="candidate"/>
     <link type="guide" xref="index#preferences"/>
-    <!--link type="guide" xref=""/-->
 
     <credit type="author copyright">
       <name>Sindhu S</name>
       <email>sindhus live in</email>
       <years>2013</years>
     </credit>
+    <credit type="copyright editor">
+      <name>Ekaterina Gerasimova</name>
+      <email>kittykat3756 gmail com</email>
+      <years>2013</years>
+    </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>Select font for printing definitions.</desc>
+    <desc>Select the font for printing definitions.</desc>
 
   </info>
 
   <title>Print font</title>
 
-  <p>You can select custom font and size to print defintions. To select font
-  for printing defintions:</p>
+  <p>You can change the default font face and size that are used for printing
+  the definitions.</p>
 
   <steps>
+    <title>Change the font</title>
     <item>
       <p>Select <guiseq><gui style="menu">Dictionary</gui>
       <gui style="menuitem">Preferences</gui>
       <gui style="tab">Print</gui></guiseq>.</p>
     </item>
     <item>
-      <p>Click the button next to <gui>Font:</gui>.</p>
-    </item>
-    <item>
-      <p>Browse fonts from the list and click to select the desired font.
-      Alternatively you can search the font by name in the text input bar.</p>
+      <p>Click font selector button.</p>
     </item>
     <item>
-      <p>Drag the slider forward to increase the font size. Alternatively, you
-      can input the font size in the text box and use <gui>+</gui> to increase
-      or <gui>-</gui> to decrease the font size.</p>
+      <p>Select the font that you wish to use.</p>
     </item>
     <item>
-      <p>Click <gui style="button">Select</gui> to confirm choice of font and
-      size selection.</p>
+      <p>Drag the slider to the right to increase the font size or left to
+      decrease it. Alternatively, you can type in the font size in the text box,
+      or use the <gui>-</gui> and <gui>+</gui> buttons to decrease and increase
+      the font size.</p>
     </item>
     <item>
-      <p>Click <gui style="button">Close</gui> to exit <gui>Preferences</gui>
-      dialog and return to <app>Dictionary</app>.</p>
+      <p>Click <gui style="button">Select</gui> to save your font settings.</p>
     </item>
   </steps>
+
+  <p>The definition is not reflowed for printing, so if you choose a large font
+  size, some of the text may be cut off.</p>
+
 </page>
diff --git a/help/C/print.page b/help/C/print.page
index 3692930..6bdea53 100644
--- a/help/C/print.page
+++ b/help/C/print.page
@@ -3,115 +3,89 @@
       id="print">
 
   <info>
-    <revision version="0.1" date="2013-03-28" status="review"/>
+    <revision version="0.1" date="2013-03-28" status="candidate"/>
     <link type="guide" xref="index#features"/>
-    <link type="seealso" xref="definitions"/>
-    <!--link type="guide" xref=""/-->
+    <link type="seealso" xref="definition"/>
+    <link type="seealso" xref="print-font"/>
 
     <credit type="author copyright">
       <name>Sindhu S</name>
       <email>sindhus live in</email>
       <years>2013</years>
     </credit>
+    <credit type="copyright editor">
+      <name>Ekaterina Gerasimova</name>
+      <email>kittykat3756 gmail com</email>
+      <years>2013</years>
+    </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>Preview and print definitions.</desc>
+    <desc>Print preview and print definitions.</desc>
 
   </info>
 
-  <title>Printing With <app>Dictionary</app></title>
+  <title>Print a definition</title>
 
-    <p><app>Dictionary</app> allows you to print definitions to both paper and
-    file.</p>
+  <p>You can print a definition to paper or a file. Before printing, you
+  should preview the definition as it would be printed to check that the text
+  fits onto the page, especially if you have changed the
+  <link xref="print-font">print font</link> size.</p>
 
   <section id="preview">
-    <title>Preview Definitions</title>
-
-    <p>You can preview the definition to be printed as it would look on paper
-    using the the <gui style="menuitem">Preview</gui> option.</p>
+    <title>Print preview</title>
 
     <steps>
-      <title>To preview a definition before printing:</title>
       <item>
-        <p>Select <guiseq><gui style="menu">File</gui><gui style="menuitem">Preview</gui></guiseq>.</p>
+        <p>Select <guiseq><gui style="menu">File</gui>
+        <gui style="menuitem">Preview</gui></guiseq>.</p>
+      </item>
+      <item>
+        <p>A print preview window will open which will show you the definition
+        exactly as it will be printed.</p>
       </item>
       <item>
-        <p>A <gui>Dictionary job</gui> window will open to show you the print
-        preview of the selected defintion. You can use the toolbar to browse
-        pages, adjust zoom level and page width for readibility purposes.</p>
+       <p>Use the toolbar to browse pages, adjust zoom level and page
+       width.</p>
       </item>
       <item>
-        <p>To end the preview and return back to <app>Dictionary</app>, click
-        <gui style="button">×</gui>.</p>
+        <p>Click the <gui style="button">Print this document</gui> to print
+        the definition or close the window to end the preview.</p>
       </item>
     </steps>
+
+    <note>
+      <p>The print button in the toolbar may not always work. If it does not
+      work for you, close the window and select
+      <guiseq><gui style="menu">File</gui>
+      <gui style="menuitem">Print</gui></guiseq>.</p>
+    </note>
+
   </section>
 
   <section id="print">
-    <title>Print defintions</title>
+    <title>Print</title>
 
-    <note style="important">
-      <p>Printing with <app>Dictionary</app> to paper requires that you have
-      connected and configured your printer. If you have not done this, please
-      consult the <link href="help:gnome-help/printing">printing help for
-      GNOME</link> .</p>
-    </note>
+    <p>You need to <link href="help:gnome-help/printing">have a printer set
+    up</link> to be able to print to paper.</p>
 
     <steps>
-      <title>To print defintions you have looked up:</title>
       <item>
         <p>Select <guiseq><gui style="menu">File</gui>
         <gui style="menuitem">Print</gui>
         <gui style="tab">General</gui></guiseq>.</p>
       </item>
       <item>
-        <p>Select the desired from printer from the list of printers
-        available.</p>
-        <p>If you have selected <gui>Print to File</gui>, then:</p>
-        <steps>
-          <item>
-            <p>Click on the button next to <gui style="button">File:</gui>.
-            In the <gui>Select a filename</gui> dialog, browse and select the
-            location on disk for the file to be saved onto. Type the desired
-            name for the file and click <gui style="button">Select</gui>.</p>
-          </item>
-          <item>
-            <p>Select the format for the file to be printed. The default format
-            is set to <code>PDF</code>. You can also save in other formats such
-            as:</p>
-            <list>
-              <item>
-                <p><gui style="radiobutton">Postscript</gui></p>
-              </item>
-              <item>
-                <p><gui style="radiobutton">SVG</gui></p>
-              </item>
-            </list>
-            <note style="important">
-              <p>If you have not selected the directory for the file to be
-              saved on disk, by default the file will be saved to the
-              <em>Documents</em> folder in your HOME directory. The file
-              will be saved with the default name - <sys>output</sys> along
-              with the corresponding file extension for the selected file
-              format. For example, <sys>output.pdf</sys> or
-              <sys>output.ps</sys>.</p>
-            </note>
-          </item>
-        </steps>
+        <p>Select the printer that you want to use from the list of printers
+        or select
+        <gui href="help:gnome-help/print-to-file">Print to File</gui>.</p>
       </item>
       <item>
-        <p>To print particular pages only, multiple copies or change order of
-        prints, you can consult <link href="help:gnome-help/printing-order">printing order help</link>.
-        Additionally, from <gui style="tab">Page Setup</gui> tab: you can
-        set options to print using different layouts and paper sizes. Please
-        consult
-        <link href="help:gnome-help/printing#paper">layout and paper</link>
-        help.</p>
+        <p>Chose your <link href="help:gnome-help/printing#paper">printing
+        settings</link>.</p>
       </item>
       <item>
-        <p>Click <gui style="button">Print</gui> to send the definition
-        to the selected printer.</p>
+        <p>Press <gui style="button">Print</gui> to print the definition.</p>
       </item>
     </steps>
 


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]