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.

Unit tests

* platform/example is now a "stub" platform - it should compile anywhere, but
  be useful nowhere.
* The old platform/example code has been moved to platform/posix - it should
  become a base implementation which works on any POSIX system
* A platform/win32 is probably due. This will be special in that it won't depend
  upon the host OS' libc (instead depending directly upon kernel32)

Include the text of the Creative Commons CC0 legal code

Import dlmalloc (public domain) as a malloc implementation. Add stub opt/notime
implementation of time.h for platforms with no clock (which only implements the
time(time_t*) function) to support this.

(Note: Builds, but implementation as of yet untested)

Remove these 4 files now they have moved to opt/. hg dropped this from the
previous changeset

* Change the style of inclusion of the internal/ headers. Modern preprocessors
  all detect the header guards and know not to include anyhow. The old style may
  have actually been counterproductive
* Make the built library be standard independent (i.e. the library build is
  independent of _PDCLIB_C_VERSION/__STDC_VERSION__/_PDCLIB_CXX_VERSION
  /__cplusplus.
* <threads.h> from C11. A bit off of the track of C99 support (which is still a
  higher priority goal), but solid implementation of many C99 functions on many
  real platforms will need proper thread support. <stdio.h> support to come.
  This is a stub implementation.
* Move malloc/free/realloc etc to opt/malloc-solar, in preparation for support
  of other memory allocators. On the cards are at least ptmalloc3 (BSD) and
  dlmalloc (public domain) as options.
* New build system (See CoreMakefile.mk). Not ready yet; but its coming. This
  doesn't change the project dependencies - you still only need GNU make.

This is a large bundle of changes - most of them are as a result of implementing
PDClib into my system, so they're mostly "changes I was doing" that have got
wrapped up together. Hopefully, now that things are together, future changesets
should be better factored.

Special thanks go to Martin "Solar" Baute for the work he has put in on this
code over many years.

update tags

Improved by Caleb1994 of osdev.org.

Fixing #47 (*snprint() crash).

Added LC_* definitions.

Fixes #45.

Fixed prototype warnings.

find did not match on symlinks.

Backported improvements to Makefile from OSDev.

Fix for #42 - free( NULL ) must not fail.

It seems I have to review the list of warning options if I missed this one.

Fix for #41.

I am not sure I understood strcoll() and strxfrm() correctly, but this is it for now.

Language.

Addressed ticket #40 (non-standard errno values).

localeconv, and setlocale (C locale only)

Moved ctype info into struct lconv.

ctype

Forgot parameter type.

Started out on v0.6.

Comment on v0.5 release

Basic tests for %c, %s, %[ and %p.

Some testcases for scanf(). Fixed bug with %*... . Fixed artifact in Makefile.

Moved the macro magic into the common header.

Cleaning up TODOs.

Cleaning up TODOs.