DP Tool Club 17

home *** CD-ROM | disk | FTP | other *** search

/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / ve2tv103.zip / HISTORY.DOC < prev next >

Wrap

Text File | 1994-07-31 | 26KB | 478 lines

TVMEditor Library History ========================= ** Turbo Vision 1.03 Users: ** ------------------------ ** Please see the notes on 03/07/94 regarding a bug fix to the Turbo ** Vision file TGROUP.CPP. The bug fix is required so that ** TVMFileEditor::valid() can work properly. Also look at TVBC4BUG.DOC. ** These bugs have been fixed in Turbo Vision 2.0. ** ** Turbo Vision 2.0 Users: ** ----------------------- ** Please see the notes on 06/25/94 regarding a bug fix to the Turbo ** Vision file TSTATUSL.CPP and on 07/29/94 for a bug fix to the Turbo ** Vision file TEVENT.CPP. The bug fixes are required so that TVMEditor ** will work properly. If you have access to CompuServe, download ** TV2BUG.ZIP from library 11 of the BCPPDOS forum which contains a list ** of known bugs in Turbo Vision 2.0. ** ** 32 BIT COMPILER WARNING: ** ----------------------- ** Be careful when using any optimization (-O type options) with the ** BC++ 4.02 32 bit compiler just yet. It tends to generate some bad code ** or take hours to compile under certain situations when those options are ** used. If you experience problems when compiling 32 bit applications, ** insure that all optimizations are turned off (i.e. use -Od as the last ** command line switch or turn them all off via the Optimizations section ** of the Local Options dialog in the IDE) and try again. Of course, if a ** patch has been released to fix these problems and you have applied it, ** ignore this warning. Version 2.00 ------------ Thanks to John Gilbert, Hycel Taylor, Ronnie Wulfsohn, Mark Pinnuck, and Christopher Pope for pointing out a couple of potential problems, bugs, and oversights. Thanks to Borland for finally releasing an updated Turbo Vision and a protected mode compiler. Starting with this version I have decided to drop the library only registrations and go with a single, full source registration. Over 90% of prior registrations were for the full source version. Also, due to the two compiler and two Turbo Vision versions, attempting to manage and generate all the different registration types and library types became cumbersome. The source code can be used to generate a library for any compiler/Turbo Vision combination via conditional compilation. I have also switched over to using make files to simplify the build process due to the various types of library that can now be generated. Using make files allows the creation of various forms of the library by simply specifying some command line switches. Read the header comments in the make files. They will give you all the necessary details. If you would like a library only version, please contact me via CompuServe E-Mail or regular postal mail for pricing and availability. See the ORDER.DOC file for information on registering new versions or upgrading from a prior version. 07/31/93 - Version 2.00 released. 07/29/94 - Updated the documentation. Some of the items from this file were condensed and now refer you to the manual which is current and contains information on all items prior to this date. *** This bug fix pertains only to Turbo Vision 2.0 users *** Tracked down a bug in TEVENT.CPP. In 32-bit protected mode, calls to the Win32 console functions fill in the event.mouse.controlKeyState data member. When using real mode or 16-bit protected mode, this data member is not filled in with any value. The garbage value in it causes unpredictable results if you try to make use of it. Here is the fix: In TEVENT.CPP, lines 105-107 in TEventQueue::getMouseEvent() are: ev.mouse.eventFlags = 0; if( ev.mouse.buttons == 0 && lastMouse.buttons != 0 ) Change them to: ev.mouse.eventFlags = 0; #if !defined(__FLAT__) // BUG FIX ev.mouse.controlKeyState = THardwareInfo::getShiftState(); #endif if( ev.mouse.buttons == 0 && lastMouse.buttons != 0 ) ****************************************************************** 07/24/94 - Added 'Boolean TVMMemo::setLineTerminator(char lTerm)' to the TVMMemo class. Pass it '\x0', '\r' (for "\r\n"), or '\n' to set the line terminator type. This is useful for buffers that are (or could be) blank when constructed and executed. By default, such memo fields default to using '\r' (CR+LF) as the line terminator. Added code to create a low memory descriptor to access the BIOS keyboard flags. If you define your own descriptor to access the BIOS keyboard flags directly as I just did, *DON'T* use TV's kbXXXXX constants as bit masks for CAPS, NumLock, etc. In the flat memory model it uses the constants from WINCON.H which don't match up to the real and 16 bit mode constants. Either define your own constants to match the others or use literal values instead. Don't ask how long it took me to figure that one out. Added the function 'void AllocateDescriptor(void)' to the library. The TVMEditor constructor calls it to allocate a descriptor used in accessing the BIOS keyboard flags and to register an exit function that will free it when the program ends. On subsequent calls, it will simply return. To go with this a new static data member was added: static unsigned short TVMEditor::lowMemDesc; This is public and you are free to use it so that your own code can access the BIOS etc. If you use it prior to instantiating an editor, call AllocateDescriptor() to establish its value. 07/07/94 - Added a private data member 'static short MaxAllocatedPages' and public access functions 'static void setMaxAllocation(long maxBytes)' and 'static void getMaxAllocation(void)' to the TVirtualMemory class. These can be used to set or get the maximum number of bytes (tracked internally as pages) that can be allocated by an instance of the class before disk swapping is forced. This prevents one editor from consuming all available memory. Got the 32 bit assembler versions of unique_name(), scanFwd(), and scanBkwd() working. Note that in scanBkwd(), the 'short SearchLen' parameter was changed to 'int SearchLen' to make the prototypes the same for the 16 and 32 bit versions. The 32 bit version pushes a 32 bit int on the stack instead of a 16 bit short probably due to the return value of strlen being used in there somewhere (?). Anyway, the type change keeps it working properly in either version. Fixed up the heap viewer code a little so that it displays a more accurate total of the free memory available in 32 bit protected mode. 07/05/94 - Added 'inline void setDefaultMessage(const char *msg)' to the TVMEditor class to allow setting of the indicator message from a source external to the TVMEditor class or one derived from it. 06/30/94 - Scrapped the 16/32 bit DPMI virtual memory class that I wrote earlier and started again. Now the class works in a similar fashion to the EMS/XMS version (SWAPVMEM.CPP is replaced by SWAPDPMI.CPP) but uses the abundant supply conventional memory before swapping to disk. My knowledge of protected mode memory allocation is limited right now, so this may change again later when I understand protected mode programming better. 06/25/94 - *** This bug fix pertains only to Turbo Vision 2.0 users *** Tracked down a bug in TSTATUSL.CPP when a status line object is stored in a resource file using 32 bit protected mode. The size difference for 'int' (32 bits long) and 'short' (16 bits long) causes the application to crash when reading it back in. Here's how to fix it: In TStatusLine::readItems(), line 267 is: int key, cmd; Change it to: ushort key, cmd; In TStatusLine::readDefs(), line 287 is: int min, max; Change it to: ushort min, max; ***************************************************************** XY block marking required changes to the hasSelection() function. These changes are to insure proper detection of a marked block but now prevent it from being an inline function. Therefore, it was moved to TVMEDIT1.CPP and only the prototype exists in TVMEDIT.H. 06/24/94 - Start Block (^KB) and End Block (^KK) can now be used to alter the starting or ending point of a marked block. This provides an effective block extension method if you ever start or stop the block in the wrong place (shift-clicking the mouse can also be used (noted below) but it works in a slightly different manner). Note that if you hit ^KB (start block) at a position after the end point, the old block will be unselected and a new block started. If you hit ^KK (end block) at a position prior to the start point, the request is ignored. The persistent marked block was a little too persistent in nature. Therefore, the TVMEditor::adjustBlock() function was added and other necessary code was added to some existing functions so that as text is edited, the block start and end points are adjusted to maintain their proper position whenever possible. 06/21/94 - Added conditional compilation for 32 bit inline assembler code to TVMEDIT1.CPP and TVMINDIC.CPP. This caused the compiler to crash or give odd errors when it recompiled via assembler. The 32 bit assembler code was then replaced with straight C code or __emit()__ statements for when the library is compiled for the flat memory model. 32 bit inline assembler does work in other modules though. Possible compiler bug? Problems seems to be related to the streamable stuff in the generated assembler source. Added a cmReSynch command that the TVMFileEditor class will recognize as an evBroadcast event. When received, it will check the date and time stamp of its associated file on disk (if one exists). If the date and/or time stamp is different, it will call the editorDialog() function with a value of edReSynch and a pointer to the filename. You can make the editorDialog() function query the user as to whether or not the file should be reloaded or simply return cmYes to force a reload. Not handling the event or returning a value other than cmYes will prevent the file from being reloaded. 06/20/94 - Finally had some time to finish changing the line-only block marking to XY (column + row) marking to mimic the original TEditor classes. To this end, 'short selStartC' and 'short selEndC' (start line column and end line column) where added to the TVMEditor class. A 'Boolean isSelecting' parameter was also added to the TVMEditor::moveChar() and TVMEditor::moveWord() functions too. In those functions, and TVMEditor::moveLine() as well, it is set to default to False if unspecified in the function call. Two extra smXXXXX constants (smMouse and smLine) were added to TVMEDIT.H to signal that the mouse is being used to mark a block of text. smLine indicates that the starting point was double clicked to select whole lines as the mouse is dragged. Note that this change significantly alters the way blocks of text are selected. The block selection now mimics that of the original TEditor in that it can start and end on any column within a line. This includes the ability for a block of text to start and end on the same line (i.e. to highlight a single word or a few characters). Clicking the mouse anywhere within the text will move the cursor to the new location as before, but will also cause any currently selected block of text to become unselected and mark the new cursor location as the start of the selected text. Dragging the mouse will extend the block. Double clicking the starting point will allow you to select whole lines as you drag the mouse up or down. A block can also be extended by shift-clicking (hold down either shift key and click the mouse in the new location). Be aware that the commands that worked on whole lines before such as Paragraph Reformat, Indent Lines, Unindent Lines, Center Lines, and Align Text will still use only with whole lines regardless of where the block starts or ends. 05/29/94 - Added a new data member to the GlobalEditorOptions structure: char PrintDevice[MAXPATH]. By default, it is set to LPT1, but it can be changed to LPT2, COM1, COM2, a filename, etc. This allows the default TVMFileEditor::PrintBuffer() function to be a little more flexible by allowing the user to specify the output device. It was also altered to use low level, unbuffered, binary writes so that it stops printing when there is an error and ESC is pressed in the critical error handler. fprintf() didn't always do this properly because it buffered the output. 05/26/94 - Changed all occurances of 'near' to _NEAR, 'far' to _FAR, and 'huge' to _HUGE so that the code is compatible with 32 bit DPMI which uses a flat memory model (doesn't use or need near, far, and huge). 05/25/94 - Improved the performance of TVMFileEditor's read and write functions by using an adjustable buffer. It shouldn't be quite so slow on large files now. However, do note that unlike most editors, the text is moved through a small conventional memory buffer instead of being allowed to utilize all available memory for storage. Started adding the necessary alterations to make the library TV 1.03, TV 2.0, and DPMI compatible. 05/20/94 - Due to several requests and my own forgetfulness as to why I ever made it protected in the first place, 'LocalEditorOptions Opts' is now a public member of TVMEditor. This makes it a whole lot easier to directly alter the tab size, indent size, and right margin value without going through a user dialog or derived class. Combined the following functions: void TVMEditor::forceUpLow(long from, long to, ushort cmnd); void TVMEditor::toggleCase(long from, long to); void TVMEditor::indentLines(long from, long to); void TVMEditor::unindentLines(long from, long to); void TVMEditor::centerLines(long from, long to); void TVMEditor::alignText(long from, long to); into one function: void TVMEditor::alterText(long from, long to, ushort cmnd); The basic logic flow of the above functions was identical and it made more sense to combine them in light of the modifications for "Signs Of Life" (see below) and impending changes to implement XY block marking. Otherwise there would have been a lot of unnecessary code duplication. It also allows for a user hook to alter blocks of text in ways other than cmForceUpper, cmForceLower, cmToggleCase, cmIndentBlock, cmUnindentBlock, cmCenterLines, and cmAlignText. If the 'cmnd' parameter is not one of those, the editorDialog() function is called with a value of edAlterText followed by the command, a pointer to the line's text, and starting and ending columns values which denote what part of the line should be affected by the command. If the editorDialog() function returns cmCancel, nothing is changed. If it returns cmOK, then the altered text is stored. This makes the editor more extensible. Signs Of Life ------------- General additions for the "Signs of Life" modification: // These are the different states that the signsOfLife() function can be // called to handle. enum SignsOfLife { slInitiate, slReporting, slHide, slShow, slDone }; // Signs of Life handler definitions typedef void (*TVMSignsOfLife)(SignsOfLife, ushort, long, long); void VMdefSignsOfLife(SignsOfLife, ushort, long, long); The GlobalEditorOptions structure contains these two extra fields: // Signs of Life. // These two values indicate when signs of life should be issued by // the editor. What this means is that after initThreshold lines, // the editor will place a call to the signsOfLife() function to let // the user know it is still working and hasn't locked up. After that, // it will place a call to it every reportInterval lines. short initThreshold; short reportInterval; The TVMEditor class now contains an additional static pointer member (like it does for editorDialog). static TVMSignsOfLife _NEAR signsOfLife; // Signs of Life function. For complete details on how this all works, read the manual sections on Signs of Life and for the above items. Also look at the demo program in TVEDIT3.CPP. It has a simple but functional example. 05/19/94 - Added to TVMEditor : virtual void doneBuffer(void) Added to TVMFileEditor: virtual void doneBuffer(Boolean reloadFile) I missed this one from the original TEditor classes. See the manual for full details and also the reference to cmReSynch in the 06/21/94 notes. 05/09/94 - Added one new function to the library in general and added two new functions to the TVMEditor class (see manual for details): char *unique_name(char *s); void TVMEditor::setSelect(short fromX, long fromY, short toX, long toY, Boolean goTop = False); void TVMEditor::putCursorAt(short x, long y, Boolean center = False); Finally made TVirtualMemory::MemoryCheck's default value TVMXMSFirst to look for XMS before EMS. In most cases, it is more readily available than EMS memory. 05/06/94 - Fixed a bug in TVMMemo::LoadMemo() that caused a single line terminated by a NULL to be ignored. Please note that for single lines like this, the LineTerminator setting used when retrieving the text will be set to the NULL character. If you want lines of text to be terminated with a line feed or carriage return+line feed upon retrieval and it is possible that only a single NULL terminated line may be inserted to start with, be sure to append such character(s) to the end of the text before loading the memo field. 04/08/94 - Made the TVMEditor::setXIndex() and TVMEditor::setScrIndex() virtual. These two functions are used to synchronize the screen cursor and text insertion point. They were made virtual to allow the embedding of special codes in the text. Overriding these functions allows you to skip past them and maintain a proper cursor position. 04/06/94 - Made the TVMEditor::drawLines() function virtual. This is the function that does the real screen updates and will need to be overridden in derived classes that alter the drawing mechanism. 03/31/94 - Added a new private data member and an access function to the TVMIndicator class: const char *DefaultMsg and inline void TVMIndicator::setDefaultMessage(const char *msg); 03/28/94 - Added preprocessor directives to TVIRTMEM.H so that string.h got included if it hadn't been done already. This is because some inline functions in it use strcpy(). Altered TVMIndicator::draw() slightly to suppress the display of the modification indicator when in Read Only mode so that it doesn't show up when text is being altered by an external source on purpose (i.e. a terminal object with scrollback). Version 1.10 ------------ Thanks to Randy at Safari Software for the suggestion to merge the separate EMS and XMS versions into one library that would handle either type based on what was available at runtime. Thanks to David Bench and Chris Abdelmalek for reporting a couple of bugs and other problems that are now fixed. 03/10/94 - Version 1.10 released. 03/07/94 - *** This bug fix now pertains only to Turbo Vision 1.03 users *** After looking for a bug in the TVMFileEditor class, it was discovered that a bug fix is needed in Turbo Vision's TGROUP.CPP. As it stands, the call to messageBox() in the doEditDialog() function prompting to save an altered or untitled file changes the value of a static local variable in TGROUP.CPP because the message dialog box calls its valid() function before closing. Subsequent calls to any valid() function after that (i.e. other modified or untitled editors) result in the "command" parameter containing the value returned by the messageBox() function, not the cmQuit command that should be there. This causes the valid() function of the other editors (or other objects) to perform incorrectly. Here's what to do: In TGROUP.CPP, lines 503 to 514 are: static ushort cmd; Boolean isInvalid( TView *p, void * ) { return Boolean( !p->valid( cmd ) ); } Boolean TGroup::valid( ushort command ) { cmd = command; return Boolean( firstThat( isInvalid, 0 ) == 0 ); } Change them to: // !! static ushort cmd; // COMMENT OUT OR DELETE THIS LINE. Boolean isInvalid( TView *p, void *commandP ) { return Boolean( !p->valid( *(ushort *)commandP ) ); } Boolean TGroup::valid( ushort command ) { // Pass a pointer to the command, DON'T use a static variable. return Boolean( firstThat( isInvalid, &command ) == 0 ); } This fix and many others can be found in the files KVBUGS.ZIP, TVBUGS.ZIP, and SYSFIX.ZIP in library 11 of the BCPPDOS forum. One thing to note, I think there are two copies of TVBUGS.ZIP in the library, one is 3K the other 13K in size. You will want the one that is 13K. You may need to go in and retrieve it manually instead of letting an automated navigator program go after it. Once you apply the above patch to the TGROUP.CPP source file and rebuild the TV.LIB library, a recompiled TVEDIT or other application will work as advertised. My library already contained the above fix with the initial release so I was not aware of the problem until a user reported it. ***************************************************************** Added a TVirtualMemory::Broadcast() member function to handle events that should be broadcast to all owners of a shared buffer. This is currently only used for the cmUpdateTitle event. Shared edit buffers will now properly update all attached windows with the new title when something like a File | Save As command is issued. 02/28/94 - Added the TVirtualMemory::MemoryCheck data member to the virtual memory class to allow the setting of a user preference regarding EMS/XMS usage. By default, it will favor XMS over EMS when looking for an available virtual memory source. This is only accessible from the registered version. The supplied demo executable does demonstrate this ability though (See Options | Start-Up Options). Merged the low level XMS function code into the EMS functions to form one library that uses either EMS or XMS based on what is available and takes into account the user's preference for memory type. Version 1.00 ------------ 02/18/94 - Version 1.00 released.