Load /tmp/tmp.vjbgZ10456/jabref-2.2~b2 into
[debian/jabref.git] / src / help / ExternalFiles.html
index 91448bf..61ea300 100644 (file)
@@ -49,5 +49,37 @@ You can set PDF and PS directories specific to a database (<b>File -> Database p
 These directories will supersede the main directories.
 </P>
 
-
-</HTML>
+<a name="RegularExpressionSearch">
+<H2>Using Regular Expression Search for Auto-Linking</H2>
+</a>
+<p>
+In the previous sections JabRef's auto-linking feature was described: If you choose names for your files
+corresponding to the bibtex-key + plus the extension, JabRef will automatically be able to find it.
+</p><p>
+Since JabRef 2.2 it is now possible to have greater flexibility in the naming scheme by using
+regular expression for the search. In most cases it should not be necessary though to adapt the given default.
+</p><p>
+If you open the external preferences
+(Options -> Preferences -> External Programs) you will find an option called "Use Regular Expression Search".
+Checking this option will allow you to enter your own regular expression for search in the PDF directories.
+</p><p>
+The following syntax is understood:
+</p>
+<ul>
+  <li><code>*</code> - Search in all immediate all subdirectories excluding the current
+      and any deeper subdirectories.</li>
+  <li><code>**</code> - Search in all subdirectories recursively AND the current directory.</li>
+  <li><code>.</code> and <code>..</code> - The current directory and the parent directory.</li>
+  <li><code>[title]</code> - All expressions in square brackets are replace by the corresponding field in the current
+  entry</li>
+  <li><code>[extension]</code> - Is replaced by the file-extension of the field you are using.</li>
+  <li>All other text is interpreted as a regular expression. But caution: You need to escape backslashes by putting
+      two backslashes after each other to not confuse them with the path-separator.</li>
+</ul>
+<p>
+The default for searches is <code>**/.*[bibtexkey].*\\.[extension]</code>. As you can see this will
+search in all subdirectories of the extension-based directory (for instance in the PDF directory) for any file that has the correct extension and
+contains the Bibtex-key somewhere.
+</p>
+</body>
+</html>