blob: 0464e954037a2d818a22f38e4626b010e5c204a6 [file] [log] [blame]
***** THIS MOST IMPORTANT FILE IN THIS PROJECT IS *****
***** *****
***** dev-guide/dev-guide.pdf *****
***** *****
***** IF YOU ARE LOOKING FOR DEVELOPER *****
***** DOCUMENTATION, START THERE. *****
Contents of this project:
dev-guide/
Contains the Photran Developer's Guide. The CVS
instructions in Appendix A are also made into a
separate PDF.
Run Ant on build.xml to build the documentation
using pdflatex. (In Eclipse, right-click build.xml
and click on Run As > Ant Build.)
Note that the PDFs contain CVS revision information
at the beginning of each chapter. If you have write
access to Photran's CVS repository, make sure you
(1) first commit the LaTeX sources
(2) then re-build the PDFs
(3) then commit the PDFs
The PDF links on the Web site retrieve the PDFs
from the CVS repository; this ensures that those
PDFs have up-to-date CVS revision information in
each section. (If you create the PDFs from modified
sources without committing them to CVS first, the
revision information will be for the last revision
in CVS rather than the date the revised version was
created.)
misc-notes/
Various notes-to-self that aren't import enough to
be in the Developer's Guide.
contributions/
Contains correspondence and documentation related to
third-party contributions in Photran.
eclipse-config/
Contains settings for the Eclipse Java code formatter
and code templates. These have since been hard-coded
into the settings for each project, so they will be
applied by default when code is formatted or new classes
are created.
--Jeff Overbey 8/19/05, updated 8/29/08, 11/12/09