Manual Changes: Preface, Coding Conventions, UML Diagrams

[Jeffrey]

This patch adds

  1) a preface,

  2) a "getting started" chapter explaining how to download source code,
    build the library, and compile a "Hello, Pooma" program,

  3) an overview of the source code and coding conventions, and

  4) a preliminary chapter of UML class diagrams, created at the
    specification, not implementation, level.

2002-Feb-26  Jeffrey D. Oldham  <address@hidden>

        * Makefile (XMLSOURCES): Add preface.xml and code.xml.
        * code.xml: New file/appendix describing source code organization
        and coding conventions.
        * concepts.xml: Fix cross reference whose name changed.
        * pooma.xml: Add entity for dangerous-bend sections, uml, g++.
        Move acknowledgements into the preface.  Move template programming
        chapter to an appendix.  Add "Getting Started" chapter.  Moved
        installation instructions from appendix into "Getting Started"
        chapter.  Added preliminary version of appendix of UML class
        diagrams.
        * preface.xml: New file containing a revised preface.
        * starting.xml: New file/chapter describing building the library
        and compiling a "Hello, Pooma" program.
        * template.xml: Move from a chapter to an appendix.
        * tutorial.xml: Moved Pooma installation to "Getting Started"
        chapter.
        * figures/Makefile: Added support for UML diagrams.
        * figures/array-uml-1.png: New illustration.
        * figures/array-uml-2.png: Likewise.
        * figures/array-uml-3.png: Likewise.
        * figures/array-uml.mp: New file for creating Array UML diagrams.
        * figures/domain-uml-1.png: New illustration.
        * figures/domain-uml.mp: New file for creating Domain UML diagrams.
        * figures/engine-uml-1.png: New illustration.
        * figures/engine-uml-2.png: Likewise.
        * figures/engine-uml-3.png: Likewise.
        * figures/engine-uml-4.png: Likewise.
        * figures/engine-uml.mp: New file for creating Engine UML diagrams.
        * figures/explanation-uml-1.png: New illustration.
        * figures/explanation-uml.mp: New file explaining UML class diagrams.
        * figures/macros.ltx: Added macros for UML diagrams.
        * figures/uml.mp: New file of MetaPost macros for UML diagrams.
        * programs/Sequential/initialize-finalize-annotated.patch: Revised
        this patch to reflect changes in the underlying file.

Applied to mainline.

Thanks,
Jeffrey D. Oldham
address@hidden

manual-2002Feb26.patch
Description: Text document