--- /dev/null
+%.html: %.xml
+ xsltproc --nonet /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/html/docbook.xsl \
+ $^ > $@
+
+all: ocaml_packaging_policy.html
+
+clean:
+ $(RM) ocaml_packaging_policy.html
--- /dev/null
+-----------------------
+* *
+* HOWTO-XML *
+* DOCBOOK *
+* *
+* *
+-----------------------
+
+
+If you are interested in writing in the policy, you should
+take a look at
+
+http://docbook.sourceforge.net/
+http://www.oasis-open.org/docbook/documentation/reference/html/docbook.html
+
+When you finish write your part, just do a make clean && make all. It will result
+in having ocaml_packaging_policy.html...
+
+Sylvain LE GALL
+Sat, 18 October 2003
-<?xml version="1.0"?>
<author>
<firstname>Sven</firstname>
<surname>Luther</surname>
-<?xml version="1.0"?>
-
- <sect id="liblocal-camlp4">
+ <section id="liblocal-camlp4">
<title>Camlp4 files</title>
- </sect>
-
+ </section>
-<?xml version="1.0"?>
-
- <sect id="libpack-camlp4">
+ <section id="libpack-camlp4">
<title>Camlp4 files</title>
- </sect>
-
+ </section>
-<?xml version="1.0"?>
- <sect id="versions">
+ <section id="versions">
<title>Version</title>
<para>
At any given time, the package <application>ocaml</application>
same version of Ocaml.
</para>
- </sect>
+ </section>
- <sect id="base">
+ <section id="base">
<title>Base Package</title>
<para>
In order to have a minimal installation, a virtual package
incompatible changes made within the same version of Ocaml.
</para>
- </sect>
+ </section>
- <sect id="files">
+ <section id="files">
<title>File terminology for Ocaml packaging</title>
<para>
<para>
There is a convention considering that native executable should be
- called <var>progname</var>.opt and bytecoded one
- <var>progname</var>.byte. When packaging, only <var>progname</var> is
- taken in account.
+ called <application>progname</application>.opt and bytecoded one
+ <application>progname</application>.byte. When packaging, only
+ <application>progname</application> is taken in account.
</para>
<para>
For easying library management, the Ocaml Task Force used the
<application>ocamlfind</application> library management scheme.
- This scheme includes a file named <emph>META</emph> which holds
+ This scheme includes a file named <filename>META</filename> which holds
all the library possibility. This is the configuration file for
handling library ( see XXX ).
</para>
- </sect>
+ </section>
- <sect id="path">
+ <section id="path">
<title>Library paths</title>
<para>
Ocaml will search library in two different location, referred to
- as <var>local</var> which hold user installed library and as
- <var>core</var> in which packaged modules stood.
+ as <varname>local</varname> which hold user installed library and as
+ <varname>core</varname> in which packaged modules stood.
</para>
<para>
By default, ocaml will look for modules in this order :
<variablelist>
<varlistentry>
- <term><var>local</var></term>
- <listitem>
- /usr/local/lib/ocaml/<var>ocaml_version</var>/
- /usr/local/lib/ocaml/<var>ocaml_version</var>/
- </listitem>
- </sect>
+ <term><varname>local</varname></term>
+ <simplelist>
+ <listitem><filename>/usr/local/lib/ocaml/&ocaml-version;/</filename></listitem>
+ <listitem><filename>/usr/local/lib/ocaml/&ocaml-version;/</filename></listitem>
+ </simplelist>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </section>
- <sect id="documentation">
+ <section id="documentation">
<title>Documentation</title>
<para>
</para>
- </sect>
+ </section>
-<?xml version="1.0"?>
<copyright>
<year>2002</year><year>2003</year>
<holder>Sven LUTHER, Stefano ZACCHIROLI and Sylvain LE GALL</holder>
A copy of the GNU General Public License is available as
<tt>/usr/share/common-licenses/GPL</tt> in the Debian GNU/Linux
distribution or on the World Wide Web at
- <url id="http://www.gnu.org/copyleft/gpl.html"
- name="The GNU Public Licence">.
+ <ulink url="http://www.gnu.org/copyleft/gpl.html">The GNU Public Licence</ulink>.
</para>
<para>
You can also obtain it by writing to the
Boston, MA 02111-1307, USA.
</para>
</legalnotice>
-
+ </copyright>
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
- "dtd/docbook-xml/4.2/docbookx.dtd" [
-<!ENTITY ocaml-pkg "<application>ocaml-<var>upstream_version</var>-<var>package_compatibility</var></application>">
-<!ENTITY ocaml-base-pkg "<application>ocaml-base-<var>upstream_version</var>-<var>package_compatibility</var></application>">
-<!ENTITY authors SYSTEM authors.xml>
-<!ENTITY legal SYSTEM legal.xml>
-<!ENTITY chapter-ocaml SYSTEM chapter-ocaml.xml>
-<!ENTITY chapter-liblocal SYSTEM chapter-liblocal.xml>
-<!ENTITY chapter-libbpack SYSTEM chapter-libpack.xml>
-<!ENTITY chapter-progpack SYSTEM chapter-progpack.xml>
-<!ENTITY appendix-transition SYSTEM appendix-transition.xml>
-<!ENTITY appendix-resources SYSTEM appendix-resources.xml>
+ "/usr/share/sgml/docbook/dtd/xml/4.2/docbookx.dtd" [
+ <!ENTITY ocaml-version "3.07">
+ <!ENTITY ocaml-compat "1">
+ <!ENTITY ocaml-pkg "<application>ocaml-&ocaml-version;-&ocaml-compat;</application>">
+ <!ENTITY ocaml-base-pkg "<application>ocaml-base-&ocaml-version;-&ocaml-compat;</application>">
+ <!ENTITY authors SYSTEM "authors.xml">
+ <!ENTITY legal SYSTEM "legal.xml">
+ <!ENTITY chapter-ocaml SYSTEM "chapter-ocaml.xml">
+ <!ENTITY chapter-liblocal SYSTEM "chapter-liblocal.xml">
+ <!ENTITY chapter-libpack SYSTEM "chapter-libpack.xml">
+ <!ENTITY chapter-progpack SYSTEM "chapter-progpack.xml">
+ <!ENTITY appendix-transition SYSTEM "appendix-transition.xml">
+ <!ENTITY appendix-resources SYSTEM "appendix-resources.xml">
]>
<article>
<articleinfo>
<title>Debian Ocaml Policy</title>
- <subtitle>For Objective Caml version 3.06</subtitle>
+ <subtitle>For Objective Caml version &ocaml-version;</subtitle>
<releaseinfo>Revision 0.1</releaseinfo>
&authors;
&legal;
projects / ocaml.git / commitdiff