This is a stub for a new GAMS project. It contains the following features:

1. Automatic documentation from reStructuredText and \LaTeX comments in the GAMS file(s)
2. Writing comments to the GAMS log file during a GAMS run
3. Auxiliary function to write the computation time (since start of the GAMS run) to the log file

This stub depends on

1. Python
2. Sphinx

Choose a project name and run the following commands replacing <project name> with your choice:

git clone https://github.com/iiasa/gams_stub.git <project name>
cd <project name>
./make_proj.sh <project name>

You should now have a fresh new repository with your project ready to go. You can sync it with Github via:

git remote add origin [email protected]:<user name>/<project name>
git push origin master

After you install the project locally, you can generate documentation by:

cd doc
make html

You can serve the documentation locally via:

make serve

You can then view the docs at http://localhost:8000/build/html/

For Windows users, Anaconda is a good way to get started with Python, and Sphynx is already included.

Follow the above instructions replacing make with ./make.bat.