Run the `clang-format.bash` script to update all our C and C++ code to a
new style defined by `.clang-format`.  Use `clang-format` version 6.0.

* If you reached this commit for a line in `git blame`, re-run the blame
  operation starting at the parent of this commit to see older history
  for the content.

* See the parent commit for instructions to rebase a change across this
  style transition commit.

When running a pipeline of child processes, provide clients a way
to get individual results.

Run the `clang-format.bash` script to update all our C and C++ code to a new
style defined by `.clang-format`.  Use `clang-format` version 3.8.

* If you reached this commit for a line in `git blame`, re-run the blame
  operation starting at the parent of this commit to see older history
  for the content.

* See the parent commit for instructions to rebase a change across this
  style transition commit.

Change-Id: Ie3aedc03bfe5c3999d4a077fafb8c6f3bbffc5c5

Per-source copyright/license notice headers that spell out copyright holder
names and years are hard to maintain and often out-of-date or plain wrong.
Precise contributor information is already maintained automatically by the
version control tool.  Ultimately it is the receiver of a file who is
responsible for determining its licensing status, and per-source notices are
merely a convenience.  Therefore it is simpler and more accurate for
each source to have a generic notice of the license name and references to
more detailed information on copyright holders and full license terms.

Our `Copyright.txt` file now contains a list of Contributors whose names
appeared source-level copyright notices.  It also references version control
history for more precise information.  Therefore we no longer need to spell
out the list of Contributors in each source file notice.

Replace KWSys per-source copyright/license notice headers with a short
description of the license and links to `Copyright.txt` and online
information available from "https://cmake.org/licensing#kwsys".

Run the `filter-notices.bash` script to perform the replacements mechanically.
Manually fix up the shebang line in one file.

Change-Id: I8497f7c868664dcf54a8608ab302ad93c860b334

The clang-format tool sorts `#include` lines within contiguous blocks.
Separate blocks with blank lines and sort the include lines within them
so that clang-format does not re-order anything.

Change-Id: I96d6828f470b9a234464972172d46afab322487c

Change-Id: I7d588cb060ea17ed4221c55b866cbbebab983e3c

Recompute `TimeoutTime` after `Timeout` changes so that one may modify
the timeout of a process after it has started running by calling the
normal `kwsysProcess_SetTimeout` method.

Change-Id: I460a02d0d3c5f107b844abb56e39f5c844e7e3fb

Update sources using KWSYS_HEADER to make the corresponding ".in"
includes consistent.

Change-Id: I9414edf93928386ffc38e0fd885edd0b7ddb2886

Since commit faff2ab0 (Process: Wait for children to terminate on Ctrl+C,
2015-06-30) we do not report the GetLastError() from CreateProcessW()
failure.  Refactor kwsysProcessCleanup to pass the error code in so
that we can always call GetLastError() immediately after a failure.

Change-Id: I2b7950560c8bde2e29070c87f4927c51dca32e39

kwsysProcess_SetOption now allows you to specify a new
kwsysProcess_Option_CreateProcessGroup option, which creates the
process in a new process group (Windows/UNIX) and a new session
(UNIX).  Child process groups receive signals separately from their
parents.  This allowed for the introduction of the new
kwsysProcess_Interrupt function, which allows one to safely request
the child process in its own group to terminate.  The Ctrl+C handler
also manually sends that signal to child process groups, since it's
no longer automatic.

Change-Id: Id0a420ad65f1b1c1d299ac0eb95fbb8b50a52409

The following applies to any KWSys console app on Windows or UNIX
(e.g. cmake.exe):  The default behavior of such an app when Ctrl+C is
pressed is to call ExitProcess or _exit.  If the user has a
subprocess open (e.g. by way of cmake --build) when this happens, the
subprocess will be orphaned because the kwsys-based program will
immediately exit.  This can lead to odd behavior such as the orphaned
subprocess continuing to run and mix output with the operating system
shell.  We prevent this behavior on Windows by tracking all
subprocesses and waiting for their termination when Ctrl+C is pressed
before allowing the call to ExitProcess to proceed.  On UNIX, we reap
every single child process and then call _exit.

Change-Id: Iebd2eedb1c06719e9797dd5b1309d473145476a8

Use an algorithm that simply reverses CommandLineToArgvW to construct
a string encoding command line arguments.

Change-Id: I52a5d27679da3962eda36b8bb6a1fb714a735a1d

When enabled, ignore all stderr pipe configuration options and
just give the child a copy of stdout as its stderr.

Change-Id: I87a64657cc701b706da78f7bfc56ad0071383372

Consolidate logic to prepare stdin/stdout/stderr in the same way
before starting any processes.  This will simplify alternative
approaches to select the child pipes.

Change-Id: I36175a8cfc2578543103297420908a539ad71a3a

In commit 29ffaf43 (Suppress deprecation warnings for GetVersionEx,
2014-09-25) we used #pragma to disable warnings on MSVC.  Update
the logic to use the proper warning number for the Intel compiler.

Change-Id: Idddca1814c645b76f7e823c0028ee2209ee4fb57

Visual Studio 12 (2013) deprecated GetVersionEx:

  warning C4996: 'GetVersionExW': was declared deprecated

in favor of either "versionhelpers.h" or VerifyVersionInfo, neither of
which exist in some of the older compilers we support.  Rather than
try to port conditionally to VerifyVersionInfo, simply suppress the
warning for now.

Change-Id: I85a6547c7dc25a104d4fe9b4034efdc5cea215ef

Change-Id: Icb357202c5591819b9f44b4e4f1376e7c4f7b7b3

We no longer support Windows 98.  Remove Win9x-specific code and
supporting infrastructure.  This simplifies the implementation in several
places.

Change-Id: Ic3062a81e5880b649feeedf397bf846400f12526

Do not try to execute a child with no command line.  Previously this led
to a silent hang.

We enumerate processes to identify those whose parent is being killed so
that we can recursively kill the children.  Enumeration uses the
Process32(First|Next) windows API functions, which accept PROCESSENTRY32
objects to be filled.  This commit corrects the declaration of the entry
structure to account for its size on 64-bit Windows.

This converts the KWSys license to a pure 3-clause OSI-approved BSD
License.  We drop the previous license clause requiring modified
versions to be plainly marked.  We also update the KWSys copyright to
cover the full development time range.

COMP: sprintf warnings. DWORD should use %ld rather than %d. Also, const char *p, a shadowed variable warning.

ENH: Added KWSYSPE_DEBUG macro to print debugging trace information.  Added TODO comment explaining why process execution can still hang when a grandchild keeps the output pipes open.

COMP: Fix or suppress warnings on Borland and Mac dashboards. Definitely fix "may be used uninitialized" warnings.

ENH: Added Process_SetPipeNative method to allow user code to override the pipes connected to the child pipeline.

ENH: Re-implemented command line argument shell quoting to support several platforms with one code base.

ENH: Adding 'System' component of C sources to hold system tools written in C.  Moved windows shell command line argument escaping code to kwsysSystem_Windows_ShellArgument and kwsysSystem_Windows_ShellArgumentSize.

BUG: When handing the child stdin pipe a file, allow another process to be writing to the file at the same time.  This allows children such as tail -f to function properly.

ENH: add support for win64 for visual studio 2005 ide and nmake, also fix warnings produced by building for win64