Moving docs tree to docs-xml to make room for generated docs in the release tarball.
[ira/wip.git] / docs-xml / smbdotconf / filename / mangledmap.xml
1 <samba:parameter name="mangled map"
2                                  type="string"
3                  context="S"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5 <description>
6         <para>
7         This is for those who want to directly map UNIX file names which cannot be represented on 
8         Windows/DOS.  The mangling of names is not always what is needed.  In particular you may have 
9         documents with file extensions that differ between DOS and UNIX. 
10         For example, under UNIX it is common to use <filename moreinfo="none">.html</filename> 
11         for HTML files, whereas under Windows/DOS <filename moreinfo="none">.htm</filename> 
12         is more commonly used.
13         </para>
14
15         <para>
16         So to map <filename moreinfo="none">html</filename> to <filename moreinfo="none">htm</filename> 
17         you would use:
18         </para>
19                 
20         <para>
21         <smbconfoption name="mangled map">(*.html *.htm)</smbconfoption>.
22         </para>
23
24         <para>
25         One very useful case is to remove the annoying <filename moreinfo="none">;1</filename> off 
26         the ends of filenames on some CDROMs (only visible under some UNIXes). To do this use a map of 
27         (*;1 *;).
28         </para>
29 </description>
30
31 <value type="default"><comment>no mangled map</comment></value>
32 <value type="example">(*;1 *;)</value>
33 </samba:parameter>