aboutsummaryrefslogtreecommitdiffhomepage
path: root/README
blob: f7b721bc4156a344fe9917999c6aa01097118907 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
	GPRESENT version 2.3
	--------------------

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, <bobd@science.uva.nl>

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

WEBSITE
    www.science.uva.nl/~bobd/useful/gpresent/