
	GPRESENT version 2.5
	--------------------

DESCRIPTION
    gpresent is a package for making presentations with groff and
    acroread.  It consist of a set of macros to be used with groff
    and a post-processor for manipulating the PostScript output of
    groff.  Without the use of the PAUSE macro, it can also be used
    for making slides.

FILES
    README           - this file
    present.tmac     - presentation macros
    groff_present.7  - manual page of the presentation macros
    presentps        - post-processor for the output of groff
    presentps.1      - manual page of presentps
    demo.rof         - groff input file of the demonstration
    demo.pdf         - demonstration of the macros
    sidebar.rof      - groff input file of the sidebar demonstration
    sidebar.pdf      - demonstration of a sidebar as header
    smile.epsf       - used in demos.
    piclink.tmac     - picture linking macros
    groff_piclink.7  - manual page of the picture linking macros
    piclink.rof      - groff input file of the piclink demonstration
    piclink.pdf      - demonstration of links inside a picture.
    COPYING          - the GNU General Public License (GPL)
    CHANGES          - list of changes compared to previous versions

USAGE
    Presentations:
	% groff -mm -mpresent file.rof > file.pps
	% presentps -l < file.pps > file.ps
	% ps2pdf file.ps
	% acroread file.pdf
    Slides:
	% groff -P-l -mm -mpresent file.rof > file.ps

    Note:
	- Do not forget to put in options for the preprocessors that
	are to be used.
	- On systems were Troff is installed you have to use -mgm
	instead of -mm.

NEEDED
    o  groff (version 1.18.1 dated Oct 3, 2002 or higher/later) with
       the mm macros (included with groff)
	    groff.ffii.org
    o  perl (version 5.x)
	    www.perl.com
    o  ps2pdf included with Ghostscript (version 5.10 or higher)
	    www.ghostscript.com
    o  acroread (version 4.0)
	    www.adobe.com/products/acrobat/adobepdf.html

INSTALL
    o  put present.tmac and piclink.tmac in the tmac directory of your
       groff installation (and delete old version named tmac.present)
    o  change the path in the first line of presentps to the path of
       your perl version 5.x and put presentps in the bin directory of
       your groff installation
    o  put groff_present.7 and groff_piclink.7 in man/man7 of your
       groff installation
    o  put presentps.1 in man/man1 of your groff installation

NOTES
    o  acroread: in your preferences for FullScreen set
	    Default Transition to Replace
	    Mouse Cursor to Always Visible or Hidden After Delay

AUTHOR
    Bob Diertens, <b.diertens@uva.nl>

COPYRIGHT
    gpresent is free software. See the file COPYING for copying
    permission.

WEBSITE
    staff.science.uva.nl/b.diertens/useful/gpresent/

