diff options
author | Darrell Anderson <humanreadable@yahoo.com> | 2014-01-19 02:07:29 -0600 |
---|---|---|
committer | Darrell Anderson <humanreadable@yahoo.com> | 2014-01-19 02:07:29 -0600 |
commit | 32f7a85c9df5f48a6c9b4d73f0323c490a6ae95f (patch) | |
tree | b20a7a37eb8d497d5a55692ae023a1d649a2f683 /doc/releasenotes/index.docbook | |
parent | 8781095d0759d8af3207e717560a53c02c32bc8b (diff) | |
download | tdebase-32f7a85c9df5f48a6c9b4d73f0323c490a6ae95f.tar.gz tdebase-32f7a85c9df5f48a6c9b4d73f0323c490a6ae95f.zip |
Create a Release Notes help handbook module, create a Release Notes link
in the Welcome to TDE handbook, and provide a run-once autostart mechanism.
Diffstat (limited to 'doc/releasenotes/index.docbook')
-rw-r--r-- | doc/releasenotes/index.docbook | 834 |
1 files changed, 834 insertions, 0 deletions
diff --git a/doc/releasenotes/index.docbook b/doc/releasenotes/index.docbook new file mode 100644 index 000000000..fa67ef816 --- /dev/null +++ b/doc/releasenotes/index.docbook @@ -0,0 +1,834 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY kappname "&tde; Release Notes"> + <!ENTITY package "tdebase"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % English "INCLUDE" > <!-- change language only here --> +]> + +<book lang="&language;"> +<bookinfo> + +<title>&tde-release-version; Release Notes</title> + +<authorgroup> + +<author> +<surname>The &tde; Team</surname> +</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>&tde-release-date;</date> +<releaseinfo>&tde-release-version;</releaseinfo> + +<copyright> +<year>&tde-copyright-date;</year> +<holder>The &tde; Team</holder> +</copyright> + +<!-- <legalnotice>&FDLNotice;</legalnotice> --> + +<abstract> +<para>&tde-release-version; Release Notes</para> +</abstract> + +<keywordset> +<keyword>TDE</keyword> +<keyword>release notes</keyword> +</keywordset> +</bookinfo> + +<chapter id="current-release-notes-introduction"> +<title>Summary</title> + +<para>This document contains important information for users, developers, and packagers. This document is +intended for people who are migrating from previous versions of Trinity. If you are a using Trinity for the +first time, then you can ignore the contents of this document.</para> + +<para>The Trinity Desktop is a full software desktop environment designed for Unix-like operating systems, +intended for computer users preferring a traditional desktop model focusing primarily on retaining the overall +KDE 3.5 user experience and efficiency. Trinity is free/libre software.</para> + +<para>First, thank you to the many people who contributed to all of these improvements. Many people played a +role, including bug fixing, enhancements, testing, etc.</para> + +<para>Many changes were made to Trinity after the release of 3.5.13.</para> + +<para>An obvious change is the version scheme. Trinity evolved from the last KDE 3.5 release, 3.5.10. Subsequent +Trinity releases followed that numbering scheme. Release R14.0.0 marks a turning point in Trinity history +because a great deal of the code infrastructure was changed. While those changes do not effect the usability or +look-and-feel of the desktop that users enjoy, Trinity developers believe a change in the version scheme +distinguishes when those changes occurred. An original project goal by users was to retain the flavor of the +original KDE 3.5 desktop. That goal remains intact. To reflect that original goal, the last number in the +original version scheme is retained in the new version scheme but is now the primary version number. While the +infrastructure has changed, the desktop itself remains the same as the original KDE 3.5. This new version scheme +indicates a modest divergence from the original KDE 3.5 series and that Trinity is now its own desktop +environment. The new version scheme reminds users that Trinity retains the original KDE 3.5 design, but is +moving forward as a separate desktop project.</para> + +<para>Notable changes include renaming and rebranding efforts to avoid conflicts with KDE4. Both Trinity and +KDE4 have roots in KDE3. These changes focus on promoting a peaceful coexistence between the two desktop +environments when both are installed concurrently on the same system as well as avoid possible trademark +issues.</para> + +<para>Renaming and rebranding efforts include:</para> + +<itemizedlist> + +<listitem><para> +Libraries +</para></listitem> + +<listitem><para> +Classes +</para></listitem> + +<listitem><para> +Environment variables and config file locations +</para></listitem> + +<listitem><para> +Package names +</para></listitem> + +<listitem><para> +Application names +</para></listitem> + +</itemizedlist> + +<para>A change log is available at the Trinity wiki: +<ulink url="http://www.trinitydesktop.org/wiki/bin/view/Documentation/Releases_R14_0_0">Change log</ulink></para> + +<para>An exhaustive list of renaming changes is available at the end of this document.</para> + +</chapter> + +<chapter id="current-release-notes-project-changes"> +<title>Project Changes</title> + +<itemizedlist> + +<listitem><para> +Migrated from SVN to GIT. +</para></listitem> +<listitem><para> +Began migrating from automake to cmake. +</para></listitem> +<listitem><para> +Added support for ARM architectures. +</para></listitem> +<listitem><para> +Continuing efforts to improve XDG compliance. +</para></listitem> +<listitem><para> +Continuing efforts to update documentation. +</para></listitem> +<listitem><para> +Continuing efforts to update locale and translation files. +</para></listitem> + +</itemizedlist> + +</chapter> + +<chapter id="current-release-notes-usability-changes"> +<title>Usability Changes</title> + +<para>Because of the wide-scale renaming efforts, existing KDE3 and 3.5.13.x user profile directories will not +function properly under R14.0.0. Don't worry.</para> + +<para>When logging into Trinity R14.0.0, the starttde script (nee startkde), performs profile checks to ensure +settings and configurations are migrated correctly. These checks include preserving the original KDE3/3.5.13.x +profile directory as-is while using those files as the basis to create the new R14.0.0 profile named +$HOME/.trinity.</para> + +<para>The underlying migration checking has been tested, but because of the renaming and rebranding efforts, +upstream packagers should test support scripts for problems and anomalies.</para> + +<para>There is another special script to help update profile directories. That script is +/opt/trinity/bin/migratekde3. This script is intended for people using versions of Trinity prior to 3.5.13. +Before starting R14.0.0 the first time, use this script to update any KDE3 profile directory. The definition of +a KDE3 profile directory includes Trinity 3.5.11 and 3.5.12. The script will look for profile directory names +of ~/.kde3, ~/.kdemod3, and ~/.kde. Because the latter directory name is also used in KDE4, several tests are +performed to ensure the directory is a KDE3 profile and not KDE4.</para> + +<para>The renaming might cause certain shortcuts and menu links to stop functioning. The underlying migration +checks performed when logging into R14.0.0 for the first time should find all of these differences, but fixing +those that are missed is straightforward. All that is needed is knowing the new name of the command or +application. For example, changing kdesu to tdesu, although that specific change is covered by the +scripts.</para> + +<para>The Trinity launcher menu, tdemenu (nee kmenu), has been reorganized to reduce clutter. In addition to +built-in XDG changes in *.desktop files, There are two methods available to manage KDE4 apps in the Trinity +menu. One method includes a build-time configuration option in tdelibs, WITH_KDE4_MENU_SUFFIX, that adds a +"[KDE4]" tag to KDE4 menu items. This tag helps identify apps of the same name. The default is OFF and requires +a package rebuild to change. A second method includes a global menu replacement, tde-applications.menu-no-kde +that explicitly excludes KDE4 apps from the menu. Using that special menu requires administrative privileges to +update.</para> + +</chapter> + +<chapter id="current-release-notes-new-or-improved-features"> +<title>New or Improved Features</title> + +<itemizedlist> + +<listitem><para> +Faster startup and logout +</para></listitem> +<listitem><para> +Ability to force Kate into MDI mode all the time. +</para></listitem> +<listitem><para> +Built-in hardware detection libraries and support to fully replace HAL. +</para></listitem> +<listitem><para> +File copy window focus enhancement: focus is now on the file name edit line by default +</para></listitem> +<listitem><para> +GUI support for controlling whether to display archives as folders. +</para></listitem> +<listitem><para> +Improved Logout Status Dialog. +</para></listitem> +<listitem><para> +Improved support for global and individual panels. +</para></listitem> +<listitem><para> +Mac like window switching for apps. +</para></listitem> +<listitem><para> +New Desktop Device Icons: My Computer, My Documents, My Network Places, Printers, Web Browser. +</para></listitem> +<listitem><para> +Rearrangeable (draggable) items in the taskbar. +</para></listitem> +<listitem><para> +Reduced TDE menu clutter and duplication. +</para></listitem> +<listitem><para> +Icons only mode available for taskbar +</para></listitem> +<listitem><para> +Accelerator key for Konsole main menu can be enabled when desired +</para></listitem> +<listitem><para> +Possible to move to next/previous file in a Konqueror list view while renaming +</para></listitem> +<listitem><para> +Kate taskbar: middle mouse click close selected document, if enabled +</para></listitem> +<listitem><para> +The number of files in the Kate MRU (Most Recently Used) list is user-configurable. +</para></listitem> +<listitem><para> +Added a progress bar to the logout status dialog. +</para></listitem> +<listitem><para> +Added a mouse doubleclick test option in the control panel. +</para></listitem> +<listitem><para> +Kate syntax highlighting files have been updated and the lookup moved to the TDE repository +</para></listitem> + +</itemizedlist> + +</chapter> + +<chapter id="current-release-notes-new-packages"> +<title>New Packages</title> + +<itemizedlist> + +<listitem><para> +GTK3/TQt Theme Engine +</para></listitem> +<listitem><para> +KControl LDAP Manager +</para></listitem> +<listitem><para> +KControl Autostart +</para></listitem> +<listitem><para> +Kasablanca +</para></listitem> +<listitem><para> +KBiff +</para></listitem> +<listitem><para> +KBibTex +</para></listitem> +<listitem><para> +KDbg +</para></listitem> +<listitem><para> +KFTPGrabber +</para></listitem> +<listitem><para> +KLCDDimmer +</para></listitem> +<listitem><para> +KNmap +</para></listitem> +<listitem><para> +KRecipes +</para></listitem> +<listitem><para> +KScope +</para></listitem> +<listitem><para> +KSensors +</para></listitem> +<listitem><para> +KShowmail +</para></listitem> +<listitem><para> +KShutdown +</para></listitem> +<listitem><para> +LDAP/Kerberos Toolkit +</para></listitem> +<listitem><para> +MPlayerthumbs +</para></listitem> +<listitem><para> +Qt4/TQt Theme Engine +</para></listitem> +<listitem><para> +tdeio-ftps +</para></listitem> +<listitem><para> +tdeio-sword +</para></listitem> +<listitem><para> +TorK +</para></listitem> + +</itemizedlist> + +</chapter> + +<chapter id="current-release-notes-package-renaming"> +<title>Package Renaming</title> + +<itemizedlist> + +<listitem><para> +kde-i18n -> tde-i18n +</para></listitem> +<listitem><para> +kde-guidance -> tde-guidance +</para></listitem> +<listitem><para> +kde-style-lipstik -> tde-style-lipstik +</para></listitem> +<listitem><para> +kde-style-qtcurve -> tde-style-qtcurve +</para></listitem> +<listitem><para> +kde-systemsettings -> tde-systemsettings +</para></listitem> +<listitem><para> +kdeaccessibility -> tdeaccessibility +</para></listitem> +<listitem><para> +kdeaddons -> tdeaddons +</para></listitem> +<listitem><para> +kdeadmin -> tdeadmin +</para></listitem> +<listitem><para> +kdeartwork -> tdeartwork +</para></listitem> +<listitem><para> +kdebase -> tdebase +</para></listitem> +<listitem><para> +kdebindings -> tdebindings +</para></listitem> +<listitem><para> +kdeedu -> tdeedu +</para></listitem> +<listitem><para> +kdegames -> tdegames +</para></listitem> +<listitem><para> +kdegraphics -> tdegraphics +</para></listitem> +<listitem><para> +kdelibs -> tdelibs +</para></listitem> +<listitem><para> +kdemultimedia -> tdemultimedia +</para></listitem> +<listitem><para> +kdenetwork -> tdenetwork +</para></listitem> +<listitem><para> +kdenetworkmanager -> tdenetworkmanager +</para></listitem> +<listitem><para> +kdepim -> tdepim +</para></listitem> +<listitem><para> +kdepowersave -> tdepowersave +</para></listitem> +<listitem><para> +kdesdk -> tdesdk +</para></listitem> +<listitem><para> +kdesudo -> tdesudo +</para></listitem> +<listitem><para> +kdesvn -> tdesvn +</para></listitem> +<listitem><para> +kdetoys -> tdetoys +</para></listitem> +<listitem><para> +kdeutils -> tdeutils +</para></listitem> +<listitem><para> +kdevelop -> tdevelop +</para></listitem> +<listitem><para> +kdewebdev -> tdewebdev +</para></listitem> +<listitem><para> +kdmtheme -> tdmtheme +</para></listitem> +<listitem><para> +kio-apt -> tdeio-apt +</para></listitem> +<listitem><para> +kio-locate -> tdeio-locate +</para></listitem> +<listitem><para> +kio-umountwrapper -> tdeio-umountwrapper +</para></listitem> +<listitem><para> +kradio -> tderadio +</para></listitem> +<listitem><para> +kwin-style-crystal -> twin-style-crystal +</para></listitem> +<listitem><para> +pykde -> pytde +</para></listitem> +<listitem><para> +qca -> tqca +</para></listitem> +<listitem><para> +qca-tls -> tqca-tls +</para></listitem> + +</itemizedlist> + +</chapter> + +<chapter id="current-release-notes-application-and-file-renaming"> +<title>Application and File Renaming</title> + +<itemizedlist> + +<listitem><para> +applications-kmenuedit.menu -> applications-tdemenuedit.menu +</para></listitem> +<listitem><para> +.kderc -> .tderc +</para></listitem> +<listitem><para> +kab2kabc -> tdeab2tdeabc +</para></listitem> +<listitem><para> +kcache -> tdecache +</para></listitem> +<listitem><para> +kconf_update -> tdeconf_update +</para></listitem> +<listitem><para> +kde-$USER -> tde-$USER +</para></listitem> +<listitem><para> +kde-config -> tde-config +</para></listitem> +<listitem><para> +kdeprint -> tdeprint +</para></listitem> +<listitem><para> +kdesu -> tdesu +</para></listitem> +<listitem><para> +kdesudo -> tdesudo +</para></listitem> +<listitem><para> +kdevelop -> tdevelop +</para></listitem> +<listitem><para> +kdm -> tdm +</para></listitem> +<listitem><para> +kdmtheme -> tdmtheme +</para></listitem> +<listitem><para> +kfile -> tdefile +</para></listitem> +<listitem><para> +khtml -> tdehtml +</para></listitem> +<listitem><para> +kio_apt -> tdeio_apt +</para></listitem> +<listitem><para> +kio_camera -> tdeio_camera +</para></listitem> +<listitem><para> +kio_ftp -> tdeio_ftp +</para></listitem> +<listitem><para> +kio_http -> tdeio_http +</para></listitem> +<listitem><para> +kio_locate -> tdeio_locate +</para></listitem> +<listitem><para> +kio_thumbnail -> tdeio_thumbnail +</para></listitem> +<listitem><para> +kioslave -> tdeioslave +</para></listitem> +<listitem><para> +klaunch -> tdelaunch +</para></listitem> +<listitem><para> +kmenu -> tdemenu +</para></listitem> +<listitem><para> +knetworkmanager -> tdenetworkmanager +</para></listitem> +<listitem><para> +kpowersave -> tdepowersave +</para></listitem> +<listitem><para> +kradio -> tderadio +</para></listitem> +<listitem><para> +krandrtray -> tderandrtray +</para></listitem> +<listitem><para> +kresources -> tderesources +</para></listitem> +<listitem><para> +krita -> chalk +</para></listitem> +<listitem><para> +ksocket -> tdesocket +</para></listitem> +<listitem><para> +kstyle -> tdestyle +</para></listitem> +<listitem><para> +kwallet -> tdewallet +</para></listitem> +<listitem><para> +kwin -> twin +</para></listitem> +<listitem><para> +kwin4 -> twin4 +</para></listitem> +<listitem><para> +startkde -> starttde +</para></listitem> + +</itemizedlist> + +</chapter> + +<chapter id="current-release-notes-environment-variable-renaming"> +<title>Environment Variable Renaming</title> + +<itemizedlist> + +<listitem><para> +KDEBINDIR -> TDEBINDIR +</para></listitem> +<listitem><para> +KDEDIR -> TDEDIR +</para></listitem> +<listitem><para> +KDEDIRS -> TDEDIRS +</para></listitem> +<listitem><para> +KDEHOME -> TDEDEHOME +</para></listitem> +<listitem><para> +KDEROOTHOME -> TDEROOTHOME +</para></listitem> +<listitem><para> +KDESRCDIR -> TDESRCDIR +</para></listitem> +<listitem><para> +KDESU_USER -> TDESU_USER +</para></listitem> +<listitem><para> +KDESYCOCA -> TDESYCOCA +</para></listitem> +<listitem><para> +KDETMP -> TDETMP +</para></listitem> +<listitem><para> +KDEVARTMP -> TDEVARTMP +</para></listitem> +<listitem><para> +KDEWM -> TDEWM +</para></listitem> +<listitem><para> +KDE_FORK_SLAVES -> TDE_FORK_SLAVES +</para></listitem> +<listitem><para> +KDE_FULL_SESSION -> TDE_FULL_SESSION +</para></listitem> +<listitem><para> +KDE_KIOSK_NO_PROFILES -> TDE_KIOSK_NO_PROFILES +</para></listitem> +<listitem><para> +KDE_KIOSK_NO_RESTRICTIONS -> TDE_KIOSK_NO_RESTRICTIONS +</para></listitem> +<listitem><para> +KDE_LANG -> TDE_LANG +</para></listitem> +<listitem><para> +KDE_MAKE_VERSION -> TDE_MAKE_VERSION +</para></listitem> +<listitem><para> +KDE_MALLOC -> TDE_MALLOC +</para></listitem> +<listitem><para> +KDE_MULTIHEAD -> TDE_MULTIHEAD +</para></listitem> +<listitem><para> +KDE_NO_IPV6 -> TDE_NO_IPV6 +</para></listitem> +<listitem><para> +KDE_SESSION_UID -> TDE_SESSION_UID +</para></listitem> +<listitem><para> +KDE_UTF8_FILENAMES -> TDE_UTF8_FILENAMES +</para></listitem> +<listitem><para> +KDE_VERSION -> TDE_VERSION +</para></listitem> + +</itemizedlist> + +</chapter> + +<chapter id="current-release-notes-class-and-library-renaming"> +<title>Class and Library Renaming</title> + +<itemizedlist> + +<listitem><para> +KABC -> TDEABC +</para></listitem> +<listitem><para> +KAbout -> TDEAbout +</para></listitem> +<listitem><para> +KAboutData -> TDEAboutData +</para></listitem> +<listitem><para> +KApplication -> TDEApplication +</para></listitem> +<listitem><para> +KBuffer -> TDEBuffer +</para></listitem> +<listitem><para> +KClipboard -> TDEClipboard +</para></listitem> +<listitem><para> +KCModule -> TDECModule +</para></listitem> +<listitem><para> +KComp -> TDEComp +</para></listitem> +<listitem><para> +KConfig -> TDEConfig +</para></listitem> +<listitem><para> +KCmd -> TDECmd +</para></listitem> +<listitem><para> +KCmdLineArgs -> TDECmdLineArgs +</para></listitem> +<listitem><para> +KGlobal -> TDEGlobal +</para></listitem> +<listitem><para> +KIcon -> TDEIcon +</para></listitem> +<listitem><para> +KInstance -> TDEInstance +</para></listitem> +<listitem><para> +KIO -> TDEIO +</para></listitem> +<listitem><para> +KIO_EXPORT -> TDEIO_EXPORT +</para></listitem> +<listitem><para> +KIOBuffer -> TDEIOBuffer +</para></listitem> +<listitem><para> +KIOConfig -> TDEIOConfig +</para></listitem> +<listitem><para> +KIOInput -> TDEIOInput +</para></listitem> +<listitem><para> +KIOJob -> TDEIOJob +</para></listitem> +<listitem><para> +KListBox -> TDEListBox +</para></listitem> +<listitem><para> +KListView -> TDEListView +</para></listitem> +<listitem><para> +KListViewItem -> TDEListViewItem +</para></listitem> +<listitem><para> +KLocale -> TDELocale +</para></listitem> +<listitem><para> +KLock -> TDELock +</para></listitem> +<listitem><para> +KPopupMenu -> TDEPopupMenu +</para></listitem> +<listitem><para> +KProcess -> TDEProcess +</para></listitem> +<listitem><para> +KServer -> TDEServer +</para></listitem> +<listitem><para> +KShared -> TDEShared +</para></listitem> +<listitem><para> +KSocket -> TDESocket +</para></listitem> +<listitem><para> +KStandardDirs -> TDEStandardDirs +</para></listitem> +<listitem><para> +KStartupInfo -> TDEStartupInfo +</para></listitem> +<listitem><para> +KStyle -> TDEStyle +</para></listitem> +<listitem><para> +KTrader -> TDETrader +</para></listitem> +<listitem><para> +KZone -> TDEZone +</para></listitem> +<listitem><para> +kdefx -> tdefx +</para></listitem> +<listitem><para> +kdeinit -> tdeinit +</para></listitem> +<listitem><para> +kiobuffer -> tdeiobuffer +</para></listitem> +<listitem><para> +kioslave -> tdeioslave +</para></listitem> +<listitem><para> +kwin -> twin +</para></listitem> +<listitem><para> +libkdecorations -> libtdecorations +</para></listitem> +<listitem><para> +libkdecore -> libtdecore +</para></listitem> +<listitem><para> +libkdefakes -> libtdefakes +</para></listitem> +<listitem><para> +libkdepim -> libtdepim +</para></listitem> +<listitem><para> +libkdeprint -> libtdeprint +</para></listitem> +<listitem><para> +libkdesu -> libtdesu +</para></listitem> +<listitem><para> +libkdeui -> libtdeui +</para></listitem> +<listitem><para> +lkabc -> ltdeabc +</para></listitem> +<listitem><para> +lkdnssd -> ltdednssd +</para></listitem> +<listitem><para> +lkfile -> ltdefile +</para></listitem> +<listitem><para> +lkhtml -> ltdehtml +</para></listitem> +<listitem><para> +lkio -> ltdeio +</para></listitem> +<listitem><para> +lkimproxy -> ltdeimproxy +</para></listitem> +<listitem><para> +libkio -> libtdeio +</para></listitem> +<listitem><para> +lknewstuff -> ltdenewstuff +</para></listitem> +<listitem><para> +lkparts -> ltdeparts +</para></listitem> +<listitem><para> +lkspell -> ltdespell +</para></listitem> +<listitem><para> +lkunittest -> ltdeunittest +</para></listitem> +<listitem><para> +lkutils -> ltdeutils +</para></listitem> +<listitem><para> +makekdewidgets -> maketdewidgets +</para></listitem> + +</itemizedlist> + +</chapter> + +<chapter id="current-release-notes-thank-you"> +<title>Thank You!</title> + +<para>Thank you for using and supporting &tde;.</para> + +</chapter> + +</book> + +<!-- +Local Variables: +mode: sgml +sgml-omittag: nil +sgml-shorttag: t +End: +--> + |