svn commit: samba-docs r1253 - in trunk/manpages-3: .

[idra at samba.org]

Author: idra
Date: 2008-03-31 20:13:01 +0000 (Mon, 31 Mar 2008)
New Revision: 1253

WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba-docs&rev=1253

Log:

Better doc mount.cifs.

Original commit msg from Jeff:

This patch adds a section to the mount.cifs manpage to clarify how
mount.cifs treats delimiters and when it autoconverts them from one
type to another. It also has it state that the use of forward slash
as a delimiter is preferred and why.

Signed-off-by: Jeff Layton <jlayton at redhat.com>


Modified:
   trunk/manpages-3/mount.cifs.8.xml


Changeset:
Modified: trunk/manpages-3/mount.cifs.8.xml
===================================================================
--- trunk/manpages-3/mount.cifs.8.xml	2008-03-27 17:54:31 UTC (rev 1252)
+++ trunk/manpages-3/mount.cifs.8.xml	2008-03-31 20:13:01 UTC (rev 1253)
@@ -499,6 +499,17 @@
 </refsect1>
 
 <refsect1>
+	<title>SERVICE FORMATTING AND DELIMITERS</title>
+
+	<para>
+		It's generally preferred to use forward slashes (/) as a delimiter in service names. They are considered to be the "universal delimiter" since they are generally not allowed to be embedded within path components on Windows machines and the client can convert them to blackslashes (\) unconditionally. Conversely, backslash characters are allowed by POSIX to be part of a path component, and can't be automatically converted in the same way.
+	</para>
+	<para>
+		mount.cifs will attempt to convert backslashes to forward slashes where it's able to do so, but it cannot do so in any path component following the sharename.
+	</para>
+</refsect1>
+
+<refsect1>
 	<title>ENVIRONMENT VARIABLES</title>
 
 	<para>