[pulseview.git] / INSTALL

-------------------------------------------------------------------------------
INSTALL
-------------------------------------------------------------------------------

Requirements
------------

 - 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 (only needed when building from git)
 - pkg-config >= 0.22
 - cmake >= 2.8.12
 - libglib >= 2.28.0
 - glibmm-2.4 (>= 2.28.0)
 - gstreamermm-1.0 (>= 1.8.0)
 - Qt5 (>= 5.3), including the following components:
    - Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg, Qt5LinguistTools
    - Qt translation package (optional; needed at runtime, not build time)
 - libboost >= 1.55 (including the following libs):
    - libboost-system
    - libboost-filesystem
    - libboost-serialization
    - libboost-test (optional, only needed to run the unit tests)
    - libboost-stacktrace (optional, only needed for debugging)
 - libsigrokflow >= 0.1.0
 - libsigrokcxx >= 0.5.1 (libsigrok C++ bindings)
 - libsigrokdecode >= 0.6.0
 - libsigrokandroidutils >= 0.1.0 (optional, only needed on Android)
 - asciidoctor (optional, only needed to build the HTML manual)
 - asciidoctor-pdf (optional, only needed to build the PDF manual)


Building and installing
-----------------------

In order to get the PulseView source code and build it, run:

 $ git clone git://sigrok.org/pulseview
 $ cd pulseview
 $ cmake .
 $ make

For installing PulseView:

 $ make install

See the following wiki page for more (OS-specific) instructions:

 http://sigrok.org/wiki/Building


Creating a source distribution package
--------------------------------------

In order to build a source package begin with an unconfigured source tree.

 $ mkdir dist
 $ cd dist
 $ 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
Commit	Line	Data
	1	-------------------------------------------------------------------------------
	2	INSTALL
	3	-------------------------------------------------------------------------------
	4
	5	Requirements
	6	------------
	7
	8	- git (only needed when building from git)
	9	- A C++ compiler with C++11 support (-std=c++11 option), e.g.
	10	- g++ (>= 4.8.1)
	11	- clang++ (>= 3.3)
	12	- make
	13	- libtool (only needed when building from git)
	14	- pkg-config >= 0.22
	15	- cmake >= 2.8.12
	16	- libglib >= 2.28.0
	17	- glibmm-2.4 (>= 2.28.0)
	18	- gstreamermm-1.0 (>= 1.8.0)
	19	- Qt5 (>= 5.3), including the following components:
	20	- Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg, Qt5LinguistTools
	21	- Qt translation package (optional; needed at runtime, not build time)
	22	- libboost >= 1.55 (including the following libs):
	23	- libboost-system
	24	- libboost-filesystem
	25	- libboost-serialization
	26	- libboost-test (optional, only needed to run the unit tests)
	27	- libboost-stacktrace (optional, only needed for debugging)
	28	- libsigrokflow >= 0.1.0
	29	- libsigrokcxx >= 0.5.1 (libsigrok C++ bindings)
	30	- libsigrokdecode >= 0.6.0
	31	- libsigrokandroidutils >= 0.1.0 (optional, only needed on Android)
	32	- asciidoctor (optional, only needed to build the HTML manual)
	33	- asciidoctor-pdf (optional, only needed to build the PDF manual)
	34
	35
	36	Building and installing
	37	-----------------------
	38
	39	In order to get the PulseView source code and build it, run:
	40
	41	$ git clone git://sigrok.org/pulseview
	42	$ cd pulseview
	43	$ cmake .
	44	$ make
	45
	46	For installing PulseView:
	47
	48	$ make install
	49
	50	See the following wiki page for more (OS-specific) instructions:
	51
	52	http://sigrok.org/wiki/Building
	53
	54
	55	Creating a source distribution package
	56	--------------------------------------
	57
	58	In order to build a source package begin with an unconfigured source tree.
	59
	60	$ mkdir dist
	61	$ cd dist
	62	$ cmake ..
	63	$ make package_source
	64
	65
	66	Generating the manual
	67	---------------------
	68
	69	To generate the HTML manual, you only need Asciidoctor. If you also want
	70	to generate the PDF manual, you need to install asciidoctor-pdf as well
	71	and make it available for execution:
	72
	73	$ gem install --pre asciidoctor-pdf
	74	$ export PATH=~/.gem/ruby/2.3.0/bin:$PATH
	75
	76	Then, to build the PulseView manual, run:
	77
	78	$ make manual
	79
	80	Note: The stylesheet used is a lightly modified version of "Read The Docs"
	81	from the Asciidoctor stylesheet factory:
	82	https://asciidoctor.org/docs/user-manual/#stylesheet-factory