X-Git-Url: https://sigrok.org/gitweb/?p=pulseview.git;a=blobdiff_plain;f=INSTALL;h=833db389b636890ab1526d41bcd6f94081cd8bd1;hp=595ad8e2d950145e380bebd8dee1b8a87b6ecf27;hb=f6b6c9bf50999dc99f9517318ffd3114cae4960f;hpb=7ba41e7ec7e575ae34ed2af33920c6e843aaac4d diff --git a/INSTALL b/INSTALL index 595ad8e2..833db389 100644 --- a/INSTALL +++ b/INSTALL @@ -5,19 +5,27 @@ INSTALL Requirements ------------ - - git - - g++ + - git (only needed when building from git) + - A C++ compiler with C++11 support (-std=c++11 option), e.g. + - g++ (>= 4.8.1) + - clang++ (>= 3.3) - make - - libtool + - libtool (only needed when building from git) - pkg-config >= 0.22 - - cmake >= 2.8.6 + - cmake >= 2.8.12 - libglib >= 2.28.0 - - Qt >= 4.5 - - libboost >= 1.42 (including the following libs): + - glibmm-2.4 (>= 2.28.0) + - Qt5 (including the following components): + - Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg + - libboost >= 1.55 (including the following libs): - libboost-system - - libboost-thread - - libsigrok >= 0.2.0 - - libsigrokdecode >= 0.2.0 (optional, support disabled by default for now) + - libboost-filesystem + - libboost-serialization + - libboost-test (optional, only needed to run the unit tests) + - 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 @@ -49,3 +57,22 @@ 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: + + $ cd manual + $ ./generate + +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