~ubuntu-branches/ubuntu/trusty/jabref/trusty

« back to all changes in this revision

Viewing changes to src/txt/README~

  • Committer: Bazaar Package Importer
  • Author(s): gregor herrmann
  • Date: 2009-12-01 18:52:51 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20091201185251-08e2unpn1jl8ijq8
Tags: 2.6~beta2-1
* Remove alternative dependency on sun-java5-jre which was removed from the
  archive. Also adjust README.Debian and /usr/bin/jabref.
* New upstream beta release:
  - fixes "allow to disable (re)storing of current tab for entries"
    (closes: #447767)
  - thanks again to Philip Rinn for his help with the upgrade
* debian/copyright: add new developer.
* Refresh patches 01_free_javac.patch and 06_BibtexEntry.patch.
* Adjust debian/jabref.links and debian/jabref.install to new jar file.
* Simplify debian/jabref.dirs.
* Add a presubj fragment for reportbug.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
 
2
 
JabRef 2.5 beta
3
 
---------------
4
 
 
5
 
Introduction:
6
 
 
7
 
JabRef is a graphical Java application for editing bibtex (.bib)
8
 
databases. JabRef lets you organize your entries into overlapping
9
 
logical groups, and with a single click limit your view to a single
10
 
group or an intersection or union of several groups. You can customize
11
 
the entry information shown in the main window, and sort by any of the
12
 
standard Bibtex fields. JabRef can autogenerate bibtex keys for your
13
 
entries. JabRef also lets you easily link to PDF or web sources for your
14
 
reference entries.
15
 
 
16
 
JabRef can import from and export to several formats, and you can
17
 
customize export filters. JabRef can be run as a command line application
18
 
to convert from any import format to any export format.
19
 
 
20
 
 
21
 
License:
22
 
JabRef is free open source software, distributed under the GNU General
23
 
Public Licence. See the enclosed text file 'gpl.txt', or the About
24
 
dialog, for details about the GPL.
25
 
 
26
 
JabRef also uses libraries distributed by other porties; see the About
27
 
box for details.
28
 
 
29
 
 
30
 
Requirements:
31
 
JabRef runs on any system equipped with the Java Virtual Machine
32
 
(1.5 or newer), which can be downloaded at no cost from
33
 
http://java.sun.com. If you do not plan to compile JabRef, the Java
34
 
Runtime Environment may be a better choice than the Java Development
35
 
Kit.
36
 
 
37
 
 
38
 
Installing and running, Windows:
39
 
JabRef is available in Windows Installer (.msi) format. To install,
40
 
double-click the .msi file. A shortcut to JabRef will be added to your
41
 
start menu.
42
 
 
43
 
The Windows installation was made by Dale Visser, using the following open-source tools:
44
 
JSmooth (.exe wrapper for Java apps), available at http://jsmooth.sf.net/
45
 
Wix (tool for compiling MSI files from an XML specification), available at http://wix.sf.net/
46
 
 
47
 
 
48
 
Installing and running, general:
49
 
JabRef can be downloaded as an executable .jar file. Run the
50
 
program as follows:
51
 
If you are using the Java Development Kit:
52
 
     java -jar <path to jar>
53
 
or, if you are using the Java Runtime Environment:
54
 
     jre -new -jar <path to jar> or
55
 
     jrew -new -jar <path to jar>
56
 
 
57
 
If you run JabRef under Java 1.5, you can add the option "-Dswing.aatext=true" before the
58
 
"-jar" option, to activate antialiased text throughout the application.
59
 
 
60
 
 
61
 
The jar file containing JabRef can be unpacked with the command:
62
 
    jar xf <path to jar>
63
 
or  jar xf <path to jar> <list of files to extract>
64
 
Unpacking the jar file is not necessary to run the program.
65
 
 
66
 
 
67
 
 
68
 
Building JabRef from source:
69
 
Please see the INSTALL file for instructions for building from source.
70
 
 
71
 
Documentation:
72
 
JabRef comes with an online help function, accessed by pressing F1 or
73
 
clicking on a question mark icon. The help files are probably not
74
 
exhaustive enough to satisfy everyone yet, but they should help sort
75
 
out the most important issues about using the program. The help files
76
 
can also be viewed outside the program with a standard HTML browser.
77
 
If you choose languages other than English, some or all help pages may
78
 
appear in your chosen languages.
79
 
 
80
 
 
81
 
Bug reports, suggestions, other feedback:
82
 
We are thankful for any bug reports or other feedback. If there are
83
 
features you want included in JabRef, tell us!
84
 
 
85
 
 
86
 
JabRef homepage:
87
 
http://jabref.sourceforge.net
88
 
 
89
 
You can always get the very latest version of the program from our SVN
90
 
repository; instructions for downloading are found on the
91
 
homepage. Note that the SVN version may contain untested features, or
92
 
have other stability issues.
93
 
 
94
 
Bug submission and Open Discussions and Help forums are found at:
95
 
http://sourceforge.net/projects/jabref
96
 
 
97
 
 
98
 
Corresponding authors:
99
 
mortenalver _ users.sourceforge.net
100
 
nbatada _ users.sourceforge.net