brasero r785 - in trunk: . help help/C help/C/figures src



Author: lmedinas
Date: Thu May  1 14:11:35 2008
New Revision: 785
URL: http://svn.gnome.org/viewvc/brasero?rev=785&view=rev

Log:
2008-05-01  Luis Medinas  <lmedinas svn gnome org>

        * configure.in:
        * help/C/Makefile.am:
        * help/C/brasero.xml:
        * help/C/legal.xml:
        * help/Makefile.am:
        * help/brasero.omf.in:
        * src/brasero-menu.h:
        * src/main.c (on_help_cb):

        Added help docs to the tree imported from ubuntu-doc team bzr tree.
        Thanks to Milo Casagrande and Phil Bull for the docs you rock!



Added:
   trunk/help/
   trunk/help/C/
   trunk/help/C/Makefile.am
   trunk/help/C/brasero.xml
   trunk/help/C/figures/
   trunk/help/C/figures/brasero_main.png   (contents, props changed)
   trunk/help/C/legal.xml
   trunk/help/Makefile.am
   trunk/help/brasero.omf.in
Modified:
   trunk/ChangeLog
   trunk/configure.in
   trunk/src/brasero-menu.h
   trunk/src/main.c

Modified: trunk/configure.in
==============================================================================
--- trunk/configure.in	(original)
+++ trunk/configure.in	Thu May  1 14:11:35 2008
@@ -37,6 +37,26 @@
 AC_PROG_CC
 AM_PROG_CC_STDC
 AC_HEADER_STDC
+dnl Set PACKAGE_DATA_DIR in config.h.
+if test "x${datadir}" = 'x${prefix}/share'; then
+  if test "x${prefix}" = "xNONE"; then
+    AC_DEFINE_UNQUOTED([PACKAGE_DATA_DIR], "${ac_default_prefix}/share/${PACKAGE}", [Define the PACKAGE_DATA_DIR.])
+  else
+    AC_DEFINE_UNQUOTED([PACKAGE_DATA_DIR], "${prefix}/share/${PACKAGE}", [Define the PACKAGE_DATA_DIR.])
+  fi
+  elif test "x${datadir}" = 'x${datarootdir}'; then
+  if test "x${datarootdir}" = 'x${prefix}/share'; then
+  	if test "x${prefix}" = "xNONE"; then
+ 	AC_DEFINE_UNQUOTED([PACKAGE_DATA_DIR], "${ac_default_prefix}/share/${PACKAGE}", [Define the PACKAGE_DATA_DIR.])
+ 	else
+ 	AC_DEFINE_UNQUOTED([PACKAGE_DATA_DIR], "${prefix}/share/${PACKAGE}", [Define the PACKAGE_DATA_DIR.])
+ 	fi
+  else
+ 	AC_DEFINE_UNQUOTED([PACKAGE_DATA_DIR], "${datarootdir}/${PACKAGE}", [Define the PACKAGE_DATA_DIR.])
+ 	fi
+  else
+	AC_DEFINE_UNQUOTED([PACKAGE_DATA_DIR], "${datadir}/${PACKAGE}", [Define the PACKAGE_DATA_DIR.])
+fi
 
 dnl ***************** SCSI related *****************************
 AC_SUBST(BRASERO_SCSI_LIBS)
@@ -75,6 +95,7 @@
 GSTREAMER_BASE_REQUIRED=0.10.0
 LIBXML2_REQUIRED=2.6.0
 HAL_REQUIRED=0.5
+GNOME_DOC_INIT
 
 dnl ** used by brasero and one plugin
 PKG_CHECK_MODULES(BRASERO_GSTREAMER, 		\
@@ -324,6 +345,7 @@
 data/Makefile
 data/brasero.desktop.in
 data/icons/Makefile
+help/Makefile
 src/plugins/Makefile
 src/plugins/cdrdao/Makefile
 src/plugins/cdrkit/Makefile

Added: trunk/help/C/Makefile.am
==============================================================================
--- (empty file)
+++ trunk/help/C/Makefile.am	Thu May  1 14:11:35 2008
@@ -0,0 +1,36 @@
+## arch-tag: Automake rules for English help files
+
+figdir = figures
+docname = brasero
+lang = C
+omffile = brasero-C.omf
+entities = legal.xml
+
+authors.xml: $(top_srcdir)/AUTHORS $(top_srcdir)/MAINTAINERS $(top_srcdir)/DOCUMENTERS
+	(echo '<?xml version="1.0" encoding="UTF-8"?>'; \
+	 echo '<sect2 id="authors">'; \
+	 echo '<title>Authors</title>'; \
+	 echo '<sect3>'; \
+         echo '<title>Lead Developers:</title>'; \
+	 echo '<para><simplelist>') > $  tmp
+	sed -e 's/>/<\/email><\/member>/' -e 's/ </ <email>/' -e 's/^/<member>/'  < $(top_srcdir)/MAINTAINERS >> $  tmp
+	(echo '</simplelist></para></sect3><sect3>'; \
+	 echo '<title>Contributors</title>'; \
+	 echo '<para><simplelist>') >> $  tmp
+	sed -e 's/>/<\/email><\/member>/' -e 's/ </ <email>/' -e 's/^/<member>/'  < $(top_srcdir)/AUTHORS >> $  tmp
+	(echo '</simplelist></para></sect3>'; \
+	 echo '<sect3><title>Documentation</title>'; \
+	 echo '<para><simplelist>') >> $  tmp
+	sed -e 's/>/<\/email><\/member>/' -e 's/ </ <email>/' -e 's/^/<member>/'  < $(top_srcdir)/DOCUMENTERS >> $  tmp
+	(echo '</simplelist></para></sect3>'; \
+	 echo '</sect2>') >> $  tmp
+	mv $  tmp $@
+
+all-am: authors.xml
+
+include $(top_srcdir)/xmldocs.make
+
+CLEANFILES += authors.xml
+
+dist-hook: app-dist-hook
+

Added: trunk/help/C/brasero.xml
==============================================================================
--- (empty file)
+++ trunk/help/C/brasero.xml	Thu May  1 14:11:35 2008
@@ -0,0 +1,1164 @@
+<?xml version="1.0"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
+"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"; [
+  <!ENTITY legal SYSTEM "legal.xml">
+  <!ENTITY appversion "0.7.0">
+  <!ENTITY manrevision "2.0">
+  <!ENTITY date "February 2008">
+  <!ENTITY app "<application>Brasero</application>">
+  <!ENTITY appname "Brasero">
+]>
+
+<!-- 
+      (Do not remove this comment block.)
+  Maintained by the GNOME Documentation Project
+  http://developer.gnome.org/projects/gdp
+  Template version: 2.0 beta
+  Template last modified Apr 11, 2002
+-->
+
+<article id="index" lang="en">
+<!-- please do not change the id; for translations, change lang to -->
+<!-- appropriate code -->
+  <articleinfo> 
+    <title>&app; Manual V&manrevision;</title>       
+	<abstract role="description">
+	      <para>&appname; is an application for burning CDs and DVDs.</para>
+	    </abstract>
+
+    <copyright> 
+      <year>2008</year> 
+      <holder>Ubuntu Documentation Project</holder> 
+    </copyright> 
+<!-- translators: uncomment this:
+
+  <copyright>
+   <year>2008</year>
+   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
+  </copyright>
+
+   -->
+<!-- An address can be added to the publisher information.  If a role is 
+     not specified, the publisher/author is the same for all versions of the 
+     document.  -->
+    <publisher> 
+      <publishername>Ubuntu Documentation Project</publishername> 
+    </publisher> 
+
+   &legal;
+   <!-- This file  contains link to license for the documentation, and 
+        other legal stuff such as "NO WARRANTY" statement. Please do not change 
+	any of this. -->
+
+    <authorgroup> 
+      <author role="maintainer"> 
+		<firstname>Milo</firstname> 
+		<surname>Casagrande</surname> 
+		<affiliation> 
+	  		<orgname>Ubuntu Documentation Project</orgname> 
+	  		<address> <email>milo_casagrande yahoo it</email> </address> 
+		</affiliation> 
+      </author> 
+      <author> 
+		<firstname>Andrew</firstname> 
+		<surname>Stabeno</surname> 
+		<affiliation> 
+	  		<orgname>Ubuntu Documentation Project</orgname> 
+	  		<address> <email>stabeno gmail com</email> </address> 
+		</affiliation> 
+      </author> 
+      <author> 
+		<firstname>Phil</firstname> 
+		<surname>Bull</surname> 
+		<affiliation> 
+	  		<orgname>Ubuntu Documentation Project</orgname> 
+	  		<address> <email>philbull gmail com</email> </address> 
+		</affiliation> 
+      </author> 
+      
+<!-- This is appropriate place for other contributors: translators,
+     maintainers,  etc. Commented out by default.
+     
+      <othercredit role="translator">
+		<firstname>Latin</firstname> 
+		<surname>Translator 1</surname> 
+		<affiliation> 
+	  		<orgname>Latin Translation Team</orgname> 
+	  		<address> <email>translator gnome org</email> </address> 
+		</affiliation>
+		<contrib>Latin translation</contrib>
+      </othercredit>
+-->
+    </authorgroup>
+
+    <revhistory>
+      <revision> 
+		<revnumber>Brasero Manual V&manrevision;</revnumber> 
+		<date>&date;</date> 
+		<revdescription> 
+	  		<para role="author">Milo Casagrande
+	    	<email>milo_casagrande yahoo it</email>
+	  		</para>
+	  		<para role="author">Andrew Stabeno
+	    	<email>stabeno gmail com</email>
+	  		</para>
+	  		<para role="author">Phil Bull
+	    	<email>philbull gmail com</email>
+	  		</para>
+	  		<para role="publisher">Ubuntu Documentation Project</para>
+		</revdescription> 
+      </revision> 
+    </revhistory> 
+
+    <releaseinfo>This manual describes version &appversion; of Brasero.
+    </releaseinfo> 
+    <legalnotice> 
+      <title>Feedback</title> 
+      <para>To report a bug or make a suggestion regarding the &app; application or
+      this manual, follow the directions in the <ulink url="ghelp:gnome-feedback"
+	  type="help">GNOME Feedback Page</ulink>. 
+      </para>
+<!-- Translators may also add here feedback address for translations -->
+    </legalnotice> 
+  </articleinfo> 
+
+  <indexterm zone="index"> 
+    <primary>Brasero</primary> 
+  </indexterm> 
+  <indexterm zone="index"> 
+    <primary>brasero</primary> 
+    <secondary>burn</secondary>
+    <tertiary>burning CD DVD</tertiary>
+  </indexterm>
+
+<!-- ============= Document Body ============================= -->
+
+<!-- ============= Introduction ============================== -->
+  <sect1 id="brasero-introduction" status="review"> 
+    <title>Introduction</title>
+    <para>&app; is an application made for burning CD-R/Ws and DVD-R/Ws.  
+    It is designed to be easy to use, while providing all the tools necessary for burning.
+    </para>
+    <para>The following are the main features of Brasero:</para>
+    <itemizedlist>
+	   <listitem><para>Burns data to CD-R/Ws and DVD-R/Ws</para></listitem>
+	   <listitem><para>Burns audio CDs from digital audio files (such as ogg, flac and mp3)</para></listitem>
+	   <listitem><para>Copies CDs and DVDs</para></listitem>
+	   <listitem><para>Creates image files and burns from existing image files</para></listitem>
+	   <listitem><para>Erases CD-R/Ws and DVD-R/Ws</para></listitem>
+	   <listitem><para>Checks the integrity of disks and disk images</para></listitem>
+    </itemizedlist>
+  </sect1>
+  
+ <!-- ============= Getting Started ========================= -->
+  <sect1 id="brasero-gettingstarted" status="review"> 
+    <title>Getting Started</title>
+    <para>You can start &app; in the following ways:</para>
+    <variablelist>
+      <varlistentry>
+	<term><guimenu>Applications</guimenu> menu</term>
+	<listitem>
+	  <para>
+	    Choose <menuchoice><guisubmenu>Sound &amp; Video</guisubmenu>
+	    <guimenuitem>Brasero Disc Burning</guimenuitem></menuchoice>.
+	  </para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+	<term>Command line</term>
+	<listitem>
+	  <para>
+	    Type <command>brasero</command> and then press <keycap>Return</keycap>.
+	  </para>
+	</listitem>
+      </varlistentry>
+    </variablelist>
+    <note><para>If &app; is set as your default disc burning application, 
+    it will automatically start when you insert a blank CD-R/W or DVD-R/W in your drive.</para></note>
+    <para>When &app; is started you will see the following window:</para>
+    
+    <!-- ==== Figure ==== -->
+    <figure id="brasero-main"> 
+      <title>Brasero Main Window</title> 
+      <screenshot> 
+	<mediaobject> 
+	  <imageobject>
+	    <imagedata fileref="figures/brasero_main.png" format="PNG"/> 
+	  </imageobject>
+	  <textobject> 
+	    <phrase>The Brasero main window. Shows the menu bar and the four types of project 
+	      to choose from.
+	    </phrase> 
+	  </textobject> 
+	</mediaobject> 
+      </screenshot> 
+    </figure>
+    <!-- ==== End of Figure ==== -->
+
+    <para>This window is the starting point for all of your projects.  You can click on the project
+    type you wish to start from here.  If you have created other projects with 
+    &app;, you will be able to select them from the section 
+    titled <guilabel>Choose a recently opened project</guilabel> (see
+    <xref linkend="brasero-open-recent-project" /> for more information).</para>
+  </sect1>
+  <!-- ============= New Project ========================= -->
+  <sect1 id="brasero-new-project" status="review">
+    <title>Creating a New Project</title>
+    <para>The following section explains the four types of project that you can create with 
+    &app;.</para>
+    
+    <!-- ==== subsection: Audio project ===== -->
+    <sect2 id="brasero-new-project-audio">
+      <title>Audio Project</title>
+      <para>This section explains how to create an audio CD.  This project takes selected
+	audio files, converts them to a raw audio format and burns them to a CD which standard CD
+	players can play.
+      </para>
+      <para>
+	To burn an audio CD:
+	<orderedlist>
+	  <listitem>
+	    <para>Insert a blank CD-R into your drive.</para>
+	  </listitem>
+	  <listitem>
+	    <para>Click <guibutton>Audio project</guibutton> in the main window or click 
+	    <menuchoice>
+	    	<guimenuitem>Project</guimenuitem>
+	    	<guimenuitem>New Project</guimenuitem>
+	    	<guimenuitem>New Audio Project</guimenuitem>
+	    </menuchoice>.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>In the pane to the left of the window, select <guilabel>Browse the file system
+	    </guilabel> from the drop-down list at the top and browse to the music files you want to 
+	      add to you project.</para>
+	    <para>You can also select the <guilabel>Search files using keywords</guilabel> 
+	     option to search for music files, or the <guilabel>Display playlists and their contents
+	     </guilabel> option to select music from playlists on your computer.</para>
+	  </listitem>
+	  <listitem>
+	    <para>Select the files you want by double-clicking on them, or by selecting them and 
+	      clicking the <guibutton>Add</guibutton> button at the top left of the toolbar.</para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      When all of the files have been added, click on 
+	      <guibutton>Burn</guibutton>. 
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      The <guilabel>Disc burning setup</guilabel> dialog will be
+	      shown; make any desired modifications (see <xref
+		linkend="brasero-audio-project-options"/>).
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Click <guibutton>Burn</guibutton> to start the burning process.
+	    </para>
+	  </listitem>
+	</orderedlist>
+      </para>
+      <para>
+	<note>
+	  <para>When adding files, refer to the status bar at the bottom of the window to 
+	  see how much space you are using on your CD.  You may have to adjust the 
+	  size of your CD to let &app; know what its actual capacity is.  To do this, click 
+	  on the button next to the status bar and select the size of your CD as quoted 
+	  on the disc or its packaging.</para>
+	</note>
+	<tip>
+	  <para>To save the project for later use, click on <menuchoice><guimenu>Project</guimenu>
+	      <guimenuitem>Save</guimenuitem></menuchoice></para>
+	</tip>
+      </para>
+      
+      <sect3 id="brasero-audio-project-options">
+	<title>Audio Project Options</title>
+	<para>
+	  Before starting the burning process, it is possible to
+	  modify some of the burning options.
+	</para>
+
+	<para>
+	  <variablelist>
+	    <varlistentry>
+	      <term>Section <guilabel>Select a drive to write
+	      to</guilabel>:</term>
+	      <listitem>
+		<itemizedlist>
+		  <listitem>
+		    <para>
+		      Click <guibutton>Properties</guibutton> to open
+		      the properties dialog for the burning device. See <xref
+			linkend="brasero-burning-device-properties"/> for more information.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      From the <guilabel>Number of copies</guilabel>
+		      spin box, select the number of copies of the disc you want to
+		      burn.
+		    </para>
+		  </listitem>
+		</itemizedlist>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>Section <guilabel>Title</guilabel>:</term>
+	      <listitem>
+		<itemizedlist>
+		  <listitem>
+		    <para>
+		      In the text box, enter the title you want to
+		      give to the disc. This title will be shown as the name
+		      of the disc.
+		    </para>
+		  </listitem>
+		</itemizedlist>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>Section <guilabel>Disc options</guilabel>:</term>
+	      <listitem>
+		<itemizedlist>
+		  <listitem>
+		    <variablelist>
+		      <varlistentry>
+			<term><guilabel>Leave the disc open to add
+			a data session later</guilabel></term>
+			<listitem>
+			  <para>
+			    Select this option to create a
+			    <emphasis>multisession</emphasis> disc, so
+			    that it will be possible to add files to the disc at a later 
+			    date (without erasing it, if it is rewritable).
+			  </para>
+			</listitem>
+		      </varlistentry>
+		    </variablelist>
+		  </listitem>
+		</itemizedlist>
+	      </listitem>
+	    </varlistentry>
+            <varlistentry>
+	      <term>Section <guilabel>Track Options</guilabel>:</term>
+	      <listitem>
+		<itemizedlist>
+		 <listitem>
+		   <para>
+			<guilabel>Pause</guilabel>: After you have inserted your audio tracks.  
+			    Highlight a track and click on the <guibutton>Pause</guibutton> button.  
+			    This will add a 2 second pause after that track.
+		   </para>
+		 </listitem>
+		 <listitem>
+		  <para><guilabel>Split</guilabel>: Select a track and click on the 
+			  <guibutton>Split</guibutton> button.  A window will pop up to 
+			  let you choose where you want to split the track.  In the 
+			  <guilabel>Method</guilabel> drop down list are 4 options:</para>
+			  <itemizedlist>
+			    <listitem>
+			      <para><guilabel>Split track manually</guilabel>: This allows you to select
+			      the time on the track where you wish to split it.  A sliding
+			      bar is provided along with an audio preview, so you can pinpoint where you 
+			      would like to split the track.</para>
+			    </listitem>
+			    <listitem>
+			      <para><guilabel>Split track in parts with a fixed length</guilabel>: This
+			      allows you to split the track into fixed-length parts which have a duration that 
+			      you specify.</para>
+                            </listitem>
+			    <listitem>
+			      <para><guilabel>Split track in fixed number of parts</guilabel>: This 
+			      allows you to select the number of parts that you want your track to be broken 
+			      up into.</para>
+                            </listitem>
+			    <listitem>
+			      <para><guilabel>Split track for each silence</guilabel>: This will search
+			      the track for silences and split the track where it finds them.</para>
+                            </listitem>
+		       </itemizedlist>
+			<para>Once you have split the tracks you can remove or merge the splits using the
+			buttons on the right.  Click <guibutton>OK</guibutton> when finished.</para>
+		  </listitem>
+		</itemizedlist>
+	      </listitem>
+	    </varlistentry>
+	  </variablelist>
+	</para>
+      </sect3>
+    </sect2>
+    <!-- ===== subsection: Data project ====== -->
+    <sect2 id="brasero-new-project-data">
+      <title>Data Project</title>
+      <para>
+	To burn a data CD:
+	<orderedlist>
+	  <listitem>
+	    <para>Insert a blank CD-R/W or DVD-R/W into your drive.</para>
+	  </listitem>
+	  <listitem>
+	    <para>Click <guibutton>Data project</guibutton> in the main window or click 
+	    <menuchoice>
+	    	<guimenuitem>Project</guimenuitem>
+	    	<guimenuitem>New Project</guimenuitem>
+	    	<guimenuitem>New Data Project</guimenuitem>
+	    </menuchoice>.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>Use the pane to the left of the window to find the files you want to 
+	      add to the project. Select <guilabel>Browse the file system</guilabel> from 
+	      the drop-down list at the top to browse for files, or select <guilabel>Search 
+	      files using keywords</guilabel> to search for them.</para>
+	  </listitem>
+	  <listitem>
+	    <para>Select the files you want by double-clicking on them, or highlighting them 
+	      and clicking the <guibutton>Add</guibutton> button at the top left of the toolbar.</para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      When all the files have been added, click
+	      <guibutton>Burn</guibutton>. 
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      The <guilabel>Disc burning setup</guilabel> dialog will be
+	      shown; make any desired modifications (see <xref
+		linkend="brasero-data-project-options"/>).
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Click <guibutton>Burn</guibutton> to start the burning process.
+	    </para>
+	  </listitem>
+	</orderedlist>
+      </para>
+
+      <sect3 id="brasero-data-project-options">
+	<title>Data Project Options</title>
+	<para>
+	  Before starting the burning process, it is possible to
+	  modify some of the burning options.
+	</para>
+	<para>
+	  <variablelist>
+	    <varlistentry>
+	      <term>Section <guilabel>Select a drive to write
+	      to</guilabel>:</term>
+	      <listitem>
+		<itemizedlist>
+		  <listitem>
+		    <para>
+		      Click <guibutton>Properties</guibutton> to open
+		      the properties dialog for the burning device. See <xref
+			linkend="brasero-burning-device-properties"/> for more information.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      From the <guilabel>Number of copies</guilabel>
+		      spin box select the number of copies of the disc you want to
+		      burn.
+		    </para>
+		  </listitem>
+		</itemizedlist>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>Section <guilabel>Label of the
+	      disc</guilabel>:</term>
+	      <listitem>
+		<itemizedlist>
+		  <listitem>
+		    <para>
+		      In the text box, enter a label to identify the
+		      disc. This label will be shown as the name
+		      of the disc.
+		    </para>
+		  </listitem>
+		</itemizedlist>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>Section <guilabel>Disc options</guilabel>:</term>
+	      <listitem>
+		<itemizedlist>
+		  <listitem>
+		    <variablelist>
+		      <varlistentry>
+			<term><guilabel>Increase compatibility with
+			Windows systems</guilabel></term>
+			<listitem>
+			  <para>
+			    Select this option if you intend the disc to be used on 
+			    computers running Windows. Files on the disc will be 
+			    checked to ensure that their filenames do not contain 
+			    characters which are invalid on Windows.
+			  </para>
+			</listitem>
+		      </varlistentry>
+		    </variablelist>
+		  </listitem>
+		  <listitem>
+		    <variablelist>
+		      <varlistentry>
+			<term><guilabel>Leave the disc open to add
+			other files later</guilabel></term>
+			<listitem>
+			  <para>
+			    Select this option to create a <emphasis>multisession
+			    </emphasis> disc, so that it will be possible to add files 
+			    to the disc at a later date (without erasing it, if it is rewritable).
+			  </para>
+			</listitem>
+		      </varlistentry>
+		    </variablelist>
+		  </listitem>
+		</itemizedlist>
+	      </listitem>
+	    </varlistentry>
+	  </variablelist>
+	</para>
+      </sect3>
+
+    </sect2>
+    <!-- ====== subsection: Copy Disc ======= -->
+    <sect2 id="brasero-new-project-copy">
+      <title>Disc Copy</title>
+      <para>
+	This project lets you take an existing disc and copy it to a
+	blank disc or image file. To copy a disc:
+	<orderedlist>
+	  <listitem>
+	    <para>Insert the CD or DVD you wish to copy into your drive.</para>
+	  </listitem>
+	  <listitem>
+	    <para>Click <guibutton>Disc copy</guibutton> in the main window or click 
+	    <menuchoice>
+	    	<guimenuitem>Project</guimenuitem>
+	    	<guimenuitem>New Project</guimenuitem>
+	    	<guimenuitem>Copy Disc</guimenuitem>
+	    </menuchoice>.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      The <guilabel>CD/DVD copy options</guilabel> dialog will
+	      be shown; make the desired modifications (see <xref
+		linkend="brasero-disc-copy-options"/> for more information).
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Click <guibutton>Copy</guibutton> to start the copying
+	      process.
+	    </para>
+	  </listitem>
+	</orderedlist>
+      </para>
+
+      <sect3 id="brasero-disc-copy-options">
+	<title>Disc Copy Options</title>
+	<para>
+	  Before starting the copying process, it is possible to
+	  modify some of the copying and burning options.
+	</para>
+	<para>
+	  <variablelist>
+	    <varlistentry>
+	      <term>Section <guilabel>Select source drive to
+	      copy</guilabel>:</term>
+	      <listitem>
+		<itemizedlist>
+		  <listitem>
+		    <para>
+		      From the drop-down list, select the drive that
+		      holds the disc you want to copy. Information about 
+		      the disc in that drive will be shown below.
+		    </para>
+		  </listitem>
+		</itemizedlist>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>Section <guilabel>Select a drive to write
+	      to</guilabel>:</term>
+	      <listitem>
+		<itemizedlist>
+		  <listitem>
+		    <para>
+		      From the drop-down menu, select the drive to
+		      write the disc copy to.
+		    </para>
+		    <para>
+		      From this drop-down menu, select <guilabel>File
+		      image</guilabel> to create
+		      a disc image, such as an ISO image.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      Click <guibutton>Properties</guibutton> to open
+		      the properties dialog for the burning device. See <xref
+			linkend="brasero-burning-device-properties"/> for more information.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      From the <guilabel>Number of copies</guilabel>
+		      spin box, select the number of copies of the disc you want to
+		      burn.
+		    </para>
+		  </listitem>
+		</itemizedlist>
+	      </listitem>
+	    </varlistentry>
+	  </variablelist>
+	</para>
+	<para>
+	  <note>
+	    <para>If you have more that one drive on you system, you can use one drive as 
+	      the source drive and the other as the destination drive.  If you do not, you will be 
+	      prompted to remove the CD or DVD you are copying and insert your blank media.</para>
+	  </note>
+	</para>
+      </sect3>
+    </sect2>
+
+    <!-- ==== subsection: Burn Image ===== -->
+    <sect2 id="brasero-new-project-image">
+      <title>Burn Image</title>
+      <para>
+	This project takes an existing file image and burns it to a
+	CD-R/W or DVD-R/W. &app; supports the following types 
+	of image file:
+	<itemizedlist>
+	  <listitem>
+	    <para>
+	      <filename>.iso</filename>
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      <filename>.raw</filename>
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      <filename>.cue</filename>
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      <filename>.toc</filename>
+	    </para>
+	  </listitem>
+	</itemizedlist>
+      </para>
+
+      <para>
+	To start this project:
+	<orderedlist>
+	  <listitem>
+	    <para>
+	      Insert a blank CD-R/W or DVD-R/W into your drive.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Click <guibutton>Burn image</guibutton> in the main window or click 
+	    <menuchoice>
+	    	<guimenuitem>Project</guimenuitem>
+	    	<guimenuitem>New Project</guimenuitem>
+	    	<guimenuitem>Burn Image</guimenuitem>
+	    </menuchoice>.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      The <guilabel>Image burning setup</guilabel> dialog will
+	      be shown; make the desired modifications (see <xref
+	      linkend="brasero-burn-image-options"/>).
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Click <guibutton>Burn</guibutton> to start the burning
+	      process.
+	    </para>
+	  </listitem>
+	</orderedlist>
+      </para>
+
+      <sect3 id="brasero-burn-image-options">
+	<title>Burn Image Options</title>
+	<para>
+	  Before starting the image burning process, it is possible to
+	  modify some of the burning options.
+	</para>
+	<para>
+	  <variablelist>
+	    <varlistentry>
+	      <term>Section <guilabel>Select a drive to write
+	      to</guilabel>:</term>
+	      <listitem>
+		<itemizedlist>
+		  <listitem>
+		    <para>
+		      Click <guibutton>Properties</guibutton> to open
+		      the properties dialog for the burning device. See <xref
+			linkend="brasero-burning-device-properties"/> for more information.
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <para>
+		      From the <guilabel>Number of copies</guilabel>
+		      spin box select the number of copies of the disc you want to
+		      burn.
+		    </para>
+		  </listitem>
+		</itemizedlist>
+	      </listitem>
+	    </varlistentry>
+	    <varlistentry>
+	      <term>Section <guilabel>Image</guilabel>:</term>
+	      <listitem>
+		<itemizedlist>
+		  <listitem>
+		    <para>
+		      <variablelist>
+			<varlistentry>
+			  <term><guilabel>Path</guilabel></term>
+			  <listitem>
+			    <para>
+			      Click on the button next to
+			      <guilabel>Path</guilabel> to open
+			      the <guilabel>Open an image</guilabel>
+			      dialog and select the image file to
+			      burn.
+			    </para>
+			  </listitem>
+			</varlistentry>
+		      </variablelist>
+		    </para>
+		  </listitem>
+		  <listitem>
+		    <variablelist>
+		      <varlistentry>
+			<term><guilabel>Image type</guilabel></term>
+			<listitem>
+			  <para>
+			    From the drop-down menu, select the type
+			    of image to burn. If unsure, select 
+			    <guilabel>Let brasero choose (safest)</guilabel>.
+			  </para>
+			</listitem>
+		      </varlistentry>
+		    </variablelist>
+		  </listitem>
+		</itemizedlist>
+	      </listitem>
+	    </varlistentry>
+	  </variablelist>
+	</para>
+      </sect3>
+    </sect2>
+
+    <sect2 id="brasero-burning-device-properties">
+      <title>Burning Device Properties</title>
+      <para>
+	Before starting the burning process, it is possible to change
+	some of the properties for the burning device that will be used.
+      </para>
+      <para>
+	<variablelist>
+	  <varlistentry>
+	    <term>Section <guilabel>Burning speed</guilabel>:</term>
+	    <listitem>
+	      <para>
+		From the drop-down menu, select the burning speed. For
+		the best value, check the CD/DVD case.
+	      </para>
+	      <warning>
+		<para>
+		  Burning a disc with a higher speed than supported
+		  could create an unreadable disc. Use lower burning 
+		  speeds to reduce the chance of this happening.
+		</para>
+	      </warning>
+	    </listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term>Section <guilabel>Options</guilabel>:</term>
+	    <listitem>
+	      <itemizedlist>
+		<listitem>
+		  <variablelist>
+		    <varlistentry>
+		      <term><guilabel>Burn the image directly without saving
+		    it to disc</guilabel></term>
+		      <listitem>
+			<para>
+			  Select this option if you want to burn the
+			  image directly onto the media, without saving it
+			  to the hard disk and without creating an image file.
+			</para>
+		      </listitem>
+		    </varlistentry>
+		  </variablelist>
+		</listitem>
+		<listitem>
+		  <variablelist>
+		    <varlistentry>
+		      <term><guilabel>Use burnproof (decrease the risk
+		      of failure)</guilabel></term>
+		      <listitem>
+			<para>
+			  Select this option to prevent the buffer
+			  underrun effect (or buffer underflow). This is when
+			  the computer is not fast enough to deliver data to 
+			  the burning device at the selected burning speed.
+			</para>
+			<warning>
+			  <para>
+			    If a buffer underrun takes place, the
+			    burned disc could be unreadable.
+			  </para>
+			</warning>
+		      </listitem>
+		    </varlistentry>
+		  </variablelist>
+		</listitem>
+		<listitem>
+		  <variablelist>
+		    <varlistentry>
+		      <term><guilabel>Simulate the
+		      burning</guilabel></term>
+		      <listitem>
+			<para>
+			  Select this option the simulate the burning
+			  process; no real burn is performed. This is
+			  useful for testing, if you are having problems 
+			  burning discs.
+			</para>
+		      </listitem>
+		    </varlistentry>
+		  </variablelist>
+		</listitem>
+		<listitem>
+		  <variablelist>
+		    <varlistentry>
+		      <term><guilabel>Eject after
+		      burning</guilabel></term>
+		      <listitem>
+			<para>
+			  Select this option to eject the media in the
+			  burning device once the burning process 
+			  has completed.
+			</para>
+		      </listitem>
+		    </varlistentry>
+		  </variablelist>
+		</listitem>
+	      </itemizedlist>
+	    </listitem>
+	  </varlistentry>
+	  <varlistentry>
+	    <term>Section <guilabel>Temporary files</guilabel>:</term>
+	    <listitem>
+	      <para>
+		From the drop-down menu, select the directory to use
+		for storing the temporary files created for the burning
+		process.
+	      </para>
+	      <para>
+		The default directory is <filename
+		class="directory">/tmp</filename>.
+	      </para>
+	    </listitem>
+	  </varlistentry>
+	</variablelist>
+      </para>
+    </sect2>
+    
+  </sect1>
+
+  <sect1 id="brasero-open-recent-project">
+    <title>Opening a Saved Project</title>
+    <para>
+      If you have recently saved a project, you can open it again in one of the following ways: 
+      <itemizedlist>
+	<listitem>
+	  <para>
+	    Choose <menuchoice><guimenu>Project</guimenu>
+	      <guisubmenu>Recent Projects</guisubmenu>
+	    </menuchoice> and select the project you
+	    want to open.
+	  </para>
+	</listitem>
+	<listitem>
+	  <para>
+	    From the main window, click on the project you want to open
+	    under <guilabel>Choose a recently opened
+	    project</guilabel>.
+	  </para>
+	</listitem>
+      </itemizedlist>
+    </para>
+    <para>To open a project which does not appear in 
+    <guilabel>Recent Projects</guilabel>, click 
+    <menuchoice>
+    	<guimenuitem>Project</guimenuitem>
+    	<guimenuitem>Open</guimenuitem>
+    </menuchoice> and select the project file.
+    </para>
+    <para>
+      Once opened, you can add or remove files from the project, 
+      burn it to disc, and then save it again for later use.
+    </para>
+  </sect1>
+
+  <sect1 id="brasero-erase-media">
+    <title>Erasing a CD or DVD</title>
+    <para>
+      Erasing or blanking a CD or DVD means to delete all the data that the CD or
+      the DVD contains. &app; is able to erase the following CD and DVD
+      formats:
+      <itemizedlist>
+	<listitem>
+	  <para>
+	    CD-RW
+	  </para>
+	</listitem>
+	<listitem>
+	  <para>
+	    DVD-RW (single or dual layer)
+	  </para>
+	</listitem>
+	<listitem>
+	  <para>
+	    DVD+RW (single or dual layer)
+	  </para>
+	</listitem>
+      </itemizedlist>
+    </para>
+    <para>
+      In general, &app; can support all of the media formats supported by your own
+      CD/DVD recorder.
+    </para>
+    <warning>
+      <para>
+	Make sure that the media you want to erase is
+	erasable. Check the media case for more information.
+      </para>
+    </warning>
+    <para>
+      To erase a CD-RW or a DVD-RW:
+      <orderedlist>
+	<listitem>
+	  <para>
+	    Insert the erasable CD or DVD in your drive.
+	  </para>
+	</listitem>
+	<listitem>
+	  <para>
+	    From the menu bar, choose <menuchoice>
+	      <guimenu>Tools</guimenu>
+	      <guimenuitem>Erase...</guimenuitem>
+	    </menuchoice>. The <guilabel>Disc blanking</guilabel>
+	      dialog will be shown.
+	  </para>
+	</listitem>
+	<listitem>
+	  <para>
+	    From the drop-down list named <guilabel>Select a
+	    recorder</guilabel>, select the drive that holds the disc 
+	    you want to erase.
+	  </para>
+	</listitem>
+	<listitem>
+	  <para>
+	    If you want to quickly erase the disc, select the <guilabel>fast
+	      blanking</guilabel> option (for more information, see
+	      <xref linkend="brasero-fast-blanking"/>).
+	  </para>
+	</listitem>
+	<listitem>
+	  <para>
+	    Press the <guibutton>Blank</guibutton> button to start
+	    erasing the CD or DVD.
+	  </para>
+	</listitem>
+      </orderedlist>
+    </para>
+    <warning>
+      <para>
+	The blanking process will permanently destroy all of the data on the disc.
+      </para>
+    </warning>
+    
+    <sect2 id="brasero-fast-blanking">
+      <title>What is fast blanking?</title>
+      <para>
+	Fast blanking is a way of quickly erasing a disc. This method is much
+	faster than fully erasing the disc, and is sufficient to allow the disc to be 
+	written to again.
+      </para>
+      <para>
+	The full erasing procedure is slower but is more secure, as it
+	removes all traces of previous data. Data removed from fast
+	blanked media can still be recovered with special tools.
+      </para>
+    </sect2>
+  </sect1>
+
+  <sect1 id="brasero-checking-integrity">
+    <title>Checking the Integrity of a CD or DVD</title>
+    <para>
+      Checking the integrity of a CD or DVD makes sure that the
+      files written to the disc are intact and have not been corrupted
+      during the burning process. 
+    </para>
+    <para>
+      The integrity check is done using the <quote>MD5 digest</quote> 
+      algorithm, which creates a <quote>fingerprint</quote> of the 
+      data on the media. Each time you burn a CD or DVD, and the 
+      <emphasis role="strong">md5sum</emphasis> plugin is 
+      enabled (see <xref linkend="brasero-plugins" /> for more 
+      information), &app; adds a MD5 file to the disc in order
+      to perform integrity checks at a later date.
+    </para>
+    <para>
+      &app; performs an integrity check after each burning session,
+      checking the automatically generated file. Usually this process is
+      longer than using an external MD5 file.
+    </para>
+    <para>
+      To check the integrity of a disc:
+      <orderedlist>
+	<listitem>
+	  <para>
+	    Insert the CD or DVD to be checked into the drive.
+	  </para>
+	</listitem>
+	<listitem>
+	  <para>
+	    From the menu bar, choose <menuchoice>
+	      <guimenu>Tools</guimenu>
+	      <guimenuitem>Check integrity</guimenuitem>
+	    </menuchoice>, or press <keycombo>
+	      <keycap>Ctrl</keycap>
+	      <keycap>F</keycap>
+	    </keycombo>.
+	  </para>
+	</listitem>
+	<listitem>
+	  <para>
+	    You can check the integrity by using a MD5 file or by
+	    letting &app; automatically perform a check on the media.
+	    <itemizedlist>
+	      <listitem>
+		<para>
+		  Select the <guilabel>Use a md5 file to check the
+		  disc</guilabel> option to use an MD5 file.
+		</para>
+	      </listitem>
+	      <listitem>
+		<para>
+		  Click on the <guilabel>None</guilabel> button under
+		  the previously mentioned option and select an MD5 file, 
+		  usually ending with the <filename>.md5</filename> 
+		  extension.
+		</para>
+	      </listitem>
+	    </itemizedlist>
+	  </para>
+	</listitem>
+	<listitem>
+	  <para>
+	    Click on the <guibutton>Check</guibutton> button to start
+	    the integrity check.
+	  </para>
+	</listitem>
+      </orderedlist>
+    </para>
+    <para>
+      If the integrity check is successful, &app; will notify you with a
+      <guilabel>File integrity check success</guilabel> dialog;
+      otherwise, the <guilabel>File integrity check error</guilabel>
+      dialog will be displayed.
+    </para>
+  </sect1>
+
+  <sect1 id="brasero-plugins">
+    <title>Plugins</title>
+    <para>
+      &app; can use different plugins to perform different tasks. There
+      are several plugins you can choose from.
+    </para>
+    <para>
+      To view available plugins, press 
+      <menuchoice>
+	<guimenu>Edit</guimenu>
+	<guimenuitem>Plugins</guimenuitem>
+      </menuchoice>. 
+      The plugins that you can use are:
+    </para>
+    <para>
+      <table frame="all">
+	<title>Plugins</title>
+	<tgroup cols="2" align="left" colsep="1" rowsep="1">
+	  <thead>
+	    <row>
+	      <entry>Plugin Name</entry>
+	      <entry>Description</entry>
+	    </row>
+	  </thead>
+	  <tbody>
+	    <row>
+	      <entry><guilabel>local-track</guilabel></entry>
+	      <entry>
+		Enables &app; to burn files which are not stored locally.
+	      </entry>
+	    </row>
+	    <row>
+	      <entry><guilabel>md5sum</guilabel></entry>
+	      <entry>
+		Enables &app; to perform integrity checks 
+		on discs after they have been burnt. Also enables
+		the writing of a small file which holds the MD5
+		sum of all the files on the disc.
+	      </entry>
+	    </row>
+	    <row>
+	      <entry><guilabel>md5sum-file</guilabel></entry>
+	      <entry>
+		Enables &app; to perform integrity checks 
+		on discs by using a file containing the MD5 sum.
+	      </entry>
+	    </row>
+	  </tbody>
+	</tgroup>
+      </table>
+    </para>
+    <para>
+      To enable or disable a plugin, click on the check box next to it.
+    </para>
+    <para>
+      <note>
+	<para>
+	  In order to use some of the plugins listed here, it may be
+	  necessary to install further applications on your
+	  system. See your operating system documentation for more
+	  information.
+	</para>
+      </note>
+    </para>
+  </sect1>
+</article>

Added: trunk/help/C/figures/brasero_main.png
==============================================================================
Binary file. No diff available.

Added: trunk/help/C/legal.xml
==============================================================================
--- (empty file)
+++ trunk/help/C/legal.xml	Thu May  1 14:11:35 2008
@@ -0,0 +1,76 @@
+  <legalnotice id="legalnotice">
+	<para>
+	  Permission is granted to copy, distribute and/or modify this
+	  document under the terms of the GNU Free Documentation
+	  License (GFDL), Version 1.1 or any later version published
+	  by the Free Software Foundation with no Invariant Sections,
+	  no Front-Cover Texts, and no Back-Cover Texts.  You can find
+	  a copy of the GFDL at this <ulink type="help"
+	  url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
+	  distributed with this manual.
+         </para>
+         <para> This manual is part of a collection of GNOME manuals
+          distributed under the GFDL.  If you want to distribute this
+          manual separately from the collection, you can do so by
+          adding a copy of the license to the manual, as described in
+          section 6 of the license.
+	</para>
+
+	<para>
+	  Many of the names used by companies to distinguish their
+	  products and services are claimed as trademarks. Where those
+	  names appear in any GNOME documentation, and the members of
+	  the GNOME Documentation Project are made aware of those
+	  trademarks, then the names are in capital letters or initial
+	  capital letters.
+	</para>
+
+	<para>
+	  DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
+	  UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
+	  WITH THE FURTHER UNDERSTANDING THAT:
+
+	  <orderedlist>
+		<listitem>
+		  <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
+                    WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
+                    IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
+                    THAT THE DOCUMENT OR MODIFIED VERSION OF THE
+                    DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
+                    A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
+                    RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
+                    OF THE DOCUMENT OR MODIFIED VERSION OF THE
+                    DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
+                    MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
+                    YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
+                    CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
+                    SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
+                    OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
+                    LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
+                    VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
+                    EXCEPT UNDER THIS DISCLAIMER; AND
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
+                       THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
+                       CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
+                       INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
+                       DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
+                       OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
+                       PARTIES, BE LIABLE TO ANY PERSON FOR ANY
+                       DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
+                       CONSEQUENTIAL DAMAGES OF ANY CHARACTER
+                       INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
+                       OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
+                       MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
+                       LOSSES ARISING OUT OF OR RELATING TO USE OF THE
+                       DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
+                       EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
+                       THE POSSIBILITY OF SUCH DAMAGES.
+		  </para>
+		</listitem>
+	  </orderedlist>
+	</para>
+  </legalnotice>
+

Added: trunk/help/Makefile.am
==============================================================================
--- (empty file)
+++ trunk/help/Makefile.am	Thu May  1 14:11:35 2008
@@ -0,0 +1,17 @@
+include $(top_srcdir)/gnome-doc-utils.make
+dist-hook: doc-dist-hook
+
+# Module name
+DOC_MODULE = brasero
+
+# Legal entity include
+DOC_ENTITIES = legal.xml
+
+# Othe includes
+DOC_INCLUDES = 
+
+# List of figures to be included
+DOC_FIGURES = figures/brasero_main.png 
+
+# List of translations
+DOC_LINGUAS = 

Added: trunk/help/brasero.omf.in
==============================================================================
--- (empty file)
+++ trunk/help/brasero.omf.in	Thu May  1 14:11:35 2008
@@ -0,0 +1,9 @@
+<?xml version="1.0" standalone="no"?>
+<omf>
+  <resource>
+    <subject category="GNOME|Applications|Sound and Video"/>
+    <type>manual</type>
+    <relation seriesid="e598da9a-cac2-11dc-9a51-a5e81ce6f0a9"/>
+    <rights type="Creative Commons by Attribution-ShareAlike" license.version="2.5" holder="Phil Bull"/>
+  </resource>
+</omf>

Modified: trunk/src/brasero-menu.h
==============================================================================
--- trunk/src/brasero-menu.h	(original)
+++ trunk/src/brasero-menu.h	Thu May  1 14:11:35 2008
@@ -51,6 +51,7 @@
 void on_burn_cb (GtkAction *action, BraseroApp *app);
 void on_disc_info_cb (GtkAction *action, BraseroApp *app);
 void on_about_cb (GtkAction *action, BraseroApp *app);
+void on_help_cb (GtkAction *action, BraseroApp *app);
 
 static GtkActionEntry entries[] = {
 	{"ProjectMenu", NULL, N_("_Project")},
@@ -73,6 +74,9 @@
 
 	{"Exit", GTK_STOCK_QUIT, NULL, NULL,
 	 N_("Exit the program"), G_CALLBACK (on_exit_cb)},
+	
+	{"Contents", GTK_STOCK_HELP, NULL, NULL, N_("Contents"),
+	 G_CALLBACK (on_help_cb)}, 
 
 	{"About", GTK_STOCK_ABOUT, NULL, NULL, N_("About"),
 	 G_CALLBACK (on_about_cb)},

Modified: trunk/src/main.c
==============================================================================
--- trunk/src/main.c	(original)
+++ trunk/src/main.c	Thu May  1 14:11:35 2008
@@ -317,6 +317,56 @@
 	g_free (license);
 }
 
+void
+on_help_cb (GtkAction *action, BraseroApp *app)
+{
+    	GError *error = NULL;
+	char *command;
+	const char *lang;
+	char *uri = NULL;
+	GdkScreen *gscreen;
+	int i;
+    
+	const char * const * langs = g_get_language_names ();
+    
+	for (i = 0; langs[i]; i++) {
+		lang = langs[i];
+        	if (strchr (lang, '.')) {
+            		continue;
+        	}
+        
+        uri = g_build_filename(PACKAGE_DATA_DIR,
+                               "/gnome/help/brasero/",
+                               lang,
+                               "/brasero.xml",
+                               NULL);
+        
+        if (g_file_test (uri, G_FILE_TEST_EXISTS)) {
+            break;
+        	}
+    	}
+    
+	command = g_strconcat ("gnome-open ghelp://", uri, NULL);
+	gscreen = gdk_screen_get_default();
+	gdk_spawn_command_line_on_screen (gscreen, command, &error);
+    	if (error) {
+        	GtkWidget *d;
+        
+        	d = gtk_message_dialog_new(NULL,
+                           GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
+                           GTK_MESSAGE_ERROR, GTK_BUTTONS_OK,
+                           error->message);
+        gtk_dialog_run(GTK_DIALOG(d));
+        gtk_widget_destroy(d);
+        g_error_free(error);
+        error = NULL;
+    }
+    
+	g_free (command);
+	g_free (uri);
+
+}
+
 static gboolean
 on_window_state_changed_cb (GtkWidget *widget,
 			    GdkEventWindowState *event,



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