4 files changed, 9 insertions, 5 deletions
diff --git a/gnuradio-core/src/lib/general/gr_descrambler_bb.h b/gnuradio-core/src/lib/general/gr_descrambler_bb.h
index 4fd8f4a0f..9e66ceff2 100644
--- a/gnuradio-core/src/lib/general/gr_descrambler_bb.h
+++ b/gnuradio-core/src/lib/general/gr_descrambler_bb.h
@@ -31,7 +31,9 @@ typedef boost::shared_ptr<gr_descrambler_bb> gr_descrambler_bb_sptr;
 gr_descrambler_bb_sptr gr_make_descrambler_bb(int mask, int seed, int len);
 
 /*!
- * \brief Descramble an input stream using an LFSR
+ * Descramble an input stream using an LFSR.  This block works on the LSB only
+ * of the input data stream, i.e., on an "unpacked binary" stream, and
+ * produces the same format on its output.
  * 
  * \param mask     Polynomial mask for LFSR
  * \param seed     Initial shift register contents
diff --git a/gnuradio-core/src/lib/general/gr_scrambler_bb.h b/gnuradio-core/src/lib/general/gr_scrambler_bb.h
index a01b08dd6..1dfa60dfb 100644
--- a/gnuradio-core/src/lib/general/gr_scrambler_bb.h
+++ b/gnuradio-core/src/lib/general/gr_scrambler_bb.h
@@ -31,7 +31,9 @@ typedef boost::shared_ptr<gr_scrambler_bb> gr_scrambler_bb_sptr;
 gr_scrambler_bb_sptr gr_make_scrambler_bb(int mask, int seed, int len);
 
 /*!
- * \brief Scramble an input stream using an LFSR
+ * Scramble an input stream using an LFSR.  This block works on the LSB only
+ * of the input data stream, i.e., on an "unpacked binary" stream, and 
+ * produces the same format on its output.
  * 
  * \param mask     Polynomial mask for LFSR
  * \param seed     Initial shift register contents
diff --git a/gnuradio-core/src/lib/general/gri_lfsr.h b/gnuradio-core/src/lib/general/gri_lfsr.h
index b6eee7679..090caab82 100644
--- a/gnuradio-core/src/lib/general/gri_lfsr.h
+++ b/gnuradio-core/src/lib/general/gri_lfsr.h
@@ -1,6 +1,6 @@
 /* -*- c++ -*- */
 /*
- * Copyright 2007 Free Software Foundation, Inc.
+ * Copyright 2008 Free Software Foundation, Inc.
  * 
  * This file is part of GNU Radio
  * 
@@ -73,7 +73,7 @@
  *  next_bit_descramble(unsigned char input) - Descramble an input stream
  *
  *      Perform one cycle of the LFSR.  The output bit is taken from 
- *      the modulo-2 sum of the masked shift register and the input LSB.
+ *      the modulo 2 sum of the masked shift register and the input LSB.
  *      The shift register MSB is assigned from the LSB of the input.
  *
  * See http://en.wikipedia.org/wiki/Scrambler for operation of these
diff --git a/gnuradio-core/src/lib/general/qa_gri_lfsr.cc b/gnuradio-core/src/lib/general/qa_gri_lfsr.cc
index 2d4346ace..fb2ca06c0 100644
--- a/gnuradio-core/src/lib/general/qa_gri_lfsr.cc
+++ b/gnuradio-core/src/lib/general/qa_gri_lfsr.cc
@@ -58,7 +58,7 @@ void
 qa_gri_lfsr::test_scrambler()
 {
   // CCSDS 7-bit scrambler
-  int mask = 0x8A; // 1+x^4+X^6 
+  int mask = 0x8A;
   int seed = 0x7F;
   int length = 7;