summaryrefslogtreecommitdiff
path: root/Build/source/utils/xpdfopen/xpdfopen-src/README
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/utils/xpdfopen/xpdfopen-src/README')
-rw-r--r--Build/source/utils/xpdfopen/xpdfopen-src/README115
1 files changed, 115 insertions, 0 deletions
diff --git a/Build/source/utils/xpdfopen/xpdfopen-src/README b/Build/source/utils/xpdfopen/xpdfopen-src/README
new file mode 100644
index 00000000000..3c7d6ba0c58
--- /dev/null
+++ b/Build/source/utils/xpdfopen/xpdfopen-src/README
@@ -0,0 +1,115 @@
+---------------------------------------------------------------------------
+xpdfopen 0.86 - Send open/close commands to Acrobat Reader, xpdf and evince
+---------------------------------------------------------------------------
+
+This is a Linux (X11) implementation of Fabrice Popineau's pdfclose/
+pdfopen commands to control Acrobat Reader, xpdf and evince.
+
+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.
+
+Version 0.81 adds an implementation for evince.
+
+Version 0.82 adds a man page and -v/--version options for pdfopen.
+
+Version 0.83 adds the -r/-reset_focus option for pdfopen.
+
+Version 0.84 adds 'load at given page' support (-p option) for Adobe
+ Reader 9, evince (at least 3.12, maybe earlier) and xpdf.
+
+Version 0.85 adds 'load at named destination' support (-g/--goto option)
+ for xpdf, evince and (supposedly) AR9. The AR9 man page
+ claims it should work, but it doesn't for me. I left
+ the allegedly-correct code there anyway, in case it works
+ for other people in other places.
+ Also add aliases for option names to make ms-windows
+ users feel at home.
+
+Version 0.86 fixes 'load at named destination' for AR9.
+
+
+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' key-presses.
+
+
+pdfopen has the following call sequence:
+ pdfopen [-r|-reset_focus] \
+ [-viewer/--viewer <ar9|ar9-tab|ar8|ar7|ar5|xpdf|evince>] \
+ [-p/--page <page number>] \
+ [-g/--goto <named destination>] \
+ [--file] <pdf file name>
+
+The "ar9" version uses AR9's "-openInNewInstance" 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 [--file] <pdf file name>
+This program closes an existing AR5, AR7, AR8, AR9, xpdf or evince window
+displaying the given PDF file.
+
+
+Version 0.85 compiles on Linux (Slackware64 14.1, anyway) with
+the following command:
+ gcc -Wall pdfopen.c sendx.c utils.c -o pdfopen -lX11 -s
+ gcc -Wall pdfclose.c sendx.c utils.c -o pdfclose -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 through 0.84)
+Acadia University, Wolfville, Nova Scotia, Canada; May 2014.
+
+
+
+
+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 "AS IS" BASIS, AND
+THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE
+MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.