Makefile

   1 # Makefile - for the org-mode distribution
   2 #
   3 # This file is not part of GNU Emacs
   4
   5 # set up environment
   6  include default.mk     # defaults, customizable via "local.mk"
   7 -include local.mk       # optional local customization, use default.mk as template
   8
   9 # default target is "all" unless overridden in local.mk
  10 all::
  11
  12 # Describe valid make targets for org-mode.
  13 .PHONY: targets help
  14 targets help helpall::
  15         $(info )
  16         $(info Getting Help)
  17         $(info ============)
  18         $(info )
  19         $(info make help          - show brief help)
  20         $(info make targets       - dito)
  21         $(info make helpall       - show extended help)
  22         $(info )
  23         $(info Build and Check)
  24         $(info ===============)
  25         $(info make               - build Org ELisp and all documentation)
  26         $(info make all           - dito)
  27         $(info make compile       - build Org ELisp files)
  28         $(info make autoloads     - create org-install.el to load org in-place)
  29         $(info make check         - build Org ELisp files and run test suite)
  30 helpall::
  31         $(info make test          - dito)
  32         $(info make compile-dirty - build only stale Org ELisp files)
  33         $(info make test-dirty    - check without building first)
  34         $(info )
  35         $(info Compatibility)
  36         $(info =============)
  37         $(info make oldorg        - what the old make did: compile autoloads info)
  38         $(info )
  39         $(info Convenience)
  40         $(info ===========)
  41         $(info make up0           - pull from upstream)
  42         $(info make up1           - pull from upstream, build and check)
  43         $(info make up2           - pull from upstream, build, check and install)
  44         $(info make update        - pull from upstream and build)
  45         $(info make update2       - pull from upstream, build and install)
  46         $(info make local.mk      - create new local.mk as template for adaptation)
  47         $(info )
  48         $(info Cleaning)
  49         $(info ========)
  50         $(info make clean         - remove built Org ELisp files and documentation)
  51         $(info make cleanall      - remove everything that can be built and all remnants)
  52         $(info make cleandirs     - clean in etc/, lisp/ and doc/)
  53         $(info make cleancontrib  - remove remnants in contrib/)
  54         $(info make cleandoc      - remove built documentation)
  55         $(info make cleandocs     - dito)
  56         $(info make cleanlisp     - remove built Org ELisp files)
  57         $(info make cleanelc      - dito)
  58         $(info make cleanrel      - remove release remnants)
  59         $(info make cleantest     - remove check remnants)
  60         $(info make clean-install - remove previous Org installation)
  61         $(info )
  62         $(info Documentation)
  63         $(info =============)
  64 targets help helpall::
  65         $(info make doc           - build all documentation)
  66 helpall::
  67         $(info make docs          - dito)
  68 targets help helpall::
  69         $(info make info          - build Info documentation)
  70 helpall::
  71         $(info make html          - build HTML documentation)
  72         $(info make pdf           - build PDF documentation)
  73         $(info make card          - build reference cards)
  74         $(info make refcard       - dito)
  75 targets help helpall::
  76         $(info )
  77         $(info Installation)
  78         $(info ============)
  79         $(info make install       - build and install Org)
  80 helpall::
  81         $(info make install-etc   - build and install files in /etc)
  82         $(info make install-lisp  - build and install Org Elisp files)
  83         $(info make install-info  - build and install Info documentation)
  84 targets help helpall::
  85         @echo ""
  86
  87  include targets.mk     # toplevel make machinery