GNOME.org
 

[gnome-user-docs] Review outdated files-* pages for 3.10

commit 2c13a53b6844bc601ea9b6098bd44ae34195df72
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Thu Nov 7 21:46:20 2013 +0000

    Review outdated files-* pages for 3.10
    
    Update screenshot of nautilus

 gnome-help/C/figures/nautilus.png  |  Bin 23331 -> 0 bytes
 gnome-help/C/files-autorun.page    |   75 ++++++++++++++++++---------------
 gnome-help/C/files-disc-write.page |   81 +++++++++++++++++++----------------
 gnome-help/C/files.page            |   21 +++++----
 gnome-help/Makefile.am             |    2 +-
 5 files changed, 97 insertions(+), 82 deletions(-)
---
diff --git a/gnome-help/C/files-autorun.page b/gnome-help/C/files-autorun.page
index 5a729bc..3ea7e2a 100644
--- a/gnome-help/C/files-autorun.page
+++ b/gnome-help/C/files-autorun.page
@@ -10,10 +10,7 @@
     <link type="guide" xref="files#removable"/>
 
     <revision pkgversion="3.7.1" version="0.2" date="2012-11-16" status="outdated"/>
-    <revision pkgversion="3.9.92" date="2013-10-04" status="outdated"/>
-
-    <desc>Automatically run applications for CDs and DVDs, cameras,
-    audio players, and other devices and media.</desc>
+    <revision pkgversion="3.9.92" date="2013-10-04" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -29,17 +26,21 @@
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Automatically run applications for CDs and DVDs, cameras,
+    audio players, and other devices and media.</desc>
   </info>
 
-<title>Open applications for devices or discs</title>
+  <!-- TODO: fix bad UI strings, then update help -->
+  <title>Open applications for devices or discs</title>
 
-<p>You can have an application automatically start when you plug in a device
-or insert a disc or media card. For example, you might want your photo organizer
-to start when you plug in a digital camera. You can also turn this off, so that
-nothing happens when you plug something in.</p>
+  <p>You can have an application automatically start when you plug in a device
+  or insert a disc or media card. For example, you might want your photo
+  organizer to start when you plug in a digital camera. You can also turn this
+  off, so that nothing happens when you plug something in.</p>
 
-<p>To decide which applications should start when you plug in various devices:
-</p>
+  <p>To decide which applications should start when you plug in various
+  devices: </p>
 
 <steps>
   <item>
@@ -56,9 +57,9 @@ nothing happens when you plug something in.</p>
     <p>Find your desired device or media type, and then choose an application
     or action for that media type. See below for a description of the different
     types of devices and media.</p>
-    <p>Instead of starting an application, you can also set it so that the device
-    will be shown in the file manager. When that happens, you will be asked
-    what to do, or nothing will happen automatically.</p>
+    <p>Instead of starting an application, you can also set it so that the
+    device will be shown in the file manager. When that happens, you will be
+    asked what to do, or nothing will happen automatically.</p>
   </item>
   <item>
     <p>If you don't see the device or media type that you want to change in the
@@ -69,11 +70,11 @@ nothing happens when you plug something in.</p>
   </item>
 </steps>
 
-<note style="tip">
-<p>If you don't want any applications to be opened automatically, whatever you
-plug in, select <gui>Never prompt or start programs on media insertion</gui> at
-the bottom of the Removable Media window.</p>
-</note>
+  <note style="tip">
+    <p>If you don't want any applications to be opened automatically, whatever
+    you plug in, select <gui>Never prompt or start programs on media
+    insertion</gui> at the bottom of the Removable Media window.</p>
+  </note>
 
 <section id="files-types-of-devices">
   <title>Types of devices and media</title>
@@ -114,22 +115,26 @@ the bottom of the Removable Media window.</p>
     <title>Music players</title>
     <p>Choose an application to manage the music library on your portable music
     player, or manage the files yourself using the file manager.</p>
-  </item>
-  <item>
-    <title>E-book readers</title>
-    <p>Use the <gui>Other Media</gui> button to choose an application to manage the
-    books on your e-book reader, or manage the files yourself using the file manager.</p>
-  </item>
-  <item>
-    <title>Software</title>
-    <p>Some discs and removable media contain software that is supposed to be run
-    automatically when the media is inserted. Use the <gui>Software</gui> option
-    to control what to do when media with autorun software is inserted. You will
-    always be prompted for a confirmation before software is run.</p>
-    <note style="warning">
-      <p>Never run software from media you don't trust.</p>
-    </note>
- </item>
+    </item>
+    <item>
+      <title>E-book readers</title>
+      <p>Use the <gui>Other Media</gui> button to choose an application to
+      manage the books on your e-book reader, or manage the files yourself
+      using the file manager.</p>
+    </item>
+    <item>
+      <title>Software</title>
+      <p>Some discs and removable media contain software that is supposed to be
+      run automatically when the media is inserted. Use the <gui>Software</gui>
+      option to control what to do when media with autorun software is
+      inserted. You will always be prompted for a confirmation before software
+      is run.</p>
+      <note style="warning">
+        <p>Never run software from media you don't trust.</p>
+      </note>
+   </item>
 </terms>
+
 </section>
+
 </page>
diff --git a/gnome-help/C/files-disc-write.page b/gnome-help/C/files-disc-write.page
index a67b814..f19ea3b 100644
--- a/gnome-help/C/files-disc-write.page
+++ b/gnome-help/C/files-disc-write.page
@@ -1,78 +1,85 @@
 <page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
       type="topic" style="task"
       id="files-disc-write">
+
   <info>
     <link type="guide" xref="files" group="more"/>
 
+    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+
     <credit type="author">
       <name>Michael Hill</name>
-      <email>mdhillca gmail com</email>
+      <email its:translate="no">mdhillca gmail com</email>
     </credit>
 
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
-
-    <desc>Put files and documents onto a blank CD or DVD using a CD/DVD burner.</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Put files and documents onto a blank CD or DVD using a CD/DVD
+    burner.</desc>
   </info>
 
   <title>Write files to a CD or DVD</title>
 
-  <p>You can put files onto a blank disc by using <gui>CD/DVD Creator</gui>. The
- option to create a CD or DVD will appear in the file manager as soon as you
- place the CD into your CD/DVD writer. The file manager lets you transfer files
- to other computers or perform <link xref="backup-why">backups</link> by putting
- files onto a blank disc. To write files to a CD or DVD:</p>
+  <p>You can put files onto a blank disc by using <gui>CD/DVD Creator</gui>.
+  The option to create a CD or DVD will appear in the file manager as soon as
+  you place the CD into your CD/DVD writer. The file manager lets you transfer
+  files to other computers or perform <link xref="backup-why">backups</link> by
+  putting files onto a blank disc. To write files to a CD or DVD:</p>
 
   <steps>
     <item>
-     <p>Place an empty disc into your CD/DVD writable drive.</p></item>
+      <p>Place an empty disc into your CD/DVD writable drive.</p></item>
     <item>
-     <p>In the <gui>Blank CD/DVD-R Disc</gui> notification that pops up
-     at the bottom of the screen, select <gui>Open with CD/DVD Creator</gui>.
-     The <gui>CD/DVD Creator</gui> folder window will open.</p>
-     <p>(You can also click on <gui>Blank CD/DVD-R Disc</gui> under
-     <gui>Devices</gui> in the file manager sidebar.)</p>
+      <p>In the <gui>Blank CD/DVD-R Disc</gui> notification that pops up at the
+      bottom of the screen, select <gui>Open with CD/DVD Creator</gui>. The
+      <gui>CD/DVD Creator</gui> folder window will open.</p>
+      <p>(You can also click on <gui>Blank CD/DVD-R Disc</gui> under
+      <gui>Devices</gui> in the file manager sidebar.)</p>
     </item>
     <item>
-     <p>In the <gui>Disc Name</gui> field, type a name for the disc.</p>
+      <p>In the <gui>Disc Name</gui> field, type a name for the disc.</p>
     </item>
     <item>
-     <p>Drag or copy the desired files into the window.</p>
+      <p>Drag or copy the desired files into the window.</p>
     </item>
     <item>
-     <p>Click <gui>Write to Disc</gui>.</p>
+      <p>Click <gui>Write to Disc</gui>.</p>
     </item>
     <item>
-     <p>Under <gui>Select a disc to write to</gui>, choose the blank disc.</p>
-     <p>(You could choose <gui>Image file</gui> instead. This will put the files
-     in a <em>disc image</em>, which will be saved on your computer. You can
-     then burn that disc image onto a blank disc at a later date.)</p>
+      <p>Under <gui>Select a disc to write to</gui>, choose the blank disc.</p>
+      <p>(You could choose <gui>Image file</gui> instead. This will put the
+      files in a <em>disc image</em>, which will be saved on your computer. You
+      can then burn that disc image onto a blank disc at a later date.)</p>
     </item>
     <item>
-     <p>Click <gui>Properties</gui> if you want to adjust burning speed, the
-     location of temporary files, and other options. The default options should
-     be fine.</p>
+      <p>Click <gui>Properties</gui> if you want to adjust burning speed, the
+      location of temporary files, and other options. The default options
+      should be fine.</p>
     </item>
     <item>
-     <p>Click the <gui>Burn</gui> button to begin recording.</p>
-     <p>If <gui>Burn Several Copies</gui> is selected, you will be prompted for
-     additional discs.</p>
+      <p>Click the <gui>Burn</gui> button to begin recording.</p>
+      <p>If <gui>Burn Several Copies</gui> is selected, you will be prompted
+      for additional discs.</p>
     </item>
     <item>
-     <p>When the disc burning is complete, it will eject automatically. Choose
-     <gui>Make More Copies</gui> or <gui>Close</gui> to exit.</p>
+      <p>When the disc burning is complete, it will eject automatically. Choose
+      <gui>Make More Copies</gui> or <gui>Close</gui> to exit.</p>
     </item>
   </steps>
 
 <section id="problem">
- <title>If the disc wasn't burned properly</title>
+  <title>If the disc wasn't burned properly</title>
+
   <p>Sometimes the computer doesn't record the data correctly, and you won't be
- able to see the files you put onto the disc when you insert it into a computer.</p>
+  able to see the files you put onto the disc when you insert it into a
+  computer.</p>
+
+  <p>In this case, try burning the disc again but use a lower burning speed,
+  for example, 12x rather than 48x. Burning at slower speeds is more reliable.
+  You can choose the speed by clicking the <gui>Properties</gui> button in the
+  <gui>CD/DVD Creator</gui> window.</p>
 
-  <p>In this case, try burning the disc again but use a lower burning speed, e.g.
- 12x rather than 48x. Burning at slower speeds is more reliable. You can choose
- the speed by clicking the <gui>Properties</gui> button in the
- <gui>CD/DVD Creator</gui> window.</p>
 </section>
 
-</page>
\ No newline at end of file
+</page>
diff --git a/gnome-help/C/files.page b/gnome-help/C/files.page
index a98b40c..196a692 100644
--- a/gnome-help/C/files.page
+++ b/gnome-help/C/files.page
@@ -2,19 +2,20 @@
       xmlns:if="http://projectmallard.org/if/1.0/";
       type="guide" style="task" version="1.0 if/1.0"
       id="files">
-  <info>
 
+  <info>
     <link type="guide" xref="index" group="files"/>
 
+    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.10" date="2013-11-07" status="review"/>
+
     <credit type="author">
       <name>Shaun McCance</name>
-      <email>shaunm gnome org</email>
+      <email its:translate="no">shaunm gnome org</email>
     </credit>
 
     <title type="link" role="trail">Files</title>
 
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
-
     <desc>
       <link xref="files-search">Searching</link>,
       <link xref="files-delete">delete files</link>,
@@ -24,12 +25,12 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Files, folders &amp; search</title>
+  <title>Files, folders &amp; search</title>
 
-<media type="image" src="figures/nautilus.png" style="floatend floatright" width="250" height="219"
-       if:test="!target:mobile">
-  <p><app>Nautilus</app> file manager</p>
-</media>
+  <!-- TODO: would be nice to give this image some styling -->
+  <media type="image" src="figures/nautilus-3-10.png" style="floatend floatright" width="350" 
if:test="!target:mobile">
+    <p><app>Files</app> file manager</p>
+  </media>
 
 <links type="topic" style="linklist nodesc bold">
   <title>Common tasks</title>
@@ -39,6 +40,8 @@
   <title>More topics</title>
 </links>
 
+  <!-- Documents is a different app, might make more sense towards the bottom
+       or as a seealso -->
 <section id="documents">
   <title>Documents</title>
   <links type="topic"/>
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index 3ef8815..e851986 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -38,7 +38,7 @@ HELP_MEDIA = \
        figures/input-keyboard-symbolic.png \
        figures/input-methods-switcher.png \
        figures/keyboard-key-menu.svg \
-       figures/nautilus.png \
+       figures/nautilus-3-10.png \
        figures/nautilus-icons.png \
        figures/network-cellular-3g-symbolic.svg \
        figures/network-cellular-4g-symbolic.svg \
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]