Created attachment 329255 [details]
Proposed patch to reword description of "default case" in smb.conf(5)

Description of problem:

    In the section of smb.conf(5) that describes the "default case"
    parameter, the structure of the sentences and lack of punctuation
    leaves them open to a number of interpretations.

Version-Release number of selected component (if applicable):

    samba-3.0.28-0.el5.8
    samba-3.0.33-3.7.el5

How reproducible:

    Every time.

Steps to Reproduce:

    1. man smb.conf
    2. search for "default case"
    3. Read the paragraphs that follow
  
Actual results:

    Confusing description of the "default case" parameter.

Expected results:

    A clear description of the parameter which yields only one understanding.

Additional info:

    Suggested wording for this paragraph is as follows:

       default case = upper/lower
           controls what the default case is for new filenames
           (ie. files that don´t currently exist in the
           filesystem). Default _lower_. IMPORTANT NOTE: As part of
           the optimizations for directories containing large numbers
           of files, the following special case applies.  If the
           options _case_sensitive_=_yes_, _preserve_case_=_No_, and
           _short_preserve_case_=_No_ are set, then the case of _all_
           incoming client filenames, not just new filenames, will be
           modified.  See additional notes below.

    Patch attached for samba-3.0.33