Migrating from KDE3.5.10 to Trinity is straightforward.

For those folks wanting to use an existing KDE3 profile, I wrote
/opt/trinity/bin/migratekde3 script to migrate an existing KDE3
profile directory. Run this script before starting X (doh!).

The automatic migration can take a few minutes because there is some deep
file scrubbing to remove remnants of KDE3. Please be patient. :)

You can manually migrate an existing KDE3 profile directory. Just keep
reading.

The migration might stall with some systems using the proprietary Nvidia
drivers. The easy workaround is to temporarily use the vesa drivers.

Do not panic if the migration fails. Exit X and delete the $HOME/.trinity
profile directory. Then follow these steps.

If you do not want to migrate an existing KDE3 profile directory, then
before starting X perform one of the following steps:

1. Create an empty Trinity profile directory:

mkdir $HOME/.trinity

2. Rename your old KDE3 profile directory:

mv $HOME/.kde3 $HOME/.kde3.old

If you want to start with a clean Trinity user profile directory, don't
do anything. You'll see the KPersonalizer applet start and the default Trinity
desktop. Configure thereafter to taste.

If you have a KDE profile directory, the startkde script will look for five key
KDE4 files. If any of those files exist then the directory is presumed to be a
KDE4 profile directory and those files will not be copied to the new Trinity
profile directory.

Even if letting Trinity automatically migrate an existing KDE3 profile directory,
please read the remainder of this file to understand what is needed to create a
clean Trinity profile directory during a migration.

========
ONE
========

If in graphical startup mode, toggle to console 6 (Alt-Ctrl-F6), and log in
with your user account. If in command line startup mode, then log in. In either
case do not run startx.

Run the following command, but modify ".kde3" as appropriate for your KDE3
profile directory. Be sure not to copy the KDE4 profile directory!

cp -a ~/.kde3 ~/.trinity

You now have a Trinity profile directory, but one that is "contaminated" with
KDE3 connections.

========
TWO
========

Run the following commands:

rm -fr ~/.trinity/cache-*
rm -fr ~/.trinity/socket-*
rm -fr ~/.trinity/tmp-*

Trinity will recreate those directories.

========
THREE
========

NOTE: If you use KMail and store your emails in your home directory then you
might want to exclude that file path from the search criteria.

Run the following command (modify ".kde3" as appropriate for your KDE3
profile directory.):

find ~/.trinity -path ~/.trinity/share/apps/kmail/mail -prune -o -type f \
       -exec sed -i 's|/\.kde3|/\.trinity|g' {} \;

Run the following command (modify the paths as appropriate)

find ~/.trinity -path ~/.trinity/share/apps/kmail/mail -prune -o -type f \
       -exec sed -i 's|/opt/kde3/|/opt/trinity/|g' {} \;

Run the following command (modify the paths as appropriate)

find ~/.trinity -path ~/.trinity/share/apps/kmail/mail -prune -o -type f \
      -exec sed -i 's|/usr/share/|/opt/trinity/share/|g' {} \;

These commands will find all references in all profile text files, including
configuration files and change the references from your KDE3 profile directory
to your new Trinity profile directory.

========
FOUR
========

To avoid conflicts with KDE4, you might want to disable the
/etc/profile.d kde.[c]sh and qt4 scripts (chmod -x).

You might want to recreate any sym links in ~/.trinity/Autostart and check
any *.desktop files stored there for the correct path to the Trinity parent
directory (default is /opt/trinity and not /usr).

If some apps fail to function properly and you migrated a KDE3 profile directory,
check the app's config file in ~/.trinity/share/config for incorrect file paths.
Or just delete the config file. A common example is KPatience (solitaire card
game), which hard-codes the file path to the user's preferred card backing deck.

========
FIVE
========

After a migration of a KDE3 profile, there might seem to be a few things wrong
the first time in Trinity.For example some keyboard shortcuts might not work.

The first thing to do is run the Menu Updating tool in Settings. None of the
non Trinity apps will be in the menu and that is why oddball things like keyboard
shortcuts stop. Once the apps are returned to the menu, the keyboard shortcuts will
again work.

Also update any Quick Launch icons. The icon will point to the correct
location and only need refreshing of the icon.

========
THE END
========

If in graphical startup mode, then log out and return to the login manager
(Alt-Ctrl-F1). If in command line startup mode, then run the startx script as
usual.