From 58e69a33b5bf5902d3a224d9210113b3f3d60d4a Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Thu, 6 Feb 2014 17:52:20 -0600 Subject: Reorganize tdeioslave help handbooks, fix related protocol files and issues, update and add handbooks. --- doc/tdeioslave/Makefile.am | 2 +- doc/tdeioslave/audiocd.docbook | 208 ---------------------------------- doc/tdeioslave/audiocd/Makefile.am | 2 + doc/tdeioslave/audiocd/index.docbook | 214 +++++++++++++++++++++++++++++++++++ 4 files changed, 217 insertions(+), 209 deletions(-) delete mode 100644 doc/tdeioslave/audiocd.docbook create mode 100644 doc/tdeioslave/audiocd/Makefile.am create mode 100644 doc/tdeioslave/audiocd/index.docbook (limited to 'doc/tdeioslave') diff --git a/doc/tdeioslave/Makefile.am b/doc/tdeioslave/Makefile.am index 085981d9..561d25fa 100644 --- a/doc/tdeioslave/Makefile.am +++ b/doc/tdeioslave/Makefile.am @@ -1,4 +1,4 @@ - +SUBDIRS = $(AUTODIRS) KDE_LANG = en KDE_DOCS = AUTO diff --git a/doc/tdeioslave/audiocd.docbook b/doc/tdeioslave/audiocd.docbook deleted file mode 100644 index 371d0aa4..00000000 --- a/doc/tdeioslave/audiocd.docbook +++ /dev/null @@ -1,208 +0,0 @@ -
-audiocd - - -&Rik.Hemsley; &Rik.Hemsley.mail; -BenjaminMeyer - - - -2004-09-16 -2.30.00 - - - -Allows treating audio CDs like a -real filesystem, where tracks are represented as files -and, when copied from the folder, are digitally extracted from the -CD. This ensures a perfect copy of the audio -data. - -To see how this slave works, insert an audio CD -in your &CD-ROM; drive and type audiocd:/ into -&konqueror;. Within a few seconds you should see a list of tracks and -some folders. - -Audio CDs don't really have folders, but -the audiocd slave provides them as a convenience. If you look inside -these folders you will see that they all contain the same number of -tracks. If you are connected to the Internet, some folders will have -the actual track titles shown as the filenames. - -The reason that these separate folders exist are so that you -can choose in which format you would like to listen to (or copy) the -tracks on the CD. - -If you drag a track from the Ogg -Vorbis folder and drop it on another &konqueror; window -open at your home folder, you should see a progress window showing -you that the track is being extracted from the CD and -saved to a file. Note that Ogg Vorbis is a compressed format, so the -file in your home folder will appear a great deal smaller than it -would have been if you had copied the raw data. - -The mechanism behind this is quite simple. When the audiocd slave -is asked to retrieve a track from the Ogg -Vorbis folder, it starts extracting the digital audio data -from the CD. As it sends the data over to the file in -your home folder, it simultaneously encodes it in Ogg Vorbis format -(CD audio is in an uncompressed format to start -with). - -You could also try dragging a file ending in .wav and dropping it on the &kde; Media -Player, &noatun;. In this case, the procedure that happens behind the -scenes is similar, except that instead of encoding the audio data in Ogg -Vorbis format, it is put through a very simple conversion, from raw -binary data (which the .cda files in -the toplevel folder represent) to RIFF WAV format, a -non-compressed format that most media players understand. - -&noatun; should quite happily play the .wav file, but if it has trouble, you may -consider using the option, explained -below. - - -Options - - - - -Set the path to the audio CD device, ⪚ -audiocd:/=/dev/sdc. -Normally, the slave will try to find a CD drive with -an audio CD inserted, but if it fails or you have -more than one CD drive, you may want to try this -option. Note that the configuration dialog allows you to set a default -value for this option. - - - - - - -Set the file name template, ⪚ -audiocd:/=Track %{number}. Note that the configuration dialog allows you to set a default value for this option. A warning that if you set it to an empty string no files will show up. - - - - - - -Set the album name template, ⪚ -audiocd:/=%{albumartist} %{albumtitle}. Note that the configuration dialog allows you to set a default value for this option. - - - - - - -Sets the process nice level for encoders, ⪚ -audiocd:/=niceLevel=10. Note that the configuration dialog allows you to set a default value for this option. - - - - - - -Set the amount of error detection and correction used when -extracting data. - - - -Level 0 - -No detection or correction. Only useful if you have a perfect -CD drive (unlikely). - - - - -Level 1 - -Enable basic error checking and correction. - - - - -Level 2 - -Default. Specifies that only a perfect extraction will be -accepted. - - - - -Note that there is a disadvantage to level 2. Extraction can be -very slow, so real-time digital playback may not work properly. If you -have a good quality CD drive (note that more -expensive does not necessarily mean better quality) then you probably -won't experience very slow extraction, but a poor drive may take days -(!) to extract the audio from one CD. - - - - - - - -Specify which Internet CD Database entry to use. Audio -CDs don't have track names, but the Internet -CD Database is a clever system which uses a special -unique identifier generated from the number and length of tracks on each -CD to cross-reference a track listing. Track listings -are contributed by the Internet community and made available to -all. Occasionally there will be multiple entries. You can specify which one to use. - -You can submit your own track listings using &kscd;, the &kde; -CD player. - -By default audiocd tries to pick the best one. - - - - - -Examples - -audiocd:/?device=/dev/scd0&paranoia_level=0&cddbChoice=0 - -Gives a listing of the tracks on the audio CD -inserted in /dev/scd0, which on -&Linux; specifies the first SCSI &CD-ROM; device. If -you copy tracks from the CD, digital extraction will -be performed without error correction or detection. The -CDDB Database entry 0 will be used. - - - - - -Frequently Asked Question - - -I get The file or folder / does not -exist. How do I fix that? I have an audio -CD in my drive! - - - -Try running cdparanoia - as yourself (not root). Do you see a track list? If not, -make sure you have permission to access the CD -device. If you're using SCSI emulation (possible if -you have an IDE CD writer) then -make sure you check that you have read and write permissions on the -generic SCSI device, which is probably /dev/sg0, /dev/sg1, &etc;. If it still doesn't work, -try typing audiocd:/?device=/dev/sg0 (or similar) -to tell tdeio_audiocd which device your &CD-ROM; is. - - - - - -
diff --git a/doc/tdeioslave/audiocd/Makefile.am b/doc/tdeioslave/audiocd/Makefile.am new file mode 100644 index 00000000..acb3c513 --- /dev/null +++ b/doc/tdeioslave/audiocd/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = en +KDE_DOCS = tdeioslave/audiocd diff --git a/doc/tdeioslave/audiocd/index.docbook b/doc/tdeioslave/audiocd/index.docbook new file mode 100644 index 00000000..41d3a1bb --- /dev/null +++ b/doc/tdeioslave/audiocd/index.docbook @@ -0,0 +1,214 @@ + + + +]> + +
+audiocd + + +&Rik.Hemsley; &Rik.Hemsley.mail; +BenjaminMeyer + + + +2004-09-16 +2.30.00 + + + +Allows treating audio CDs like a +real filesystem, where tracks are represented as files +and, when copied from the folder, are digitally extracted from the +CD. This ensures a perfect copy of the audio +data. + +To see how this slave works, insert an audio CD +in your &CD-ROM; drive and type audiocd:/ into +&konqueror;. Within a few seconds you should see a list of tracks and +some folders. + +Audio CDs don't really have folders, but +the audiocd slave provides them as a convenience. If you look inside +these folders you will see that they all contain the same number of +tracks. If you are connected to the Internet, some folders will have +the actual track titles shown as the filenames. + +The reason that these separate folders exist are so that you +can choose in which format you would like to listen to (or copy) the +tracks on the CD. + +If you drag a track from the Ogg +Vorbis folder and drop it on another &konqueror; window +open at your home folder, you should see a progress window showing +you that the track is being extracted from the CD and +saved to a file. Note that Ogg Vorbis is a compressed format, so the +file in your home folder will appear a great deal smaller than it +would have been if you had copied the raw data. + +The mechanism behind this is quite simple. When the audiocd slave +is asked to retrieve a track from the Ogg +Vorbis folder, it starts extracting the digital audio data +from the CD. As it sends the data over to the file in +your home folder, it simultaneously encodes it in Ogg Vorbis format +(CD audio is in an uncompressed format to start +with). + +You could also try dragging a file ending in .wav and dropping it on the &kde; Media +Player, &noatun;. In this case, the procedure that happens behind the +scenes is similar, except that instead of encoding the audio data in Ogg +Vorbis format, it is put through a very simple conversion, from raw +binary data (which the .cda files in +the toplevel folder represent) to RIFF WAV format, a +non-compressed format that most media players understand. + +&noatun; should quite happily play the .wav file, but if it has trouble, you may +consider using the option, explained +below. + + +Options + + + + +Set the path to the audio CD device, ⪚ +audiocd:/=/dev/sdc. +Normally, the slave will try to find a CD drive with +an audio CD inserted, but if it fails or you have +more than one CD drive, you may want to try this +option. Note that the configuration dialog allows you to set a default +value for this option. + + + + + + +Set the file name template, ⪚ +audiocd:/=Track %{number}. Note that the configuration dialog allows you to set a default value for this option. A warning that if you set it to an empty string no files will show up. + + + + + + +Set the album name template, ⪚ +audiocd:/=%{albumartist} %{albumtitle}. Note that the configuration dialog allows you to set a default value for this option. + + + + + + +Sets the process nice level for encoders, ⪚ +audiocd:/=niceLevel=10. Note that the configuration dialog allows you to set a default value for this option. + + + + + + +Set the amount of error detection and correction used when +extracting data. + + + +Level 0 + +No detection or correction. Only useful if you have a perfect +CD drive (unlikely). + + + + +Level 1 + +Enable basic error checking and correction. + + + + +Level 2 + +Default. Specifies that only a perfect extraction will be +accepted. + + + + +Note that there is a disadvantage to level 2. Extraction can be +very slow, so real-time digital playback may not work properly. If you +have a good quality CD drive (note that more +expensive does not necessarily mean better quality) then you probably +won't experience very slow extraction, but a poor drive may take days +(!) to extract the audio from one CD. + + + + + + + +Specify which Internet CD Database entry to use. Audio +CDs don't have track names, but the Internet +CD Database is a clever system which uses a special +unique identifier generated from the number and length of tracks on each +CD to cross-reference a track listing. Track listings +are contributed by the Internet community and made available to +all. Occasionally there will be multiple entries. You can specify which one to use. + +You can submit your own track listings using &kscd;, the &kde; +CD player. + +By default audiocd tries to pick the best one. + + + + + +Examples + +audiocd:/?device=/dev/scd0&paranoia_level=0&cddbChoice=0 + +Gives a listing of the tracks on the audio CD +inserted in /dev/scd0, which on +&Linux; specifies the first SCSI &CD-ROM; device. If +you copy tracks from the CD, digital extraction will +be performed without error correction or detection. The +CDDB Database entry 0 will be used. + + + + + +Frequently Asked Question + + +I get The file or folder / does not +exist. How do I fix that? I have an audio +CD in my drive! + + + +Try running cdparanoia + as yourself (not root). Do you see a track list? If not, +make sure you have permission to access the CD +device. If you're using SCSI emulation (possible if +you have an IDE CD writer) then +make sure you check that you have read and write permissions on the +generic SCSI device, which is probably /dev/sg0, /dev/sg1, &etc;. If it still doesn't work, +try typing audiocd:/?device=/dev/sg0 (or similar) +to tell tdeio_audiocd which device your &CD-ROM; is. + + + + + +
-- cgit v1.2.1