Bug 480405

Summary: 'default case' parameter description in smb.conf(5) is confusing
Product: Red Hat Enterprise Linux 5 Reporter: Bryan Mason <bmason>
Component: samba3xAssignee: Guenther Deschner <gdeschner>
Status: CLOSED ERRATA QA Contact: qe-baseos-daemons
Severity: low Docs Contact:
Priority: low    
Version: 5.2CC: azelinka, dpal, gdeschner
Target Milestone: rc   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: samba3x-3.3.12-0.55.el5 Doc Type: Bug Fix
Doc Text:
The smb.conf manual page contained an ambiguous description of the 'default case' parameter. With this update, the description is updated and gives a clear description.
Story Points: ---
Clone Of:
: 639141 (view as bug list) Environment:
Last Closed: 2011-01-13 22:44:22 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 639141    
Attachments:
Description Flags
Proposed patch to reword description of "default case" in smb.conf(5) none

Description Bryan Mason 2009-01-16 21:06:32 UTC
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

Comment 6 Eva Kopalova 2010-12-15 07:54:28 UTC
    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
The smb.conf manual page contained an ambiguous description of the 'default case' parameter. With this update, the description is updated and gives a clear description.

Comment 8 errata-xmlrpc 2011-01-13 22:44:22 UTC
An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on therefore solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.

http://rhn.redhat.com/errata/RHBA-2011-0054.html