xenial (1) pdfopen.1.gz

Provided by: texlive-binaries_2015.20160222.37495-1ubuntu0.1_amd64 bug

NAME

       pdfopen, pdfclose - open or close a PDF file viewer

SYNOPSIS

       pdfopen [ options ]  [ --file ]  file.pdf
       pdfclose [ --file ]  file.pdf

OPTIONS

       -h, --help, -?
               output help and exit.

       -v, --version, -V
               output the version number and exit.

       -p <n>, --page <n>
               when  starting  the viewer, display page <n> of the document (notes: not all viewers support this
               feature, and even in those cases this option only has  effect  when  the  document  is  initially
               loaded).  This option is over-ridden by -g.

       -g <named destination>, --goto <named destination>
               when  starting  the  viewer,  display  the  page of the document containing the named destination
               (notes: not all viewers support this feature, and even in those cases this option only has effect
               when the document is initially loaded).

       -r, --reset_focus
               after  sending  commands  to the PDF viewer, attempt to reset the input focus to the window which
               had focus before the commands were sent.

       -viewer, --viewer <ar9|ar9-tab|ar8|ar7|ar5|xpdf|evince>
               use (respectively) Adobe Reader 9 (in a new window), Adobe Reader 9 (in a new tab  of  a  running
               AR9,  if  any),  Adobe Reader 8, Adobe Reader 7, Adobe Reader 5, xpdf or evince as the PDF viewer
               program.  Adobe Reader 9 (in a new window) is the default.

RATIONALE

       At certain points of TeX document preparation, many people repeat a "edit-compile-view" cycle.  Since PDF
       viewers such as Adobe's Acrobat Reader ("acroread") do not automatically refresh the display when the PDF
       file changes, this cycle can be more cumbersome than desired.  The pdfopen program provides  the  ability
       to automate the reloading of the PDF document when it is changed.

       Note:  there  seems  to  be  little need for pdfclose under GNU/Linux, since (unlike the situation for MS
       windows) acroread does not lock the PDF file, which would prevent pdftex (or a DVI to PDF converter) from
       creating  a  new  version of the PDF output file.  However, pdfclose is provided in case someone finds it
       useful.

DESCRIPTION

       pdfopen searches for an instance of the specified (or default) PDF viewer displaying  the  specified  PDF
       file.   If  there  is  already  an  instance of the given viewer displaying the given file, the viewer is
       instructed to reload the file.  If no such instance is found,  pdfopen  attempts  to  run  the  specified
       viewer on the specified document.

       The  default  viewer  is "acroread", which could start any one of a number of versions of Acrobat Reader,
       depending on what is installed on your system.  However, the commands to reload the current document vary
       from  one version of acroread to another; consequently, if you are using a version of acroread other than
       AR9, you should explicitly specify the viewer program.

       This version of pdfopen accepts the following viewer options:
       ar9, ar9-tab, ar8, ar7, ar5, xpdf, and evince.
       The difference between ar9 and ar9-tab is significant when there is no instance of AR9 already displaying
       the  requested  document.  In this situation, while ar9 will request acroread to create a new instance of
       acroread (and thus open a new window) by using the -openInNewInstance argument, ar9-tab  starts  acroread
       without  this  argument; if there is already an instance of acroread running, a new tab will be opened in
       an existing window.

       pdfclose searches for one of the above PDF viewers displaying the given file and instructs the viewer  to
       "close" the window.  In most cases, the PDF viewer continues to run, possibly now displaying just a blank
       window.  (This behaviour varies somewhat from one PDF viewer to another.)

PORTABILITY AND AVAILABILITY

       These programs have been tested on Slackware64 Version 14.1 and a few other versions /  distributions  of
       GNU/Linux.   The  code  is  reasonably  generic  and  should  work  out  of the box using most recent X11
       implementations.  (Reports to the contrary are welcome, particularly if they come with robust fixes.)

       These programs are designed for X11-based systems.  If  you  somehow  find  compiled  versions  of  these
       programs on a system using another window system, they are very unlikely to be of any use to you.

       Source   and   binaries   of   the  programs  can  be  downloaded  from  CTAN://support/xpdfopen/  (e.g.,
       http://mirror.ctan.org/support/xpdfopen).

CAVEATS

       If you use ar9-tab to reload the PDF document and the instance of acroread with  the  given  document  is
       currently  displaying  some  other  document,  the  command causes your document to be displayed, but not
       reloaded.

       pdfopen works by looking for a window with a name (window title) matching that  expected  for  the  given
       viewer  and  document.   If for some reason your viewer's window name is not as expected, pdfopen may not
       work for you.

       With at least AR9 and some window managers, using pdfopen to reload  the  document  gives  focus  to  the
       acroread  window,  even though the mouse cursor is not necessarily in that window.  This can be annoying.
       The -reset_focus option can be used to deal with this problem.

AUTHOR

       This manual page was written by Jim Diamond <Jim.Diamond@acadiau.ca>.  I am the current maintainer of the
       X11  versions of pdfopen and pdfclose.  Report any bugs you find to me.  Feature enhancement requests are
       welcome, coded enhancements even more so.

       Past authors: Fabrice Popineau wrote the MS-windows versions of pdfopen and  pdfclose  upon  which  these
       programs  were  originally  based.   Taco  Hoekwater  created  the GNU/Linux versions, up to Version 0.61
       (including some  documentation  which  inspired  parts  of  this  man  page).   Peter  Breitenlohner  has
       contributed both code and suggestions to versions later than 0.61.