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