From 954e614cb2c4f9584ce36b53b9a1981def1a20a8 Mon Sep 17 00:00:00 2001 From: Olaf Barthel Date: Sun, 20 Nov 2005 19:56:58 +0000 Subject: [PATCH] - Fixed the remaining HTML errors. git-svn-id: file:///Users/olsen/Code/migration-svn-zu-git/logical-line-staging/clib2/trunk@15067 87f5fb63-7c3d-0410-a384-fd976d0f7a62 --- documentation/README.html | 57 +++++++++++++++++++++++++++++++-------- 1 file changed, 46 insertions(+), 11 deletions(-) diff --git a/documentation/README.html b/documentation/README.html index bd91602..328021a 100644 --- a/documentation/README.html +++ b/documentation/README.html @@ -126,7 +126,7 @@ much about the environment GCC expects, I borrowed code snippets from libnix, which was written by Matthias Fleischer and Gunther Nikl. This in particular concerns the integer and floating point math support, the setjmp/longjmp routines and the startup code. The M68881 inline math code comes from the -<math-68881.h> file written by Matthew Self (self@bayes.arc.nasa.gov).

+<math-68881.h> file written by Matthew Self (self [at] bayes.arc.nasa.gov).

5. Limitations and caveats

@@ -175,7 +175,7 @@ if simultaneous and overlapping accesses to files, memory allocation and other resources are taking place.

Also take care with file I/O involving the stdin/stdout/stderr -streams; read/write operations on these streams will be mapped to the Input()/Output()/ErrorOutput() +streams; read/write operations on these streams will be mapped to the Input()/Output()/ErrorOutput() file handles of the process performing these operations. Since only this small set of operations is mapped, functions such as fcntl() or select() will not work on the stdin/stdout/stderr streams and the corresponding @@ -201,7 +201,7 @@ You will have to modify this to look like this: lib: %{pg: -lprofile} --start-group -lc --end-group -Normally, the specs file is located at the compilers installation directory. For cross-compilers, +

Normally, the specs file is located at the compilers installation directory. For cross-compilers, this is /usr/local/amiga/lib/gcc/ppc-amigaos/compiler-version/specs. For a native compiler, it's in gcc:lib/gcc/ppc-amigaos/compiler-version/specs. Most likely, your compiler will already have this added to it's specs file.

@@ -255,6 +255,9 @@ want to add the option -lm -lc to the linker command line.

The exception handling is currently entirely out of control of the developer and solely subject to the rules imposed by the operating system itself.

+

The fmod() function returns the value of the x parameter and +sets errno to EDOM if the y parameter value is 0.

+

5.6.2. Library functions

5.6.2.1. NULL
@@ -297,7 +300,7 @@ in a requester window. The diagnostic message shown in this window will take the

The Ctrl+C event is translated into SIGINT. Signal delivery may delayed until a library function which polls for the signal examines it. This means, for example, that -a runaway program called in an infinite loop cannot be aborted by sending it a Ctrl+C event.

+a runaway program called in an infinite loop cannot be aborted by sending it a Ctrl+C event.

Processing of the Ctrl+C event involves the internal __check_abort() function which polls for the presence of the event and which will call raise(SIGINT);. The __check_abort() @@ -315,7 +318,9 @@ function may be replaced by user code.

There is no difference between text and binary streams.

-

Writing to a text or binary stream does not truncate the associated file.

+

Writing to a text or binary stream does not truncate the associated file. A stream may be +truncated by the initial fopen() call if the mode parameter starts with +the letter w.

The file position indicator is initially set to the end of an append mode stream.

@@ -324,6 +329,10 @@ function may be replaced by user code.

The %p conversion is the hexadecimal representation of the pointer, and it is preceded by the string 0x.

+

The %a, %e, %f, %g, %A, +%E, %F and %G specifiers will produce the string inf +for infinity.

+
5.6.2.6. scanf() family

The input for the %p conversion must be a hexadecimal number, @@ -365,10 +374,10 @@ will remove the file when the program exits or the file is closed.

5.6.2.10. abort()
-

The abort() function will flush all buffered files and -close all the files currently open. Memory allocated will be freed. +

The abort() function will flush all buffered files, +close all the files currently open and delete temporary files.

-
5.6.2.11. exit()
+
5.6.2.11. exit() and _Exit()

The value passed to the exit() function will be passed to the Amiga operating system. The value of EXIT_FAILURE is equivalent @@ -378,13 +387,33 @@ of EXIT_SUCCESS is equivalent to RETURN_OK as defined in the Amiga system header file <dos/dos.h>; this value maps to the number 0.

-
5.6.2.11. Time
+

The _Exit() function will flush all buffered files, +close all the files currently open and delete temporary files.

+ +
5.6.2.12. getenv()
+ +

Environment data is retrieved from the global Amiga operating system environment +storage area through the dos.library/GetEnv() function. Global variables are +stored in files in the ENV: directory.

+ +
5.6.2.13. system()
+ +

If the command parameter is not NULL and the system() function returns, then the result will +be equivalent to the exit code of the program invoked, or -1 if the program could not be started. +This follows the behaviour of the Amiga operating system function dos.library/System(). +A return value of 0 typically indicates successful execution and a value > 0 +typically indicates failure.

+ +
5.6.2.15. Time

The default time zone is derived from the Amiga operating system locale settings and takes the form GMT+hh or GMT-hh, -respectively in which hh stands for the difference between the local +respectively, in which hh stands for the difference between the local time zone and Greenwich Mean Time.

+

The clock_t and time_t types are unsigned 32 bit integers. +The time_t epoch starts with midnight January 1st, 1970.

+

Daylight savings time is not supported.

The reference point used by the clock() function is the time @@ -396,6 +425,12 @@ when the program was started.

The period (.) is the decimal-point character.

+

The strftime() behaviour follows the Amiga operating system locale +settings. If the 'C' locale is in effect, then the output generated by the +%Z takes the form GMT+hh or GMT-hh, +respectively, in which hh stands for the difference between the local +time zone and Greenwich Mean Time.

+

6. Conventions and design issues

You will have noticed the 330+ files in this directory. This is not the best @@ -494,6 +529,6 @@ can reach me at:

Or via e-mail:

-

olsen@sourcery.han.de

+

olsen [at] sourcery.han.de