From 46fc9a7c5fea3e1b80cfa8a7f05f42b1b9b7801f Mon Sep 17 00:00:00 2001 From: pewgeuges <73141620+pewgeuges@users.noreply.github.com> Date: Fri, 5 Mar 2021 04:30:50 +0100 Subject: [PATCH 1/5] Adapt after the 2.5.9d1 accident. --- class/dashboard/layout.php | 4 +- class/init.php | 12 ++--- footnotes.php | 94 ++++++++++++++++++++++++++++++-------- readme.txt | 13 ++++-- 4 files changed, 92 insertions(+), 31 deletions(-) diff --git a/class/dashboard/layout.php b/class/dashboard/layout.php index 4908403..6e48570 100644 --- a/class/dashboard/layout.php +++ b/class/dashboard/layout.php @@ -213,11 +213,11 @@ abstract class MCI_Footnotes_Layout_Engine { */ if ( C_BOOL_CSS_PRODUCTION_MODE === true ) { - wp_register_style( 'mci-footnotes-admin', plugins_url( 'footnotes/css/settings.min.css' ), array(), C_STR_FOOTNOTES_VERSION ); + wp_register_style( 'mci-footnotes-admin', plugins_url( 'footnotes/css/settings.min.css' ), array(), C_STR_PACKAGE_VERSION ); } else { - wp_register_style( 'mci-footnotes-admin', plugins_url( 'footnotes/css/settings.css' ), array(), C_STR_FOOTNOTES_VERSION ); + wp_register_style( 'mci-footnotes-admin', plugins_url( 'footnotes/css/settings.css' ), array(), C_STR_PACKAGE_VERSION ); } diff --git a/class/init.php b/class/init.php index 45cd4ec..94daec1 100644 --- a/class/init.php +++ b/class/init.php @@ -306,7 +306,7 @@ class MCI_Footnotes { * Plugin version number is needed for busting browser caches after each plugin update. * @since 2.1.4 automate passing version number for cache busting. * @date 2020-11-30T0646+0100 - * The constant C_STR_FOOTNOTES_VERSION is defined at start of footnotes.php. + * The constant C_STR_PACKAGE_VERSION is defined at start of footnotes.php. * * The media scope argument 'all' is the default. * No need to use '-css' in the handle, as this is appended automatically. @@ -350,7 +350,7 @@ class MCI_Footnotes { MCI_Footnotes_Config::C_STR_PLUGIN_NAME . '/css/footnotes-' . $l_str_tooltip_mode_short . 'ttbrpl' . $l_str_layout_mode . '.min.css' ), array(), - C_STR_FOOTNOTES_VERSION, + C_STR_PACKAGE_VERSION, 'all' ); @@ -364,9 +364,9 @@ class MCI_Footnotes { * * This optional layout fix is useful by lack of layout support. */ - wp_enqueue_style( 'mci-footnotes-common', plugins_url( MCI_Footnotes_Config::C_STR_PLUGIN_NAME . '/css/dev-common.css' ), array(), C_STR_FOOTNOTES_VERSION ); - wp_enqueue_style( 'mci-footnotes-tooltips', plugins_url( MCI_Footnotes_Config::C_STR_PLUGIN_NAME . '/css/dev-tooltips.css' ), array(), C_STR_FOOTNOTES_VERSION ); - wp_enqueue_style( 'mci-footnotes-alternative', plugins_url( MCI_Footnotes_Config::C_STR_PLUGIN_NAME . '/css/dev-tooltips-alternative.css' ), array(), C_STR_FOOTNOTES_VERSION ); + wp_enqueue_style( 'mci-footnotes-common', plugins_url( MCI_Footnotes_Config::C_STR_PLUGIN_NAME . '/css/dev-common.css' ), array(), C_STR_PACKAGE_VERSION ); + wp_enqueue_style( 'mci-footnotes-tooltips', plugins_url( MCI_Footnotes_Config::C_STR_PLUGIN_NAME . '/css/dev-tooltips.css' ), array(), C_STR_PACKAGE_VERSION ); + wp_enqueue_style( 'mci-footnotes-alternative', plugins_url( MCI_Footnotes_Config::C_STR_PLUGIN_NAME . '/css/dev-tooltips-alternative.css' ), array(), C_STR_PACKAGE_VERSION ); $l_str_page_layout_option = MCI_Footnotes_Settings::instance()->get( MCI_Footnotes_Settings::C_STR_FOOTNOTES_PAGE_LAYOUT_SUPPORT ); if ( 'none' !== $l_str_page_layout_option ) { @@ -376,7 +376,7 @@ class MCI_Footnotes { MCI_Footnotes_Config::C_STR_PLUGIN_NAME . '/css/dev-layout-' . $l_str_page_layout_option . '.css' ), array(), - C_STR_FOOTNOTES_VERSION, + C_STR_PACKAGE_VERSION, 'all' ); } diff --git a/footnotes.php b/footnotes.php index 047d538..1e37566 100755 --- a/footnotes.php +++ b/footnotes.php @@ -14,31 +14,87 @@ */ /** - * Version number for stylesheet cache busting. + * Package Version number for stylesheet cache busting. * + * Please keep this constant in sync with the Version in the header above, + * and also in sync with the Package Version in the header of the readme. + * DO NOT SYNC THE STABLE TAG VALUE WITH THE PACKAGE VERSION VALUE. * @since 2.1.4 * @since 2.5.3 (Hungarian) * @var str - * @lastmodified 2021-03-04T0526+0100 + * @lastmodified 2021-03-05T0427+0100 */ -define( 'C_STR_FOOTNOTES_VERSION', '2.5.11d1' ); +define( 'C_STR_PACKAGE_VERSION', '2.5.11d1' ); -/* - LICENSE NOTICE - - This program is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License, version 3, as - published by the Free Software Foundation. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this program; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ +/** + * Package Version vs Stable Tag version. + * + * WordPress plugin readmes are usually lacking the version number of the package. + * In Footnotes, this has been included after the stable tag had been mistaken for + * the package version, given that state-of-the-art readmes have that information. + * + * - Adding: Documentation: Readme: 'Package Version' field for information, after the 'Stable Tag' field parsed for release information. + * + * @since 2.5.11 + * @see readme.txt + * @link https://meta.trac.wordpress.org/ticket/5645#comment:5 + * + * - Bugfix: Codebase: revert to 2.5.8, thanks to @little-shiva @watershare @adjayabdg @staho @frav8 @voregnev @dsl225 @alexclassroom @a223123131 @codldmac bug reports. + * + * @version 2.5.10 (reversion to @version 2.5.8) + * @date 2021-03-01 11:09:29 +0000 + * @revision 2483464 + * @link https://plugins.trac.wordpress.org/changeset/2483464/footnotes/trunk + * + * @reporter @little-shiva + * @link https://wordpress.org/support/topic/footnotes-broke-two-of-my-client-sites/ + * + * @reporter @watershare + * @link https://wordpress.org/support/topic/latest-update-broke-my-site-19/ + * + * @reporter @adjayabdg + * @link https://wordpress.org/support/topic/latest-update-broke-my-site-19/#post-14115531 + * + * @reporter @staho + * @link https://wordpress.org/support/topic/version-2-5-9d1-breaks-wp-down/ + * + * @reporter @frav8 + * @link https://wordpress.org/support/topic/version-2-5-9d1-breaks-wp-down/#post-14115614 + * + * @reporter @voregnev + * @link https://wordpress.org/support/topic/version-2-5-9d1-breaks-wp-down/#post-14115632 + * + * @reporter @dsl225 + * @link https://wordpress.org/support/topic/version-2-5-9d1-breaks-wp-down/#post-14115820 + * + * @reporter @alexclassroom + * @link https://wordpress.org/support/topic/version-2-5-9d1-breaks-wp-down/#post-14115860 + * + * @reporter @a223123131 + * @link https://wordpress.org/support/topic/version-2-5-9d1-breaks-wp-down/#post-14115906 + * @link https://wordpress.org/support/topic/update-breaks-layout-3/ + * @link https://wordpress.org/support/topic/bugs-in-every-2nd-update/#post-14116804 + * + * @reporter @codldmac + * @link https://wordpress.org/support/topic/crashed-my-site-104/ + * + * The accidental release of 2.5.9d1 was due to 3 factors: + * + * 1. The codebase got overhauled for the sake of WordPress Coding Standards compliance, + * one requirement of which is that files be named after the name of the class in them; + * 2. The renamed folder was not added to Subversion version control due to an unexpected + * unfamiliarity with the system and its command line interface; + * 3. The Stable Tag field in the Readme header was used for the package version because + * the related field is lacking, and the use of file headers for release configuration + * is uncommon. + * + * @link https://wordpress.org/support/topic/2-5-10-reverts-2-5-9d1-and-apologies/ + * @link https://wordpress.org/support/topic/2-5-10-reverts-2-5-9d1-and-apologies/#post-14119440 + * @link https://github.com/markcheret/footnotes/issues/55 + * @link https://meta.trac.wordpress.org/ticket/5645 + * @link https://wordpress.org/plugins/readme.txt + * @link https://developer.wordpress.org/plugins/wordpress-org/how-your-readme-txt-works/ + */ /** * Plugin’s main PHP file. diff --git a/readme.txt b/readme.txt index 795e457..64d0d82 100644 --- a/readme.txt +++ b/readme.txt @@ -5,8 +5,9 @@ Requires at least: 3.9 Tested up to: 5.6.1 Requires PHP: 5.6 Stable Tag: 2.5.10 +Package Version: 2.5.11d1 License: GPLv3 or later -License URI: http://www.gnu.org/licenses/gpl-3.0.html +License URI: https://www.gnu.org/licenses/gpl-3.0.html == Description == @@ -19,7 +20,7 @@ https://www.youtube.com/watch?v=HzHaMAAJwbI **footnotes** gives you the ability to display well-formatted footnotes on your WordPress Pages and Posts — those footnotes we know from offline publishing. = Main Features = -- Fully customizable **footnotes** start and end shortcodes; +- Fully customizable **footnote** start and end shortcodes; - Styled tooltips supporting hyperlinks display **footnotes** or a dedicated text; - Responsive *Reference Container* at the end or positioned by shortcode; - Display the **footnotes** *Reference Container* inside a Widget; @@ -78,14 +79,18 @@ Visit this swift write-up from a **footnotes** user by the name of **Southwest** == Changelog == = 2.5.11 = +- Adding: Documentation: Readme: 'Package Version' field for information, after the 'Stable Tag' field parsed for release information. - Bugfix: Dashboard: unescape quotation marks in Custom CSS text area and input boxes, thanks to @rumperuu code contribution. - Update: Codebase: compliance to WordPress Coding Standards, thanks to @rumperuu code contribution. - Adding: Documentation: additional readme in markdown format for use with GitHub, thanks to @rumperuu code contribution. -- Adding: Documentation: help and support for individual contributors through Contributing Guidelines, thanks to @rumperuu code contribution. +- Adding: Documentation: help and support for contributors through Contributing Guidelines, thanks to @rumperuu code contribution. - Adding: Development: pre-commit hook for WordPress projects, modified from @bjornjohansen, thanks to @rumperuu code contribution. = 2.5.10 = -- Bugfix: Revert to 2.5.8. OUR APOLOGIES, PLEASE, FOR THE 2.5.9d1 PLUGIN 'Stable Tag' MISHAP. +- Bugfix: Codebase: revert to 2.5.8, thanks to @little-shiva @watershare @adjayabdg @staho @frav8 @voregnev @dsl225 @alexclassroom @a223123131 @codldmac bug reports. + += 2.5.9d1 = +- Update: Codebase: accident. OUR APOLOGIES, PLEASE, FOR THE 2.5.9d1 PLUGIN 'Stable Tag' MISHAP. = 2.5.8 = - Bugfix: Layout: support right-to-left writing direction by replacing remaining CSS values 'left' with 'start', thanks to @arahmanshaalan bug report. From f63dfde076d7bf87e040056d1a23c45803537bd8 Mon Sep 17 00:00:00 2001 From: pewgeuges <73141620+pewgeuges@users.noreply.github.com> Date: Fri, 5 Mar 2021 08:44:15 +0100 Subject: [PATCH 2/5] Corrections to changelog. --- development/customized-documentation-schema.txt | 8 +++++--- footnotes.php | 4 +++- readme.txt | 12 ++++++------ 3 files changed, 14 insertions(+), 10 deletions(-) diff --git a/development/customized-documentation-schema.txt b/development/customized-documentation-schema.txt index dbb72e9..7ce343a 100644 --- a/development/customized-documentation-schema.txt +++ b/development/customized-documentation-schema.txt @@ -1,5 +1,5 @@ customized-documentation-schema.txt -@lastmodified 2021-02-15T2022+0100 +@lastmodified 2021-03-05T0501+0100 Plugin Footnotes for WordPress, v2.5.4 and later @@ -255,10 +255,12 @@ MISSING TAGS: @modified @publisher @reporter +@revision +@timestamp @user -▲ Config (original, missing and added tags), example of VS Code +▲ Config (original, missing and added tags), example of VS Code. /usr/share/code/resources/app/extensions/php/syntaxes/php.tmLanguage.json original: @@ -274,4 +276,4 @@ PHPStan: |extends|implements|template custom: -|accountable|bib|biblio|callback|commit|committer|contributor|courtesy|date|datetime|lastmodified|modified|publisher|reporter|user +|accountable|bib|biblio|callback|commit|committer|contributor|courtesy|date|datetime|lastmodified|modified|publisher|reporter|revision|timestamp|user diff --git a/footnotes.php b/footnotes.php index 1e37566..86a2216 100755 --- a/footnotes.php +++ b/footnotes.php @@ -19,10 +19,11 @@ * Please keep this constant in sync with the Version in the header above, * and also in sync with the Package Version in the header of the readme. * DO NOT SYNC THE STABLE TAG VALUE WITH THE PACKAGE VERSION VALUE. + * @see full docblock below. * @since 2.1.4 * @since 2.5.3 (Hungarian) * @var str - * @lastmodified 2021-03-05T0427+0100 + * @lastmodified 2021-03-05T0457+0100 */ define( 'C_STR_PACKAGE_VERSION', '2.5.11d1' ); @@ -36,6 +37,7 @@ define( 'C_STR_PACKAGE_VERSION', '2.5.11d1' ); * - Adding: Documentation: Readme: 'Package Version' field for information, after the 'Stable Tag' field parsed for release information. * * @since 2.5.11 + * @see C_STR_PACKAGE_VERSION * @see readme.txt * @link https://meta.trac.wordpress.org/ticket/5645#comment:5 * diff --git a/readme.txt b/readme.txt index 64d0d82..cfa9849 100644 --- a/readme.txt +++ b/readme.txt @@ -79,18 +79,18 @@ Visit this swift write-up from a **footnotes** user by the name of **Southwest** == Changelog == = 2.5.11 = -- Adding: Documentation: Readme: 'Package Version' field for information, after the 'Stable Tag' field parsed for release information. -- Bugfix: Dashboard: unescape quotation marks in Custom CSS text area and input boxes, thanks to @rumperuu code contribution. -- Update: Codebase: compliance to WordPress Coding Standards, thanks to @rumperuu code contribution. +- Adding: Documentation: Readme: Header: 'Package Version' field for information, after the 'Stable Tag' field (parsed for release configuration), to prevent further misuse. +- Bugfix: Dashboard: debug text input fields by disabling quotation mark escapement, thanks to @rumperuu code contribution during the codebase conformance overhaul. +- Update: Codebase: make all PHP code comply to WordPress Coding Standards requirements, thanks to @rumperuu code contribution and refactoring. - Adding: Documentation: additional readme in markdown format for use with GitHub, thanks to @rumperuu code contribution. -- Adding: Documentation: help and support for contributors through Contributing Guidelines, thanks to @rumperuu code contribution. +- Adding: Documentation: help and support for contributors by the means of Contributing Guidelines, thanks to @rumperuu code contribution. - Adding: Development: pre-commit hook for WordPress projects, modified from @bjornjohansen, thanks to @rumperuu code contribution. = 2.5.10 = -- Bugfix: Codebase: revert to 2.5.8, thanks to @little-shiva @watershare @adjayabdg @staho @frav8 @voregnev @dsl225 @alexclassroom @a223123131 @codldmac bug reports. +- Bugfix: Codebase: revert to 2.5.8 with apologies (below), thanks to @little-shiva @watershare @adjayabdg @staho @frav8 @voregnev @dsl225 @alexclassroom @a223123131 @codldmac bug reports. = 2.5.9d1 = -- Update: Codebase: accident. OUR APOLOGIES, PLEASE, FOR THE 2.5.9d1 PLUGIN 'Stable Tag' MISHAP. +- Update: Codebase: accidental release of trunk/, tagged when 2.5.10 was released 3½ h later. OUR APOLOGIES, PLEASE, FOR THE 2.5.9d1 PLUGIN 'Stable Tag' MISHAP. = 2.5.8 = - Bugfix: Layout: support right-to-left writing direction by replacing remaining CSS values 'left' with 'start', thanks to @arahmanshaalan bug report. From 6ff77dc74d764697ed48f414ed370096d1327f97 Mon Sep 17 00:00:00 2001 From: pewgeuges <73141620+pewgeuges@users.noreply.github.com> Date: Fri, 5 Mar 2021 08:58:48 +0100 Subject: [PATCH 3/5] =?UTF-8?q?Also=20added=20@=E2=80=8Crevision=20and=20@?= =?UTF-8?q?=E2=80=8Ctimestamp=20PHPDOC=20tags=20@=E2=80=8Crevision=20and?= =?UTF-8?q?=20@=E2=80=8Ctimestamp=20used=20for=20SVN=20refs.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Full enumeration of added custom PHPDOC tags: @‌accountable, @‌bib, @‌biblio, @‌callback, @‌commit, @‌committer, @‌contributor, @‌courtesy, @‌date, @‌datetime, @‌lastmodified, @‌modified, @‌publisher, @‌reporter, @‌revision, @‌timestamp, @‌user.Some tags like @‌reporter and @‌contributor are more used than others. --- footnotes.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/footnotes.php b/footnotes.php index 86a2216..d601ec1 100755 --- a/footnotes.php +++ b/footnotes.php @@ -44,8 +44,8 @@ define( 'C_STR_PACKAGE_VERSION', '2.5.11d1' ); * - Bugfix: Codebase: revert to 2.5.8, thanks to @little-shiva @watershare @adjayabdg @staho @frav8 @voregnev @dsl225 @alexclassroom @a223123131 @codldmac bug reports. * * @version 2.5.10 (reversion to @version 2.5.8) - * @date 2021-03-01 11:09:29 +0000 * @revision 2483464 + * @timestamp 2021-03-01 11:09:29 +0000 * @link https://plugins.trac.wordpress.org/changeset/2483464/footnotes/trunk * * @reporter @little-shiva From 0e6c5a8f87c83a238d5376d4064476d2b5dac02f Mon Sep 17 00:00:00 2001 From: pewgeuges <73141620+pewgeuges@users.noreply.github.com> Date: Mon, 8 Mar 2021 10:10:32 +0100 Subject: [PATCH 4/5] Readme header upgrade. --- footnotes.php | 19 ++++++++++--------- readme.txt | 12 ++++++++---- 2 files changed, 18 insertions(+), 13 deletions(-) diff --git a/footnotes.php b/footnotes.php index d601ec1..b7ab5f2 100755 --- a/footnotes.php +++ b/footnotes.php @@ -23,24 +23,25 @@ * @since 2.1.4 * @since 2.5.3 (Hungarian) * @var str - * @lastmodified 2021-03-05T0457+0100 + * @lastmodified 2021-03-08T1008+0100 */ define( 'C_STR_PACKAGE_VERSION', '2.5.11d1' ); /** - * Package Version vs Stable Tag version. + * Version numbers in a WordPress plugin readme.txt header. + * + * - Adding: Documentation: Readme.txt: informative 'Package Version' field in sync with the package version currently hidden in the main PHP script header. + * - Adding: Documentation: Readme.txt: informative 'Tagged Version' field pointing a tag folder in SVN for bugfix versions available ahead of the stable tag. + * - Adding: Documentation: Readme.txt: comment line below the 'Stable Tag' field to warn that this is (unexpectedly) parsed for release configuration. + * + * @since 2.5.11 + * @see readme.txt + * @link https://meta.trac.wordpress.org/ticket/5652 * * WordPress plugin readmes are usually lacking the version number of the package. * In Footnotes, this has been included after the stable tag had been mistaken for * the package version, given that state-of-the-art readmes have that information. * - * - Adding: Documentation: Readme: 'Package Version' field for information, after the 'Stable Tag' field parsed for release information. - * - * @since 2.5.11 - * @see C_STR_PACKAGE_VERSION - * @see readme.txt - * @link https://meta.trac.wordpress.org/ticket/5645#comment:5 - * * - Bugfix: Codebase: revert to 2.5.8, thanks to @little-shiva @watershare @adjayabdg @staho @frav8 @voregnev @dsl225 @alexclassroom @a223123131 @codldmac bug reports. * * @version 2.5.10 (reversion to @version 2.5.8) diff --git a/readme.txt b/readme.txt index cfa9849..1ec1bce 100644 --- a/readme.txt +++ b/readme.txt @@ -4,8 +4,10 @@ Tags: footnote, footnotes, bibliography, formatting, notes, Post, posts, referen Requires at least: 3.9 Tested up to: 5.6.1 Requires PHP: 5.6 -Stable Tag: 2.5.10 Package Version: 2.5.11d1 +Tagged Version: 2.5.10 +Stable Tag: 2.5.10 +CAUTION: THE S. T. FIELD IS PARSED FOR RELEASE CONFIGURATION. License: GPLv3 or later License URI: https://www.gnu.org/licenses/gpl-3.0.html @@ -79,11 +81,13 @@ Visit this swift write-up from a **footnotes** user by the name of **Southwest** == Changelog == = 2.5.11 = -- Adding: Documentation: Readme: Header: 'Package Version' field for information, after the 'Stable Tag' field (parsed for release configuration), to prevent further misuse. +- Adding: Documentation: Readme.txt: comment line below the 'Stable Tag' field to warn that this is (unexpectedly) parsed for release configuration. +- Adding: Documentation: Readme.txt: informative 'Tagged Version' field pointing a tag folder in SVN for bugfix versions available ahead of the stable tag. +- Adding: Documentation: Readme.txt: informative 'Package Version' field in sync with the package version currently hidden in the main PHP script header. - Bugfix: Dashboard: debug text input fields by disabling quotation mark escapement, thanks to @rumperuu code contribution during the codebase conformance overhaul. - Update: Codebase: make all PHP code comply to WordPress Coding Standards requirements, thanks to @rumperuu code contribution and refactoring. -- Adding: Documentation: additional readme in markdown format for use with GitHub, thanks to @rumperuu code contribution. -- Adding: Documentation: help and support for contributors by the means of Contributing Guidelines, thanks to @rumperuu code contribution. +- Adding: Documentation: additional readme in markdown format 'README.md' for use with GitHub, thanks to @rumperuu code contribution. +- Adding: Documentation: help and support for contributors by the means of Contributing Guidelines 'CONTRIBUTING.md', thanks to @rumperuu code contribution. - Adding: Development: pre-commit hook for WordPress projects, modified from @bjornjohansen, thanks to @rumperuu code contribution. = 2.5.10 = From b6f6ff76f372e23602d3efc853cdd31f6558758e Mon Sep 17 00:00:00 2001 From: pewgeuges <73141620+pewgeuges@users.noreply.github.com> Date: Thu, 11 Mar 2021 06:26:34 +0100 Subject: [PATCH 5/5] Version number related fixes before pull request. --- footnotes.php | 53 +++++++++++++++++++++++++++++++-------------------- readme.txt | 2 +- 2 files changed, 33 insertions(+), 22 deletions(-) diff --git a/footnotes.php b/footnotes.php index b7ab5f2..869c62a 100755 --- a/footnotes.php +++ b/footnotes.php @@ -19,78 +19,89 @@ * Please keep this constant in sync with the Version in the header above, * and also in sync with the Package Version in the header of the readme. * DO NOT SYNC THE STABLE TAG VALUE WITH THE PACKAGE VERSION VALUE. - * @see full docblock below. + * * @since 2.1.4 * @since 2.5.3 (Hungarian) * @var str - * @lastmodified 2021-03-08T1008+0100 + * @lastmodified 2021-03-11T0623+0100 */ define( 'C_STR_PACKAGE_VERSION', '2.5.11d1' ); /** * Version numbers in a WordPress plugin readme.txt header. - * + * * - Adding: Documentation: Readme.txt: informative 'Package Version' field in sync with the package version currently hidden in the main PHP script header. * - Adding: Documentation: Readme.txt: informative 'Tagged Version' field pointing a tag folder in SVN for bugfix versions available ahead of the stable tag. * - Adding: Documentation: Readme.txt: comment line below the 'Stable Tag' field to warn that this is (unexpectedly) parsed for release configuration. - * + * * @since 2.5.11 * @see readme.txt * @link https://meta.trac.wordpress.org/ticket/5652 - * + * + * Package Version Actual version string. + * May identify a development version. + * A 'd' series is suffixed to incremented bugfix version. + * + * Tagged Version Refers to the latest tag. + * Typically the best available version. + * May not be released, due to release frequency concerns. + * + * Stable Tag Parsed in trunk/ for release configuration. + * Must not be greater than the Version in MAIN.php header. + * * WordPress plugin readmes are usually lacking the version number of the package. * In Footnotes, this has been included after the stable tag had been mistaken for * the package version, given that state-of-the-art readmes have that information. - * + * * - Bugfix: Codebase: revert to 2.5.8, thanks to @little-shiva @watershare @adjayabdg @staho @frav8 @voregnev @dsl225 @alexclassroom @a223123131 @codldmac bug reports. - * + * * @version 2.5.10 (reversion to @version 2.5.8) * @revision 2483464 * @timestamp 2021-03-01 11:09:29 +0000 * @link https://plugins.trac.wordpress.org/changeset/2483464/footnotes/trunk - * + * * @reporter @little-shiva * @link https://wordpress.org/support/topic/footnotes-broke-two-of-my-client-sites/ - * + * * @reporter @watershare * @link https://wordpress.org/support/topic/latest-update-broke-my-site-19/ - * + * * @reporter @adjayabdg * @link https://wordpress.org/support/topic/latest-update-broke-my-site-19/#post-14115531 - * + * * @reporter @staho * @link https://wordpress.org/support/topic/version-2-5-9d1-breaks-wp-down/ - * + * * @reporter @frav8 * @link https://wordpress.org/support/topic/version-2-5-9d1-breaks-wp-down/#post-14115614 - * + * * @reporter @voregnev * @link https://wordpress.org/support/topic/version-2-5-9d1-breaks-wp-down/#post-14115632 - * + * * @reporter @dsl225 * @link https://wordpress.org/support/topic/version-2-5-9d1-breaks-wp-down/#post-14115820 - * + * * @reporter @alexclassroom * @link https://wordpress.org/support/topic/version-2-5-9d1-breaks-wp-down/#post-14115860 - * + * * @reporter @a223123131 * @link https://wordpress.org/support/topic/version-2-5-9d1-breaks-wp-down/#post-14115906 * @link https://wordpress.org/support/topic/update-breaks-layout-3/ * @link https://wordpress.org/support/topic/bugs-in-every-2nd-update/#post-14116804 - * + * * @reporter @codldmac * @link https://wordpress.org/support/topic/crashed-my-site-104/ - * + * * The accidental release of 2.5.9d1 was due to 3 factors: - * + * * 1. The codebase got overhauled for the sake of WordPress Coding Standards compliance, * one requirement of which is that files be named after the name of the class in them; * 2. The renamed folder was not added to Subversion version control due to an unexpected * unfamiliarity with the system and its command line interface; * 3. The Stable Tag field in the Readme header was used for the package version because - * the related field is lacking, and the use of file headers for release configuration + * the related field is lacking, and the use of file headers for release configuration * is uncommon. - * + * * @link https://wordpress.org/support/topic/2-5-10-reverts-2-5-9d1-and-apologies/ * @link https://wordpress.org/support/topic/2-5-10-reverts-2-5-9d1-and-apologies/#post-14119440 * @link https://github.com/markcheret/footnotes/issues/55 diff --git a/readme.txt b/readme.txt index 1ec1bce..3a968b0 100644 --- a/readme.txt +++ b/readme.txt @@ -223,7 +223,7 @@ Visit this swift write-up from a **footnotes** user by the name of **Southwest** = 2.2.0 = - Adding: Reference container: support for custom position shortcode, thanks to @hamshe issue report. -- Adding: Start/end short codes: more predefined options. +- Adding: Dashboard: Footnote delimiters: more predefined options. - Adding: Numbering styles: lowercase Roman numerals support. - Update: Priority levels: update the notice in the dashboard Priority tab. - Update: Dashboard: Tooltip settings: group into 3 thematic containers.