Smb4K README (version 0.5.0)
============================

Smb4K is an SMB/CIFS share browser for KDE. It uses the Samba software suite to 
access the SMB/CIFS shares of the local network neighborhood. Its purpose is to 
provide a program that's easy to use and has as many features as possible.

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

- Scanning for (active) workgroups, hosts, and shares
- Mounting and unmounting of SMB/CIFS shares, including unmounting all shares 
  at once
- Access to the files of a mounted SMB/CIFS share using Konqueror
- Auto-detection of external mounts/unmounts
- Mounting of recently used shares on start-up
- Miscellaneous infos about the SMB/CIFS shares
- Network search
- WINS server support
- Preview of SMB/CIFS 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), Czech, Chinese Simplified, 
French, German, Hungarian, Italian, Japanese, Norwegian (Bookmal + Nynorsk),
Polish, (Russian), Slovak, Spanish, Swedish, Turkish, Ukrainian
  
Supported operating systems:
----------------------------

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

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

This 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 or sudo - Programs to allow general users to do superuser things
  [ftp://ftp.ucolick.org/pub/users/will/ or http://www.sudo.ws/sudo/]
- 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 to 
http://developer.berlios.de/bugs/?group_id=769, if you find a problem. Please 
do not forget to include the version of Smb4K, if you are running Linux or 
FreeBSD and which distribution (Linux) you are using.

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 -P smb4k
When prompted for a password, simply press the Enter key. 
