Mercurial > hg > sidinfo

annotate README.txt @ 20:6058339ffe0e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update usage.
author Matti Hamalainen <ccr@tnsp.org>
date Thu, 25 Sep 2014 02:49:51 +0300
parents 46d21c77bbb1
children 8f2855f9300c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
2 Programmed and designed by Matti 'ccr' Hämäläinen
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
3 (C) Copyright 2014 Tecnic Software productions (TNSP)
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
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
7 -----------------------------------------------------------------------
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
8
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
9 Contact
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 IRC : ccr @ IRCNet, sometimes also Freenode
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
12 e-mail : ccr@tnsp.org
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
13
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
14 -----------------------------------------------------------------------
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
15
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
16 Requirements
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
17 ============
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
18 The compilation and usage of these utilities requires following
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
19 software packages or functional equivalents installed:
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
20
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
21 - GCC (4.x, older ones might work as well)
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
22 - GNU binutils
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
23 - GNU Make
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
24
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
25 For Linux -> Win32/64 cross-compilation I have used the standard
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
26 MinGW packages from Debian Testing (wheezy):
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
27
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
28 gcc-mingw-w64 mingw-w64-i686-dev mingw-w64-x86-64-dev
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
29
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
30 Some of those require a bit of poking to get working properly, YMMV.
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
31
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
32 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
33
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
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
36 How to build
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
37 ============
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
38 0) Possibly edit Makefile / Makefile.w32
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
39
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
40 1) $ gmake
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
41 or, if cross-compiling to Win32 via MinGW
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
42 $ gmake -f Makefile.w32
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
43
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
44 2) ???
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
45
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
46 3) If it works -> Happy fun times \:D\
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
47
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
48 -----------------------------------------------------------------------
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
49
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
50 Usage
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
51 =====
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
52
17
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
53 $ ./sidinfo /misc/C64Music/MUSICIANS/J/Jeff/Anal_ogue.sid
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
54 Filename : /misc/C64Music/MUSICIANS/J/Jeff/Anal_ogue.sid
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
55 Type : PSID
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
56 Version : 2.0
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
57 Data offset : 124
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
58 Data size : 7154
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
59 Load address : 0
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
60 Init address : 4017
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
61 Play address : 4027
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
62 Songs : 1
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
63 Start song : 1
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
64 Name : Anal'ogue
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
65 Author : Søren Lund (Jeff)
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
66 Copyright : 1996 Jeff
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
67 Hash : 6d5b7f0ff092e55abf27c37c8bc3fc64
11
20bcf214b282 Add some "documentation" and a license.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
68
17
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
69
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
70 $ ./sidinfo /misc/C64Music/MUSICIANS/J/Jeff/Anal_ogue.sid -p -x
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
71 Filename=/misc/C64Music/MUSICIANS/J/Jeff/Anal_ogue.sid
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
72 Type=PSID
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
73 Version=2.0
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
74 DataOffs=$0000007c
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
75 DataSize=$00001bf2
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
76 LoadAddr=$0000
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
77 InitAddr=$0fb1
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
78 PlayAddr=$0fbb
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
79 Songs=$0001
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
80 StartSong=$0001
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
81 Name=Anal'ogue
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
82 Author=Søren Lund (Jeff)
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
83 Copyright=1996 Jeff
46d21c77bbb1 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 11
diff changeset
84 Hash=6d5b7f0ff092e55abf27c37c8bc3fc64