[svn-upgrade] Integrating new upstream version, jabref (2.3.1)
[debian/jabref.git] / src / txt / README
2 JabRef 2.3.1
3 ------------
6 Introduction:
8 JabRef is a graphical Java application for editing bibtex (.bib)
9 databases. JabRef lets you organize your entries into overlapping
10 logical groups, and with a single click limit your view to a single
11 group or an intersection or union of several groups. You can customize
12 the entry information shown in the main window, and sort by any of the
13 standard Bibtex fields. JabRef can autogenerate bibtex keys for your
14 entries. JabRef also lets you easily link to PDF or web sources for your
15 reference entries.
17 JabRef can import from and export to several formats, and you can
18 customize export filters. JabRef can be run as a command line application
19 to convert from any import format to any export format.
22 License:
23 JabRef is free open source software, distributed under the GNU General
24 Public Licence. See the enclosed text file 'gpl.txt', or the About
25 dialog, for details about the GPL.
27 JabRef also uses libraries distributed by other porties; see the About
28 box for details.
31 Requirements:
32 JabRef runs on any system equipped with the Java Virtual Machine
33 (1.5 or newer), which can be downloaded at no cost from
34 http://java.sun.com. If you do not plan to compile JabRef, the Java
35 Runtime Environment may be a better choice than the Java Development
36 Kit.
39 Installing and running, Windows:
40 JabRef is available in Windows Installer (.msi) format. To install,
41 double-click the .msi file. A shortcut to JabRef will be added to your
42 start menu.
44 The Windows installation was made by Dale Visser, using the following open-source tools:
45 JSmooth (.exe wrapper for Java apps), available at http://jsmooth.sf.net/
46 Wix (tool for compiling MSI files from an XML specification), available at http://wix.sf.net/
49 Installing and running, general:
50 JabRef can be downloaded as an executable .jar file. Run the
51 program as follows:
52 If you are using the Java Development Kit:
53      java -jar <path to jar>
54 or, if you are using the Java Runtime Environment:
55      jre -new -jar <path to jar> or
56      jrew -new -jar <path to jar>
58 If you run JabRef under Java 1.5, you can add the option "-Dswing.aatext=true" before the
59 "-jar" option, to activate antialiased text throughout the application.
62 The jar file containing JabRef can be unpacked with the command:
63     jar xf <path to jar>
64 or  jar xf <path to jar> <list of files to extract>
65 Unpacking the jar file is not necessary to run the program.
69 Building JabRef from source:
70 Please see the INSTALL file for instructions for building from source.
72 Documentation:
73 JabRef comes with an online help function, accessed by pressing F1 or
74 clicking on a question mark icon. The help files are probably not
75 exhaustive enough to satisfy everyone yet, but they should help sort
76 out the most important issues about using the program. The help files
77 can also be viewed outside the program with a standard HTML browser.
78 If you choose languages other than English, some or all help pages may
79 appear in your chosen languages.
81 Change log:
83 2.3.1
84     - Removed default applications for file types under Mac OS X, and made use of the
85       standard "/usr/bin/open <filename>" way to open files except when an application name
86       is explicitly set.
87     - [ 1620792 ] Fixed: JabRef randomly hangs during Medline fetch
88 2.3
89     - Added handling of unknown file types when synchronizing the file field.
90     - Changed the way customized external file types are stored. Types are now stored in a
91       way analogous to a diff from the default types. This allows default types added in later
92       versions to appear immediately, even if the user has customized the list.
93     - Moved file preferences from General tab to new File tab.
94     - Reduced horizontal size of preferences dialog.
95     - Fixed handling of quotes when using the "abbr" modifier for key generator (Debian bug
96       #448917).
97     - Download file procedure now strips query string in order to find correct file extension
98       (Debian bug #448027).
99 2.3b3
100     - Export formats that output the character encoding now use common names for encodings
101       instead of Java-specific names.
102     - Added "Open" button in external link dialog box to test or use the link.
103     - Added formatter WrapFileLinks which iterates over file links, producing a formatted
104       string for each containing any desired information about the file link.
105     - Applied Fedor Bezrukov patch (setting User-Agent in URLDownload to solve ArXiv problem).
106     - Applied Aaron Chen's patch for fixing bugs in IEEExplore fetcher.
107     - Applied Edward Valeev's patch for handling article numbers replacing pages in Refer/Endnote
108       import.
109     - Added toolbar button to entry editor for writing XMP-metadata.
110     - Added paste and drag & drop support to file list editor.
111     - Added "authorLast" and "editorLast" markers for using last author's last name in BibTeX keys.
112     - Added support for file field in Write XMP action.
113     - Numeric fields (year, volume, number, pmid, citeseercitationcount) are now sorted as numbers
114       when possible.
115     - Improvements to the Ovid import filter.
116     - Modified AuthorLastFirstAbbreviator and AuthorAbbreviator to accept names in both last-first
117       and first-first format, but always return in last-first format. These two formatters are
118       identical.
119     - [ 1648789 ] Fixed: Problem on writing XMP when option to leave out some fields was active.
120     - [ 1561990 ] Fixed: Exporting to WinEdt - apostrophe.
121     - Fixed bug in entry editor: source panel edits were not properly stored when clicking a
122       different entry in the main table.
123     - Fixed problem with "Synchronize file links" not honouring database specific file directory.
124     - Fixed problem with file type selection in external file link editor not being up-to-date.
125     - Fixed problem with wrong enable/disable behaviour of Clear search button when switching
126       between tabs.
127     - Fixed argument parsing in AbstractParamLayoutFormatter so \t and \n can be used for
128       tabs and newlines.
129 2.3b2
130     - When user chooses to save to an existing file, and answers that the file should not be
131       overwritten, a new file dialog now appears instead of the operation cancelling.
132     - Removed antialias setting for main table, because it interferes with proper rendering
133       on LCDs when running under JRE 6. Removed non-optional antialias settings for entry
134       editor for the same reason.
135     - Changed external link handling so remote (http) links can be sent to the external
136       application. Applications like Evince and Gimp can open remote links.
137     - Replaced Simle HTML export filter with improved version by Mark Schenk.
138     - Introduced ParamLayoutFormatter interface for layout formatters that can take an
139       argument by the following syntax: \format[MyFormatter(argument)]{\field}
140       Implementing classes contain a setArgument(String) method that receives the argument
141       (if any) before the format() method is called.
142     - Timestamp and owner fields are now set also when appending a bib file, and new options
143       have been introduced to control whether imported/appended/pasted entries should have
144       these fields overwritten if already set.
145     - Added operations for adding file links in import inspection window, and made file
146       and URL icons in the table clickable.
147     - Removed PDF and PS columns and operations in import inspection window (replaced by
148       operations on the "file" field).
149     - File field column in main table now shows file type icon instead of generic icon. 
150     - Modified Endnote export to take "file" field into account, and to resolve full
151       paths to PDF files.
152     - Added "Auto" button to automatically set "owner" field to the default username. 
153     - Added \encoding tag for begin/end layouts in export filters to print the name of the
154       character encoding used for the export. The tag is not available in entry layouts.
155     - Added \% as a supported LaTeX command, producing '%'.
156     - Fixed bug in HTMLChars: commands like {\aa} and {\o} were not processed properly, even
157       though defined in Globals.HTMLCHARS.
158     - Fixed bug that made it possible to accidentally close database without saving, when error
159       occurs during the save operation.
160 2.3b
161         - Added % at start of signature text in BibTeX output. Parser now reads both
162           old and new style.
163         - Added MIS Quarterly export format.
164     - Added support for COPAC file format.
165         - Added RemoveTilde LayoutFormatter to deal with Bibtex non-breakable spaces.
166         - Added autocompletion feature for author/editors and other fields.
167         - Added feature to save all open databases.
168         - Added support for pushing citations to Vim when Vim server is enabled.
169         - Added missing option for specifying the path to LEd.exe.
170         - Added -s/--nosplash command line option for disabling the splash screen.
171         - Added new field marker [auth.etal] for key generation.
172         - Added support in XMP metadata handling for bibtex string resolution.
173         - When opening databases, already open files are now skipped.
174         - Option to use native instead of Swing file dialogs is now available on all OSes.
175         - Synchronize external links now searches entire database, not selected entries.
176         - Medline import now adds <Affiliation> information into the "institution" field.
177         - Improved handling of external links. The 'file' field can now specify a list
178           of external links, and arbitrary file types are supported. Old-style PDF and
179           PS links can be moved automatically into the 'file' field.
180         - Fixed minor bug in importing preferences. General fields for entry editors are
181           now updated without restarting JabRef.
182         - Fixed bug in RIS and Refer/Endnote imports. Entries with editors but no authors
183           are now imported properly.
184         - Fixed missing export formatter AuthorFirstFirstCommas.
185         - Fixed minor bug in Harvard export with missing space between year and title.
186         - Fixed bug that caused lockup when connection to IEEExplore fails.
187         - Fixed wrong dependency in OAI2/ArXiv Fetcher.
188         - Fixed problem with foreign characters in OAI2/ArXiv Fetcher.
189         - Fixed problem with key generation in OAI2/ArXiv Fetcher.
190         - Fixed bug in duplicate search that made misc entries never get
191           detected as duplicates.
192         - Fixed bug in XMP reimport from DublinCore related to month strings.
193 2.2     - Added progress bar to indicate progress when synchronizing PS/PDF links.
194         - Option to autogenerate key for imported entries now also affects entries imported
195           without using the import inspection window.
196         - Modified quick jump behaviour so sequences of letters can be found. Timeout or
197           ESC resets the search.
198         - Width of side pane is now remembered.
199         - Improved XMP support: 
200           - JabRef now reads and write DublinCore and Legacy Document Properties
201             Caution needs to be used though since, JabRef does overwrite existing values.
202           - XMP privacy filter can be used to prevent sensitive fields to be exported.
203         - Support for OAI2 identifiers with subcategories, e.g. math.RA/0601001
204         - Fixed bug that made explicit groups appear empty after updating group tree from external
205           change.
206         - New windows installer thanks to Uwe St�hr.
207         - [ 1641247 ] Fixed: No update of preview after generating bibtex key
208         - [ 1631548 ] Fixed: Absolute paths should be stored for last open files.
209         - [ 1598777 ] Fixed: Month sorting
210         - [ 1570570 ] New Feature: Deselect all duplicates on import
211         - [ 1574773 ] Fixed: sanitizeUrl() breaks ftp:// and file:///
212         - [ 1609991 ] Fixed: Silverplatter Import: Publisher and Year confused
213         - [ 1608391 ] Fixed: Medline Search Editbox size gets to big
214 2.2b2   - Redesigned export functions to simplify GUI and provide "Export selected
215           entries" functionality. Export filter is now chosen using the file type
216           dropdown menu in the file dialog.
217         - Fixed bug that caused UnsupportedEncodingException on Windows when saving.
218         - Added warning dialog when exporting failed.
219         - Added fix for exporting special chars in RTF like ���...
220         - Added NameFormat LayoutFormatter based on Bibtex method name.format$
221         - Added Fetch from ArXiv.org to Web Search
222           [ 1587342 ] Quering ArXiv (and any OAI2 Repository)
223         - [ 1594123 ] Fixed: Failure to import big numbers in Bibtex
224         - [ 1594169 ] Fixed: Entry editor navigation between panels faulty
225         - [ 1588028 ] Fixed: Export HTML table has relative DOI URL
226         - [ 1601651 ] Fixed: PDF subdirectory - missing first character
227 2.2b    - Added Mark Schenk's advanced HTML export filter.
228         - Added options to copy/move/link to dragged linkable file (pdf, ps, etc.).
229         - Removed unnecessary output text when scanning for external file changes.
230         - Changed layout of entry editor to solve problem with collapsing text fields.
231         - Added first version of support for XMP-metadata in PDFs.
232           - "Import into..." 
233           - Integrate with copy/move/link.
234           - Added option to write all/selected PDFs in database
235         - Added tooltips to database tabs showing the file's full path.
236         - Added function for setting or clearing specific fields in selected or
237           all entries.
238         - Setting a relative PDF/PS path in Database Properties now makes JabRef
239           look for the directory relative to the bib file's location.
240         - Removed Oxford comma from AuthorList...Comma-LayoutFormatters.
241         - Added LayoutFormatters that print the Oxford comma.
242         - Added missing space between abbreviated author first names:
243           William Andrew Paul => W. A. Paul (used to be W.A. Paul)
244         - Added LayoutFormatter for HTML paragraphs.
245         - Changing Database Properties now causes the database to be marked as changed.
246         - Improved simple search. Words are now treated as separate search terms,
247           and phrases can be indicated with "double quotes".
248         - When a letter key is pressed in the table, the first entry starting with the
249           same letter (in the current sort column) is selected.
250         - Bib files dragged into JabRef now appear in the Recent files menu.
251         - Fixed bug in import dialog.
252         - Better support for ISI files in general (should basically be better than INSPEC) including IEEE parsing.
253         - Added regular expression search for auto-linking. Search is now more flexible by default.
254         - Search operation also now search relative to the JabRef directory.
255         - General improvements in Inspec ISI handling.
256         - New LayoutFormatter: AuthorOrgSci - first author is in "last, first" 
257           all others in "first last". First names are abbreviated.
258         - New LayoutFormatter: NoSpaceBetweenAbbreviations - spaces between multiple 
259           abbreviated first names are removed.
260         - Improved PDF link resolver to produce proper URIs.
261         - [ 1503956 ] Fixed: Help text instead of Help icon.
262         - [ 1542552 ] Fixed: Wrong author import from ISI file.
263         - [ 1534537 ] Fixed: resize groups interface
264         - [ 1465610 ] Fixed: (Double-)Names containing hyphen (-) not handled correctly
265         - [ 1436014 ] Fixed: No comma added to separate keywords
266                 - [ 1548875 ] Fixed: download pdf produces unsupported filename
267                 - [ 1545601 ] Fixed: downloading pdf corrupts pdf field text
268         - [ 1285977 ] Fixed: Impossible to properly sort a numeric field
269             - [ 1535044 ] Fixed: Month sorting
270         - [ 1540646 ] Fixed: Default sort order: bibtexkey
271         - [ 1553552 ] Fixed: Not properly detecting changes to flag as changed
272 2.1     - Added capability to drag files and WWW links into JabRef. BibTeX files will be
273           opened normally, other files imported, and WWW links downloaded and imported.
274         - The -v command line option now makes the application only print version number
275           and quit immediately.
276         - Duplicates within a set of imported entries are now found and shown in the
277           import inspection window.
278         - Mac users can now choose between native and Swing file chooser under
279           Preferences -> Advanced.
280         - Fixed missing duplicate warning when importing without import inspection window.
281         - Fixed error in ISI import which allowed empty fields to be set, causing errors
282           when saving and reloading entries.
283         - Fixed missing time and owner stamps when importing entries (only in 2.1b/2.1b2).
284         - Fixed erroneous updates in entry editor if user switches to a different entry
285           while downloading PDF/PS file.
286         - Fixed bug (only in 2.1b2) in calling file open/save dialog on Mac OS X.
287         - Fixed bug that made duplicate resolver dialog pop under import inspection dialog.
288         - Fixed bug in windows-installer which prevented running JabRef from the 
289           command-line with arguments.
290         - Added windows-installer-option to associate JabRef with .bib files.
291 2.1b2   - Added option to toggle floating of marked entries to the top of the table.
292         - Added option to open, append and import multiple BibTeX files.
293         - Improved support for LaTeX special characters in HTML and RTF representations.
294         - Improved generation of subdatabase from AUX file. Crossreferenced entries are
295           now included automatically.
296         - Fixed bug that made entry selection get lost when an edit modifies the entry's
297           position in the main table.
298         - Fixed bug in BibTeXML export (entry type name missing in tag).
299         - Fixed name handling in (non-compliant) Endnote files giving all author names
300           on the same line.
301         - Fixed problem with keyword handling in Medline import.
302         - Fixed (harmless) NullPointerException when medline fetch is cancelled.
303         - Fixed bug in parser that made {"} illegal in fields quoted with ".
304 2.1b    - Known issue: font sizes cannot be changed, but should follow OS settings on
305           Windows and Mac.
306         - Known issue: some HTML may be handled inappropriately when downloading from
307           IEEEXplore.
308         - Changed Paste function so timestamp and owner fields are updated.
309         - Added "Other" item to the "New entry ..." menu.
310         - Changed sorting order so marked entries are displayed at the top of the table.
311         - Added IEEEXplore search and download feature.
312         - Added option to store entries in their original order. Unsorted table view now
313           shows entries in their original order.
314         - Added option to autogenerate keys for entries with missing keys before each save.
315         - Improved handling of external URLs to prevent problems with special characters.
316         - Medline and Endnote imports no longer automatically add curly braces around capital
317           letters in title.
318         - Float search now scrolls table to the top.
319         - Fixed lockup problem in preview with uneven number of # characters in fields.
320         - Fixed problem with default content selector fields reappearing after removal.
321         - Fixed problem with unsupported character encodings being selectable and causing
322           unreported save errors.
323         - Fixed bug that blocked last line in table columns setup from being removed.
324         - Fixed missing export formats from command line.
325         - Fixed bug that made Review tab impossible to remove from entry editor.
326         - Fixed bug in Medline XML import that assigned wrong PMID for some entries.
327         - Fixed bug in custom export that collapsed sequences of two or more backslashes
328           into a single backslash in output.
329         - Fixed bug (misspelled formatter name) in Harvard RTF export.
330 2.0.1:  - Fixed bug that made a hidden entry editor under some circumstances store a
331               field value to the wrong entry.
332             - Fixed synchronization bug that made the opening of a new database sometimes fail.
333             - Fixed bug in setting external journal lists when no personal list is set.
334 2.0:    - Changed sorting selection interface for main table for more intuitive
335           operation.
336         - Made import operation update "working directory".
337         - Removed hard-coded author/editor name rearrangement in OpenOffice and
338           OpenDocument exports.
339         - Fixed hangup when parsing RIS files from Nature.
340         - Fixed NullPointerException when generating database from AUX file on Mac OS X.
341         - Fixed bug in routine for adding braces around capital letters.
342         - Fixed bug in switching preview layouts.
343         - Fixed bug in link handling in entry preview.
344 2.0b2:  - Changed field order in OpenDocument export to comply with bibliography requirement.
345         - Added support for inserting citations into Emacs using gnuserv/gnuclient.
346         - Added option to set a regular expression replace operation on generated bibtex keys.
347         - Added support for custom importers inside a jar file.
348         - Fixed bug in opening URLs containing '&' on Windows.
349 2.0b:   - Added a system for registering custom import formats in the form of Java classes.
350         - Added export option for OpenDocument spreadsheet.
351         - Added new options for name formatting in main table.
352         - Added REPEC-NEP import filter.
353         - Added option for non-field parameters for export formatters. If the parameters does not start with the
354           backslash character, it will be passed unchanged to the formatter in place of any field value.
355         - Added export formatter CurrentDate, which returns the current date, and takes a format string as
356           parameter.                   
357         - Added customization of table colors, accessible from Tools -> Preferences -> Entry table.
358         - Added new Appearance tab to preferences dialog to gather appearance related options.
359         - Added toggling of abbreviated and full journal names. The list of journals is realized as
360            an external file, but editable from a Manage Journal Abbreviations panel. Secondary lists can also
361            be linked, but not edited. There is a download option to quickly get a list available on the internet,
362            and we will provide one or more lists for download from the SourceForge web server.
363         - Added functionality for new JabRef instances to detect a running instance, and send
364           command line parameters to the running instance for processing.
365         - Added handling of HTML links in preview panel.
366         - Added confirmation dialog when database is saved and the chosen encoding doesn't support all characters.
367           Gives options to save, cancel or try a different encoding.
368         - The encoding used when opening a database is now remembered, and used when database is stored.
369         - Added review field for research comments, paper reviews, etc.
370         - Added option to disable wrapping for certain fields. Wrapping of pdf, ps, doi and url is disabled by
371           default.
372         - Antialiasing option now affects entry editor text fields as well as table text.
373         - Changed to monospaced font in source editor field.
374         - Removed option to put double braces around BibTeX fields, but retained option to remove double braces
375           when loading. Added option to put braces around capital letters of a chosen set of fields.
376         - Improved Ovid import.
377         - Fixed problem with ordering of BibTeX strings that are referred to by other strings.
378         - Fixed problem with loading 16-bit encoded bib files with 8-bit encoding as default, and vice versa.
379         - Fixed multiplying authors bug when author/editor field appears both in Required and Optional tabs.
380         - Fixed startup freeze when trying to load certain malformed bib files.
381         - Fixed bug related to multi-line fields in RIS import.
382         - Fixed bug related to looking up a fully qualified DOI
383         - Included review field to preview panel 1, which shows the abstract
384         - Fixed bug where booktitle field was not displayed in preview
385           for conference proceedings, similar to journal field
386         - By default preserve capitalization on the following fields: title;journal;booktitle;review;abstract
387 1.8.1:  - Added automatic timestamp with configurable format for entries.
388         - Added new key generator modifier ":abbr" to abbreviate field contents.
389         - Added Help button in Preferences -> Entry preview
390         - Added Big5, Big5_HKSCS and GBK encodings for Chinese.
391         - Improved marking feature. Username is now used for marking, so different users can mark
392           entries separately without interference.
393         - Improved handling of names such as "Firstname de la Lastname jr.", with different handling
394           for presentation and sorting purposes. Key generation now should always use the genuine last
395           name, and not produce keys like "de2001".
396         - Removed duplicate warning from inspection dialog for non-selected entries.
397         - Fixed setting of sheet name in OpenOffice.org Calc export.
398         - Fixed bug that prevented PDF/PS opening by F4 from automatically finding files in
399           subdirectories below the main PDF/PS dir.
400         - Fixed BibTeX parser bug that made it choke on short comment strings.
401         - Fixed bug that made regexp search fail for fields containing newline characters.
402         - Fixed platform-dependent handling of newline characters.
403         - Fixed bug that prevented command line import with explicit format.
404         - Fixed bug that made it impossible to disable table antialiasing.
405         - Fixed AuthorAndsCommaReplacer.
406 1.8:    - Search panel now starts visible if it was visible at last shutdown.
407         - Added option to disable import inspection window when only one entry is being imported.
408         - Fixed parser bug that caused problems for bib files containing extra characters after the
409           last entry.
410         - Fixed missing month in JStor import.
411             - Fixed some bugs in "new from plain-text" wizard
412 1.8b2:  - Changed handling of external updates so the notification is suppressed when there are
413           no actual changes.
414         - Changed autodetecting import so BibTeX files are handled more similarly to other formats.
415         - Enabled sorting by icon columns.
416         - Added option to remove BibTeX source panel from entry editor.
417         - Added command line option to not load any files at startup. Will override any autoloading
418           or other command line options that normally load or import files.
419         - Added handling of duplicates to import inspection window.
420         - Made entry preview be updated whenever the selection is expanded by one row, to make
421           it more useful while selecting a set of entries.
422         - Changed BibTeX field parsing to avoid inserting line breaks at wrong places.
423         - Improved handling of page numbers in Medline import.
424         - Fixed import of file links when importing SixPack files.
425         - Fixed bug that prevented closing of search interface when no databases are open.
426         - Fixed OpenOffice Calc export to be compatible with OpenOffice.org 2.0 beta.
427         - Fixed bugs in Refer/Endnote import filter. 
428         - Fixed bug that caused changes to be lost in some cases when the same field is present
429           in multiple entry editor tabs.
430         - Fixed bug that prevented command line autodetecting import from working with BibTeX files.
431         - Fixed minor bug in routine for removing double braces.
432 1.8b:   - Added option to store bib file with double braces.
433         - Follow @input tags in aux files to indicate nested aux files for
434           generating subdatabases.
435         - Improved wrapping and formatting of bib files, to preserve paragraph separator (empty line).
436         - Added test buttons for customization of preview layouts.
437         - Added inspection dialog for previewing and generating keys for imported entries,
438           and deciding which ones to keep and discard. The dialog allows inspection during long import
439           processes such as Medline search.
440         - Restructured layout to use a common side pane with all tabs.
441         - Added import filter for Cambridge Scientific Abstracts (CSA) format.
442         - Added PS directory with similar options as PDF.
443             - Added [authshort] and [edtrshort] key field markers. Patch submitted by
444               Kolja Brix.
445         - Made the program remember preview enable setting.
446         - Improved handling of illegal regular expressions in search.
447         - Removed options to search only Required, Optional and/or General fields,
448           in order to simplify search interface.
449         - Changed keys for Next and Previous tab to CTRL-PGDN and CTRL-PGUP to match shortcuts in a
450           certain popular web browser.
451         - Minor change to Preferences -> Table columns to enable insertion of column in position 2.
452         - Fixed parser bug that caused problems for files with >10000 entries.
453         - Fixed bug in entry editor that caused the source edit panel to remove marking from entries.
454         - Fixed export bug that made "\begin" tags fail if encountered immediately after an "\end" tag. 
455         - Fixed export bug that made whitespace disappear after empty field values.
456         - Fixed ISI import bug that handled SO fields with line breaks wrong.
457         - Fixed bug occuring when choosing not to import duplicate imported entry.
458         - Fixed problem with detecting popup trigger on Mac OSX with one button mouse.
459         - Fixed erroneous relative paths for PDF files when PDF directory is not set.
460         - Fixed entry preview to resolve string references.
461 1.7.1   - Removed unnecessary stack traces when opening external viewer.
462         - Fixed bug that made Ctrl-E destroy current edit in entry editor.
463         - Fixed problem when copying modified BibTeX key gave old value.
464         - Fixed missing 'booktitle' import in CONF entries in RIS import.
465         - Fixed bug that made group tree disappear for certain keyword expressions.
466         - Fixed bug that made standard BibTeX fields be saved without line wrapping.
467 1.7     - When fetching from Medline or CiteSeer, fetched entry is now opened in editor.
468         - Added French translations of help files.
469         - Added color highlighting of focused text field in entry editor.
470         - Added option in context menu of entry editor for changing capitalization
471               of field contents.
472             - Added name conversion "Smith, RA" -> "Smith, R. A." to Medline import.
473             - Fixed bug that left some search settings items disabled when they shouldn't be.
474         - Fixed bug that caused requirement for restart to register change in default
475           key pattern.
476         - Fixed bug that caused crash some times after adding/removing field content selectors.
477         - Fixed bug in recognizing custom entry types when reading bib files.
478         - Fixed bug that allowed a deleted entry to stay visible in the entry editor.
479 1.7b2:  - Made side pane resizable.
480         - Replaced entry customization dialog with improved interface.
481         - Added standard entry type "conference", similar to "inproceedings".
482         - Added default key pattern to avoid the need to set similar patterns manually.
483         - Added line wrapping to metadata in saved .bib file to avoid long lines.
484         - Added "bibtexkey" as implicit fourth sort criterion, to minimize problem with almost
485           similar entries swapping places.
486         - Added OpenOffice.org Calc export filter that exports spreadsheet compatible with the
487           OpenOffice.org bibliography feature.
488         - Added a couple of previously unsupported publication types in SciFinder.
489         - Added extra shortcuts CTRL-+ and CTRL-- for switching tabs in entry editor, since
490           original shortcuts CTRL[-SHIFT]-TAB is used by some window managers.
491         - Updated Endnote export filter.
492         - Fixed focus and key binding problems for switching tabs/entries in entry editor
493         - Fixed bug that prevented required fields tab from appearing for entries with only bibtex key
494           as required field.
495         - Fixed bug that prevented the user from changing the default encoding.
496         - Fixed bugs in RIS import.
497         - Fixed bug 1112050; freeze when reading certain author fields with mismatched braces.
498 1.7b:   - Changed routine for rearranging author names (Lastname, Firstname) so bracketed
499             expressions are treated as units.
500         - Grouping controls now allow group hierarchies, and now allow explicit and search
501           expression groups as well as keyword groups.
502         - Added full customization of general fields tabs
503         - Added option to preserve formatting for non-BibTeX fields.
504         - Added integrity check for database.
505         - Added export filters EndNote and Harvard RTF.
506         - Added automatic import format chooser for import (same as wildcard import below).
507         - Added wildcard (*) option for command-line import, to try to automatically
508           determine the correct format.
509         - Improved layout of Preferences dialog.
510         - Improved several import filters.
511         - Added authIniN/edtrIniN key formatters.
512         - Marked entries now float to the top when no searching or grouping reordering is active.
513         - Fixed problem with opening file dialog on Win NT - AWT dialog is now opened if
514           Swing dialog fails.
515 1.6:    - Improved handling of entry selection in various ways. E.g. selected entry is now scrolled
516           into view when opening entry editor and entry is kept selected when importing CiteSeer
517           fields.
518         - Fixed update bug between autogenerated bibtex key and source panel.
519         - Fixed missing . at the end of last author name in RIS import.
520         - Fixed NullPointerException on certain special characters when exporting to BibTeXML.
521         - Fixed bug that sometimes prevented the unmarking of entries.
522         - Fixed problem with formatting one-name authors.
523 1.6b:   - Added mnemonic keys to menus and menu items.
524         - Added MODS and tab-separated file export
525         - Added facility for detecting and handling external changes to open bib files.
526         - Added scan option for exact duplicates with automatic removal.
527         - Bibtex strings are now sorted automatically.
528         - Bibtex strings are now resolved when exporting database.
529         - Fixed problem with field content selector getting too wide. Limited width.
530         - Fixed PDF/PS view routine to remove problems with filenames
531           containing spaces.
532         - Fixed bug that interfered with Fetch Medline by ID, and fixed
533           parsing problem with certain Medline entries.
534         - Fixed bug that interfered with Push to WinEdt.
535         - Fixed HTML output so \c{c} is handled correctly.
536         - command line option for generating a sub-database from LaTex aux file
537           entries
538         - simple copy/paste menu in entry editor
539         - experimental: text-input-area with underlying infotext in plaintext import dialog
540 1.55:   - Made method for opening PDF files robust with regard to file separators (/ and \),
541           so bib files can easier be used across platforms.
542         - Improved Medline fetcher. Can now fetch entries based on a search expression.
543         - Added features for fetching fields and referring publications from the CiteSeer
544           database.
545         - Added option to always save database ordered by author/editor/year, and made this
546           the default setting.
547         - When a single entry is selected, right-click menu now shows a checkbox menu for group
548           memberships instead of the regular "Add to" and "Remove from" menus.
549         - Improved [shorttitle] and [veryshorttitle] special key pattern fields.
550         - Added dialog box for conveniently setting the fields of an entry from a
551           plain text description.
552         - Added formatter "ResolvePDF" to create correct PDF/PS links in HTML export when
553           relative file names are used.
554         - Added Abstract panel in entry editor.
555         - Added alternate preview with abstract, and made both previews configurable.
556         - Added the option to create a subset of a database based on an .aux file.
557         - Added 'Cancel' button to duplicate resolver dialog, so the process can be stopped.
558         - Added check for spaces in custom entry type names.
559         - Added several new key pattern markers.
560         - Added toolbar buttons for Mark/Unmark to improve discoverability.
561         - Fixed bug that made export filters ignore the chosen character encoding.
562         - Fixed bug that interfered with author name formatting.
563         - Fixed various bugs in import filters.
564         - Fixed bug that prevented confirmation dialog when deleting entry from the entry editor.
565         - Fixed bug that made the next entry be opened instead of the current, when pressing
566           Enter in table.
567         - Fixed bug that made it possible to leave a source edit when the source didn't validate
568           properly. Also made it impossible to change table selection until source validates.
569 1.5:    - Enabled selection of default encoding, and started storing encoding information in
570           saved .bib files, which is used when reopening.
571         - Added Highlight and select options to the group interface, and made it possible
572             to change the number of visible lines in the list.
573               - Added option to allow or disallow direct table editing.
574         - Added optional confirmation dialog for deleting entries.
575               - Added optional warning dialog for duplicate BibTeX keys.
576         - Added warnings to bibtex parser, and prevented failure to load files with
577           duplicate string definitions.
578               - Added JStor import filter.
579         - Changed the look and feel to JGoodies Forms on non-Macintosh platforms.
580         - Optimized performance in several areas.
581         - Numerous usability improvements.
582         - Fixed RIS import bug caused by short lines.
583               - Fixed bug in SciFinder import.
584               - Fixed bug that made entire field get cleared when removing from group.
585 1.4:    - Added advanced search feature.
586         - Added facility for using custom export formats.
587         - Added command line options for importing/exporting files, importing/exporting
588           user preferences, loading session and for suppressing the GUI (using RitOpt for
589           parsing options).
590         - Added automatic stripping of \url{} when opening url.
591         - Improved export filters.
592         - Fixed focus bug which sometimes interfered with cut/copy/paste.
593 1.3.1:  - Bugfix.
594 1.3:    - Added entry preview.
595         - Added detection of duplicate entries.
596               - Added possibility to mark entries persistently.
597         - Added import filter for Sixpack and Biblioscape Tag files.
598               - Added option to use a standard directory for PDFs. PDFs placed in or below this directory
599           and named after an entry's BibTeX key can be automatically found.
600             - Added optional columns showing clickable icons for pdf/ps and url/doi links.
601         - Added menu and toolbar actions for open pdf/ps and url/doi.
602         - Added web lookup of DOI.
603         - Added several new special field markers to the key autogenerator.
604               - Added BibTeXML and simple HTML export.
605               - Changed browsing of entries. Entry editor now shows the selected entry.
606               - Improved HTML export for several entry types.
607               - Improved compatibility with Mac OS X.
608         - Made it possible to set custom secondary and tertiary sort fields.
609         - Made the entry number column width customizable.
610               - Fixed bug that caused database to always be marked as changed after viewing source.
611                - Fixed bug in selector word removal.
612                - Fixed  bug that made the file chooser unable to interpret Mac OS X aliases.
613 1.2:    - Replaced the icon set.
614         - Added support for French language.
615         - Added customization of key generation.
616         - Improved HTML export.
617         - Added Replace string feature.
618             - Made a couple of adaptations for Mac OS X users.
619         - Added option in Table Preferences to set current column widths as default.
620             - Added import filter for BibTeXML.
621         - Fixed bug that allowed non-lowercase grouping field, leading to problems.
622         - Fixed bug that made selector words added in the dialog to be lowercased.
623         - Fixed bug relating to translated help files.
624 1.19:   - Entry editor is now opened for an entry that causes an error when saving.
625         - Added options to display names in harmonised format in the main table.
626         - Added Docbook and (experimental) HTML export.
627         - Enabled 'doi' and 'pii' fields for Medline import.
628         - Enabled antialiasing fonts.
629         - Added the Kunststoff look&feel to give a more pleasant user interface.
630         - Added font selector for the main table.
631         - Improved table column customization.
632         - Added word selector feature for selected fields (keywords, journal).
633         - Added support for German and Norwegian language.
634         - Generalized copy cite key features for multiple entries.
635         - Added quick load/save session feature.
636         - Fixed issue/number bug in ISI import.
637         - Added "Open pdf/ps" item in right-click menu.
638         - Fixed bug causing external viewer to only work in General fields.
639         - Added functionality for using Browse buttons for file-related fields
640           (ps, pdf, etc.).
641         - Added Browse buttons to External programs tab in Preferences.
642         - Fixed bug related to Save database and Source field which caused changes
643           to disappear.
644 1.1:    - Added bibtex key uniqueness checking, and prevented autogeneration
645           from generating non-unique keys.
646         - Added command line option to load file on startup.
647         - Fixed problem with autogeneration creating invalid keys.
648         - Improved Refer/Endnote import.
649         - Added feature for importing entries and/or strings and/or group
650           definitions from another BibTeX database.
651         - Added menu choices to import into open database.
652               - Added toolbar button for closing current database.
653               - Fixed shortcut key for "Store field" in entry editor, and fixed
654                 problem that made shortcut for "Save database" unavailable from
655           entry editor.
656         - Added option to fetch Medline entries automatically by
657           ID, based on a patch submitted by Mike Smoot.
658         - Fixed bug in RIS import.
659         - Added options to copy key and copy "\cite{key}" to right-click menu.
660         - Fixed bug that caused some General fields not to get displayed.
661         - Enabled customization of General fields.
662         - Enabled customization of existing entry types, and definition of
663           new types.
664 1.0:    First release.
667 Bug reports, suggestions, other feedback:
668 We are thankful for any bug reports or other feedback. If there are
669 features you want included in JabRef, tell us!
672 JabRef homepage:
673 http://jabref.sourceforge.net
675 You can always get the very latest version of the program from our CVS
676 repository; instructions for downloading are found on the
677 homepage. Note that the CVS version may contain untested features, or
678 have other stability issues. Unless you're feeling extremely lucky, go
679 for the version in the HEAD branch of the module 'jabref'.
682 Bug submission and Open Discussions and Help forums are found at:
683 http://sourceforge.net/projects/jabref
686 Corresponding authors:
687 mortenalver _ users.sourceforge.net
688 nbatada _ users.sourceforge.net