website: updates

website/blog/2023-08-17-bison-v3-8-2-1-released.mdx

@@ -26,6 +26,7 @@ Version **3.8.2-1** is the first release of GNU bison.
 <!-- truncate -->
 
 import Image from '@theme/IdealImage';
+import CodeBlock from '@theme/CodeBlock';
 
 The [xPack GNU bison](https://xpack.github.io/bison/)
 is a standalone cross-platform binary distribution of
@@ -60,8 +61,14 @@ The binary files are available from <a href={frontMatter.download_url}>GitHub Re
 
 ## Install
 
-The full details of installing the **xPack GNU bison** on various platforms
-are presented in the [Install Guide](/docs/install/).
+The easiest way to install this specific version, is by using **xpm**:
+
+<CodeBlock language="console"> {
+`xpm install @xpack-dev-tools/bison@${frontMatter.version}.${frontMatter.npm_subversion} -verbose
+`} </CodeBlock>
+
+Comprehensive instructions for installing **xPack GNU bison** on different platforms
+can be found in the [Install Guide](/docs/install/).
 
 ## Compliance
 
@@ -143,11 +150,11 @@ xpack-bison-3.8.2-1-linux-x64.tar.gz
 
 ### 32-bit support
 
-Support for 32-bit Intel Linux and Intel Windows was
-dropped in 2022. Support for 32-bit Arm Linux (armv7l) will be preserved
+Support for 32-bit x86 GNU/Linux and x86 Windows was
+dropped in 2022. Support for 32-bit Arm GNU/Linux (armv7l) will be preserved
 for a while, due to the large user base of 32-bit Raspberry Pi systems.
 
-### Linux minimum requirements
+### GNU/Linux minimum requirements
 
 Support for RedHat 7 was dropped in 2022 and the
 minimum requirement was raised to GLIBC 2.27, available starting

website/blog/_common/_deprecation-notices-glib-2.27.mdx

@@ -6,21 +6,21 @@
 
 ## Deprecation notices
 
-### Linux minimum requirements
+### GNU/Linux minimum requirements
 
 The minimum requirement is **GLIBC 2.27**, available starting
 with Ubuntu 18, Debian 10 and RedHat 8.
 Support for RedHat 7 was dropped in 2022.
 
 ### 32-bit support
 
-Support for 32-bit Intel Linux and Intel Windows was
+Support for 32-bit x86 GNU/Linux and x86 Windows was
 dropped in 2022.
 
-### Pre-deprecation notice for 32-bit Arm Linux
+### Pre-deprecation notice for 32-bit Arm GNU/Linux
 
 Due to the large user base of 32-bit Raspberry Pi systems,
-support for 32-bit Arm Linux (armv7l) will be preserved
+support for 32-bit Arm GNU/Linux (armv7l) will be preserved
 for a little while, but expect it to be dropped by 2025,
 so it is recommended to consider an upgrade to a RPi 4 or 5 with
 at least 4 GB (preferably 8 GB) of RAM.

website/docs/about/_common/History32bitDiscontinued/index.tsx

@@ -0,0 +1,19 @@
+/*
+ * DO NOT EDIT!
+ * Automatically generated from xbb-helper/templates/docusaurus/common.
+ *
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2024 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/licenses/MIT/.
+ */
+
+export default function History32bitDiscontinued({platforms}): JSX.Element {
+    return (
+        <>Support for {platforms} (32-bit) was discontinued</>
+    );
+}

website/docs/about/_common/HistoryAppleSiliconAdded/index.tsx

@@ -0,0 +1,19 @@
+/*
+ * DO NOT EDIT!
+ * Automatically generated from xbb-helper/templates/docusaurus/common.
+ *
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2024 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/licenses/MIT/.
+ */
+
+export default function HistoryAppleSiliconAdded(): JSX.Element {
+    return (
+        <>Support for <b>Apple Silicon macOS</b> was added</>
+    );
+}

website/docs/about/_common/HistoryArmLinuxAdded/index.tsx

@@ -0,0 +1,19 @@
+/*
+ * DO NOT EDIT!
+ * Automatically generated from xbb-helper/templates/docusaurus/common.
+ *
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2024 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/licenses/MIT/.
+ */
+
+export default function HistoryArmLinuxAdded(): JSX.Element {
+    return (
+        <>Support for <b>32/64-bit Arm GNU/Linux</b> platforms (like Raspberry Pi) was added</>
+    );
+}

website/docs/about/_common/HistoryPlatformsAdded/index.tsx

@@ -0,0 +1,19 @@
+/*
+ * DO NOT EDIT!
+ * Automatically generated from xbb-helper/templates/docusaurus/common.
+ *
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2024 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/licenses/MIT/.
+ */
+
+export default function HistoryPlatformsAdded({platforms}): JSX.Element {
+    return (
+        <>Support for {platforms} was added</>
+    );
+}

website/docs/about/_common/HistoryRenameXpack/index.tsx

@@ -0,0 +1,19 @@
+/*
+ * DO NOT EDIT!
+ * Automatically generated from xbb-helper/templates/docusaurus/common.
+ *
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2024 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/licenses/MIT/.
+ */
+
+export default function HistoryRenameXpack(): JSX.Element {
+    return (
+        <>The project was renamed <b>xPack GNU bison</b></>
+    );
+}

website/docs/about/_common/HistoryWindowsUcrt/index.tsx

@@ -0,0 +1,19 @@
+/*
+ * DO NOT EDIT!
+ * Automatically generated from xbb-helper/templates/docusaurus/common.
+ *
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2024 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/licenses/MIT/.
+ */
+
+export default function HistoryWindowsUcrt(): JSX.Element {
+    return (
+        <>In the Windows binaries, the MSVC runtime was replaced with the newer <b>Universal C Runtime</b> (<b>UCRT</b>)</>
+    );
+}

website/docs/about/_common/HistoryXpm/index.tsx

@@ -0,0 +1,21 @@
+/*
+ * DO NOT EDIT!
+ * Automatically generated from xbb-helper/templates/docusaurus/common.
+ *
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2024 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/licenses/MIT/.
+ */
+
+import customField from '@site/src/libs/customField';
+
+export default function HistoryXpm({specifier}): JSX.Element {
+    return (
+        <>The xPack metadata has been added, and the package can now be more conveniently installed via <b>xpm</b>. It is  available from <code>npmjs.com</code> as <code>{specifier ? specifier : '@xpack-dev-tools/bison'}</code></>
+    );
+}

website/docs/about/_common/HistoryZipAdded/index.tsx

@@ -0,0 +1,19 @@
+/*
+ * DO NOT EDIT!
+ * Automatically generated from xbb-helper/templates/docusaurus/common.
+ *
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2024 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/licenses/MIT/.
+ */
+
+export default function HistoryZipAdded({platforms}): JSX.Element {
+    return (
+        <>Standard <code>.zip</code> archives were added in parallel with Windows setup files</>
+    );
+}

website/docs/about/_common/_history-gnu-arm-eclipse.mdx

@@ -0,0 +1,9 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
+
+{/* ------------------------------------------------------------------------ */}
+
+This project began in **{props.date || 'DATE'}** as one of the support tools for the
+**GNU Arm Eclipse** plug-ins,
+which were later rebranded as **GNU MCU Eclipse** plug-ins and are now
+integrated into the [Eclipse Embedded CDT](https://eclipse-embed-cdt.github.io).

website/docs/about/_common/_history-rename-xpack.mdx

@@ -0,0 +1,9 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
+
+import Link from '@docusaurus/Link';
+
+{/* ------------------------------------------------------------------------ */}
+
+The project was renamed **xPack GNU bison**
+(in <Link to={props.releaseURL || 'URL'}>{props.releaseName || 'NAME'}</Link>).

website/docs/about/_common/_history-restructuring.mdx

@@ -0,0 +1,10 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
+
+{/* ------------------------------------------------------------------------ */}
+
+The project underwent a comprehensive restructuring. To streamline the top
+`package.json` by showcasing only user-related definitions and concealing
+build-related ones, all build-related files were relocated to the
+`build-assets` folder. Furthermore, the development Git branch was
+renamed to `xpack-development` for enhanced clarity.

website/docs/about/_common/_history-setup-discontinued.mdx

@@ -0,0 +1,12 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
+
+import Link from '@docusaurus/Link';
+
+{/* ------------------------------------------------------------------------ */}
+
+To increase flexibility and
+allow multiple versions of a tool to be installed on the same system,
+the Windows setup format was discontinued. From
+version <Link to={props.releaseURL || 'URL'}>{props.releaseName || 'NAME'}</Link> onward,
+for Windows, only a standard `.zip` archive was distributed.

website/docs/about/_common/_history-xbb-v5.mdx

@@ -0,0 +1,13 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
+
+{/* ------------------------------------------------------------------------ */}
+
+The project received a significant update by transitioning the build
+scripts from the cumbersome monolithic XBB Docker images to the more
+flexible and modular xPacks. XBB version
+[5.0.0](https://xpack.github.io/blog/2023/02/07/xbb-v5.0.0-released/)
+marked a major milestone for the xPack project, as it was the first
+self-sustained release. This version enabled the creation of new
+binary xPacks using existing binary xPacks, eliminating the need for
+custom Docker images or other compiled tools.

website/docs/about/_common/_intro-primary.mdx

@@ -0,0 +1,8 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
+
+{/* ------------------------------------------------------------------------ */}
+
+The main goal of this project is to streamline the **development of embedded projects**.
+[µOS++](http://micro-os-plus.github.io) is the first cross-platform
+project to benefit from the xPack tools.

website/docs/about/_common/_intro-secondary.mdx

@@ -0,0 +1,11 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
+
+{/* ------------------------------------------------------------------------ */}
+
+This project currently functions as a supplementary tool for building
+the primary xPack Development Tools. Since these tools are exclusively
+built on macOS and GNU/Linux, to reduce maintenance efforts, for now
+there are no Windows binaries. However, the project is versatile and can be
+used in any builds; if necessary, Windows binaries can be added in future
+releases.

website/docs/about/_common/_website-docusaurus-migration.mdx

@@ -0,0 +1,12 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
+
+{/* ------------------------------------------------------------------------ */}
+
+In **{props.date || 'DATE'}**,
+as part of the project restructuring, the website content was migrated
+from the xPack Jekyll sub-site to a local Docusaurus configuration
+stored in the `website` folder. To ensure continuity, HTML `<meta>`
+redirects were added to the old pages.
+Additionally, a GitHub Action was implemented to automatically
+publish the site upon any pushes to the `website` Git branch.

website/docs/about/_common/_website-docusaurus-template.mdx

@@ -0,0 +1,9 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
+
+{/* ------------------------------------------------------------------------ */}
+
+In **{props.date}** the website content was added in the `website` folder,
+as an instance of the Docusaurus template. Additionally a GitHub Action
+was added to automatically publish the site upon any pushes to the
+`website` Git branch.

website/docs/about/_common/_website-jekyll.mdx

@@ -0,0 +1,10 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
+
+{/* ------------------------------------------------------------------------ */}
+
+The initial web site was launched in **{props.date || 'DATE'}** as
+a sub-site in the xPack web site.
+It used the
+[Jekyll Doc Theme 6.0](https://idratherbewriting.com/documentation-theme-jekyll/)
+by [Tom Johnson](https://github.com/tomjoht).

website/docs/about/_history.mdx

@@ -0,0 +1,15 @@
+
+import HistoryRestructuring from './_common/_history-restructuring.mdx'
+
+{/* ------------------------------------------------------------------------ */}
+
+The project was created in **August 2023**.
+
+### August 2023
+
+The first **xPack GNU bison** release was
+[v3.8.2-1](/blog/2023/08/17/bison-v3-8-2-1-released/).
+
+### August 2024
+
+<HistoryRestructuring/>

website/docs/about/_more-intro.mdx

@@ -0,0 +1,6 @@
+
+import IntroSecondary from './_common/_intro-secondary.mdx'
+
+{/* ------------------------------------------------------------------------ */}
+
+<IntroSecondary/>

website/docs/about/_website.mdx

@@ -0,0 +1,6 @@
+
+import WebsiteDocusaurus from './_common/_website-docusaurus-template.mdx'
+
+{/* ------------------------------------------------------------------------ */}
+
+<WebsiteDocusaurus date="September 2024"/>