This page describes how to build the GMAT User Guide and Training Manual from sources. The User Guide and Training Manual are both configurations of the same set of source documents.
Check out the documentation sources from the GMAT SourceForge repository. The Subversion URL for the documentation is:
Or, you can check out the entire trunk. The documentation is stored in the
Internal users will need to check out the internal
gmat.git repository. Again, look in the
You'll need the following prerequisites to build the User Guide:
Download the Java SE JRE or JDK from Oracle, if you don't already have it installed. Both versions 6 and 7 should work. I haven't tested earlier versions. You'll need to add the main
javaexecutable to your system path.
Download the MinGW installer from SourceForge. The installer will ask if you want to install MSYS; make sure you select this option. You can install the other components if you wish, but MSYS is the only required component.
htmlhelp.exe from Microsoft and install it. You'll need to add the path to
hhc.exe to your
Pathenvironment variable. This is only needed for CHM format output.
javato your path: You should be able to open a shell (cmd.exe or the MinGW Shell on Windows) and type "
java" to run the Java command-line application. If you get "
'java' is not recognized as an internal or external command, operable program or batch file.", then follow these steps:
java.exeon your system. For me, this path is
C:\Program Files\Java\jre7\bin. If there is already an existing value for
Path, add the new path to the end, separated from the existing value by a semicolon.
doc/help: In the shell, navigate to the
helpdirectory of the GMAT repository you checked out earlier. If you checked out the full trunk, the path is
make: The documentation will be built in all formats: PDF, HTML, CHM. All files are placed directly in the
Makefilesupports the following main targets:
all(default): build both the User Guide and the Training Manual in all formats
clean: delete all compiled files
help: build User Guide in all formats
training: build Training Manual in all formats
html: build the User Guide in HTML single-page and multi-page formats