summaryrefslogtreecommitdiff
path: root/Build/source/utils/xpdfopen/README
blob: 51b532c7bccafd181367056cb8b3c710e1c0079c (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
81
82
83
84
85
86
87
88
89
------------------------------------------------------------------
Pdfopen 0.80 - Send open/close commands to Acrobat Reader and xpdf
------------------------------------------------------------------

This is a Linux (X11) implementation of Fabrice Popineau's pdfclose/
pdfopen commands to control Acrobat Reader and xpdf.

The libX code was borrowed from Reinhard Fobbe's Sendx library for 
Tcl/Tk, and the programs use the same license, copied below. 

Version 0.3 adds support for Adobe Reader 7.0 for Linux.
(different window titles and key shortcuts)

Version 0.4 uses autoconf

Version 0.5 fixes an incorrect autoconf variable, supports
building under X11R5, handles pathnames on the command-line, 
and  fixes a bug where pdfopen did not exit correctly after 
(automatically) starting acroread.

Version 0.51 uses the strrchr() function instead of rindex() 
to allow compilation on non-BSD derived unix platforms.

Version 0.61 attempts to do something useful with Adobe Reader 8,
even though it is impossible to restore the viewport.

Version 0.80 adds an implementation for AR 9 and xpdf.

The AR command lines do not behave precisely the same as under Windows, 
because the Linux Reader behaves somewhat differently: it is not 
scriptable, but it is possible to 'fake' keypresses.


pdfopen has the following call sequence:
	pdfopen [-viewer <ar9|ar9-tab|ar8|ar7|ar5|xpdf>] <pdf file name>
The 'ar9' version uses the '-openInNewWindow' option, the 'ar9-tab'
version does not (so if there is already an AR9 window open, a new tab
will be opened in that window).


pdfclose has the following call sequence:
	pdfclose <pdf file name>
This program closes an existing AR5, AR7, AR8, AR9 or xpdf window
displaying the given PDF file.


Version 0.80 compiles on Linux (Slackware64 13.0, anyway) with
the following command:
	gcc -Wall pdfopen.c sendx.c utils.c -o pdfopen -lX11 -s
should you not want to go through the process of creating and running
a configure program.


Taco Hoekwater <taco@metatex.org> (Version(s) up to 0.61)
Dordrecht, The Netherlands, December 2008.

Jim Diamond <jim.diamond@acadiau.ca> (Version 0.80)
Acadia University, Wolfville, Nova Scotia, Canada; April 2010.




License terms:
--------------
The following terms apply to all files associated with the software
unless explicitly disclaimed in individual files.

The authors hereby grant permission to use, copy, modify, distribute,
and license this software and its documentation for any purpose,
provided that existing copyright notices are retained in all copies
and that this notice is included verbatim in any distributions. No
written agreement, license, or royalty fee is required for any of the
authorized uses.  Modifications to this software may be copyrighted by
their authors and need not follow the licensing terms described here,
provided that the new terms are clearly indicated on the first page of
each file where they apply.

IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.

THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
NON-INFRINGEMENT.  THIS SOFTWARE IS PROVIDED ON AN &quot;AS IS&quot;
BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE
MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.