============================================================= PEG 201: META: PEG format ============================================================= :Authors: Tuomas Lukka :Date: $Date: 2002/10/19 08:41:32 $ :Revision: $Revision: 1.1 $ :Status: Incomplete This META-PEG deals with formatting PEGs. Issues ------ - Defining standard fields? - Our own directives? Low-level Format ---------------- PEGs use the python reStructuredText_ markup language. .. _reStructuredText: http://docutils.sourceforge.net Overall structure ----------------- The PEG should begin with the header and after that, a short introduction which should briefly answer the questions **what** and **why** (and, if not obvious, **how**). After this section, there should be an Issues section (following the example of OpenGL extension specs), which should contain the open questions related to this PEG. Once an issue is resolved, it is often good to leave the resolution and the rationale behind the resolution into the Issues section Then, there can be free-form sections in which the changes proposed are detailed.