/
INSTALL
177 lines (128 loc) · 6.98 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
---------------------------------------------------------------
| id3 mass tagger v0.81
-------------------------------------------------------------
the contents of the source distribution:
COPYING - license
INSTALL - ... ? :)
README - program documentation
CHANGES - changelog
makefile - generic (gnu) makefile
makefile.dj - makefile for djgpp2
makefile.bcc - makefile for borland c++
makefile.nmk - makefile for microsoft c++
main.cpp - main program file (C++)
id3-images.c - auxiliary program to extract album art (C)
pattern.* - + automatic variables (C++)
dumptag.* - + save/reading tag info (C++)
sedit.* - string formatting (C++)
set_base.h - abstract patch class (C++)
setid3.* - + id3v1 implementation (C++)
getid3.* - + id3v1 reader (C++)
setid3v2.* - + id3v2 implementation (C++)
getid3v2.* - + id3v2 reader (C++)
setlyr3.* - + lyrics3 implementation (C++)
getlyr3.* - + lyrics3 reader (C++)
setfname.* - + file renamer/handler (C++)
setquery.* - + stdout formatter (C++)
setgroup.h - + combiner (C++)
varexp.* - wildcard/pattern matching class (C++)
fileexp.* - filefinder/matcher (C++)
mass_tag.* - + tagging engine (C++)
charconv.* - character conversion (C++)
char_ucs.* - + utf16 encoding (C++)
char_utf8.* - + utf8 encoding (C++)
utf8.h - stand-alone utf8 encoder/decoder (C++)
auto_dir.h - smart dirent pointer class (C++)
id3v1.* - definitions & data relevant to ID3v1 tag data (C)
id3v2.* - basic ID3v2 reading/writing interface (C)
fileops.* - auxiliary file functions (C)
lyrics3.* - Lyrics3v2 interface (C++)
id3.man - raw man page (troff -man)
debian/ - Debian files for creating a .deb package
rpm/ - RPM specfile for creating a .rpm package
bash/ - definitions for bash auto-completion
---------------------------------------------------------------
| (c) squell 2003-2015 - copyright notice
-------------------------------------------------------------
All files in this package are copyrighted. This is NOT public domain software.
This software comes under a FreeBSD style license, which (in short) means you
can pretty much do with it as you please (including redistribution under
another license such as the GNU GPL), as long as copyright is acknowledged.
It also means you can't sue me if anything terrible happens.
For the actual licensing conditions you should read the file 'COPYING',
which should be included in this source distribution.
---------------------------------------------------------------
| building and installing using a package manager
-------------------------------------------------------------
Files are included for building packages for .deb and .rpm-based Linux
distributions, and FreeBSD. The package will identify itself as `id3mtag'.
* .deb (Debian/Ubuntu)
From the source tree, run:
> dpkg-buildpackage -b
This should create a .deb file in the parent directory.
* .rpm (Fedora/CentOS)
The simplest way is to simply run:
> rpmbuild -ta id3-0.80.tar.gz
Then look in your RPM build area ($HOME/rpmbuild)
* FreeBSD
Install audio/id3mtag from the ports collection.
---------------------------------------------------------------
| building and installing manually
-------------------------------------------------------------
Successfully compiled with (non-exhaustive list):
- GCC 4.x, 5.0
- Clang 3.x
- Microsoft C/C++ 16.x/18.x
- Borland/Embarcadero C++ 5.5/6.90
- Oracle/Sun C++ 5.13, using STLport4
- Intel C++ 14.0.2
This program is written to be portable, assuming at least a C90 and C++03
compiler and a POSIX:2001 environment. Compilation shouldn't be hard.
Notes for building under Windows:
* When using MSVC, the file 'dirent.h' is not included with the compiler. You
can use the open source replacement by Toni Ronkko, obtainable at
https://github.com/tronkko/dirent/
* With MinGW, you need to add LDFLAGS="-static-libgcc -static-libstdc++" to
the mingw32-make commandline if you want to execute the resulting binary
on a machine without MinGW installed.
Notes for building under MacOS:
* You will need to explicitly link with iconv; e.g. "make LDFLAGS=-liconv"
===
Makefiles
Pick the makefile you need and rename it to 'makefile' or use 'make -f':
'makefile' is meant for generic GNU/BSD systems. You can also use this
file for building with Cygwin or MinGW.
Please note that CFLAGS/CXXFLAGS/LDFLAGS set in your environment will
override the default (recommended) flags provided in this makefile.
'makefile.dj' is for DOS systems using DJGPP v2
'makefile.nmk' is for building a Win32 executable with VisualStudio `nmake'
'makefile.bcc' is for building a Win32 executable with C++Builder `make'
===
Standard makefile targets:
make - builds the program
make clean - removes all files produced by make
Generic GNU/BSD makefile targets & variables:
make install - installs the program
make install-strip - like install, but strips executable of debug info
make install-full - also installs the documentation in $(datadir)/doc
make uninstall - uninstall (does not remove documentation)
make bash_completion - installs the bash completion support
make help - lists all makefile targets and variables
Because id3 does not have a configure script (yet), you can set
these variables only on the 'make' commandline:
prefix - the prefix directory (def. "/usr/local")
bindir - dir for binaries (def. "$(prefix)/bin")
mandir - dir for manpages (def. "$(prefix)/man")
datadir - dir for shared files (def. "$(prefix)/share")
binary - the binary to install (def. "id3")
DESTDIR - used for staged installs (def. "")
E.g: "make install prefix=$HOME" to install in $HOME/bin instead. See inside
'makefile' or try `make help' for more details (and more variables).
---------------------------------------------------------------
| useful links
-------------------------------------------------------------
(Win32) Minimalist GNU for Windows:
http://www.mingw.org/
---------------------------------------------------------------
| contact: info@squell.net
-------------------------------------------------------------