This file is indexed.

/usr/share/doc/liquidsoap/html/build.html is in liquidsoap 1.1.1-6ubuntu2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
<?xml version="1.0"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML \
1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
  <meta content="text/html; charset=UTF-8" http-equiv="content-type" />
  <title>Liquidsoap :: Build liquidsoap from source</title>
  <link href="css/style.css" type="text/css" rel="stylesheet" />
</head>
<body>
<div id="wrapper">
  <div id="header">
    <div id="logo">
      <h1>Liquidsoap</h1>
      <h2>audio stream generation</h2>
    </div>
  <div>
   <ul id="menu">
     <li id="menu-about">
       <a href="index.html">about</a></li>
     <li id="menu-doc-index">
       <a href="documentation.html">documentation</a></li>
     <li id="menu-doc-api">
       <a href="reference.html">API</a></li>
     <li id="menu-doc-snippets">
       <a href="scripts/index.html">snippets</a></li>
     <li id="menu-developers">
       <a href="https://github.com/savonet/liquidsoap/issues">developers</a></li>
   </ul>
  </div>
  </div>
  <div id="content"><div>
  <h3>Building liquidsoap from source</h3>
<p>
From every sub-project's directory (ocaml-vorbis, ocaml-dtools, liquidsoap, 
etc.) you can build using <code>./bootstrap</code>, <code>./configure</code>, 
<code>make</code> and optionally install using <code>make install</code>.
</p>
<p>
If you are using the <code>liquidsoap-full</code> tarball,
or the latest source code from our
<a href="https://github.com/savonet/liquidsoap-full">github repository</a>,
there is also a fast procedure for building liquidsoap
that doesn't require installing the libraries provided by Savonet.
The steps to follow are simple.
</p>
<p>
If you are using the git sources, you need to initialize all submodules
by invoking <code>make init</code>, <code>make update</code> and finally <code>./bootstrap</code>.
</p>
<p>
You should now choose which features you want to enable when building liquidsoap.
Each shipped feature can be enabled/disabled by editing the
<code>PACKAGE</code> file.
Depending on your version you might have to first copy 
<code>PACKAGES.default</code> to <code>PACKAGES</code>.
</p>
<p>
Then run the usual commands:
</p>
<pre class="syntax "># Configure all libraries and packages.
# You may pass extra options such as --enable-debugging,
# --prefix, --sysconfdir, --localstatedir, etc.
./configure

# Now, build all libraries and liquidsoap
make

# To install liquidsoap,
# you usually need to type the following as root
make install
</pre>
<h4>Dependencies</h4>
<p>
Here are liquidsoap's dependencies.
All OCaml libraries are distributed by Savonet, except when linked.
You may refer to the liquidsoap INSTALL file for required versions of the 
libraries:
</p>
<ul>
<li>
<a href="http://www.ocaml-programming.de/programming/findlib.html" target="_blank">ocamlfind</a></li>
<li>
ocaml-dtools (&gt;= 0.3.0)</li>
<li>
ocaml-duppy (&gt;= 0.4.2)</li>
<li>
ocaml-mm (&gt;= 0.2.1)</li>
<li>
<a href="http://www.ocaml.info/home/ocaml_sources.html" target="_blank">ocaml-pcre</a></li>
</ul>
<p>
And also optional dependencies. For most of these, you also need
the associated C/C++ library, which is usually provided by your distribution's
packaging system. You may as well need additional dependencies, such as <code>g++</code>, used
for building bindings built on top of C++ libraries, as marked below and possibly
also <code>libtool</code>.
</p>
<ul>
<li>
ocaml-ogg for ogg audio and video formats</li>
<li>
ocaml-vorbis for ogg/vorbis audio encoding and decoding</li>
<li>
ocaml-cry for Icecast/Shoutcast streaming</li>
<li>
ocaml-mad for mp3 decoding</li>
<li>
ocaml-lame for mp3 encoding</li>
<li>
ocaml-shine for fixed-point mp3 encoding</li>
<li>
ocaml-faac for AAC encoding</li>
<li>
ocaml-aacplus for AAC+ encoding</li>
<li>
ocaml-voaacenc for AAC decoding</li>
<li>
ocaml-fdkaac for AAC(+) encoding. Replacement candidate for both voaac and aacplus</li>
<li>
ocaml-flac for native flac and ogg/flac encoding/decoding</li>
<li>
ocaml-theora for ogg/theora encoding/decoding</li>
<li>
ocaml-schroedinger for ogg/dirac video encoding/decoding</li>
<li>
ocaml-gavl for video conversion</li>
<li>
ocaml-samplerate for audio samplerate conversion</li>
<li>
ocaml-taglib for MP3 audio tag reading (needs <code>g++</code>)</li>
<li>
ocaml-magic for file type detection. This library is very useful for reading mp3 files. If not enabled, liquidsoap may accept as mp3 files that do not contains mp3 data, such as jpeg pictures.</li>
<li>
ocaml-xmlplaylist for XML-based playlist formats</li>
<li>
ocaml-soundtouch for soundtouch audio effects (need <code>g++</code>)</li>
<li>
ocaml-lastfm and ocaml-xmllight for lastfm protocol support</li>
<li>
<a href="http://camomile.sourceforge.net/" target="_blank">camomile</a> for detecting metadata encoding and re-encoding them to utf8</li>
<li>
ocaml-alsa for ALSA input/output</li>
<li>
ocaml-ao for AO I/O</li>
<li>
ocaml-portaudio for Portaudio I/O</li>
<li>
ocaml-bjack for Jack output/input</li>
<li>
ocaml-ladspa for LADSPA plugins</li>
<li>
<a href="http://erratique.ch/software/xmlm" target="_blank">xmlm</a></li>
<li>
<a href="http://pauillac.inria.fr/camlimages/" target="_blank">camlimages</a> for image decoding</li>
<li>
<a href="http://ocamlsdl.sourceforge.net/home.html" target="_blank">ocaml-sdl</a> for display, font &amp; image support</li>
<li>
<a href="http://projects.snarc.org/ocaml-inotify" target="_blank">ocaml-inotify</a> to monitor file changes, in particular with playlists.</li>
</ul>
<p>
Runtime dependencies include:
</p>
<ul>
<li>
<a href="http://www.gnu.org/software/wget/" target="_blank">wget</a> for downloading remote files (http, https, ftp)</li>
<li>
<a href="http://www.cstr.ed.ac.uk/projects/festival/" target="_blank">festival</a> for speech synthesis (say)</li>
</ul>
<p>
And other that you'll find on the project page, or in liquidsoap-full tarball.
</p>
  </div></div>
  <div>
    <div id="footer"> 2003-2013 Savonet team</div>
  </div>
  </div>
</body></html>