--- al.c 2002/10/17 14:16:51 1.17
+++ al.c 2002/10/17 15:02:49 1.18
@@ -1,5 +1,5 @@
/*
-** OSSP al -- Assembly Lists
+** OSSP al -- Assembly Line
** Copyright (c) 2002 The OSSP Project <http://www.ossp.org/>
** Copyright (c) 2002 Cable & Wireless Deutschland <http://www.cw.com/de/>
** Copyright (c) 2002 Ralf S. Engelschall <rse@engelschall.com>
@@ -26,7 +26,7 @@
** OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
** SUCH DAMAGE.
**
-** al.c: assembly lists library implementation
+** al.c: assembly line library implementation
*/
#include <stddef.h>
@@ -498,7 +498,7 @@
/****************************************************************************/
/*
- * allocate an empty assembly list
+ * allocate an empty assembly line
* dispose all chunks and all allocated backing store
*/
al_rc_t al_create(al_t **alp)
@@ -509,7 +509,7 @@
if (alp == NULL)
return AL_RC(AL_ERR_ARG);
- /* allocate and initialize new assembly list object */
+ /* allocate and initialize new assembly line object */
/* XXX - what malloc ? */
if ((al = (al_t *)malloc(sizeof(al_t))) == NULL)
return AL_RC(AL_ERR_MEM);
@@ -681,7 +681,7 @@
}
/*
- * this is the central function to manipulate assembly lists
+ * this is the central function to manipulate assembly line
*
* cut arbitrary spans from list into a destination buffer (or drop it)
* insert (destructive move) content from another list into the cut
@@ -873,7 +873,7 @@
}
/*
- * list traversal requires a context. It needs to be
+ * assembly line traversal requires a context. It needs to be
* malloced to keep its inner structure private
*/
al_rc_t al_txalloc(al_t *al, al_tx_t **txp)
@@ -898,7 +898,7 @@
}
/*
- * initiate list traversal
+ * initiate assembly line traversal
*
* - do initial seek, fail if position does not exist
* - save traversal parameters
@@ -919,9 +919,9 @@
}
/*
- * list traversal step
+ * assembly line traversal step
*
- * return EOF if at end of list
+ * return EOF if at end of assembly line
* clip view chunk to traversal bounds
* advance chunk cursor according to traversal direction
*/
@@ -966,7 +966,7 @@
}
/*
- * full list traversal with callback
+ * full assembly line traversal with callback
*
* traversal is aborted when callback return != AL_OK
* reaching EOF (and also aborting with AL_ERR_EOF) is not an error
@@ -996,7 +996,7 @@
}
/*
- * full list traversal with data copy to linear buffer
+ * full assembly line traversal with data copy to linear buffer
*
* returns actual number of bytes copied
*
@@ -1030,7 +1030,7 @@
}
/*
- * full list traversal with data copy to target assembly list
+ * full assembly line traversal with data copy to target assembly line
*
* traversal context is kept on stack (XXX ?)
*/
@@ -1058,7 +1058,7 @@
/*
* relay macros to caller
*
- * al_bytes - total number of bytes in list
+ * al_bytes - total number of bytes in assembly line
* al_chunk_len - number of bytes in chunk
* al_chunk_span - clip interval (off,off+n( against chunk length
* al_chunk_ptr - return memory pointer to byte within chunk
|
