XMOTD 1.17.3 README                 http://www.ee.ryerson.ca/~elf/xmotd/

February 2003
Luis Fernandes, <elf@ee.ryerson.ca>
Ryerson University,
Toronto, Canada

xmotd is a message-of-the-day browser for X11 and
dumb-terminals. 

WHAT'S NEW

1.17.3 fixes a timestamp bug introduced in 1.17.2. The patch was
contributed by Marcin Owsiany and also Andy Roosen (who also added
more features to xmotd; these will appear in a future version).

REQUIREMENTS

xmotd requires, a C compiler and at minimum, X11R5 including Xt (the X
Toolkit) for the resource and command-line parsing functions, and the
Athena widget (Xaw) libraries. Optionally, Xm (the Motif toolkit)
should be installed if you wish to compile the Motif version; the Xpm
library should be installed if you wish to compile-in support for
colour logos.

The HTML library is not included with the 'lite' distribution.

BUILDING

First, unpack the distribution with:

    zcat xmotd-1.17.x.tar.gz | tar xvf -

A directory called xmotd-1.17.x will be created; cd into that
directory and to build the default flavour type:

    xmkmf -a; make all

Note: If your xmkmf does not support the -a option
(e.g. /usr/openwin/bin/xmkmf), type:

   xmkmf; make makefiles; make all

xmotd can be built in different flavours:
    - with the Athena widget library (default), or;
    - with Athena & HTML widget, or;
    - with the Motif widget library, or;
    - with Motif and HTML widget.

Refer to the commentary in the Imakefile for details on customizing
the build for HTML, Motif and XPM support.

INSTALLATION

After the compilation is complete (ignore compilation warnings when
the HTML widget is being compiled) and if you wish to install xmotd
automatically, type:

    make install

NOTE: that "make install" will replace your app-defaults file (if you
have previously installed xmotd ) with the app-defaults in the
distribution. If you have modified your app-defaults, make a copy
before invoking the install.

Alternatively, you can manually copy the xmotd binary to the install
directory and the manual-page to the man8 directory.

PLATFORMS

It has been sucessfully compiled here at Ryerson under SunOS 4.1.4,
Solaris 2.5.1, 2.6 and 2.8 and GNU/Linux 2.4.18.

xmotd has also been successfully compiled on the following platforms:

    HP 9000/735 running HP-UX 9.03 (X11R5).  
    IBM RS/6000 model C10 (PowerPC) running AIX v3.2.5.
    Silicon Graphics INDY running Irix 5.3 (X11R5)
    Mips/CDC (running EPIX) and PCS/M68030 (running MUNIX/SysV). 

MANIFEST

This distribution contains the following files:

        README                  (this file)
        ACKNOWLEDGEMENTS        (contributors to xmotd)
        GNU                     (Terms of GPL)
        Imakefile               (X Consortium's gift to humanity)
        Makefile                (...3 guesses)
        XMotd                   (app-defaults)
        XMotd_motif             (Motif app-defaults)
        xmotd.8                 ([nt]roff man-page)
        xlogo.bm                (default bitmap, the "X"-logo)
        xlogo.xpm               (default pixmap used w/ xpm support)
        *.c, *.h                (source)
        browser                 (shell script)
        libhtmlw/               (NCSA HTML widget; not in 'lite' version)


xmotd has many options. Refer to the man-page for further details on
customizing and more examples showing xmotd in use. You can read the
man-page, without installing it, with the following command:

    nroff -man xmotd.8 | less

APP-DEFAULTS

xmotd can be customized via editres.

Reasonably adequate application defaults are compiled into xmotd so it
is NOT necessary to install the supplied app-defaults file.

You can also customize the resources with the supplied app-defaults
file, XMotd. The Motif version is called XMotd_motif; rename it XMotd
before installing and comment-out appropriate resources if building
with HTML support. The app-defaults file installs in:

         $ProjectRoot/lib/X11/app-defaults/XMotd

All resources are available as command-line option equivalents so
xmotd may be customized completely via the command-line.

COPYRIGHT (xmotd)

xmotd Copyright 1993 (released as xbanner, no public release)
xmotd Copyright 1994-97, 1999, 2001, 2003 Luis Fernandes

Permission to use, copy, hack, and distribute this software and its
documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appear in all copies and
that both that copyright notice and this permission notice appear in
supporting documentation.

xmotd IS PRESENTED AS IS, WITHOUT ANY IMPLIED OR WRITTEN WARRANTY.

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 2 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, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

COPYRIGHT (HTML widget)

libhtmlw is copyright (C) 1993, Board of Trustees of the University of
Illinois. See the file libhtmlw/HTML.c for the complete text of the
NCSA copyright.

NOTE: THE HTML WIDGET IS NOT DISTRIBUTED IN THE "LITE" VERSION OF THE
xmotd DISTRIBUTION, WHICH IS THEREFORE FULLY COMPLIANT WITH THE GPL.