-#

-# Copyright 2001-2007,2009,2012 Free Software Foundation, Inc.

-#

-# This file is part of GNU Radio

-#

-# GNU Radio is free software; you can redistribute it and/or modify

-# it under the terms of the GNU General Public License as published by

-# the Free Software Foundation; either version 3, or (at your option)

-# any later version.

-#

-# GNU Radio is distributed in the hope that it will be useful,

-# but WITHOUT ANY WARRANTY; without even the implied warranty of

-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

-# GNU General Public License for more details.

-#

-# You should have received a copy of the GNU General Public License

-# along with GNU Radio; see the file COPYING. If not, write to

-# the Free Software Foundation, Inc., 51 Franklin Street,

-# Boston, MA 02110-1301, USA.

-#

-

-Welcome to GNU Radio!

-

-

-Please see http://gnuradio.org for the wiki, bug tracking,

-and source code viewer.

-

-If you've got questions about GNU Radio, please subscribe to the

-discuss-gnuradio mailing list and post your questions there.

-http://gnuradio.org/redmine/projects/gnuradio/wiki/MailingLists

-

-There is also a "Build Guide" in the wiki that contains OS specific

-recommendations:

-http://gnuradio.org/redmine/projects/gnuradio/wiki/BuildGuide

-

-

-The bleeding edge code can be found in our git repository at

-http://gnuradio.org/git/gnuradio.git/. To checkout the latest, use

-this command:

-

- $ git clone git://git.gnuradio.org/gnuradio

-

-For information about using Git, please see:

-http://gnuradio.org/redmine/projects/gnuradio/wiki/DevelopingWithGit

-

-

-How to Build GNU Radio:

-

-For more complete instructions, see the "Building GNU Radio" page in

-the GNU Radio manual (can be built or found online at

-http://gnuradio.org/doc/doxygen/build_guide.html).

-

-See these steps for a quick build guide.

-

- (1) Ensure that you've satisfied the external dependencies. These

- dependencies are listed in the manual's build page and are not

- presented here to reduce duplication errors.

-

- See the wiki at http://gnuradio.org for details.

-

-

- (2) Building from cmake:

-

- $ mkdir $(builddir)

- $ cd $(builddir)

- $ cmake [OPTIONS] $(srcdir)

- $ make

- $ make test

- $ sudo make install

-

-

-That's it!

-

-Options:

-Useful options include setting the install prefix and the build type:

-

- -DCMAKE_INSTALL_PREFIX=<directory to install to>

- -DCMAKE_BUILD_TYPE="<type>"

-

-Currently, GNU Radio has a "Debug" type that builds with '-g -O2'

-useful for debugging the software and a "Release" type that builds

-with '-O3', which is the default.

-

-

--------------------------------------------------------------------------------

-

- KNOWN INCOMPATIBILITIES

-

-

- GNU Radio triggers bugs in g++ 3.3 for X86. DO NOT USE GCC 3.3 on

- the X86 platform. g++ 3.2, 3.4, and the 4.* series are known to work well.

-

--------------------------------------------------------------------------------

-

--------------------------------------------------------------------------------

-

- NOTES

-

--------------------------------------------------------------------------------

-

-To run the examples you may need to set PYTHONPATH. Note that the

-prefix and python version number in the path needs to match your

-installed version of python.

-

- $ export PYTHONPATH=/usr/local/lib/python2.7/dist-packages

-

-You may want to add this to your shell init file (~/.bash_profile if

-you use bash).

-

-

-Another handy trick if for example your fftw includes and libs are

-installed in, say ~/local/include and ~/local/lib, instead of

-/usr/local is this:

-

- $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$HOME/local/lib

- $ make CPPFLAGS="-I$HOME/local/include"

-

-

-Sometimes the prerequisites are installed in a location which is not

-included in the default compiler and linker search paths. This

-happens with pkgsrc and NetBSD. To build, tell configure to use these

-locations:

-

- LDFLAGS="-L/usr/pkg/lib -R/usr/pkg/lib" CPPFLAGS="-I/usr/pkg/include" ./configure --prefix=/usr/gnuradio

-

-

--------------------------------------------------------------------------------

-

- Legal Matters

-

--------------------------------------------------------------------------------

-

-Some files have been changed many times throughout the

-years. Copyright notices at the tops of these files list which years

-changes have been made. For some files, changes have occurred in many

-consecutive years. These files may often have the format of a year

-range (e.g., "2006 - 2011"), which indicates that these files have had

-copyrightable changes made during each year in the range, inclusive.

-