@@ -59,3 +59,56 @@ Each of the installation steps described above can be reversed:
5959
6060 sudo make uninstall-all
6161
62+# Other targets
63+
64+The following 'make' targets should not be needed by the average user,
65+but are documented here for packagers and developers:
66+
67+## Building and installing
68+
69+* `configure`: Performs the needed preprocessing to create a proper
70+ Cabal package for Pandoc:
71+ - Builds `Pandoc.cabal` from `Pandoc.cabal.in`, using
72+ the shell script `cabalize`.
73+ - Builds `ASCIIMathML.hs`, `DefaultHeaders.hs`, and `S5.hs`
74+ from templates in `src/templates` and data in `src/ASCIIMathML.js`,
75+ `src/ui`, and `src/headers`.
76+ - Stores values of relevant environment variables in `vars` for
77+ persistence.
78+ - Runs Cabal's "configure" command.
79+* `build-exec`: Builds `pandoc` executable (using Cabal's "build"
80+ command) and creates the wrappers `html2markdown` and `markdown2pdf`
81+ from templates in `src/wrappers`.
82+* `build-doc`: Builds program documentation (e.g. `README.html`).
83+* `build-lib-doc`: Builds Haddock documentation for Pandoc libraries.
84+* `install-doc`, `uninstall-doc`: Installs/uninstalls user documentation
85+ and man pages.
86+* `install-lib-doc`, `uninstall-lib-doc`: Installs/uninstalls library
87+ documentation and man pages.
88+* `install-exec`, `uninstall-exec`: Installs/uninstalls programs
89+ (`pandoc` and wrappers).
90+
91+## Testing
92+
93+* `test`: Runs Pandoc's test suite. (All tests should pass.)
94+* `test-markdown`: Runs the Markdown regression test suite, using
95+ `pandoc --strict`. (One of the list tests will fail.)
96+
97+## Cleaning
98+
99+* `clean`: Restores directory to pre-build state, removing generated files.
100+* `distclean`: Like clean, but also cleans up files created by `make deb`.
101+
102+## Packaging
103+
104+* `osx-pkg-prep`: Prepares for building a MacOS X package.
105+* `osx-pkg`: Builds a MacOS X package (must be run as root, and on OS X).
106+ You should make `osx-pkg-prep` first (not as root).
107+* `osx-dmg`: Creates a compressed disk image containing Mac OS X package
108+ (must be run on OS X). You should make `osx-pkg` first.
109+* `win-pkg`: Creates a Windows binary package (presupposes `pandoc.exe`,
110+ which must be created by building Pandoc on a Windows machine).
111+* `tarball`: Creates a source tarball for distribution.
112+* `deb`: Creates debian packages in `..` directory.
113+* `website`: Creates Pandoc's website in `web/pandoc` directory.
114+