update changelog
[debian/jabref.git] / src / main / resources / help / RemoteHelp.html
1 <html xmlns="http://www.w3.org/1999/xhtml">
2 <head>
3 <link rel="stylesheet" type="text/css" href="jabref_help.css"/>
4 </head>
5
6 <body>
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>