diff options
author | Roland Hieber <r.hieber@pengutronix.de> | 2017-06-14 11:42:44 +0200 |
---|---|---|
committer | Michael Olbrich <m.olbrich@pengutronix.de> | 2017-06-21 10:14:53 +0200 |
commit | b1abb1cdde535aee59917bdad281f2069ed40393 (patch) | |
tree | 1e12adb0013fef5ae106c06f6e435f7e01ce7124 /doc | |
parent | 154f5a8d31d6acca20fcf6dc49f1ee8b72d728dc (diff) | |
download | ptxdist-b1abb1cdde535aee59917bdad281f2069ed40393.tar.gz ptxdist-b1abb1cdde535aee59917bdad281f2069ed40393.tar.xz |
doc: mention configure-helper.py
Signed-off-by: Roland Hieber <r.hieber@pengutronix.de>
Signed-off-by: Michael Olbrich <m.olbrich@pengutronix.de>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/dev_manual.rst | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/doc/dev_manual.rst b/doc/dev_manual.rst index 4df7e9411..a54888b43 100644 --- a/doc/dev_manual.rst +++ b/doc/dev_manual.rst @@ -872,6 +872,38 @@ order, if the X related tools are built or not. All the autocheck features are problematic here. So, if we do not want ``configure`` to guess its settings we **must disable everything we do not want**. +To support this process, PTXdist supplies a helper script, located at +``/path/to/ptxdist/scripts/configure-helper.py`` that compares the configure +output with the settings from ``FOO_CONF_OPT``: + +:: + + $ /opt/ptxdist-2017.06.0/scripts/configure-helper.py -p libsigrok + --- rules/libsigrok.make + +++ libsigrok-0.5.0 + @@ -4,3 +4,74 @@ + --libdir=/usr/lib + --build=x86_64-host-linux-gnu + --host=arm-v7a-linux-gnueabihf + + --enable-warnings=min|max|fatal|no + + --disable-largefile + + --enable-all-drivers + + --enable-agilent-dmm + [...] + + --enable-ruby + + --enable-java + + --without-libserialport + + --without-libftdi + + --without-libusb + + --without-librevisa + + --without-libgpib + + --without-libieee1284 + + --with-jni-include-path=DIR-LIST + +In this example, many configure options from libsigrok (marked with ``+``) +are not yet present in ``LIBSIGROK_CONF_OPT`` and must be added, possibly also +by providing more dynamic options in the package definition. + Since every optional parameter adds four lines of code to the rule files, PTXdist provides some shortcuts to handle it. Refer to section :ref:`param_macros` for further details. |