summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAchim Gratz <Stromeko@Stromeko.DE>2012-04-22 08:22:31 +0200
committerBastien Guerry <bzg@altern.org>2012-04-22 10:51:29 +0200
commit0a9c29d30518222f455b72ef6955ec02b8a4814d (patch)
treee35406000607456f0d26ae401eb9dd9d51ee9dcf
parent7993ae4816d5e8f11b0f0fa4279a8602e28707d2 (diff)
downloadorg-mode-0a9c29d30518222f455b72ef6955ec02b8a4814d.tar.gz
allow customization of the "doc" target to skip certain types of documentation
* doc/Makefile: read targets to make for "doc" from $(ORG_MAKE_DOC), defaults to "info html pdf"; can be overridden by the user in local.mk. * targets.mk: read targets to make for "doc" and "docs" from $(ORG_MAKE_DOC), defaults to "info html pdf"; can be overridden by the user in local.mk. * default.mk: document ORG_MAKE_DOC and provide a (commented) example of how to have make only produce info documentation.
-rw-r--r--default.mk6
-rw-r--r--doc/Makefile2
-rw-r--r--targets.mk3
3 files changed, 9 insertions, 2 deletions
diff --git a/default.mk b/default.mk
index 45e6fbf..ea56d72 100644
--- a/default.mk
+++ b/default.mk
@@ -4,6 +4,9 @@
## CHECK AND ADAPT THE FOLLOWING DEFINITIONS
##----------------------------------------------------------------------
+# Override default target if desired or define your own default target
+# oldorg: # have plain "make" do the same things the old Makefile did
+
# Name of your emacs binary
EMACS = emacs
@@ -19,6 +22,9 @@ datadir = $(prefix)/emacs/etc/org
# Where info files go.
infodir = $(prefix)/info
+# Define if you only need info documentation, the default includes html and pdf
+# ORG_MAKE_DOC = info # html pdf
+
# Where to create temporary files for the testsuite
TMPDIR ?= /tmp
testdir = $(TMPDIR)/tmp-orgtest
diff --git a/doc/Makefile b/doc/Makefile
index 74fa4d5..95e7024 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -6,7 +6,7 @@ endif
clean cleanall clean-install \
org-version.inc
-all: info html pdf card
+all: $(ORG_MAKE_DOC)
info: org
diff --git a/targets.mk b/targets.mk
index 394e55e..a341301 100644
--- a/targets.mk
+++ b/targets.mk
@@ -6,6 +6,7 @@ DISTFILES_extra= Makefile request-assign-future.txt contrib etc
LISPDIRS = lisp
SUBDIRS = doc etc $(LISPDIRS)
INSTSUB = $(SUBDIRS:%=install-%)
+ORG_MAKE_DOC ?= info html pdf
ifneq ($(wildcard .git),)
GITVERSION ?= $(shell git describe --abbrev=6 HEAD)
@@ -62,7 +63,7 @@ install: $(INSTSUB)
install-info: install-doc
-doc docs: info html pdf card
+doc docs: $(ORG_MAKE_DOC)
info html pdf card:
$(MAKE) -C doc $@