v6.3

.github/workflows/clean-build.yaml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        go-version: [ "1.20", "1.21", "1.22" ]
+        go-version: [ "1.20", "1.21", "1.22", "1.23" ]
 
     steps:
       - name: Setup Go ${{ matrix.go-version }}

.github/workflows/code-coverage.yaml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        go-version: [ "1.22" ]
+        go-version: [ "1.23" ]
     env:
       MUREX_TEST_NO_EXEC_DEPS: true
     steps:

.github/workflows/deploy-dev-docs.yaml

@@ -24,7 +24,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        go-version: [ "1.22" ]
+        go-version: [ "1.23" ]
 
     steps:
       - name: Checkout

.github/workflows/deploy-docs.yaml

@@ -22,7 +22,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        go-version: [ "1.22" ]
+        go-version: [ "1.23" ]
 
     steps:
       - name: Checkout

.github/workflows/murex-downloads.yaml

@@ -8,7 +8,7 @@ on:
   workflow_dispatch:
 
 env:
-  GO_VERSION: "1.21"
+  GO_VERSION: "1.23"
 
 jobs:
   Build-Downloads:

.github/workflows/murex-tests.yaml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        go-version: [ '1.20', '1.21', '1.22' ]
+        go-version: [ '1.20', '1.21', '1.22', "1.23" ]
     env:
       MUREX_BUILD_FLAGS: --no-colour
       MUREX_TEST_NO_EXEC_DEPS: true

.gitignore

@@ -5,6 +5,8 @@ murex.exe
 murex.upx
 /docgen
 /docgen.exe
+/stringer
+/stringer.exe
 bin/
 VERSION
 deleteme.db
@@ -23,12 +25,15 @@ wasm_exec.js
 # optional builtins
 /builtins/imports_build
 
-# test working directories
+# test and debugging files
 /deleteme
 /test/tmp
 *.test
 *.prof
 *.pprof
+*local.*
+
+debug.log
 
 # IDE
 .idea/
@@ -41,7 +46,6 @@ murex.iml
 /vendor.new
 /pkg
 /src
-/gen/docs-test/
 
 # Misc
 .DS_Store

CONTRIBUTING.md

@@ -1,6 +1,7 @@
-<h1>Contributing to Murex</h1>
 
-Murex is community project. We gratefully accept contributions.
+<h1>How To Contribute</h1>
+
+> Murex is community project. We gratefully accept contributions
 
 <h2>Table of Contents</h2>
 
@@ -38,11 +39,17 @@ please do raise a pull request.
 All documentation is written in markdown. Even the website is HTML generated
 from the original markdown documents. And all markdown documents are themselves
 generated from files with the extension `_doc.yaml`. These template files are
-the backbone of the documentation's pseudo-CMS.
+the backbone of the documentation's static site CMS.
+
+Each generated markdown file has a footer with a link to the YAML file that it
+was generated from.
+
+You can compile the markdown files by running `go generate` from the root of
+the project directory:
 
-If you are unsure where to find a document, you can either `grep` the source
-repository for a known phrase, or ask in the [Github discussions](https://github.com/lmorg/murex/discussions)
-group.
+```
+go generate ./...
+```
 
 ### Writing Integrations
 
@@ -56,7 +63,7 @@ aliases or functions defined.
 One of the core tenets of Murex is that it's out-of-the-box experience should
 already be excellent and any customization that happens after is for
 personalization rather than because the default experience is lacking in some
-way. So Murex has made it very easy for you to contribute.
+way. So Murex has made it very easy for you to contribute:
 
 In the root of the project resides the [integrations directory](https://github.com/lmorg/murex/tree/master/integrations).
 Each file in there is compiled into Murex, assuming the following condition is
@@ -81,8 +88,8 @@ These can be raised on our [Github issue tracker](github.com/lmorg/murex/issues)
 ### Committing Code
 
 Murex is written in a language called Go. Not a lot of Murex's code is well
-documented however that was is document can be found in the [API section](/docs/apis) of the
-user guide.
+documented however the stuff that has been documented can be found in the
+[API section](/docs/apis) of the user guide.
 
 ### Blogging
 

DOWNLOAD.md

@@ -1,4 +1,5 @@
-<h1>Download Murex</h1>
+
+<h1>Download Links</h1>
 
 [![Version](version.svg)](DOWNLOAD.md)
 
@@ -25,9 +26,11 @@
 
 ## Download Links
 
-Below are the instructions to download a pre-compiled binary via HTTPS. If you
-wish to install from source or use your preferred package manager, then please
-refer to the [INSTALL](INSTALL.md) page for further instructions.
+Below are the instructions to download a pre-compiled binary via HTTPS.
+
+If you wish to install from source or use your preferred package manager, then
+please refer to the [INSTALL](INSTALL.md)
+page for further instructions.
 
 ### Darwin (macOS)
 
@@ -160,7 +163,7 @@ following site: [docs.microsoft.com/en-us/windows/wsl/install-win10](https://doc
 * [Compatibility Commitment](/compatibility.md):
   Murex is committed to excellent backwards compatibility
 * [Install](/INSTALL.md):
-  Installation instructions
+  Installation Instructions
 * [Supported Platforms](docs//supported-platforms.md):
   Operating systems and CPU architectures supported by Murex
 

INSTALL.md

@@ -1,4 +1,5 @@
-<h1>Install Murex</h1>
+
+<h1>Install</h1>
 
 <h2>Table of Contents</h2>
 
@@ -134,7 +135,7 @@ pretty well. So the overall experience is a clean and readable terminal.
 
 * [Compatibility Commitment](/compatibility.md):
   Murex is committed to excellent backwards compatibility
-* [Download](/DOWNLOAD.md):
+* [Download Links](/DOWNLOAD.md):
   Murex download links
 * [Supported Platforms](docs//supported-platforms.md):
   Operating systems and CPU architectures supported by Murex

app/app.go

@@ -1,3 +1,5 @@
+//go:generate ./update-version.mx
+
 package app
 
 import (
@@ -10,36 +12,33 @@ import (
 const Name = "murex"
 
 // Version number of $SHELL
-// Format of version string should be "(major).(minor).(revision) DESCRIPTION"
+// Format of version string should be "$(Major).$(Minor).$(Revision) ($Branch)"
 const (
-	version  = "%d.%d.%d"
-	Major    = 6
-	Minor    = 2
-	Revision = 4000
+	Major     = 6
+	Minor     = 3
+	Revision  = 4221
+	Branch    = "develop"
+	BuildDate = "2024-09-18  21:37:02"
 )
 
 // Copyright is the copyright owner string
-const Copyright = "© 2018-2024 Laurence Morgan"
+const Copyright = "2018-2024 Laurence Morgan"
 
 // License is the projects software license
-const License = "License GPL v2"
+const License = "GPL v2"
 
-// ShellModule is the name of the module that REPL code gets imported into
-var ShellModule = Name + "/shell"
+var licenseFull string
 
-func init() {
-	v = fmt.Sprintf(version, Major, Minor, Revision)
-	sv, _ = semver.Parse(v)
-}
+func GetLicenseFull() string  { return licenseFull }
+func SetLicenseFull(s string) { licenseFull = s }
 
-var v string
+// ShellModule is the name of the module that REPL code gets imported into
+var ShellModule = Name + "/shell"
 
 func Version() string {
-	return v
+	return fmt.Sprintf("%d.%d.%04d (%s)", Major, Minor, Revision, Branch)
 }
 
-var sv *semver.Version
-
 func Semver() *semver.Version {
-	return sv
+	return &semver.Version{Major, Minor, Revision}
 }