Forced new documentation style on readwrite library.

diff --git a/src/readwrite.c b/src/readwrite.c
index 761497021e1af9cce25cdd441f19cb1f9898e366..cdee90bbecbc62027aa7a5b55fe14b7ed4842a6d 100644 (file)
--- a/src/readwrite.c
+++ b/src/readwrite.c
@@ -1,3 +1,5 @@
+/*  readwrite.c */
+
 #include "readwrite.h"
 #include <stdio.h>
 #include <stdint.h>
@@ -6,13 +8,11 @@
 static const uint16_t uchar_s = UCHAR_MAX + 1;
 
 extern uint16_t read_uint16_bigendian(FILE * file) {
-// Read uint16 from file in big-endian order.
   unsigned char a = fgetc(file);
   unsigned char b = fgetc(file);
   return (a * uchar_s) + b; }
 
 extern uint32_t read_uint32_bigendian(FILE * file) {
-// Read uint32 from file in big-endian order.
   unsigned char a = fgetc(file);
   unsigned char b = fgetc(file);
   unsigned char c = fgetc(file);
@@ -20,14 +20,12 @@ extern uint32_t read_uint32_bigendian(FILE * file) {
   return (a * uchar_s * uchar_s * uchar_s) + (b * uchar_s * uchar_s) + (c * uchar_s) + d; }
 
 extern void write_uint16_bigendian(uint16_t x, FILE * file) {
-// Write uint16 to file in beg-endian order.
   unsigned char a = x / uchar_s;
   unsigned char b = x % uchar_s;
   fputc(a, file);
   fputc(b, file); }
 
 extern void write_uint32_bigendian(uint32_t x, FILE * file) {
-// Write uint32 to file in beg-endian order.
   unsigned char a = x / (uchar_s * uchar_s * uchar_s);
   unsigned char b = (x - (a * uchar_s * uchar_s * uchar_s)) / (uchar_s * uchar_s);
   unsigned char c = (x - ((a * uchar_s * uchar_s * uchar_s) + (b * uchar_s * uchar_s))) / uchar_s;

diff --git a/src/readwrite.h b/src/readwrite.h
index a4b0973ea2d68e95d70c35a8e9888356d58661e4..348bb8d7335332b7f5d714b490ce2b9d6c10759f 100644 (file)
--- a/src/readwrite.h
+++ b/src/readwrite.h
@@ -1,3 +1,9 @@
+/*   readwrite.h:
+ *
+ *   Routines for reading/writing multibyte data from/to files. They ensure a
+ *   defined endianness.
+ */
+
 #ifndef READWRITE_H
 #define READWRITE_H
 
@@ -6,7 +12,7 @@
 
 extern uint16_t read_uint16_bigendian(FILE * file);
 extern uint32_t read_uint32_bigendian(FILE * file);
-extern void write_uint16_bigendian(uint16_t x, FILE * file);
-extern void write_uint32_bigendian(uint32_t x, FILE * file);
+extern void     write_uint16_bigendian(uint16_t x, FILE * file);
+extern void     write_uint32_bigendian(uint32_t x, FILE * file);
 
 #endif