documentation comments

diff --git a/iwjpictest/copybits.asm b/iwjpictest/copybits.asm
index a4047114d3e7140f5d6a170a1185617aafaae929..2efab6be2ceb811f1e2bd0274626062e37c3e5db 100644 (file)
--- a/iwjpictest/copybits.asm
+++ b/iwjpictest/copybits.asm
@@ -1,5 +1,13 @@
 ; -*- fundamental -*-
 
+; This program:
+;   * copies input signals from input pins to output pins, as shown in
+;     the `TEST-LEFT' and `TEST-RIGHT' PIC pinout diagrams;
+;   * flashes PER-PIC-LED (pin 21) and FLASHER (pin 2) in the
+;     pattern [high-low] with 50% duty cycle with period approx 660ms
+;     (assuming 20MHz clock input).
+;   * leaves all other pins set to their default states (usually Z).
+
        include         /usr/share/gputils/header/p18f458.inc
 
 ACCSFR         equ             0x0f00

diff --git a/iwjpictest/flasher.asm b/iwjpictest/flasher.asm
index 5e533723ee7215b3185d644d54a57477edb7aace..de5489aad7e912d87da54799676e5601d5d6b936 100644 (file)
--- a/iwjpictest/flasher.asm
+++ b/iwjpictest/flasher.asm
@@ -1,5 +1,11 @@
 ; -*- fundamental -*-
 
+; This program:
+;   * flashes PER-PIC-LED (pin 21) with the pattern
+;      [ L-H-Z L-H-L-H-Z L-H-L-H-L-H-Z ]
+;     where each state lasts approx. 160ms (at 20MHz clock).
+;   * leaves all other pins set to their default states (usually Z).
+
        include         /usr/share/gputils/header/p18f458.inc
 
 COUNTFAST      equ             0x00

diff --git a/iwjpictest/serialloop.asm b/iwjpictest/serialloop.asm
index a4047114d3e7140f5d6a170a1185617aafaae929..2efab6be2ceb811f1e2bd0274626062e37c3e5db 100644 (file)
--- a/iwjpictest/serialloop.asm
+++ b/iwjpictest/serialloop.asm
@@ -1,5 +1,13 @@
 ; -*- fundamental -*-
 
+; This program:
+;   * copies input signals from input pins to output pins, as shown in
+;     the `TEST-LEFT' and `TEST-RIGHT' PIC pinout diagrams;
+;   * flashes PER-PIC-LED (pin 21) and FLASHER (pin 2) in the
+;     pattern [high-low] with 50% duty cycle with period approx 660ms
+;     (assuming 20MHz clock input).
+;   * leaves all other pins set to their default states (usually Z).
+
        include         /usr/share/gputils/header/p18f458.inc
 
 ACCSFR         equ             0x0f00