File: INSTALL

package info (click to toggle)
libquvi 0.4.1-1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 1,980 kB
  • sloc: sh: 11,634; ansic: 2,978; makefile: 115
file content (76 lines) | stat: -rw-r--r-- 2,799 bytes parent folder | download | duplicates (2)
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


Prerequisites
=============

  * libquvi-scripts   0.4.0+      <http://quvi.sourceforge.net/>
  * libcurl           7.18.2+     <http://curl.haxx.se/>
  * libiconv          1.12.0+     <http://www.gnu.org/software/libiconv/>
  * (lib)lua          5.1+        <http://lua.org/>


Installation from source
========================

REMINDER: Run "make uninstall" if you have installed libquvi from the
source previously.

  * How to use GNU Autotools build system falls outside of the scope of
  this documentation, refer to the appropriate sources instead

  * IF you are unsure, THEN do not install from the source
    - libquvi is available to many distros as a precompiled package

    - Precompiled packages (ideally) make sure that no old files are
      left behind when the software is upgraded or uninstalled

    - Any old files left behind on your system may potentially interfere
      with the new version of libquvi

  * Consider yourself reminded

"./configure && make install", typically. See also "./configure --help".
If you are compiling libquvi from the development code from the git
repository, see "Installation from development code", instead.

  --with-examples         Build examples which are not compiled by default,
                            No real value to the users, developers
                            may want to use this switch

  --with-soup             Build with libsoup(-gnome) examples
                            Required *only* by examples/callback_libsoup.c,
                            ignored unless both --with-examples and
                            --with-soup are used. No real value to the
                            users, recommended for developers only

  --with-nd-output =arg   Where arg can be either "HTML" or "FramedHTML"
                            May be used to define the output format
                            for the API documentation produced by
                            NaturalDocs

  --without-manual        Do not install manual page(s)


Installation from development code
==================================

If you are compiling libquvi from the development code, run "autogen.sh",
first. This generates the configuration files that are not in the git
repository. You will need:

  * GNU Autotools (autoconf, automake, etc.)
  * GNU libiconv (for AM_ICONV macro, in configure.ac)

Once the files have been generated, follow the instructions in "Installation
from source" above.


API documentation
=================

"make doc" generates the C API reference documentation from the
NaturalDocs tags. The same documentation is available at:
  <http://quvi.sourceforge.net/>

The documentation is *not* installed with libquvi. Additional make target
"make distdoc" exists that creates a tarball from the generated HTML.