fixup some MD markups

which should help rst

improve smoke.sh on linux, to check
if the compiler works.

This is a GNU Coding Standard, and useful

C17 reconsidered safeclib but looked only at the old incomplete Cisco version,
not our complete and fixed version.
They have an Annex K

See ChangeLog

Change diagnose_if to be in clang-7

to make warn-dmax fatal

we also test now wine-3.0, and add/clarify the recently added smokers

 - Fix path in Kbuild and slkm_init.c
 - Specify in README that configure must be called with --disable-wchar
to build kernel module (as wchar is not available in kernel space)
 - Include config.h in kernel mode (for restrict define if needed)
 - Fix calls to EXPORT_SYMBOL in all files (missing trailing ;)
 - Do not include time.h in kernel space
 - Do not declare functions that use FILE in kernel space
 - Do not define handle_werror in safe_str_constraint.h if wchar is
disabled

Signed-off-by: Fabrice Fontaine <fontaine.fabrice@gmail.com>

also at http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2013/n3631.pdf

an overview over the various detected libc caveat's

Mention the only other implementations of the safe libc.
Mention that the LICENSE is MIT.
Protect safe_mem_lib.h from old systems without wchar.h

apparently BSDs have the same broken vswscanf as newlib (with %%n)
and also a broken mbstowcs with \0. Only tested with FreeBSD, will
test later with the other BSDs

do something with the c99 check.
either warn and disable __VA_ARGS__
or error. testcase cygwin64 gcc-4

toupper requires an unsigned number.
only cygwin caught that.

L'\xd834df01' is only valid with sizeof(wchar_t) == 4,
with size 2, the first word is legal unicode.

Adds cygwin support. Closes #18

only on darwin. probe for the sinners.
fixed cross-compilation and then testing with wine.

cleanup the src headers, only safeclib_private.h is needed.

Revert some #4 changes to argument names (of cosmetic nature).

bump version to 2017-08-24
See #6

dist the 2 generated architecture-specific headers.
They are needed.

added docs man perf targets, docs and man via doxygen.
man needed a pre-gen markdown file and some post-gen cleanup.

== Problem
When the library was installed to the system and a user attempted
to compile against the library the compile would fail.

== Reason
The problem was due to some types not being defined in the public API
of the library.

== Solution
Changed the public API, header files, of the library so that a few
of the files are now auto-generated based on information discovered
by the configure script. The header files that are now auto-generated
are 'safe_lib_errno.h' and 'safe_types.h'.

What changed from original:
- Documented how to setup the source tree for building in the README
- removed all makefiles that were obsoleted by autotools
- removed runtime_environment.c as it was not referenced by any other
  code within the library
- had to edit safe_types.h due to a compile error, may
  need to make this more portable later
- library can now be compiled as a shared and static object, all symbols
  are exported which is something I hope to change
- tests are now run when 'make check' is run
- converted the build to be silent like a Linux source compile
- requires/has been tested with autoconf(v2.65), automake(v1.11),
  and libtool(v2.2.6)

Still a lot of things need to be done:
- finish writing the definitions for the rest of the test programs
- convert the configure options to actually be configurable
  instead of someone having to go in and change code
- fix up the header files so that they can be parsed to
  generate an export symbols files
- fix up the header files so that they are C++ compatible
- convert to a non-recursive make setup (low priority)
- enable support for gcov and let it be selectable at configure
  time
- convert to using the config.h file for testing if a platform
  has certain features
- check for other portability issues
- remove all '^M's from the files, arg!!!
- fix and make consistent the versioning of the library