some hints

README

@@ -37,6 +37,9 @@ Table of contents:
 For Debian, Ubuntu and other derivates you should use the debian package:
 	see http://systemausfall.org/toolforge/debian/
 
+Please follow the /usr/share/doc/cryptobox-server/README.Debian for
+any special steps regarding Debian.
+
 There are currently no official rpm packages of the CryptoBox.
 
 For source installation follow these steps:

README.samba

@@ -21,9 +21,10 @@ Reload the new samba configuration by calling:
 
 B) one share for each volume
 
-Copy the example event script /usr/share/doc/cryptobox-server/event-script/samba
-to /etc/cryptobox-server/events.d/samba. This event handler will add and remove
-shares whenever a volume is mounted or unmounted via the CryptoBox webinterface.
+Copy the example event script /usr/share/doc/cryptobox-server/event-scripts/samba
+to /etc/cryptobox-server/events.d/samba and make sure it is executable
+by root. This event handler will add and remove shares whenever a volume is mounted 
+or unmounted via the CryptoBox webinterface.
 
 Add the following line to your /etc/samba/smb.conf:
 	include = /var/cache/cryptobox-server/settings/misc/samba-include.conf

README.ssl

@@ -28,15 +28,21 @@ There are two ways for setting up a SSL connection:
 
 
 2) CryptoBox behind stunnel
-	If you do not have an ssl certificate yet, then you should create it first.
-	Please take a look into the "start_stunnel.sh" script. You may use it
-	to create a certificate and dig a tunnel.
+	You may want to tunnenl the traffic between the cryptobox-server
+	and your browser. "stunnel" is an excellent candidate for this job.
+
+	If you do not have an ssl certificate yet, then you should create
+	one first. On Debian: "apt-get install ssl-cert" and run the following
+	command (replace the <NAMES>; a default CERT_CONF is shipped with the cryptobox-server
+	package):
+
+		make-ssl-cert <CERT_CONF> <CERT_FILE_NAME>
 
 	In case, that you already have a certificate just run this command:
 
-		stunnel -p "$YOUR_CERT_FILE" -r localhost:80 -d 443
+		stunnel -p <CERT_FILE_NAME> -r localhost:80 -d 443
 	
-	Maybe you should add this to your bootup scripts.
+	And maybe you want to add the last command to your bootup scripts.
 
 
 3) Problems with SSL detection?

debian/README.Debian

@@ -6,9 +6,11 @@ All settings named [Foo]->Bar are defined in this file.
 
 1) Configure startup and network settings in /etc/default/cryptobox-server.
 Set 'NO_START' to "0" if the CryptoBox should start at every bootup.
+Set the port on which the cryptobox-server should listen.
 
 2) Define [Main]->AllowedDevices according to the devices that you want to
-publish via the cryptobox webinterface.
+publish via the cryptobox webinterface. Be careful this drives may be
+overwritten by front-end users!
 
 3) Choose a list of plugins to disable in [Main]->DisabledPlugins.
 

debian/cryptobox-server.default

@@ -9,6 +9,7 @@ NO_START=1
 RUNAS=cryptobox
 
 # listening port
+# for now please use a port above 1024
 PORT=8080
 
 # some more server options (rarely necessary)