[gnome-user-docs] Write new net- stubs and the video-sending stub



commit b6d5d8ab60ed0170643d0f10479e4b6a3ddde2df
Author: Phil Bull <philbull gmail com>
Date:   Fri Apr 1 18:46:09 2011 +0100

    Write new net- stubs and the video-sending stub

 gnome-help/C/net-othersconnect.page        |   43 ++++++++++++++---------
 gnome-help/C/net-otherscontrol.page        |   46 +++++++++++++++----------
 gnome-help/C/net-passwordok-noconnect.page |   51 ++++++++++++++++++----------
 gnome-help/C/video-sending.page            |   20 ++++++++---
 4 files changed, 102 insertions(+), 58 deletions(-)
---
diff --git a/gnome-help/C/net-othersconnect.page b/gnome-help/C/net-othersconnect.page
index 1668137..d1eaa75 100644
--- a/gnome-help/C/net-othersconnect.page
+++ b/gnome-help/C/net-othersconnect.page
@@ -3,31 +3,40 @@
       id="net-othersconnect">
   <info>
     <link type="guide" xref="net#problems"/>
-    <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
+    <link type="seealso" xref="net-otherscontrol"/>
+    
+    <revision pkgversion="3.0" date="2011-04-01" status="review"/>
 
-    <credit type="author copyright">
-      <name>Shaun McCance</name>
-      <email>shaunm gnome org</email>
-      <years>2011</years>
+    <credit type="author">
+      <name>Phil Bull</name>
+      <email>philbull gmail com</email>
     </credit>
 
     <desc></desc>
   </info>
 
-  <title>Other users can't connect to the Internet</title>
+<title>Other users can't connect to the internet</title>
 
-  <comment>
-    <cite date="2011-03-20" href="mailto:shaunm gnome org">Shaun McCance</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
+<p>If you have set up a network connection but other users on your computer can't connect to it, they probably aren't entering the right settings when they try to connect. For example, if you have a wireless connection, they may not be entering the right wireless security password.</p>
 
-  <p>Short introductory text...</p>
+<p>You can make it so that everyone can share the settings for a network connection once you have set it up. This means that you only need to set it up once, and everyone else on the computer will be able to connect to it without being asked any questions. To do this:</p>
 
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+<steps>
+ <item>
+  <p>Click the network icon on the top bar and click <gui>Edit Connections</gui>.</p>
+ </item>
+ 
+ <item>
+  <p>Find the connection you want everyone to be able to use. Click to select it and then click <gui>Edit</gui>.</p>
+ </item>
+ 
+ <item>
+  <p>Check <gui>Available to all users</gui> and click <gui>Save</gui>. You will have to enter your admin password to save the changes. Only admin users can do this.</p>
+ </item>
+ 
+ <item>
+  <p>Other users of the computer will now be able to use this connection without entering any further details.</p>
+ </item>
+</steps>
 
 </page>
diff --git a/gnome-help/C/net-otherscontrol.page b/gnome-help/C/net-otherscontrol.page
index 2ec2416..ae3a67a 100644
--- a/gnome-help/C/net-otherscontrol.page
+++ b/gnome-help/C/net-otherscontrol.page
@@ -3,31 +3,41 @@
       id="net-otherscontrol">
   <info>
     <link type="guide" xref="net#problems"/>
-    <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
+    <revision pkgversion="3.0" date="2011-04-01" status="review"/>
 
-    <credit type="author copyright">
-      <name>Shaun McCance</name>
-      <email>shaunm gnome org</email>
-      <years>2011</years>
+    <credit type="author">
+      <name>Phil Bull</name>
+      <email>philbull gmail com</email>
     </credit>
 
-    <desc></desc>
+    <desc>You need to uncheck the <gui>Available to all users</gui> option in the connection settings.</desc>
   </info>
 
-  <title>Other users can't control the network connections</title>
+<title>Other users can't control the network connections</title>
 
-  <comment>
-    <cite date="2011-03-20" href="mailto:shaunm gnome org">Shaun McCance</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
+<p>If you can edit a network connection but other users on your computer can't, you may have set the connection to be <gui>available to all users</gui>. This makes it so that everyone on the computer can <em>connect</em> using that connection, but only users <link xref="user-admin-explain">with administrative rights</link> are allowed to change its settings.</p>
 
-  <p>Short introductory text...</p>
+<p>The reason for this is that, since everyone is affected if the settings are changed, only highly-trusted (admin) users should be allowed to modify the connection.</p>
 
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+<p>If other users really need to be able to change the connection themselves, make it so the connection is <em>not</em> available to everyone on the computer. This way, everyone will be able to manage their own connection settings rather than relying on one set of shared, system-wide settings for the connection.</p>
+
+<steps>
+ <title>Make it so that the connection isn't shared any more</title>
+ <item>
+  <p>Click the network icon on the top bar and click <gui>Edit Connections</gui>.</p>
+ </item>
+ 
+ <item>
+  <p>Find the connection you want everyone to be able to manage/edit themselves. Click to select it and then click <gui>Edit</gui>.</p>
+ </item>
+ 
+ <item>
+  <p>You will have to enter your admin password to change the connection. Only admin users can do this.</p>
+ </item>
+ 
+ <item>
+  <p>Uncheck <gui>Available to all users</gui> and click <gui>Save</gui>. Other users of the computer will now be able to manage the connection themselves.</p>
+ </item>
+</steps>
 
 </page>
diff --git a/gnome-help/C/net-passwordok-noconnect.page b/gnome-help/C/net-passwordok-noconnect.page
index 3e83f67..dfb6a51 100644
--- a/gnome-help/C/net-passwordok-noconnect.page
+++ b/gnome-help/C/net-passwordok-noconnect.page
@@ -3,31 +3,46 @@
       id="net-passwordok-noconnect">
   <info>
     <link type="guide" xref="net#wireless"/>
-    <revision pkgversion="3.0" date="2011-03-20" status="stub"/>
+    <revision pkgversion="3.0" date="2011-04-01" status="review"/>
 
     <credit type="author">
-      <name>Jim Campbell</name>
-      <email>jwcampbell gmail com</email>
-      <years>2011</years>
+      <name>Phil Bull</name>
+      <email>philbull gmail com</email>
     </credit>
 
-    <desc>XXXXX</desc>
+    <desc>Double-check the password, try using the pass key instead of the password, turn the wireless card off and on again...</desc>
   </info>
 
-  <title>I've entered the correct password, but I still can't connect</title>
+<title>I've entered the correct password, but I still can't connect</title>
 
-  <comment>
-    <cite date="2011-03-20" href="mailto:jwcampbell gmail com">Jim Campbell</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
+<p>If you're sure that you entered the correct <link xref="net-wireless-wepwpa">wireless password</link> but you still can't successfully connect to a wireless network, try some of the following:</p>
 
-  <p>Short introductory text...</p>
-
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+<list>
+ <item>
+  <p>Double-check that you have the right password</p>
+  <p>Passwords are case-sensitive (it matters whether they have capital or lower-case letters), so check that you didn't get the case of one of the letters wrong.</p>
+ </item>
+ 
+ <item>
+  <p>Try the hex or ASCII pass key</p>
+  <p>The password you enter can also be represented in a different way - as a string of characters in hexadecimal (numbers 0-9 and letters a-f). If you have access to the pass key as well as the password/passphrase, try typing the pass key instead. Make sure you select the correct <gui>wireless security</gui> option when asked for your password (for example, select <gui>WEP 40/128-bit Key</gui> if you're typing the 40-character pass key for a WEP-encrypted connection).</p>
+ </item>
+ 
+ <item>
+  <p>Try turning your wireless card off and then on again</p>
+  <p>Sometimes wireless cards get stuck or experience a minor problem that means they won't connect. Try turning the card off and then on again to reset it - see <link xref="net-wireless-troubleshooting"/> for more information.</p>
+ </item>
+ 
+ <item>
+  <p>Check that you're using the right type of wireless security</p>
+  <p>When prompted for your wireless security password, you can choose which type of wireless security to use. Make sure you choose the one that is used by the router or wireless base station. This should be selected by default, but sometimes it will not be for some reason. If you don't know which one it is, use trial and error to go through the different options.</p>
+ </item>
+ 
+ <item>
+  <p>Check that your wireless card is properly supported</p>
+  <p>Some wireless cards aren't supported very well. They show up as a wireless connection, but they can't connect to a network because their drivers lack the ability to do this. See if you can get an alternative wireless driver, or if you need to perform some extra set-up (like installing a different <em>firmware</em>). See <link xref="net-wireless-troubleshooting"/> for more information.</p>
+ </item>
+ 
+</list>
 
 </page>
diff --git a/gnome-help/C/video-sending.page b/gnome-help/C/video-sending.page
index 3d51b27..49c6b33 100644
--- a/gnome-help/C/video-sending.page
+++ b/gnome-help/C/video-sending.page
@@ -5,9 +5,9 @@
   <info>
     <link type="guide" xref="media#videos"/>
     
-    <desc>XXXXX</desc>
+    <desc>Check that they have the right video codecs installed.</desc>
     
-    <revision pkgversion="3.0" version="0.1" date="2011-03-25" status="stub"/>
+    <revision pkgversion="3.0" date="2011-04-01" status="review"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -18,8 +18,18 @@
 
 <title>Other people can't play the videos I made</title>
 
-<comment>
- <p>People using Windows or Mac OS might not have the right codecs installed to play a video that you put on a CD (for example). Explain briefly what a codec is, and how you might want to try using a different codec for the video, or to get your friends to install a codec on their own computer.</p>
-</comment>
+<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.</p>
+
+<p>You can check which format your video is in by finding it in the file manager (look for <app>Files</app> in the <gui>Activities</gui> overview), right-clicking it and selecting <gui>Properties</gui>. Go to the <gui>Audio/Video</gui> tab and look at which <gui>codec</gui> is listed under <gui>Video</gui>.</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 convertor 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>
+</note>
 	
 </page>



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