Files
xahaud/doc
Vinnie Falco d8dea963fa Squashed 'src/beast/' changes from 1b9a714..6d5547a
6d5547a Set version to 1.0.0-b34
6fab138 Fix and tidy up CMake build scripts:
ccefa54 Set version to 1.0.0-b33
32afe41 Set internal state correctly when writing frames:
fe3e20b Add write_frames unit test
578dcd0 Add decorator unit test
aaa3733 Use fwrite return value in file_body
df66165 Require Visual Studio 2015 Update 3 or later
b8e5a21 Set version to 1.0.0-b32
ffb1758 Update CMake scripts for finding packages:
b893749 Remove http Writer suspend and resume feature (API Change):
27864fb Add io_service completion invariants tests
eba05a7 Set version to 1.0.0-b31
484bcef Fix badge markdown in README.md
5663bea Add missing dynabuf_readstream member
0d7a551 Tidy up build settings
0fd4030 Move the handler, don't copy it

git-subtree-dir: src/beast
git-subtree-split: 6d5547a32c50ec95832c4779311502555ab0ee1f
2017-04-20 13:40:52 -07:00
..

Building documentation

Specifying Files

To specify the source files for which to build documentation, modify INPUT and its related fields in doc/source.dox. Note that the INPUT paths are relative to the doc/ directory.

Install Dependencies

Windows

Install these dependencies:

  1. Install Doxygen
  2. Download the following zip files from xsltproc (Alternate download: ftp://ftp.zlatkovic.com/libxml/), and extract the bin\ folder contents into any folder in your path.
  • iconv
  • libxml2
  • libxslt
  • zlib
  1. Download Boost
  2. Extract the compressed file contents to your (new) $BOOST_ROOT location.
  3. Open a command prompt or shell in the $BOOST_ROOT.
  4. ./bootstrap.bat
  5. If it is not already there, add your $BOOST_ROOT to your environment $PATH.

MacOS

  1. Install doxygen:
  • Use homebrew to install: brew install doxygen. The executable will be installed in /usr/local/bin which is already in your path.
  • Alternatively, install from here: doxygen. You'll then need to make doxygen available to your command line. You can do this by adding a symbolic link from /usr/local/bin to the doxygen executable. For example, $ ln -s /Applications/Doxygen.app/Contents/Resources/doxygen /usr/local/bin/doxygen
  1. Install Boost
  2. Extract the compressed file contents to your (new) $BOOST_ROOT location.
  3. Open a command prompt or shell in the $BOOST_ROOT.
  4. $ ./bootstrap.bat
  5. If it is not already there, add your $BOOST_ROOT to your environment $PATH. This makes the b2 command available to the command line.
  6. That should be all that's required. In OS X 10.11, at least, libxml2 and libxslt come pre-installed.

Linux

  1. Install Docker
  2. Build Docker image. From the Beast root folder:
sudo docker build -t beast-docs doc/

Do it

Windows & MacOS

From the Beast root folder:

cd doc
./makeqbk.sh && b2

The output will be in doc/html.

Linux

From the Beast root folder:

sudo docker run -v $PWD:/opt/beast --rm beast-docs

The output will be in doc/html.