This repository has been archived by the owner on Jan 9, 2019. It is now read-only.
/
README
188 lines (119 loc) · 4.66 KB
/
README
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
177
178
179
180
181
182
183
184
185
186
187
188
Vicare/SQLite
=============
Topics
------
1. Introduction
2. License
3. Install
4. Usage
A. Credits
B. Bugs
C. Resources
1. Introduction
---------------
This package is a distribution of C and Scheme libraries for Vicare
Scheme, an R6RS compliant Scheme implementation; it provides bindings
for the SQLite SQL database engine.
The last time the maintainer bothered to update this paragraph, he had
tested SQLite Autoconf version 3.8.10.
This package makes use of the GNU Autotools.
2. License
----------
Copyright (c) 2012, 2013, 2015 Marco Maggi <marco.maggi-ipsu@poste.it>
This program is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program. If not, see <http://www.gnu.org/licenses/>.
3. Install
----------
Before installing Vicare/SQLite make sure to have a correctly installed
SQLite library and Vicare Scheme.
To install Vicare/SQLite from a proper release tarball, we must unpack
the archive then do:
$ cd vicare-sqlite-0.4.0
$ mkdir build
$ cd build
$ ../configure
$ make
$ make check
$ make install
notice that the "configure" script is prepared to enable shared
libraries and disable static libraries: this must not be changed,
because the package is meant to install a C shared library to be
dynamically loaded.
The Makefile is designed to allow parallel builds, so we can do:
$ make -j4 all && make -j4 check
which, on a 4-core CPU, should speed up building and checking
significantly.
To test what a rule will do use the "-n" option; example:
$ make install -n
The "Makefile" supports the "DESTDIR" environment variable to install
the files under a temporary location; example:
$ make install DESTDIR=/tmp/vicare-sqlite
If, instead, we have checked out a revision from the repository, we
will have to first build the infrastructure running a script from the
top source directory:
$ cd vicare-sqlite
$ sh autogen.sh
notice that "autogen.sh" will run the programs "autoreconf" and
"libtoolize"; the latter is selected through the environment variable
"LIBTOOLIZE", whose value can be customised; for example to run
"glibtoolize" rather than "libtoolize" we do:
$ LIBTOOLIZE=glibtoolize sh autogen.sh
After this the procedure is the same as the one for building from a
proper release tarball, but we have to enable maintainer mode:
$ ../configure --enable-maintainer-mode [options]
$ make
$ make check
$ make install
Libraries are installed under the directory:
$(libdir)/vicare-scheme
on 32-bit platforms we should arrange such library to be:
$(prefix)/lib/vicare-scheme
on 64-bit platforms we should arrange such library to be:
$(prefix)/lib64/vicare-scheme
The variable VFLAGS is available to the user when running "configure"
and "make" to add command line options to the execution of "vicare" when
compiling libraries and running tests; for example:
$ make VFLAGS="-g -O2 --option print-loaded-libraries"
4. Usage
--------
Read the documentation.
A. Credits
----------
Vicare/SQLite was written by Marco Maggi. Vicare Scheme is an R6RS
compliant fork of Ikarus Scheme; originally created by Abdulaziz
Ghuloum, it is now maintained by Marco Maggi.
The main author and architect of SQLite is Dr. Richard Hipp.
B. Bugs
-------
Bug reports are appreciated. Register issues at the Vicare/SQLite issue
tracker:
<http://github.com/marcomaggi/vicare-sqlite/issues>
C. Resources
------------
The documentation of Vicare/SQLite is available online:
<http://marcomaggi.github.com/docs/vicare-sqlite.html>
the latest version of this package can be downloaded from:
<https://bitbucket.org/marcomaggi/vicare-sqlite/downloads>
development takes place at:
<http://github.com/marcomaggi/vicare-sqlite/>
and as backup at:
<https://bitbucket.org/marcomaggi/vicare-sqlite/>
the home page of the Vicare project is at:
<http://marcomaggi.github.io/vicare.html>
SQLite can be found here:
<http://www.sqlite.org/>
### end of file
# Local Variables:
# mode: text
# coding: utf-8-unix
# fill-column: 72
# paragraph-start: "*"
# End: