Smb4K README (version 0.4.1)
============================

Smb4K is an SMB share browser for KDE. Its aim is to provide a tool for an
easy access to the SMB shares of your local network neighborhood.

Features so far:
----------------

- Scanning for (active) workgroups, hosts, and shares
- Mounting and unmounting of SMB shares, including unmounting all shares at once
- Access to the files of a mounted SMB share using Konqueror
- Auto-detection of external mounts/unmounts
- Mounting of recently used shares on start-up
- Miscellaneous infos about the SMB shares
- Network search
- WINS server support
- Preview of SMB shares
- Selectable look-up and search methods
- Default login
- Ability to execute mount and umount SUID root
- Special handling of homes shares
- Ability to bookmark favorite shares
- System tray icon
- Support of advanced Samba options
- Experimental support of printer shares
- Translations: Brazilian Portuguese, Bulgarian, (Catalan), Chinese Simplified, 
  French, German, Hungarian, Italian, Japanese, Norwegian (Bookmal + Nynorsk),
  Polish, (Russian), Slovak, Spanish, Swedish, Ukrainian
  
Supported operating systems:
----------------------------

Smb4K supports Linux (kernel >= 2.2.x) and since version 0.4.1 also (>= 4.10-RELEASE, 
still experimental). Other operating systems haven't been tested.

Requirements:
-------------

The current stable version of Smb4K depends on the development files of the following 
libraries:
- KDE (>= 3.2.0): The powerful Open Source graphical desktop environment for Unix 
  workstations 
  [http://www.kde.org]
- Qt (>= 3.2.0): A multiplatform C++ application development framework.
  [http://www.trolltech.no]
- XFree86 or X.org - Freely redistributable implementations of the X Window System
  [http://www.xfree86.org or http://www.x.org]
- An implementation of the C library

Make sure that you also have installed all header files of the libraries Qt and KDE 
are depending on. Recent versions of automake and autoconf are also needed.

For a proper operation, you implicitly need:
- Support of the /proc filesystem compiled into your kernel if you are using Linux
- Samba (>= 2.2.x) - Tools to access to a server's filespace and printers via SMB
  [http://www.samba.org]
- grep - GNU grep 
  [http://www.gnu.org/directory/grep.html]
- GNU awk (GAWK) or similar - A pattern scanning and processing language.
  [http://www.gnu.org/directory/gawk.html]
- sed - The GNU stream editor 
  [http://www.gnu.org/directory/sed.html]
- findutils (xargs) - The GNU Find Utilities are the basic directory searching 
  utilities of the GNU operating system
  [http://www.gnu.org/directory/findutils.html]
- util-linux (mount, umount) - Miscellaneous system utilities
  [ftp://ftp.kernel.org/pub/linux/utils/util-linux]

To enable full functionality, you may also want to install these packages:
- super - Program to allow general users to do superuser things
  [ftp://ftp.ucolick.org/pub/users/will/]
- teTeX or similar (dvips) - A TeX distribution for Unix
  [http://tug.org/teTeX/]
- GNU enscript - A tool to convert ASCII files to PostScript
  [http://people.ssh.fi/mtr/genscript/]

Bugs
----
You are strongly encouraged to send a bug report, if you find a problem:
http://developer.berlios.de/bugs/?group_id=769

Copyright
---------
Smb4K is released under the terms of the GNU General Public License (GPL).
A copy of that license is available in the file COPYING.

Latest Version
--------------
You can always obtain the latest stable version of Smb4K from
http://smb4k.berlios.de.

From time to time the Smb4K team releases unstable code for testing purposes.
You can find it under ftp://ftp.berlios.de/pub/smb4k/testing.

You might want to check out the latest development code using anonymous CVS: 
 cvs -d:pserver:anonymous@cvs.smb4k.berlios.de:/cvsroot/smb4k login
 cvs -z3 -d:pserver:anonymous@cvs.smb4k.berlios.de:/cvsroot/smb4k co smb4k
When prompted for a password, simply press the Enter key. 
