Next: , Previous: Introduction, Up: Top


2 General Usage

If anything may go wrong, it will definitely go wrong.

—Murphy's Law

Murphy is an optimist.

—O'Rielly's Law


GNUN currently consists of a few makefiles, scripts and optional generic.lang.html files, intended to contain article-independent but team-specific information. They are designed to reside in the server/gnun directory, but this may change. In all examples in this manual, “invoking” means executing on the command line make -C server/gnun [target] [variable=value ...] while the working directory is the root in the `www' web repository. For the purpose of brevity, we will refer to the above command as simply make, which is equivalent to cd server/gnun ; make. It is desirable never to invoke make with the -k (--keep-going) option, because an eventual error in only one make recipe might create a mess in many articles, both original and translated. Do this with caution, and generally only when debugging in a safe environment.

The build process is intended to be invoked by a cron job, although manual intervention to a certain degree is possible.