Str Header (UseFunc Example) Readme
===================================

This header is an example of usage of a simple header with
UseFunc. This header only contains one function called
StrCase. This function can be found in the wiki:
nsis.sf.net/wiki/StrCase.

1. How to use the Str header
------------------------------

  1.1 For Users
  -------------

      1.1.1 Functions Reference
      ---------------------------

        1.1.1.1 ${StrCase} "ResultVar" "String" "Case"
        -----------------------------------------------------

          Requires: LogicLib and System plugin.

          This function converts a string to a specified case. 


          ResultVar

            Variable where the transformed String by the Case parameter is returned. 

          String

            String to transform into Case case. 

          Case

            Case type to transform String. The following are supported:

            empty value
              Original Case (same as String). 
            L
              Lower Case. 
            U
              Upper Case. 
            T
              Title Case. 
            S
              Sentence Case. 
            <>
              Switch Case. 

          Example:

          ${StrCase} $0 "This is just an example" "T"
          $0 = "This Is Just An Example"

2. Versions History
-------------------

1.0 - 10/Aug/2005

- First version.

3. Credits
----------

  - Str header for UseFunc created by deguix.
  - StrCase created by deguix. It is based on functions by eccles.

4. License
----------

  This header file is provided 'as-is', without any express or implied
  warranty. In no event will the author be held liable for any damages
  arising from the use of this header file.

  Permission is granted to anyone to use this header file for any purpose,
  including commercial applications, and to alter it and redistribute
  it freely, subject to the following restrictions:

  1. The origin of this header file must not be misrepresented;
     you must not claim that you wrote the original header file.
     If you use this header file in a product, an acknowledgment in the
     product documentation would be appreciated but is not required.
  2. Altered versions must be plainly marked as such,
     and must not be misrepresented as being the original header file.
  3. This notice may not be removed or altered from any distribution.