From: Stefano Zacchiroli <zack@debian.org>
Date: Mon, 27 Aug 2007 13:18:18 +0000 (+0000)
Subject: - flags specific for the backend html/man
X-Git-Tag: archive/raspbian/4.08.1-4+rpi1~3^2~543
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=cb86293887781152dfef26b21bc9829eb1c96b94;p=ocaml.git

- flags specific for the backend html/man
- preliminary support for manpage generation
---

diff --git a/debian/cdbs/ocaml-vars.mk b/debian/cdbs/ocaml-vars.mk
index 908b2bbf..e984b2f2 100644
--- a/debian/cdbs/ocaml-vars.mk
+++ b/debian/cdbs/ocaml-vars.mk
@@ -16,7 +16,7 @@
 # this program; if not, write to the Free Software Foundation, Inc., 51
 # Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 #
-# $Id: ocaml-vars.mk 4199 2007-08-27 13:08:35Z zack $
+# $Id: ocaml-vars.mk 4200 2007-08-27 13:18:18Z zack $
 
 _cdbs_scripts_path ?= /usr/lib/cdbs
 _cdbs_rules_path ?= /usr/share/cdbs/1/rules
@@ -88,9 +88,17 @@ OCAML_LIB_PACKAGES := $(filter lib%-ocaml,$(DEB_PACKAGES))
 OCAML_OCAMLDOC_PACKAGES =
 #OCAML_OCAMLDOC_PACKAGES = $(OCAML_LIBDEV_PACKAGES)	# more "aggressive" default
 
-# flags to be passed to ocamldoc (in addition to -html and -d DESTDIR).
+# generic (i.e. non backend specific) flags to be passed to ocamldoc
 # For debian/rules writers
 OCAML_OCAMLDOC_FLAGS = -stars -m A
 
+# html-specific flags to be passed to ocamldoc (in addition to -html -d DESTDIR)
+# For debian/rules writers
+OCAML_OCAMLDOC_FLAGS_HTML =
+
+# man-specific flags to be passed to ocamldoc (in addition to -man -d DESTDIR)
+# For debian/rules writers
+OCAML_OCAMLDOC_FLAGS_MAN = -man-mini
+
 endif
 
diff --git a/debian/cdbs/ocaml.mk b/debian/cdbs/ocaml.mk
index 315049b6..16d66614 100644
--- a/debian/cdbs/ocaml.mk
+++ b/debian/cdbs/ocaml.mk
@@ -16,7 +16,7 @@
 # this program; if not, write to the Free Software Foundation, Inc., 51
 # Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 #
-# $Id: ocaml.mk 4195 2007-08-27 08:58:20Z zack $
+# $Id: ocaml.mk 4200 2007-08-27 13:18:18Z zack $
 
 _cdbs_scripts_path ?= /usr/lib/cdbs
 _cdbs_rules_path ?= /usr/share/cdbs/1/rules
@@ -48,10 +48,19 @@ $(patsubst %,install/%,$(DEB_PACKAGES))::
 		echo 'mkdir -p debian/$(cdbs_curpkg)/usr/share/doc/$(cdbs_curpkg)/html/api' ; \
 		mkdir -p debian/$(cdbs_curpkg)/usr/share/doc/$(cdbs_curpkg)/html/api ; \
 		echo 'invoking ocamldoc on debian/$(cdbs_curpkg)$(OCAML_STDLIB_DIR)/ ...' ; \
+		# generate HTML documentation
 		find debian/$(cdbs_curpkg)$(OCAML_STDLIB_DIR)/ \
 			-type f -name '*.mli' -or -name '*.ml' \
-		| xargs ocamldoc $(OCAML_OCAMLDOC_FLAGS) -html \
+		| xargs ocamldoc $(OCAML_OCAMLDOC_FLAGS) \
+			-html $(OCAML_OCAMLDOC_FLAGS_HTML) \
 			-d debian/$(cdbs_curpkg)/usr/share/doc/$(cdbs_curpkg)/html/api ; \
+		## generate manpages
+		## XXX dumb: find for *.ml{i,} is executed twice
+		#find debian/$(cdbs_curpkg)$(OCAML_STDLIB_DIR)/ \
+		#	-type f -name '*.mli' -or -name '*.ml' \
+		#| xargs ocamldoc $(OCAML_OCAMLDOC_FLAGS) \
+		#	-man $(OCAML_OCAMLDOC_FLAGS_MAN) \
+		#	-d debian/$(cdbs_curpkg)/usr/share/man/... # TODO ; \
 	fi
 
 # generate .in files counterpars before building, substituting @OCamlABI@