add a user-friendly list of changes
[portage.git] / RELEASE-NOTES
1 Release Notes for portage-2.2_pre1
2 ==================================
3
4 New features / Major changes
5 ----------------------------
6 * elog framework: This finally adds a flexible way to log all einfo, ewarn and
7         eerror messages as well as adding a new elog command for ebuilds. New ebuilds
8         should use elog instead of einfo for delivering important information as 
9         einfo messages will not be logged by default. [genone]
10 * elog modules: Together with the framework some basic modules implementing
11         common logging facilities are shipped, these include:
12         - mod_syslog for relaying messages to syslog
13         - mod_mail for sending messages to a predefined mail adress
14         - mod_save for saving messages to a file
15         - mod_custom for processing messages with a custom command
16         NOTE: The elog interfaces are still subject to change, so don't rely on the
17         exact format yet. [genone]
18 * version syntax enhancements: The version parsing and comparison code was 
19         completely rewritten and now supports two extensions to previous versions:
20         - a cvs prefix to denote live cvs (or svn or any other vcs) ebuilds, so now
21                 you can have a package foo with the ebuilds foo-1.ebuild and 
22                 foo-cvs.1.ebuild in the same directory. cvs ebuilds will always be 
23                 ranked higher than any non-cvs ebuild.
24         - multiple suffixes now allow for constructions like foo-1.0_pre1_rc5
25         Also the new code is now separated into its own module portage_versions.py
26         with no dependencies on the main portage module. [genone]
27 * recursive config files: Most of the config files in /etc/portage can now
28         also be directories, if they are then portage will recursively use all
29         files in them. So you could have /etc/portage/package.keywords/kde/base
30         and /etc/portage/package.keywords/gnome instead of a single package.keywords.
31         This applies to the following files:
32         - package.keywords
33         - package.mask
34         - package.unmask
35         - package.use
36         - mirrors
37         [genone]
38
39 Bug fixes / Minor Changes
40 -------------------------
41 * Removal of "masked by -*" message [genone]
42 * Fixed some minor screwup in the sort algorithm for versions [genone]