li.doc

WINDOWS 命令开发的C语言源代码

  - Thom Little Associates - CodeWright for Windows Commands -

        - LoadInclude - Load C/C++ or MASM Include File -
                        - Version 1.00 -


tlaLI10.zip CONTENTS:

   LI.C     Source file.
   LI.DOC   This documentation file.
   LI16.DEF Definition file for Windows.
   LI16.DLL	Dynamic Link Library for Windows.
   LI32.DEF Definition file for Windows/NT.
   LI32.DLL Dynamic Link Library for Windows/NT.


BACKGROUND:

The original concept for this command came from Premia in a
command called SelFile that was distributed without copyright in
two versions.  Both of these versions were slightly less then what
we needed for our development environments.  A near total re-write
of SelFile was performed in the effort to augment it for our
needs.

FUNCTION:

This program executes as a command within the CodeWright for
Windows or CodeWright for Windows/NT environment.

It is often useful to directly load a file that is identified in an
include statement.  LoadInclude will automate this process for you.
Simply place the cursor anywhere on the line that contains the
include statement and issue a LoadInclude command.

LoadInclude verifies that the current line has an include
statement, extracts the file name from the statement, and then
attempts to load the file by using three methods in the following
order:

   Absolute Reference:

      A load is attempted using just the filename on the include
      statement.
      
      If this is a fully qualified name the absolute reference to
      the file will result.

      If this is not a  a fully qualified name then the current
      default drive and subdirectory will be added to the base and
      extension from the include statement to form a fully
      qualified name.
         
      (Note that the current drive and directory may be pointing at
      an unpredictable location when you call LoadInclude.  This
      sometimes results in an unexpected result.)

   Current File Reference:

      A filename is constructed by adding the base and extension
      of the filename in the include statement to the drive and
      directory of the file containing the include statement
      (i.e., the current buffer).

   Include Path Reference:

      A filename is constructed by adding the base and extension
      from the include statement to each entry in the system
      environment INCLUDE variable.

COMMAND SYNTAX:

   LoadInclude( )
      or
   LoadInclude
   

INSTALLATION:

If you are using CodeWright for Windows, copy the file LI16.DLL
anywhere on your hard disk.  If you are using CodeWright for
Windows/NT, copy the file LI32.DLL anywhere on your hard disk.

Insert a LibPreload= statement in your CodeWright initialization
file (.INI) that points to the location where you have installed
LI16.DLL (or LI32.DLL).  Examples:

   LibPreload=li16.dll
   LibPreload=e:\bld\li\li32.dll

After you reload CodeWright, the LoadInclude command will
be available for use.


MESSAGES:

   <file_name> - absolute reference.
   <file_name> - current file reference.
   <file_name> - include path reference.

      The file was successfully loaded into the buffer using the
      method listed.
      
      Return TRUE.

   <file_name> - not found.

      The file was not found using any of the three lookup
      techniques.
      
      Return FALSE.

   <file_name> - open failed.

      The file was successfully located but an error occurred
      while attempting to read it into a CodeWright buffer.
      
      Return FALSE.

   INCLUDE environment variable not set.

      The INCLUDE environment variable was either never set or you
      set it the then inadvertently cleared it.
      
      Return FALSE.

   Not C/C++ or MASM include file.

      The statement at the current cursor location is not a C/C++
      "#include," MASM "INCLUDE," or MASM "include" statement.
      
      Return FALSE.
      

SHAREWARE:
      
We normally distribute software of this form as Shareware. Since
the genesis of this command was in a command written by Premia, we
feel that it is unethical for us to accept payment for it.

This software is provided as freeware for your evaluation and use.
This software has been placed in the public domain.

   Thom Little Associates
   Product Support
   P.O. Box 1901
   Boston, MA  02205-1901

   Voice ......... 617.227.4644
   Compuserve .... 70724.71 (Thom Little)
   Channel One ... Thom Little
   Premia ........ Thom Little

Copyright 1993, Thom Little Associates, all rights reserved.


DISCLAIMER:

Thom Little Associates disclaims all warranties as to this
software, whether express or implied, including without limitation
any implied warranties of merchantability, fitness for a
particular purpose, functionality or data integrity or protection.


ACKNOWLEDGEMENTS:

DOS, Windows, Windows/NT, and Visual C++ are copyrights of
Microsoft Corporation.

CodeWright for Windows and CodeWright for Windows/NT are
copyrights of Premia Corporation.


HISTORY:

12-15-93  Version 1.00 first release to public.