readme.txt

使用于OS/2下的小工具的C源程序,使用于OS/2下的小工具的C源程序

                                                  [README.TXT]
                                    
                        Welcome to TOOLS/2.
                                    
                Copyright 1990-1992 Martti Ylikoski
                        All rights Reserved
     
     
     Genaral.
     
     TOOLS/2 is  a small  set of  tools for OS/2 and DOS. Most
     programs are dual mode programs - they can be run in both
     DOS and OS/2.
     
     TOOLS/2 is Freeware - Feel free to copy it to friends and
     colleques. I  require that  you copy  it  unmodified  and
     entirely (both disks) and don't request any fee for it. I
     grant to  right to  charge a  small fee for the copies of
     this package if you are:
          - a non-profit user group.
          - disk  vendor   approved  by   the  Association  of
          Shareware Professionals
          - have  written permission  from me  and it  has not
          been revoked
     and you  charge a  fee that  is less  than $10  per  disk
     (excluding shipping).
     
     I have  retained copyright  to this  package -  both  the
     source  code  and  accompanying  documentation.  You  may
     however take  out individual  functions and  use them  in
     your  work,  if  your  work  is  totally  unrelated  from
     utilities. You should however clearly mark where you have
     taken the  code from  and pass  my copyright message with
     it. A  message like  "DirScan -  extracted  from  TOOLS/2
     source code.  Copyright(c) Martti Ylikoski 1990-1992. All
     right reserved." will do just fine.
     
     For example  you might  be writing a general installation
     program that at the beginning of the installation seaches
     the disk  for an  older version of the installed product.
     You could  then use  the DirScan-function.  It is however
     prohibited to  use the DirScan in a tool that seaches for
     files and makes small modifications for them.
     
     There are  two ideas  behind holding  copyright to source
     code and  preventing others  from modifying  it. First is
     uncontrolled changes.  I really  don't  want  to  receive
     questions or  bug  reports  about  code  that  I  haven't
     written and don't know anything about.
     
     Second is  to prevent  anyone from  modyfying the  source
     code a  little bit  a starting to sell it for money. What
     is free, must remain free.
     
     For example  someone  might  feel  that  an  installation
     program is  very much  an utility.  However searching for
     the old  version of an installed program constitutes only
     a very  small percentage  of the  program and the type of
     function it  performs is  different of  those in  TOOLS/2
     package.
     
     You may  register your  usage of  TOOLS/2 by sending me a
     check for  $45 draw  on a finnish bank. As stated earlier
     there is  no must  for this.  If  I  receive  even  modes
     amounts money,  I will generally feel very happy and will
     create more  new tools  and correct  the mistakes  in old
     ones.
     
     
     Installing TOOLS/2.
     
     There are  two installation  programs on  the  diskettes.
     Install.cmd is  for OS/2  and install.bat  for DOS. Start
     installation by typing
     a:install
     and follow  the instructions.  By  default  TOOLS/2  will
     install the  dual mode  programs to the directory C:\BINB
     and the  protected  mode  (OS/2)  programs  to  directory
     C:\BINP. If you want to change these default directories,
     you must manually edit the installation scripts.
     
     Note  allso   that  one   of  the  demonstation  programs
     (traddemo.cmd for  OS/2 and traddemo.bat for DOS) assumes
     that there  exist a  file demotest.txt in C:\BINB. If you
     have changed  the installtion directories and want to run
     the  demonstrations,   you  must  manually  correct  this
     reference also.
     
     After installing  the tools  you should  edit  the  PATH-
     environment directory  to contain the directories C:\BINB
     and  C:\BINP   in  OS/2   and  C:\BINB  in  DOS  (or  any
     directories  where   you  have   installed  the   tools).
     Otherwise  you   will  not  be  able  to  run  them  (the
     operationg system will not find them). These values start
     to affect after a boot up.
     
     
     TOOLS/2 demonstaration.
     
     There exists  a demonstaration  program which covers most
     of TOOLS/2.  It starts  from a  file demo.cmd  (OS/2)  or
     demo.bat  (DOS).  This  demonstration  calls  then  other
     command scripts. Start the demonstration by typing at the
     command promt:
     demo
     Running the  demo requires  that the PATH-variable is set
     correctly.
     
     
     Documentation.
     
     There is  a manual  page for  each command.  These are in
     .TXT-files. By default the documentation is not copied to
     the disk,  since there  is no standard directory where it
     could be copied.
     
     For OS/2  there is  also a TOOLS2.INF-file. It is in same
     format as  all OS/2  help files.  To view  it type at the
     command prompt:
     view tools2
     You must  be in  the same  directory. The  .TXT files are
     provided because  they are  the  only  way  to  view  the
     documentation under DOS.
     
     If you  want to take a look at the macro language used to
     generate OS/2  help files see the tools2.gen file on disk
     2. There  is also  a makefile  (doc.mak), which shows the
     commands that generated the help file.
     
     
     Source code.
     
     Full source code is provided. Most utilities contain only
     one module.  E.g. the  code used  to  generate  the  mem-
     command is  in mem.c.  There are  also make files for all
     tools. The makefiles have the same name as the tools, but
     end in .mak.
     
     
     Libraries.
     
     The library used with TOOLS/2 is also provided. It's name
     is mtoolsp  in protected  mode and  mtoolsr in real mode.
     These libraries  contain reusable code used to create the
     utilies.  The   makefiles  used   to  create   them   are
     mtoolsp.mak   for   mtoolsp.lib   and   mtoolsr.mak   for
     mtoolsr.lib.  Unfortunately   there   is   currently   no
     ducumentation available  on the  functions except what is
     provided with the source code.
     
     
     Feedback.
     
     There is on disk 1 a feedback form in feedback.txt, which
     contains some  questions  about  your  impressions  about
     TOOLS/2. More  than anything  tools writers need feedback
     from users.  What's good and what's not. What kind of new
     tools are  needed. I  strongly suggest  that you at least
     glance through  it. Also  free format  letters  are  very
     welcome.
     
     
     Registration.
     
     As stated earlier, you may register your usage by sending
     me a  check of  $45 drawn  on a finnish bank. Fill in the
     form below and send it with you check. Send the check and
     form to the address:
          Martti Ylikoski
          Poutuntie 3 A 7
          SF-00400 Helsinki
          Finland.
     
     
     
     
                     TOOLS/2 REGISTRATION FORM
     
     
     Name:____________________________________________________
     
     
     Address:
     _________________________________________________________
     
     _________________________________________________________
     
     _________________________________________________________
     
     _________________________________________________________
     
     Telephone:_______________________________________________
     
     TOOLS/2 version:_________________________________________
     
     
     
     Unistalling.
     
     If you  are not  satisfied with  TOOLS/2,  you  can  also
     uninstall it.  There are two files on the first diskette.
     uninstal.cmd for OS/2 and uninstal.bat for DOS. Note that
     there is  only one l at the end. To uninstall type at the
     command prompt:
     a:unistal
     and follow the directions.
     
     
     Disclaimer.
     
     THE SOFTWARE  IS PROVIDED  "AS IS"  AND I  DISCLAIMS  ALL
     WARRANTIES WITH  REGARD TO  THIS SOFTWARE,  INCLUDING ALL
     IMPLIED WARRANTIES  OF MERCHANTABILITY AND FITNESS. IN NO
     EVENT  SHALL   I  BE  LIABLE  FOR  ANY  SPECIAL,  DIRECT,
     INDIRECT,  OR   CONSEQUENTIAL  DAMAGES   OR  ANY  DAMAGES
     WHATSOEVER RESULTING  FROM LOSS  OF USE, DATA OR PROFITS,
     WHETHER IN  AN ACTION  OF CONTRACT,  NEGLIGENCE OR  OTHER
     TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE
     USE OR PERFORMANCE OF THIS SOFTWARE.