src/help/RemoteHelp.html

   1 <html xmlns="http://www.w3.org/1999/xhtml">
   2
   3 <body text="#275856">
   4     <basefont size="4"
   5           color="#2F4958"
   6           face="arial">
   7
   8     <h1>Remote operation</h1>
   9
  10     <p>This feature can be toggled and
  11     configured under <b>Preferences -&gt; Advanced</b>.</p>
  12
  13     <p><i>Note that activating this feature under Windows XP SP2
  14     (and possibly other configurations) may prompt a message box
  15     stating that certain features of the program have been blocked
  16     by the Windows firewall. You can safely tell the firewall to
  17     keep blocking - the firewall will not interfere with remote
  18     operation of JabRef.</i></p>
  19
  20     <p>If listening for remote operation is enabled, JabRef will at
  21     startup attempt to start listening to a specific port. This
  22     means that other applications can send information to JabRef
  23     through this port. JabRef will only accept local connections,
  24     to avoid the risk of interference from outside.</p>
  25
  26     <p>Binding to this port makes it possible for a second JabRef
  27     instance to discover that the first one is running. In this
  28     case, unless specifically instructed to run in stand-alone
  29     mode, the second JabRef instance will pass its command line
  30     options through the port to the first JabRef instance, and then
  31     immediately quit.</p>
  32
  33     <p>The first JabRef instance will read the command line
  34     options, and perform the indicated actions, such as reading or
  35     importing a file, or importing a file to the currently shown
  36     database. If a file is imported using the command-line option
  37     <code>--importToOpen</code>, the imported entries will be added
  38     to the currently shown database. If no database is open, a new
  39     one will be created.</p>
  40 </body>
  41 </html>