Makefile

   1 # Makefile - for the org-mode distribution
   2 # GNU make is required
   3 #
   4 # This file is not part of GNU Emacs
   5
   6 # set up environment
   7  include mk/default.mk  # defaults, customizable via "local.mk"
   8 -include local.mk       # optional local customization, use default.mk as template
   9
  10 # default target is "all" unless overridden in local.mk
  11 all::
  12
  13 # Describe valid make targets for org-mode.
  14 .PHONY: targets help helpall
  15 targets:        help
  16 help helpall::
  17         $(info )
  18         $(info Getting Help)
  19         $(info ============)
  20         $(info )
  21         $(info make help           - show brief help)
  22         $(info make targets        - ditto)
  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            - ditto)
  29         $(info make compile        - build Org ELisp files)
  30         $(info make single         - build Org ELisp files, single Emacs per source)
  31         $(info make autoloads      - create org-loaddefs.el to load Org in-place)
  32         $(info make test           - build Org ELisp files and run test suite)
  33         $(info make vanilla        - run Emacs with this Org-mode and no personal config)
  34 helpall::
  35         $(info make test-dirty     - check without building first)
  36         $(info make compile-dirty  - build only stale Org ELisp files)
  37         $(info )
  38         $(info Compatibility)
  39         $(info =============)
  40         $(info make oldorg         - what the old make did: compile autoloads info)
  41         $(info )
  42         $(info Cleaning)
  43         $(info ========)
  44         $(info make clean          - remove built Org ELisp files and documentation)
  45         $(info make cleanall       - remove everything that can be built and all remnants)
  46         $(info make clean-install  - remove previous Org installation)
  47         $(info )
  48         $(info Configuration Check)
  49         $(info ===================)
  50 help helpall::
  51         $(info make config         - check main configuration)
  52 helpall::
  53         $(info make config-version - check Org version)
  54         $(info make config-test    - check test configuration)
  55         $(info make config-exe     - check executables configuration)
  56         $(info make config-cmd     - check command configuration)
  57         $(info make config-all     - check all configuration)
  58         $(info )
  59         $(info Documentation)
  60         $(info =============)
  61 help helpall::
  62         $(info make doc            - build all documentation)
  63 helpall::
  64         $(info make docs           - ditto)
  65 help helpall::
  66         $(info make info           - build Info documentation)
  67 helpall::
  68         $(info make html           - build HTML documentation)
  69         $(info make pdf            - build PDF documentation)
  70         $(info make card           - build reference cards)
  71         $(info make refcard        - ditto)
  72 help helpall::
  73         $(info )
  74         $(info Installation)
  75         $(info ============)
  76         $(info make install        - build and install Org)
  77 helpall::
  78         $(info make install-etc    - build and install files in /etc)
  79         $(info make install-lisp   - build and install Org Elisp files)
  80         $(info make install-info   - build and install Info documentation)
  81         $(info )
  82         $(info Convenience)
  83         $(info ===========)
  84         $(info make up0            - pull from upstream)
  85         $(info make up1            - pull from upstream, build and check)
  86         $(info make up2            - pull from upstream, build, check and install)
  87         $(info make update         - pull from upstream and build)
  88         $(info make update2        - pull from upstream, build and install)
  89         $(info make uncompiled     - combine cleanlisp and autoloads)
  90         $(info make local.mk       - create new local.mk as template for adaptation)
  91 help helpall::
  92         $(info )
  93         $(info Full documentation on Worg)
  94         $(info ==========================)
  95         $(info http://orgmode.org/worg/dev/org-build-system.html)
  96         @echo ""
  97
  98  include mk/targets.mk  # toplevel make machinery