
What's new since PTVIEW version 2.0?

- Added regular expression text subsitution capability.
- Added most recently used file list.
- Added global file grep capability.

What's new since PTVIEW version 1.1?

- There are some UI changes; especially in the area of browsing symbol, and
  right mouse menus.
- Added support of reading MSVC++ 1.5 make files.
- Added some minimal sets of editing capabilities.
- Speed! PTVIEW is now faster. It is a lot faster in preprocessing "big"
  program files.
- PTVIEW can now preprocess on the background.
- Added the functionality to preprocess include files based on the preprocess
  information got from processing the top level file. 


What's new since PTVIEW version 1.0? Not much. Except:

- There is a new command line syntax. It is a little bit more flexible.
- There are some UI changes. These UI changes should make PTVIEW a little bit
  easier to use.


PTVIEW (Program Text Viewer) version 2.5 is a small Windows 3.1 utility that
helps you to read dazzling C/C++ program text files, which may possibly be
clustered up by conditionally compiled segments. It can hide/highlight the
code segments which are not going to be compiled; it can outline statement
blocks mangled among these segments; and it can even print them out to your
printer. The main features of PTVIEW are:

-- Tab characters control/conversion. PTVIEW allows you to change tab size
   easily so that you can try out different tab sizes on a text file created
   with tab size unknown to you. Moreover, you can choose to get rid of the tab
   characters, or to use your favourite tab size, with just a button click.

-- C/C++ preprocessing. PTVIEW is able to perform some simple C/C++
   preprocessing in order to hide/highlight conditionally compiled away code
   segments. For example, PTVIEW is able to prepocess the following piece of
   code and find out which code lines will actually be included for
   compilation, which will not:
        #if defined (WIN32)
            // This line will be compiled if the target system is 32 bits.
        #else
            // This line will be compiled if the target system is 16 bits.
        #endif

-- C/C++ statement block highlighting. PTVIEW is able to find out program text
   lines belonging to different statement blocks after preprocessing. It will
   outline the different statement blocks like:
        if (...)
    +---{
    |       if (...)
    |+--    {
    ||          ...
    |+--    }
    +---}

-- Macro symbol definitions lookup. PTVIEW is able to tell you the definition,
   and evaluated value if possible, of a macro symbol at a particular line
   after preprocessing; additionally, PTVIEW can tell you the path of file
   inclusions that leads to the definition of the symbol.

-- C/C++ comments highlighting. PTVIEW is able to hightlight C/C++ comments
   without preprocessing. Note that PTVIEW cannot correctly highlight comments
   if they are nested. Actually, PTVIEW will have trouble dealing with nested
   comments.

-- 1up, 2up or 4up printing with line width control.

-- Full Regular Expression text pattern search/replace.

-- Although PTVIEW is meant to be a program text viewer, it is equipped with
   some minimal set of editing capilities.



Components:

-- PTVIEW.exe
   - The executable of PTVIEW. It is developed to run on Windows 3.1 or higher.
     I have tried to run the program on other platforms like Windows 95 and
     Windows NT; it seems that PTVIEW runs fine on both platforms.
-- PTVDEF.dll
   -- A supporting DLL that deals with compiler system specific settings.
-- PTVRE.dll
   -- This DLL implements the regular expression search/replace algorithms 
      used by PTVIEW.
-- PTVREG.dll
   -- This DLL implements the regular expression global file grep algorithm
      used by PTVIEW. This DLL uses PTVRE.dll.
-- BWCC.dll
   -- Another supporting DLL.
-- PTVIEW.hlp
   -- PTVIEW on-line help file.
-- README.txt
   -- This file.
-- SAMPLE.txt
   -- Sample text file. Please open, and preprocess the file as described in
      the file.

For simplicity, put all these four files in the same directory; then, you
should start PTVIEW from that directory. If you are sure that there is alreay
a copy of BWCC.dll in your Windows system directory, you can safely delete
this copy of BWCC.dll that comes with the program.

If you are interested in using PTVRE.dll and/or PTVREG.dll in your personal
Windows program or freeware, please contact me and ask for the API.


Major bugs fixed since version 2.0:

- Fixed bug of searching with regular expression. The problem was that regular
  sub-expressiones could not be properly located.

- Fixed regular expression search bug. Now, PTVIEW will search for the longest
  match; instead of the shortest.


Major bugs fixed since version 1.1:

- Fixed memory bug. The problem was that PTVIEW crashes if it runs out of space
  for adding new symbols.


Major bugs fixed since version 1.0:

- Fixed program termination problem. The problem was that PTVIEW 1.0 doesn't
  behave correctly when you try to cancel saving of unsaved file during program
  termination.
- Fixed printing problem. The problem was that some printer drivers refuse to
  print more than one page of PTVIEW 1.0 output.


Known bugs:
- The first PTVGREP window opened must be the last closed.


PTVIEW version 2.5 is a FREEWARE. It can be distributed freely for non-
commerical use. However, I still retain the rights to the source and binary
of the program. PTVIEW is distributed AS-IS. It doesn't come with any support
or warranty. I am not responsible for any damage caused due to the use of the
program. Bug reports and suggestions are welcome.



Trevor W.S. Lee

74512.1047@compuserve.com

Room 2506, Wang Yan House
Wang Fuk Court
Tai Po, N.T.
Hong Kong

2657-1361 (Hong Kong Tel.)

