# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1707608146 -3600
# Node ID d733978fa1fadd28254e58284109bec55a3de5a8
# Parent  fcc601d704670646717ee18b957249e70965f2d7
Adjusted comments.

diff -r fcc601d70467 -r d733978fa1fa pkg/devices/lib/dma/src/x1600.cc
--- a/pkg/devices/lib/dma/src/x1600.cc	Sun Feb 11 00:35:07 2024 +0100
+++ b/pkg/devices/lib/dma/src/x1600.cc	Sun Feb 11 00:35:46 2024 +0100
@@ -234,7 +234,8 @@
   }
 }
 
-// Transfer data between memory locations.
+// Transfer data between memory locations, returning the number of units that
+// should have been transferred.
 
 unsigned int
 Dma_x1600_channel::transfer(uint32_t source, uint32_t destination,
@@ -307,6 +308,9 @@
   return units;
 }
 
+// Wait for a transfer to end, returning the number of units remaining to be
+// transferred.
+
 unsigned int
 Dma_x1600_channel::wait()
 {
@@ -336,8 +340,6 @@
                                   Dma_trans_halted);
   _regs[Dma_transfer_count] = 0;
 
-  // Return the number of remaining units.
-
   return remaining;
 }