Fixing displayed pen and x-axis to report the right units and scaling of frequencies.
[debian/gnuradio] / README.components
index eb72b1d6fbd873d86b011156b545d8b939e307bd..996f2ee5458f92e0356e8339545f9730302e2793 100755 (executable)
@@ -4,21 +4,38 @@
 
 # Copyright 2008 Free Software Foundation.
 #
+# DO NOT RUN THIS SCRIPT UNTIL YOU UNDERSTAND IT!!!  IT WILL REMOVE
+# FILES ON YOUR SYSTEM.
+#
+# Read the script thoroughly before running it; it will *remove*
+# /usr/local/gnuradio and repopulate it.
+#
 # This script provides a way to build GNU Radio modules individually,
 # and both serves as an example of using the component build system
-# and provides a way to test that build system.  This script is
-# intended to be broadly portable; be careful when modifying not to
-# cause problems on systems that place dependencies in other than /usr
+# and provides a way to test the build system.  When run, it will
+# build and install each GNU Radio module in turn, using the
+# just-installed modules as prerequisites.  It places the output of
+# each build in a separate file BUILD.NNN.options, so that one can do
+# 'tail -f BUILD.*' to see which components were successfully built.
+
+# This script is intended to be broadly portable; be careful when
+# modifying not to cause problems on systems that place dependencies
+# in other than /usr
 #
 # Besides GNU Radio dependencies, this program requires sudo, with a
 # timer long enough to build each module (or no password requirement).
 #
-# Read the script thoroughly before running it; it will *remove*
-# /usr/gnuradio and repopulate it.
 
 set -x
 
-PREFIX=/usr/gnuradio
+# Do not use /opt, because many systems do not have /opt and that
+# risks running out of space in /.  /usr/local/gnuradio is believed to
+# be reasonable on all of *BSD and GNU/Linux.  Probably this needs
+# OS-specific overrides.
+PREFIX=/usr/local/gnuradio
+
+echo "ABOUT TO COMPLETELY REMOVE $PREFIX in 10 SECONDS!"
+sleep 10
 
 echo -n "README.components START "; date
 
@@ -70,34 +87,37 @@ CONF_DOC_ARGS="
 CONF_DISABLE_ALL="--disable-all-components"
 
 # We use % instead of ' ' to be able to iterate with /bin/sh's for.
+# This variable should list all possible arguments, in tsorted order.
 CONF_ENABLE_ARGS="
 --enable-omnithread
+--with-omnithread%--enable-gnuradio-core
 --with-omnithread%--enable-pmt
 --with-omnithread%--with-pmt%--enable-mblock
---with-omnithread%--enable-gnuradio-core
 --with-omnithread%--with-pmt%--with-mblock%--enable-usrp
 --with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--with-usrp%--enable-gr-usrp
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-msdd6000
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-audio-alsa
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-audio-jack
 --with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-audio-oss
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-audio-osx
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-audio-portaudio
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-audio-windows
 --with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-atsc
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-comedi
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-cvsd-vocoder
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--with-usrp%--enable-gr-gpio
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-gsm-fr-vocoder
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-pager
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--with-usrp%--enable-gr-radar-mono
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-radio-astronomy
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-trellis
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-video-sdl
 --with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gr-wxgui
---with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--with-usrp%with-gr-wxgui%--enable-gr-utils
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--with-usrp%--enable-gr-sounder
+--with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--with-usrp%--with-gr-usrp%--with-gr-wxgui%--enable-gr-utils
 --with-omnithread%--with-gnuradio-core%--with-pmt%--with-mblock%--enable-gnuradio-examples
 "
 
-# These are not used, but a list of what the script does not build.
-CONF_DISABLE_ARGS="
---enable-gr-comedi
---enable-gr-cvsd-vocoder
---enable-gr-gpio
---enable-gr-gsm-fr-vocoder
---enable-gr-pager
---enable-gr-radar-mono
---enable-gr-radio-astronomy
---enable-gr-trellis
---enable-gr-video-sdl
---enable-gr-sounder
-"
-
 seq=0
 for arg in $CONF_ENABLE_ARGS; do
 
@@ -111,6 +131,9 @@ for arg in $CONF_ENABLE_ARGS; do
     # configure with just one module
     ./configure --prefix=$PREFIX $CONF_DISABLE_ALL $argspace &&
 
+    # remove all prior objects
+    make clean &&
+
     # build
     make $jflag &&