From d0af24870eede648bf265d885126282c403e91fc Mon Sep 17 00:00:00 2001 From: Jean-Philippe Lang Date: Sun, 4 Nov 2007 13:19:42 +0000 Subject: [PATCH] Slight changes for 0.6.0 release. git-svn-id: http://redmine.rubyforge.org/svn/trunk@883 e93f8b46-1217-0410-a6f0-8f06a7374b81 --- doc/CHANGELOG | 540 ++++++++++++++++++-------------- doc/COPYING | 678 ++++++++++++++++++++--------------------- doc/INSTALL | 131 ++++---- doc/README | 77 ----- doc/UPGRADING | 69 +++-- lib/redmine/version.rb | 4 +- 6 files changed, 748 insertions(+), 751 deletions(-) delete mode 100644 doc/README diff --git a/doc/CHANGELOG b/doc/CHANGELOG index b18acebdd..1d7e0f6a0 100644 --- a/doc/CHANGELOG +++ b/doc/CHANGELOG @@ -1,231 +1,309 @@ -== redMine changelog - -redMine - project management software -Copyright (C) 2006-2007 Jean-Philippe Lang -http://redmine.rubyforge.org/ - - -== 2007-07-15 v0.5.1 - -* per project forums added -* added the ability to archive projects -* added “Watch” functionality on issues. It allows users to receive notifications about issue changes -* custom fields for issues can now be used as filters on issue list -* added per user custom queries -* commit messages are now scanned for referenced or fixed issue IDs (keywords defined in Admin -> Settings) -* projects list now shows the list of public projects and private projects for which the user is a member -* versions can now be created with no date -* added issue count details for versions on Reports view -* added time report, by member/activity/tracker/version and year/month/week for the selected period -* each category can now be associated to a user, so that new issues in that category are automatically assigned to that user -* added autologin feature (disabled by default) -* optimistic locking added for wiki edits -* added wiki diff -* added the ability to destroy wiki pages (requires permission) -* a wiki page can now be attached to each version, and displayed on the roadmap -* attachments can now be added to wiki pages (original patch by Pavol Murin) and displayed online -* added an option to see all versions in the roadmap view (including completed ones) -* added basic issue relations -* added the ability to log time when changing an issue status -* account information can now be sent to the user when creating an account -* author and assignee of an issue always receive notifications (even if they turned of mail notifications) -* added a quick search form in page header -* added 'me' value for 'assigned to' and 'author' query filters -* added a link on revision screen to see the entire diff for the revision -* added last commit message for each entry in repository browser -* added the ability to view a file diff with free to/from revision selection. -* text files can now be viewed online when browsing the repository -* added basic support for other SCM: CVS (Ralph Vater), Mercurial and Darcs -* added fragment caching for svn diffs -* added fragment caching for calendar and gantt views -* login field automatically focused on login form -* subproject name displayed on issue list, calendar and gantt -* added an option to choose the date format: language based or ISO 8601 -* added a simple mail handler. It lets users add notes to an existing issue by replying to the initial notification email. -* a 403 error page is now displayed (instead of a blank page) when trying to access a protected page -* added portuguese translation (Joao Carlos Clementoni) -* added partial online help japanese translation (Ken Date) -* added bulgarian translation (Nikolay Solakov) -* added dutch translation (Linda van den Brink) -* added swedish translation (Thomas Habets) -* italian translation update (Alessio Spadaro) -* japanese translation update (Satoru Kurashiki) -* fixed: error on history atom feed when there’s no notes on an issue change -* fixed: error in journalizing an issue with longtext custom fields (Postgresql) -* fixed: creation of Oracle schema -* fixed: last day of the month not included in project activity -* fixed: files with an apostrophe in their names can't be accessed in SVN repository -* fixed: performance issue on RepositoriesController#revisions when a changeset has a great number of changes (eg. 100,000) -* fixed: open/closed issue counts are always 0 on reports view (postgresql) -* fixed: date query filters (wrong results and sql error with postgresql) -* fixed: confidentiality issue on account/show (private project names displayed to anyone) -* fixed: Long text custom fields displayed without line breaks -* fixed: Error when editing the wokflow after deleting a status -* fixed: SVN commit dates are now stored as local time - - -== 2007-04-11 v0.5.0 - -* added per project Wiki -* added rss/atom feeds at project level (custom queries can be used as feeds) -* added search engine (search in issues, news, commits, wiki pages, documents) -* simple time tracking functionality added -* added version due dates on calendar and gantt -* added subprojects issue count on project Reports page -* added the ability to copy an existing workflow when creating a new tracker -* added the ability to include subprojects on calendar and gantt -* added the ability to select trackers to display on calendar and gantt (Jeffrey Jones) -* added side by side svn diff view (Cyril Mougel) -* added back subproject filter on issue list -* added permissions report in admin area -* added a status filter on users list -* support for password-protected SVN repositories -* SVN commits are now stored in the database -* added simple svn statistics SVG graphs -* progress bars for roadmap versions (Nick Read) -* issue history now shows file uploads and deletions -* #id patterns are turned into links to issues in descriptions and commit messages -* japanese translation added (Satoru Kurashiki) -* chinese simplified translation added (Andy Wu) -* italian translation added (Alessio Spadaro) -* added scripts to manage SVN repositories creation and user access control using ssh+svn (Nicolas Chuche) -* better calendar rendering time -* fixed migration scripts to work with mysql 5 running in strict mode -* fixed: error when clicking "add" with no block selected on my/page_layout -* fixed: hard coded links in navigation bar -* fixed: table_name pre/suffix support - - -== 2007-02-18 v0.4.2 - -* Rails 1.2 is now required -* settings are now stored in the database and editable through the application in: Admin -> Settings (config_custom.rb is no longer used) -* added project roadmap view -* mail notifications added when a document, a file or an attachment is added -* tooltips added on Gantt chart and calender to view the details of the issues -* ability to set the sort order for roles, trackers, issue statuses -* added missing fields to csv export: priority, start date, due date, done ratio -* added total number of issues per tracker on project overview -* all icons replaced (new icons are based on GPL icon set: "KDE Crystal Diamond 2.5" -by paolino- and "kNeu! Alpha v0.1" -by Pablo Fabregat-) -* added back "fixed version" field on issue screen and in filters -* project settings screen split in 4 tabs -* custom fields screen split in 3 tabs (one for each kind of custom field) -* multiple issues pdf export now rendered as a table -* added a button on users/list to manually activate an account -* added a setting option to disable "password lost" functionality -* added a setting option to set max number of issues in csv/pdf exports -* fixed: subprojects count is always 0 on projects list -* fixed: locked users are proposed when adding a member to a project -* fixed: setting an issue status as default status leads to an sql error with SQLite -* fixed: unable to delete an issue status even if it's not used yet -* fixed: filters ignored when exporting a predefined query to csv/pdf -* fixed: crash when french "issue_edit" email notification is sent -* fixed: hide mail preference not saved (my/account) -* fixed: crash when a new user try to edit its "my page" layout - - -== 2007-01-03 v0.4.1 - -* fixed: emails have no recipient when one of the project members has notifications disabled - - -== 2007-01-02 v0.4.0 - -* simple SVN browser added (just needs svn binaries in PATH) -* comments can now be added on news -* "my page" is now customizable -* more powerfull and savable filters for issues lists -* improved issues change history -* new functionality: move an issue to another project or tracker -* new functionality: add a note to an issue -* new report: project activity -* "start date" and "% done" fields added on issues -* project calendar added -* gantt chart added (exportable to pdf) -* single/multiple issues pdf export added -* issues reports improvements -* multiple file upload for issues, documents and files -* option to set maximum size of uploaded files -* textile formating of issue and news descritions (RedCloth required) -* integration of DotClear jstoolbar for textile formatting -* calendar date picker for date fields (LGPL DHTML Calendar http://sourceforge.net/projects/jscalendar) -* new filter in issues list: Author -* ajaxified paginators -* news rss feed added -* option to set number of results per page on issues list -* localized csv separator (comma/semicolon) -* csv output encoded to ISO-8859-1 -* user custom field displayed on account/show -* default configuration improved (default roles, trackers, status, permissions and workflows) -* language for default configuration data can now be chosen when running 'load_default_data' task -* javascript added on custom field form to show/hide fields according to the format of custom field -* fixed: custom fields not in csv exports -* fixed: project settings now displayed according to user's permissions -* fixed: application error when no version is selected on projects/add_file -* fixed: public actions not authorized for members of non public projects -* fixed: non public projects were shown on welcome screen even if current user is not a member - - -== 2006-10-08 v0.3.0 - -* user authentication against multiple LDAP (optional) -* token based "lost password" functionality -* user self-registration functionality (optional) -* custom fields now available for issues, users and projects -* new custom field format "text" (displayed as a textarea field) -* project & administration drop down menus in navigation bar for quicker access -* text formatting is preserved for long text fields (issues, projects and news descriptions) -* urls and emails are turned into clickable links in long text fields -* "due date" field added on issues -* tracker selection filter added on change log -* Localization plugin replaced with GLoc 1.1.0 (iconv required) -* error messages internationalization -* german translation added (thanks to Karim Trott) -* data locking for issues to prevent update conflicts (using ActiveRecord builtin optimistic locking) -* new filter in issues list: "Fixed version" -* active filters are displayed with colored background on issues list -* custom configuration is now defined in config/config_custom.rb -* user object no more stored in session (only user_id) -* news summary field is no longer required -* tables and forms redesign -* Fixed: boolean custom field not working -* Fixed: error messages for custom fields are not displayed -* Fixed: invalid custom fields should have a red border -* Fixed: custom fields values are not validated on issue update -* Fixed: unable to choose an empty value for 'List' custom fields -* Fixed: no issue categories sorting -* Fixed: incorrect versions sorting - - -== 2006-07-12 - v0.2.2 - -* Fixed: bug in "issues list" - - -== 2006-07-09 - v0.2.1 - -* new databases supported: Oracle, PostgreSQL, SQL Server -* projects/subprojects hierarchy (1 level of subprojects only) -* environment information display in admin/info -* more filter options in issues list (rev6) -* default language based on browser settings (Accept-Language HTTP header) -* issues list exportable to CSV (rev6) -* simple_format and auto_link on long text fields -* more data validations -* Fixed: error when all mail notifications are unchecked in admin/mail_options -* Fixed: all project news are displayed on project summary -* Fixed: Can't change user password in users/edit -* Fixed: Error on tables creation with PostgreSQL (rev5) -* Fixed: SQL error in "issue reports" view with PostgreSQL (rev5) - - -== 2006-06-25 - v0.1.0 - -* multiple users/multiple projects -* role based access control -* issue tracking system -* fully customizable workflow -* documents/files repository -* email notifications on issue creation and update -* multilanguage support (except for error messages):english, french, spanish -* online manual in french (unfinished) +== Redmine changelog + +Redmine - project management software +Copyright (C) 2006-2007 Jean-Philippe Lang +http://www.redmine.org/ + + +== 2007-11-04 v0.6.0 + +* Permission model refactoring. +* Permissions: there are now 2 builtin roles that can be used to specify permissions given to other users than members of projects +* Permissions: some permissions (eg. browse the repository) can be removed for certain roles +* Permissions: modules (eg. issue tracking, news, documents...) can be enabled/disabled at project level +* Added Mantis and Trac importers +* New application layout +* Added "Bulk edit" functionality on the issue list +* More flexible mail notifications settings at user level +* Added AJAX based context menu on the project issue list that provide shortcuts for editing, re-assigning, changing the status or the priority, moving or deleting an issue +* Added the hability to copy an issue. It can be done from the "issue/show" view or from the context menu on the issue list +* Added the ability to customize issue list columns (at application level or for each saved query) +* Overdue versions (date reached and open issues > 0) are now always displayed on the roadmap +* Added the ability to rename wiki pages (specific permission required) +* Search engines now supports pagination. Results are sorted in reverse chronological order +* Added "Estimated hours" attribute on issues +* A category with assigned issue can now be deleted. 2 options are proposed: remove assignments or reassign issues to another category +* Forum notifications are now also sent to the authors of the thread, even if they don’t watch the board +* Added an application setting to specify the application protocol (http or https) used to generate urls in emails +* Gantt chart: now starts at the current month by default +* Gantt chart: month count and zoom factor are automatically saved as user preferences +* Wiki links can now refer to other project wikis +* Added wiki index by date +* Added preview on add/edit issue form +* Emails footer can now be customized from the admin interface (Admin -> Email notifications) +* Default encodings for repository files can now be set in application settings (used to convert files content and diff to UTF-8 so that they’re properly displayed) +* Calendar: first day of week can now be set in lang files +* Automatic closing of duplicate issues +* Added a cross-project issue list +* AJAXified the SCM browser (tree view) +* Pretty URL for the repository browser (Cyril Mougel) +* Search engine: added a checkbox to search titles only +* Added "% done" in the filter list +* Enumerations: values can now be reordered and a default value can be specified (eg. default issue priority) +* Added some accesskeys +* Added "Float" as a custom field format +* Added basic Theme support +* Added the ability to set the “done ratio” of issues fixed by commit (Nikolay Solakov) +* Added custom fields in issue related mail notifications +* Email notifications are now sent in plain text and html +* Gantt chart can now be exported to a graphic file (png). This functionality is only available if RMagick is installed. +* Added syntax highlightment for repository files and wiki +* Improved automatic Redmine links +* Added automatic table of content support on wiki pages +* Added radio buttons on the documents list to sort documents by category, date, title or author +* Added basic plugin support, with a sample plugin +* Added a link to add a new category when creating or editing an issue +* Added a "Assignable" boolean on the Role model. If unchecked, issues can not be assigned to users having this role. +* Added an option to be able to relate issues in different projects +* Added the ability to move issues (to another project) without changing their trackers. +* Atom feeds added on project activity, news and changesets +* Added the ability to reset its own RSS access key +* Main project list now displays root projects with their subprojects +* Added anchor links to issue notes +* Added reposman Ruby version. This script can now register created repositories in Redmine (Nicolas Chuche) +* Issue notes are now included in search +* Added email sending test functionality +* Added LDAPS support for LDAP authentication +* Removed hard-coded URLs in mail templates +* Subprojects are now grouped by projects in the navigation drop-down menu +* Added a new value for date filters: this week +* Added cache for application settings +* Added Polish translation (Tomasz Gawryl) +* Added Czech translation (Jan Kadlecek) +* Added Romanian translation (Csongor Bartus) +* Added Hebrew translation (Bob Builder) +* Added Serbian translation (Dragan Matic) +* Added Korean translation (Choi Jong Yoon) +* Fixed: the link to delete issue relations is displayed even if the user is not authorized to delete relations +* Performance improvement on calendar and gantt +* Fixed: wiki preview doesn’t work on long entries +* Fixed: queries with multiple custom fields return no result +* Fixed: Can not authenticate user against LDAP if its DN contains non-ascii characters +* Fixed: URL with ~ broken in wiki formatting +* Fixed: some quotation marks are rendered as strange characters in pdf + + +== 2007-07-15 v0.5.1 + +* per project forums added +* added the ability to archive projects +* added “Watch” functionality on issues. It allows users to receive notifications about issue changes +* custom fields for issues can now be used as filters on issue list +* added per user custom queries +* commit messages are now scanned for referenced or fixed issue IDs (keywords defined in Admin -> Settings) +* projects list now shows the list of public projects and private projects for which the user is a member +* versions can now be created with no date +* added issue count details for versions on Reports view +* added time report, by member/activity/tracker/version and year/month/week for the selected period +* each category can now be associated to a user, so that new issues in that category are automatically assigned to that user +* added autologin feature (disabled by default) +* optimistic locking added for wiki edits +* added wiki diff +* added the ability to destroy wiki pages (requires permission) +* a wiki page can now be attached to each version, and displayed on the roadmap +* attachments can now be added to wiki pages (original patch by Pavol Murin) and displayed online +* added an option to see all versions in the roadmap view (including completed ones) +* added basic issue relations +* added the ability to log time when changing an issue status +* account information can now be sent to the user when creating an account +* author and assignee of an issue always receive notifications (even if they turned of mail notifications) +* added a quick search form in page header +* added 'me' value for 'assigned to' and 'author' query filters +* added a link on revision screen to see the entire diff for the revision +* added last commit message for each entry in repository browser +* added the ability to view a file diff with free to/from revision selection. +* text files can now be viewed online when browsing the repository +* added basic support for other SCM: CVS (Ralph Vater), Mercurial and Darcs +* added fragment caching for svn diffs +* added fragment caching for calendar and gantt views +* login field automatically focused on login form +* subproject name displayed on issue list, calendar and gantt +* added an option to choose the date format: language based or ISO 8601 +* added a simple mail handler. It lets users add notes to an existing issue by replying to the initial notification email. +* a 403 error page is now displayed (instead of a blank page) when trying to access a protected page +* added portuguese translation (Joao Carlos Clementoni) +* added partial online help japanese translation (Ken Date) +* added bulgarian translation (Nikolay Solakov) +* added dutch translation (Linda van den Brink) +* added swedish translation (Thomas Habets) +* italian translation update (Alessio Spadaro) +* japanese translation update (Satoru Kurashiki) +* fixed: error on history atom feed when there’s no notes on an issue change +* fixed: error in journalizing an issue with longtext custom fields (Postgresql) +* fixed: creation of Oracle schema +* fixed: last day of the month not included in project activity +* fixed: files with an apostrophe in their names can't be accessed in SVN repository +* fixed: performance issue on RepositoriesController#revisions when a changeset has a great number of changes (eg. 100,000) +* fixed: open/closed issue counts are always 0 on reports view (postgresql) +* fixed: date query filters (wrong results and sql error with postgresql) +* fixed: confidentiality issue on account/show (private project names displayed to anyone) +* fixed: Long text custom fields displayed without line breaks +* fixed: Error when editing the wokflow after deleting a status +* fixed: SVN commit dates are now stored as local time + + +== 2007-04-11 v0.5.0 + +* added per project Wiki +* added rss/atom feeds at project level (custom queries can be used as feeds) +* added search engine (search in issues, news, commits, wiki pages, documents) +* simple time tracking functionality added +* added version due dates on calendar and gantt +* added subprojects issue count on project Reports page +* added the ability to copy an existing workflow when creating a new tracker +* added the ability to include subprojects on calendar and gantt +* added the ability to select trackers to display on calendar and gantt (Jeffrey Jones) +* added side by side svn diff view (Cyril Mougel) +* added back subproject filter on issue list +* added permissions report in admin area +* added a status filter on users list +* support for password-protected SVN repositories +* SVN commits are now stored in the database +* added simple svn statistics SVG graphs +* progress bars for roadmap versions (Nick Read) +* issue history now shows file uploads and deletions +* #id patterns are turned into links to issues in descriptions and commit messages +* japanese translation added (Satoru Kurashiki) +* chinese simplified translation added (Andy Wu) +* italian translation added (Alessio Spadaro) +* added scripts to manage SVN repositories creation and user access control using ssh+svn (Nicolas Chuche) +* better calendar rendering time +* fixed migration scripts to work with mysql 5 running in strict mode +* fixed: error when clicking "add" with no block selected on my/page_layout +* fixed: hard coded links in navigation bar +* fixed: table_name pre/suffix support + + +== 2007-02-18 v0.4.2 + +* Rails 1.2 is now required +* settings are now stored in the database and editable through the application in: Admin -> Settings (config_custom.rb is no longer used) +* added project roadmap view +* mail notifications added when a document, a file or an attachment is added +* tooltips added on Gantt chart and calender to view the details of the issues +* ability to set the sort order for roles, trackers, issue statuses +* added missing fields to csv export: priority, start date, due date, done ratio +* added total number of issues per tracker on project overview +* all icons replaced (new icons are based on GPL icon set: "KDE Crystal Diamond 2.5" -by paolino- and "kNeu! Alpha v0.1" -by Pablo Fabregat-) +* added back "fixed version" field on issue screen and in filters +* project settings screen split in 4 tabs +* custom fields screen split in 3 tabs (one for each kind of custom field) +* multiple issues pdf export now rendered as a table +* added a button on users/list to manually activate an account +* added a setting option to disable "password lost" functionality +* added a setting option to set max number of issues in csv/pdf exports +* fixed: subprojects count is always 0 on projects list +* fixed: locked users are proposed when adding a member to a project +* fixed: setting an issue status as default status leads to an sql error with SQLite +* fixed: unable to delete an issue status even if it's not used yet +* fixed: filters ignored when exporting a predefined query to csv/pdf +* fixed: crash when french "issue_edit" email notification is sent +* fixed: hide mail preference not saved (my/account) +* fixed: crash when a new user try to edit its "my page" layout + + +== 2007-01-03 v0.4.1 + +* fixed: emails have no recipient when one of the project members has notifications disabled + + +== 2007-01-02 v0.4.0 + +* simple SVN browser added (just needs svn binaries in PATH) +* comments can now be added on news +* "my page" is now customizable +* more powerfull and savable filters for issues lists +* improved issues change history +* new functionality: move an issue to another project or tracker +* new functionality: add a note to an issue +* new report: project activity +* "start date" and "% done" fields added on issues +* project calendar added +* gantt chart added (exportable to pdf) +* single/multiple issues pdf export added +* issues reports improvements +* multiple file upload for issues, documents and files +* option to set maximum size of uploaded files +* textile formating of issue and news descritions (RedCloth required) +* integration of DotClear jstoolbar for textile formatting +* calendar date picker for date fields (LGPL DHTML Calendar http://sourceforge.net/projects/jscalendar) +* new filter in issues list: Author +* ajaxified paginators +* news rss feed added +* option to set number of results per page on issues list +* localized csv separator (comma/semicolon) +* csv output encoded to ISO-8859-1 +* user custom field displayed on account/show +* default configuration improved (default roles, trackers, status, permissions and workflows) +* language for default configuration data can now be chosen when running 'load_default_data' task +* javascript added on custom field form to show/hide fields according to the format of custom field +* fixed: custom fields not in csv exports +* fixed: project settings now displayed according to user's permissions +* fixed: application error when no version is selected on projects/add_file +* fixed: public actions not authorized for members of non public projects +* fixed: non public projects were shown on welcome screen even if current user is not a member + + +== 2006-10-08 v0.3.0 + +* user authentication against multiple LDAP (optional) +* token based "lost password" functionality +* user self-registration functionality (optional) +* custom fields now available for issues, users and projects +* new custom field format "text" (displayed as a textarea field) +* project & administration drop down menus in navigation bar for quicker access +* text formatting is preserved for long text fields (issues, projects and news descriptions) +* urls and emails are turned into clickable links in long text fields +* "due date" field added on issues +* tracker selection filter added on change log +* Localization plugin replaced with GLoc 1.1.0 (iconv required) +* error messages internationalization +* german translation added (thanks to Karim Trott) +* data locking for issues to prevent update conflicts (using ActiveRecord builtin optimistic locking) +* new filter in issues list: "Fixed version" +* active filters are displayed with colored background on issues list +* custom configuration is now defined in config/config_custom.rb +* user object no more stored in session (only user_id) +* news summary field is no longer required +* tables and forms redesign +* Fixed: boolean custom field not working +* Fixed: error messages for custom fields are not displayed +* Fixed: invalid custom fields should have a red border +* Fixed: custom fields values are not validated on issue update +* Fixed: unable to choose an empty value for 'List' custom fields +* Fixed: no issue categories sorting +* Fixed: incorrect versions sorting + + +== 2006-07-12 - v0.2.2 + +* Fixed: bug in "issues list" + + +== 2006-07-09 - v0.2.1 + +* new databases supported: Oracle, PostgreSQL, SQL Server +* projects/subprojects hierarchy (1 level of subprojects only) +* environment information display in admin/info +* more filter options in issues list (rev6) +* default language based on browser settings (Accept-Language HTTP header) +* issues list exportable to CSV (rev6) +* simple_format and auto_link on long text fields +* more data validations +* Fixed: error when all mail notifications are unchecked in admin/mail_options +* Fixed: all project news are displayed on project summary +* Fixed: Can't change user password in users/edit +* Fixed: Error on tables creation with PostgreSQL (rev5) +* Fixed: SQL error in "issue reports" view with PostgreSQL (rev5) + + +== 2006-06-25 - v0.1.0 + +* multiple users/multiple projects +* role based access control +* issue tracking system +* fully customizable workflow +* documents/files repository +* email notifications on issue creation and update +* multilanguage support (except for error messages):english, french, spanish +* online manual in french (unfinished) diff --git a/doc/COPYING b/doc/COPYING index 82fa1daad..d511905c1 100644 --- a/doc/COPYING +++ b/doc/COPYING @@ -1,339 +1,339 @@ - GNU GENERAL PUBLIC LICENSE - Version 2, June 1991 - - Copyright (C) 1989, 1991 Free Software Foundation, Inc., - 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. - - Preamble - - The licenses for most software are designed to take away your -freedom to share and change it. By contrast, the GNU General Public -License is intended to guarantee your freedom to share and change free -software--to make sure the software is free for all its users. This -General Public License applies to most of the Free Software -Foundation's software and to any other program whose authors commit to -using it. (Some other Free Software Foundation software is covered by -the GNU Lesser General Public License instead.) You can apply it to -your programs, too. - - When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you -have the freedom to distribute copies of free software (and charge for -this service if you wish), that you receive source code or can get it -if you want it, that you can change the software or use pieces of it -in new free programs; and that you know you can do these things. - - To protect your rights, we need to make restrictions that forbid -anyone to deny you these rights or to ask you to surrender the rights. -These restrictions translate to certain responsibilities for you if you -distribute copies of the software, or if you modify it. - - For example, if you distribute copies of such a program, whether -gratis or for a fee, you must give the recipients all the rights that -you have. You must make sure that they, too, receive or can get the -source code. And you must show them these terms so they know their -rights. - - We protect your rights with two steps: (1) copyright the software, and -(2) offer you this license which gives you legal permission to copy, -distribute and/or modify the software. - - Also, for each author's protection and ours, we want to make certain -that everyone understands that there is no warranty for this free -software. If the software is modified by someone else and passed on, we -want its recipients to know that what they have is not the original, so -that any problems introduced by others will not reflect on the original -authors' reputations. - - Finally, any free program is threatened constantly by software -patents. We wish to avoid the danger that redistributors of a free -program will individually obtain patent licenses, in effect making the -program proprietary. To prevent this, we have made it clear that any -patent must be licensed for everyone's free use or not licensed at all. - - The precise terms and conditions for copying, distribution and -modification follow. - - GNU GENERAL PUBLIC LICENSE - TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION - - 0. This License applies to any program or other work which contains -a notice placed by the copyright holder saying it may be distributed -under the terms of this General Public License. The "Program", below, -refers to any such program or work, and a "work based on the Program" -means either the Program or any derivative work under copyright law: -that is to say, a work containing the Program or a portion of it, -either verbatim or with modifications and/or translated into another -language. (Hereinafter, translation is included without limitation in -the term "modification".) Each licensee is addressed as "you". - -Activities other than copying, distribution and modification are not -covered by this License; they are outside its scope. The act of -running the Program is not restricted, and the output from the Program -is covered only if its contents constitute a work based on the -Program (independent of having been made by running the Program). -Whether that is true depends on what the Program does. - - 1. You may copy and distribute verbatim copies of the Program's -source code as you receive it, in any medium, provided that you -conspicuously and appropriately publish on each copy an appropriate -copyright notice and disclaimer of warranty; keep intact all the -notices that refer to this License and to the absence of any warranty; -and give any other recipients of the Program a copy of this License -along with the Program. - -You may charge a fee for the physical act of transferring a copy, and -you may at your option offer warranty protection in exchange for a fee. - - 2. You may modify your copy or copies of the Program or any portion -of it, thus forming a work based on the Program, and copy and -distribute such modifications or work under the terms of Section 1 -above, provided that you also meet all of these conditions: - - a) You must cause the modified files to carry prominent notices - stating that you changed the files and the date of any change. - - b) You must cause any work that you distribute or publish, that in - whole or in part contains or is derived from the Program or any - part thereof, to be licensed as a whole at no charge to all third - parties under the terms of this License. - - c) If the modified program normally reads commands interactively - when run, you must cause it, when started running for such - interactive use in the most ordinary way, to print or display an - announcement including an appropriate copyright notice and a - notice that there is no warranty (or else, saying that you provide - a warranty) and that users may redistribute the program under - these conditions, and telling the user how to view a copy of this - License. (Exception: if the Program itself is interactive but - does not normally print such an announcement, your work based on - the Program is not required to print an announcement.) - -These requirements apply to the modified work as a whole. If -identifiable sections of that work are not derived from the Program, -and can be reasonably considered independent and separate works in -themselves, then this License, and its terms, do not apply to those -sections when you distribute them as separate works. But when you -distribute the same sections as part of a whole which is a work based -on the Program, the distribution of the whole must be on the terms of -this License, whose permissions for other licensees extend to the -entire whole, and thus to each and every part regardless of who wrote it. - -Thus, it is not the intent of this section to claim rights or contest -your rights to work written entirely by you; rather, the intent is to -exercise the right to control the distribution of derivative or -collective works based on the Program. - -In addition, mere aggregation of another work not based on the Program -with the Program (or with a work based on the Program) on a volume of -a storage or distribution medium does not bring the other work under -the scope of this License. - - 3. You may copy and distribute the Program (or a work based on it, -under Section 2) in object code or executable form under the terms of -Sections 1 and 2 above provided that you also do one of the following: - - a) Accompany it with the complete corresponding machine-readable - source code, which must be distributed under the terms of Sections - 1 and 2 above on a medium customarily used for software interchange; or, - - b) Accompany it with a written offer, valid for at least three - years, to give any third party, for a charge no more than your - cost of physically performing source distribution, a complete - machine-readable copy of the corresponding source code, to be - distributed under the terms of Sections 1 and 2 above on a medium - customarily used for software interchange; or, - - c) Accompany it with the information you received as to the offer - to distribute corresponding source code. (This alternative is - allowed only for noncommercial distribution and only if you - received the program in object code or executable form with such - an offer, in accord with Subsection b above.) - -The source code for a work means the preferred form of the work for -making modifications to it. For an executable work, complete source -code means all the source code for all modules it contains, plus any -associated interface definition files, plus the scripts used to -control compilation and installation of the executable. However, as a -special exception, the source code distributed need not include -anything that is normally distributed (in either source or binary -form) with the major components (compiler, kernel, and so on) of the -operating system on which the executable runs, unless that component -itself accompanies the executable. - -If distribution of executable or object code is made by offering -access to copy from a designated place, then offering equivalent -access to copy the source code from the same place counts as -distribution of the source code, even though third parties are not -compelled to copy the source along with the object code. - - 4. You may not copy, modify, sublicense, or distribute the Program -except as expressly provided under this License. Any attempt -otherwise to copy, modify, sublicense or distribute the Program is -void, and will automatically terminate your rights under this License. -However, parties who have received copies, or rights, from you under -this License will not have their licenses terminated so long as such -parties remain in full compliance. - - 5. You are not required to accept this License, since you have not -signed it. However, nothing else grants you permission to modify or -distribute the Program or its derivative works. These actions are -prohibited by law if you do not accept this License. Therefore, by -modifying or distributing the Program (or any work based on the -Program), you indicate your acceptance of this License to do so, and -all its terms and conditions for copying, distributing or modifying -the Program or works based on it. - - 6. Each time you redistribute the Program (or any work based on the -Program), the recipient automatically receives a license from the -original licensor to copy, distribute or modify the Program subject to -these terms and conditions. You may not impose any further -restrictions on the recipients' exercise of the rights granted herein. -You are not responsible for enforcing compliance by third parties to -this License. - - 7. If, as a consequence of a court judgment or allegation of patent -infringement or for any other reason (not limited to patent issues), -conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot -distribute so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you -may not distribute the Program at all. For example, if a patent -license would not permit royalty-free redistribution of the Program by -all those who receive copies directly or indirectly through you, then -the only way you could satisfy both it and this License would be to -refrain entirely from distribution of the Program. - -If any portion of this section is held invalid or unenforceable under -any particular circumstance, the balance of the section is intended to -apply and the section as a whole is intended to apply in other -circumstances. - -It is not the purpose of this section to induce you to infringe any -patents or other property right claims or to contest validity of any -such claims; this section has the sole purpose of protecting the -integrity of the free software distribution system, which is -implemented by public license practices. Many people have made -generous contributions to the wide range of software distributed -through that system in reliance on consistent application of that -system; it is up to the author/donor to decide if he or she is willing -to distribute software through any other system and a licensee cannot -impose that choice. - -This section is intended to make thoroughly clear what is believed to -be a consequence of the rest of this License. - - 8. If the distribution and/or use of the Program is restricted in -certain countries either by patents or by copyrighted interfaces, the -original copyright holder who places the Program under this License -may add an explicit geographical distribution limitation excluding -those countries, so that distribution is permitted only in or among -countries not thus excluded. In such case, this License incorporates -the limitation as if written in the body of this License. - - 9. The Free Software Foundation may publish revised and/or new versions -of the General Public License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. - -Each version is given a distinguishing version number. If the Program -specifies a version number of this License which applies to it and "any -later version", you have the option of following the terms and conditions -either of that version or of any later version published by the Free -Software Foundation. If the Program does not specify a version number of -this License, you may choose any version ever published by the Free Software -Foundation. - - 10. If you wish to incorporate parts of the Program into other free -programs whose distribution conditions are different, write to the author -to ask for permission. For software which is copyrighted by the Free -Software Foundation, write to the Free Software Foundation; we sometimes -make exceptions for this. Our decision will be guided by the two goals -of preserving the free status of all derivatives of our free software and -of promoting the sharing and reuse of software generally. - - NO WARRANTY - - 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY -FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN -OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES -PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED -OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF -MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS -TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE -PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, -REPAIR OR CORRECTION. - - 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR -REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, -INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING -OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED -TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY -YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER -PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE -POSSIBILITY OF SUCH DAMAGES. - - END OF TERMS AND CONDITIONS - - How to Apply These Terms to Your New Programs - - If you develop a new program, and you want it to be of the greatest -possible use to the public, the best way to achieve this is to make it -free software which everyone can redistribute and change under these terms. - - To do so, attach the following notices to the program. It is safest -to attach them to the start of each source file to most effectively -convey the exclusion of warranty; and each file should have at least -the "copyright" line and a pointer to where the full notice is found. - - - Copyright (C) - - This program is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or - (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License along - with this program; if not, write to the Free Software Foundation, Inc., - 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. - -Also add information on how to contact you by electronic and paper mail. - -If the program is interactive, make it output a short notice like this -when it starts in an interactive mode: - - Gnomovision version 69, Copyright (C) year name of author - Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. - This is free software, and you are welcome to redistribute it - under certain conditions; type `show c' for details. - -The hypothetical commands `show w' and `show c' should show the appropriate -parts of the General Public License. Of course, the commands you use may -be called something other than `show w' and `show c'; they could even be -mouse-clicks or menu items--whatever suits your program. - -You should also get your employer (if you work as a programmer) or your -school, if any, to sign a "copyright disclaimer" for the program, if -necessary. Here is a sample; alter the names: - - Yoyodyne, Inc., hereby disclaims all copyright interest in the program - `Gnomovision' (which makes passes at compilers) written by James Hacker. - - , 1 April 1989 - Ty Coon, President of Vice - -This General Public License does not permit incorporating your program into -proprietary programs. If your program is a subroutine library, you may -consider it more useful to permit linking proprietary applications with the -library. If this is what you want to do, use the GNU Lesser General -Public License instead of this License. + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Lesser General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License along + with this program; if not, write to the Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. diff --git a/doc/INSTALL b/doc/INSTALL index 8532d7a14..4da5daef9 100644 --- a/doc/INSTALL +++ b/doc/INSTALL @@ -1,69 +1,62 @@ -== redMine installation - -redMine - project management software -Copyright (C) 2006-2007 Jean-Philippe Lang -http://redmine.rubyforge.org/ - - -== Requirements - -* Ruby on Rails 1.2.2 -* A database (see compatibility below) - -Optional: -* SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH) -* RMagick (gantt export to png) - -Supported databases: -* MySQL (tested with MySQL 5) -* PostgreSQL (tested with PostgreSQL 8.1) -* SQLite (tested with SQLite 3) - - -== Installation - -1. Uncompress program archive: - tar zxvf - -2. Create an empty database: "redmine" for example - -3. Configure database parameters in config/database.yml - for "production" environment (default database is MySQL) - -4. Create the database structure. Under the application main directory: - rake db:migrate RAILS_ENV="production" - It will create tables and an administrator account. - -5. Insert default configuration data in database: - rake redmine:load_default_data RAILS_ENV="production" - It will load default roles, trackers, statuses, workflows and enumerations. - This step is optional (but recommended), as you can define your - own configuration from sratch. - -6. Test the installation by running WEBrick web server: - ruby script/server -e production - - Once WEBrick has started, point your browser to http://localhost:3000/ - You should now see the application welcome page - -7. Use default administrator account to log in: - login: admin - password: admin - -8. You can go to "Admin -> Settings" to modify application settings. - -9. Setup Apache or Lighttpd with fastcgi for best performance. - - -== SMTP server Configuration - -In config/environment.rb, you can set parameters for your SMTP server: -config.action_mailer.smtp_settings: SMTP server configuration -config.action_mailer.perform_deliveries: set to false to disable mail delivering - -Don't forget to restart the application after any change. - - -== Upgrading - -See UPGRADING +== Redmine installation + +Redmine - project management software +Copyright (C) 2006-2007 Jean-Philippe Lang +http://www.redmine.org/ + + +== Requirements + +* Ruby on Rails 1.2.2 or higher (this release won't work with Rails 2.0) +* A database (see compatibility below) + +Optional: +* SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH) +* RMagick (gantt export to png) + +Supported databases: +* MySQL (tested with MySQL 5) +* PostgreSQL (tested with PostgreSQL 8.1) +* SQLite (tested with SQLite 3) + + +== Installation + +1. Uncompress the program archive + +2. Create an empty database: "redmine" for example + +3. Configure database parameters in config/database.yml + for "production" environment (default database is MySQL) + +4. Create the database structure. Under the application main directory: + rake db:migrate RAILS_ENV="production" + It will create tables and an administrator account. + +5. Insert default configuration data in the database: + rake redmine:load_default_data RAILS_ENV="production" + It will load default roles, trackers, statuses, workflows and enumerations. + This step is optional but *highly recommended* + +6. Test the installation by running WEBrick web server: + ruby script/server -e production + + Once WEBrick has started, point your browser to http://localhost:3000/ + You should now see the application welcome page + +7. Use default administrator account to log in: + login: admin + password: admin + +8. You can go to "Admin -> Settings" to modify application settings. + +9. Setup Apache or Lighttpd with fastcgi for best performance. + + +== SMTP server Configuration + +In config/environment.rb, you can set parameters for your SMTP server: +config.action_mailer.smtp_settings: SMTP server configuration +config.action_mailer.perform_deliveries: set to false to disable mail delivering + +Don't forget to restart the application after any change to this file. diff --git a/doc/README b/doc/README deleted file mode 100644 index 9afa69a0d..000000000 --- a/doc/README +++ /dev/null @@ -1,77 +0,0 @@ -== redMine - -redMine - project management software -Copyright (C) 2006-2007 Jean-Philippe Lang -http://redmine.rubyforge.org/ - -== License - -This program is free software; you can redistribute it and/or -modify it under the terms of the GNU General Public License -as published by the Free Software Foundation; either version 2 -of the License, or (at your option) any later version. - -This program is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -GNU General Public License for more details. - -You should have received a copy of the GNU General Public License -along with this program; if not, write to the Free Software -Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - - -== Main features - -redMine is a flexible project management web application written using Ruby on Rails. - -* Multiple users/multiple projects -* Fully customizable role based access control -* Issue tracking system -* Fully customizable workflow -* Documents/files repository -* Forums -* News management -* Per project Wiki -* Time tracking -* Repository browser and diff viewer -* Email notifications -* Custom fields for projects, users and issues -* Multiple LDAP authentication support -* User self-registration support -* Multilanguage support -* Multiple repositories support -* Multiple databases support - - -== User documentation - -User documentation for redMine is written using DocBook XML format. -It's also avaible as HTML files in /public/manual (contextual help) - - -== Versioning - -redMine versioning scheme is major.minor.revision -Versions before 1.0.0 must be considered as beta versions and upgrading support -may not be provided for these versions. - - -== Credits - -* Jean-Francois Boutier (spanish translation) -* Andreas Viklund (open source XHTML layout, http://andreasviklund.com/) -* Karim Trott (german translation) -* Todd McGrath (help with english translation) -* Satoru Kurashiki (japanese translation) -* Alessio Spadaro (italian translation) -* Andy Wu (chinese simplified translation) -* Thomas Löber (german translation) -* Daniel Weinand (german translation) -* Joao Carlos Clementoni (portuguese translation) -* Cyril Mougel (side by side diff) -* Nikolay Solakov (Bulgarian translation) -* Linda van den Brink (Dutch translation) -* Pavol Murin (Wiki attachments) -* Thomas Habets (Swedish translation) -* Ralph Vater (CVS adapter) diff --git a/doc/UPGRADING b/doc/UPGRADING index 73086e680..5ccffedf7 100644 --- a/doc/UPGRADING +++ b/doc/UPGRADING @@ -1,33 +1,36 @@ -== redMine upgrade procedure - -redMine - project management software -Copyright (C) 2006-2007 Jean-Philippe Lang -http://redmine.rubyforge.org/ - - -== Upgrading from 0.3.0 and above - -1. Uncompress program archive in a new directory: - tar zxvf - -3. Copy your database settings (RAILS_ROOT/config/database.yml) - into the new config directory - -4. Migrate your database: - rake db:migrate RAILS_ENV="production" - -5. Copy the RAILS_ROOT/files directory content into your new installation - -Note 1: Rails 1.2.2 is required for version 0.4.2 and later. - -Note 2: when upgrading your code with svn update, don't forget to clear -the application cache (RAILS_ROOT/tmp/cache) before restarting. - -Note 3: settings previously defined in custom_config.rb are now stored -in database, as of version 0.4.2. Go to "Admin -> Settings" to edit them. - - -== From 0.2.x and below - -Due to major database changes since 0.2.x, there is no migration support -from 0.2.x and previous versions. +== Redmine upgrade procedure + +Redmine - project management software +Copyright (C) 2006-2007 Jean-Philippe Lang +http://www.redmine.org/ + + +== Upgrading from 0.3.0 and above + +1. Uncompress the program archive in a new directory + +3. Copy your database settings (RAILS_ROOT/config/database.yml) + into the new config directory + +4. Enter your SMTP settings in config/environment.rb + Do not replace this file with the old one + +5. Migrate your database (please make a backup before doing this): + rake db:migrate RAILS_ENV="production" + +6. Copy the RAILS_ROOT/files directory content into your new installation + +Note 1: Rails 1.2.2 or higher is required for version 0.4.2 and later. +This release won't work with Rails 2.0 + +Note 2: when upgrading your code with svn update, don't forget to clear +the application cache (RAILS_ROOT/tmp/cache) before restarting. + +Note 3: settings previously defined in custom_config.rb are now stored +in database, as of version 0.4.2. Go to "Admin -> Settings" to edit them. + + +== From 0.2.x and below + +Due to major database changes since 0.2.x, there is no migration support +from 0.2.x and previous versions. diff --git a/lib/redmine/version.rb b/lib/redmine/version.rb index 85b7217b7..f09287e7c 100644 --- a/lib/redmine/version.rb +++ b/lib/redmine/version.rb @@ -3,8 +3,8 @@ require 'rexml/document' module Redmine module VERSION #:nodoc: MAJOR = 0 - MINOR = 5 - TINY = 1 + MINOR = 6 + TINY = 0 def self.revision revision = nil -- 2.39.5