GNOME.org
 

[gnome-user-docs] Some 3.2 candidates, minor and interface changes

commit e25f018c8c1df5c8861269164888ea839143ce3d
Author: Michael Hill <mdhill src gnome org>
Date:   Mon Sep 19 21:10:23 2011 -0400

    Some 3.2 candidates, minor and interface changes

 gnome-help/C/user-admin-change.page   |    6 +++-
 gnome-help/C/user-admin-explain.page  |   51 +++++++++++++++++++++++-----
 gnome-help/C/user-admin-problems.page |   13 +++++--
 gnome-help/C/user-changepassword.page |   11 +++++-
 gnome-help/C/user-changepicture.page  |    4 ++-
 gnome-help/C/user-delete.page         |   10 +++--
 gnome-help/C/user-goodpassword.page   |   59 +++++++++++++++++++++------------
 gnome-help/C/video-dvd.page           |    6 ++--
 gnome-help/C/video-sending.page       |   36 ++++++++++++++++----
 9 files changed, 144 insertions(+), 52 deletions(-)
---
diff --git a/gnome-help/C/user-admin-change.page b/gnome-help/C/user-admin-change.page
index 5d8cfa6..eb0e059 100644
--- a/gnome-help/C/user-admin-change.page
+++ b/gnome-help/C/user-admin-change.page
@@ -8,6 +8,9 @@
     <link type="seealso" xref="user-admin-explain" />
     
     <desc>You can change which users are allowed to make changes to the system by giving them administrative privileges.</desc>
+
+    <revision pkgversion="3.2" date="2011-09-19" status="candidate"/>
+    
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -22,7 +25,8 @@
 
 <steps>
  <item>
-  <p>Click your name on the top bar, select <gui>System Settings</gui> and open <gui>User Accounts</gui>.</p>
+    <p>Click your name on the top bar and click the picture next to your
+    name to open the <gui>User Accounts</gui> window.</p>
  </item>
  
  <item>
diff --git a/gnome-help/C/user-admin-explain.page b/gnome-help/C/user-admin-explain.page
index 972c1bf..509935e 100644
--- a/gnome-help/C/user-admin-explain.page
+++ b/gnome-help/C/user-admin-explain.page
@@ -6,6 +6,8 @@
     <link type="guide" xref="user-accounts#privileges"/>
     
     <desc>You need admin privileges to change important parts of your system.</desc>
+
+    <revision pkgversion="3.2" date="2011-09-19" status="candidate"/>
     
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -17,26 +19,57 @@
 
 <title>How do administrative privileges work?</title>
 
-<p>As well as the files that <em>you</em> create, your computer also has a number of files which are needed by the system for it to work properly. If these important <em>system files</em> are changed improperly they can cause various things to break, so they are protected from changes by default. Certain applications also modify important parts of the system, and so are also protected.</p>
+  <p>As well as the files that <em>you</em> create, your computer also has a
+ number of files which are needed by the system for it to work properly. If
+ these important <em>system files</em> are changed improperly they can cause
+ various things to break, so they are protected from changes by default. Certain
+ applications also modify important parts of the system, and so are also
+ protected.</p>
 
-<p>The way that they are protected is by only allowing users with <em>administrative privileges</em> to change the files or use the applications. In day-to-day use, you won't need to change any system files or use these applications, so by default you do not have admin privileges.</p>
+  <p>The way that they are protected is by only allowing users with
+ <em>administrative privileges</em> to change the files or use the applications.
+ In day-to-day use, you won't need to change any system files or use these
+ applications, so by default you do not have admin privileges.</p>
 
-<p>Sometimes you need to use these applications, so you may be able to temporarily get admin privileges to allow you to make the changes. If an application needs admin privileges, it will ask for your password. For example, if you want to install some new software, the software installer (package manager) will ask for your admin password so it can add the new application to the system. Once it has finished, your admin privileges will be taken away again.</p>
+  <p>Sometimes you need to use these applications, so you may be able to
+ temporarily get admin privileges to allow you to make the changes. If an
+ application needs admin privileges, it will ask for your password. For example,
+ if you want to install some new software, the software installer (package
+ manager) will ask for your admin password so it can add the new application to
+ the system. Once it has finished, your admin privileges will be taken away
+ again.</p>
 
-<p>Admin privileges are associated with your user account. Some users are allowed to have admin privileges and some are not. Without admin privileges you will not be able to install software. Some user accounts (for example, the "root" account) have permanent admin privileges. You shouldn't use admin privileges all of the time, because you might accidentally change an important file and break something.</p>
+  <p>Admin privileges are associated with your user account. Some users are
+ allowed to have admin privileges and some are not. Without admin privileges you
+ will not be able to install software. Some user accounts (for example, the
+ "root" account) have permanent admin privileges. You shouldn't use admin
+ privileges all of the time, because you might accidentally change an important
+ file and break something.</p>
 
-<p>In summary, admin privileges allow you to change important parts of your system when you need to, but prevent you from doing it accidentally.</p>
+  <p>In summary, admin privileges allow you to change important parts of your
+ system when you need to, but prevent you from doing it accidentally.</p>
 
 <note>
  <title>What does "super user" mean?</title>
- <p>A user with admin privileges is sometimes called a <em>super user</em>. This is simply because that user has more privileges than normal users. You might see people discussing things like <cmd>su</cmd> and <cmd>sudo</cmd>; these are programs for temporarily giving you "super user" (admin) privileges.</p>
+  <p>A user with admin privileges is sometimes called a <em>super user</em>.
+ This is simply because that user has more privileges than normal users. You
+ might see people discussing things like <cmd>su</cmd> and <cmd>sudo</cmd>;
+ these are programs for temporarily giving you "super user" (admin) privileges.</p>
 </note>
 
 <section id="advantages">
  <title>Why are admin privileges useful?</title>
- <p>Requiring users to have admin privileges before important system changes are made is useful because it helps to prevent your system from being broken, intentionally or unintentionally.</p>
- <p>If you had admin privileges all of the time, you might accidentally change an important file, or run an application which changes something important by mistake. Only getting admin privileges temporarily, when you need them, reduces the risk of these mistakes happening.</p>
- <p>Only certain, trusted users should be allowed to have admin privileges. This prevents other users from messing with the computer and doing things like uninstalling applications that you need, installing applications that you don't want, or changing important files. This is useful from a security standpoint.</p>
+  <p>Requiring users to have admin privileges before important system changes
+ are made is useful because it helps to prevent your system from being broken,
+ intentionally or unintentionally.</p>
+  <p>If you had admin privileges all of the time, you might accidentally change
+ an important file, or run an application which changes something important by
+ mistake. Only getting admin privileges temporarily, when you need them, reduces
+ the risk of these mistakes happening.</p>
+  <p>Only certain, trusted users should be allowed to have admin privileges.
+ This prevents other users from messing with the computer and doing things like
+ uninstalling applications that you need, installing applications that you don't
+ want, or changing important files. This is useful from a security standpoint.</p>
 </section>
 
 </page>
diff --git a/gnome-help/C/user-admin-problems.page b/gnome-help/C/user-admin-problems.page
index 3e1afa4..195be8e 100644
--- a/gnome-help/C/user-admin-problems.page
+++ b/gnome-help/C/user-admin-problems.page
@@ -7,6 +7,8 @@
     
     <desc>You can only do some things, like installing applications, if you have admin privileges.</desc>
     
+    <revision pkgversion="3.2" date="2011-09-19" status="candidate"/>
+
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -17,20 +19,23 @@
 
 <title>Problems caused by administrative restrictions</title>
 
-<p>There are a few problems that you might experience because you don't have <link xref="user-admin-explain">administrative privileges</link>. Some things require you to have admin privileges in order to work, such as:</p>
+  <p>You may experience a few problems if you don't have
+ <link xref="user-admin-explain">administrative privileges</link>. Some tasks
+ require admin privileges in order to work, such as:</p>
 
 <list>
  <item>
-  <p>Connecting to some networks/wireless networks</p>
+  <p>Connecting to networks or wireless networks</p>
  </item>
  <item>
-  <p>Viewing the contents of a removable disk plugged-in to the computer, or the contents of a different disk partition (e.g. if you have a Windows partition)</p>
+  <p>Viewing the contents of a removable disk connected to the computer, or the
+ contents of a different disk partition (e.g. a Windows partition)</p>
  </item>
  <item>
   <p>Installing new applications</p>
  </item>
 </list>
 
-<p>You can <link xref="user-admin-change">change who has admin privileges</link>.</p>
+  <p>You can <link xref="user-admin-change">change who has admin privileges</link>.</p>
 
 </page>
diff --git a/gnome-help/C/user-changepassword.page b/gnome-help/C/user-changepassword.page
index 24af68b..68fdb75 100644
--- a/gnome-help/C/user-changepassword.page
+++ b/gnome-help/C/user-changepassword.page
@@ -8,7 +8,7 @@
     
     <desc>Keep your account secure by changing your password often
     in your account settings.</desc>
-    
+
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -37,9 +37,16 @@
   final for 3.0.x without that, but leave this comment in for 3.2.</p>
 </comment>
 
+<comment>
+  <cite date="2011-09-19">mdhill</cite>
+  <p>Not prompted to change keyring password on next login in 3.2. Add
+  keyring pages.</p>
+</comment>
+
 <p>It is a good idea to change your password from time to time, especially if you think someone else knows what your password is.</p>
    <steps>
-    <item><p>Click your name on the top bar and select <gui>My Account</gui>.</p></item>
+    <item><p>Click your name on the top bar and click the picture next to your
+    name to open the <gui>User Accounts</gui> window.</p></item>
     <item><p>Click the label next to <gui>Password</gui>.</p><note>
     <p>The label should look
     like a series of dots or boxes if you already have a password set.</p></note></item>
diff --git a/gnome-help/C/user-changepicture.page b/gnome-help/C/user-changepicture.page
index 2d51762..a2f1331 100644
--- a/gnome-help/C/user-changepicture.page
+++ b/gnome-help/C/user-changepicture.page
@@ -5,6 +5,7 @@
   <info>
     <link type="guide" xref="user-accounts#manage"/>
     <desc>Add your photo to the login and user screens.</desc>
+    <revision pkgversion="3.2" date="2011-09-19" status="candidate"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -25,7 +26,8 @@
   webcam.</p>
 
   <steps>
-    <item><p>Click your name on the top bar and select <gui>My Account</gui>.</p></item>
+    <item><p>Click your name on the top bar and click the picture next to your
+    name to open the <gui>User Accounts</gui> window.</p></item>
     <item><p>Click the picture next to your name. A drop-down gallery
     will be shown with some stock login photos. If you like one of
     them, click it to use it for yourself.</p>
diff --git a/gnome-help/C/user-delete.page b/gnome-help/C/user-delete.page
index 26d32f0..99fc579 100644
--- a/gnome-help/C/user-delete.page
+++ b/gnome-help/C/user-delete.page
@@ -5,6 +5,7 @@
   <info>
     <link type="guide" xref="user-accounts#manage"/>
     <desc>Remove users that no longer use your computer.</desc>
+    <revision pkgversion="3.2" date="2011-09-19" status="candidate"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski com</email>
@@ -27,15 +28,16 @@
   your computer, you can delete that user's account.</p>
 
 <steps>
-  <item><p>Click your name on the top bar and select <gui>My Account</gui>.</p></item>
+  <item><p>Click your name on the top bar and click the picture next to your
+  name to open the <gui>User Accounts</gui> window.</p></item>
   <item><p>Click <gui>Unlock</gui> in the top right corner and type your
   password to make changes. You must be an administrative user to delete user
   accounts.</p></item>
   <item><p>Select the user you want to delete and click the <gui>-</gui> button.</p></item>
   <item><p>Each user has their own home folder for their files and settings.
-  You can choose to keep or delete the user's home folder. Delete the files
-  if you're sure they won't be used anymore and you need to free up disk
-  space. These files are permanently deleted. They can't be recovered. You
+  You can choose to keep or delete the user's home folder. Click <gui>Delete
+  Files</gui> if you're sure they won't be used anymore and you need to free up
+  disk space. These files are permanently deleted. They can't be recovered. You
   may want to back up the files to an external drive or CD before deleting
   them.</p></item>
 </steps>
diff --git a/gnome-help/C/user-goodpassword.page b/gnome-help/C/user-goodpassword.page
index 1674c9e..5ca5667 100644
--- a/gnome-help/C/user-goodpassword.page
+++ b/gnome-help/C/user-goodpassword.page
@@ -6,6 +6,7 @@
     <link type="guide" xref="user-accounts#passwords"/>
     
     <desc>Use longer, more complicated passwords.</desc>
+    <revision pkgversion="3.2" date="2011-09-19" status="candidate"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -26,41 +27,53 @@
 
 <note style="important">
  <p>
- Make your passwords easy enough for you to remember, but very difficult for others (including computer programs) to guess.  
+ Make your passwords easy enough for you to remember, but very difficult for
+ others (including computer programs) to guess.  
  </p>
 </note>
-<p>Choosing a good password will help to keep your computer safe. If your password is easy to guess, someone may figure it out and gain access to your personal information.</p>
-<p>People could even use computers to systematically try to guess your password, so even one that would be difficult for a human to guess might be extremely easy for a computer program to crack. Here are some tips for choosing a good password:</p>
+  <p>Choosing a good password will help to keep your computer safe. If your
+ password is easy to guess, someone may figure it out and gain access to your
+ personal information.</p>
+  <p>People could even use computers to systematically try to guess your
+ password, so even one that would be difficult for a human to guess might be
+ extremely easy for a computer program to crack. Here are some tips for choosing
+ a good password:</p>
 
 <list>
  <item>
-  <p>Use a mixture of upper-case and lower-case letters, numbers, symbols and spaces in the password.  This makes it more difficult to guess; there are more symbols to choose from, so more possible passwords that someone would have to check when trying to guess yours.</p>
+  <p>Use a mixture of upper-case and lower-case letters, numbers, symbols and
+ spaces in the password.  This makes it more difficult to guess; there are more
+ symbols to choose from, so more possible passwords that someone would have to
+ check when trying to guess yours.</p>
   <note>
-<p>
-  A good method for choosing a password is to take the first letter of each word in a phrase that you can remember.  The phrase could be the name of a movie, a book, a song or an album. For example, "Flatland: A Romance of Many Dimensions" would become F:ARoMD or faromd or f: aromd.
-</p>
+  <p>A good method for choosing a password is to take the first letter of each
+ word in a phrase that you can remember.  The phrase could be the name of a
+ movie, a book, a song or an album. For example, "Flatland: A Romance of Many
+ Dimensions" would become F:ARoMD or faromd or f: aromd.</p>
 </note>
  </item>
  <item>
-  <p>Make your password as long as possible. The more characters it contains, the longer it should take for a person or computer to guess it.</p>
+  <p>Make your password as long as possible. The more characters it contains,
+ the longer it should take for a person or computer to guess it.</p>
  </item>
  <item>
-  <p>Do not use any words that appear in a standard dictionary in any language.  Password crackers will try these first.   The most common password is "password" - people can guess passwords like this very quickly!</p>
+  <p>Do not use any words that appear in a standard dictionary in any language.
+  Password crackers will try these first.   The most common password is
+ "password" - people can guess passwords like this very quickly!</p>
   </item>
   <item>
-  <p>Do not use any personal information such as a date, license plate number, or any family member's name.</p>
+  <p>Do not use any personal information such as a date, license plate number,
+ or any family member's name.</p>
   </item>
   <item>
   <p>Do not use any nouns. </p>
  </item>
  <item>
- <p>
-  Choose a password that can be typed quickly, to decrease the chances of someone being able to make out what you have typed if they happen to be watching you.
- </p>
+  <p>Choose a password that can be typed quickly, to decrease the chances of
+ someone being able to make out what you have typed if they happen to be
+ watching you.</p>
  <note style="tip">
-  <p>
- Never write your passwords down anywhere.  They can be easily found!
- </p>
+  <p>Never write your passwords down anywhere.  They can be easily found!</p>
  </note>
  </item>
  <item>
@@ -69,14 +82,18 @@
 
  <item>
   <p>Use different passwords for different accounts.</p>
-  <p>If you use the same password for all of your accounts, anyone who guesses it will be able to access all of your accounts immediately.</p>
-  <p>It can be difficult to remember lots of passwords, however. Though not as secure as using a different passwords for everything, it may be easier to use the same one for things that don't matter (like websites), and different ones for important things (like your online banking account and your email).</p>
+  <p>If you use the same password for all of your accounts, anyone who guesses
+ it will be able to access all of your accounts immediately.</p>
+  <p>It can be difficult to remember lots of passwords, however. Though not as
+ secure as using a different passwords for everything, it may be easier to use
+ the same one for things that don't matter (like websites), and different ones
+ for important things (like your online banking account and your email).</p>
  </item>
  
  <item>
- <p>
- Change your passwords regularly.
- </p>
+  <p>
+   Change your passwords regularly.
+  </p>
  </item>
 </list>
 
diff --git a/gnome-help/C/video-dvd.page b/gnome-help/C/video-dvd.page
index 36aad67..c393fa6 100644
--- a/gnome-help/C/video-dvd.page
+++ b/gnome-help/C/video-dvd.page
@@ -21,8 +21,8 @@
 
 <section id="codecs">
  <title>Installing the right codecs for DVD playback</title>
- <p>In order to play DVDs, you need to have the right <em>codecs</em> installed. A codec is some software that allows applications to read a video or audio format. If you try to play a DVD and don't have the right codecs installed, the movie player you're using should tell you about this and offer to install them for you.
- If this doesn't happen, you'll have to install the codecs manually - ask for help on how to do this using your Linux distribution's support forums or otherwise. The software packages you'll probably need are <app>gstreamer0.10-plugins-ugly</app> and <app>libdvd0</app>.</p>
+ <p>In order to play DVDs, you need to have the right <em>codecs</em> installed. A codec is a piece of software that allows applications to read a video or audio format. If you try to play a DVD and don't have the right codecs installed, the movie player you're using should tell you about this and offer to install them for you.
+ If this doesn't happen, you'll have to install the codecs manually - ask for help on how to do this using your Linux distribution's support forums. The software packages you'll probably need are <app>gstreamer0.10-plugins-ugly</app> and <app>libdvd0</app>.</p>
  <p>DVDs are also "copy-protected" using a system called CSS. This prevents you from copying DVDs, but it also prevents you from playing them unless you have some extra software to handle the copy protection.</p>
 
  <p>You can buy a commercial DVD decoder that can handle copy protection from <link href="http://www.fluendo.com/shop/product/fluendo-dvd-player/";>Fluendo</link>. It works with Linux and should be legal to use in all countries.</p>
@@ -30,7 +30,7 @@
 
 <section id="region">
  <title>Checking the DVD region</title>
- <p>DVDs have a "region code", which tells you in which region of the world you are allowed to play the DVD. DVD players can only play DVDs from the same region as them. For example, if you have a region 1 DVD player, you will only be allowed to play DVDs from North America.</p>
+ <p>DVDs have a <em>region code</em>, which tells you in which region of the world you are allowed to play the DVD. DVD players can only play DVDs from the same region as them. For example, if you have a Region 1 DVD player, you will only be allowed to play DVDs from North America.</p>
  <p>If the region of your computer's DVD player and the DVD you are trying to play do not match, you won't be able to play the DVD. It is often possible to change the region used by your DVD player, but you can only do this a few times before it locks into one region permanently.</p>
  <p>To change the DVD region of your computer's DVD player, use <link href="http://linvdr.org/projects/regionset/";>regionset</link>.</p>
 </section>
diff --git a/gnome-help/C/video-sending.page b/gnome-help/C/video-sending.page
index 7c9f2d6..12a4c27 100644
--- a/gnome-help/C/video-sending.page
+++ b/gnome-help/C/video-sending.page
@@ -5,6 +5,7 @@
   <info>
     <link type="guide" xref="media#videos"/>    
     <desc>Check that they have the right video codecs installed.</desc>
+    <revision pkgversion="3.2" date="2011-09-19" status="candidate"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -15,21 +16,42 @@
 
 <title>Other people can't play the videos I made</title>
 
-<p>If you made a video on your Linux computer and sent it to someone using Windows or Mac OS, you may find that they have problems playing the video.</p>
+  <p>If you made a video on your Linux computer and sent it to someone using
+ Windows or Mac OS, you may find that they have problems playing the video.</p>
 
-<p>To be able to play your video, the person you sent it to must have the right <em>codecs</em> installed. A codec is a little piece of software that knows how to take the video and display it on the screen. There are lots of different video formats and each requires a different codec to play it back.You can check which format your video is by doing:</p> 
+  <p>To be able to play your video, the person you sent it to must have the
+ right <em>codecs</em> installed. A codec is a little piece of software that
+ knows how to take the video and display it on the screen. There are lots of
+ different video formats and each requires a different codec to play it back.
+ You can check which format your video is by doing:</p> 
 <list>
-    <item><p>Open the <app>Files</app> application from the <gui>Activities</gui> overview.</p></item> 
+    <item><p>Open the <app>Files</app> application from the <gui>Activities</gui>
+ overview.</p></item> 
     <item><p>Right-click on video file and select <gui>Properties</gui>.</p></item>
-    <item><p>Go to the <gui>Audio/Video</gui> tab and look at which <gui>codec</gui> is listed under <gui>Video</gui>.</p></item>
+    <item><p>Go to the <gui>Audio/Video</gui> tab and look at which
+ <gui>codec</gui> is listed under <gui>Video</gui>.</p></item>
 </list>
 
-<p>Ask the person having problems with playback if they have the right codec installed. They may find it helpful to search the web for the name of the codec plus the name of their video playback application. For example, if your video uses the <em>Theora</em> format and you have a friend using Windows Media Player to try and watch it, search for "theora windows media player". You will often be able to download the right codec for free if it's not installed.</p>
+  <p>Ask the person having problems with playback if they have the right codec
+ installed. They may find it helpful to search the web for the name of the codec
+ plus the name of their video playback application. For example, if your video
+ uses the <em>Theora</em> format and you have a friend using Windows Media
+ Player to try and watch it, search for "theora windows media player". You will
+ often be able to download the right codec for free if it's not installed.</p>
 
-<p>If you can't find the right codec, try the <link href="http://www.videolan.org/vlc/";>VLC media player</link>. It works on Windows and Mac OS as well as Linux, and supports a lot of different video formats. Failing that, try converting your video into a different format. Most video editors are able to do this, and specific video converter applications are available. Check the software installer application to see what's available.</p>
+  <p>If you can't find the right codec, try the
+ <link href="http://www.videolan.org/vlc/";>VLC media player</link>. It works on
+ Windows and Mac OS as well as Linux, and supports a lot of different video
+ formats. Failing that, try converting your video into a different format. Most
+ video editors are able to do this, and specific video converter applications are
+ available. Check the software installer application to see what's available.</p>
 
 <note>
- <p>There are a few other problems which might prevent someone from playing your video. The video could have been damaged when you sent it to them (sometimes big files aren't copied across perfectly), they could have problems with their video playback application, or the video may not have been created properly (there could have been some errors when you saved the video).</p>
+  <p>There are a few other problems which might prevent someone from playing
+ your video. The video could have been damaged when you sent it to them
+ (sometimes big files aren't copied across perfectly), they could have problems
+ with their video playback application, or the video may not have been created
+ properly (there could have been some errors when you saved the video).</p>
 </note>
 	
 </page>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]