sidinfo: README.txt annotate

annotate README.txt @ 367:f73270cabde2

Bump copyright years.

author	Matti Hamalainen <ccr@tnsp.org>
date	Sat, 02 Jan 2021 11:37:13 +0200
parents	339680ca9a29
children	078a25cd67d8

rev	line source
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	1 SIDInfo - PSID/RSID information displayer
119 431aa2c00c45 UTF-8. Matti Hamalainen <ccr@tnsp.org> parents: 96 diff changeset	2 Programmed and designed by Matti 'ccr' Hämäläinen
367 f73270cabde2 Bump copyright years. Matti Hamalainen <ccr@tnsp.org> parents: 366 diff changeset	3 (C) Copyright 2014-2021 Tecnic Software productions (TNSP)
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	4
20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	5 See COPYING for license information.
20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	6
248 a8605886579d Adjust README. Matti Hamalainen <ccr@tnsp.org> parents: 233 diff changeset	7 For contacting the author, e-mail is preferred: ccr@tnsp.org
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	8
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	9 =======================================================================
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	10
20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	11 Requirements
20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	12 ============
20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	13 The compilation and usage of these utilities requires following
20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	14 software packages or functional equivalents installed:
20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	15
233 b634952372f1 Update README a bit. Matti Hamalainen <ccr@tnsp.org> parents: 214 diff changeset	16 - GCC or some other C99 compatible C compiler like Clang.
366 339680ca9a29 Cosmetic. Matti Hamalainen <ccr@tnsp.org> parents: 354 diff changeset	17
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	18 - GNU Make
153 e3be2ae6120e Delete trailing whitespace. Matti Hamalainen <ccr@tnsp.org> parents: 152 diff changeset	19
43 b9b56b4b0592 Update instructions. Matti Hamalainen <ccr@tnsp.org> parents: 40 diff changeset	20 - th-libs library (included in the tar/zip packages,
b9b56b4b0592 Update instructions. Matti Hamalainen <ccr@tnsp.org> parents: 40 diff changeset	21 for building from mercurial repo, see "how to build")
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	22
157 8fc887cb56d0 Implement iconv support for converting from PSID de-facto latin-1/ISO-8859-* Matti Hamalainen <ccr@tnsp.org> parents: 153 diff changeset	23 - libiconv (optional, for converting ISO-8859/Latin-1 encoded
8fc887cb56d0 Implement iconv support for converting from PSID de-facto latin-1/ISO-8859-* Matti Hamalainen <ccr@tnsp.org> parents: 153 diff changeset	24 text used in HVSC SID files and STIL database to whatever
8fc887cb56d0 Implement iconv support for converting from PSID de-facto latin-1/ISO-8859-* Matti Hamalainen <ccr@tnsp.org> parents: 153 diff changeset	25 character set your system is using, like UTF-8.)
8fc887cb56d0 Implement iconv support for converting from PSID de-facto latin-1/ISO-8859-* Matti Hamalainen <ccr@tnsp.org> parents: 153 diff changeset	26
8fc887cb56d0 Implement iconv support for converting from PSID de-facto latin-1/ISO-8859-* Matti Hamalainen <ccr@tnsp.org> parents: 153 diff changeset	27
233 b634952372f1 Update README a bit. Matti Hamalainen <ccr@tnsp.org> parents: 214 diff changeset	28 For Linux -> Win32/64 cross-compilation I have used the MinGW packages
b634952372f1 Update README a bit. Matti Hamalainen <ccr@tnsp.org> parents: 214 diff changeset	29 from Debian Testing (wheezy), installable via "apt-get mingw-w64".
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	30
20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	31 Please don't ask me for help to get cross-compilation working.
20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	32
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	33 =======================================================================
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	34
20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	35 How to build
20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	36 ============
30 8f2855f9300c Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 17 diff changeset	37 0) If building from Mercurial repo, you need th-libs:
8f2855f9300c Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 17 diff changeset	38
295 887b67891105 Refer to https:// URL instead of http:// Matti Hamalainen <ccr@tnsp.org> parents: 290 diff changeset	39 $ hg clone https://tnsp.org/hg/th-libs
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	40
354 0e818307e90b Update README for the changes in MiNGW cross-build Makefiles. Matti Hamalainen <ccr@tnsp.org> parents: 325 diff changeset	41 1) Possibly edit Makefile / Makefile.cross-mingw
30 8f2855f9300c Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 17 diff changeset	42
76 ed63d30669f6 s/gmake/make/g Matti Hamalainen <ccr@tnsp.org> parents: 73 diff changeset	43 2) $ make
30 8f2855f9300c Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 17 diff changeset	44
354 0e818307e90b Update README for the changes in MiNGW cross-build Makefiles. Matti Hamalainen <ccr@tnsp.org> parents: 325 diff changeset	45 or, if cross-compiling to Win 32/64 via MinGW
30 8f2855f9300c Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 17 diff changeset	46
354 0e818307e90b Update README for the changes in MiNGW cross-build Makefiles. Matti Hamalainen <ccr@tnsp.org> parents: 325 diff changeset	47 $ make -f Makefile.cross-mingw MINGW=32
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	48
30 8f2855f9300c Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 17 diff changeset	49 3) ???
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	50
30 8f2855f9300c Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 17 diff changeset	51 4) If it works -> Happy fun times \:D\
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	52
96 b6bf182bd37f Add line about 'make install'. Matti Hamalainen <ccr@tnsp.org> parents: 76 diff changeset	53 5) sudo make install
b6bf182bd37f Add line about 'make install'. Matti Hamalainen <ccr@tnsp.org> parents: 76 diff changeset	54
284 5dfe7846e902 Document the support of "HVSC_BASE" environment variable. Matti Hamalainen <ccr@tnsp.org> parents: 282 diff changeset	55 6) Optionally set "HVSC_BASE" environment variable
5dfe7846e902 Document the support of "HVSC_BASE" environment variable. Matti Hamalainen <ccr@tnsp.org> parents: 282 diff changeset	56 somewhere to point to your HVSC root directory
5dfe7846e902 Document the support of "HVSC_BASE" environment variable. Matti Hamalainen <ccr@tnsp.org> parents: 282 diff changeset	57 aka "/somewhere/C64Music", so you don't need to
5dfe7846e902 Document the support of "HVSC_BASE" environment variable. Matti Hamalainen <ccr@tnsp.org> parents: 282 diff changeset	58 specify it via the -H option. This way sidinfo
5dfe7846e902 Document the support of "HVSC_BASE" environment variable. Matti Hamalainen <ccr@tnsp.org> parents: 282 diff changeset	59 will use the song length database and STIL
5dfe7846e902 Document the support of "HVSC_BASE" environment variable. Matti Hamalainen <ccr@tnsp.org> parents: 282 diff changeset	60 database from HVSC.
5dfe7846e902 Document the support of "HVSC_BASE" environment variable. Matti Hamalainen <ccr@tnsp.org> parents: 282 diff changeset	61
5dfe7846e902 Document the support of "HVSC_BASE" environment variable. Matti Hamalainen <ccr@tnsp.org> parents: 282 diff changeset	62 (This setting is also used by some other SID-
5dfe7846e902 Document the support of "HVSC_BASE" environment variable. Matti Hamalainen <ccr@tnsp.org> parents: 282 diff changeset	63 related utilities such as stilview and sidplayfp.)
5dfe7846e902 Document the support of "HVSC_BASE" environment variable. Matti Hamalainen <ccr@tnsp.org> parents: 282 diff changeset	64
96 b6bf182bd37f Add line about 'make install'. Matti Hamalainen <ccr@tnsp.org> parents: 76 diff changeset	65
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	66 =======================================================================
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	67
20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	68 Usage
20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	69 =====
40 eabee1428b0a Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 30 diff changeset	70 For more information about options, see 'sidinfo --help'.
eabee1428b0a Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 30 diff changeset	71
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	72 --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	73
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	74
193 ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	75 Display all information about one file in "entry per row" format:
ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	76
153 e3be2ae6120e Delete trailing whitespace. Matti Hamalainen <ccr@tnsp.org> parents: 152 diff changeset	77 $ sidinfo /misc/C64Music/MUSICIANS/J/Jeff/Anal_ogue.sid
17 46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	78 Filename : /misc/C64Music/MUSICIANS/J/Jeff/Anal_ogue.sid
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	79 Type : PSID
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	80 Version : 2.0
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	81 Data offset : 124
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	82 Data size : 7154
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	83 Load address : 0
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	84 Init address : 4017
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	85 Play address : 4027
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	86 Songs : 1
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	87 Start song : 1
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	88 Name : Anal'ogue
119 431aa2c00c45 UTF-8. Matti Hamalainen <ccr@tnsp.org> parents: 96 diff changeset	89 Author : Søren Lund (Jeff)
17 46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	90 Copyright : 1996 Jeff
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	91 Hash : 6d5b7f0ff092e55abf27c37c8bc3fc64
11 20bcf214b282 Add some "documentation" and a license. Matti Hamalainen <ccr@tnsp.org> parents: diff changeset	92
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	93 --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
17 46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	94
193 ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	95 Display in "parseable" INI-style format, with hexadecimal values:
ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	96
67 b114164d9ed9 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 65 diff changeset	97 $ sidinfo /misc/C64Music/MUSICIANS/J/Jeff/Anal_ogue.sid -p -x
17 46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	98 Filename=/misc/C64Music/MUSICIANS/J/Jeff/Anal_ogue.sid
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	99 Type=PSID
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	100 Version=2.0
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	101 DataOffs=$0000007c
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	102 DataSize=$00001bf2
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	103 LoadAddr=$0000
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	104 InitAddr=$0fb1
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	105 PlayAddr=$0fbb
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	106 Songs=$0001
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	107 StartSong=$0001
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	108 Name=Anal'ogue
119 431aa2c00c45 UTF-8. Matti Hamalainen <ccr@tnsp.org> parents: 96 diff changeset	109 Author=Søren Lund (Jeff)
17 46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	110 Copyright=1996 Jeff
46d21c77bbb1 Update documentation. Matti Hamalainen <ccr@tnsp.org> parents: 11 diff changeset	111 Hash=6d5b7f0ff092e55abf27c37c8bc3fc64
40 eabee1428b0a Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 30 diff changeset	112
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	113 --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
40 eabee1428b0a Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 30 diff changeset	114
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	115 One-line format with "\|" (pipe character) as a field separator, and
d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	116 also specify which fields are to be included:
193 ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	117
153 e3be2ae6120e Delete trailing whitespace. Matti Hamalainen <ccr@tnsp.org> parents: 152 diff changeset	118 $ sidinfo -l \\| -f type,ver,hash,name,author,copyright Anal_ogue.sid
194 05e2332070a7 Fix some typos and cleanup. Matti Hamalainen <ccr@tnsp.org> parents: 193 diff changeset	119
119 431aa2c00c45 UTF-8. Matti Hamalainen <ccr@tnsp.org> parents: 96 diff changeset	120 PSID\|2.0\|Anal'ogue\|Søren Lund (Jeff)\|1996 Jeff\|6d5b7f0ff092e55abf27c37c8bc3fc64\|
40 eabee1428b0a Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 30 diff changeset	121
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	122 --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
40 eabee1428b0a Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 30 diff changeset	123
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	124 By using the format string functionality you can control the output
d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	125 format very specifically:
67 b114164d9ed9 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 65 diff changeset	126
b114164d9ed9 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 65 diff changeset	127 $ sidinfo Anal_ogue.sid -F 'NAME="@name@"\nHASH=@hash@\n'
194 05e2332070a7 Fix some typos and cleanup. Matti Hamalainen <ccr@tnsp.org> parents: 193 diff changeset	128
64 2bf85a700e23 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 43 diff changeset	129 NAME="Anal'ogue"
2bf85a700e23 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 43 diff changeset	130 HASH=6d5b7f0ff092e55abf27c37c8bc3fc64
152 44e1c1555d87 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 136 diff changeset	131
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	132 --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
152 44e1c1555d87 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 136 diff changeset	133
193 ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	134 You could, for example create SQL INSERT statements:
ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	135
ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	136 $ sidinfo Anal_ogue.sid -e\' -F "INSERT INTO sometable (filename,name,author) VALUES ('@filename@', '@name@', '@author@', '@copyright@')\n"
ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	137
ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	138 INSERT INTO sometable (filename,name,author) VALUES ('./Anal_ogue.sid', 'Anal\'ogue', 'Søren Lund (Jeff)', '1996 Jeff')
ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	139
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	140 --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
193 ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	141
152 44e1c1555d87 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 136 diff changeset	142 Furthermore, you can use "printf"-style format specifiers for
44e1c1555d87 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 136 diff changeset	143 formatting each @field@, see this example:
44e1c1555d87 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 136 diff changeset	144
44e1c1555d87 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 136 diff changeset	145 $ sidinfo Anal_ogue.sid -F 'NAME=@name:"%-64s"@\nHASH=@hash:"%64s"@\nLOAD_ADDR=@loadaddr:$%04x@\n'
44e1c1555d87 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 136 diff changeset	146 NAME="Anal'ogue "
44e1c1555d87 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 136 diff changeset	147 HASH=" 6d5b7f0ff092e55abf27c37c8bc3fc64"
44e1c1555d87 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 136 diff changeset	148 LOAD_ADDR=$0fb0
44e1c1555d87 Update documentation a bit. Matti Hamalainen <ccr@tnsp.org> parents: 136 diff changeset	149
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	150 Many of the standard C-style printf() format specifiers are supported,
d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	151 but not all, and obviously only integer/string formats are supported.
193 ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	152
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	153 --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
193 ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	154
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	155 Since sidinfo v0.7.6 it is also possible to automatically scan and
d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	156 recurse directories via '-R' option, for example:
193 ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	157
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	158 $ sidinfo -R "/misc/C64Music/*.sid"
193 ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	159
194 05e2332070a7 Fix some typos and cleanup. Matti Hamalainen <ccr@tnsp.org> parents: 193 diff changeset	160 The above will start from /misc/C64Music/ and scan any accessible
05e2332070a7 Fix some typos and cleanup. Matti Hamalainen <ccr@tnsp.org> parents: 193 diff changeset	161 subdirectories for files that match "*.sid" pattern and handle them.
193 ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	162
ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	163 Using previous example about SQL inserts:
ef646bacfa99 Update examples. Matti Hamalainen <ccr@tnsp.org> parents: 169 diff changeset	164
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	165 $ sidinfo -R "/misc/C64Music/*.sid" -e\' -F "INSERT INTO sometable (filename,name,author) VALUES ('@filename@', '@name@', '@author@', '@copyright@')\n"
194 05e2332070a7 Fix some typos and cleanup. Matti Hamalainen <ccr@tnsp.org> parents: 193 diff changeset	166
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	167 --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
282 5936a3dc9755 Document the STIL related issues of -F formatting with few words. Matti Hamalainen <ccr@tnsp.org> parents: 248 diff changeset	168
325 d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	169 SIDInfo 0.9 adds support for the HVSC STIL database. Unfortunately
d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	170 controlling the output of STIL information in the "-F" format string
d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	171 option is quite limited, as all fields will be concatenated into
d056f284184b Improvements to the README. Matti Hamalainen <ccr@tnsp.org> parents: 295 diff changeset	172 one long string field.
282 5936a3dc9755 Document the STIL related issues of -F formatting with few words. Matti Hamalainen <ccr@tnsp.org> parents: 248 diff changeset	173
290 4686ea0b6851 Minor typographic and grammatic improvements. Matti Hamalainen <ccr@tnsp.org> parents: 284 diff changeset	174 You can change the field separator by specifying the "-l" option and
4686ea0b6851 Minor typographic and grammatic improvements. Matti Hamalainen <ccr@tnsp.org> parents: 284 diff changeset	175 also optionally omit the STIL field names by using the "-n" option.
282 5936a3dc9755 Document the STIL related issues of -F formatting with few words. Matti Hamalainen <ccr@tnsp.org> parents: 248 diff changeset	176

Mercurial > hg > sidinfo

annotate README.txt @ 367:f73270cabde2