//******************************************************************************
//* Console Trashcan (ctrash) - Version History                                *
//*                                                                            *
//* Author     : Mahlon R. Smith                                               *
//*              Copyright (c) 2015-2020 Mahlon R. Smith, The Software Samurai *
//*              On the web :            http://www.SoftwareSam.us/            *
//*                                                                            *
//*              Source code, binary, and CSS style definitions released under *
//*                 GNU GPL version 3.                                         *
//*              Documentation released under:                                 *
//*                 GNU FDL version 1.3                                        *
//*                                                                            *
//* Date       : 17-Jan-2020                                                   *
//*                                                                            *
//* -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  *
//* Copyright Notice:                                                          *
//* This program is free software: you can redistribute it and/or modify it    *
//* under the terms of the GNU General Public License as published by the Free *
//* Software Foundation, either version 3 of the License, or (at your option)  *
//* any later version.                                                         *
//*                                                                            *
//* This program is distributed in the hope that it will be useful, but        *
//* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY *
//* or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License   *
//* for more details.                                                          *
//*                                                                            *
//* You should have received a copy of the GNU General Public License along    *
//* with this program.  If not, see <http://www.gnu.org/licenses/>.            *
//*                                                                            *
//* -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  *
//* The full copyright notice for 'ctrash' is located in 'ctrash.info' and     *
//* 'ctrash.html'.                                                             *
//*    Texinfo-format docs: info -f ctrash.info -n 'Copyright Notice'          *
//*    HTML-format docs   : open 'ctrash.html' in your favorite browser        *
//*                                                                            *
//* -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  *
//* Description:                                                               *
//* Please see the description of package components in the 'README' file      *
//*                                                                            *
//******************************************************************************

Version History (most recent first):
- - - - - - - - - - - - - - - - - -
v: 0.0.06 17-Jan-2020
   -- Update compiler to g++ v:9.2.1:
      -- New warning that library functions 'tempnam' and 'tmpnam_r are 
         dangerous. While this is technically true, this application uses 
         them in such a way that negates the danger.
      -- Still, we seriously dislike compiler warnings, even when we are 
         "sure" that they do not apply to us. See ctfGetTempdirPath(), 
         ctfCreateTemppath() and ctfCreateTempname() methods for our 
         solution.
      -- Import updated version of the gString class from NcDialogAPI.
         No change in functionality.
   -- Update the copyright message displayed by the '--version' option.
   -- Documentation update.
   -- Posted to website 17-Jan 2020

v: 0.0.05 26-Feb-2016
   -- Update the copyright message displayed by the '--version' option.
      (not publically released)

v: 0.0.04 07-Oct-2015
   -- Generate error message if filename specified by '--file-list' option 
      was not found.
   -- Update calls to 'formatInt' and 'compare' methods of the gString class 
      to match changes to gString prototypes (no functionality changed).
   -- Update algorithm for creating temp-file names, to reduce the likelihood 
      of duplicate filenames.
   -- Update copyright message.
   -- Bug fix: When trimming path strings for display, a filename wider than 
      the available field width was causing an out-of-bounds error.

v: 0.0.03 06-Oct-2015
   -- Complete implementation of 'rm' compatibility mode.
   -- Several bug fixes in restoration algorithm.
   -- Complete implementation for emptying items from Trashcan based on 
      item's deletion date.
   -- Integrate suggestions from testers.
   -- Documentation update.
   -- First public release.

v: 0.0.02 02-Sep-2015
   -- Restructure source-item validation to significantly reduce the number
      of 'lstat' calls.
   -- Complete implementation of recursive move of directory trees to and from 
      the Trashcan.
   -- Add sort options for detailed-record output.
   -- Pretest free space on target filesystem before moving data (Trashcan's 
      filesystem and target filesystems for directory tree restoration).

v: 0.0.01 22-Apr-2015
   -- Adapt the Trashcan-specific code from the FileMangler utility to
      produce a simple command-line utility for accessing the Trashcan.
   -- All output passes through a single point, so that an NcDialog user 
      interface can be added later. This is also useful in case we want to 
      adapt the code as a link library for other applications.

