summaryrefslogtreecommitdiff
path: root/gnuradio-core/src/python/gnuradio
diff options
context:
space:
mode:
Diffstat (limited to 'gnuradio-core/src/python/gnuradio')
-rw-r--r--gnuradio-core/src/python/gnuradio/__init__.py13
-rw-r--r--gnuradio-core/src/python/gnuradio/blks2/__init__.py3
-rw-r--r--gnuradio-core/src/python/gnuradio/eng_notation.py3
-rw-r--r--gnuradio-core/src/python/gnuradio/gr/__init__.py4
-rwxr-xr-xgnuradio-core/src/python/gnuradio/gr_unittest.py3
5 files changed, 25 insertions, 1 deletions
diff --git a/gnuradio-core/src/python/gnuradio/__init__.py b/gnuradio-core/src/python/gnuradio/__init__.py
index a4917cf64c..d55dac79db 100644
--- a/gnuradio-core/src/python/gnuradio/__init__.py
+++ b/gnuradio-core/src/python/gnuradio/__init__.py
@@ -1 +1,12 @@
-# make this a package
+"""
+GNU Radio is a free & open-source software development toolkit that provides signal processing blocks to implement software radios. It can be used with readily-available low-cost external RF hardware to create software-defined radios, or without hardware in a simulation-like environment. It is widely used in hobbyist, academic and commercial environments to support both wireless communications research and real-world radio systems.
+
+GNU Radio applications are primarily written using the Python programming language, while the supplied performance-critical signal-processing path is implemented in C++ using processor floating-point extensions, where available. Thus, the developer is able to implement real-time, high-throughput radio systems in a simple-to-use, rapid-application-development environment.
+
+While not primarily a simulation tool, GNU Radio does support development of signal processing algorithms using pre-recorded or generated data, avoiding the need for actual RF hardware.
+
+GNU Radio is licensed under the GNU General Public License (GPL) version 3. All of the code is copyright of the Free Software Foundation.
+"""
+
+# This file makes gnuradio a package
+# The docstring will be associated with the top level of the package.
diff --git a/gnuradio-core/src/python/gnuradio/blks2/__init__.py b/gnuradio-core/src/python/gnuradio/blks2/__init__.py
index 2dfdc77f46..1d3203ec79 100644
--- a/gnuradio-core/src/python/gnuradio/blks2/__init__.py
+++ b/gnuradio-core/src/python/gnuradio/blks2/__init__.py
@@ -18,6 +18,9 @@
# the Free Software Foundation, Inc., 51 Franklin Street,
# Boston, MA 02110-1301, USA.
#
+"""
+Miscellaneous contents implemented in python.
+"""
import glob
import os.path
diff --git a/gnuradio-core/src/python/gnuradio/eng_notation.py b/gnuradio-core/src/python/gnuradio/eng_notation.py
index c552a45f55..d23f9005f0 100644
--- a/gnuradio-core/src/python/gnuradio/eng_notation.py
+++ b/gnuradio-core/src/python/gnuradio/eng_notation.py
@@ -18,6 +18,9 @@
# the Free Software Foundation, Inc., 51 Franklin Street,
# Boston, MA 02110-1301, USA.
#
+"""
+Display numbers as strings using engineering notation.
+"""
scale_factor = {}
scale_factor['E'] = 1e18
diff --git a/gnuradio-core/src/python/gnuradio/gr/__init__.py b/gnuradio-core/src/python/gnuradio/gr/__init__.py
index 602d1119fb..525c06cf5d 100644
--- a/gnuradio-core/src/python/gnuradio/gr/__init__.py
+++ b/gnuradio-core/src/python/gnuradio/gr/__init__.py
@@ -21,6 +21,10 @@
# The presence of this file turns this directory into a Python package
+"""
+Core contents.
+"""
+
# This is the main GNU Radio python module.
# We pull the swig output and the other modules into the gnuradio.gr namespace
diff --git a/gnuradio-core/src/python/gnuradio/gr_unittest.py b/gnuradio-core/src/python/gnuradio/gr_unittest.py
index e4510a6eb9..c729566e88 100755
--- a/gnuradio-core/src/python/gnuradio/gr_unittest.py
+++ b/gnuradio-core/src/python/gnuradio/gr_unittest.py
@@ -19,6 +19,9 @@
# the Free Software Foundation, Inc., 51 Franklin Street,
# Boston, MA 02110-1301, USA.
#
+"""
+GNU radio specific extension of unittest.
+"""
import unittest
import gr_xmlrunner