- minor improvements to tio and sio

- renamed extio to eio in awk
- renamed qse_awk_run_t to qse_awk_rtx_t

qse/include/qse/cmn/fio.h

@@ -88,6 +88,9 @@ typedef struct qse_fio_lck_t qse_fio_lck_t;
 
 struct qse_fio_t
 {
+	/* note that qse_fio_t is instantiated statically 
+	 * in sio.c. make sure that you update the static instantiation
+	 * when you change the structure of qse_fio_t */
 	QSE_DEFINE_STD_FIELDS (fio)
 	int           errnum;
 	qse_fio_hnd_t handle;
@@ -204,6 +207,12 @@ qse_ssize_t qse_fio_read (
 /****f* qse.cmn.fio/qse_fio_write
  * NAME
  *  qse_fio_write - write data
+ *
+ * DESCRIPTION
+ *  If QSE_FIO_TEXT is used and the size parameter is (qse_size_t)-1,
+ *  the function treats the data parameter as a pointer to a null-terminated
+ *  string.
+ * 
  * SYNOPSIS
  */
 qse_ssize_t qse_fio_write (

qse/include/qse/cmn/sio.h

@@ -95,9 +95,8 @@ void qse_sio_purge (
 	qse_sio_t* sio
 );
 
-#if 0
 qse_ssize_t qse_sio_getc (
-	qse_sio_t* sio,
+	qse_sio_t*  sio,
 	qse_char_t* c
 );
 
@@ -107,10 +106,10 @@ qse_ssize_t qse_sio_gets (
 	qse_size_t size
 );
 
-
-qse_ssize_t qse_sio_getstr (
-	qse_sio_t* sio, 
-	qse_str_t* buf
+qse_ssize_t qse_sio_getsn (
+	qse_sio_t*  sio,
+	qse_char_t* buf,
+	qse_size_t  size
 );
 
 qse_ssize_t qse_sio_putc (
@@ -122,24 +121,28 @@ qse_ssize_t qse_sio_puts (
 	qse_sio_t*        sio,
 	const qse_char_t* str
 );
-#endif
 
-qse_ssize_t qse_sio_read (
-	qse_sio_t*  sio,
-	qse_char_t* buf,
-	qse_size_t  size
-);
-
-qse_ssize_t qse_sio_write (
+qse_ssize_t qse_sio_putsn (
 	qse_sio_t*        sio, 
 	const qse_char_t* str,
 	qse_size_t        size
 );
 
+/****f* qse.cmn.sio/qse_sio_getpos
+ * NAME
+ *  qse_sio_getpos - get the stream position
+ *
+ * WARNING
+ *  The getpos() function may not return the desired postion because of 
+ *  buffering.
+ *
+ * SYNOPSIS
+ */
 int qse_sio_getpos (
 	qse_sio_t*     sio, 
 	qse_sio_pos_t* pos
 );
+/******/
 
 int qse_sio_setpos (
 	qse_sio_t*    sio, 
@@ -147,14 +150,6 @@ int qse_sio_setpos (
 );
 
 #if 0
-qse_ssize_t qse_sio_putsn (qse_sio_t* sio, ...);
-qse_ssize_t qse_sio_putsxn (qse_sio_t* sio, ...);
-qse_ssize_t qse_sio_putsv (qse_sio_t* sio, qse_va_list ap);
-qse_ssize_t qse_sio_putsxv (qse_sio_t* sio, qse_va_list ap);
-
-/* WARNING:
- *   getpos may not return the desired postion because of the buffering 
- */
 int qse_sio_rewind (qse_sio_t* sio);
 int qse_sio_movetoend (qse_sio_t* sio);
 #endif

qse/include/qse/cmn/tio.h

@@ -263,6 +263,12 @@ qse_ssize_t qse_tio_read (
 /******/
 
 /****f* qse.cmn.tio/qse_tio_write
+ * NAME
+ *  qse_tio_write - write text
+ * 
+ * DESCRIPTION
+ *  If the size paramenter is (qse_size_t)-1, the function treats the data 
+ *  parameter as a pointer to a null-terminated string.
  *
  * SYNOPSIS
  */