forked from Mirrors/openclonk
docs: Update Makefile documentation and cygwin instructions
parent
e33521c7ab
commit
991845a5bb
|
@ -1,8 +1,15 @@
|
|||
# Notable targets:
|
||||
# all (default): German and English onlinedocs
|
||||
# online-en: only English onlinedocs, which can be partially updated
|
||||
# Enwickler.chm: the German offline doc
|
||||
# use with make Entwickler.chm HHC = /path/to/hhc
|
||||
# German and English online docs:
|
||||
# make all
|
||||
# make install prefix=/path/to/webspace
|
||||
# The offline docs:
|
||||
# make chm HHC=/path/to/hhc.exe
|
||||
|
||||
# Only English online docs, which can be partially updated:
|
||||
# make online-en
|
||||
# The English offline doc:
|
||||
# make chm/en/Developer.chm HHC=/path/to/hhc.exe
|
||||
# XML syntax check:
|
||||
# make check
|
||||
|
||||
# Extra Parameters for xsltproc can be given in the XSLTFLAGS variable.
|
||||
# Use prefix to select the directory where the docs are to be installed
|
||||
|
|
|
@ -4,7 +4,7 @@ This section explains how to build the German and English HTML-documentation fro
|
|||
|
||||
In Linux, it should be as easy as: Open the console and run make in this directory.
|
||||
|
||||
In Windows, you ned Python and Cygwin. During the Cygwin installation, select these additional libraries to install:
|
||||
In Windows, you need Python and Cygwin. During the Cygwin installation, select these additional libraries to install:
|
||||
+ make
|
||||
+ xsltproc (libxml2 + libxslt + python-libxml2)
|
||||
+ findutils
|
||||
|
@ -12,7 +12,8 @@ In Windows, you ned Python and Cygwin. During the Cygwin installation, select th
|
|||
+ gettext
|
||||
+ gettext-devel
|
||||
+ libgcrypt + libgpg-error (for whatever reason)
|
||||
Also you might have to rename find.exe, so that the cygwin provided one is used - first in Windows\System32\dllback then in Windows\System32 to make sure it isn't used.
|
||||
|
||||
After the installation, run cygwin, cd to this directory (/cygdrive/c/.../openclonk/docs/) and run make. The process takes about ten minutes to complete.
|
||||
The online version of the documentation has been generated into the online/ directory.
|
||||
After the installation, run cygwin, cd to this directory (/cygdrive/c/.../openclonk/docs/) and run make. The process takes a few minutes to complete.
|
||||
The online version of the documentation has been generated into the online/ directory.
|
||||
|
||||
To build the .chm files, install the html help compiler from http://www.microsoft.com/en-us/download/details.aspx?id=21138 or http://go.microsoft.com/fwlink/?LinkId=14188 and run make chm HHC=/path/to/hhc.exe
|
||||
|
|
Loading…
Reference in New Issue