X-Git-Url: http://git.code-monkey.de/?p=pulseview.git;a=blobdiff_plain;f=INSTALL;h=b51b246ebf3ea492a378f0cb762b5869e34909fe;hp=445e36b8e34561b5e91118a9a9f5a06d4f1abd92;hb=dde5aab3c1c55ef4bf7b255b976b23320bad384f;hpb=e37a0c3e6087c1aaa1dff648ecb0c0d1ed786e6a diff --git a/INSTALL b/INSTALL index 445e36b..b51b246 100644 --- a/INSTALL +++ b/INSTALL @@ -22,9 +22,11 @@ Requirements - libboost-filesystem - libboost-serialization - libboost-test (optional, only needed to run the unit tests) + - libboost-stacktrace (optional, only needed for debugging) - libsigrokcxx >= 0.6.0 (libsigrok C++ bindings) - libsigrokdecode >= 0.6.0 - libsigrokandroidutils >= 0.1.0 (optional, only needed on Android) + - Asciidoctor (optional, only needed to build the manual) Building and installing @@ -56,3 +58,21 @@ In order to build a source package begin with an unconfigured source tree. $ cmake .. $ make package_source + +Generating the manual +--------------------- + +To generate the HTML manual, you only need Asciidoctor. If you also want +to generate the PDF manual, you need to install asciidoctor-pdf as well +and make it available for execution: + + $ gem install --pre asciidoctor-pdf + $ export PATH=~/.gem/ruby/2.3.0/bin:$PATH + +Then, to build the PulseView manual, run: + + $ make manual + +Note: The stylesheet used is a lightly modified version of "Read The Docs" +from the Asciidoctor stylesheet factory: +https://asciidoctor.org/docs/user-manual/#stylesheet-factory