========================================================================
                                VisEmacs
========================================================================

Copyright (C) 1997 Christopher Payne

Author: Christopher Payne <payneca@sagian.com>
Version: 1.0
Created:  1 Sep 1997
Date: 10 Sep 1997

VisEmacs is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.

VisEmacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with GNU Emacs; see the file COPYING.  If not, write to the
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.

Background:

VisEmacs is a Visual Studio Add-In that allows Emacs to be integrated
as the default text editor.  It will be used instead of the Visual
Studio built-in editor when you double-click on a file or press F4
after compiling (it will go to the proper line in the emacs buffer).
A note:  because the Visual Studio editor is not used, reverting
buffers does not have to happen, as emacs is always used (which 
enables auto-save recovery features lost with auto-revert-mode).

Installation:

1) Copy VisEmacs.dll into a convenient directory like \Emacs\bin, 
   \Emacs\lib, or \Emacs\Add-In

2) Register the DLL using regsvr32.exe ... for example:
   > cd \Emacs\Add-In
   > regsvr32 VisEmacs.dll

3) Start Visual Studio and go to:
      Tools
        Customize...
          Add-Ins and Macro Files

4) Click on Browse, and point Visual Studio to your VisEmacs.dll file.

5) Click the checkbox to indicate that you want to use the Add-In, and
   Close the Customize dialog box.

7) You should notice the VisEmacs Toolbar with a large 'E' Icon.


Compiling VisEmacs:

  Two Options:
1) Use the pre-compiled version of the DLL in the Release\ directory.
2) Open the VisEmacs Workspace in Visual Studio and compile


Using VisEmacs:

Clicking the 'E' Toolbar will show the VisEmacs configuration dialog.

Use Visual Studio as normal, and Emacs should almost always (I'm not
making any guarantees) bring Emacs to the foreground to edit the
document.


Problems:

VisEmacs works by hooks exposed by Visual Studio.  Most of the
functionality works from the OpenDocument (look it up in VS 5) hook.
So...If a document is open in Visual Studio, and you double click 
the file in the File Browser...Emacs will NOT come to the foreground.
Since the document was open in the Visual Studio editor, the 
OpenDocument event never occurred.


Final Thoughts:

If you like this little DLL, drop me a line.  If you hate it...write a
new one, and show me.  I like new utilities too.  :)

Christopher Payne
payneca@sagian.com

