File: appendix-local.xml

package info (click to toggle)
dh-ocaml 2.5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 352 kB
  • sloc: xml: 1,746; perl: 1,063; sh: 244; makefile: 105
file content (69 lines) | stat: -rw-r--r-- 2,577 bytes parent folder | download | duplicates (5)
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
<?xml version="1.0"?>
<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"/usr/share/sgml/docbook/dtd/xml/4.4/docbookx.dtd" [
<!ENTITY % included SYSTEM "included.ent">
%included;
]>

<appendix id="appendix">
  <title>Appendix</title>
  
  <section id="liblocal-path">
      <title>Locally installing OCaml programs and libraries</title>

      <para>
        Locally installed files are files that are installed directly by
        the system administrator, in contrast to files installed through Debian
        packages. Installation and use of locally installed OCaml related
        programs is out of the scope of this document. However, in order to
        have it work with a standard Debian installation, a local system
        administrator should follow these guidelines:
        <itemizedlist>
          <listitem>
            <para>
              Executable files should be installed
              in <filename>/usr/local/bin</filename>.
            </para>
          </listitem>
          <listitem>
            <para>
              Shared libraries (for C bindings) should be installed
              in <filename>/usr/local/lib/ocaml/stublibs/</filename>
            </para>
          </listitem>
          <listitem>
            <para>
              Basically, every other file should be installed
              in <filename>/usr/local/lib/ocaml/</filename>. This
              includes in particular bytecode libraries
              (<filename>*.cma</filename>), native libraries
              (<filename>*.cmxa</filename>), bytecode object files
              (<filename>*.cmo</filename>), native object files
              (<filename>*.cmx</filename>), native plugin object files 
              (<filename>*.cmxs</filename>), static libraries
              (<filename>*.a</filename>) and <filename>META</filename>
              files.
            </para>
          </listitem>
        </itemizedlist>
      </para>

      <para>
        The default configuration of <filename>ocamlfind</filename> (the OCaml
        library manager recommended in Debian) first looks for a local
        installation of libraries and then for libraries installed by Debian
        packages.
      </para>

      <warning>
        <para>
          The <varname>+</varname> preceding any library in the
          <option>-I</option> of <command>ocamlc</command> or
          <command>ocamlopt</command> won't be expanded to the local standard
          library path. You need to specify the path entirely.
        </para>
      </warning>

  </section>

</appendix>