Fix warnings

Add an up to date POSIX port (works on Mac OS X). This is fully functional except for strerror. Warning cleanup is to come.

Remove object files that had smuggled their way into the POSIX platform directories

_PDCLIB_float.h: add newline at end of file
_PDCLIB_int.h: provide way to override choice of int64_t

opt/nothread: add support for recursion

Move existing errno handling to tss_errno, to allow the POSIX platform to just use the underlying OS's errno implementation. Eventually, tss_errno will use the thread specific primitives.

Add hello world file which can be used to establish that the I/O routines are working

Jamfile, Jamrules: Convert to UNIX line endings

wcsncat test suite had a parameter which was a narrow string. whoops!

FIXES PDCLIB-20 by preserving _PDCLIB_STATUS flag

PDCLIB_scan: For %p, use E_long. This is a temporary change: Long term, we will be adding an E_pointer conversion

_PDCLIB_print: Change "written" unsigned -> int due to C promotion rules causing incorrect behaviour on 64-bit platforms

_PDCLIB_scan: Correct INT_MAX -> UINT_MAX when initializing width
vfprintf: Correct SIZE_MAX -> UINT_MAX when initializing width

posix: First pass at updated config file for POSIX platforms

win32: _PDCLIB_config.h cleaned up:
 * _PDCLIB_NOHANDLE removed (obsolete)
 * _PDCLIB_NORETURN removed (obsolete)
 * Temp name length was greated than max guaranteed file name length. This has obvious issus.

_PDCLIB_aux.h: Better detection of Clang and GCC features

_PDCLIB_seek: Incorrect specification (used int64_t where int_fast64_t was correct)

_PDCLIB_scan: Had incorrect upper bound on field width causing integer overflow

Add Sublime Text project file

PDCLIB-18: Unify fgetc under _PDCLIB_getchars. Also unify gets under _PDCLIB_getchars (gets also suffered from the bug)

PDCLIB-18: Add _PDCLIB_getchars to _PDCLIB_io.h. Change fread & fgets to go through this function.

All narrow character reads are going to be directed through this function

PDCLIB-19: Remove gets() when >=C11. Deprecated it universally.

PDCLIB-18: Implement defect test cases

PDCLIB-8: First phase of intergation of new I/O backend system (with minimal
disruption of existing code)
* _PDCLIB_fdopen: renamed _PDCLIB_fvopen to more clearly deliniate from POSIX
  fdopen function and state purpose
* _PDCLIB_fd_t is now a library provided union type
   Contains members of type void*, uintptr_t, intptr_t. If another type is
   required, define _PDCLIB_OSFD_T to that type in _PDCLIB_config.h
* _PDCLIB_fileops_t added. This structure contains the file operations
* _PDCLIB_fillbuffer, _PDCLIB_flushbuffer, _PDCLIB_seek become internal APIs
    (_PDCLIB_seek's days are numbered!)
* _PDCLIB_close is removed
* tmpfile() and fopen() should now call through to _PDCLIB_fvopen and provide
  a pointer to an appropriate _PDCLIB_fileops_t structure

Win32 port updated. Other ports are TODO

On C++, define _PDCLIB_wchar_t to be builtin type wchar_t

win32: Fix warnings relating to definition of LONG and use of InterlockedCompareExchange

PDCLIB-15: _PDCLIB_print now calls through to putc_unlocked

PDCLIB-16: Add _unlocked variations of all I/O routines; move work into these versions
PDCLIB-15: Make most stdio routines lock the stream and then call through to the _unlocked version

PDCLIB-15: fopen initializes stream lock; fclose releases

PDCLIB-15 PDCLIB-16:
 * Move _PDCLIB_file_t to _PDCLIB_io.h, compertmentalizing dependencies.
   Removes I/O specific structures from _PDCLIB_int.h. Allows _PDCLIB_io.h
   to depend upon _PDCLIB_threadconfig.h without recursive dependencies
   happening.
 * Add "lock" member to _PDCLIB_file_t as the stream locking mutex
 * Add flockfile/ftrylockfile/funlockfile as functions which manipulate the
   locking mutex explicitly
 * Add man page on flockfile/funlockfile/ftrylockfile
 * Add flockfile/ftrylockfile/funlockfile and *_unlocked to <stdio.h> and
   <wchar.h> as appropriate
 * win32: Initialize mutex member correctly

Improve reStructuredText formatting

Convert readme to be in reStructuredText format (for nice formatting)

PDCLIB-14: abort() on buffer size error

PDCLIB-13: fwrite did not reset it's offset after doing a buffer flush.
           TODO: Evaluate if fwrite should move to using an offset stored inside the FILE structure

   Patch submitted by Rink Springer (complexity: trivial)

Update .hgignore to ignore sublime text workspaces

PDCLIB-2: Pure wide character functions
 * functions/wchar/: functions which only involve wide characters & no locale dependent characters
 * opt/mincoll: new option providing bare minimum collation support (pure wchar_t binary comparison)
 * platform/win32: Use mincoll
 * testing/_PDCLIB_test.h: Provide wide character strings for testing the wide character functions

PDCLIB-2: <wchar.h>: don't expect or expose definition of FILE. Declare mbstate_t, wint_t, wchar_t

man3/wchar.h.3: _PDCLIB_restrict -> restrict. doh.

man3/pdclib.3: link wchar.h from our list of headers

PDCLIB-2: Complete wchar.h + manual page. This header is a monster, implies numerous backend changes, and therefore is going to be a bit of a slog :-(

PDCLIB-7: Add _PDCLIB_ftell64 to give us full precision file positioning information. Rewrite ftell to use it, and fseek to use it for the SEEK_CUR case. This should resolve PDCLIB-7

PDCLIB-7: When fseek is called with SEEK_CUR, internally calculate the new offset and then hand SEEK_SET to the glue layer, as our offset may differ from the offset of the underlying file descriptor due to buffering

opt nothread: Fix call_once to match recent changes to the implementation method

win32: mutex rewrite. new form is much simpler

strnlen: stupid off-by-one

printf_testcases.h: don't check for _PDCLIB_CHAR_SIGNED; instead, check for CHAR_MIN==-128.

PDCLIB-6: Didn't increment the specification pointer after the '*' in a precision specifier. Our printf now passes the tyndur test suite.

C11 7.21.6.1p8 "The result of converting a zero value with a precision of zero is no characters"

C11 7.21.6.1p4: the precision may be * or an _optional_ number

PDCLIB-6: Macros not wrapped in parentheses are evil things

PDCLIB-6: Removing the zero flag requires bitwise and, not bitwise xor

PDCLIB-6: Move output from %s/%c specifiers to their own functions in _PDCLIB_print. These functions now handle padding and precision appropriately

_PDCLIB_iotest.h: Print out the format string which caused the error (PDCLIB-6)

<string.h>: add POSIX 2008 extension strnlen (general utility + use by printf).

PDCLIB-6: _PDCLIB_status_t: change members from size_t to unsigned or int as appropriate. >int will overflow into error return anyway. Aligns types to better support negative precisions.

printf_testcases.h: Don't enable the Tyndur test cases if TEST_CONVERSION_ONLY is defined (it causes spurious test failures in the _PDCLIB_print test)

PDCLIB-6: int2base: alternate conversion specifier for hex output (#x/#X) doesn't print 0x/0X if value==0

PDCLIB-6: Inside _PDCLIB_print, remove intformat and completely rewrite int2base. The new code is non-recursive and far more logical. Additionally, because everything occurs in one place, it vastly simplifies some aspects of the handling

_PDCLIB_iotest.h: the code for determining if the result matched or not was too clever, and operator short circuiting was casuing the "actual" result for cases where the return codes didn't match to be stale (i.e. the result from a previous test). This should make fixing PDCLIB-6 much simpler

PDCLIB-6: Incorporate the Tyndur test suite into our printf test suite (see included license note for details).

This both incorporates the test suite to aid in fixing PDCLIB-6, and also ensures we have a good test suite to use for regression tests

Manual pages: renmae man->man3 to follow existing conventions. Add files _Exit.3, quick_exit.3, at_quick_exit.3, strndup.3 aliasing the file which documents said function, using .so inclusion directive. (While symlinks would be ideal, they are not sufficiently portable)

win32: mtx_destroy implemented

<threads.h>: correct declaration of thrd_start_t. oops.

<time.h> opt/notime: add timespec_get. wrap time with REGTEST check

<time.h>: define timespec_get, TIME_UTC, to support <threads.h> implementations

win32: initial pass at thread support

call_once: inline definition in threads.h (available when _PDCLIB_ONCE_FLAG_IS_DONE is defined): had sense of conditional wrong way around

_PDCLIB_ONCE_FLAG_DONE -> _PDCLIB_ONCE_FLAG_IS_DONE(flag) to support once_flag types which are not simply comparable (e.g. structures)

win32: predeclare mainCRTStartup in crt0.c (silence compiler warning)

Remove dev_zero_fd from dlmalloc.c (we don't use it - its a dlmalloc unix assumption)

win32: declare _PDCLIB_w32errno in _PDCLIB_flushbuffer.c

wcsrchr: add (wchar_t*) cast to found assignment (previously was assigning a const wchar_t without cast)

win32: Predeclare _PDCLIB_w32errno (silence compiler warning)

rename: test driver checked for rv == -1 on failure. Standard defines failure as any non-zero return; now check rv != 0. This makes the testsuite complete on win32 without failures (excepting disabled/not yet tested warnings)

win32: L_tmpnam set to 260 (MAX_PATH)

<float.h> is now implemented in the platform independent portion. It is based
upon a macro family defined in _PDCLIB_float.h, which is similar in structore
to the existing _PDCLIB_int.h. It is controlled by three definitions in
_PDCLIB_config.h, which define which IEEE 754 format the floating point types
are in. This removes a GCC dependency from all of the targets, and should help
in making PDCLib support other compilers

win32: most tests now build on Watcom

Enable building PDCLib with Watcom. This was surprisingly painless: their C99 mode has come a long way!

printf test cases: check signdness of char. Validate assumptions about shorts

win32: Fix _PDCLIB_seek. Todo soon: change this API. It is far too tricky and involves too much reaching into the stream objects.

printf_testcases: validate assumptions test cases make (todo soon: add support for case of char being unsigned)

win32: add a last chance exception handler which invokes the appropriate signal handler

fclose.c: don't try to open testfile2 while already open; [win32] implement rename

_PDCLIB_flushbuffer for win32. correct seeking behaviour.

ignore generated html files from manuals

Documentation for errno.h and errno

EDOM was repeated

Change the HTML manual page style to remove width limit (primarily for the
website's manual viewer, where the size is capped by an iframe anyhow)

Add nothrow annotations where appropriate

The feature check statements should represent what the user enters, not how we check </brainfart>

Correct formatting of strdup/strndup in man string.h

Add string.h man page

Import default mandoc stylesheet for HTML manuals

Bugfix: memmove parameters incorrectly defined as restrict.

Add support for building HTML manual pages to the Jamfile

(merge)

Import the manual pages into the repository

Initial pass at a port to win32

* Test cleanups: surround the code for all functions by #ifndef REGTEST
* Don't REGTEST internal functions (it doesn't make sense)
* <stdio.h>: add _PDCLIB_fdopen, which opens a file based upon its _PDCLIB_fd_t
  file descriptor
    TODO: Should this be public or not? POSIX fdopen demonstrates utility
    TODO: Can we stop storing the file name? Is that useful?
* fopen: rewrite based upon _PDCLIB_fdopen to consolidate code
* strndup: don't REGTEST - mingw doesn't implement.
* <stddef.h>: conditional definition of wchar_t for <wchar.h>
* <wchar.h>: Add 4 simple functions for dependencies
* <_PDCLIB_aux.h>: rename _PDCLIB_ALL to _PDCLIB_EXTENSIONS
* platform/example/functions/stdio/tmpfile.c: return NULL, not 1
* Build system: SubInclude the platform directory to enable the building of
  support routines (e.g. app startup files)
* Test system: If $(CRT0) is set, link the contents of it into the tests. This
  enables the platform code to provide startup files.

 * New feature check macro system. See _PDCLIB_aux.h for details
 * remove "#pragma weak" from strdup.c. It's nonportable and shouldn't be
   necessary
 * <string.h> changed to use new feature test system for strdup + strndup
 * add strndup implementation
 * <assert.h> more reliable handling of error messages

 Build system:
 * The CoreMake system is dead. It proved to be unscalable
 * The old Make based system is gone, also
 * We now use a Jam based system (requires the latest FT_Jam). Reasons:
  * Make is hard to scale in a non-recursive manner. The interactions get
    intractably complex
  * The build system depended upon GNU Make. GNU Make's license (the GPLv3) is
    about as diametrically opposed to PDCLib's CC0 as you can get without being
    closed source
  * Jam is actually more portable. In particular, it doesn't require a Unix
    emulation layer (unlike GMake)
  * The Jam system, as is, can be incorporated into the build system of a larger
    project.

Why Jam?
 * GNU make is too low level. It also incorporates too much magic: it can spend
   significant ammounts of time trying to update source files from SCCS and RCS
   files for example (a feature it is doubtful somebody has used in the last
   decade)
 * Systems like CMake are too high level: CMake is very difficult to use in a
   cross compilation environment.
 * Systems like Scons and Waf pose similar issues. Scons is also incredibly
   slow.