diff --git a/jtms3.txt b/jtms3.txt
index 830993e36..d057fb8fe 100644
--- a/jtms3.txt
+++ b/jtms3.txt
@@ -4,21 +4,21 @@
 1. Transmitting
 
 Messages are sent character-by character, 6 bits plus even parity.
-Message length can be one of {5 7 9 11 13 17 19 23 29}; if necessary
-the message is padded with blanks to the next available length.  No
-other FEC is used.
+Message length can be one of {5 7 9 11 13 17 19 23 29}; messages are
+padded with blanks up to the next available length.  
 
 Modulation is BPSK at 2000 baud.  The baseband waveform is built by
 inserting a tapered sinc function for each bit, then multiplying by a
-sine wave at frequency f0 = 10000.0/7 = 1428.57 Hz.  Agt sample rate
-48000 Hz there are 24 samples per PSK symbol and 7*24=168 samples per
-character.  The carrier phase increment over one character is 
-f0*(168/48000) = 5 cycles.  
+sine wave at frequency f0 = 10000.0/7 = 1428.57 Hz.  At fsample=48000
+Hz there are 24 samples per PSK symbol and 7*24=168 samples per
+character.  Carrier phase increment over one character is
+f0*(168/48000) = 5 cycles, exactly.
 
 2. Receiving
 
   a. Pings are detected (or mouse-picked data is selected) as in
-     WSJT9.
+     WSJT9.  Pings can also be detected from the squared analytic
+     signal.  Experience may tell which is better.
 
   b. Compute real-to-complex FFT.  Zap birdies, remove frequency 
      components outside the range 300 - 2700 Hz, and convert to analytic
diff --git a/libm65/specjtms.f90 b/libm65/specjtms.f90
index 37f35e1e3..d76e5eb9a 100644
--- a/libm65/specjtms.f90
+++ b/libm65/specjtms.f90
@@ -1,6 +1,6 @@
 subroutine specjtms(k,px,pxsmo,spk0,f0)
 
-! Starting code for a JTMS3 decoder.
+! Compute noise level and 2D spectra, for GUI display.
 
   parameter (NSMAX=30*48000)
   parameter (MAXFFT=8192)
diff --git a/mainwindow.cpp b/mainwindow.cpp
index 354eae65b..cdaf00d10 100644
--- a/mainwindow.cpp
+++ b/mainwindow.cpp
@@ -1,4 +1,4 @@
-//-------------------------------------------------------------- MainWindow
+//--------------------------------------------------------------- MainWindow
 #include "mainwindow.h"
 #include "ui_mainwindow.h"
 #include "devsetup.h"