Anonymous avatar Anonymous committed 6453d8d

Merge changes from TracUpgrade@48 and some minimal updates to the INSTALL and UPGRADE files (well, basically redirecting to TracInstall and TracUpgrade...)

Comments (0)

Files changed (3)

 Trac is a lightweight project management tool that is implemented as a
 web-based application. Trac is written in the Python programming language and
 can use SQLite or PostgreSQL as  database. For HTML rendering, Trac uses the
-Clearsilver templating system.
+Genshi templating system.
+
+
+Note that you should also read the trac/wiki/default-pages/TracInstall 
+documentation file present in the source distribution.
 
 
 Requirements
  * Python, version >= 2.3.
    + Please keep in mind, that for RPM-based systems you will also need
    python-devel and python-xml packages.
- * Subversion, version >= 1.0. (>= 1.1.x recommended)
- * Subversion SWIG Python bindings (not PySVN).
- * PySQLite, version 1.x (for SQLite 2.x) or version 2.x (for SQLite 3.x)
- * Clearsilver, version >= 0.9.3 (0.9.14 recommended)
+ * Genshi, version >= 0.4.1 (0.5dev recommended)
+ * Optionally, Subversion, version >= 1.0. (>= 1.1.x recommended)and Subversion SWIG Python bindings (not PySVN).
+ * PySQLite, version 2.x for SQLite 3.x
  * A web server capable of executing CGI/FastCGI scripts, or Apache HTTPD with
-   mod_python. (Trac also comes with a standalone server, but its use is not
-   recommended for use in a production environment.)
+   mod_python. (Trac also comes with a standalone server)
 
 
 Installing Trac
 a new version of Trac. This document describes the steps necessary to upgrade
 an environment.
 
+Note that you should also read the trac/wiki/default-pages/TracUpgrade 
+documentation file present in the source distribution.
+
+
 Note that Environment upgrades are not necessary for minor version releases
 unless otherwise noted. For example, there's no need to upgrade a Trac
 environment created with (or upgraded) 0.8.0 when installing 0.8.4 (or any
 The following sections discuss any extra actions that may need to be taken
 to upgrade to specific versions of Trac.
 
+From 0.10.x to 0.11.x
+---------------------
+
+There should not be any serious problems...
+
+However, take a look at the following documented caveats::
+
+ http://trac.edgewall.org/wiki/TracDev/ReleaseNotes/0.11#Caveats
+
+Also, you should be careful to check that the plugins you depend on have
+been ported to 0.11, as they most probably won't work without adaptation
+due to the numerous internal changes that occurred during 0.11 development.
+Note however that Clearsilver based plugin are still supported.
+
+See: http://trac.edgewall.org/wiki/TracDev/ApiChanges/0.11
+
 
 From 0.9.x to 0.10.x
 --------------------

trac/wiki/default-pages/TracUpgrade

 = Upgrade Instructions =
 [[TracGuideToc]]
 
-A [wiki:TracEnvironment Trac environment] needs to be upgraded before it can be used with Trac-0.11. This document describes the steps necessary to upgrade an environment.
+A [TracEnvironment Trac environment] needs to be upgraded before it can be used with Trac 0.11. This document describes the steps necessary to upgrade an environment.
 
- '''Note''': ''Environment upgrades are not necessary for minor version releases unless otherwise noted. 
+Environment upgrades are not necessary for minor version releases unless otherwise noted. 
 
- '''Note''': ''A database change is required, so it is no longer safe to switch back from 0.11 to 0.10.
-
- '''Beware:''' milestone:0.11 still says it is safe to switch between 0.10.4 and 0.11dev
 
 == Instructions ==
 
 
 You may also want to remove the Trac `cgi-bin`, `htdocs`, `templates` and `wiki-default` directories that are commonly found in a directory called `share/trac` (the exact location depends on your platform).
 
-> If You had the webadmin components, You should disable (remove from config file) webadmin.* -  now Admin is part of the Trac code base.
-
+> If you had the webadmin plugin installed, you can now uninstall it as it is now part of the Trac code base.
 
 
 === Upgrade the Trac Environment ===
 
-After restarting, Trac should show the instances which need a manual upgrade via the automated upgrade scripts to ease the pain. These scripts are run via [wiki:TracAdmin trac-admin]:
+After restarting, Trac should show the instances which need a manual upgrade via the automated upgrade scripts to ease the pain. These scripts are run via [TracAdmin trac-admin]:
 {{{
 trac-admin /path/to/projenv upgrade
 }}}
 
 === Update the Trac Documentation ===
 
-Every [wiki:TracEnvironment Trac environment] includes a copy of the Trac documentation for the installed version. As you probably want to keep the included documentation in sync with the installed version of Trac, [wiki:TracAdmin trac-admin] provides a command to upgrade the documentation:
+Every [TracEnvironment Trac environment] includes a copy of the Trac documentation for the installed version. As you probably want to keep the included documentation in sync with the installed version of Trac, [TracAdmin trac-admin] provides a command to upgrade the documentation:
 {{{
 trac-admin /path/to/projenv wiki upgrade
 }}}
 Note that this procedure will of course leave your `WikiStart` page intact.
 
 === Trac Macros, Plugins ===
-The Trac macros will need to be adapted, as the old-style wiki-macros are not supported anymore (due to the drop of ClearSilver and the HDF); they need to be converted to the new-style macros.
+The Trac macros will need to be adapted, as the old-style wiki-macros are not supported anymore (due to the drop of ClearSilver and the HDF); they need to be converted to the new-style macros, see TracWikiMacros.
 
 
 === Restart the Web Server ===
 
 == Known Issues ==
 === parent dir ===
-If you use a trac parent env configuration and one of the plugines in one child does not work, none of the children work.
+If you use a trac parent env configuration and one of the plugins in one child does not work, none of the children work.
 
 == Changing Database Backend ==
 == SQLite to PostgreSQL ==
 
 == Older Versions ==
 
-For upgrades from former versions refer to TracUpgrade.
+For upgrades from former versions refer to wiki:0.10/TracUpgrade.
 
 -----
 See also: TracGuide, TracInstall
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.