-*- org -*-

#+STARTUP: hidestars oddeven

This is the 'NEWS' file for the 'screen-wrappers' project. This file contains
information on changes since the last release of the package, as well as a
running list of changes from previous versions.  If critical bugs are found in
any of the software, notice of such bugs and the versions in which they were
fixed will be noted here, as well.

------------------------------------------------------------------------------

* screen-wrappers 0.3.1 (2016-07-29)

** fixes

*** issue #5: screen-wrappers build now omits `--nobacklink` when invoking pod2html

    The `'--no-backlink'` option to `pod2html` requests what is the default
    behavior for that tool, but that command line option is not available on
    some older `pod2html` versions (such as that from perl 5.8.8) on hosts on
    which we wish to build screen-wrappers. We therefore have removed the
    option from the Makefile recipe; the resulting build is identical in
    behavior and outcome to that prior to this change, but the build is now
    able to complete successfully on a slightly wider range of machines (at
    the expense of the build recipe being slightly less explicit about the
    wanted behavior).

** improvements

   (none)

------------------------------------------------------------------------------


* screen-wrappers 0.3.0 (2016-07-04)

** fixes

   (none)


** improvements

*** README(.md) switched to GitHub-flavored markdown (from org-mode) for improved rendering on GitHub

    The content of the file was also updated to integrate better from the
    GitHub repository view (which shows the README file by default) with the
    project's GitHub Pages site.

    Also renamed the file from 'README' to 'README.md' so GitHub would
    recognize it as a markdown file.


*** issue #3: screen-ls: allow short-form command line options to be bundled

    https://github.com/salewski/screen-wrappers/issues/3

    All of the following representative invocations are now equivalent:

    :     $ screen-ls -l -p
    :     $ screen-ls -lp

    :     $ screen-ls -p -l
    :     $ screen-ls -pl

    Prior to this change, the bundled variations ('-lp' and '-pl') caused the
    program to exit with an error code.


*** issue #4: build now generates man pages in HTML format, too

    https://github.com/salewski/screen-wrappers/issues/4

    The project is now able to generate man pages in HTML format (in addition
    to the troff format man pages). This is mainly intended for use by the
    author to incorporate them into the 'screen-wrappers' project's GitHub
    Pages web site.  However, the mechanism is generic and will install the
    pages beneath a 'html' directory beneath the =htmldir= location (which can
    be specified at configure-time).

    Since this is a new capability, we have bumped up the 'm' in our M.m.p
    (semver) version number from '0.2.3' to '0.3.0'.

------------------------------------------------------------------------------


* screen-wrappers 0.2.2 (2016-06-22)

** fixes

*** screen-ls: minor documentation fix


*** screen-ls: fix github issue #2: name of last session name was being omitted from output when using newer versions of GNU 'screen'.

    See: https://github.com/salewski/screen-wrappers/issues/2


** improvements

   (none)

------------------------------------------------------------------------------


* screen-wrappers 0.2.1 (2016-04-10)

** fixes

*** screen-ls: address github bug #1: work correctly with GNU screen 4.3.0 or newer

    https://github.com/salewski/screen-wrappers/issues/1

    Upstream GNU screen versions prior to 4.3.0 exited with a non-zero exit
    status of 1 (rather than the expected zero status) when invoked with the
    'screen -ls' option, as is done by the 'screen-ls' program:

    http://savannah.gnu.org/bugs/?26750

    Earlier versions of 'screen-ls' had a comment in the source code noting
    the wonkiness, and broke with GNU screen 4.3.0 when the upstream bug
    #26750 was addressed (2015-06-12).

    The 'screen-ls' program now attempts to parse the output of 'screen
    --version' at runtime and adapt its behavior accordingly. If it detects a
    version of GNU screen older than 4.3.0, then the traditional 'screen-ls'
    behavior is used. If a version of screen newer than 4.3.0 is detected,
    then the behavior is modified to expect a zero exit status to indicate a
    successful outcome from the 'screen -ls' invocation.


** improvements

   (none)

------------------------------------------------------------------------------


* screen-wrappers 0.2.0 (2016-03-25)

This release of 'screen-wrappers' finds the project publicly hosted on GitHub
for the first time. The project's GitHub URL is:

    http://github.com/salewski/screen-wrappers

** fixes

   (none)


** improvements

*** screen-ls: minor doc fixes

*** screen-ls: new '-U' (--unsorted) option

    The new '-U' (--unsorted) option prevents the program from sorting the
    output, and instead list screen sessions in order output by
    screen(1). Thanks to John Marquart for suggesting this feature.

------------------------------------------------------------------------------


* screen-wrappers 0.1.1 (2013-07-09)

** fixes

**** screen-ls: corrected 'screen -q -ls' exit status checking

The screen-wrappers-0.1.0 release included a version of 'screen-ls' that had
code left in that was being used by the author to verify error handling by
forcing the exception condition, with the result that the program was
unusable. Sorry! This has been corrected.


** improvements

------------------------------------------------------------------------------


* screen-wrappers 0.1.0 (2013-07-09)

This is the initial release of 'screen-wrappers'.

The 'screen-wrappers' project provides convenience wrappers for various
invocations of the GNU screen(1) program.

    http://www.gnu.org/software/screen/

This initial release provides only the 'screen-ls' program. Once installed,
you can read screen-ls(1) to learn all about it.

See the README file for more information.

------------------------------------------------------------------------------
