website: updates

website/blog/.!5907!2023-08-31-gcc-v13-2-0-1-released.mdx

@@ -0,0 +1,154 @@
+---
+title: xPack GCC v13.2.0-1 released
+seo_title: Version 13.2.0-1 released
+description: Version 13.2.0-1 is a new release of xPack GCC.
+keywords:
+  - xpack
+  - gcc
+  - release
+
+date: 2023-08-31 20:35:32 +0300
+
+authors: ilg-ul
+
+# To be listed in the Releases page.
+tags:
+  - releases
+
+# ----- Custom properties -----------------------------------------------------
+
+
+version: "13.2.0-1"
+npm_subversion: "1"
+
+download_url: https://github.com/xpack-dev-tools/gcc-xpack/releases/tag/v13.2.0-1/
+
+---
+
+import {PageMetadata} from '@docusaurus/theme-common';
+import Image from '@theme/IdealImage';
+import CodeBlock from '@theme/CodeBlock';
+
+{/* ------------------------------------------------------------------------ */}
+
+Version **13.2.0-1** is a new release; it follows the official GNU GCC release.
+
+<!-- truncate -->
+
+<PageMetadata title={frontMatter.seo_title} />
+
+
+The [xPack GCC](https://xpack.github.io/gcc/)
+is a standalone cross-platform binary distribution of
+[GCC](https://gcc.gnu.org).
+
+There are separate binaries for **Windows** (x64),
+**macOS** (x64, arm64)
+and **GNU/Linux** (x64, arm64 and arm).
+
+:::note Raspberry Pi
+
+The main targets for the GNU/Linux Arm
+binaries are the **Raspberry Pi** class devices (armv7l and aarch64;
+armv6 is not supported).
+
+:::
+
+## Download
+
+The binary files are available from <a href={frontMatter.download_url}>GitHub Releases</a>.
+
+## Prerequisites
+
+- x64 GNU/Linux: any system with **GLIBC 2.27** or higher
+  (like Ubuntu 18 or later, Debian 10 or later, RedHat 8 or later,
+  Fedora 29 or later, etc)
+- arm64/arm GNU/Linux: any system with **GLIBC 2.27** or higher
+  (like Raspberry Pi OS, Ubuntu 18 or later, Debian 10 or later, RedHat 8 or later,
+  Fedora 29 or later, etc)
+- x64 Windows: Windows 7 with the Universal C Runtime
+  ([UCRT](https://support.microsoft.com/en-us/topic/update-for-universal-c-runtime-in-windows-c0514201-7fe6-95a3-b0a5-287930f3560c)),
+  Windows 8, Windows 10
+- x64 macOS: 10.13 or later
+- arm64 macOS: 11.6 or later
+
+## Install
+
+The easiest way to install this specific version, is by using **xpm**:
+
+<CodeBlock language="console"> {
+`xpm install @xpack-dev-tools/gcc@${frontMatter.version}.${frontMatter.npm_subversion} -verbose
+`} </CodeBlock>
+
+Comprehensive instructions for installing **xPack GCC** on different platforms
+can be found in the [Install Guide](/docs/install/).
+
+## Compliance
+
+The xPack GCC generally follows the official
+[GCC](https://gcc.gnu.org/releases.html) releases.
+
+The current version is based on:
+
+- GCC version [13.2.0](https://gcc.gnu.org/gcc-13/) from July 27, 2023;
+- binutils version
+[2.41](https://lists.gnu.org/archive/html/info-gnu/2023-07/msg00009.html)
+from July 30, 2023.
+
+## Supported languages
+
+The supported languages are:
+
+- C
+- C++
+- Obj-C
+- Obj-C++
+- Fortran
+
+Note: Obj-C/C++ support is minimalistic.
+
+Starting with August 2022, support for 32-bit multilib was added on x86
+GNU/Linux; it can be enabled via the `-m32` compile option.
+
+## Changes
+
+Compared to the upstream, there are no functional changes.
+
+## Bug fixes
+
+- none
+
+## Enhancements
+
+- none
+
+## Known problems
+
+- [[#8]](https://github.com/xpack-dev-tools/gcc-xpack/issues/8) due to
+an error in the binutils build script, in certain conditions, on GNU/Linux,
+the linker complained about a dependency to `libpthread.so` and/or
+`libm.so`; fixed in 2024-02-24.
+
+## Documentation
+
+To save space and bandwidth, the original GNU GCC documentation is available
+[online](https://gcc.gnu.org/onlinedocs/).
+
+## Build
+
+The binaries for all supported platforms
+(Windows, macOS and GNU/Linux) were built using the
+[xPack Build Box (XBB)](https://xpack.github.io/xbb/), a set
+of build environments based on slightly older distributions, that should be
+compatible with most recent systems.
+
+For the prerequisites and more details on the build procedure, please see the
+[Maintainer Info](/docs/maintainer/) page.
+
+## CI tests
+
+Before publishing, a set of simple tests were performed on an exhaustive
+set of platforms. The results are available from:
+
+- [GitHub Actions](https://github.com/xpack-dev-tools/gcc-xpack/actions/)
+- [Tra

website/docs/getting-started/index.mdx

@@ -37,8 +37,8 @@ import ReleaseSchedule from './_release-schedule.mdx'
 
 ## Overview
 
-**xPack GCC** is a standalone
-cross-platform (Windows, macOS, GNU/Linux) binary
+**xPack GCC** is a
+standalone, cross-platform (Windows, macOS, GNU/Linux) binary
 distribution of GCC,
 aimed at reproducible builds.
 
@@ -48,7 +48,7 @@ aimed at reproducible builds.
 To be **reproducible**, an operation must remain stable over time and
 across different environments. In other words, if builds are repeated
 after some time, possibly on a different machine or platform, the
-resulting behavior must be functionally equivalent.
+resulting behaviour must be functionally equivalent.
 
 </details>
 
@@ -65,7 +65,7 @@ this project also includes the
 
 <UpgradeNotice/>
 
-## What are xpm packages? (xPacks)
+## What are xpm packages? (xPacks) {#xpm-packages}
 
 **xpm packages**, abbreviated as **xPacks**, are versatile,
 language-neutral software packages. They have been successfully
@@ -74,16 +74,16 @@ utilised in C/C++ projects.
 <details>
 <summary>What the heck are xpm packages / xPacks? Please, do not introduce another package format!</summary>
 
-While the initial appearance may seem complex, utilizing
+Although the initial appearance may seem complex, utilising
 xpm packages is, in fact, straightforward.
 The design rationale is to automate frequent
-operations that occur during software development, in this case the
+operations that occur during software development, such as the
 installation of
 dependencies, and to ensure reproducibility.
 
 These packages are managed by **[xpm](https://xpack.github.io/xpm/)**
 (the xPack Project Manager),
-a program that complements the **[npm](https://docs.npmjs.com/cli/)** CLI
+a programme that complements the **[npm](https://docs.npmjs.com/cli/)** CLI
 (the popular JavaScript package manager), with new language-neutral features.
 
 The xPacks Framework **does NOT introduce a new package format**; instead,
@@ -98,34 +98,40 @@ are extracted into separate folders within the project.
 
 Based on the content, there are two types of xpm packages:
 
-- **source packages** (that install source files, usually libraries) and
-- **binary packages** (that install executables/binary files, usually tools).
+- packages with source libraries (**source** xpm packages)
+- packages with executables, usually platform-specific binary
+tools (**binary** xpm packages)
 
-Binary packages include references to archives with the platform specific
-binaries (such as `.tar.gz` for Unix or `.zip` for Windows).
+**Source xpm packages** are regular npm packages that include **library
+source files**, typically in **C/C++**, though there are no language
+restrictions.
 
-These archives are also expanded along the package metadata. Since they
-include executables, links/forwarders to
+**Binary xpm packages** are also regular npm packages, but with minimal
+content, typically just the `package.json` file. Since these packages
+provide executables for multiple platforms, some of which are quite
+large, it is not practical to include all binaries within the npm
+package itself. Instead, the `package.json` file contains references
+(URLs) to platform-specific binary archives (e.g., `.tar.gz` for Unix or
+`.zip` for Windows).
+
+These archives are also expanded along with the package metadata.
+Links/forwarders to
 these executables are created in a `.bin` folder,
 eliminating the need to add multiple folders to the `PATH`.
 
-Given that some binary packages, such as toolchains, can have very large
-archives, the packages are extracted only once into a user global location to
-conserve space. In projects, instead of duplicating the content of these
-archives, symbolic links are created.
-
-Simply put, xpm packages can be used to further automate the
-installation of source libraries and tools.
+In summary, xpm packages can enhance and automate the installation
+process for source libraries and tools.
 
 </details>
 
 ## Features
 
 All binaries are:
 
-- **self-contained** (include all required libraries)
-- **file-system relocatable** (can be installed in any location)
-- built on slightly older systems (to make them run on both old and new systems)
+- **Self-contained** (include all required libraries).
+- **File-system relocatable** (can be installed in any location).
+- Built on slightly older systems (to ensure compatibility with both
+old and new systems).
 
 <details>
 <summary>Compatibility with older systems</summary>
@@ -154,17 +160,17 @@ location, including in user folders.
 
 The main advantages of using the **xPack GCC** are:
 
-- a convenient, uniform and portable install/uninstall/upgrade
+- A convenient, uniform and portable install/uninstall/upgrade
 procedure; the same procedure is used for all major
-  platforms (**x64 Windows**, **x64 macOS**, **arm64 macOS**, **x64 GNU/Linux**, **arm64 GNU/Linux**, **arm GNU/Linux**)
-- multiple versions of the same package can be installed at the same time on
-  the same system
-- no need to worry about dependent libraries, they are all included
-- not affected by system updates that
-  might change the versions of the dependent libraries
-- significantly lighter and easier to use than Docker images that provide
-  similar functionality and are GNU/Linux centric
-- projects can be tied to specific tools versions; this provides a good
+  platforms (**x64 Windows**, **x64 macOS**, **arm64 macOS**, **x64 GNU/Linux**, **arm64 GNU/Linux**, **arm GNU/Linux**).
+- Multiple versions of the same package can be installed at the same time on
+  the same system.
+- No need to worry about dependent libraries, they are all included.
+- Not affected by system updates that
+  might change the versions of the dependent libraries.
+- Significantly lighter and easier to use than Docker images that provide
+  similar functionality and are GNU/Linux centric.
+- Projects can be tied to specific tools versions; this provides a good
   reproducibility, especially useful in **CI/CD** environments.
 
 <OtherBenefits/>

website/docs/install/index.mdx

@@ -63,22 +63,22 @@ as <a href={`https://www.npmjs.com/package/@xpack-dev-tools/gcc`}><code>@xpack-d
 the [`npmjs.com`](https://www.npmjs.com) registry.
 
 <details>
-<summary>xPacks refresher</summary>
+<summary>xpm packages (xPacks) refresher</summary>
 
-xPacks (short for xpm packages) are general-purpose,
+**xpm packages**, abbreviated as **xPacks**, are general-purpose,
 language-neutral software packages.
 They use **the same format as npm packages**,
 which is a collection of files/folders
 and a `package.json` file with the package metadata.
 
 **xpm** can install source and binary packages.
-Binary xPacks include references to regular archives with the platform
+Binary packages include references to regular archives with the platform
 specific binaries (such as `.tar.gz` for Unix or `.zip` for Windows).
 These archives are unpacked and links/forwarders to
 the executables are created in a `.bin` folder.
 
 For more details, please see the previous explanation in the
-[Getting Started](/docs/getting-started/#xpacks) page.
+[Getting Started](/docs/getting-started/#xpm-packages) page.
 
 </details>
 
@@ -426,7 +426,7 @@ install the packages globally will fail with _already installed_.
 <details>
 <summary>PATH setup</summary>
 
-In order to access the GNU RISC-V Embedded GCC binaries installed in
+In order to access the GCC binaries installed in
 the user global xPacks store,
 the project build configurations need a PATH adjustment:
 

website/docs/user/index.mdx

@@ -3,7 +3,7 @@
 # DO NOT EDIT!
 # Automatically generated from xbb-helper/templates/docusaurus/common.
 
-title: User Information
+title: User's Guide
 description: User information, including the versioning scheme, usage of shared libraries, and RPATH configuration on GNU/Linux.
 keywords:
   - xpack

website/docusaurus.config.ts

@@ -102,9 +102,12 @@ const config: Config = {
   organizationName: 'xpack-dev-tools', // Usually your GitHub org/user name.
   projectName: 'gcc-xpack', // Usually your repo name.
 
+  onBrokenAnchors: 'throw',
   onBrokenLinks: 'throw',
   onBrokenMarkdownLinks: 'throw',
 
+  onDuplicateRoutes: 'throw',
+
   // Useful for the sitemap.xml, to avoid redirects, since
   // GitHub redirects all to trailing slash.
   trailingSlash: true,