; ------------------------------------------------------------------------------
; This Source Code Form is subject to the terms of the Mozilla Public License,
; v. 2.0. If a copy of the MPL was not distributed with this file, You can
; obtain one at http://mozilla.org/MPL/2.0/
;
; Copyright (C) 2012, Peter Johnson (www.delphidabbler.com).
;
; $Rev$
; $Date$
;
; Change Log for CodeSnip Release 4
; ------------------------------------------------------------------------------
Release v4.0.1 of 08 December 2012
+ Fixed bug #3578652 (http://bit.ly/RXIwBC): Pre-processor directive errors in main db ini files by removing support for problematic directives.
+ Rolling mouse over links in detail pane no longer displays a hint in the status bar. This change fixes bug #3577407 (http://bit.ly/VeSVGg): Clicking detail pane snippet link leaves hint in status bar.
+ Windows no longer scale automatically when screen DPI differs from that on design system. This fixes bugs #3591818 (http://bit.ly/TvNaUL) "Strange window behaviour in Windows 7" and bug #3591820 (http://bit.ly/SEH6dO) "Incorrect font size used for some bold text".
+ Update operating system detection code to detect W0ndows 8 & 2012 server.
+ Some refactoring and some redundant code removed.
+ Updated documentation.
+ Updated help topic that describes main display.
Release v4.0.0 of 12 October 2012
Final v4 release.
See also changes from alpha, beta and release candidates below for details of changes since v3.9.3.
+ New glyphs that describes level of testing applied to snippets from online Code Snippets Database now appear in top right of detail pane.
+ Changed main window caption and task bar entry to include version number "4" after program name.
+ Fixed bugs:
- #3572382 (http://bit.ly/OnEtNY): Automatic conversion of blank lines to paragraphs in REML markup editor gets confused if block level tags are already present.
- Unreported: Controls in News dialogue box do not use correct font.
+ A little refactoring.
+ Updated help file:
- Modified re recent changes
- Added new "What's new" topic giving details of changes in v4. Implements feature request #3567490 (http://bit.ly/RgQx0W).
- Renamed "Welcome" page as "Overview".
+ Updated documentation, including read-me file.
Release v4.0 RC 3 of 18 September 2012
Internal CodeSnip version 3.999.3
+ Fixed serious bug #3568628 (http://bit.ly/V5NX0H): CodeSnip faulting at startup after fresh install with no previous v3 installation.
Release v4.0 RC 2 of 17 September 2012
Internal CodeSnip version 3.999.2
+ Fixed serious bug #3568515 (http://bit.ly/Oy2Q7g): Duplicating a snippet with a display name causes crash.
+ Minor update to licensing information and about box credits.
Release v4.0 RC 1 of 14 September 2012
Internal CodeSnip version 3.999.1
+ UI changes:
- Welcome page completely revised. Instead of a program overview the page now describes the state of the databases and available compilers and displays help links and a donation request. There are also some links to the about box, news and program updates.
- Many changes to glyphs used in menus and toolbar.
- Removed some images that relate to trade marks, i.e. PayPal Donate button and Delphi compiler icons.
- No clicking noise is now issued by UI in response to user interaction with Details pane.
- Links to external commands and to other snippets re-styled.
- Revised and updated program's main icon.
+ Fixed bug #3566426 (http://bit.ly/OmbwTB): About Box Paths Page displays wrongly when themes not available.
+ Added support for Delphi XE3 compiler. Implements feature request #3566346 (http://bit.ly/SIVpS2).
+ Completely new Easter Egg.
+ Refactoring and internal code changes, including a revision of the "external" object that communicates with JavaScript in browser controls.
+ Changed License:
- EULA for excutable code changed to Mozilla Public License v2.0.
- Most original source code changed to Mozilla Public License v2.0 from v1.1.
- Only an abbreviated version of the license is now displayed by the installer and in the help file.
- License information has been consolidated into a new file: License.html.
+ About box changed re new license and changes in required and voluntary acknowledgements and credits.
+ Help file updated.
+ Documentation updated.
Release v4.0 beta 2 of 25 August 2012
Internal CodeSnip version 3.99.2
+ Bug fixes:
- #3556620 (http://bit.ly/Mq1Khh): Serious flaw in generating units containing class types when the classes contain method types other than procedure or function.
- #3556713 (http://bit.ly/RIzfvQ): Context menus are not displayed when pressing Alt+F10.
- #3556715 (http://bit.ly/O3QN0u): Deleting a category then returning to it via the history list causes a GPF.
- #3556718 (http://bit.ly/RVanCE): Inconsistent context menus for edit controls in Snippets Editor.
- #3557107 (http://bit.ly/PfiYxm): New snippets and categories are not added to the history list.
- #3558649 (http://bit.ly/PAXLQv): Closing the Preferences dialogue always refreshes the main display even if the dialogue box was cancelled or if nothing was changed.
- #3559156 (http://bit.ly/TKXYQ7): "Previews" giving examples of the effect of changes made in the Preferences dialogue box sometimes disappear when the tab key is pressed.
- #3559239 (http://bit.ly/Pm1HU4): Snippet names and display names are used inconsistently in the UI.
- #3559257 (http://bit.ly/Qc8Fqu): Compile Results displayed from the main menu can get out of sync with the actual compile results of snippets that have been edited since they were last compiled.
- #3559265 (http://bit.ly/NvV9iH): Viewing dependencies for an un-named snippet or a snippet not in the database causes a GPF.
- #3559266 (http://bit.ly/S69wO2): When include files are generated for a snippet that depends on a class type, the required class is not listed in the file's header comments.
- #3560317 (http://bit.ly/PUcEgV): The caption of the Active Text preview dialogue box refers to "Extra" text when it is used to preview a snippet's description.
- #3560521 (http://bit.ly/RG7Jlw): The state of the Overview tree often doesn't restore correctly after a database update.
- #3560958 (http://bit.ly/TX7M9V): Snippets are not sorted correctly (i.e. on display name) in the Overview pane.
- #3561014 (http://bit.ly/PEFgXY): The current view in the Display pane is not cleared, wven though all tabs are closed, when the database is re-loading.
- #3561047 (http://bit.ly/Pf5L5v): The Category view in the Overview pane sometimes appears fully expanded when it is expected to be fully collapsed.
- Untracked: Removed "(v4 preview)" text that had been left in main window title bar.
- Untracked: Minor accelerator key related problems in the Preferences dialogue box.
+ Main UI changes:
- The Detail pane tabset now has a context menu that can be used to close the current tab or all but the current tab. The Close tab option is also added to current view's context menu.
- Right-clicking a tab in the Overview or Detail pane now selects the tab.
- Middle-clicking an item in the Overview pane now selects it. Previously middle clicks were ignored.
- Many more parts of the main display and dialogue boxes now display display names for snippets rather than unique names.
- Ctrl clicking snippet and category links in the Detail pane and History UI controls now opens the chosen item in a new tab. Implements feature requests #3559377 (http://bit.ly/OqnAjd) and #3559378 (http://bit.ly/NPtEkX).
- Different link styles are now used for the different types of link in the Detail pane. Implements feature request #3559464 (http://bit.ly/Pwsqg6).
- Pressing Ctrl+Return on an active snippet or category link in the Details pane now opens the item in a new tab instead of the current tab. Pressing Return now opens the item in the current tab.
- The Detail pane's context menu now displays more options when text selections and links are right clicked. Implements feature request #3559375 (http://bit.ly/NzaY8a) with some minor differences.
- New button added to the Display tab of the Preferences dialogue box that resets default snippet heading colours. Implements feature request #3559140 (http://bit.ly/QKQo43).
- The "Types" unit is now displayed by default in the Snippets Editor Reference Tab's predefined units list.
+ When a category is printed, any URLs in snippet descriptions are output and styled.
+ Names of units referenced by snippets may now contain dots.
+ Some refactoring and internal code changes, including a major reworking of the "first run" program configuration and a revision to the "external" object that communicates with JavaScript in browser controls.
+ Help file updated:
- Re UI changes.
- With a description of the need to configure namespaces for Delphi XE2 for each unit referenced by the code it is test compiling - addresses bug #3536531 (http://bit.ly/Q2bcmY).
+ Updated documentation.
Release v4.0 beta 1 of 11 August 2012
Internal CodeSnip version 3.99.1
+ New features:
- Structure of snippet pages in details pane is now customisable: various page elements can be omitted and order of elements can be specified. Each snippet type has its own page customisation. Implements feature request #3519456 (http://bit.ly/NhT8Kr).
- Snippets can now have a "display name" that can contain any characters and does not need to be unique. When provided the display name is displayed in preference to the normal name. Implements feature request #3519460 (http://bit.ly/NN6kRP).
- Snippet descriptions can now be formatted and contain multiple paragraphs. This implements feature requests #3411890 (http://bit.ly/OS8a5a) and #3520405 (http://bit.ly/OS8yRe).
- Snippets can now be configured so that their source code is not syntax highlighted. This change allows snippets in other languages not to be highlighted as if they are Pascal. Implements feature request #3519935 (http://bit.ly/LrNiAg)
- Colour of headings for snippets and categories from main and user databases are now user configurable. This implements feature request #3519463 (http://bit.ly/Nz9JH2).
- User can now limit the number of compilers that appear in the compiler results table in the display pane. This is done via the Configure Compilers dialogue box. Implements feature request #3519459 (http://bit.ly/Q5O51z).
- New option on Tools menu that checks availability of new versions of CodeSnip.
+ User interface changes:
- "Test Compile" link removed from snippet display in details pane.
- "Test Compile" dialogue box changed so that only the installed compilers that CodeSnip uses for test compilation are displayed, instead of all known compilers.
- Welcome page revised.
+ Changes to snippets editor:
- New field on Code tab to enter optional snippet display name.
- New check box on Code tab to specify if Pascal syntax highlighter is to be used for source code.
- New tabbed "markup editor" lets user enter multi-paragraph snippet descriptions and extra information either as plain text or as REML markup.
- Controls on Code tab re-ordered.
- Extra Information tab revised with much larger edit control and deletion of explanatory text.
- Editor enlarged.
+ Changes to Preferences dialogue box:
- New "Snippet Layout" tab added where composition and layout of snippet pages can be customised.
- "General" preferences tab split into two: "Misc." that contains only measurement units and "Display" that contains display related options.
- Added controls to "Display" tab to set main and user database heading colours.
- Changes that affect appearance of content of details pane are now reflected in the display as soon as the Preferences dialogue box closes, rather than on program restart.
+ Changes to REML markup handling:
- Any REML text not embedded in block level tags is now automatically wrapped in <p> tags.
- Nested REML block level tags are no longer allowed.
- Changed handling of multiple spaces in REML code to be the same as in HTML.
- Formatting of REML code improved when re-displayed.
+ Bug fixes:
- Bug #3536331 fixed (http://bit.ly/KQTYc3): words at the end of some paragraphs in a snippet's extra information were not being found in "whole word only" searches.
- Fixed unreported file parsing bug that occured when loading a saved snippet selection from disk.
+ Changed Delphi compiler detection so that compilers can be detected by examining current user registry key in addition to local machine registry key. This enables Delphis that were installed for a given user only to be detected.
+ Improved error handling when reading and writing snippet selection files.
+ User database and export file formats updated to v6.
+ Per-user confuration file format changes: bumped file version to v9.
+ Major changes to installer:
- Now always brings forward any earlier common config files if needed.
- Per user configuration files are now ignored: they are handled by main program (see below).
- Only main database, not user database, is now imported from earlier versions on user request. User databases are now handled by main program (see below).
- There is no longer an option to delete old databases or configuration files.
- Updating from a v4 preview (alpha) release causes an extra page to be displayed that gives instructions relating to updating from preview to current release.
+ Program now detects if it is running for first time since updating:
- If this is first run since updating from v3 or earlier a "first run" wizard guides user through importing any old preferences or user databases.
- For point v4.x point updates user configuration file is silently updated as necessary.
+ Significant refactoring.
+ Updated help file in line with changes and new features.
+ Updated documentation, including minor changes to privacy statement and license.
Release v4.0 alpha 3 (preview) of 18 June 2012
Internal CodeSnip version 3.98.3
+ New features:
- Compiler warnings can now be switched on as well as off in generated code.
- Names and descriptions of snippets in a category can now be printed.
- Text and compiler searches can now be nested so that the later search refines the earlier one.
- Current selection (i.e. search result set) can be saved to disk and loaded again later.
+ User interface changes:
- Overview pane now displays buttons that can be used to collapse or expand non-empty section headings.
- Ctrl + arrow keys can now be used to scroll overview pane tree view vertically and horizontally without changing selection in overview pane.
- Main window is now refreshed whenever changes that affect it are made in the Preferences dialogue box.
- Some main menu shortcut keys changed.
- Dependencies dialogue box now has two tabs: the first displays the snippets required to compile the selected snippet while the second tab displays snippets that depend upon the selected snippet.
- Code Generation tab of Preferences dialogue box updated to enable warnings to be switched on or off. In addition default warnings can be restored, list view columns can be sorted and Alt key shortcuts tweaked.
- Code Import dialogue box improved: now sorts imported units in list view and scrolls to make renamed snippets visible.
- Snippet selection and cross-reference search dialogues now report if existing search results will be overwritten.
- Text and compiler search dialogues now ask if any current search results are to be refined.
- Tree views in Snippet Selection, Snippets export and Snippets submission dialogue boxes can now be expanded and collapsed.
- Appearance of message boxes tweaked.
- Program tab of About box updated with credits for new third party code.
+ Bug fixes:
- Error in logic of code that generates program ID was fixed.
- Bug #2868708 fixed (http://bit.ly/KeyAvS): edited snippets are no longer lost from manual snippet selections unless snippet names are changed.
- Bug #3534138 fixed (http://bit.ly/Mg9gJG): details pane display is now cleared when last tab is closed: previously content of last closed tab remained on screen.
+ Info about user's OS and IE version is now sent to web server during online database updates.
+ Some refactoring.
+ Help file updated in line with changes and new features. Some US English spellings changed to UK English for consistency.
+ Updated documentation, including:
- Privacy statement updated re changes in data recorded via database update logons.
- Licensing docs updated re introduction of some MPL 2.0 files.
Release v4.0 alpha 2 (preview) of 21 April 2012
Internal CodeSnip version 3.98.2
+ New features:
- New "unit" snippet type that enables complete units to be stored in database and to be test compiled.
- New "classes" snippet type that enables a single Object Pascal class or advanced record-with-methods to be stored in database, test compiled and included in generated units.
- Snippets from both the user and main databases can now be duplicated. Duplicates are editable and are stored in the user database.
- Online CodeSnip FAQs can now be displayed in the default browser from a new option on the "Help" menu.
+ User interface changes:
- New "Snippets" and "Categories" top level menus have been added. They are populated with items previously on the "Database" menu. "Snippets" menu also has new "Duplicate Snippet" item.
- "Help" menu re-arranged: items from the former "On The Web" sub-menu are now placed directly on "Help" menu.
- Numerous new and updated glyphs on toolbar, menu and in main display.
- Minor tweaks to controls in the Code tab of the Snippets Editor.
- Minor changes to the style of version info displayed on the splash screen.
+ Bug fixes:
- Fixed potential source of a bug in code that edits user-defined categories.
- Fixed unreported minor bug in dialogue boxes that display tabbed page controls: clicking a tab did not always give it the keyboard focus.
- Fixed bug #3519784 (http://bit.ly/IsCsun) where multi-line "type" or "constant" snippets that start on the same line as the type or const keyword were corrupted when included in units using the "comments after snippet header" comment style.
+ Characters used to introduced switches on the command line were changed: '/' replaces '\'. '-' is still permitted.
+ User and main database formats modified. User databases saved with this version may not be readable with release 4.0 alpha 1.
+ Some refactoring.
+ Help file updated in line with changes and some errors fixed.
+ Updated documentation.
Release v4.0 alpha 1 (preview) of 31 December 2011
Internal CodeSnip version 3.98.1
Changes relate to v3.9.3
+ User interface changes:
- New multi-tab detail pane can now show more than one snippet, category etc.
- Results of test compiles now appear in a dialogue box instead of in details pane.
- New code import wizard for cleaner control over import process.
- New "Compile" top level menu that groups all actions relating to test compilation.
- Empty section headings can now be displayed in overview pane if required.
- New display options relating to multi-tab display.
- New view displayed instead of welcome screen when database updated.
- Some additions and changes to main window navigation keys.
- Main window and task bar captions changed.
- Some dialogue boxes tweaked.
- Compiler configuration dialogue box heavliy revised to support default compiler paths.
- "About" dialogue box paths tab display improved.
- Compile error dialogue box display standardised.
- Splash screen updated.
+ Improved Delphi code syntax highlighter:
- Recognises Delphi 2010 keywords
- Correctly handles context sensitive directives within "property", "exports" and "external" statements.
- Recognises '&' prefix that causes keywords to be treated as identifiers.
+ Compiler search paths can now be specified for included units permitting non-VCL units to be used by snippets.
+ Database:
- Non-empty categories can no longer be deleted.
- File format of both user-defined and main databases changed.
- Database locations changed: updates to main database and edits to user database do not affect databases used by v3 and earlier.
- Location and file format of both user defined and main databases changed.
- Database now supports Unicode Delphi source code.
- Unicode Delphi identifiers can now be used for snippet names.
- Export and backup file formats updated: new formats are not backward compatible but older versions can still be imported.
- Code submission service now supports Unicode souce code.
- Database updates now use v5 of delphidabbler.com web update service with revised checksum handling.
+ Unicode support:
- Program now fully supports Unicode internally.
- Test units now use UTF-8 format if source code contains non-ANSI characters. ANSI format is used otherwise to permit compilation on older Delphi compilers.
- Many export file formats now support Unicode and UTF8 formats. User may specify file types from Save dialogue box.
- Configuration files are now in Unicode format.
- Some Unicode support added to database (see above).
+ Web service data handling code improved: now includes ability to send raw bytes and can detect and adapt to character encoding used in responses.
+ Common and per-user configuration file names and locations changed. Bumped file version numbers to 6 and 8 respectively.
+ Fixed some bugs:
- Various Unicode and code page related problems in RTF code generation.
- Memory leaks.
- Version detection in backup file restoration.
+ Cascading style sheet handling improved.
+ Any errors in scripts run in browser control now trapped and reported as exceptions instead of via browser control's own error dialogue box.
+ Revised external object that communicates with JavaScript in browser controls.
+ Hyperlinks used in snippets now support the https:// protocol.
+ A default title now used in print spooler if none specified.
+ Source code heavily refactored.
+ Help file updated in line with changes.
+ Installer:
- Changed so that v3 and v4 installs can co-exist - default install locations are different and v4 does not overwrite v3.
- Converts v3 config files to v4 Unicode format and copies to new locations. File version stamps are updated.
- Installer is now compiled with Unicode version of Inno Setup instead of ANSI version.
- Scripts updated and refactored.
+ Updated documentation, including changes to privacy statement and new file format documentation.
