Re: gtcd and gnome-media

[Erik Jarvi <ejarvi megsinet net>]

On Tue, Jul 18, 2000 at 03:15:52PM -0400, Alexander Kirillov wrote:
> On Tue, Jul 18, 2000 at 01:38:34PM -0500, Erik Jarvi wrote: > 
> > Hi, 
> >
> > I added a few items to the gtcd doc in gnome-apps.sgml. I'm just
> >learning DocBook, so there probably will be errors.
> 
> 2 comments:
> 
> 1. please convert all tags to lower case (including such as
> Format="png") for future xml compatibility
> 
> 2. Many tags are missing. All buttons should be <guibutton>; tab names
>    should be <guilabel>, GNOME CD player should be <application>, etc.  
 
Thanks this is exactly what I needed. :)  Any more tags that I should put in?
 
> Yes, i know, most of these problems were there before - Dave did this
> in a hurry long ago, and nobody got to fixing it, but now it is about
> the time...

I couldn't get '&mdash;' to work. 
db2html gtcd.sgml output:
input file was called gtcd.sgml -- output will be in gtcd

working on ../gtcd.sgml
jade:../gtcd.sgml:3:0:E: no document type declaration; will parse without validation
jade:../gtcd.sgml:79:45:E: general entity "mdash" not defined and no default entity
about to copy cascading stylesheet and admon graphics to temp dir
about to rename temporary directory to gtcd

Erik

-- 
All music aspires to the condition of muzak.
<!-- ############# GNOME CD PLAYER - APPLICATION ############# -->

<chapter id="gtcd">
<title>GNOME CD Player</title>
 <sect1>
  <title>Introduction</title>
  <para>
  <indexterm>
   <primary>GNOME CD Player</primary>
  </indexterm>
   The <application>GNOME CD Player</application> (<command>gtcd</command>) is a 
   GNOME enabled application that is preloaded with GNOME.  This is a simple CD 
   Player which allows you to listen to Compact Discs on your PC.
  </para>
 </sect1>
 <sect1 id="gtcd-use">
  <title>Using the GNOME CD Player</title>
   <para>
    The <application>GNOME CD  Player</application> will be available to you in  the Main Menu in
    the Audio  menu and can also  be invoked in the  command line with
    <prompt>$</prompt><command>gtcd</command>.
   </para>
   <figure>
    <title>The GNOME CD Player</title>
   <screenshot>
    <screeninfo>GTCD</screeninfo>
    <graphic format="png" fileref="./figs/gtcd" srccredit="dcm">
    </graphic>
   </screenshot>
   </figure>
   <important>
    <title>IMPORTANT</title>
    <para>
      You must have the correct access rights to your CDROM drive for this
      application to be successful. Some systems, will normally grant you the
      necessary rights automatically when you log into the console. The
      mechanism that does this is called the
      <application>pam_console</application>. If your system doesn't give you
      the necessary rights to the CDROM, then you will need to be given those
      rights. If you have the root password type the following in a terminal
      window.
     <programlisting>
      $ su 
      $ Password: [type  in root password] 
      $ chmod a+r /dev/cdrom
      $ exit
     </programlisting>
    </para>
    <para>
     If  your CDROM is  located somewhere  other than  <command>/dev/cdrom</command> make
     sure you change it in the commands above.
    </para>
   </important>
   <para>
    The <application>GNOME CD Player</application> works like any CD Player with common buttons such as
    Play, Stop, Pause, etc. Plus a track selector button that displays the track
    titles in a drop down menu. By pressing the track number in the window,
    you can change the looping features. There are three settings normal, loop-cd,
    and loop-t (which is loop track). By pressing the track time you change the
    track/disk elapsed/remaining. You have access to change various properties by
    pressing the <guibutton>Preferences</guibutton> button. This will bring up
    the <application>GNOME CD Player</application> <guibutton>Preferences</guibutton> dialog.
   </para>
   <para>
    There are three tabs in the <application>GNOME CD Player</application> <guibutton>Preferences</guibutton> dialog:
     <guilabel>Preferences</guilabel>, <guilabel>Keybindings</guilabel>, and <guilabel>CDDB Settings</guilabel>.
   </para>
   <figure>
    <title>The GNOME CD Player Properties</title>
   <screenshot>
    <screeninfo>The GTCD Properties Dialog</screeninfo>
    <graphic format="png" fileref="./figs/gtcd-props" srccredit="dcm">
    </graphic>
   </screenshot>
   </figure>
   <itemizedlist mark="bullet">
    <listitem>
     <para>
       <guilabel>Preferences</guilabel> Tab &mdash; In this dialog you may specify:  
     </para>     
     <para> 
      What  you would  like the  <application>GNOME CD Player</application>  to do when
      first started,  and when exited. 
     </para>
     <para> 
      The  location of  your CDROM on  your system.  This is
       usually  <command>/dev/cdrom</command>.
     </para>
     <para>
      The Color to display the  Track and CD Title.
     </para>
     <para> 
      The Font  to  display the  Track  and  CD Title.
     </para>
     <para>
       Whether you would  like handles on the title  window which will
       allow you  to drag  the title  window off of  the CD  Player to
       float  on the desktop.
     </para>
     <para> 
       Whether  tooltips are enabled when your mouse is over the buttons.
     </para>
     <para>
        Use alternate method to play CD
        [Note: I'm not sure what this means]
    </para>
    </listitem>
    <listitem>
     <para>
      <guilabel>Keybindings Tab</guilabel> &mdash; In this tab you can change the key bindings associated
      with the GNOME CD Player. These keybindings allow you to use the Player
      without using your mouse. If you want to change one of the bindings, select
      it with your mouse and type the new key in the <command>Click here to
      change</command> text box. Press Apply to save the changes
     </para>
    </listitem>
    <listitem>
     <para>
      <guilabel>CDDB Settings Tab</guilabel> &mdash; CDDB stands for CD Database and is a huge global
      database of CD information. Each CD has an identity, which the CD Player
      can read. If you are connected to the internet, it will then search a CDDB
      server for that CD identity and return any information it has on it. This
      usually includes CD Title, Artist, and track titles. It can also include
      notes and lyric information. Once this data is retrieved, the <application>
      GNOME CD Player</application> will store the information on your hard drive for future access. In
      the CDDB Setting tab you can change the CDDB server and edit your local
      CDDB database. You can read more about CDDB by visiting the <ulink
      url="http://www.cddb.org" type="http">CDDB Website</ulink>.
     </para>
    </listitem>
   </itemizedlist>
   <para>
    Another feature in the <application>GNOME CD Player</application> 
    is the  Track Editor. The track editor can be launched by the 
    <guibutton>Track Editor</guibutton> button on the main 
    <application>GNOME CD Player</application> window. The
    Track Editor allows  you to edit the CD  track information in case
    it is  incorrect or there was no  CDDB entry for your  CD. You may
    also  check the  status of  the CDDB  information by  pressing the
    <guibutton>CDDB  Status</guibutton> button  at the  bottom  of the
    Track  Editor. This  will show  you  what messages,  if any,  were
    returned from the CDDB server. The <guibutton>Submit</guibutton> 
    button is to sumbit information about the CD to the CDDB, if you
    are the lucky one to be the first to have a CD without any
    information at the CDDB site.
    [Note: I haven't been able to get this to work.]
   </para>
   <figure>
    <title>The GNOME CD Player Track Editor</title>
   <screenshot>
    <screeninfo>The GTCD Track Editor.</screeninfo>
    <graphic format="png" fileref="./figs/trackeditor" srccredit="dcm">
    </graphic>
   </screenshot>
   </figure>
  </sect1>
 </chapter>