Merge tag 'version-4.21.1' into develop

delphidabbler · delphidabbler · commit b615c2fef45e · 2023-04-09T12:52:20.000+01:00
Release v4.21.1
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -6,6 +6,32 @@ Releases are listed in reverse version number order.
 
 > Note that _CodeSnip_ v4 was developed in parallel with v3 for a while. As a consequence some v3 releases have later release dates than early v4 releases.
 
+## Release v4.21.1 of 09 April 2023
+
+* Completed implementation of support for [REML version 5](https://htmlpreview.github.io/?https://github.com/delphidabbler/codesnip/blob/version-4.21.0/Docs/Design/reml.html) (ommitted from v4.20.0 in error) and fixed some bugs in the original implementation [issues #81 and #82], including:
+  * Heavily revised "active text" handling code and document model to fix support for lists introduced in v4.21.0.
+  * Added support for rendering lists in plain text reports and generated source code header comments.
+  * Added support for rendering lists in Rich Text Format for use in printed information and in reports copied to the clipboard.
+  * Overhauled HTML rendering code that generates HTML for display in the UI.
+  * Heavily revised parsing and generation of REML code.
+  * Updated "active text" validation code.
+* Prevented snippets editor from stripping REML `<p>` tags [issue #103].
+* Fixed garbled copyright symbols in generated source code [issue #80].
+* Fixed bug in code that compresses multiple white space into a single space [issue #95].
+* Fixed out of range error in code that handles text encodings [issue #97].
+* Fixed broken formatting of compiler result tables in text and rich text snippet reports & print outs [issue #101].
+* Updated copyright date displayed in about box [issue #98].
+* Updated operating system detection code to detect Windows 10/11 builds released in December 2022 and Q1 2023.
+* Some refactoring [including issue #83] 
+* Changed build process to create all files in `_build` directory and to use different zip file names [issue #78].
+* Documentation changes:
+  * Updated `Build.html` to document changes in build process.
+  * Updated `CHANGELOG.md` to fix broken link [issue #76] and to remove information about semantic versioning.
+  * Removed broken links in `Docs/License.html`.
+  * Updated copyright date in various license files [including issue #96].
+  * Fixed errors and oversights in REML documentation.
+* Removed some redundant tests that were failing due to passing invalid parameters to the revised _StrWrap_ routine [issue #79].
+
 ## Release v4.21.0 of 16 December 2022
 
 * Updated to support [REML version 5](https://htmlpreview.github.io/?https://github.com/delphidabbler/codesnip/blob/version-4.21.0/Docs/Design/reml.html) in snippet description & extra information [issue #71]:
diff --git a/Docs/Design/reml.html b/Docs/Design/reml.html
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML>
 
 <!--
- * This file copyright (C) 2020-2021, Peter Johnson (gravatar.com/delphidabbler) and
+ * This file copyright (C) 2020-2023, Peter Johnson (gravatar.com/delphidabbler) and
  * is licensed under the MIT License: https://opensource.org/licenses/MIT
  *
  * DelphiDabbler Code Snippets Database Documentation: REML markup language
diff --git a/Src/ActiveText.UHTMLRenderer.pas b/Src/ActiveText.UHTMLRenderer.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2009-2022, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2009-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Provides a class that renders active text as HTML.
 }
diff --git a/Src/ActiveText.UMain.pas b/Src/ActiveText.UMain.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2008-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2008-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Provides interfaces, a factory class and implementation of "active text".
  * Active text is text that can have actions performed on it. Actions may
diff --git a/Src/ActiveText.URTFRenderer.pas b/Src/ActiveText.URTFRenderer.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2012-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2012-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Implements a class and helpers that create RTF representations of active text
  * with customised styling.
diff --git a/Src/ActiveText.UTextRenderer.pas b/Src/ActiveText.UTextRenderer.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2012-2022, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2012-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Implements class that renders active text as plain text in fixed width, word
  * wrapped paragraphs.
diff --git a/Src/ActiveText.UValidator.pas b/Src/ActiveText.UValidator.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2011-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2011-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Implements a container record that provides methods to validate active text
  * object.
diff --git a/Src/CodeSnip.dpr b/Src/CodeSnip.dpr
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2005-2022, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2005-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * CodeSnip application project file.
 }
diff --git a/Src/Compilers.USettings.pas b/Src/Compilers.USettings.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2022, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2022-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Class that reads and writes settings that apply to all compilers.
 }
diff --git a/Src/DBIO.UXMLDataIO.pas b/Src/DBIO.UXMLDataIO.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2008-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2008-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Implements classes that can read and write databases stored in XML format
  * with associated source code files.
diff --git a/Src/FmSnippetsEditorDlg.FrActiveTextEditor.pas b/Src/FmSnippetsEditorDlg.FrActiveTextEditor.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2012-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2012-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * A frame that provides an editor for entering and ammending active text,
  * either as plain text or in markup.
diff --git a/Src/FrOverview.pas b/Src/FrOverview.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2005-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2005-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Implements a titled frame that displays lists of snippets, arranged in
  * different ways, and manages user interaction with the displayed items.
diff --git a/Src/Help/HTML/new.htm b/Src/Help/HTML/new.htm
@@ -81,11 +81,18 @@ <h2>
         namespaces can be used.
       </li>
       <li>
-        <strong>[v4.3]</strong> The user defined snippets database can now be
+        <strong>[v4.3/v4.5.1]</strong> As of v4.3 the user defined snippets database can now be
         moved to a user specified directory. This useful for ensuring the
         database is backed up, for example by placing it in a <em>Dropbox</em>
         or <em>GoogleDrive</em> sub-folder. (This option is not available in the
-        portable edition.)
+        portable edition.) From v4.5.1 the database can also be relocated to a network drive.
+      </li>
+      <li>
+        <strong>[v4.7]</strong> Snippets can now be imported from the SWAG
+        (SourceWare Archive Group) collection of snippets.
+      </li>
+      <li>
+        <strong>[v4.20]</strong> The user defined database can now be deleted.
       </li>
     </ul>
     <h2>
@@ -186,6 +193,11 @@ <h2>
         The Welcome page has been completely redesigned to be cleaner and to
         provide more useful information about the databases and program.
       </li>
+      <li>
+        <strong>[v4.19.0/v4.20.0]</strong> From v4.19.0 the font size used in
+        the overview pane can be customised. The ability to change the font size
+        in the detail pane was added in v4.20.0.
+      </li>
     </ul>
     <h2>
       Favourites [v4.2]
@@ -232,6 +244,9 @@ <h2>
         required namespaces in the <em>Namespaces</em> tab of the
         <a href="dlg_configcompilers.htm">Configure Compilers</a> dialogue box.
       </li>
+      <li>
+        <strong>[v4.21.0]</strong> <em>CodeSnip</em> now detects newly installed Delphi compilers at start up.
+      </li>
     </ul>
     <h2>
       Other Features
diff --git a/Src/Help/HTML/reml.htm b/Src/Help/HTML/reml.htm
@@ -4,7 +4,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2009-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2009-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Help topic describing REML markup language.
 -->
diff --git a/Src/UCodeImportExport.pas b/Src/UCodeImportExport.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2008-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2008-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Implements classes that can import and export user defined snippets from and
  * to XML.
diff --git a/Src/UConsts.pas b/Src/UConsts.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2009-2022, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2009-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Defines various character, string and resource id constants.
 }
diff --git a/Src/UEncodings.pas b/Src/UEncodings.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2009-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2009-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Provides support for certain character encodings used by the program.
 }
diff --git a/Src/UGraphicUtils.pas b/Src/UGraphicUtils.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2006-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2006-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Utility routines used for working with graphics.
 }
diff --git a/Src/UREMLDataIO.pas b/Src/UREMLDataIO.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2008-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2008-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Implements classes that render and parse Routine Extra Markup Language (REML)
  * code. This markup is used to read and store active text objects as used by
diff --git a/Src/URTFBuilder.pas b/Src/URTFBuilder.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2006-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2006-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Implements various classes used to create content of a rich text document.
 }
diff --git a/Src/URTFSnippetDoc.pas b/Src/URTFSnippetDoc.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2008-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2008-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Implements a class that renders a document that describes a snippet as rich
  * text.
diff --git a/Src/URTFStyles.pas b/Src/URTFStyles.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2012-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2012-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Defines structures that encapsulate RTF styling elements.
 }
diff --git a/Src/URTFUtils.pas b/Src/URTFUtils.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2005-2022, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2005-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Utility functions used when processing RTF.
 }
diff --git a/Src/USnippetDoc.pas b/Src/USnippetDoc.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2008-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2008-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Implements an abstract base class that renders a text document that describes
  * a snippet. Should be overridden by classes that generate actual documents in
diff --git a/Src/USnippetExtraHelper.pas b/Src/USnippetExtraHelper.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2008-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2008-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Implements a class that helps with parsing of a snippet's extra property as
  * active text and vice versa.
diff --git a/Src/USourceGen.pas b/Src/USourceGen.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2005-2022, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2005-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Implements a class that is used to generate Pascal source code containing
  * specified database snippets.
diff --git a/Src/UStrUtils.pas b/Src/UStrUtils.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2011-2021, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2011-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Unicode string utility routines.
  *
diff --git a/Src/UTextSnippetDoc.pas b/Src/UTextSnippetDoc.pas
@@ -3,7 +3,7 @@
  * v. 2.0. If a copy of the MPL was not distributed with this file, You can
  * obtain one at https://mozilla.org/MPL/2.0/
  *
- * Copyright (C) 2009-2022, Peter Johnson (gravatar.com/delphidabbler).
+ * Copyright (C) 2009-2023, Peter Johnson (gravatar.com/delphidabbler).
  *
  * Implements a class that renders a document that describes a snippet as plain
  * text.
diff --git a/Src/VersionInfo.vi-inc b/Src/VersionInfo.vi-inc
@@ -1,8 +1,8 @@
 # CodeSnip Version Information Macros for Including in .vi files
 
 # Version & build numbers
-version=4.21.0
-build=267
+version=4.21.1
+build=268
 
 # String file information
 copyright=Copyright © P.D.Johnson, 2005-<YEAR>.

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`<!DOCTYPE HTML>`
`2`	`2`
`3`	`3`	`<!--`
`4`		`- * This file copyright (C) 2020-2021, Peter Johnson (gravatar.com/delphidabbler) and`
	`4`	`+ * This file copyright (C) 2020-2023, Peter Johnson (gravatar.com/delphidabbler) and`
`5`	`5`	`* is licensed under the MIT License: https://opensource.org/licenses/MIT`
`6`	`6`	`*`
`7`	`7`	`* DelphiDabbler Code Snippets Database Documentation: REML markup language`
Original file line number	Diff line number	Diff line change
`@@ -3,7 +3,7 @@`
`3`	`3`	`* v. 2.0. If a copy of the MPL was not distributed with this file, You can`
`4`	`4`	`* obtain one at https://mozilla.org/MPL/2.0/`
`5`	`5`	`*`
`6`		`- * Copyright (C) 2009-2022, Peter Johnson (gravatar.com/delphidabbler).`
	`6`	`+ * Copyright (C) 2009-2023, Peter Johnson (gravatar.com/delphidabbler).`
`7`	`7`	`*`
`8`	`8`	`* Provides a class that renders active text as HTML.`
`9`	`9`	`}`
Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@`
`4`	`4`	`* v. 2.0. If a copy of the MPL was not distributed with this file, You can`
`5`	`5`	`* obtain one at https://mozilla.org/MPL/2.0/`
`6`	`6`	`*`
`7`		`- * Copyright (C) 2009-2021, Peter Johnson (gravatar.com/delphidabbler).`
	`7`	`+ * Copyright (C) 2009-2023, Peter Johnson (gravatar.com/delphidabbler).`
`8`	`8`	`*`
`9`	`9`	`* Help topic describing REML markup language.`
`10`	`10`	`-->`