This file contains an unsorted list of tasks to be done on the
MetaPost manual.  Feel free to add new, move or remove finished
items.

Where to put new items?
-----------------------
Section 'Wanted For Release' contains items that we want to be
finished before the next release.  Even minor issues can and
should be added here.

Items in section 'Mid Term Issues' have no dead-line, but should
be self-contained enough to be done independent from other stuff.

Items in section 'Long Term Issues' are less actively worked on.
The reason they are less actively worked on is not lack of
importance, but lack of developer resources.  Nevertheless, they
are on the agenda.  Contributions are welcome!

How to pick items?
------------------
You can indicate interest or active work on an item by putting your
initials in parenthese in front of that item and checking the
modified TODO file into the repository.  That way, anybody who is
subscribed to the metapost-commits list is notified of your
interest.  Additionally, it is wise to communicate that you're
working on an issue (you didn't remember adding yourself) on the
mp-implementors list or alternatively the metapost list.


*****************************
***   Wanted For Release  ***
*****************************

mpman.tex
* Describe environment variables.
* Add note on postcontrol and precontrol when discussing control points.
* Add description of interaction mode commands.




*****************************
***   Mid Term Issues     ***
*****************************

* Revise introduction.
* Move prologues discussion to section 3.
* More information and examples on alternatives for calling TeX
    or LaTeX from within MetaPost.
* (SH) Revise (and add more) flow charts for MetaPost workflow.
* Information on using MetaPost from within LaTeX (emp), ConTeXt
    and LuaTeX.
* Why is verbatimtex\end{document}etex "safer", cf. sec. 13.1?
* Discuss difference between "draw <pic> withpen" and
    "label(<pic>, ...) withpen" (when label bug is fixed).
* Add a sub-section discussing colours in section 9.
* (SH) Colour cars and change code example in section 9.9.
* Describe mpware in section "Legacy information".




*****************************
***   Long Term Issues    ***
*****************************

* Add decent title graphics.
* Review presentation of primitives and plain macros in appendix A.
* Build reference manual automatically from mp.web (as a separate manual?).
* Make manual sources compatible with preview mode (Emacs).
* Make manual sources LaTeX2e conform.
* Make manual sources look nice in Emacs (AUCTeX font-locking).
* Review overall layout of the manuals (type area, float placement,
  listing presentation etc.)