ADDO - execute a command or file with elevated permissions
=============================================================================
                                                                  *Readme.txt*

CONTENTS *

    |01| License
    |02| Usage
    |03| Examples

         |03_01| Chaining Commands
         |03_02| Using ADDO within autorun.inf

    |04| Compatability
    |06| Compiling
    |07| Contributing
    |08| Credits
    |09| Thanks

LICENSE *01*

    Copyright (C) 2007  John Elkins   ~
>

    This program is free software: you can redistribute it and/or modify it
    under the terms of the GNU General Public License as published by the Free
    Software Foundation, either version 3 of the License, or (at your option)
    any later version.
<
    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
    or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
    |License.txt| for more details.
>
    You should have received a copy of the GNU General Public License along
    with this program. If not, see .
<

    NOTE: You are not required to accept the GNU General Public License in
    order to receive or run a copy of this program.  However, you must accept
    and abide by the GNU General Public License if you choose to modify or
    propigate this program.


USAGE *02* 

    ADDO [OPTION]... command/file

    Input Options:~

    /|w|                Wait for the command to complete.
    /|a|:       Perform an action.
    /|s|:         Specify how an application is to be shown.
    /|d|:    Name of the working directory.
     
    Informative Output Options:~

    /|i|    Display runtime and debug information.
    /|?|    Display help.
    /|v|    Display version information.

    PERFORM AN ACTION SPECIFIED BY A VERB *a*

        By default the 'runas' verb is used.  Other valid verbs include 'open'
        and 'explore'.  Verbs are passed directly to the ShellExecEx function
        so additional verbs such as 'print' and 'edit' may also work. >

        /a:open
        /a:runas
        /a:explore
<

    SPECIFY HOW AN APPLICATION IS TO BE SHOWN *s*

        By default the application is shown normally. The application can also
        be shown hidden, minimized, or maximized. >
        
        /s:hide     Hidden
        /s:min      Minimized
        /s:max      Maximized
<
     
    NAME OF THE WORKING DIRECTORY *d*

        By default the current working directory is used. The string '%0' can
        be used to refer to the directory in which the ADDO executable
        resides. >
        
        /d:%0       The directory in which ADDO resides


EXAMPLES *03*
    
    CHAINING COMMANDS *03_01*

        Pass a chain of commands to addo by escaping each ampersand with a
        caret. >

        C:\> addo echo hello ^&^& echo there
<

    USING ADDO WITHIN AUTORUN *03_02*

        When placed on the root of the drive and passed the /d:%0
        parameter addo can be used within an autorun.inf file to launch
        non executable files and scripts located on the drive.

        Example autorun.inf: >
            
        [autorun]
        
        shell\configure = &Configure
        shell\configure\command =addo /a:open /d:%0 Configure.vbs


COMPATABILITY *04* 

    ADDO has been successfully tested on the following platforms:

    Hardware: ~
    - x86 Intel IA-32 / i386
    - x64 Intel EM64T, AMD64, x64, x86-64

    Software: ~
    - Windows XP
    - Windows Vista

    ADDO doesn't work on ??? and has been untested on ???


COMPILING *05* 

    The source code is provided in the zip file. No documentation is provided
    other than the comments found within the source and this Readme.

    The original public release was built using the GNU c++ compiler and
    associated tools under the 'cygwin' environment using the -mno-cygwin and
    -mwindows machine options.  The included |Makefile| will build the
    executable under the 'cygwin' environment.


CONTRIBUTING *06* 

    The |Todo.txt| file contains a list of things to do.

    Mercurial source control management is used to track  changes.  Submit
    contributions to |soulfx|.


CREDITS *07* 

    - John *soulfx* Elkins 


THANKS *08*  

    - Love for mercy and kindness
    - Bram Moolenaar for VIM
    - Steve Hall and Contributers for Cream

=============================================================================
VIM OPTIONS *vim-options*

    vim:ft=help:fdm=expr:nowrap
    vim:foldexpr=getline(v\:lnum+1)=~'^[^\ ][A-Z\ ]\\+\\s\\*.\\+\\*'?'0'\:getline(v\:lnum+1)=~'\\u\\+\\s\\*.\\+\\*'?'1'\:getline(v\:lnum)=~'^[^\ ][A-Z\ ]\\+\\s\\*.\\+\\*'?'>1'\:getline(v\:lnum)=~'\\u\\+\\s\\*.\\+\\*'?'>2'\:'='
    vim:foldtext=substitute(v\:folddashes.substitute(getline(v\:foldstart),'\\s*\\*.*',"",""),'^-\\+','','')

    Source: geocities.com/soulfx/addo

               ( geocities.com/soulfx)