krusader/README

Krusader 1.90.0 "Power Stone"
=================================
Well, here we are!

The Krew is finally bringing you the _last_ release of Krusader the
file manager for the KDE 3.x series. In this release you can expect 
many new Krusader Extensions sent in by our users + bugfixes.
We would like to thank all of the community for keeping us sharp all these
years throughout our release cycles. 

IMPORTANT: Crashes in Krusader caused by Qt 3.3.5
------------------------------------------------------------------------
We've been getting a lot of emails and bug reports regarding random
crashes in Krusader, especially during some file operations (copy/move
etc.). These crashes are related to Qt 3.3.5 and NOT Krusader.
It seems that Qt 3.3.5 introduced a serious bug which is now causing
random crashes in many KDE applications including Konqueror. You can
google for it to find out more. 

As far as we know, Debian and SUSE already posted new Qt binaries that
fix the problem, and Gentoo has masked Qt 3.3.5 completely.
As for now, you either need Qt 3.3.4 or a fixed Qt 3.3.5, depending on
your distribution. For more information is available on our website at
http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1407
------------------------------------------------------------------------

Krusader 1.90.0 contains plenty of changes, bug fixes and updates
in response to reports and requests from our users.
Special thanks goes to Václav Juza for testing, debugging and general help!


The highlights are:

Basically, Krusader-1.90.0 = Krusader-1.80.0 + bugfixes + 
Krusader Extensions sent in by our loyal users. Thanks!
+ Improvements:
 - GCC 4.3 compatibility
 - KDE 3.2 through KDE 3.5 compatibility
 - bugfixes
+ Many Krusader Extensions:
 - Keymaps, use keybindings of other commanders or customized keybindings!
 - Colormaps, use colors of other commanders or customized colors!
 - Useractions, create actions for your own needs!
 - Javascript useractions, create actions with additional javascript power
   for your own needs!
+ Krusader Extensions highlights:
  + Color schemes: Total Commander, Dos Navigator, Midnight Commander, bash
  + Keymap: Midnight Commander
  + Useractions:
   - Search and Replace in file
   - Split large mp3 files
   - Copy as root
   - Archive foo to dir
   - lzma and tar.lzma archive support
   - tar.7z archive support
   - ar (.a, .deb,...) archive support
   - Unpack multiple zip archives
   - kgpg: encrypt, decrypt, sign, verify signature
   - .uue file support (uuencode and uudecode)
  + Javascript useractions:
   - Recode files using iconv or GNU recode
   - Mount as root
   - Select from file
   - Calculator
+ Check the changelog for a complete overview of changes and Extensions.

Krusader 1.80.0 contained many changes, bug fixes and updates
in response to reports and requests from our users. The highlights are:

- Full support for ACL permissions like properties, preserve
  attributes, synchronizer and others
- Many terminal emulator enhancements bringing new functions, new
  usages and a new look
- Many improvements of the UserAction system
- Countless usability enhancements, especially in Konfigurator and the
  improved, reordered menubar
- Comparing in the synchronizer interface and parallel threading over
  slower servers
- Atomic extensions and ability to rename the filename, without extension
- Numerous archive enhancements like handling packing and unpacking in
  the background, encryption support, multiple volume archives, compression
  level
- Complete list of changes and enhancements is in the ChangeLog
- Next cycle with all our energy and efforts begins for Krusader on KDE4: 

Changes since Krusader 1.80.0-beta2
- Many bugfixes
- Translation updates

Changes since Krusader 1.80.0-beta1 (but not limited to):
 
- Added the long-awaited brief view! 
- A new GUI to configure the atomic extensions introduced in beta1 
- ACL and documentation related compile fixes 
- More usability and feature enhancements in the synchronizer, search
  and locate modules
- Bugfixes all over the place 

Enjoy!
Krusader Krew

Notice: if you've got bugs to report, please do so using Krusader's
        website, and not with KDE's bugzilla (bugs.kde.org).

             as always, enjoy
                  Krusader Krew.

                      http://www.krusader.org


+----------------------------------------------------------------------+
| To learn what's new, read the ChangeLog file.                        |
| For bug reports, fixes, patches and comments: please read the FAQ    |
| section of the Krusader Handbook.                                    |
| You can reach us by mail [krusader * users sourceforge net]          |
| or drop us a note in our Krusader forum.                             |
+----------------------------------------------------------------------+


Installation
============
Check the environment variables KDEDIR - QTDIR.

Unpack the tarball and go to the Krusader source directory.
If you have downloaded from CVS you will have to run the following
command to create the "./configure" script:
$ make -f Makefile.cvs

Installation procedure:
$ ./configure
$ make
$ su -c 'make install'

When you install a Krusader cvs or beta version and if Krusader was
previously installed on your computer, there is a possibility that you
will have to update the krusaderui.rc file. please read the FAQ for more
info.


Need more help?
For detailed installation instructions, please read the INSTALL and FAQ
file. Or read it online at:
http://krusader.sourceforge.net/handbook/installation.html
The FAQ are available at:
http://krusader.sourceforge.net/handbook/faq.html
 
Mac OS-X port
-------------
There is a Mac OS-X port with the help of finkproject.org
http://pdb.finkproject.org/pdb/package.php/krusader


To checkout the Krusader KDE3 version from cvs:
===============================================
$ cvs -d:pserver:anonymous@krusader.cvs.sourceforge.net:/cvsroot/krusader login
$ cvs -z3 -d:pserver:anonymous@krusader.cvs.sourceforge.net:/cvsroot/krusader \
co krusader_trinity
 
(Note: updates from within the modules directory do not need the -d
parameter)

Or download the nightly tarball from:
http://krusader.sourceforge.net/cvs.php

Klik Krusader
=============
If you want to find out if Krusader is right for you and don't want to
go through the whole installation-compilation process. Thanks to the
guys at http://klik.atekon.de/ this is possible. After installing the
klik client, Krusader is just one mouse click away!
 
klik://krusader = the krusader release in Debian Stable
klik://krusader-latest = latest available krusader-stable
klik://krusader-cvs = snapshot of krusader-cvs

The latter 2 klik packages are provided by the Krusader Krew.


Krusader Handbook
=================
Documentation, detailed install procedure, FAQ, ...
The Krusader Handbook is available in the Help menu of Krusader.
Or read it online at:
http://krusader.sourceforge.net/handbook/index.html

Help Krusader
=============
http://krusader.sourceforge.net/help.php
Here you get a chance to contribute to the Krusader project. From time
to time we'll post things that need to be done, but can't be done by us.
If you feel you can help, click the appropriate link on the website.
All help is welcome.
Thanks!
 
GUI-Translators
---------------
Krusader is currently available in about 27 languages:
Some of these translations can use an update, please read the next url
for more information.
http://krusader.sourceforge.net/i18n.php

Documentation Translators
-------------------------
Recently the Krusader documentation is made translatable!
Please contact Frank if you want to translate the documentation.

Documentation
-------------
Help is needed (we are looking for documentation writers) for keeping
the Krusader documentation up to date.
Please contact Frank.

FAQ
---
If you have a question for the FAQ.
Please contact Frank.

Extensions
----------
Krusader supports a wide varity of extensions. We are always glad to see
someone creating something new. Please upload your extensions at
kde-files.org.
http://www.kde-files.org/index.php?xcontentmode=660x661x662x663

Feature Requests
----------------
Discussions about new features for future Krusader versions. Please
visit our "New Features Requests" forum.

Packagers
---------
We are always in need of packagers.
Please contact Dirk Eschler.

Donations
---------
http://sourceforge.net/project/project_donations.php?group_id=6488
Honestly, we didn't consider donations, until users asked us for a way
to donate to the project. Developing Krusader can be a full time job at
times, and even though it is very time consuming, we all enjoy it, and
want to see the project become even better. Donations for this project
will be used for further development of Krusader, be it by purchasing
hardware, or promoting of the project.

Spread the Word
---------------
If you like Krusader, let people know! Write articles and reviews for
internet or print publications. Encourage your friends to give Krusader
a try. Participate in forums to help others in the community.
Help us spreading the word about Krusader!


For GUI Translators
===================
Translation procedure
---------------------
Before we release a stable version of Krusader, we bring out at least
one beta version. From that moment on there is a feature freeze and only
bugs will be fixed. This means that translators can update their
translations for the coming stable. Normally, all the Krusader
translators will receive an e-mail from Dirk Eschler, to invite you for
translating Krusader. We will update all foo.po files against
krusader.pot just before the beta will be released, so that you will
only have to edit the new foo.po file with Kbabel. This way you don't
have to worry anymore about how foo.po must be updated. In the past some
translators updated foo.po in a wrong way, so they translated obsolete
messages, we want to prevent this, of course.

Use i18n_status and ViewCVS to see the live translation status of
Krusader!
http://krusader.sourceforge.net/i18n.php
http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/krusader/krusader_trinity/po/
The latest news about the Krusader translations will be in the LATEST
NEWS section of the "Krusader translation howto".

New translations
----------------
If your native language is not listed in VIEWCVS, you will have to
translate Krusader for your language. Dirk Eschler is the Krusader
i18n coordinator, please contact him if you intend to translate Krusader
to your native language.

Krusader translation howto
--------------------------
We have a very detailed "Krusader Translation HowTo" if you need some
help. The latest news about the Krusader translations is in the
LATEST NEWS section. This allows that even beginners or non-programmers
can translate Krusader to their native language. Please have a look at
http://krusader.sourceforge.net/phpBB/viewtopic.php?t=389

Quickstart procedure for translators updating existing translations
-------------------------------------------------------------------
1.
Run KDE in your native language.

2.
Checkout the latest available version of Krusader from CVS. Or if you
are not familiar with CVS, download the latest Krusader CVS snapshot
(nightly tarball) from http://krusader.sourceforge.net/cvs.php, and run:
$ make -f Makefile.cvs
$ ./configure
$ make
$ su -c "make install"

3.
Translate your foo.po with Kbabel.
Note: We will update all foo.po files just before the beta will be
released.

4.
Compile foo.po, for error checking (from the po directory):
$ msgfmt foo.po --statistics -c -v --output-file=foo.gmo
If it reports "xx fuzzy translations" or "xx untranslated messages",
please return to step 3.

5.
Run the commands of step 2 to reinstall the new or updated translation.
Run Krusader and test your native translations.
If necessary fix the foo.po file (redo steps 3-5).

6.
If everything is ok, send the updated translation to Dirk Eschler.


URL's
=====
- Homepage
  http://www.krusader.org
  http://krusader.sourceforge.net  
- Installation
  http://www.krusader.org/handbook/installation.html
- FAQ
  http://www.krusader.org/handbook/faq.html
- Documentation
  http://www.krusader.org/handbook/index.html
- Todolist
  http://www.krusader.org/phpBB/viewforum.php?f=10
- Buglist
  http://sourceforge.net/tracker/?atid=106488&group_id=6488&func=browse
- Forum
  http://www.krusader.org/phpBB/index.php
- ChangeLog
  http://www.krusader.org/text.php?t=cvs.changelog
- CVSNEWS
  http://www.krusader.org/text.php?t=cvs.news
- Mailing lists
  http://www.krusader.org/lists.php
- Donations
  http://sourceforge.net/project/project_donations.php?group_id=6488
- Translations
  http://www.krusader.org/i18n.php
- Help Krusader
  http://www.krusader.org/help.php
- Krusader Extensions
  http://www.kde-files.org/index.php?xcontentmode=660x661x662x663
- Krusader meets OpenUsability 
  http://openusability.org/projects/krusader/    
- Download pages
  http://www.krusader.org/down.php
  http://sourceforge.net/project/showfiles.php?group_id=6488


The Krusader Krew
==================
Krusader is developed by a dedicated team of individuals, known as the
Krusader Krew:
- Shie Erlich, author
  [erlich * users sourceforge net]
- Rafi Yanai, author
  [yanai * users sourceforge net]
- Dirk Eschler, webmaster and i18n coordinator
  [deschler * users sourceforge net]
- Csaba Karai, developer
  [ckarai * users sourceforge net]
- Heiner Eichmann, developer
  [h.eichmann * gmx de]
- Jonas Baehr, developer
  [jonas baehr * users web de]
- Frank Schoolmeesters, documentation and marketing coordinator
 [frank_schoolmeesters * yahoo com]
- Richard Holt, documentation
  [richard holt * gmail com]
- Matej Urbancic, Marketing & Product Research
  [matej * amis net]


Package Description
===================
Krusader is an advanced, twin-panel (commander-style) file-manager for
KDE and other desktops

Krusader is a simple, easy, powerful, twin-panel file manager 
(commander-style) for KDE and other *nix desktops, similar to Midnight
or Total Commander. It provides all the file management features you
could possibly want.

Plus: extensive Archive handling, mounted Filesystem support, FTP,
advanced Search module, viewer/Editor, directory Synchronization,
file content Comparisons, powerful batch Renaming and much, much more.

It supports a wide variety of archive formats and can handle other KIO
slaves such as smb or fish. It is (almost) completely customizable, very
user friendly, fast and looks great on your desktop!

You should give it a try.