debian/MANIFEST
-debian/README.Debian
+debian/OCaml_for_Debian
debian/README.source
debian/TODO.Debian
debian/changelog
debian/man/ocamlmklib.1
debian/man/ocamlobjinfo.1
debian/native-archs
-debian/ocaml-base-nox.README.Debian
debian/ocaml-base-nox.dirs.in
debian/ocaml-base-nox.docs
debian/ocaml-base-nox.install.in
--- /dev/null
+OCaml for Debian
+----------------
+
+ 1) The OCaml package has been split into different binary packages:
+
+ o ocaml: contains the full OCaml suite
+ o ocaml-nox: the full suite except for the Graphics and Tk modules
+ o ocaml-base: contains the runtime stuff (ocamlrun + dlls + Tk)
+ o ocaml-base-nox: contains the runtime stuff (ocamlrun + dlls - Tk)
+
+ o ocaml-compiler-libs: contains several modules used internally by
+ the OCaml compilers. They are not needed for normal OCaml
+ development, but may be helpful in the development of certain
+ applications.
+ o ocaml-source: contains the full OCaml source for the (few) packages which
+ need them at build time or for personal use (it should _not_ be used to
+ build OCaml itself).
+
+ o ocaml-mode: contains a major mode for editing OCaml files in Emacs.
+
+ 2) The caml include files are found under /usr/lib/ocaml/<ocaml_version>/caml.
+ A symlink is provided from /usr/include/caml for convenience. If
+ /usr/include/caml was previously a directory, for whatever reason, a warning
+ will be issued and the file moved to /usr/include/caml.bad. This can be
+ safely erased later on.
+
+ 3) User-installed stuff should not go under /usr/lib/ocaml/<ocaml_version>,
+ but rather under /usr/local/lib/ocaml/<ocaml_version>.
+ We will take no responsibility for people who break this rule and mess things
+ up.
+
+ 4) Starting from OCaml 3.05, all dll.so files are now put into a common
+ stublibs directory, so the ocaml-ldconf tool for handling the ld.conf
+ file is not needed anymore, but we will still keep it around until all
+ libraries are ported. As of OCaml 3.08, ocaml-ldconf is now deprecated
+ and not available anymore.
+ Notice that user-installed dll.so files should go into
+ /usr/local/lib/ocaml/<ocaml_version>/stublibs which is searched before
+ /usr/lib/ocaml/<ocaml_version>/stublibs.
+
+ -- Ralf Treinen <treinen@debian.org>, Fri, 15 Jul 2016 22:08:59 +0200
+
+ocamldoc's LaTeX output
+-----------------------
+
+ocamldoc can generated documentation in LaTeX format which can be later on
+compiled using a LaTeX environment. The LaTeX sources generated by ocamldoc
+exploits the fullpage.sty style, which is not included in a default texlive
+installation (the Debian LaTeX environment of choice).
+
+In order to be able to compile ocamldoc generated LaTeX sources you will need
+to install the "texlive-latex-extra" package.
+
+ -- Stefano Zacchiroli <zack@debian.org> Sun, 02 Sep 2007 18:22:14 +0200
+
+Debug information produced by ocamlc
+====================================
+
+In upstream OCaml, “ocamlc -custom” produces executables that cannot
+be stripped (more precisely, the bytecode, which is not part of the
+ELF data, is removed by strip). This Debian version is patched (and
+the patch has been rejected by upstream [1], but is available
+separately in debian/patches) so that the bytecode is embedded in the
+executable and can be stripped. This new behaviour is optional, and
+can be enabled by setting the OCAML_CUSTOM_EMBED environment variable
+to “y”.
+
+[1] http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=49;bug=256900
+
+ -- Stéphane Glondu <glondu@debian.org>, Tue, 26 Jun 2012 07:27:05 +0200
+++ /dev/null
-OCaml Debian package
-====================
-
-In upstream OCaml, “ocamlc -custom” produces executables that cannot
-be stripped (more precisely, the bytecode, which is not part of the
-ELF data, is removed by strip). This Debian version is patched (and
-the patch has been rejected by upstream [1], but is available
-separately in debian/patches) so that the bytecode is embedded in the
-executable and can be stripped. This new behaviour is optional, and
-can be enabled by setting the OCAML_CUSTOM_EMBED environment variable
-to “y”.
-
-[1] http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=49;bug=256900
-
- -- Stéphane Glondu <glondu@debian.org>, Tue, 26 Jun 2012 07:27:05 +0200
+++ /dev/null
-OCaml for Debian
-----------------
-
- 1) The OCaml package has been split into different binary packages:
-
- o ocaml: contains the full OCaml suite
- o ocaml-nox: the full suite except for the Graphics and Tk modules
- o ocaml-base: contains the runtime stuff (ocamlrun + dlls + Tk)
- o ocaml-base-nox: contains the runtime stuff (ocamlrun + dlls - Tk)
-
- o ocaml-compiler-libs: contains several modules used internally by
- the OCaml compilers. They are not needed for normal OCaml
- development, but may be helpful in the development of certain
- applications.
- o ocaml-source: contains the full OCaml source for the (few) packages which
- need them at build time or for personal use (it should _not_ be used to
- build OCaml itself).
-
- o ocaml-mode: contains a major mode for editing OCaml files in Emacs.
-
- 2) The caml include files are found under /usr/lib/ocaml/<ocaml_version>/caml.
- A symlink is provided from /usr/include/caml for convenience. If
- /usr/include/caml was previously a directory, for whatever reason, a warning
- will be issued and the file moved to /usr/include/caml.bad. This can be
- safely erased later on.
-
- 3) User-installed stuff should not go under /usr/lib/ocaml/<ocaml_version>,
- but rather under /usr/local/lib/ocaml/<ocaml_version>.
- We will take no responsibility for people who break this rule and mess things
- up.
-
- 4) Starting from OCaml 3.05, all dll.so files are now put into a common
- stublibs directory, so the ocaml-ldconf tool for handling the ld.conf
- file is not needed anymore, but we will still keep it around until all
- libraries are ported. As of OCaml 3.08, ocaml-ldconf is now deprecated
- and not available anymore.
- Notice that user-installed dll.so files should go into
- /usr/local/lib/ocaml/<ocaml_version>/stublibs which is searched before
- /usr/lib/ocaml/<ocaml_version>/stublibs.
-
- -- Ralf Treinen <treinen@debian.org>, Fri, 15 Jul 2016 22:08:59 +0200
-
-ocamldoc's LaTeX output
------------------------
-
-ocamldoc can generated documentation in LaTeX format which can be later on
-compiled using a LaTeX environment. The LaTeX sources generated by ocamldoc
-exploits the fullpage.sty style, which is not included in a default texlive
-installation (the Debian LaTeX environment of choice).
-
-In order to be able to compile ocamldoc generated LaTeX sources you will need
-to install the "texlive-latex-extra" package.
-
- -- Stefano Zacchiroli <zack@debian.org> Sun, 02 Sep 2007 18:22:14 +0200
+debian/OCaml_for_Debian
README.adoc
cp tools/$$u debian/ocaml-nox/usr/bin/ocaml$$u; \
fi \
done
- set -e; for pkg in ocaml ocaml-nox ocaml-base; do ( \
- mkdir -p debian/$$pkg/usr/share/doc/$$pkg && \
- cd debian/$$pkg/usr/share/doc/$$pkg && \
- ln -sf ../ocaml-base-nox/README.gz . && \
- ln -sf ../ocaml-base-nox/README.Debian .; \
- ); done
endif
# Remaining stuff
touch $@
.PHONY: override_dh_installdocs
override_dh_installdocs:
- dh_installdocs --ignore debian/README.Debian
+ dh_installdocs --package=ocaml-base-nox --doc-main-package=ocaml
+ dh_installdocs --remaining-packages
.PHONY: override_dh_missing
override_dh_missing:
projects / ocaml.git / commitdiff