cenvi.doc

C 语言开发HNT格式数据库系统

                    CEnvi Shareware Manual, Chapter 1:
                       CEnvi Unregistered Shareware


                     CEnvi unregistered version 1.008
                             21 December 1993

                       CEnvi Shareware User's Manual

          Copyright 1993, Nombas, All Rights Reserved.
          Published by Nombas, P.O. Box 875, Medford, MA 02155 USA
          [phone]

          Thank you for trying this shareware version of CEnvi from Nombas,
          a member of the Association of Shareware Professionals (ASP).

1.  CEnvi Unregistered Shareware

1.1.  Introduction to Cmm and CEnvi

          Cmm (C minus minus) is 'C' for the rest of us.  CEnvi runs Cmm
          programs in the DOS, Windows, OS/2, NT, Unix, etc...
          environments.  Together, CEnvi and Cmm make the power and
          flexibility of the C programming language part of every computer
          user's environment, without the hardware, time, and programmer
          resources needed for developing full-blown C programs.

          With CEnvi and Cmm, anyone can take control of their computer
          environment.  C is not just for programming nerds anymore.  CEnvi
          utilites, macros, batch files, and scripts can quickly be
          created, shared, and modified among all computer users,
          professional and amateur alike.

          CEnvi can be incorporated at a pace that is comfortable to you:
          you may only want to use CEnvi code set up by a more experienced
          user, you may want to enhance existing batch files with a line or
          two of CEnvi code, or you may write complete utilities using
          CEnvi.

1.2.  CEnvi unregistered shareware version

          This package is the unregistered shareware version of CEnvi.
          Nombas provides this unregistered shareware version of CEnvi so
          that you can try the program for a while before deciding whether
          to buy.  If, after a few weeks of using using this product, you
          think CEnvi will be useful to you and/or your organization then
          use the registration form at the end of this document (or see the
          file: REGISTER.DOC) to register CEnvi.

1.2.1   Why you should register

          If you register, then you will receive:
            *The latest version of CEnvi for all supported platforms
              (currently DOS, OS/2, and Windows, with NT support expected
              soon) without the annoying "Please Register" reminder.
            *The CEnvi user's manual (almost 100 pages, including a
              description of the Cmm programming language, a tutorial for
              those who have never programmed, and descriptions and
              examples of the nearly 150 functions included in the CEnvi
              library).
            *Free incremental electronic downloads for new versions of
              CEnvi for all supported operating systems.
            *Unlimited support from Nombas and CEnvi/Cmm users through
              CompuServe (72212,1622), internet ([e-mail]), the
              cenvi-cmm e-mail mailing list ([e-mail]), and
              the Nombas BBS (617-391-6595).
            *Access to the growing list of CEnvi utilities and libraries
              (some of which are included in this unregistered shareware
              package, and others are contributed by Nombas and CEnvi/Cmm
              users to the electronic locations described above).
            *Discounts for additional registered version of CEnvi to use
              within your organization.

1.2.2   How to register

          See the REGISTER.DOC document that is included with this package
          (and is also duplicated at the end of this document), to purchase
          a registered version of CEnvi.

1.3.  Installing CEnvi, documents, and sample files

          To install this package for evaluation
            * Create a directory and then copy all of these files into that
              directory.
            * From within that directory execute CEnvi.exe.
            * At the CEnvi "Code:" prompt enter "Install.cmm" to execute
              the Install program (which is written in Cmm).
            * You may then test CEnvi by trying out the included example
              files and by creating CEnvi code of your own.

          For DOS and OS/2 versions, the install.cmm program will set up
          the PATH environment variable to include the directory you
          installed the files in, and will also set the CMMPATH environment
          variable to this directory.  For Windows, install will add the
          CMMPATH profile value in WIN.INI (in the [CEnvi] section), and
          will also add the CMM file extension to the [Extensions] section
          in WIN.INI.

1.3.1   4DOS and 4OS2 users - .cmm executable extension

          4DOS and 4OS2 users can directly execute .cmm files by
          associating the .cmm file extension with your CEnvi executable.
          Assuming the CEnvi.exe is in the c:\CENVID directory, then a 4DOS
          user would want to add this line to AUTOEXEC.BAT:
              SET .cmm=C:\CENVID\CEnvi.exe

1.4.  Removing CEnvi unregistered shareware

          If, after testing CEnvi for a few weeks, you choose not to
          register this version of CEnvi, then you should remove the
          program from your computer.  (Also please consider telling Nombas
          why CEnvi did not suit your needs; we need such feedback if we
          are to improve the product.)

          For all operating systems, the first step for removing CEnvi is
          to delete all the CEnvi files and the directory that you copied
          the files to.  The next step depends on your operating system:

1.4.1   DOS de-installation

          Install.cmm made two changes to C:\AUTOEXEC.BAT: the directory
          that CEnvi was in will have been added to your PATH statement,
          and the CMMPATH environment variable will have been added.  To
          de-install CEnvi you must remove the CEnvi directory from the
          PATH statement and you must also delete the "SET CMMPATH=..."
          line.

1.4.2   OS/2 de-installation

          Install.cmm made two changes to C:\CONFIG.SYS: the directory that
          CEnvi was in will have been added to your PATH statement, and the
          CMMPATH environment variable will have been added.  To de-install
          CEnvi you must remove the CEnvi directory from the PATH statement
          and you must also delete the "SET CMMPATH=..." line.

1.4.3   Windows de-installation

          Install.cmm made two changes to WIN.INI: the CMM profile
          extension was added and the CMMPATH profile string was created.
          To de-install CEnvi you must edit WIN.INI (with NOTEPAD.EXE for
          example) and remove from the [Extensions] section a line similar
          to this:
               CMM=C:\CENVI\CENVI.EXE ^.CMM
          and also remove these line (or lines much like these) from
          WIN.INI:
               [CEnvi]
               CMMPATH=E:\NOMBAS\CENVI\EXAMPLES.WIN

1.5.  Using this package

1.5.1   Unregistered CEnvi shareware executable

          The executable in this package, named CEnvi.EXE, is identical to
          the registered version of CEnvi at the time this package was
          created with one exception: this unregistered shareware version
          will occasionally put up a screen to remind you to register your
          copy of CEnvi (see the bottom of this document or REGISTER.DOC).
          Nombas has spent, and will continue to spend, time and resources
          developing and supporting CEnvi and Cmm.  Without your honest
          support Nombas cannot improve and support CEnvi (and pay
          mortgage, feed the kids, pay the doctor, etc...).

          It is likely that months have elapsed since this shareware
          package has been put together (see date at the top of this file).
          If so, then the version of CEnvi you receive will be an updated
          version of this one.  At the time of this release, incremental
          improvements have been planned in memory use, speed of execution,
          debugging tools, developer tools, and documentation.

1.5.2   Example programs

          The following example programs are included with this shareware
          version of CEnvi.  Those files with a batch extension (.BAT for
          DOS and .CMD for OS/2) can be run by invoking the batch file
          directly.  Those files with the CEnvi source file extension
          (.CMM) are invoked by executing CEnvi with the file name as the
          first argument (e.g. CENVI FranTick.cmm).  Files with different
          (e.g., *.LIB, *.H, *.DAT) are files used by CEnvi some of the
          example programs.

          Many of the files will provide help for how to use them if they
          are invoked with "/?" as the only parameter.

          All of these example files are here for you to view, study,
          experiment with, and alter for your own use.  The Nombas BBS will
          continue to gather CEnvi and Cmm example files created by Nombas
          or uploaded by CEnvi and Cmm users; so registered users will have
          a large library to choose from (maybe some other CEnvi user has
          already solved your need, or perhaps their need is close to yours
          and you will only have to make small modifications to someone
          else's uploaded CEnvi program). 

1.5.3   DOS example files:
            *AllDirs.bat: Perform a command in this directory and all
              sub-directories
            *AllFiles.bat: Perform a command on all files matching a given
              file specification
            *Ascii.bat: Display the ascii character table
            *BatLoops.bat: Examples of various methods CEnvi can use to
              allow looping within batch files
            *BattMem.bat: Show values stored in a PC's battery-protected
              memory
            *Border.cmm: Draw a simple border on the screen
            *CmmEdit.cmm: VERY simple text editor; developed step-by-step
              in the tutorial chapter of the Registered CEnvi Manual.
            *DelTree.bat: Delete a directory tree
            *DirStat.bat: Extract specific fields from a DOS "DIR" listing
            *DiskFree.bat: Display free space on a disk drive
            *DosTime.bat: Show time according to computer's internal clock
            *ErrLev.bat: Execute a command and set the ERRLEV value as the
              return code, which makes ERRORLEVEL a variable
            *Fibonacc.cmm: Two methods for generating the Fibonacci
              sequence
            *FileFind.bat: Wildcard search for files on current drive or on
              all drives
            *Find#.cmm: Extract a number from wordy output; used by
              DirStat.bat
            *FranTick.cmm: Animated tick who drank too much coffee
            *GetUKey.cmm: Display a choice prompt and then set an
              environment variable based on user's selection 
            *Hello.cmm: My first Cmm program. Used to begin the Cmm
              tutorial.
            *HexDump.bat: Display hexadecimal dump of a file
            *Install.cmm: Install this registered version of CEnvi.
            *IsDay_1.bat: One method to check if it is a specific day of
              the week
            *IsDay_2.bat: Another method to check if it's a specific day of
              the week
            *IsItFri.bat: Is it Friday?
            *KbdBuf.bat: Alter the size of the keyboard buffer
            *KbdRate.bat: Alter the typematic rate of the keyboard
            *KeyCode.bat: Display keycode of any key pressed
            *KeyState.bat: Get or set the state of the NumLock, CapsLock,
              or Insert keys
            *KeyStuff.bat: Stuff characters into the keyboard buffer
            *MemBlock.bat: Trace through DOS's allocated memory blocks
            *Mouse.bat: Demonstrate reading a mouse's position and state
            *MultiDir.bat: DOS's "DIR" command allowing multiple file