home *** CD-ROM | disk | FTP | other *** search
- Program Arguments Library
- ~~~~~~~~~~~~~~~~~~~~~~~~~
- Copyright (C)1994 by Dianne Hackborn.
-
- BUGS:
-
- ------------------------------------------------------------------------
-
- PLANS:
-
- - Being able to add/remove ArgEntry structures after the ProgArgs structure
- has been initially allocated.
-
- - Multiple occurances of the same argument, ie 'LEFTEDGE' for a window
- may occur more than once if there are multiple windows being defined.
-
- - Reading and writing of MultiArgs in text files and tool types.
-
- - Special 'binary' argument type? This would be like a string, except the
- first ULONG would be the length of the data, and it would be saved in
- a more condensed than standard escaped strings are. [Perhaps some form
- of UU encoding.]
-
- - Support for multi-valued and flag arguments. Something like:
-
- "POSITION/V:LEFT=0|TOP=1|RIGHT=2|BOTTOM=BOT=3"
-
- You would then get either a pointer to string which is perhaps always
- one of the rightmost values, or an actual integer.
-
- - More sophisticated command line help [use the descriptions to
- construct more detailed help text.]
-
- - Additional argument control as described in AllocProgArgsA() autodocs.
-
- - Argument translation.
-
- - Writing icons with text file settings.
-
- ------------------------------------------------------------------------
-
- ISSUES:
-
- ------------------------------------------------------------------------
-
- VERSION INFORMATION:
-
- Version 1.2 / April 08, 1995 at 4:26AM (-28/-28 bytes) :
-
- Small bug fix in locking directories.
-
- Version 1.1 / April 07, 1995 at 5:05PM (-192/-192 bytes) :
-
- T:, ENV:, and ENVARC: are now only locked when needed.
-
- Version 1.0 / April 07, 1995 at 3:23PM (-64/-68 bytes) :
-
- Recompiled full library for release.
-
- Fixed Installer script to not crash when checking deferred assings.
- Thanks to Mikael Berglund for finding this bug.
-
- Version 0.12 / February 04, 1995 at 2:49PM (+0/+0 bytes) :
-
- And still more autodoc reformatting.
-
- Version 0.11 / February 04, 1995 at 1:43AM (+24/+28 bytes) :
-
- More reformatting of autodocs, due to popular demand. ;)
-
- Beta library now brings up info requester on first use.
-
- Version 0.10 / January 09, 1995 at 12:21AM (+796/+796 bytes) :
-
- Reformatted Autodocs.
-
- Added PADIR_TEMP, PADIR_PREFS, PADIR_PRESETS. These [and now
- PADIR_ENV, PADIR_ARC, PADIR_ENVARC] may fail when being switched
- to if they can't be locked.
-
- Added PA_TransHook and PA_TransObject.
-
- Version 0.8 / December 30, 1994 at 4:08AM (+104/+32 bytes) :
-
- Moved much of the header file documentation into the appropriate
- autodocs.
-
- Added AEFLAG_HEXNUM and parsing of $nnn, 0xnnn, %nnn numbers.
-
- Changed base value of argument tags to TAG_USER+0x10000, in
- anticipation of future support for argument entries with multiple
- values in the argument set.
-
- Version 0.7 / December 27, 1994 at 9:53AM (+112/+0 bytes) :
- Version 0.6 / December 27, 1994 at 2:42AM (-4/+108 bytes) :
-
- Library wasn't calling init constructors/destructors.
-
- Version 0.5 / December 27, 1994 at 12:54AM (-3936/-3936 bytes) :
-
- Removed unused debugging code from library.
-
- Renamed PA_AllComments from PA_CommentsOnly.
-
- Added PA_ForceWrite and made this TRUE by default.
-
- Version 0.4 / December 22, 1994 at 6:40PM (+356/+352 bytes) :
-
- Added installation tool.
-
- Added GetProgArgsA(), PA_GetArgEntry(), PA_NextArgEntry().
-
- Renamed the TagArgs functions to start with 'PA_'.
-
- Renamed RPA_* constants to REMARG_*
-
- RemTagArgsA() now uses the REMARG_* controls in ti_Data like
- RemProgArgsA().
-
- Version 0.3 / December 21, 1994 at 7:54PM (+100/+100 bytes) :
-
- Added PA_CommentsOnly.
-
- Version 0.2 / December 21, 1994 at 6:36PM (+976/+18856 bytes) :
-
- Implemented PADIR_ENVARC.
-
- Added PA_CreateDirs.
-
- Added PA_CreateIcon.
-
- Fixed handling of relative program name paths -- now only uses the last
- filename component only. It didn't use to work with relative paths,
- since we want to be able to find the file from the ProgramDir().
-
- Added check for a quoted program name.
-
- Version 0.1 / December 21, 1994 at 3:21PM :
-
- Added checks for empty command line.
-
- Version 0.0 / December 11, 1994 at 10:57PM (+17912 bytes) :
-
- Created from linked library.
-