|
| 1 | +================================= |
| 2 | +== TextAnalysisTool.NET ReadMe == |
| 3 | +================================= |
| 4 | + |
| 5 | + |
| 6 | +------------------ |
| 7 | +-- Requirements -- |
| 8 | +------------------ |
| 9 | + |
| 10 | +Microsoft .NET Framework 2.0 or 4.0 (including versions 3.0, 3.5, and 4.5) |
| 11 | + |
| 12 | +Note: TextAnalysisTool.NET is compiled for .NET 2.0 and comes with a .config |
| 13 | +file that lets it run under .NET 4.0 (for example, on Windows 8 without the |
| 14 | +".NET Framework 3.5" feature installed). |
| 15 | + |
| 16 | + |
| 17 | +------------------------------- |
| 18 | +-- Installation Instructions -- |
| 19 | +------------------------------- |
| 20 | +1) Copy TextAnalysisTool.NET.exe and TextAnalysisTool.NET.exe.config to a |
| 21 | + local folder |
| 22 | +2) Run TextAnalysisTool.NET.exe |
| 23 | + |
| 24 | + |
| 25 | +--------------- |
| 26 | +-- File List -- |
| 27 | +--------------- |
| 28 | +TextAnalysisTool.NET.exe - Application |
| 29 | +TextAnalysisTool.NET.exe.config - Application configuration file |
| 30 | +TextAnalysisTool.NET.txt - Documentation file |
| 31 | +ReadMe.txt - Requirements, Installation Instructions, File List, Known Issues, |
| 32 | + Notes, History |
| 33 | + |
| 34 | + |
| 35 | +------------------ |
| 36 | +-- Known Issues -- |
| 37 | +------------------ |
| 38 | +* GDI+ occasionally throws a System.Runtime.InteropServices.ExternalException |
| 39 | + with the message "A generic error occurred in GDI+.". This exceptional |
| 40 | + condition causes TextAnalysisTool.NET to exit after notifying the user. |
| 41 | +* The .NET Framework's improper handling of vertical and horizontal scrollbar |
| 42 | + messages for ListBoxes can cause rendering problems for files with very many |
| 43 | + or very long lines. |
| 44 | +* Checkboxes don't always repaint properly due to a .NET Framework bug. |
| 45 | +* There is extra flicker when resizing the window. This is due to a workaround |
| 46 | + for an even worse .NET Framework repainting bug. |
| 47 | +* ListBox limitations on 16-bit OSes (Windows 95/98/Me) prevent files with |
| 48 | + more than 32,767 lines from displaying properly. |
| 49 | + |
| 50 | + |
| 51 | +----------- |
| 52 | +-- Notes -- |
| 53 | +----------- |
| 54 | +One of TextAnalysisTool.NET's core principles is that data should be read one |
| 55 | +time as soon as it is available and kept in memory after that. This principle |
| 56 | +allows the source data to be amended, changed, or even become unavailable |
| 57 | +without affecting the user. Though this principle is an optional convenience |
| 58 | +when the data source is a file, it is a strict requirement for data sources |
| 59 | +that offer only one chance to read their data (such as the clipboard and plug- |
| 60 | +ins). Accordingly, TextAnalysisTool.NET keeps the entire data set in memory at |
| 61 | +all times which means that particularly large data sets can tax systems with |
| 62 | +comparatively few available resources. The prototypical example is loading a |
| 63 | +file that is larger than the amount of memory in the system: performance |
| 64 | +suffers. TextAnalysisTool.NET strives to be as responsive as possible under |
| 65 | +all circumstances, but is ultimately bound by the resources available to it. |
| 66 | + |
| 67 | + |
| 68 | +------------- |
| 69 | +-- History -- |
| 70 | +------------- |
| 71 | + |
| 72 | +2013-05-07 |
| 73 | +---------- |
| 74 | +* Compiled using the .NET 2.0 "Any CPU" configuration to enable access to more |
| 75 | + memory when run on 64-bit operating systems |
| 76 | +* Superficial string changes for copyright date, etc. |
| 77 | + |
| 78 | +2006-12-04 |
| 79 | +---------- |
| 80 | +* Copy to clipboard includes HTML formatting that preserves the font/ coloring |
| 81 | + of the copied text when pasting (user request) |
| 82 | +* Enhanced New Filter and Find dialogs to pre-populate with the text of the |
| 83 | + currently selected line (user request) |
| 84 | +* Added saving/loading of Show Only Filtered Lines setting in .TAT filter |
| 85 | + files (user request) |
| 86 | +* Added "[x / y]" to enabled filter descriptions to show how many lines are |
| 87 | + currently matching each filter |
| 88 | +* Added support for legacy keyboard shortcuts Ctrl+Insert (copy) and Shift+ |
| 89 | + Insert (paste) (user request) |
| 90 | +* Added black and white to list of filter color options (user request) |
| 91 | +* Disabled glyph-mapping to work around a GDI+ bug that causes abrupt |
| 92 | + application termination |
| 93 | +* Fixed bug where Help | Documentation didn't clear the Show Only Filtered |
| 94 | + Lines setting |
| 95 | + |
| 96 | +2006-01-11 |
| 97 | +---------- |
| 98 | +* Significantly improved performance with large files (load time reduced by |
| 99 | + ~40%, memory use reduced by ~25%, filter time reduced by ~10%) |
| 100 | +* Fixed potential null dereference in LineCollectionDisplay.OnDrawItem that is |
| 101 | + extremely rare on all operating systems before Windows Vista (user report) |
| 102 | +* Fixed filter display coloration bug when running under .NET 2.0 by working |
| 103 | + around the problem so that the correct behavior is present under both .NET |
| 104 | + 1.1 and .NET 2.0 (user report) |
| 105 | +* Fixed bug where Ctrl-Alt-[A-Z] didn't work if filtered lines were hidden and |
| 106 | + no lines were displayed |
| 107 | +* Fixed bug where the body of the '_' character couldn't be seen with some |
| 108 | + font sizes (including the default) |
| 109 | +* Fixed bug where copying text containing '\0' to the clipboard truncated that |
| 110 | + text prematurely |
| 111 | +* Fixed premature line truncation bug due to use of default encoding when |
| 112 | + reading files |
| 113 | +* Fixed premature line truncation when drawing lines containing '\u0084' |
| 114 | +* Improved performance of toggling markers on high line numbers |
| 115 | +* Improved performance of drawing extremely long lines |
| 116 | +* Set IMAGE_FILE_LARGE_ADDRESS_AWARE flag in PE header to enable access to a |
| 117 | + larger virtual memory area when it is available (ex: on 64-bit machines or |
| 118 | + on machines with the /3GB boot option set) |
| 119 | +* Added formatting to the XML content of *.tat filter files for improved human |
| 120 | + readability and better revision control (user request) |
| 121 | +* Added support for applying Shift modifier key to Ctrl+F to begin a reverse |
| 122 | + find (this shortcut overrides the shortcut for toggling filter f) |
| 123 | +* Added display of plug-in file version to "Installed plug-ins" dialog |
| 124 | +* Add About dialog note about protection under United States patent 6,963,878 |
| 125 | + |
| 126 | +2003-09-02 |
| 127 | +---------- |
| 128 | +* Fixed bug whereby refreshing 0-line file caused an unhandled exception |
| 129 | +* Added short version of file name to window title, makes it easier to switch |
| 130 | + among different windows in the taskbar (user request) |
| 131 | +* Last directory used for successful file and filter access (via a dialog) is |
| 132 | + remembered, makes it easier to keep files and filters in different locations |
| 133 | + (user request) |
| 134 | +* Addressed minor focus issues related to filter display |
| 135 | + |
| 136 | +2003-07-24 |
| 137 | +---------- |
| 138 | +* Switched to building on top of .NET Framework 1.1 |
| 139 | +* Switched to using Windows XP visual styles for dialog controls |
| 140 | +* Improved performance during startup, reduced memory requirements |
| 141 | +* Fixed horizontal scroll bar bug for long lines with embedded tabs |
| 142 | +* Added keyboard shortcuts for toggling and cycling filters (user request) |
| 143 | + |
| 144 | +2003-04-07 |
| 145 | +---------- |
| 146 | +* Added support for plug-ins that extend TextAnalysisTool.NET by allowing it |
| 147 | + to read custom file types! (see the "Plug-ins" section of the documentation |
| 148 | + for more details) |
| 149 | + |
| 150 | +2003-03-24 |
| 151 | +---------- |
| 152 | +* Added support for coloring lines according to the filter(s) they match (see |
| 153 | + documentation for details) (user request) |
| 154 | +* Right-clicking "Regular expression" checkbox opens MSDN online documentation |
| 155 | + for regular expression syntax (user request) |
| 156 | +* Require confirmation when Help | Documentation is chosen to avoid |
| 157 | + inadvertently discarding the current lines and filters (user request) |
| 158 | +* File sharing modes tweaked for maximum versatility (specifically, to allow |
| 159 | + opening a file that's actively being written to) |
| 160 | +* File | Reload tries to preserve the selected line and current view of the |
| 161 | + file |
| 162 | +* File open/save dialog boxes remember the last file type they were used with |
| 163 | +* Focus rectangle now drawn in line display |
| 164 | +* Other minor user interface fixes/improvements |
| 165 | + |
| 166 | +2003-02-28 |
| 167 | +---------- |
| 168 | +Initial release of TextAnalysisTool.NET! |
| 169 | +Highlights: |
| 170 | +* Status bar with file name and filtered/unfiltered line count! (user request) |
| 171 | +* Support for copying multi-line selections! (user request) |
| 172 | +* Line display colors can be customized! (user request) |
| 173 | +* Multiple lines can be marked at the same time! (via multi-line selections) |
| 174 | +* Support for drag-and-drop to import text! |
| 175 | +* Support for reading UTF-8, Unicode, and Unicode big endian files! |
| 176 | +* User efficiency improvements to the Add Filter dialog box! |
| 177 | +* Real-time validation for Add Filter/Find input! (great for reg-ex's) |
| 178 | +* Filter pane is usable without a mouse! |
| 179 | +* Checkboxes in filter pane show which filters are active! |
| 180 | + |
| 181 | +2003-02-21, 2003-02-11, 2003-02-06 |
| 182 | +---------------------------------- |
| 183 | +Preview releases to a handful of volunteers |
0 commit comments