.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "DISC-COVER 1" .TH DISC-COVER 1 "2020-10-24" "CD cover generator" "produces covers for audio CDs" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Disc\-Cover \- create front and back covers for audio CDs .SH "SYNOPSIS" .IX Header "SYNOPSIS" disc-cover [\-2|second\ \fIfilename\fR] [\-b|flaptext\ text] [\-a|additional\ text] \&\-allmusic [\-c|\-casetype\ (jewel|slim|x\-slim|tevion\-slim|letter\-slim)] [\-C|Configuration\ \fIfilename\fR] [\-D|Device\ \fIdevice\fR] [\-e|extended] [\-f|file\ \fIfilename\fR] [\-h|help] [\-H|Help] [\-n|new] [\-o|output\ \fIfilename\fR] [\-p\ \fIfilename\fR|\-pic\ \fIfilename\fR] [\-R|Remove] [\-S|Server] [\-t|type\ txt|dvi|tex|ps|pdf|cddb|lbl|html] [\-u|uppercase] [\-v|version] [\-V|Verbose] [\-va|\-variousartists] \&\-template_list .SH "DESCRIPTION" .IX Header "DESCRIPTION" Disc-Cover creates front and back covers for audio CDs. The \s-1CD\s0 has to be present in the CD-ROM drive, or alternatively a valid \s-1CDDB\s0 file can be used. Disc-Cover searches the \s-1CDDB\s0 database for an entry corresponding to the \s-1CD\s0's \&\s-1CDDB ID.\s0 It starts by looking for a local \s-1CDDB\s0 entry in \fI~/.cddb\fR (or another directory pointed to by your cddb installation). If no local \s-1CDDB\s0 entry matches the \s-1CD,\s0 disc-cover continues to search the online \s-1CDDB\s0 databases or \s-1CDINDEX\s0 databases as configured in the AudioCD library. It then formats the entry to produce a Latex, Dvi, Postscript or \s-1PDF\s0 file, which contains the front and back covers on a single page. Other formats supported include a simple text output, a \s-1CDDB\s0 compatible format, \s-1HTML\s0 and an output format that can be used with cdlabelgen (http://www.red\-bean.com/~bwf/software/cdlabelgen/), another cover builder. .SH "QUICKSTART" .IX Header "QUICKSTART" The easiest way of using Disc-Cover is to put an audio cd in your cdrom drive and then run disc-cover without options. Disc-Cover will tell you what it does and if it is able to create a set of covers it tells you the name of the file it creates. Normally this is a PostScript file that is ready for printing. .SH "LAYOUT" .IX Header "LAYOUT" The front cover shows artist, album title and when available extended disc info. Optionally a picture can be added to the front cover. The back cover holds the title and artist in the same fashion. In addition to those, the back cover lists the individual tracks, preceded by a track number and followed by their running time. The total running time of the \s-1CD\s0 is given at the bottom of the back cover. The sides of the back cover contain the artist and \s-1CD\s0 title. Another flap hangs on the side of the right of the back cover. When using fully transparent jewel cases this flap is visible from the front. By default it holds the user's full name. Colour is also supported. .SH "FEATURES" .IX Header "FEATURES" .IP "\- Uses Latex to produce high quality output." 4 .IX Item "- Uses Latex to produce high quality output." .PD 0 .IP "\- Outputs in Latex, Dvi, Postscript, Pdf, Cddb entry, \s-1HTML,\s0 Text and a format to use with cdlabelgen." 4 .IX Item "- Outputs in Latex, Dvi, Postscript, Pdf, Cddb entry, HTML, Text and a format to use with cdlabelgen." .IP "\- Supports caching of cddb entries in a directory that can be shared with other cddb-aware programs." 4 .IX Item "- Supports caching of cddb entries in a directory that can be shared with other cddb-aware programs." .IP "\- Connects with a cddb or cdindex server to get the disc title, artist and list of track titles and extended information where available." 4 .IX Item "- Connects with a cddb or cdindex server to get the disc title, artist and list of track titles and extended information where available." .IP "\- Optionally put a picture on the front cover, supports almost any image format." 4 .IX Item "- Optionally put a picture on the front cover, supports almost any image format." .IP "\- Optionally let Disc-Cover search on allmusic.com for a small version of the corresponding front cover of the cd, which it will put on your front cover." 4 .IX Item "- Optionally let Disc-Cover search on allmusic.com for a small version of the corresponding front cover of the cd, which it will put on your front cover." .IP "\- Assign different colours to different items such as artist name and track numbers." 4 .IX Item "- Assign different colours to different items such as artist name and track numbers." .IP "\- Supports double albums (two cds in one jewel case)." 4 .IX Item "- Supports double albums (two cds in one jewel case)." .IP "\- Creates covers for jewel cases and various slim cases." 4 .IX Item "- Creates covers for jewel cases and various slim cases." .PD .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-2, \-second\fR \fIfilename\fR" 4 .IX Item "-2, -second filename" When using this option disc-cover goes into double album mode, meaning it will print the front cover using the first cddb entry, either reading the cd in the drive or by using a file as described in "\fB\-f, \-file\fR \fIfilename\fR" option. Then it prints the back cover with two halves, the upper half consists the title/artist and then the tracks of the first cd, the lower half contains the tracks of the second cd. .IP "\fB\-a, \-additional\fR \fItext\fR" 4 .IX Item "-a, -additional text" Add text to the bottom of the front cover. Default is to put extended disc information here. You can use this to cancel the extended disc information by doing '\fB\-a\fR \*(L" \*(R"'. .IP "\fB\-allmusic\fR" 4 .IX Item "-allmusic" Search on wwww.allmusic.com for the front cover of the album. This picture will be put on the front cover, just like with \fB\-p\fR and \fB\-pic\fR. These last options override this flag. This way you can enable \-allmusic by default in the config file and override it whenever you need to. .IP "\fB\-b, \-flaptext\fR \fItext\fR" 4 .IX Item "-b, -flaptext text" Add text to the additional flap at the side of the back cover. This flap is visible when used with a fully transparent jewel case. These are becoming more common everyday. By default text from the password entry is used. We take the string from the comments field up until the first comma. Most times this should be the user's full name. Cancel this text by using the configuration file or with '\fB\-b\fR \*(L" \*(R"'. .IP "\fB\-c, \-casetype\fR (\fIjewel|slim|x\-slim|tevion\-slim|letter\-slim\fR)" 4 .IX Item "-c, -casetype (jewel|slim|x-slim|tevion-slim|letter-slim)" These options correspond with files in one of the \f(CW@config_template_dirs\fR which are templates that describe case types. You can also copy one of these files to your current directory, change it and let disc-cover use your own template. The cases described next are delivered together with Disc-Cover. Setting this to slim will have Disc-Cover output covers in a format suitable for slim cases. These are thinner cases often used for single cds or EPs. Use x\-slim if you want the side and flap exchanged. Even more slim are the cases provided by Tevion (use: tevion-slim). For people using letter format that have trouble with not getting the whole case fitted on paper, please use letter-slim. .IP "\fB\-C, \-Configuration\fR \fIfilename\fR" 4 .IX Item "-C, -Configuration filename" Output configuration to a file. The current flags and options set in existing configuration files or given on the commandline are used to set the values. To see the current settings do ;disc\-cover \-C \-'. For example, you can change the default output format to pdf as follows: .Sp .Vb 1 \& disc\-cover \-t pdf \-C ~/.disc\-coverrc .Ve .IP "\fB\-D, \-Device\fR \fIdevice\fR" 4 .IX Item "-D, -Device device" Specify the CD-ROM device. Default is to use \fI/dev/cdrom\fR .IP "\fB\-e, \-extended\fR" 4 .IX Item "-e, -extended" This flag enables extended track information, when available. This extended information will be added below the track names. It is mostly used in compilation cds for artist information. Sometimes this extended track information has been used for lyrics, needles to say this will not fit at the back of one cd cover and hence to prevent the destruction of the layout only the first line will be used. That is why this is an option instead of default behaviour. .IP "\fB\-f, \-file\fR \fIfilename\fR" 4 .IX Item "-f, -file filename" Use filename as input instead of searching the local and online \s-1CDDB\s0 database. File should be a valid \s-1CDDB\s0 entry. .IP "\fB\-g, \-genre\fR" 4 .IX Item "-g, -genre" Include the genre of the disc as the last line of the bottom text on the front cover. The line looks like this: "genre: \fIgenre\fR". Default is off, as often the wrong genre is used or even just misc or data has been chosen. .IP "\fB\-h, \-help\fR" 4 .IX Item "-h, -help" Print help message and exit. .IP "\fB\-H, \-Help\fR" 4 .IX Item "-H, -Help" Show the manual page using pod2text, this should be installed and working (you can check this by typing 'pod2text /path/to/disc\-cover') .IP "\fB\-n, \-new\fR" 4 .IX Item "-n, -new" Creates a new cddb entry. This works with any format, but should be used in conjunction with '\-t cddb' to create a template for you to fill in. See the \*(L"\s-1FREQUENTLY ASKED QUESTIONS\*(R"\s0 to create covers for your custom cds or for cds that are not in the \s-1CDDB\s0 database yet. .IP "\fB\-o, \-output\fR \fIfilename\fR" 4 .IX Item "-o, -output filename" The \-o switch allows one to specify the name of the output file. By default the filename will be Artist_Title.xxx, where xxx is txt, tex, dvi, ps, pdf or html, depending on the file format. See \-t option for supported file formats. Using "\fB\-o\fR \-" will send the output to standard output. .IP "\fB\-p\fR \fIfilename\fR" 4 .IX Item "-p filename" Includes the picture \fIfilename\fR on the front cover in a framed box right aligned with the artist name. The format of the picture has to be known to the program \fIconvert\fR that comes with \fIImageMagick\fR. Also the graphicx package for LaTeX has to be available. The picture is scaled to 200x200 and converted into Adobe Encapsulated PostScript Interchange format. Remember that output in tex, dvi, txt, html and labelgen are completely useless with pictures. In case of output in pdf the picture is transformed into Encapsulated Portable Document Format (\s-1EPDF\s0). .IP "\fB\-pic\fR \fIfilename\fR" 4 .IX Item "-pic filename" Include a graphics file on the front cover without converting it. This only works when the format of the file is the same as the output format. In case of PostScript (\s-1PS\s0) output you can use Encapsulated PostScript (\s-1EPS,EPSI\s0) files. In case of Portable Document Format (\s-1PDF\s0) you can use Encapsulated Portable Document Format (\s-1EPDF\s0). Note that this is essentially the same option as in "\fB\-p\fR \fIfilename\fR" but no scaling or converting is performed. More responsibility goes to the user this way. .IP "\fB\-R, \-Remove\fR" 4 .IX Item "-R, -Remove" By default disc-cover deletes all temporary files it creates before it exits. This behaviour can be overwritten by specifying the this option. For debugging purposes only. .IP "\fB\-S, \-Server\fR" 4 .IX Item "-S, -Server" Create a default configuration for the selection of \s-1CDDB\s0 server. This configuration is used by other \s-1CDDB\s0 aware programs too, so be careful. Note that Disc-Cover will not overwrite the configuration file. .IP "\fB\-t, \-type\fR \fItxt|tex|dvi|ps|pdf|cddb|lbl|html\fR" 4 .IX Item "-t, -type txt|tex|dvi|ps|pdf|cddb|lbl|html" The \-t switch allows one to specify the output format. By default disc-cover will create a Postscript file. Other formats supported include \s-1ASCII\s0 text (txt), LaTeX (tex), \s-1DVI\s0 (dvi), \s-1PDF\s0 (pdf), cddb database format (cddb), a cdlabelgen compatible format (lbl) and in Hypertext Markup Language (html). .IP "\fB\-u, \-uppercase\fR" 4 .IX Item "-u, -uppercase" Fixes those annoying entries that are written without capitals. It capitalises every single word in titles and artists. .IP "\fB\-v, \-version\fR" 4 .IX Item "-v, -version" Print version and program information and exit. .IP "\fB\-V, \-Verbose\fR" 4 .IX Item "-V, -Verbose" Enable verbose output of Disc-Cover, the libaudiocd library and all third party software, such as LaTeX, dvips and convert. For debugging purposes. .IP "\fB\-va, \-variousartists\fR" 4 .IX Item "-va, -variousartists" Some \s-1CDDB\s0 entries code every track in the 'artist / title' format. Mostly, this is used for artists that contain various artists. By enabling this option Disc-Cover will decode and use that information. .IP "\fB\-template_list\fR" 4 .IX Item "-template_list" Prints a list of output template types and their descriptions. .SH "CONFIGURATION" .IX Header "CONFIGURATION" Disc-cover first checks the file \fI/etc/disc\-cover.conf\fR for system wide parameters and then looks at \fI~/.disc\-coverrc\fR. Following are all the different variables that can be set. The file \fI~/.cdserverrc\fR is used indirectly through the AudioCD library. This file contains the \s-1CDDB\s0 and \s-1CDINDEX\s0 servers. Furthermore it can be used to control certain other options of this library. See the appropriate documentation. .PP You can generate a configuration file with the "\fB\-C, \-Configuration\fR \fIfilename\fR" option. Keep in mind that the values in this file will be set by looking at the current settings. That is, any existing configuration files or options on the commandline will be used. .PP To make a clean configuration file, first remove the ~/.disc\-coverrc file and then run Disc-Cover without any option but '\-C': disc-cover \-C ~/.disc\-coverrc .ie n .IP "$config_version_config" 4 .el .IP "\f(CW$config_version_config\fR" 4 .IX Item "$config_version_config" This will be used in the future by new versions of Disc-Cover to check for inconsistencies in changed, removed or added configuration options. .Sp .Vb 1 \& Default: \*(Aq1.4.0\*(Aq; .Ve .ie n .IP "$config_tmp_dir" 4 .el .IP "\f(CW$config_tmp_dir\fR" 4 .IX Item "$config_tmp_dir" This sets the directory that is used for temporary files. .Sp .Vb 1 \& Default: \*(Aq/tmp\*(Aq; .Ve .ie n .IP "$config_output_format" 4 .el .IP "\f(CW$config_output_format\fR" 4 .IX Item "$config_output_format" This is the default output format. Although you can choose any of the types listed in 'disc\-cover \-h' option the most common would be 'ps' or 'pdf'. .Sp .Vb 1 \& Default: \*(Aqps\*(Aq; .Ve .ie n .IP "$config_device" 4 .el .IP "\f(CW$config_device\fR" 4 .IX Item "$config_device" The default cdrom drive that is used to scan a cd. See "\fB\-D, \-Device\fR \fIdevice\fR" .Sp .Vb 1 \& Default: \*(Aq/dev/cdrom\*(Aq; .Ve .ie n .IP "$config_cddb_cache_directory" 4 .el .IP "\f(CW$config_cddb_cache_directory\fR" 4 .IX Item "$config_cddb_cache_directory" The path where cddb entries are stored in and retrieved from. This can be shared with other programs that also use cddb. .Sp .Vb 1 \& Default: "$ENV{HOME}/.cddb"; .Ve .ie n .IP "$flag_with_extended_track_info" 4 .el .IP "\f(CW$flag_with_extended_track_info\fR" 4 .IX Item "$flag_with_extended_track_info" Setting this to one will force disc-cover to include extended track information. See "\fB\-e, \-extended\fR" option. It is advised to keep this 0 as there are lots of entries that contain ugly and meaningless extended information. Most of the time it is only useful in case of various artists cds. .Sp .Vb 1 \& Default: 0; .Ve .ie n .IP "$flag_various_artist_cd" 4 .el .IP "\f(CW$flag_various_artist_cd\fR" 4 .IX Item "$flag_various_artist_cd" Setting this to one will force disc-cover to parse every track the same way it parses the 'artist / title' label. This might be useful for various artist cds where every track is formatted in the same way. It is advised to leave this option 0, as disc-cover will issue a warning whenever it encounters such a disc. You can easily turn it on with "\fB\-va, \-variousartists\fR" .Sp .Vb 1 \& Default: 0; .Ve .ie n .IP "$flag_double_disc_cdtitle" 4 .el .IP "\f(CW$flag_double_disc_cdtitle\fR" 4 .IX Item "$flag_double_disc_cdtitle" Setting this flag during the processing of a double cd (using the "\fB\-2, \-second\fR" option) enables a 'smart' algorithm that attempts to find a nice title for the cd, using the titles of both cddb entries. It will remove all characters unequal in both strings, and gets rid of any characters surrounding uncommon parts. Last, it removes the words 'disc' and 'disk', plus any whitespace at the beginning or end., \-second>> option) enables a 'smart' algorithm that attempts to find a nice title for the cd, using the titles of both cddb entries. It will remove all characters unequal in both strings, and gets rid of any characters surrounding uncommon parts. Last, it removes the words 'disc' and 'disk', plus any whitespace at the beginning or end. .Sp .Vb 1 \& Default: 1; .Ve .ie n .IP "$flag_genre" 4 .el .IP "\f(CW$flag_genre\fR" 4 .IX Item "$flag_genre" By setting this an additional line will be added to the bottom of the bottom text on the front cover with the genre (taken from the database) of the disc. See \fB\-g, \-genre\fR option. .Sp .Vb 1 \& Default: 0; .Ve .ie n .IP "$flag_picture_use_allmusic" 4 .el .IP "\f(CW$flag_picture_use_allmusic\fR" 4 .IX Item "$flag_picture_use_allmusic" Setting this flag does the same as the \fB\-allmusic\fR option. That is, Disc-Cover will search for a cover picture on allmusic to be put on the front cover. .Sp .Vb 1 \& Default: 0; .Ve .ie n .IP "$flag_uppercase_fix" 4 .el .IP "\f(CW$flag_uppercase_fix\fR" 4 .IX Item "$flag_uppercase_fix" Setting this flag does the same as the \fB\-u,\-uppercase\fR option. That is, Disc-Cover will capitalise every single word in titles and artists. .Sp .Vb 1 \& Default: 0; .Ve .ie n .IP "%config_latex_colors" 4 .el .IP "\f(CW%config_latex_colors\fR" 4 .IX Item "%config_latex_colors" This is a list of colours that can be set to alter most of the different items that appear on the covers. You can change the colour of the title, artist, discinfo, track strings, track numbers and track times independently. Use colours from the color.sty Latex file: black, white, red, green, blue, cyan, magenta and yellow. .Sp .Vb 10 \& Default: ( title => \*(Aqblack\*(Aq, \& artist => \*(Aqblack\*(Aq, \& discinfo => \*(Aqblack\*(Aq, \& track_number => \*(Aqblack\*(Aq, \& track_string => \*(Aqblack\*(Aq, \& track_time => \*(Aqblack\*(Aq, \& track_extended => \*(Aqblack\*(Aq \& track_artist => \*(Aqblack\*(Aq \& flaptext => \*(Aqblack\*(Aq, \& ); .Ve .ie n .IP "$config_flaptext" 4 .el .IP "\f(CW$config_flaptext\fR" 4 .IX Item "$config_flaptext" This takes the string from the comments field of the user's password entry. We use only the text up until the first comma, which normally is set to the user's full name. You can also put a simple string here or an empty one to cancel the output. See also "\fB\-b, \-flaptext\fR \fItext\fR" option. .Sp .Vb 1 \& Default: split \*(Aq,\*(Aq, (getpwuid($<)))[6]; .Ve .ie n .IP "$config_casetype" 4 .el .IP "\f(CW$config_casetype\fR" 4 .IX Item "$config_casetype" This determines for which type of case output is generated. It searches for a template file in all the \f(CW@config_template_dirs\fR with the same name. .Sp .Vb 1 \& Default: "jewel"; .Ve .ie n .IP "$latex_user_packages" 4 .el .IP "\f(CW$latex_user_packages\fR" 4 .IX Item "$latex_user_packages" If you create a template that requires special LaTeX packages, they can be added here. Generally not advised if you want to share your templates with others as they need to own those LaTeX packages, and add them to Disc-Cover's configuration file. .Sp .Vb 1 \& Default: ""; .Ve .ie n .IP "$latex_language_encoding" 4 .el .IP "\f(CW$latex_language_encoding\fR" 4 .IX Item "$latex_language_encoding" Whenever you create cds with languages not normally supported by LaTeX you should add or change this. It calls \eusepackage[$latex_language_encoding]{inputenc}. Main encodings are, latin1 for \s-1ISO\s0 Latin\-1, ascii for pure \s-1ASCII,\s0 ansinew and cp1252 (they are synonyms) for Windows 3.1 \s-1ANSI\s0 (an \s-1MS\s0 extension of \s-1ISO\s0 Latin\-1) and applemac for Apple MacIntosh. .Sp .Vb 1 \& Default: "latin1"; .Ve .SH "FREQUENTLY ASKED QUESTIONS" .IX Header "FREQUENTLY ASKED QUESTIONS" Here you might find an answer between the FAQs. .SS "Q: I get the following error (or similar), what's wrong?" .IX Subsection "Q: I get the following error (or similar), what's wrong?" .Vb 5 \& "Can\*(Aqt locate HTTP/Request.pm in @INC (@INC contains: \& /usr/lib/perl5/5.00502/i586\-linux /usr/lib/perl5/5.00502 \& /usr/lib/perl5/site_perl/5.005/i586\-linux /usr/lib/perl5/site_perl/5.005 .) \& at ./disc\-cover line 811. \& BEGIN failed\-\-compilation aborted at ./disc\-cover line 811." .Ve .PP A: Install the Perl modules called libwww-perl, HTML-Parser, \s-1URI,\s0 and MIME\-Base64, which can be found at www.cpan.org or at the 'more stuff...' directory on the homepage of Disc-Cover. See the file \s-1INSTALL\s0 for more details. .SS "Q: I get the following error with the option \-V, what's wrong?" .IX Subsection "Q: I get the following error with the option -V, what's wrong?" .Vb 8 \& "Disc\-Cover: running verbose version x.x.x (config y.y.y) \& Disc\-Cover: creating tmp dir (/tmp/disc\-cover\-4436) \& Disc\-Cover: calling Audio\-CD library... \& Trying CDDB server cddbp://:0/ \& Connection error: No such file or directory \& Could not establish connection with any CDDB servers! \& Disc\-Cover: ...back from call to Audio\-CD library. \& Disc\-Cover: Audio\-CD library says success, let\*(Aqs continue" .Ve .PP A: You have no \s-1CDDB\s0 servers configured. Either use the wonderful program cdcd to create such a configuration or run disc-cover with the options \-S. .SS "Q: How do I make a cover for homemade cds?" .IX Subsection "Q: How do I make a cover for homemade cds?" A: Follow these steps. .PP 1. Insert the homemade cd. .PP 2. Run disc-cover like this: disc-cover \-n \-t cddb \-o myfile.cddb .PP 3. Edit the myfile.cddb with some text editor, the tracks will all be named \*(L"Untitled\*(R". This should be very easy. .PP 4. For printable output run disc-cover again: disc-cover \-f myfile.cddb .SS "Q: I have been using 1.0.1. under SuSE 7.3 for a while an want to upgrade to 1.3.X or higher However, Audio-CD does not compile." .IX Subsection "Q: I have been using 1.0.1. under SuSE 7.3 for a while an want to upgrade to 1.3.X or higher However, Audio-CD does not compile." A: You have to install lbcdaudio first. Your distribution does not contain it, or it does not install it with the standard setup. .SS "Q: After installation all my \s-1CD\s0's are reread from the internet." .IX Subsection "Q: After installation all my CD's are reread from the internet." A: Run the following commands (from a script, if you like) .PP .Vb 12 \& cd ~/.cddb \& ln \-s . blues \& ln \-s . classical \& ln \-s . country \& ln \-s . data \& ln \-s . folk \& ln \-s . jazz \& ln \-s . newage \& ln \-s . reggae \& ln \-s . rock \& ln \-s . soundtrack \& ln \-s . misc .Ve .ie n .SS "Q: Q3. Mike Oliphant's grip creates cddb-files with track-artist held in a special field called \s-1TARTIST0, TARTIST1, ...\s0 Why can't disc-cover print these labels appropriately by the ""\-va"" option?" .el .SS "Q: Q3. Mike Oliphant's grip creates cddb-files with track-artist held in a special field called \s-1TARTIST0, TARTIST1, ...\s0 Why can't disc-cover print these labels appropriately by the ``\-va'' option?" .IX Subsection "Q: Q3. Mike Oliphant's grip creates cddb-files with track-artist held in a special field called TARTIST0, TARTIST1, ... Why can't disc-cover print these labels appropriately by the -va option?" A: Unfortunately Mike's idea to invent new tags for the track artist violates the freedb-conventions for handling samplers. There will be no support for this. .SS "Q: How to cut the covers?" .IX Subsection "Q: How to cut the covers?" A: This is my routine for jewel cases, just one way of doing it. I start with the front cover. I cut it with two cuts along the width of the paper. This results in a front cover with two pieces of paper along the sides. These are folded backwards to help the cover keep in place when it is inserted in the jewel case. The back cover is just cut with four cuts. .SS "Q: When I print my cover from \s-1PDF\s0 in Acrobat Reader the resulting covers are too small. How come?" .IX Subsection "Q: When I print my cover from PDF in Acrobat Reader the resulting covers are too small. How come?" A: Hendrik Neumann : The problem is the option 'Fit to page' that makes Acrobat Reader scale the page before printing. Turn it off before attempting to print. .SS "Q: I'm not root and I want to install Audio::CD" .IX Subsection "Q: I'm not root and I want to install Audio::CD" A: Adam Spiers : make sure that the correct parameters are given to the perl Makefile.PL file as follows: .PP .Vb 2 \& perl Makefile.PL LIBS="\-L/nfs\-home/adams/local/lib \-lcdaudio" \e \& INC=\-I/nfs\-home/adams/software/libcdaudio\-0.99.6/source PREFIX=~ .Ve .SS "Q: How do I make covers for double cds?" .IX Subsection "Q: How do I make covers for double cds?" A: Follow these steps: .PP 1. insert the \fIsecond\fR disc .PP 2. Run disc-cover: disc-cover \-t cddb \-o disc2.cddb .PP 3. replace the second disc with the first .PP 4. Run disc-cover again: disc-cover \-2 disc2.cddb .SS "Q: The quality of the picture is reduced!" .IX Subsection "Q: The quality of the picture is reduced!" A: The image is resized to 200x200 pixels, this is to make sure that the size of the resulting eps or pdf picture is not too large. You can work around this by converting your picture yourself, for example with jpeg2ps, and then including this in your cover using the '\-pic' option. This options includes files as they are. .SS "Q: I want Disc-Cover to have this specific feature, what now?" .IX Subsection "Q: I want Disc-Cover to have this specific feature, what now?" A: Send me an e\-mail with your feature or better yet, implement it yourself and send me a patch file. This does not guarantee that your feature will be in any future version though. I would like to keep Disc-Cover as simple to use as possible. But, sometimes I can't resist to put in something new, or the number of e\-mails on one feature grows large enough for me to add it to Disc-Cover. .SS "Q: I run Disc-Cover and it does not produce a correct cover, what's wrong?" .IX Subsection "Q: I run Disc-Cover and it does not produce a correct cover, what's wrong?" A: I don't know! If you e\-mail the problem I can try to fix it. When you mail some error please remember to state the problem as exact as you can and to include the cddb entry (save it with 'disc\-cover \-t cddb'). Also, two debug options are included. Use "\fB\-V, \-Verbose\fR" to get verbose output of what the program is doing. This helps me locate the problem if you email me your problem. Use "\fB\-R, \-Remove\fR" to prevent disc-cover from deleting temporary files. This enables you to examine intermediate files (.tex, .div, pictures). .SH "FILES" .IX Header "FILES" .IP "\fI/etc/disc\-cover.conf\fR" 4 .IX Item "/etc/disc-cover.conf" System wide configuration file (for its format see \*(L"\s-1CONFIGURATION\*(R"\s0)). All its items can be overridden in a user configuration file. .IP "\fI\f(CI$HOME\fI/.disc\-coverrc\fR" 4 .IX Item "$HOME/.disc-coverrc" User configuration file (for its format see \*(L"\s-1CONFIGURATION\*(R"\s0). .IP "\fI\f(CI$HOME\fI/.cdserverrc\fR" 4 .IX Item "$HOME/.cdserverrc" Configuration of the AudioCD library. Use this to select which servers are to be used. .SH "BUGS" .IX Header "BUGS" .IP "1." 4 Whenever there is more than one file in the cddb cache directory disc-cover will issue a warning and just use the first one it found. .IP "2." 4 Not possible to use \s-1CDINDEX\s0 files as input. .IP "3." 4 The layout of the tracks can be slightly deformed when special international characters or any other tall characters appear in the title. .SH "AUTHORS" .IX Header "AUTHORS" disc-cover is written and maintained by J.I. van Hemert You can find the latest version on http://www.cwi.nl/~jvhemert/disc\-cover.html The program is licensed under the \s-1GNU\s0 Public License. More information about this license is in the source package in the file \fI\s-1COPYING\s0\fR or on http://www.gnu.org/copyleft/gpl.html