.\" 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 "STILVIEW 1" .TH STILVIEW 1 "2021-04-19" "perl v5.30.0" "User Programs" .\" 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" stilview \- command\-line program to help you retrieve the entries stored in STIL. .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBstilview\fR [\-b] [\-d] [\-e entry] [\-f field] [\-i] [\-l \s-1HVSC\s0 base dir] [\-m] [\-o] [\-s] [\-t tune number] .PP \&\fBstilview\fR {[\-h] | [\-v]} .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBSTILView\fR is a command-line driven program to help you retrieve the entries stored in \s-1STIL\s0 fast and accurately. STILView uses the \s-1STIL \*(C+\s0 class heavily to do this, and in fact, the primary purpose of this command-line program is to test that class (which is, \s-1BTW,\s0 used in many GUI-based \s-1SID\s0 players, most notably in SIDPlay for Windows and \s-1XSIDPLAY\s0 for Unix systems). However, it is user-friendly enough to be used by non-programmers, too. .SH "GLOSSARY" .IX Header "GLOSSARY" Some terms and STIL-related lingo in alphabetical order: .IP "\fB\s-1BUG ENTRY\s0\fR" 4 .IX Item "BUG ENTRY" There exists a special file in \s-1HVSC\s0 (\fI/DOCUMENTS/BUGlist.txt\fR) that lists all known bugs in \s-1SID\s0 tunes in \s-1HVSC.\s0 See the top of that file for details about what's in it exactly. A \s-1BUG\s0 entry is like a \&\s-1STIL\s0 entry, but it is contained in this BUGlist.txt file. .IP "\fB\s-1FIELD\s0\fR" 4 .IX Item "FIELD" The smallest piece of information in a \s-1STIL\s0 entry. Currently valid field names are \s-1NAME, TITLE, ARTIST\s0 and \s-1COMMENT.\s0 .IP "\fBFILE-GLOBAL \s-1COMMENT\s0\fR" 4 .IX Item "FILE-GLOBAL COMMENT" A special \s-1COMMENT\s0 field in a \s-1STIL\s0 entry for a multi-tune \s-1SID\s0 file that refers to the whole \s-1SID,\s0 not just one tune in it. These usually contain general information about the \s-1SID\s0 file itself. .Sp Example: .Sp .Vb 9 \& /Hubbard_Rob/Gerry_the_Germ.sid \& COMMENT: In Rob\*(Aqs own demo of this music, the tunes are named after the levels \& in the original game. \& (#1) \& TITLE: Lungs \& (#2) \& TITLE: Kidney \& (#7) \& TITLE: End .Ve .IP "\fB\s-1HVSC\s0\fR" 4 .IX Item "HVSC" High Voltage \s-1SID\s0 Collection. If you don't know what this is, you downloaded the wrong program. :) .IP "\fBHVSC-RELATIVE \s-1PATHNAME\s0\fR" 4 .IX Item "HVSC-RELATIVE PATHNAME" The pathname plus filename of a \s-1SID\s0 file that can be found in your \&\s-1HVSC,\s0 relative to the base directory of \s-1HVSC.\s0 It is always in UNIX-style format, eg.: /Hubbard_Rob/Commando.sid refers to Rob Hubbard's Commando.sid file within \s-1HVSC\s0 (which may actually be found as C:\eMusic\eHVSC\eHubbard_Rob\eCommando.sid on your Windows \s-1PC\s0). .IP "\fBMULTI-TUNE \s-1ENTRY\s0\fR" 4 .IX Item "MULTI-TUNE ENTRY" A \s-1STIL\s0 entry that is referring to a \s-1SID\s0 file that has many tunes in it. Each tune might have its own \s-1STIL\s0 block, which are separated by a so-called tune designation in the form of \*(L"(#x)\*(R", where x = the tune number. Consult the \s-1STIL.FAQ\s0 in \s-1HVSC\s0 for a detailed description. .Sp Example: .Sp .Vb 9 \& /Hubbard_Rob/Gerry_the_Germ.sid \& COMMENT: In Rob\*(Aqs own demo of this music, the tunes are named after the levels \& in the original game. \& (#1) \& TITLE: Lungs \& (#2) \& TITLE: Kidney \& (#7) \& TITLE: End .Ve .IP "\fB\s-1SECTION\s0\fR" 4 .IX Item "SECTION" A part of \s-1STIL\s0 that belongs to one composer (ie. every \s-1STIL\s0 entry referring to \s-1SID\s0 files that are in one subdirectory in \s-1HVSC\s0). Sections in \s-1STIL\s0 are always separated by a line in the form of: \*(L"### Composer's name ########\*(R". .IP "\fBSECTION-GLOBAL \s-1COMMENT\s0\fR" 4 .IX Item "SECTION-GLOBAL COMMENT" A special \s-1STIL\s0 entry that refers not to an individual \s-1SID\s0 file, but to a whole subdirectory. These usually contain info about the composer himself, or about all the \s-1SID\s0 file he/she ever composed, and are always indexed in the form of \*(L"/Subdir/\*(R" (note the trailing slash!). .Sp Example: .Sp .Vb 5 \& /Hubbard_Rob/ \& COMMENT: All of these tunes have been confirmed by Hubbard to be his. People \& have often stolen Hubbard\*(Aqs routine causing some tunes to be falsely \& credited to him. \& Hubbard\*(Aqs own comments are denoted by (RH). .Ve .IP "\fBSINGLE-TUNE \s-1ENTRY\s0\fR" 4 .IX Item "SINGLE-TUNE ENTRY" A \s-1STIL\s0 entry that has no tune designation in it in the form of \*(L"(#x)\*(R", where x is a number. (Note, that a single-tune entry might still refer to a \s-1SID\s0 file which has many tunes in it, ie. when a single-tune entry has nothing but a \s-1COMMENT\s0 field in it!) .Sp Example: .Sp .Vb 3 \& /Hubbard_Rob/Chain_Reaction.sid \& TITLE: Zoolook (remix) [from Zoolook] \& ARTIST: Jean Michel Jarre .Ve .Sp Another example (the \s-1SID\s0 this is refering to has many tunes in it!): .Sp .Vb 2 \& /Barrett_Steve/Magic_Land_Dizzy.sid \& COMMENT: Also used in the game "Wacky Darts" (c) 1990 Codemasters. .Ve .IP "\fB\s-1STIL\s0\fR" 4 .IX Item "STIL" \&\s-1SID\s0 Tune Information List, essentially a text-file database that can be found in your \s-1HVSC\s0 in the /DOCUMENTS/ subdirectory. .IP "\fB\s-1STIL ENTRY\s0\fR" 4 .IX Item "STIL ENTRY" All of the pieces of information in \s-1STIL\s0 relating to one \s-1SID\s0 file of the \s-1HVSC.\s0 They are always indexed by the HVSC-relative pathname. .IP "\fB\s-1TUNE\s0\fR" 4 .IX Item "TUNE" One of the compositions in a \s-1SID.\s0 Most \s-1SID\s0 files have only one tune in them, but many have more than one (eg. one for the title score of the game, and one for the hi-score music). .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-b\fR" 4 .IX Item "-b" Do \fBnot\fR print \s-1BUG\s0 entries Default value: Not specified (ie. do print \s-1BUG\s0 entries) .Sp Example: \f(CW\*(C`stilview \-e=/Hubbard_Rob/Commando.sid \-b\*(C'\fR .Sp When this option is specified, \s-1BUG\s0 entries will not be printed for the given \s-1SID\s0 tune. At a minimum, the \-e option has to be specified for this option to work. .IP "\fB\-d\fR" 4 .IX Item "-d" Default value: Not specified (ie. debug mode is off) .Sp Example: \f(CW\*(C`stilview \-e=/Hubbard_Rob/Commando.sid \-d\*(C'\fR .Sp Turns on debug mode in STILView. This will result in an extensive output, with the debugging messages going to \s-1STDERR.\s0 If you encounter any problem or strange behavior with STILView, run STILView with the exact same options as you did when you encountered the problem, with this \-d option added to them. Capture the complete output of this run, and send it to me with a detailed explanation of the problem (see email address at the top of this file). .IP "\fB\-e\fR=\fIentry\fR" 4 .IX Item "-e=entry" Default: \s-1NONE\s0 (you have to give an HVSC-relative pathname to this option) .Sp Example #1: \f(CW\*(C`stilview \-e=/Hubbard_Rob/Commando.sid\*(C'\fR .Sp Example #2: \f(CW\*(C`stilview \-e=/Hubbard_Rob/\*(C'\fR .Sp This is where you specify the \s-1STIL\s0 entry you are looking for, given as an HVSC-relative pathname. If there exists no \s-1STIL\s0 entry for the given filename, STILView will print out nothing. Otherwise, you'll get the \s-1STIL\s0 entry (or parts of it, as you may have specified it by other options). HVSC-relative pathnames are case-insensitive, so /HUBBARD_ROB/Commando.sid is the same as /Hubbard_Rob/Commando.sid. .Sp Example #1 is the most frequent way of retrieving \s-1STIL\s0 entries, and it will return all of the \s-1STIL\s0 entry for Commando.sid, as well as the section-global comment for /Hubbard_Rob/. Example #2 is another valid thing to do: this will return only the section-global comment for /Hubbard_Rob/. .IP "\fB\-h\fR" 4 .IX Item "-h" Default: \s-1NONE\s0 Example: stilview \-h .Sp Prints a brief help screen listing the available options. All other options that are also specified on the command-line are ignored. .IP "\fB\-f\fR=\fIfield\fR" 4 .IX Item "-f=field" Default: all .Sp Valid values for are: all, name, author, title, artist, comment .Sp Example #1: \f(CW\*(C`stilview \-l \-e=/Hubbard_Rob/Delta.sid \-f=comment\*(C'\fR .Sp Example #2: \f(CW\*(C`stilview \-l \-e=/Hubbard_Rob/Delta.sid \-t=1 \-f=title\*(C'\fR .Sp Example #3: \f(CW\*(C`stilview \-l \-e=/Hubbard_Rob/Delta.sid \-t=12 \-f=all \-s \-b\*(C'\fR .Sp Asks for one particular field in a \s-1STIL\s0 entry. Combined with the \-t option, these two options can retrieve any portion of a \s-1STIL\s0 entry, including a single field in a specific subtune's entry. Below is full and complete explanation of what the different possible combinations of the \-t and \-f options retrieve: .Sp \&\f(CW\*(C`\-t=0 \-f=all\*(C'\fR : All of the \s-1STIL\s0 entry is printed. .Sp \&\f(CW\*(C`\-t=0 \-f=comment\*(C'\fR : The file-global comment is printed. For single-tune entries that have nothing but a \s-1COMMENT\s0 field in them, this prints that \s-1COMMENT.\s0 For single-tune entries that have other fields in them, this prints nothing. (This is because single-tune entries with nothing but a \s-1COMMENT\s0 field are assumed to be file-global comments.) .Sp \&\f(CW\*(C`\-t=0 \-f=\*(C'\fR : Nothing is printed. This combination of these options is invalid. .Sp \&\f(CW\*(C`\-t= \-f=all\*(C'\fR : (Where x is anything but 0.) All fields from the portion of the \s-1STIL\s0 entry for the given tune number are printed. For single-tune entries, asking for \-t=1 \-f=all is equivalent to saying \-t=0 \-f=all, since by definition, the whole entry refers to only one tune. (However, specifying \-t with any other number than 1 will print nothing!) Note that if there's a file-global comment in the \s-1STIL\s0 entry (which also means that if a single-tune entry has nothing but a \s-1COMMENT\s0 field in it), that is \&\fBnot\fR printed with these combinations of options. .Sp \&\f(CW\*(C`\-t= \-f=\*(C'\fR : (Where x is anything but 0.) The specific field from the portion of the \s-1STIL\s0 entry for the given tune number is printed. For single-tune entries that have nothing but a \s-1COMMENT\s0 in them, this returns nothing. .Sp Of course, if the \s-1STIL\s0 entry or any portion of it asked with these options does not exist, STILView will print nothing. Also, unless otherwise specified with the \-o, \-s and \-b options, the section-global comment and the \s-1BUG\s0 entry of the given \s-1SID\s0 file will also get printed (provided they exist). .Sp In example #1, the file-global comment for /Hubbard_Rob/Delta.sid is printed, since \-t is not specified and is assumed to be 0. Also printed are the section\- global comment and the \s-1BUG\s0 entry for the same \s-1SID\s0 file (if they exist). In example #2, the \s-1TITLE\s0 field of the \s-1STIL\s0 entry for tune #1 of /Hubbard_Rob/Delta.sid is printed along with the section-global comment and the \s-1BUG\s0 entry for the same \s-1SID\s0 file (if they exist). In example #3, all of the \s-1STIL\s0 entry for tune #12 of /Hubbard_Rob/Delta.sid is printed, but nothing else. .IP "\fB\-i\fR" 4 .IX Item "-i" Default: \s-1NONE\s0 .Sp Example: \f(CW\*(C`stilview \-i\*(C'\fR .Sp Starts STILView in interactive mode, ignoring all other options specified on the command-line, except \-l, \-d and \-m. In interactive mode, you can look for \s-1STIL\s0 entries by typing them in. You will get prompted for the desired \s-1STIL\s0 entry (which has to be specified with an HVSC-relative pathname), for the tune number requested (which should be any non-negative number, but this is not enforced), and finally for the specific \s-1STIL\s0 field you want to retrieve. .IP "\fB\-l\fR=\fI\s-1HVSC\s0 base dir\fR" 4 .IX Item "-l=HVSC base dir" Default: The value of the \s-1HVSC_BASE\s0 environment variable .Sp Example #1: \f(CW\*(C`stilview \-l=C:\eMusic\eHVSC\e \-e=/Hubbard_Rob/Commando.sid\*(C'\fR .Sp Example #2: \f(CW\*(C`stilview \-l=../HVSC/ =\-e=/Hubbard_Rob/Commando.sid\*(C'\fR .Sp Example #3: \f(CW\*(C`stilview \-l \-e=/Hubbard_Rob/Commando.sid\*(C'\fR .Sp This is where you tell STILView where it can find the \s-1HVSC\s0 base directory (the path to the directory has to be specified in the form required by your operating system, eg. C:\eMusic\eHVSC under Windows, /home/lala/HVSC under \s-1UNIX\s0). STILView will then try to locate the \s-1STIL\s0.txt file in the /DOCUMENTS/ subdirectory of that directory. If this option is not specified (or if \-l is specified without a base directory), STILView will try to extract the path of the \s-1HVSC\s0 base directory from the \s-1HVSC_BASE\s0 environment variable. If that environment variable doesn't exist or is pointing to a location where there's no \s-1STIL\s0.txt file in a \s-1DOCUMENTS\s0 directory, STILView fails. If the \s-1HVSC_BASE\s0 environment variable exists and is valid, and this option is specified, the directory specified with this option is used as the \s-1HVSC\s0 base directory instead of the environment variable. .Sp In example #1 the \s-1HVSC\s0 base directory is located in C:\eMusic\eHVSC\e on the hard drive of a Windows \s-1PC,\s0 in example #2 it is located in the \s-1HVSC\s0 directory of the current directory's parent directory of a \&\s-1UNIX\s0 system. In example #3 the \s-1HVSC\s0 base directory is not specified with the option, so it is assumed that the \s-1HVSC_BASE\s0 environment variable contains the path to it. In reality, specifying the \-l option in example #3 is redundant, and can be omitted. .IP "\fB\-m\fR" 4 .IX Item "-m" Demo mode .Sp Default: \s-1NONE\s0 .Sp Example #1: \f(CW\*(C`stilview \-m\*(C'\fR .Sp Example #2: \f(CW\*(C`stilview \-e=/Hubbard_Rob/Commando.sid \-m \-i\*(C'\fR .Sp When specified, it prints out a whole bunch of things that a) test most of the functionality of STILView, and b) show what STILView is capable of retrieving from \s-1STIL.\s0 In example #1, the demo is printed with the \s-1STIL\s0 info coming from a default \s-1STIL\s0 entry, then STILView quits. In example #2, the demo is printed taking the \s-1STIL\s0 info from the specified \s-1STIL\s0 entry of /Hubbard_Rob/Commando.sid (instead of the default \s-1SID\s0 file), then interactive mode is entered. .IP "\fB\-o\fR" 4 .IX Item "-o" Do \fBnot\fR print \s-1STIL\s0 entries .Sp Default value: Not specified (ie. do print \s-1STIL\s0 entries) .Sp Example #1: \f(CW\*(C`stilview \-e=/Hubbard_Rob/Delta.sid \-o\*(C'\fR .Sp Example #2: \f(CW\*(C`stilview \-e=/Hubbard_Rob/Delta.sid \-o \-s\*(C'\fR .Sp When this option is specified, \s-1STIL\s0 entries will not be printed for the given \s-1SID\s0 tune (but section-global entries and \s-1BUG\s0 entries will be printed, provided they exist and other options did not turn their output off). At a minimum, the \-e option has to be specified for this option to work. Example #1 will print out the section-global comment and the \s-1BUG\s0 entry for /Hubbard_Rob/Delta.sid, example #2 will print out just the section-global comment for the same \s-1SID.\s0 .IP "\fB\-s\fR" 4 .IX Item "-s" Do \fBnot\fR print section-global comments .Sp Default value: Not specified (ie. do print section-global entries) .Sp Example: \f(CW\*(C`stilview \-e=/Hubbard_Rob/Delta.sid \-s\*(C'\fR .Sp When this option is specified, section-global entries will not be printed for the given \s-1SID\s0 tune. At a minimum, the \-e option has to be specified for this option to work. .IP "\fB\-t\fR=\fItune number\fR" 4 .IX Item "-t=tune number" Default value: 0 .Sp Example #1: \f(CW\*(C`stilview \-e=/Hubbard_Rob/Commando.sid \-t=0\*(C'\fR .Sp Example #2: \f(CW\*(C`stilview \-e=/Hubbard_Rob/Delta.sid \-t=1 \-f=title \-s \-b\*(C'\fR .Sp Example #3: \f(CW\*(C`stilview \-e=/Hubbard_Rob/Delta.sid \-t=12\*(C'\fR .Sp Asks for the portion of a \s-1STIL\s0 entry referring to one particular tune. If tune number 0 is given, it retrieves all of the entry. Combined with the \-f option, these two options can retrieve any portion of a \s-1STIL\s0 entry, including a single field in a specific subtune's entry. .Sp For further details about this option, see the explanation of the \&\-f option. .Sp Example #1 retrieves all of the \s-1STIL\s0 entry for /Hubbard_Rob/Commando.sid, including the section-global comment and the \s-1BUG\s0 entry (if any), but since the default value for this option is 0, it might as well be omitted in this example. Example #2 retrieves only the \s-1TITLE\s0 field of the first subtune's entry for /Hubbard_Rob/Delta.sid (and not the section\- global comment or the \&\s-1BUG\s0 entry), while example #3 retrieves all of the \s-1STIL\s0 entry for tune #12 of the same \s-1SID\s0 file (including the section-global comment and the \s-1BUG\s0 entry, if any). .IP "\fB\-v\fR" 4 .IX Item "-v" Print version numbers .Sp Default value: Not specified (ie. do *not* print version numbers) .Sp Example #1: \f(CW\*(C`stilview \-v\*(C'\fR .Sp Example #2: \f(CW\*(C`stilview \-e=/Hubbard_Rob/Commando.sid \-v\*(C'\fR .Sp When this option is specified, the version number of the STILView program and the version number of the \s-1STIL\s0.txt file used by it is printed out. In example #1 this is the only piece of info that gets printed on the screen, in example #2 the version numbers are printed out, then the \s-1STIL\s0 entry for /Hubbard_Rob/Commando.sid is also printed out. .SH "ENVIRONMENT" .IX Header "ENVIRONMENT" .IP "\fB\s-1HVSC_BASE\s0\fR" 4 .IX Item "HVSC_BASE" Specifies the location of the \s-1HVSC\s0 base directory. .SH "EXAMPLES" .IX Header "EXAMPLES" All of the examples below assume that the \s-1HVSC_BASE\s0 environment is set to a valid \s-1HVSC\s0 base directory (where the \fI\f(CI$HVSC_BASE\fI/DOCUMENTS/STIL.txt\fR and \fI\f(CI$HVSC_BASE\fI/DOCUMENTS/BUGlist.txt\fR files exist), and the examples also assume the presence of the following entries in these files: .PP .Vb 1 \& \-\-\- In STIL.txt \-\-\- \& \& /Hubbard_Rob/ \& COMMENT: All of these tunes have been confirmed by Hubbard to be his. People \& have often stolen Hubbard\*(Aqs routine causing some tunes to be falsely \& credited to him. \& \& /Hubbard_Rob/Action_Biker.sid \& COMMENT: "Action B was a very early game and very conservative in it\*(Aqs approach \& \- it was my idea of giving them what I thought they wanted, a simple \& cute tune....." (RH) \& \& /Hubbard_Rob/Commando.sid \& COMMENT: Tunes #1 and #3 have been converted from arcade version. \& \& /Hubbard_Rob/Delta.sid \& COMMENT: According to Hubbard, Kentilla and Delta were the most complicated one \& to compose, they took the longest time to do and they both drove him \& insane. \& (#1) \& TITLE: On the Run [from the Dark Side of the Moon] \& ARTIST: Pink Floyd \& COMMENT: It is more inspired by it than a remix of it. \& (#12) \& TITLE: Koyaanisqatsi [from the movie] \& ARTIST: Philip Glass \& COMMENT: "Inspired by Philip Glass and Pink Floyd." (RH) \& \& /Hubbard_Rob/International_Karate.sid \& TITLE: Merry Christmas, Mr. Lawrence [from the movie] (0:42\-1:16) \& ARTIST: Ryuichi Sakamoto \& COMMENT: "[...] I started exploring pentatonic things in B flat minor over \& different bass notes, B flat, D flat, G flat and A flat. The middle \& section went into F (I think) at double tempo to liven things up. I \& was pleased with the tune......" (RH) \& \& /Hubbard_Rob/Rasputin.sid \& (#1) \& TITLE: Katjusha (0:07\-0:36) \& ARTIST: Matvei Blanter, M. Isakovski \& TITLE: Katjusha (2:20) \& ARTIST: Matvei Blanter, M. Isakovski \& TITLE: Kaljinka (2:41\-2:51) \& ARTIST: Traditional \& COMMENT: Russian folk song. \& TITLE: Kaljinka (3:12\-3:22) \& ARTIST: Traditional \& COMMENT: Russian folk song. \& (#2) \& COMMENT: Russian folk song. \& \& \-\-\- In BUGlist.txt \-\-\- \& \& /Hubbard_Rob/Commando.sid \& BUG: This is just for demo. \& \& /Hubbard_Rob/Delta.sid \& (#12) \& BUG: Demo entry. .Ve .PP Given these entries, following are the printouts you can expect from STILView. ($> denotes a command-line prompt given by your operating system.) .PP Everything related to a \s-1SID\s0 file is printed: .PP .Vb 10 \& $> stilview \-e=/Hubbard_Rob/Commando.sid \& \-\-\-\- GLOBAL COMMENT \-\-\-\- \& COMMENT: All of these tunes have been confirmed by Hubbard to be his. People \& have often stolen Hubbard\*(Aqs routine causing some tunes to be falsely \& credited to him. \& \-\-\-\-\-\- STIL ENTRY \-\-\-\-\-\- \& COMMENT: Tunes #1 and #3 have been converted from arcade version. \& \-\-\-\-\-\-\-\-\-\- BUG \-\-\-\-\-\-\-\-\-\- \& BUG: This is just for demo. \& $> .Ve .PP Ask for just the section-global comment: .PP .Vb 6 \& $> stilview \-e=/Hubbard_Rob/ \& /Hubbard_Rob/ \& COMMENT: All of these tunes have been confirmed by Hubbard to be his. People \& have often stolen Hubbard\*(Aqs routine causing some tunes to be falsely \& credited to him. \& $> .Ve .PP Note that this can also be retrieved with: .PP .Vb 5 \& $> stilview \-e=/Hubbard_Rob/Commando.sid \-o \-b \& COMMENT: All of these tunes have been confirmed by Hubbard to be his. People \& have often stolen Hubbard\*(Aqs routine causing some tunes to be falsely \& credited to him. \& $> .Ve .PP This prints out nothing, as single-tune entries do not have file-global comments: .PP .Vb 2 \& $> stilview \-e=/Hubbard_Rob/International_Karate.sid \-t=0 \-f=comment \-s \-b \& $> .Ve .PP \&...Except if the only field in them is a \s-1COMMENT\s0 (in which case that comment is assumed to be a file-global comment): .PP .Vb 5 \& $> stilview \-e=/Hubbard_Rob/Action_Biker.sid \-t=0 \-f=comment \-s \-b \& COMMENT: "Action B was a very early game and very conservative in it\*(Aqs approach \& \- it was my idea of giving them what I thought they wanted, a simple \& cute tune....." (RH) \& $> .Ve .PP Also note that single-tune entries have only one tune, so asking for the \s-1STIL\s0 entry of tune #3 is pointless: .PP .Vb 2 \& $> stilview \-e=/Hubbard_Rob/International_Karate.sid \-t=3 \-s \-b \& $> .Ve .PP Print out the file-global comment for the given \s-1SID\s0 file: .PP .Vb 5 \& $> stilview \-e=/Hubbard_Rob/Delta.sid \-t=0 \-f=comment \-s \-b \& COMMENT: According to Hubbard, Kentilla and Delta were the most complicated one \& to compose, they took the longest time to do and they both drove him \& insane. \& $> .Ve .PP Print out the \s-1ARTIST\s0 field of tune #12 of the given \s-1SID\s0 file, plus print out everything else related to the \s-1SID\s0 file: .PP .Vb 10 \& $> stilview \-e=/Hubbard_Rob/Delta.sid \-t=12 \-f=artist \& \-\-\-\- GLOBAL COMMENT \-\-\-\- \& COMMENT: All of these tunes have been confirmed by Hubbard to be his. People \& have often stolen Hubbard\*(Aqs routine causing some tunes to be falsely \& credited to him. \& \-\-\-\-\-\- STIL ENTRY \-\-\-\-\-\- \& ARTIST: Philip Glass \& \-\-\-\-\-\-\-\-\-\- BUG \-\-\-\-\-\-\-\-\-\- \& BUG: Demo entry. \& $> .Ve .PP Note that the current version of STILView is capable to retrieve only the first specified field of a tune that covers multiple songs! See below: .PP .Vb 3 \& $> stilview \-e=/Hubbard_Rob/Rasputin.sid \-t=1 \-f=title \-s \& TITLE: Katjusha (0:07\-0:36) \& $> .Ve .PP Section-global comments are printed out even if the \s-1STIL\s0 entry for the given \s-1SID\s0 file does not exist: .PP .Vb 5 \& $> stilview \-e=/Hubbard_Rob/This_doesnt_exist.sid \& COMMENT: All of these tunes have been confirmed by Hubbard to be his. People \& have often stolen Hubbard\*(Aqs routine causing some tunes to be falsely \& credited to him. \& $> .Ve .PP The following 4 steps depict how to have STILView print out everything related to a given \s-1SID\s0 file's given tune number one by one: .PP 1) This prints out just the section-global comment: .PP .Vb 5 \& $> stilview \-e=/Hubbard_Rob/Delta.sid \-o \-b \& COMMENT: All of these tunes have been confirmed by Hubbard to be his. People \& have often stolen Hubbard\*(Aqs routine causing some tunes to be falsely \& credited to him. \& $> .Ve .PP 2) This prints out just the file-global comment: .PP .Vb 5 \& $> stilview \-e=/Hubbard_Rob/Delta.sid \-t=0 \-f=comment \-s \-b \& COMMENT: According to Hubbard, Kentilla and Delta were the most complicated one \& to compose, they took the longest time to do and they both drove him \& insane. \& $> .Ve .PP 3) This prints out all of the \s-1STIL\s0 entry for the given tune number: .PP .Vb 5 \& $> stilview \-e=/Hubbard_Rob/Delta.sid \-t=12 \-f=all \-s \-b \& TITLE: Koyaanisqatsi [from the movie] \& ARTIST: Philip Glass \& COMMENT: "Inspired by Philip Glass and Pink Floyd." (RH) \& $> .Ve .PP 4) And this prints out just the \s-1BUG\s0 entry for the same tune number: .PP .Vb 3 \& $> stilview \-e=/Hubbard_Rob/Delta.sid \-t=12 \-s \-o \& BUG: Demo entry. \& $> .Ve .PP The following 3 steps depict how to have STILView print out everything related to a given \s-1SID\s0 file: .PP 1) This prints out just the section-global comment: .PP .Vb 5 \& $> stilview \-e=/Hubbard_Rob/Delta.sid \-o \-b \& COMMENT: All of these tunes have been confirmed by Hubbard to be his. People \& have often stolen Hubbard\*(Aqs routine causing some tunes to be falsely \& credited to him. \& $> .Ve .PP 2) This prints out all of the \s-1STIL\s0 entry: .PP .Vb 10 \& $> stilview \-e=/Hubbard_Rob/Delta.sid \-s \-b \& COMMENT: "[...] The Delta music loader and ingame music was Gary Liddon\*(Aqs idea. \& [...] He was the producer at Thalamus at the time. He told Rob Hubbard \& to make the ingame music like the 2nd track from Dark Side of the Moon \& by Pink Floyd." (Info from Matt Furniss.) \& "The small jingles are all small clips from Sanxion and Romeo/Juliet \& music. They were all supposed to be for short stingers such as end of \& level, extra life etc..." \& "Delta was based on this minimalist composition technique inspired by \& Glass and a bit of Pink Floyd. It was quite hard too do and required \& some custom code to the driver to do it. The music was tedious to \& debug. The other Delta stuff was more conventional \- I quite liked the \& other tunes. Delta was spread over a 2 week period....." (RH) \& According to Hubbard, Kentilla and Delta were the most complicated one \& to compose, they took the longest time to do and they both drove him \& insane. \& (#1) \& TITLE: On the Run [from the Dark Side of the Moon] \& ARTIST: Pink Floyd \& COMMENT: It is more inspired by it than a remix of it. \& (#12) \& TITLE: Koyaanisqatsi [from the movie] \& ARTIST: Philip Glass \& COMMENT: "Inspired by Philip Glass and Pink Floyd." (RH) \& $> .Ve .PP 3) And this prints out all of the \s-1BUG\s0 entry: .PP .Vb 4 \& $> stilview \-e=/Hubbard_Rob/Delta.sid \-s \-o \& (#12) \& BUG: Demo entry. \& $> .Ve .SH "AUTHORS" .IX Header "AUTHORS" .IP "\fBLaLa\fR " 4 .IX Item "LaLa " Original author. .IP "\fBLeandro Nini\fR " 4 .IX Item "Leandro Nini " Current maintainer. .SH "RESOURCES" .IX Header "RESOURCES" .IP "Home page: " 4 .IX Item "Home page: " .PD 0 .IP "High Voltage Sid Collection (\s-1HVSC\s0): " 4 .IX Item "High Voltage Sid Collection (HVSC): " .PD .SH "COPYING" .IX Header "COPYING" .IP "Copyright (C) 1998, 2002 LaLa" 4 .IX Item "Copyright (C) 1998, 2002 LaLa" .PD 0 .IP "Copyright (C) 2012\-2017 Leandro Nini" 4 .IX Item "Copyright (C) 2012-2017 Leandro Nini" .PD .PP This program is free software; you can redistribute it and/or modify it under the terms of the \s-1GNU\s0 General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. .PP This program is distributed in the hope that it will be useful, but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of \&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the \&\s-1GNU\s0 General Public License for more details. .PP You should have received a copy of the \s-1GNU\s0 General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, \s-1MA\s0 02110\-1301, \s-1USA.\s0