update comments

diff --git a/src/ieee754/fpdiv/div0.py b/src/ieee754/fpdiv/div0.py
index 45a5f971fa8bf617dc47084770acc884d90ebcc4..167edde662eda12b7b774474ba09359b039c5ec3 100644 (file)
--- a/src/ieee754/fpdiv/div0.py
+++ b/src/ieee754/fpdiv/div0.py
@@ -60,9 +60,9 @@ class FPDivStage0Mod(Elaboratable):
         m = Module()
 
         # XXX TODO, actual DIV code here.  this class would be
-        # "step one" which takes the pre-normalised data and
+        # "step one" which takes the pre-normalised data (see ispec) and
         # *begins* the processing phase (enters the massive DIV
-        # pipeline chain)
+        # pipeline chain) - see ospec.
 
         # store intermediate tests (and zero-extended mantissas)
         am0 = Signal(len(self.i.a.m)+1, reset_less=True)

diff --git a/src/ieee754/fpdiv/div1.py b/src/ieee754/fpdiv/div1.py
index 52edde60fb364b40f48a40a448d71bf6013a4e7f..5ceff1fe1d939ebb438e6ac53ea11066ddbfae26 100644 (file)
--- a/src/ieee754/fpdiv/div1.py
+++ b/src/ieee754/fpdiv/div1.py
@@ -1,4 +1,4 @@
-"""IEEE754 Floating Point Divider 
+"""IEEE754 Floating Point Divider
 
 Relevant bugreport: http://bugs.libre-riscv.org/show_bug.cgi?id=99
 """
@@ -21,10 +21,10 @@ class FPDivStage1Mod(Elaboratable):
         self.o = self.ospec()
 
     def ispec(self):
-        return FPDivStage0Data(self.width, self.id_wid)
+        return FPDivStage0Data(self.width, self.id_wid) # Q/Rem (etc) in...
 
     def ospec(self):
-        return FPDivStage0Data(self.width, self.id_wid)
+        return FPDivStage0Data(self.width, self.id_wid) # ... Q/Rem (etc) out
 
     def process(self, i):
         return self.o
@@ -40,7 +40,8 @@ class FPDivStage1Mod(Elaboratable):
 
         # XXX TODO, actual DIV code here.  this class would be
         # "step two" and is the main "chain".  tons of these needed.
-        # here is where Q and R are used, TODO: those are in FPDivStage0Data.
+        # here is where Q and R are used, TODO: those need to be in
+        # FPDivStage0Data.
 
         # store intermediate tests (and zero-extended mantissas)
         am0 = Signal(len(self.i.a.m)+1, reset_less=True)

diff --git a/src/ieee754/fpdiv/div2.py b/src/ieee754/fpdiv/div2.py
index 051e87029222616cc45e1557c04de28a73fe9718..6b9be39c4da67405551e4df7e51286be1c71fa3a 100644 (file)
--- a/src/ieee754/fpdiv/div2.py
+++ b/src/ieee754/fpdiv/div2.py
@@ -22,10 +22,10 @@ class FPDivStage2Mod(FPState, Elaboratable):
         self.o = self.ospec()
 
     def ispec(self):
-        return FPDivStage0Data(self.width, self.id_wid)
+        return FPDivStage0Data(self.width, self.id_wid) # Q/Rem in...
 
     def ospec(self):
-        return FPAddStage1Data(self.width, self.id_wid)
+        return FPAddStage1Data(self.width, self.id_wid) # out to post-process
 
     def process(self, i):
         return self.o