path: root/doc/releasenotes/index.docbook

<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
]>

<article id="release-notes" lang="&language;">
<title>&tde-release-version; Release Notes</title>

<articleinfo>
<authorgroup>
<author>&tde-authors;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<date>&tde-release-date;</date>
<releaseinfo>&tde-release-version;</releaseinfo>

<copyright>
<year>&tde-copyright-date;</year>
<holder>&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>

</articleinfo>

<sect1 id="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>

<sect2 id="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>

</sect2>

<sect2 id="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>

<para>Because of a common heritage shared with KDE, Trinity still shares many app and library names with KDE.
Therefore to avoid conflicts, the normal practice is to install Trinity to /opt/trinity. Because of this
atypical installation location, on many systems non-Trinity desktops and window managers initially will not
find any Trinity apps. For systems using /etc/profile.d, ensure the packager includes appropriate scripts to
populate all necessary environment variables. For other systems, at least the XDG_CONFIG_DIRS and XDG_DATA_DIRS
environment variables must be modified to recognize the /opt/trinity directory. Typical modifications look like
this:</para>

<itemizedlist>

<listitem><para>
XDG_CONFIG_DIRS=/etc/trinity/xdg:/etc/xdg:/etc/kde/xdg
</para></listitem>
<listitem><para>
XDG_DATA_DIRS=/opt/trinity/share:/usr/share
</para></listitem>

</itemizedlist>

<para>Users who do not install any tde-i18n package will encounter broken symlinks if they browse the
non-English documention folders of some applications. Such symlinks are hooks to the correct location 
of localized common resources and will work properly once the related tde-i18n package is installed.
Please refrain from filing bugs related to those broken symlinks.</para>
</sect2>


<sect2 id="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>
<listitem><para>
tdecmshell --list output is now sorted alphabetically.
</para></listitem>
<listitem><para>
Improved application crash report framework, which now also includes source code commit references for better debugging.
</para></listitem>


</itemizedlist>

</sect2>

<sect2 id="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>

</sect2>

<sect2 id="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>

</sect2>

<sect2 id="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>
kbuildsycoca -> tdebuildsycoca
</para></listitem>
<listitem><para>
kcache -> tdecache
</para></listitem>
<listitem><para>
kcmshell -> tdecmshell
</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>
kdebugdialog -> tdedebugdialog
</para></listitem>
<listitem><para>
kdeeject -> tdeeject
</para></listitem>
<listitem><para>
kdekillall -> tdekillall
</para></listitem>
<listitem><para>
kdepasswd -> tdepasswd
</para></listitem>
<listitem><para>
kdessh -> tdessh
</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>
kfilereplace -> tdefilereplace
</para></listitem>
<listitem><para>
kfontinst -> tdefontinst
</para></listitem>
<listitem><para>
kfontview -> tdefontview
</para></listitem>
<listitem><para>
khtml -> tdehtml
</para></listitem>
<listitem><para>
kiconedit -> tdeiconedit
</para></listitem>
<listitem><para>
kinit* -> tdeinit*
</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>
kmid -> tdemid
</para></listitem>
<listitem><para>
knetworkmanager -> tdenetworkmanager
</para></listitem>
<listitem><para>
kpowersave -> tdepowersave
</para></listitem>
<listitem><para>
kprint -> tdeprint
</para></listitem>
<listitem><para>
kprintfax -> tdeprintfax
</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>
qmake -> tqmake
</para></listitem>
<listitem><para>
qmoc -> tqmoc
</para></listitem>
<listitem><para>
qtconfig -> tqconfig
</para></listitem>
<listitem><para>
quic -> tquic
</para></listitem>
<listitem><para>
startkde -> starttde
</para></listitem>

</itemizedlist>

</sect2>

<sect2 id="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>

</sect2>

<sect2 id="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>

</sect2>

<sect2 id="release-notes-thank-you">
<title>Thank You!</title>

<para>Thank you for using and supporting &tde;.</para>

</sect2>

</sect1>

</article>