diff options
Diffstat (limited to '')
| -rw-r--r-- | README | 10 | ||||
| -rw-r--r-- | doc/info/chap/error-reporting.texinfo | 18 | ||||
| -rw-r--r-- | include/slibc-human.h | 2 | ||||
| -rw-r--r-- | src/slibc-human/machinesize.c | 2 |
4 files changed, 16 insertions, 16 deletions
@@ -60,13 +60,13 @@ COMMENTS functions would also be appreciated. FUTURE DIRECTIONS - The macro _SMALL_BINARY shall whenever available, create - macros that make the program use implementions of the functions - that optimised for size rather than performance. It should + The macro _SMALL_BINARY shall, whenever available, create + macros that make the program use implementations of the functions + that are optimised for size rather than performance. It should be compile-time selectable whether this macro has any effect, or if it is always in effect. _FAST_BINARY could also be added - to make the program use fast implementions when the library - is compiled to use the size optimised implementations. + to make the program use fast implementations when the library + is compiled to use the size-optimised implementations. RATIONALE slibc is written as a learning exercise, and for fun. diff --git a/doc/info/chap/error-reporting.texinfo b/doc/info/chap/error-reporting.texinfo index 44b43fc..baa6807 100644 --- a/doc/info/chap/error-reporting.texinfo +++ b/doc/info/chap/error-reporting.texinfo @@ -32,18 +32,18 @@ Most functions return a sentinel value when an exceptional condition occurs, typically a negative value (actually @code{-1}), a constant such as @code{EOF}, or @code{NULL}@. This return value only -tells you that an exeception condition has occurred. +tells you that an exception condition has occurred. @hfindex errno.h @lvindex errno By including the header file @file{<errno.h>}, the modifiable lvalue @code{errno} is made available. @sc{ISO}@tie{}C specifies that @code{errno} is not -necessarily a variable, but rather just an modifiable -lvalue. In fact, must @code{libc}:s, including -@code{slibc} defines it as a macro that calls a +necessarily a variable, but rather just a modifiable +lvalue. In fact, most @code{libc}:s, including +@code{slibc}, define it as a macro that calls a function and uses the unary @code{*}-operator on the -return. +return value. @code{errno} is often thought of as a variable declared as @code{int errno}, or @code{volatile int errno}. @@ -53,17 +53,17 @@ of this, the @code{errno} is defined as a macro that calls a function. Otherwise, it would not be implementable without @sc{ISO}@tie{}C11. -The value of @code{errno} is describes the error, +The value of @code{errno} describes the error, if and only if the function returned a value indicating -an error. Some, function can return the sentinel +an error. Some functions can return the sentinel value both on success and error. Therefore, the value @code{0} on @code{errno} means that the function returned after successful completion rather than on -failure. Exceptional conditions are describe by +failure. Exceptional conditions are described by non-zero values listed in @ref{Error codes}. The state of @code{errno} is undefined unless otherwise -specified after a succesful completion of a function call. +specified after a successful completion of a function call. This means that you, generally, cannot check whether an error has occurred by checking the value of @code{errno} rather than the return value. diff --git a/include/slibc-human.h b/include/slibc-human.h index 57a57c2..0fd550c 100644 --- a/include/slibc-human.h +++ b/include/slibc-human.h @@ -318,7 +318,7 @@ char* humansize(char*, size_t, size_t, enum humansize_mode, int, const char* res /** * Parses a human representation of storage size or file offset. * - * If no unit is used, bytes are assumed. If you rather it be + * If no unit is used, bytes are assumed. If you would rather it be * (for example) kilobytes, you can multiply it if * `strpbrk(str, "qwertyuiopasdfghjklzxcvbnmQWERTYUIOPASDFGHJKLZXCVBNM") == NULL`. * diff --git a/src/slibc-human/machinesize.c b/src/slibc-human/machinesize.c index 3c8a41a..46c6eb2 100644 --- a/src/slibc-human/machinesize.c +++ b/src/slibc-human/machinesize.c @@ -85,7 +85,7 @@ static size_t prefix(char** restrict str, enum machinesize_mode mode) /** * Parses a human representation of storage size or file offset. * - * If no unit is used, bytes are assumed. If you rather it be + * If no unit is used, bytes are assumed. If you would rather it be * (for example) kilobytes, you can multiply it if * `strpbrk(str, "qwertyuiopasdfghjklzxcvbnmQWERTYUIOPASDFGHJKLZXCVBNM") == NULL`. * |