home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / dirdg10.zip / ReadMe.1st < prev   
Text File  |  1994-08-21  |  3KB  |  79 lines
  1. This is DirDialog V1.0. (C) 1994 by Ralf G. R. Bergs
  2.  
  3. E-mail:     rabe@pool.informatik.rwth-aachen.de
  4. Snail mail: Hueckeswagener Str. 42, 51647 Gummersbach, FR of Germany
  5. Phone/fax:  +49 2261 21968
  6.  
  7.  
  8. Purpose:
  9. ========
  10. DirDialg() is a dialog similar to the system file dialog. In contrast
  11. to the latter it is NOT used to select individual files, but a directory
  12. from a list.
  13.  
  14.  
  15. "Foreword:"
  16. ===========
  17. This is one of the first little programs I created with VX-REXX (in
  18. fact, created with REXX at all). Therefore please be gentle with me. ;-)
  19. Of course, comments, suggestions (especially how to improve the speed
  20. of the "VRDir" stuff used to fill the directory list with directory
  21. names), bug reports (or even patches!) are highly appreciated.
  22.  
  23. I used VX-REXX version 2.0 patchlevel B to develop this, but I guess it
  24. could work with 1.x too. (If someone verifies this, please TELL ME
  25. about it!)
  26.  
  27. There's a little "demo program" that runs "DirDialog" and displays
  28. the selected directory on exit in a console window. To run DEMO.EXE,
  29. you need the VX-REXX runtime library VROBJ.DLL.
  30.  
  31. * BTW, "DirDialog" is postcard-ware. If you use it in an application that *
  32. * is NOT only used by yourself (i.e. if you distribute it to others),     *
  33. * you MUST register it. To register, please send me a postcard of your    *
  34. * home town, or my lawyers will sue you. (Nah, just kiddin' ;-)           *
  35.  
  36.  
  37. Installation:
  38. ============
  39. To install, just add the line
  40.  
  41.     VRX: DirDialg.VRX
  42.  
  43. to your projects .VRP file, below the other "VRX:" lines. That's all!
  44.  
  45.  
  46. Usage:
  47. =====
  48.  
  49. dir = DirDialg( VRWindow(), caption, startdir )
  50.  
  51.     caption:  the dialog window's title (default: "Select a directory")
  52.     startdir: the directory initially displayed when you call DirDialg()
  53.                 (default: the current working directory at the time your
  54.                 application was started)
  55.     dir:      either a directory you selected or "" if you pressed
  56.                 "Cancel."
  57.  
  58.  
  59. License:
  60. =======
  61. "This library is free software; you can redistribute it and/or
  62. modify it under the terms of the GNU Library General Public
  63. License as published by the Free Software Foundation; either
  64. version 2 of the License, or (at your option) any later version.
  65.  
  66. This library is distributed in the hope that it will be useful,
  67. but WITHOUT ANY WARRANTY; without even the implied warranty of
  68. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  69. Library General Public License for more details.
  70.  
  71. You should have received a copy of the GNU Library General Public
  72. License along with this library; if not, write to the Free
  73. Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA."
  74.  
  75.  
  76. History:
  77. =======
  78. 08/21/94    First public release V1.0
  79.