improve commenting

diff --git a/src/com/atmel/fpslic/FakeFpslic.java b/src/com/atmel/fpslic/FakeFpslic.java
index 53135c5..a6643ae 100644 (file)
--- a/src/com/atmel/fpslic/FakeFpslic.java
+++ b/src/com/atmel/fpslic/FakeFpslic.java
@@ -6,6 +6,7 @@ import java.util.*;
 import java.io.*;
 import org.ibex.util.Log;
 
+/** a dummy implementation of FpslicDevice */
 public class FakeFpslic extends FpslicDevice {
 
     public FakeFpslic(int width, int height) { super(width, height); }

diff --git a/src/com/atmel/fpslic/FpslicBootPins.java b/src/com/atmel/fpslic/FpslicBootPins.java
index d73638a..eb0b143 100644 (file)
--- a/src/com/atmel/fpslic/FpslicBootPins.java
+++ b/src/com/atmel/fpslic/FpslicBootPins.java
@@ -3,7 +3,8 @@ import com.ftdi.usb.*;
 import java.io.*;
 
 /**
- * Pin-level access to the bootstrap interface of the FPSLIC
+ * Pin-level access to the bootstrap interface of the FPSLIC; this
+ * interface is generally implemented by subclasses of Board.
  */
 public interface FpslicBootPins {
 

diff --git a/src/edu/berkeley/abits/Device.java b/src/edu/berkeley/abits/Device.java
index 7bf6639..d0199c5 100644 (file)
--- a/src/edu/berkeley/abits/Device.java
+++ b/src/edu/berkeley/abits/Device.java
@@ -1,5 +1,6 @@
 package edu.berkeley.abits;
 
+/** an actual FPGA */
 public interface Device {
 
     public int getWidth();