X-Git-Url: http://git.samba.org/?p=samba.git;a=blobdiff_plain;f=docs%2FINSTALL.txt;h=a97d5f26790c49f8eb54ed60b175334dc29330c5;hp=d9d85a2008e3f5554e636d1dad8fa3bb84252028;hb=5828b37ded0844ad337bc5a5f4e5534a87d65c0f;hpb=b1bddd39c732ba011c9a8a111a0f5e08e42e7a40

diff --git a/docs/INSTALL.txt b/docs/INSTALL.txt
index d9d85a2008e..a97d5f26790 100644
--- a/docs/INSTALL.txt
+++ b/docs/INSTALL.txt
@@ -1,5 +1,9 @@
-HOW TO INSTALL AND TEST SAMBA
-=============================
+Contributor:	Andrew Tridgell <samba-bugs@samba.anu.edu.au>
+Date:		Unknown
+Status:		Current
+
+Subject:	HOW TO INSTALL AND TEST SAMBA
+===============================================================================
 
 
 STEP 0. Read the man pages. They contain lots of useful info that will
@@ -8,6 +12,10 @@ try something like:
 
 	nroff -man smbd.8 | more
 
+Unfortunately, having said this, the man pages are sadly out of date and
+really need more effort to maintain them. Other sources of information 
+are pointed to by the Samba web site, http://samba.canberra.edu.au/pub/samba.
+
 STEP 1. Building the binaries
 
 To do this, first edit the file source/Makefile. You will find that
@@ -49,10 +57,11 @@ options.
 
 The simplest useful configuration file would be something like this:
 
-[homes]
-	workgroup = MYGROUP
-	guest ok = no
-	read only = no
+   workgroup = MYGROUP
+
+   [homes]
+      guest ok = no
+      read only = no
 
 which would allow connections by anyone with an account on the server,
 using either their login name or "homes" as the service name. (Note
@@ -143,6 +152,8 @@ You can then run startsmb by hand or execute it from /etc/rc.local
 
 To kill it send a kill signal to the processes nmbd and smbd.
 
+NOTE: If you use the SVR4 style init system then you may like to look
+at the examples/svr4-startup script to make Samba fit into that system.
 
 
 STEP 7. Try listing the shares available on your server
@@ -228,8 +239,9 @@ CHOOSING THE PROTOCOL LEVEL
 The SMB protocol has many dialects. Currently Samba supports 5, called
 CORE, COREPLUS, LANMAN1, LANMAN2 and NT1.
 
-You can choose what protocols to support in the smb.conf file. The
-default is NT1 and that is the best for the vast majority of sites.
+You can choose what maximum protocol to support in the smb.conf
+file. The default is NT1 and that is the best for the vast majority of
+sites.
 
 In older versions of Samba you may have found it necessary to use
 COREPLUS. The limitations that led to this have mostly been fixed. It
@@ -308,7 +320,9 @@ compatability modes called DENY_FCB and DENY_DOS.
 
 You can disable share modes using "share modes = no". This may be
 useful on a heavily loaded server as the share modes code is very
-slow. 
+slow. See also the FAST_SHARE_MODES option in the Makefile for a way
+to do full share modes very fast using shared memory (if your OS
+supports it).
 
 
 MAPPING USERNAMES
@@ -317,3 +331,12 @@ MAPPING USERNAMES
 If you have different usernames on the PCs and the unix server then
 take a look at the "username map" option. See the smb.conf man page
 for details.
+
+
+OTHER CHARACTER SETS
+====================
+
+If you have problems using filenames with accented characters in them
+(like the German, French or Scandinavian character sets) then I
+recommmend you look at the "valid chars" option in smb.conf and also
+take a look at the validchars package in the examples directory.