From a384176cb93ab5b3db56675674bf7b0d4778ecec Mon Sep 17 00:00:00 2001 From: Alexander Bokovoy Date: Wed, 9 Apr 2003 14:38:24 +0000 Subject: Next batch of conversions: File names. Fixed some wrong context marks (most of "hide ..." parameters are per-share) (This used to be commit 0f8d5b210a60a40f95a43daf06d3d8686985ecd1) --- docs/docbook/smbdotconf/filename/casesensitive.xml | 14 +++--- docs/docbook/smbdotconf/filename/casesignames.xml | 13 +++-- docs/docbook/smbdotconf/filename/defaultcase.xml | 18 ++++--- .../smbdotconf/filename/deletevetofiles.xml | 45 +++++++++-------- docs/docbook/smbdotconf/filename/hidedotfiles.xml | 15 +++--- docs/docbook/smbdotconf/filename/hidefiles.xml | 58 ++++++++++++---------- .../smbdotconf/filename/hidespecialfiles.xml | 20 ++++---- .../docbook/smbdotconf/filename/hideunreadable.xml | 16 +++--- .../smbdotconf/filename/hideunwriteablefiles.xml | 20 ++++---- docs/docbook/smbdotconf/filename/manglecase.xml | 15 +++--- docs/docbook/smbdotconf/filename/mangledstack.xml | 42 +++++++++------- docs/docbook/smbdotconf/filename/mangleprefix.xml | 27 ++++++---- docs/docbook/smbdotconf/filename/manglingchar.xml | 23 +++++---- .../docbook/smbdotconf/filename/manglingmethod.xml | 33 ++++++------ docs/docbook/smbdotconf/filename/preservecase.xml | 23 +++++---- .../smbdotconf/filename/shortpreservecase.xml | 29 +++++------ docs/docbook/smbdotconf/filename/stripdot.xml | 19 ++++--- 17 files changed, 238 insertions(+), 192 deletions(-) (limited to 'docs/docbook') diff --git a/docs/docbook/smbdotconf/filename/casesensitive.xml b/docs/docbook/smbdotconf/filename/casesensitive.xml index 622aea329e..94b20d6c0c 100644 --- a/docs/docbook/smbdotconf/filename/casesensitive.xml +++ b/docs/docbook/smbdotconf/filename/casesensitive.xml @@ -1,7 +1,9 @@ - - case sensitive (S) - See the discussion in the section NAME MANGLING. + + + See the discussion in the section NAME MANGLING. - Default: case sensitive = no - - + Default: case sensitive = no + + diff --git a/docs/docbook/smbdotconf/filename/casesignames.xml b/docs/docbook/smbdotconf/filename/casesignames.xml index 94bcb85984..3254b545c5 100644 --- a/docs/docbook/smbdotconf/filename/casesignames.xml +++ b/docs/docbook/smbdotconf/filename/casesignames.xml @@ -1,5 +1,8 @@ - - casesignames (S) - Synonym for case - sensitive. - + + + Synonym for case sensitive. + + diff --git a/docs/docbook/smbdotconf/filename/defaultcase.xml b/docs/docbook/smbdotconf/filename/defaultcase.xml index f2bdf5db1c..de3ad35c0c 100644 --- a/docs/docbook/smbdotconf/filename/defaultcase.xml +++ b/docs/docbook/smbdotconf/filename/defaultcase.xml @@ -1,9 +1,11 @@ - - default case (S) - See the section on - NAME MANGLING. Also note the - short preserve case parameter. + + + See the section on + NAME MANGLING. Also note the + short preserve case parameter. - Default: default case = lower - - + Default: default case = lower + + diff --git a/docs/docbook/smbdotconf/filename/deletevetofiles.xml b/docs/docbook/smbdotconf/filename/deletevetofiles.xml index 49a5e2232f..c851824b7e 100644 --- a/docs/docbook/smbdotconf/filename/deletevetofiles.xml +++ b/docs/docbook/smbdotconf/filename/deletevetofiles.xml @@ -1,25 +1,28 @@ - - delete veto files (S) - This option is used when Samba is attempting to - delete a directory that contains one or more vetoed directories - (see the veto files - option). If this option is set to no (the default) then if a vetoed - directory contains any non-vetoed files or directories then the - directory delete will fail. This is usually what you want. + + + This option is used when Samba is attempting to + delete a directory that contains one or more vetoed directories + (see the veto files + option). If this option is set to no (the default) then if a vetoed + directory contains any non-vetoed files or directories then the + directory delete will fail. This is usually what you want. - If this option is set to yes, then Samba - will attempt to recursively delete any files and directories within - the vetoed directory. This can be useful for integration with file - serving systems such as NetAtalk which create meta-files within - directories you might normally veto DOS/Windows users from seeing - (e.g. .AppleDouble) + If this option is set to yes, then Samba + will attempt to recursively delete any files and directories within + the vetoed directory. This can be useful for integration with file + serving systems such as NetAtalk which create meta-files within + directories you might normally veto DOS/Windows users from seeing + (e.g. .AppleDouble) - Setting delete veto files = yes allows these - directories to be transparently deleted when the parent directory - is deleted (so long as the user has permissions to do so). + Setting delete veto files = yes allows these + directories to be transparently deleted when the parent directory + is deleted (so long as the user has permissions to do so). - See also the veto - files parameter. + See also the veto + files parameter. - Default: delete veto files = no - + Default: delete veto files = no + + diff --git a/docs/docbook/smbdotconf/filename/hidedotfiles.xml b/docs/docbook/smbdotconf/filename/hidedotfiles.xml index 63e87d8059..1728f01f8f 100644 --- a/docs/docbook/smbdotconf/filename/hidedotfiles.xml +++ b/docs/docbook/smbdotconf/filename/hidedotfiles.xml @@ -1,7 +1,10 @@ - - hide dot files (S) - This is a boolean parameter that controls whether - files starting with a dot appear as hidden files. + + + This is a boolean parameter that controls whether + files starting with a dot appear as hidden files. - Default: hide dot files = yes - + Default: hide dot files = yes + + diff --git a/docs/docbook/smbdotconf/filename/hidefiles.xml b/docs/docbook/smbdotconf/filename/hidefiles.xml index 6f93a2a239..b687fc5a1f 100644 --- a/docs/docbook/smbdotconf/filename/hidefiles.xml +++ b/docs/docbook/smbdotconf/filename/hidefiles.xml @@ -1,35 +1,39 @@ - - hide files(S) - This is a list of files or directories that are not - visible but are accessible. The DOS 'hidden' attribute is applied - to any files or directories that match. + + + This is a list of files or directories that are not + visible but are accessible. The DOS 'hidden' attribute is applied + to any files or directories that match. - Each entry in the list must be separated by a '/', - which allows spaces to be included in the entry. '*' - and '?' can be used to specify multiple files or directories - as in DOS wildcards. + Each entry in the list must be separated by a '/', + which allows spaces to be included in the entry. '*' + and '?' can be used to specify multiple files or directories + as in DOS wildcards. - Each entry must be a Unix path, not a DOS path and must - not include the Unix directory separator '/'. + Each entry must be a Unix path, not a DOS path and must + not include the Unix directory separator '/'. - Note that the case sensitivity option is applicable - in hiding files. + Note that the case sensitivity option is applicable + in hiding files. - Setting this parameter will affect the performance of Samba, - as it will be forced to check all files and directories for a match - as they are scanned. + Setting this parameter will affect the performance of Samba, + as it will be forced to check all files and directories for a match + as they are scanned. - See also hide - dot files, - veto files and - case sensitive. + See also hide + dot files, + veto files and + case sensitive. - Default: no file are hidden - Example: hide files = + Default: no file are hidden + + Example: hide files = /.*/DesktopFolderDB/TrashFor%m/resource.frk/ - The above example is based on files that the Macintosh - SMB client (DAVE) available from - Thursby creates for internal use, and also still hides - all files beginning with a dot. - + The above example is based on files that the Macintosh + SMB client (DAVE) available from + Thursby creates for internal use, and also still hides + all files beginning with a dot. + + diff --git a/docs/docbook/smbdotconf/filename/hidespecialfiles.xml b/docs/docbook/smbdotconf/filename/hidespecialfiles.xml index 9a8c206097..815e8ea63c 100644 --- a/docs/docbook/smbdotconf/filename/hidespecialfiles.xml +++ b/docs/docbook/smbdotconf/filename/hidespecialfiles.xml @@ -1,10 +1,12 @@ - - hide special files (G) - This parameter prevents clients from seeing - special files such as sockets, devices and fifo's in directory - listings. - + + + This parameter prevents clients from seeing + special files such as sockets, devices and fifo's in directory + listings. + - Default: hide special files = no - - + Default: hide special files = no + + diff --git a/docs/docbook/smbdotconf/filename/hideunreadable.xml b/docs/docbook/smbdotconf/filename/hideunreadable.xml index d25153f103..f34a3a597d 100644 --- a/docs/docbook/smbdotconf/filename/hideunreadable.xml +++ b/docs/docbook/smbdotconf/filename/hideunreadable.xml @@ -1,8 +1,10 @@ - - hide unreadable (G) - This parameter prevents clients from seeing the - existance of files that cannot be read. Defaults to off. + + + This parameter prevents clients from seeing the + existance of files that cannot be read. Defaults to off. - Default: hide unreadable = no - - + Default: hide unreadable = no + + diff --git a/docs/docbook/smbdotconf/filename/hideunwriteablefiles.xml b/docs/docbook/smbdotconf/filename/hideunwriteablefiles.xml index 9e28e8de5c..7d20296ff2 100644 --- a/docs/docbook/smbdotconf/filename/hideunwriteablefiles.xml +++ b/docs/docbook/smbdotconf/filename/hideunwriteablefiles.xml @@ -1,10 +1,12 @@ - - hide unwriteable files (G) - This parameter prevents clients from seeing - the existance of files that cannot be written to. Defaults to off. - Note that unwriteable directories are shown as usual. - + + + This parameter prevents clients from seeing + the existance of files that cannot be written to. Defaults to off. + Note that unwriteable directories are shown as usual. + - Default: hide unwriteable = no - - + Default: hide unwriteable = no + + diff --git a/docs/docbook/smbdotconf/filename/manglecase.xml b/docs/docbook/smbdotconf/filename/manglecase.xml index 170d77d453..d514375c3b 100644 --- a/docs/docbook/smbdotconf/filename/manglecase.xml +++ b/docs/docbook/smbdotconf/filename/manglecase.xml @@ -1,8 +1,9 @@ - - mangle case (S) - See the section on - NAME MANGLING + + + See the section on NAME MANGLING - Default: mangle case = no - - + Default: mangle case = no + + diff --git a/docs/docbook/smbdotconf/filename/mangledstack.xml b/docs/docbook/smbdotconf/filename/mangledstack.xml index 3e6099ba92..42083d13a2 100644 --- a/docs/docbook/smbdotconf/filename/mangledstack.xml +++ b/docs/docbook/smbdotconf/filename/mangledstack.xml @@ -1,23 +1,27 @@ - - mangled stack (G) - This parameter controls the number of mangled names - that should be cached in the Samba server smbd - 8. + + + This parameter controls the number of mangled names + that should be cached in the Samba server smbd + 8. - This stack is a list of recently mangled base names - (extensions are only maintained if they are longer than 3 characters - or contains upper case characters). + This stack is a list of recently mangled base names + (extensions are only maintained if they are longer than 3 characters + or contains upper case characters). - The larger this value, the more likely it is that mangled - names can be successfully converted to correct long UNIX names. - However, large stack sizes will slow most directory accesses. Smaller - stacks save memory in the server (each stack element costs 256 bytes). - + The larger this value, the more likely it is that mangled + names can be successfully converted to correct long UNIX names. + However, large stack sizes will slow most directory accesses. Smaller + stacks save memory in the server (each stack element costs 256 bytes). + - It is not possible to absolutely guarantee correct long - filenames, so be prepared for some surprises! + It is not possible to absolutely guarantee correct long + filenames, so be prepared for some surprises! - Default: mangled stack = 50 - Example: mangled stack = 100 - - + Default: mangled stack = 50 + + Example: mangled stack = 100 + + diff --git a/docs/docbook/smbdotconf/filename/mangleprefix.xml b/docs/docbook/smbdotconf/filename/mangleprefix.xml index 7dfd46199c..5476ed1f08 100644 --- a/docs/docbook/smbdotconf/filename/mangleprefix.xml +++ b/docs/docbook/smbdotconf/filename/mangleprefix.xml @@ -1,11 +1,16 @@ - - mangle prefix (G) - controls the number of prefix - characters from the original name used when generating - the mangled names. A larger value will give a weaker - hash and therefore more name collisions. The minimum - value is 1 and the maximum value is 6. - Default: mangle prefix = 1 - Example: mangle prefix = 4 - - + + + controls the number of prefix + characters from the original name used when generating + the mangled names. A larger value will give a weaker + hash and therefore more name collisions. The minimum + value is 1 and the maximum value is 6. + + Default: mangle prefix = 1 + + Example: mangle prefix = 4 + + diff --git a/docs/docbook/smbdotconf/filename/manglingchar.xml b/docs/docbook/smbdotconf/filename/manglingchar.xml index e6a9050466..57c4fa2acd 100644 --- a/docs/docbook/smbdotconf/filename/manglingchar.xml +++ b/docs/docbook/smbdotconf/filename/manglingchar.xml @@ -1,11 +1,14 @@ - - mangling char (S) - This controls what character is used as - the magic character in name mangling. The default is a '~' - but this may interfere with some software. Use this option to set - it to whatever you prefer. + + + This controls what character is used as + the magic character in name mangling. The + default is a '~' but this may interfere with some software. Use this option to set + it to whatever you prefer. - Default: mangling char = ~ - Example: mangling char = ^ - - + Default: mangling char = ~ + + Example: mangling char = ^ + + diff --git a/docs/docbook/smbdotconf/filename/manglingmethod.xml b/docs/docbook/smbdotconf/filename/manglingmethod.xml index 11f9e9eb01..74366483bd 100644 --- a/docs/docbook/smbdotconf/filename/manglingmethod.xml +++ b/docs/docbook/smbdotconf/filename/manglingmethod.xml @@ -1,14 +1,19 @@ - - mangling method (G) - controls the algorithm used for the generating - the mangled names. Can take two different values, "hash" and - "hash2". "hash" is the default and is the algorithm that has been - used in Samba for many years. "hash2" is a newer and considered - a better algorithm (generates less collisions) in the names. - However, many Win32 applications store the mangled names and so - changing to the new algorithm must not be done - lightly as these applications may break unless reinstalled. - Default: mangling method = hash2 - Example: mangling method = hash - - + + + controls the algorithm used for the generating + the mangled names. Can take two different values, "hash" and + "hash2". "hash" is the default and is the algorithm that has been + used in Samba for many years. "hash2" is a newer and considered + a better algorithm (generates less collisions) in the names. + However, many Win32 applications store the mangled names and so + changing to the new algorithm must not be done + lightly as these applications may break unless reinstalled. + + Default: mangling method = hash2 + + Example: mangling method = hash + + diff --git a/docs/docbook/smbdotconf/filename/preservecase.xml b/docs/docbook/smbdotconf/filename/preservecase.xml index 3be458ce15..d8a4e2342d 100644 --- a/docs/docbook/smbdotconf/filename/preservecase.xml +++ b/docs/docbook/smbdotconf/filename/preservecase.xml @@ -1,13 +1,14 @@ - - preserve case (S) - This controls if new filenames are created - with the case that the client passes, or if they are forced to - be the default case - . + + + This controls if new filenames are created + with the case that the client passes, or if they are forced to + be the default case + . - Default: preserve case = yes + Default: preserve case = yes - See the section on NAME - MANGLING for a fuller discussion. - - + See the section on NAME MANGLING for a fuller discussion. + + diff --git a/docs/docbook/smbdotconf/filename/shortpreservecase.xml b/docs/docbook/smbdotconf/filename/shortpreservecase.xml index 1c8b36380d..52c93e1370 100644 --- a/docs/docbook/smbdotconf/filename/shortpreservecase.xml +++ b/docs/docbook/smbdotconf/filename/shortpreservecase.xml @@ -1,16 +1,17 @@ - - short preserve case (S) - This boolean parameter controls if new files - which conform to 8.3 syntax, that is all in upper case and of - suitable length, are created upper case, or if they are forced - to be the default case - . This option can be use with preserve case = yes - to permit long filenames to retain their case, while short - names are lowered. + + + This boolean parameter controls if new files + which conform to 8.3 syntax, that is all in upper case and of + suitable length, are created upper case, or if they are forced + to be the default case + . This option can be use with preserve case = yes + to permit long filenames to retain their case, while short + names are lowered. - See the section on - NAME MANGLING. + See the section on NAME MANGLING. - Default: short preserve case = yes - - + Default: short preserve case = yes + + diff --git a/docs/docbook/smbdotconf/filename/stripdot.xml b/docs/docbook/smbdotconf/filename/stripdot.xml index ff877144a6..afed63a12b 100644 --- a/docs/docbook/smbdotconf/filename/stripdot.xml +++ b/docs/docbook/smbdotconf/filename/stripdot.xml @@ -1,9 +1,12 @@ - - strip dot (G) - This is a boolean that controls whether to - strip trailing dots off UNIX filenames. This helps with some - CDROMs that have filenames ending in a single dot. + + + This is a boolean that controls whether to + strip trailing dots off UNIX filenames. This helps with some + CDROMs that have filenames ending in a single dot. - Default: strip dot = no - - + Default: strip dot = no + + -- cgit