diff --git a/doc/development.rst b/doc/development.rst index b57fb544..98a3a942 100644 --- a/doc/development.rst +++ b/doc/development.rst @@ -18,10 +18,12 @@ Requirements ``libxml2-devel`` - CUnit packages must be installed - [Optional] ``laz-perf`` library may be installed for LAZ compression support - (built from source_) + (see :ref:`build_sources` instructions) + +.. _build_sources: ------------------------------------------------------------------------------ -Build/Install +Build from sources ------------------------------------------------------------------------------ After generating the configure script with ``autogen.sh``, you can use @@ -54,6 +56,50 @@ After generating the configure script with ``autogen.sh``, you can use $ ./configure CFLAGS="-DNESTED_QSORT=1" + +**LAZ support** + +If you want to enable LAZ compression, you first need to build the ``1.5.0`` +laz-perf library from sources: + +.. code-block:: bash + + $ git clone https://github.com/hobuinc/laz-perf + $ cd laz-perf + $ git checkout 1.5.0 + $ cmake . + $ make + $ make install + + +And then enable LAZ compression with ``--with-lazperf`` option on PgPointcloud side: + +.. code-block:: + + $ ./configure --with-lazperf=/usr/local + + PointCloud is now configured for + + -------------- Compiler Info ------------- + C compiler: gcc -g -O2 + CXX compiler: g++ -g -O2 + SQL preprocessor: /usr/bin/cpp -traditional-cpp -w -P + + -------------- Dependencies -------------- + PostgreSQL config: /usr/bin/pg_config + PostgreSQL version: PostgreSQL 17.5 (170) + Libxml2 config: /usr/bin/xml2-config + Libxml2 version: 2.14.3 + LazPerf status: /usr/local/include/laz-perf + CUnit status: enabled + + +.. warning:: + + Laz-perf ``1.5.0`` is outdated and some work is necessary to upgrade to + ``3.X`` version. + + ------------------------------------------------------------------------------ Tests ------------------------------------------------------------------------------ diff --git a/doc/install.rst b/doc/install.rst index 9665ed70..4ea32b04 100644 --- a/doc/install.rst +++ b/doc/install.rst @@ -10,6 +10,7 @@ Install :backlinks: none +------------------------------------------------------------------------------ Docker image ----------------------------------------------------------------------------- @@ -23,6 +24,7 @@ development version: .. _`Docker Hub`: https://hub.docker.com/r/pgpointcloud/pointcloud +------------------------------------------------------------------------------ GNU/Linux ------------------------------------------------------------------------------ @@ -45,6 +47,7 @@ pgPointcloud is available on Arch Linux through the `user repository`_. .. _`user repository`: https://aur.archlinux.org/packages/pgpointcloud +------------------------------------------------------------------------------ Windows ------------------------------------------------------------------------------ @@ -53,6 +56,7 @@ pgPointcloud is directly included in the `PostGIS`_ bundle. .. _`PostGIS`: https://postgis.net/windows_downloads/ +------------------------------------------------------------------------------ MacOS ------------------------------------------------------------------------------ @@ -61,6 +65,7 @@ pgpointcloud is available on macOS via `MacPorts`_. .. _`MacPorts`: https://ports.macports.org/port/pgpointcloud/ +------------------------------------------------------------------------------ Releases tarballs ------------------------------------------------------------------------------ @@ -97,11 +102,13 @@ Releases tarballs .. _source: +------------------------------------------------------------------------------ Sources ------------------------------------------------------------------------------ The source code repository for pgPointcloud is on `GitHub`_. You can retrieve -the development version with ``git``: +the development version with ``git``. See :ref:`build_sources` for +instructions. .. code-block:: console