From 816ace2436b57a709a569bfb03a17236db28f1bf Mon Sep 17 00:00:00 2001 From: "Luke T. Shumaker" Date: Sat, 13 Apr 2024 17:09:27 -0600 Subject: wip refactor --- contribs.yml | 164 ++++++++++++++++++++++++----------------------------------- 1 file changed, 67 insertions(+), 97 deletions(-) (limited to 'contribs.yml') diff --git a/contribs.yml b/contribs.yml index 20ec3aa..6620ea7 100644 --- a/contribs.yml +++ b/contribs.yml @@ -1,100 +1,70 @@ -tags: - docs: - prettyName: Documentation - desc: | - I'm working to improve documentation for GNU/Linux, but more - than that I'm working to improve the forms of documentation that - more skilled technical writers might be afraid or incapable of - working on: `--help` text, generated documentation, and auditing - documentation against the source code to make sure that it is - accurate and complete. - ARM: - prettyName: ARM support - desc: | - Not that folks can't use GNU/Linux on ARM (obviously, the - Raspberry Pi has been a huge success), but there's still a lot - more friction to using GNU/Linux on ARM compared to x86. I'm - working on that. - GI: - prettyName: GObject Introspection - desc: | - GObject Introspection (which is a terrible name for what it is, - btw) is a cross-(language-runtime) object system. GObject was - an object system for C that game out of GTK+, and then GObject - Introspection was created as a way to specify the ABI for - working with an object, so that GObjects could be used from - other languages. I think that GObject Introspection is a really - cool technology that can be the basis of reducing friction - between languages, but it needs better/more-ubiquitous tooling. +- urls: [https://github.com/flori/json/pull/567] + tags: [Ruby, JSON, SoftwareFreedom] + desc: | + ruby-json contains code that is not Free under the FSF's + definition, not Open Source under the OSI's definition, and not + GPL-compatible. This has coused much consternation among folks + who care about any of those 3 things. -contributions: - - urls: [https://github.com/flori/json/pull/567] - tags: [Ruby, JSON, SoftwareFreedom] - desc: | - ruby-json contains code that is not Free under the FSF's - definition, not Open Source under the OSI's definition, and not - GPL-compatible. This has coused much consternation among folks - who care about any of those 3 things. + This PR replaces that non-Free code with Free code, removing + friction for Ruby users on GNU/Linux distros that care about those + 3 things. +- urls: [https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio/-/merge_requests/328] + tags: [ARM] + sponsored-by: Umorpha Systems + desc: | + To do its work, mkinitcpio needs to know the version number of the + Linux kernel that it is generating an image for; the normal way + that it knows this is to sniff the version number from the kernel + file. However, it fails to sniff the version number from ARM + zImage kernels, which means that Arch Linux ARM and Parabola for + ARM need to resort to hacks to get mkinitcpio to work right. - This PR replaces that non-Free code with Free code, removing - friction for Ruby users on GNU/Linux distros that care about - those 3 things. - - urls: [https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio/-/merge_requests/328] - tags: [ARM] - sponsored-by: Umorpha Systems - desc: | - To do its work, mkinitcpio needs to know the version number of - the Linux kernel that it is generating an image for; the normal - way that it knows this is to sniff the version number from the - kernel file. However, it fails to sniff the version number from - ARM zImage kernels, which means that Arch Linux ARM and Parabola - for ARM need to resort to hacks to get mkinitcpio to work right. + This PR removes that friction by teaching mkinitcpio to understand + ARM zImage files. +- urls: [https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio/-/merge_requests/277] + sponsored-by: Umorpha Systems + desc: | + One of the things going on in the secure-boot world is moving + toward "Unified Kernel Images" (UKI), which are when the kernel + and the init-ramdisk are bundled together into a single file to + reduce the risk of a compromised init-ramdisk being able to + compromise a secured kernel. This PR reduces friction when using + mkinitcpio to generate images directly as UKI without generating a + plain init-ramdisk first. +- urls: + - https://mailman.astron.com/pipermail/file/2024-April/001335.html + - https://github.com/file/file/commit/cf139abf35d07ebfd0c3edcab2fc400a211c0fbb + tags: [ARM] + desc: | + This PR improves its ability to detect information about Linux + kernel ARM zImage files. +- urls: + - https://mailman.astron.com/pipermail/file/2024-March/001327.html + - https://github.com/file/file/commit/3b92878ee277a6b6c0a37429e9edf5e5b55fcdd4 + tags: [docs] + desc: | + To do this, `file` reads a "magic" file that describes the magic + numbers that it might see in a file. This PR fixes a mistake in + the `magic(5)` manual for writing such files. +- urls: [https://github.com/diamondburned/gotk4/pull/140] + tags: [GI, docs] + desc: | + The not-quite-markdown format that `.gir` files use for + documentation is under-specified and hard to parse. Right now I'm + focusing on how to properly parse it, so that we can have + top-notch language-specific documentation for GI libraries. - This PR removes that friction by teaching mkinitcpio to - understand ARM zImage files. - - urls: [https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio/-/merge_requests/277] - sponsored-by: Umorpha Systems - desc: | - One of the things going on in the secure-boot world is moving - toward "Unified Kernel Images" (UKI), which are when the kernel - and the init-ramdisk are bundled together into a single file to - reduce the risk of a compromised init-ramdisk being able to - compromise a secured kernel. This PR reduces friction when - using mkinitcpio to generate images directly as UKI without - generating a plain init-ramdisk first. - - urls: - - https://mailman.astron.com/pipermail/file/2024-April/001335.html - - https://github.com/file/file/commit/cf139abf35d07ebfd0c3edcab2fc400a211c0fbb - tags: [ARM] - desc: | - This PR improves its ability to detect information about Linux - kernel ARM zImage files. - - urls: - - https://mailman.astron.com/pipermail/file/2024-March/001327.html - - https://github.com/file/file/commit/3b92878ee277a6b6c0a37429e9edf5e5b55fcdd4 - tags: [docs] - desc: | - To do this, `file` reads a "magic" file that describes the magic - numbers that it might see in a file. This PR fixes a mistake in - the `magic(5)` manual for writing such files. - - urls: [https://github.com/diamondburned/gotk4/pull/140] - tags: [GI, docs] - desc: | - The not-quite-markdown format that `.gir` files use for - documentation is under-specified and hard to parse. Right now - I'm focusing on how to properly parse it, so that we can have - top-notch language-specific documentation for GI libraries. - - This PR is laying the groundwork for the new parser. - - urls: - - https://lists.ozlabs.org/pipermail/linux-erofs/2023-November/009765.html - - https://github.com/erofs/erofs-utils/commit/f528b82ffbcb15484a7195c1a1d08ece0ff67350 - - https://github.com/erofs/erofs-utils/commit/197e3294bcdf93f37d12989cd830a33c055b1a53 - - https://github.com/erofs/erofs-utils/commit/f97311883337eb7e0ded55e60995e6599eba73e5 - tags: [docs] - sponsored-by: Umorpha Systems - desc: | - This patchset improves the `--help` documentation and - man-pages the EroFS userspace tools, and reduces friction by - having `fsck.erofs` accept common command line flags that fsck - implementions for other filesystems take. + This PR is laying the groundwork for the new parser. +- urls: + - https://lists.ozlabs.org/pipermail/linux-erofs/2023-November/009765.html + - https://github.com/erofs/erofs-utils/commit/f528b82ffbcb15484a7195c1a1d08ece0ff67350 + - https://github.com/erofs/erofs-utils/commit/197e3294bcdf93f37d12989cd830a33c055b1a53 + - https://github.com/erofs/erofs-utils/commit/f97311883337eb7e0ded55e60995e6599eba73e5 + tags: [docs] + sponsored-by: Umorpha Systems + desc: | + This patchset improves the `--help` documentation and man-pages + the EroFS userspace tools, and reduces friction by having + `fsck.erofs` accept common command line flags that fsck + implementions for other filesystems take. -- cgit v1.2.3-2-g168b