From c3da1a21ed2b8646f60ca3aecd1c2076d5aed0f1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabian=20Gra=C3=9Fl?= Date: Fri, 30 Oct 2026 12:06:07 +0100 Subject: [PATCH 1/2] The pins and the download URLs move with the release MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The site installs the three libraries as path repositories and names a released version twice — once in `require` and once in the path repository's `versions` map — so both have to move to the version that was just released. The directives package goes to 0.3.1 and the two converters to 0.3.0, and the lock follows the pins: a lock that names an older version fails the install rather than the build, and the message names the repository that is outranked. The assets of `mdoffice` are named after the version, so the three download URLs and the ARM asset one of them names move to 0.1.2. A URL naming a version that was never published is a 404 forever. --- composer.json | 12 ++++++------ composer.lock | 19 ++++++++----------- content/command-line/installation.md | 8 ++++---- content/index.md | 2 +- 4 files changed, 19 insertions(+), 22 deletions(-) diff --git a/composer.json b/composer.json index 44828a0..9b904ed 100644 --- a/composer.json +++ b/composer.json @@ -16,9 +16,9 @@ "ext-mbstring": "*", "ext-zip": "*", "league/commonmark": "^2.10", - "markdown-office/commonmark-generic-directives": "0.3.0", - "markdown-office/markdown-word": "dev-main", - "markdown-office/markdown-presentation": "dev-main" + "markdown-office/commonmark-generic-directives": "0.3.1", + "markdown-office/markdown-word": "0.3.0", + "markdown-office/markdown-presentation": "0.3.0" }, "repositories": [ { @@ -27,7 +27,7 @@ "options": { "symlink": true, "versions": { - "markdown-office/commonmark-generic-directives": "0.3.0" + "markdown-office/commonmark-generic-directives": "0.3.1" } } }, @@ -37,7 +37,7 @@ "options": { "symlink": true, "versions": { - "markdown-office/markdown-word": "dev-main" + "markdown-office/markdown-word": "0.3.0" } } }, @@ -47,7 +47,7 @@ "options": { "symlink": true, "versions": { - "markdown-office/markdown-presentation": "dev-main" + "markdown-office/markdown-presentation": "0.3.0" } } } diff --git a/composer.lock b/composer.lock index fbe16e5..1034750 100644 --- a/composer.lock +++ b/composer.lock @@ -4,7 +4,7 @@ "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies", "This file is @generated automatically" ], - "content-hash": "a7c52b0758fa031d56ea2f018057c411", + "content-hash": "f02be1a581d0a05697fef81b470d57b1", "packages": [ { "name": "composer/pcre", @@ -656,11 +656,11 @@ }, { "name": "markdown-office/commonmark-generic-directives", - "version": "0.3.0", + "version": "0.3.1", "dist": { "type": "path", "url": "../commonmark-generic-directives", - "reference": "7e4c56b1e9e78d57b4684dc99f13e8899d919ec8" + "reference": "ffcda3df4f06a3b8d03712c2756367575236377d" }, "require": { "league/commonmark": "^2.10", @@ -736,11 +736,11 @@ }, { "name": "markdown-office/markdown-presentation", - "version": "dev-main", + "version": "0.3.0", "dist": { "type": "path", "url": "../markdown-presentation", - "reference": "06da2e48f72b9df0309b6a0ac4bb991e651079bd" + "reference": "18a7004a5d7f364047dd3659e6edf5af5bbbeb0e" }, "require": { "cweagans/composer-patches": "^2.0", @@ -832,11 +832,11 @@ }, { "name": "markdown-office/markdown-word", - "version": "dev-main", + "version": "0.3.0", "dist": { "type": "path", "url": "../markdown-word", - "reference": "707f5f05c05a6d9ce9880fe88390341c330f3ee6" + "reference": "4ce60b53dbc253b3b5f1af1e7b2b39b240b370ee" }, "require": { "ext-dom": "*", @@ -5972,10 +5972,7 @@ ], "aliases": [], "minimum-stability": "dev", - "stability-flags": { - "markdown-office/markdown-presentation": 20, - "markdown-office/markdown-word": 20 - }, + "stability-flags": {}, "prefer-stable": true, "prefer-lowest": false, "platform": { diff --git a/content/command-line/installation.md b/content/command-line/installation.md index d6a9a3c..3586b8a 100644 --- a/content/command-line/installation.md +++ b/content/command-line/installation.md @@ -26,7 +26,7 @@ winget install markdown-office.mdoffice {% endtab %} {% tab "Linux" %} ```bash -curl -L -o mdoffice https://github.com/markdown-office/mdoffice/releases/latest/download/mdoffice-0.1.1-linux-x86_64 +curl -L -o mdoffice https://github.com/markdown-office/mdoffice/releases/latest/download/mdoffice-0.1.2-linux-x86_64 chmod +x mdoffice ``` {% endtab %} @@ -37,7 +37,7 @@ composer require markdown-office/mdoffice {% endtab %} {% endtabs %} -On ARM, the Linux asset is `mdoffice-0.1.1-linux-aarch64`. +On ARM, the Linux asset is `mdoffice-0.1.2-linux-aarch64`. **The release is out**, and the executables and the archive are on [the releases page](https://github.com/markdown-office/mdoffice/releases) with the checksum of @@ -84,7 +84,7 @@ signature is an ad-hoc one and the binary is not notarised. Fetching the file wi `curl` does not set the flag: ```bash -curl -L -o mdoffice https://github.com/markdown-office/mdoffice/releases/latest/download/mdoffice-0.1.1-macos-arm64 +curl -L -o mdoffice https://github.com/markdown-office/mdoffice/releases/latest/download/mdoffice-0.1.2-macos-arm64 chmod +x mdoffice ``` @@ -105,7 +105,7 @@ The same program as a PHAR, for a machine that has PHP and would rather not down a second copy of it: ```bash -curl -L -o mdoffice.phar https://github.com/markdown-office/mdoffice/releases/latest/download/mdoffice-0.1.1.phar +curl -L -o mdoffice.phar https://github.com/markdown-office/mdoffice/releases/latest/download/mdoffice-0.1.2.phar php mdoffice.phar word notes.md ``` diff --git a/content/index.md b/content/index.md index 1e046c3..0bd3e6c 100644 --- a/content/index.md +++ b/content/index.md @@ -33,7 +33,7 @@ winget install markdown-office.mdoffice {% endtab %} {% tab "Linux" %} ```bash -curl -L -o mdoffice https://github.com/markdown-office/mdoffice/releases/latest/download/mdoffice-0.1.1-linux-x86_64 +curl -L -o mdoffice https://github.com/markdown-office/mdoffice/releases/latest/download/mdoffice-0.1.2-linux-x86_64 chmod +x mdoffice ``` {% endtab %} From 3c849d534c1a1a66b24b05e5d27fb4b0263631e2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fabian=20Gra=C3=9Fl?= Date: Fri, 30 Oct 2026 12:10:23 +0100 Subject: [PATCH 2/2] The `--version` transcript is of an installed copy MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The page shows what an installed copy answers, and the answer changed with the release: the tool is `0.1.2`, and it holds the `v0.3.0` of both converters. The libraries were read from the install rather than declared, so the numbers are the ones the program prints. That includes the `v` in front of the library versions, which the transcript was missing: a released copy reads its libraries from Packagist, where the version is the tag — `v0.3.0` — and the published `0.1.1` answers `v0.2.2` on both lines. A checkout answers with the branch it resolved rather than with a release, which is what the prose below the transcript says, and the padding is the program's own: the version starts in the same column on both lines, in the transcript and in the output. --- content/command-line/basic.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/command-line/basic.md b/content/command-line/basic.md index 6d9da9b..0854892 100644 --- a/content/command-line/basic.md +++ b/content/command-line/basic.md @@ -180,9 +180,9 @@ An installed copy answers with its own version and the two libraries it holds: ```bash $ mdoffice --version -mdoffice 0.1.1 - markdown-office/markdown-word 0.2.2 - markdown-office/markdown-presentation 0.2.2 +mdoffice 0.1.2 + markdown-office/markdown-word v0.3.0 + markdown-office/markdown-presentation v0.3.0 ``` The tool versions itself separately from the libraries it holds, because it is neither of them: a @@ -195,5 +195,5 @@ answers with the branch it resolved rather than with a release, because that is ```bash $ mdoffice word --version -mdoffice word 0.2.2 +mdoffice word v0.3.0 ```