WSJT-X/doc
Bill Somerville ec0c0786a9 Make CMake variable for asciidoc script less likely to be overridden
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5327 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2015-04-29 23:56:48 +00:00
..
common Added automatic VERSION attributes to asciidoc generation 2015-04-28 22:33:32 +00:00
user_guide Added automatic VERSION attributes to asciidoc generation 2015-04-28 22:33:32 +00:00
CMakeLists.txt Make CMake variable for asciidoc script less likely to be overridden 2015-04-29 23:56:48 +00:00
README Some info for developers 2015-04-29 11:33:31 +00:00
wsjtx.conf.in Solve the WSJT-X manual versioning issue 2015-04-28 22:59:12 +00:00

This folder  contains the sources  of WSJT-X documentation.   To build
these you will need the asciidoc and Python v2 tools installed.

If you do not wish to build  the documentation, it is possible to skip
this  directory  in the  WSJT-X  build  by  setting the  CMake  option
WSJT_GENERATE_DOCS to OFF in your build tree.


On Linux
========

You will probably have these installed already if you are building the
WSJT-X  manpages,  if you  are  not  you  will  just need  to  install
asciidoc:

 sudo apt-get install asciidoc

or

 sudo yum install asciidoc

or whatever your distribution and package management requires.


On Mac OS X
===========

I recommend MacPorts:

 sudo port install asciidoc


On Windows
==========

The asciidoc  tool is a  Python script so you  will need to  install a
version of  Python v2. If  you already have  Python v3 as  the default
Python interpreter on your system  then download and install Python v2
(probably v2.7.x) but  adjust the installer options so as  not to make
it  the  default  system  Python   interpreter,  this  is  normally  a
configuration option in the MSI installer.

The current  version of asciidoc (8.6.9)  is broken on Windows  so you
will need to get the latest development version:

 download https://github.com/asciidoc/asciidoc/archive/master.zip

and unzip  it somewhere like  C:\Tools then you  will need to  add the
path to asciidoc and possibly Python  v2 to your CMake tool chain file
for building WSJT-X. The directory  containing asciidoc.py needs to be
included in the CMAKE_PREFIX_PATH variable.