cheese r1012 - in trunk/help: . C



Author: dgsiegel
Date: Thu Sep 11 08:12:52 2008
New Revision: 1012
URL: http://svn.gnome.org/viewvc/cheese?rev=1012&view=rev

Log:
use markups and cross-references in help, fixes bug #551764, courtesy of Theppitak Karoonboonyanan


Modified:
   trunk/help/C/cheese.xml
   trunk/help/ChangeLog

Modified: trunk/help/C/cheese.xml
==============================================================================
--- trunk/help/C/cheese.xml	(original)
+++ trunk/help/C/cheese.xml	Thu Sep 11 08:12:52 2008
@@ -190,7 +190,7 @@
     <title>Effects</title>
     <para>
       To apply effects to the input of your webcam, click
-      the button labelled Effects. When you go to the
+      the button labelled <guibutton>Effects</guibutton>. When you go to the
       effects window, you will see a window similar to the image below
       <figure>
         <title>&app; effects screenshot</title>
@@ -209,9 +209,11 @@
       You are able to select numerous effects to apply to your photo. To apply
       an effect, just click on the effect that you want. The button will appear highlighted.
       Selecting multiple effects will apply all the effects to
-      your image (for example, if you apply âHulkâ and âHorizontal Flipâ, the
+      your image (for example, if you apply <guibutton>Hulk</guibutton> and
+      <guibutton>Vertical Flip</guibutton>, the
       input from the webcam will be altered to have a green shade and be up side down).
-      To disable all effects, just click on the âNo Effectâ button.
+      To disable all effects, just click on the
+      <guibutton>No Effect</guibutton> button.
     </para>
   </section>
 
@@ -219,9 +221,13 @@
     <title>Photo Mode</title>
     <para>
       Photo mode is the default mode that &app; opens in. When not in photo mode,
-      click the button labelled âPhotoâ, press Alt + P or Menu: Cheese - Photo to change to photo mode.
-      Photo mode will take a single photo every time the button labelled âTake a
-      photoâ or the Spacebar is pressed, and will save to disk.
+      click the button labelled <guibutton>Photo</guibutton>, press
+      <keycombo><keycap>Alt</keycap><keycap>P</keycap></keycombo> or Menu:
+      <menuchoice><guimenu>Cheese</guimenu><guimenuitem>Photo</guimenuitem></menuchoice>
+      to change to photo mode.
+      Photo mode will take a single photo every time the button labelled
+      <guibutton>Take a photo</guibutton> or the <keycap>Spacebar</keycap>
+      is pressed, and will save to disk.
     </para>
   </section>
 
@@ -229,19 +235,24 @@
     <title>Video Mode</title>
     <para>
       Video mode is a mode that allows you to take short videos using the webcam.
-      When not in video mode, click the button labelled âVideoâ, press Alt â V or Menu: Cheese - Video to
+      When not in video mode, click the button labelled
+      <guibutton>Video</guibutton>, press
+      <keycombo><keycap>Alt</keycap><keycap>V</keycap></keycombo> or Menu:
+      <menuchoice><guimenu>Cheese</guimenu><guimenuitem>Video</guimenuitem></menuchoice> to
       change to video mode. Video mode will start recording a video every time the
-      button labelled âStart Recordingâ or the Spacebar is pressed. The video will stop
-      recording and save to disk when the button labelled âStop Recordingâ
-      or the Spacebar is pressed.
+      the button labelled <guibutton>Start Recording</guibutton> or the
+      <keycap>Spacebar</keycap> is pressed. The video will stop
+      recording and save to disk when the button labelled <guibutton>Stop
+      Recording</guibutton> or the <keycap>Spacebar</keycap> is pressed.
     </para>
 
     <para>
       The video mode does look any different to the screen shot of photo mode,
-      except that the button labelled âTake a photoâ will be either âStart Recordingâ
-      or âStop Recordingâ,
-      and the button labelled âVideoâ is greyed out, whereas the button
-      labelled âPhotoâ is not.
+      except that the button labelled <guibutton>Take a photo</guibutton> will
+      be either <guibutton>Start Recording</guibutton>
+      or <guibutton>Stop Recording</guibutton>,
+      and the button labelled <guibutton>Video</guibutton> is greyed out, whereas the button
+      labelled <guibutton>Photo</guibutton> is not.
     </para>
   </section>
 </section>
@@ -256,13 +267,15 @@
 
     <para>
       To take a photo, apply the effects that you wish by clicking the button
-      labelled âEffectsâ, click on the effects desired as described in a previous section
-      and press the button labelled âBackâ. You should now have the effects that
+      labelled <guibutton>Effects</guibutton>, click on the effects desired as
+      described in a previous section and press the button labelled
+      <guibutton>Back</guibutton>. You should now have the effects that
       you clicked on applied to the webcam input.
     </para>
 
     <para>
-      To take the photo, press the button labelled âTake a photoâ or press the spacebar. You will then
+      To take the photo, press the button labelled <guibutton>Take a photo</guibutton>
+      or press the <keycap>spacebar</keycap>. You will then
       see &application; count down from 3 or instantly take the photo, depending on your settings. When the photo is taken, your entire screen
       will flash white, and the photo that was just taken will appear in the photo
       stream at the bottom of the program window.
@@ -272,11 +285,13 @@
   <section id="recordingavideo">
     <title>Taking a video</title>
     <para>
-      To take a video in &app;, make sure that the âVideoâ button has been pressed
+      To take a video in &app;, make sure that the <guibutton>Video</guibutton>
+      button has been pressed
     </para>
 
     <para>
-      To start recording a video, press the button labelled âStart Recordingâ or press the spacebar.
+      To start recording a video, press the button labelled <guibutton>Start
+      Recording</guibutton> or press the <keycap>spacebar</keycap>.
       The time of how much video has been recorded will appear in the bottom right
       hand corner.
     </para>
@@ -297,7 +312,7 @@
     <title>Viewing a photo or video</title>
     <para>
       To view a video or photo that has been taken, locate it in the photo stream and
-      double click on it. Alternatively, you can right click on it and select âOpenâ.
+      double click on it. Alternatively, you can right click on it and select <guimenuitem>Open</guimenuitem>.
       This will then open the file in the default application for that file type.
     </para>
   </section>
@@ -307,8 +322,8 @@
     <para>
       To save a photo to an alternate place on your hard drive where you can easily
       find them, find the photo or video that you wish to save in the photo stream, right
-      click on it and select âSave Asâ from the pop-up menu. This will bring up a
-      standard âSave Fileâ dialog that will allow you to rename the photo if desired
+      click on it and select <guimenuitem>Save As</guimenuitem> from the pop-up menu. This will bring up a
+      standard <guilabel>Save File</guilabel> dialog that will allow you to rename the photo if desired
       and save to any location you wish.
     </para>
   </section>
@@ -317,13 +332,13 @@
     <title>Deleting a photo</title>
     <para>
       To delete a photo from the photo stream, locate the photo you wish to delete in
-      the photo stream, left click on it once and press the delete button on your
-      keyboard. Alternatively, you can right click on it and click âDeleteâ.
+      the photo stream, left click on it once and press the <keycap>delete</keycap> button on your
+      keyboard. Alternatively, you can right click on it and click <guimenuitem>Delete</guimenuitem>.
     </para>
 
     <para>
       You will be prompted if you wish to delete it from the photo stream. To confirm,
-      press the button labelled âMove to Trashâ.
+      press the button labelled <guibutton>Move to Trash</guibutton>.
     </para>
 
     <note>
@@ -341,7 +356,7 @@
       Photos can be directly emailed from &app;. You will need to have the default mail
       client set up with an email account, otherwise you will need to set one up. To email
       a photo, locate the photo you wish to email in the photo stream, right click on
-      it and select âSend by Mailâ.
+      it and select <guimenuitem>Send by Mail</guimenuitem>.
     </para>
 
     <para>
@@ -353,10 +368,11 @@
   <section id="account-photo">
     <title>Set as Account Photo</title>
     <para>
-      To set a photo as your account photo (which can be viewed from System -> Preferences
-      -> About Me, and which will also appear if the login window displays a list of
+      To set a photo as your account photo (which can be viewed from
+      <menuchoice><guimenu>System</guimenu><guimenuitem>Preferences</guimenuitem>
+      <guimenuitem>About Me</guimenuitem></menuchoice>, and which will also appear if the login window displays a list of
       user names with photos), locate the photo that you wish to set in &app;, right click
-      on it and select âSet as Account Photoâ
+      on it and select <guimenuitem>Set as Account Photo</guimenuitem>
     </para>
   </section>
 
@@ -364,7 +380,7 @@
     <title>Export a photo to F-Spot</title>
     <para>
       To export a photo to F-Sport, locate the photo that you wish to export in your photo
-      stream, right click on it and select âExport to F-Spotâ. You will then be prompted from
+      stream, right click on it and select <guimenuitem>Export to F-Spot</guimenuitem>. You will then be prompted from
       F-Spot if you wish to import the photos that are sent to it.
     </para>
 
@@ -394,13 +410,14 @@
   <section id="faq-sluggish">
     <title>The video is sluggish/has a slow response. What can I do?</title>
     <para>
-      You may have set "ximagesink" ("X Window System (No Xv)") as video-output.
-      This means, that your cpu is doing all the work. Change it to "xvimagesink"
-      ("X Window System (X11/XShm/Xv)") in order to let your graphics card do the work.
+      You may have set "<literal>ximagesink</literal>" (<guilabel>X Window System (No Xv)</guilabel>) as video-output.
+      This means, that your cpu is doing all the work. Change it to "<literal>xvimagesink</literal>"
+      (<guilabel>X Window System (X11/XShm/Xv)</guilabel>) in order to let your graphics card do the work.
     </para>
 
     <para>
-      To change the settings, run "gstreamer-properties", click the Video tab
+      To change the settings, run <command>gstreamer-properties</command>,
+      click the <guilabel>Video</guilabel> tab
       and change the appropriate settings.
     </para>
   </section>
@@ -409,12 +426,13 @@
     <title>I have a Mac with iSight and a ATI graphics card, and the colors are weird.</title>
     <para>
       This is a problem with the ATI graphics card, though there is a work around.
-      Change the video-output to custom and insert the following: "ffmpegcolorspace !
-      video/x-raw-yuv,format=(fourcc)YV12 ! ffmpegcolorspace ! xvimagesink".
+      Change the video-output to custom and insert the following: "<literal>ffmpegcolorspace !
+      video/x-raw-yuv,format=(fourcc)YV12 ! ffmpegcolorspace ! xvimagesink</literal>".
     </para>
 
     <para>
-      To change the settings, run "gstreamer-properties", click the Video tab
+      To change the settings, run <command>gstreamer-properties</command>,
+      click the <guilabel>Video</guilabel> tab
       and select custom from the drop down menu.
     </para>
   </section>
@@ -422,8 +440,9 @@
   <section id="faq-work-gstreamer">
     <title>My webcam works with gstreamer, but does not work with &application;. What's wrong?</title>
     <para>
-      Using "gstreamer-properties" mentioned in the above question, try changing from
-      xvimagesink to ximagesink or vice-versa. If this still does not work run "cheese --verbose" on
+      Using <command>gstreamer-properties</command> mentioned in the above question, try changing from
+      <guilabel>xvimagesink</guilabel> to <guilabel>ximagesink</guilabel> or vice-versa.
+      If this still does not work run <command>cheese --verbose</command> on
       the command line and copy the logging into a bug report in our 
       <ulink url="http://bugzilla.gnome.org/browse.cgi?product=cheese"; type="http">
       bug tracker</ulink>.
@@ -433,7 +452,8 @@
   <section id="faq-work-other">
     <title>My webcam works with other programs such as Ekiga, Camorama, but not with &application;. What's wrong?</title>
     <para>
-      See if your webcam works when testing it in "gstreamer-properties". If it works
+      See if your webcam works when testing it in
+      <command>gstreamer-properties</command>. If it works
       there, but not in &application;, please file a bug report in our 
       <ulink url="http://bugzilla.gnome.org/browse.cgi?product=cheese"; type="http">
       bug tracker</ulink>.
@@ -444,8 +464,8 @@
     <title>Where does &application; store my photos?</title>
     <para>
       Your photos are stored in ~/.gnome2/cheese/media. You can also save
-      them to an alternate location from within &app;. Please see the help
-      topic titled "Saving photos and videos to an alternate location" for
+      them to an alternate location from within &app;. Please see
+      <xref linkend="saving"/> for
       information on this.
     </para>
   </section>
@@ -458,7 +478,7 @@
     </para>
 
     <para>
-      Try running "qcset /dev/video0 compat=dblbuf" to enable double buffer
+      Try running <command>qcset /dev/video0 compat=dblbuf</command> to enable double buffer
       compatibility mode, then restart &application;
     </para>
   </section>
@@ -466,7 +486,7 @@
   <section id="faq-no-camera-found">
     <title>"No Camera Found" Error Message</title>
     <para>
-      "When I launch &app;, I get the message "No Camera Found" but I have my webcam plugged into my computer".
+      "When I launch &app;, I get the message 'No Camera Found' but I have my webcam plugged into my computer".
 
       There are many situations this can happen in, and the exact problem that is causing this needs to be isolated.
       If possible, try each of the following to try and get your webcam working.



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