Comment cleanups.

[pdclib] / platform / example_cygwin / functions / _PDCLIB / flushbuffer.c

diff --git a/platform/example_cygwin/functions/_PDCLIB/flushbuffer.c b/platform/example_cygwin/functions/_PDCLIB/flushbuffer.c
index c2ac98d8ef8aac286460ede9a2e4aa8dcf326e7e..713e903f7390cd1e7c8c5559d5c00c7cc577972d 100644 (file)
--- a/platform/example_cygwin/functions/_PDCLIB/flushbuffer.c
+++ b/platform/example_cygwin/functions/_PDCLIB/flushbuffer.c
@@ -1,5 +1,3 @@
-/* $Id$ */
-
 /* _PDCLIB_flushbuffer( struct _PDCLIB_file_t * )
 
    This file is part of the Public Domain C Library (PDCLib).
@@ -50,6 +48,10 @@ int _PDCLIB_flushbuffer( struct _PDCLIB_file_t * stream )
             /* Write error */
             switch ( errno )
             {
+                /* See <_PDCLIB_config.h>. There should be differenciated errno
+                   handling here, possibly even a 1:1 mapping; but that is up
+                   to the individual platform.
+                */
                 case EBADF:
                 case EFAULT:
                 case EFBIG:
@@ -58,10 +60,11 @@ int _PDCLIB_flushbuffer( struct _PDCLIB_file_t * stream )
                 case EIO:
                 case ENOSPC:
                 case EPIPE:
-                    _PDCLIB_errno = _PDCLIB_EIO;
+                    _PDCLIB_errno = _PDCLIB_ERROR;
                     break;
                 default:
-                    _PDCLIB_errno = _PDCLIB_EUNKNOWN;
+                    /* This should be something like EUNKNOWN. */
+                    _PDCLIB_errno = _PDCLIB_ERROR;
                     break;
             }
             stream->status |= _PDCLIB_ERRORFLAG;
@@ -79,7 +82,10 @@ int _PDCLIB_flushbuffer( struct _PDCLIB_file_t * stream )
             return 0;
         }
     }
-    _PDCLIB_errno = _PDCLIB_ERETRY;
+    /* Number of retries exceeded. You probably want a different errno value
+       here.
+    */
+    _PDCLIB_errno = _PDCLIB_ERROR;
     stream->status |= _PDCLIB_ERRORFLAG;
     /* Move unwritten remains to begin of buffer. */
     stream->bufidx -= written;