]> git.lyx.org Git - lyx.git/blobdiff - README
Merge branch 'master' of git.lyx.org:lyx
[lyx.git] / README
diff --git a/README b/README
index e9487959fd92e8013378b65b60c6baf72c924adb..2da3d1a1162353be5b752c33a473a9fbef80349c 100644 (file)
--- a/README
+++ b/README
@@ -25,36 +25,50 @@ What is LyX?
 
 What do I need to run LyX?
 
-    Either of :
+    Either:
     * a Unix-like system (including Windows with cygwin)
     * Windows 2000 or newer
-    * Mac OS 10.2 or newer
+    * Mac OS 10.4 or newer
 
-    A decent LaTeX2e installation (e.g. teTeX for unix) not older
-       than 1995/12/01.
-    Python 2.3 or later to convert old LyX files and for helper scripts
+    A decent LaTeX2e installation (e.g. TeX Live for Linux, MikTeX for
+    Windows).
+
+    Python 2.4 or later to convert old LyX files and for helper scripts.
+    Note 1: Python 2.4 or later is required due to the subprocess module.
+    Note 2: Python 2.6 or later is recommended on Windows.
+    Note 3: Python 3.0 or later is not supported.
 
 How does the LyX version scheme work?
 
-    LyX uses a continuous numbering scheme in which odd or
-    even numbering is not significant. Instead a number '1.x.y'
-    indicates stable release '1.x', fix level 'y'. Prereleases
-    are labeled with a "pre" suffix. Thus there are three possible
-    file names:
-
-       lyx-1.5.0.tar.gz       -- stable release
-       lyx-1.5.5.tar.gz       -- fifth maintenance release of the
-                                 1.5 stable release
-       lyx-1.5.0pre1.tar.gz   -- potentially unstable test release
-
-    The maintenance releases are designed primarily to fix bugs. The
-    goal here is not to have parallel development as for the linux
-    kernel (the team is too small to afford that), but rather to
-    include all the simple (so that the maintenance burden on us
-    is not too high) and safe (so that system administrators can
-    install them without fear) bug fixes.  Experience shows that
-    these releases will contain a few new features, and that the
-    bulk of the patches will be documentation updates.
+    LyX uses a contiguous numbering scheme for versions, where a
+    number "1.x.y" indicates a stable release '1.x', maintenance
+    release 'y'.  In other words, LyX 1.5.0 was the first stable
+    release in the 1.5-series of LyX. At the time of writing, the
+    latest maintenance release in the 1.5-series was LyX 1.5.2
+
+    Please note that maintenance releases are designed primarily to
+    fix bugs, and that the file format will _never_ change due to a
+    maintenance release.
+
+    In addition to the stable releases and maintenance releases, some
+    users may want to give a ''release candidate'' a try. This is a
+    release that should be stable enough for daily work, but yet may
+    be potentially unstable. If no major bugs are found, the release
+    candiate is soon released as the first stable release in a a new
+    series. To summarize, there are three possible types of file names
+    that are of interest to normal users:
+
+       lyx-1.5.0.tar.gz     -- stable release, first in the 1.5-series
+       lyx-1.5.5.tar.gz     -- fifth maintenance release of LyX 1.5
+       lyx-1.5.0rc1.tar.gz  -- potentially unstable release candidate
+
+    Note that the goal is not parallel development as for the linux
+    kernel --the team is too small to afford that-- but rather to
+    include all the simple and safe bug fixes. This is so that the
+    maintenance burden on us is not too high, and so that system
+    administrators can install new releases without fear. Experience
+    shows that these releases will contain a few new features, and
+    that the bulk of the patches will be documentation updates.
 
     If you get the source from Subversion, the version string will
     look like one of:
@@ -75,10 +89,11 @@ How do I upgrade from an earlier LyX version?
 What do I need to compile LyX from the source distribution?
 
     * A good C++ compiler.  Development is being done mainly with
-      gcc/g++, but some others work also. As of LyX 1.5.0, you need at
+      gcc/g++, but some others work also. As of LyX 1.6.0, you need at
       least gcc 3.2.x.
 
-    * The Qt4 library, version 4.1.1 or newer.
+    * The Qt4 library, at least version 4.5.0. For all features
+      newer versions (e.g. Qt 4.8) are recommended.
 
     Read the file "INSTALL" for more information on compiling.
 
@@ -97,14 +112,11 @@ Okay, I've installed LyX. What now?
 Does LyX have support for non-English speakers/writers/readers?
 
     Yes. LyX supports writing in many languages, including
-    right-to-left languages like Arabic or Hebrew. There is a port
-    of LyX named CJK-LyX which adds support for Chinese, Korean
-    and Japanese (http://cellular.phys.pusan.ac.kr/cjk.html)
-    [This support is being merged in lyx-1.5]
+    right-to-left languages like Arabic or Hebrew.
 
-    Menus and error messages have been translated to 17 languages.
+    Menus and error messages have been translated to many languages.
     For the status of the different translations, see
-    http://www.lyx.org/devel/i18n.php
+    http://www.lyx.org/I18n
 
     Keymaps can ease typing in many languages.
 
@@ -113,20 +125,19 @@ Internet resources of relevance to LyX
     The LyX homepage contains valuable information about LyX and the
     various LyX mailing lists, as well as links to mirrors and other
     LyX homepages around the world:
-    http://www.lyx.org/
+       http://www.lyx.org/
 
     The LyX Wiki is the place where users can share information on
     setting up and using LyX.
-    http://wiki.lyx.org/
+       http://wiki.lyx.org/
 
     The main LyX archive site:
-    ftp://ftp.lyx.org/pub/lyx/
+       ftp://ftp.lyx.org/pub/lyx/
 
     The LyX Development page has information about the development
-    effort. LyX is under Subversion control, so you can get the very
+    effort. LyX is under Git version control, so you can get the very
     latest sources from there at any time.
-    http://www.lyx.org/devel
-    ftp://ftp.devel.lyx.org/pub/lyx/
+       http://www.lyx.org/Development
 
 How do I submit a bug report?
 
@@ -134,7 +145,8 @@ How do I submit a bug report?
     You'll find detailed info on submitting bug reports there.
 
     If you can't do that, send details to the LyX Developers' mailing
-    list, or use the LyX bug tracker at http://bugzilla.lyx.org/.
+    list, or use the LyX bug tracker at
+    http://www.lyx.org/trac/wiki/BugTrackerHome.
     Don't forget to mention which version you are having problems with!
 
 How can I participate in the development of LyX?