112
submitted 1 day ago by cm0002@lemy.lol to c/linux@programming.dev

In demonstrating one of the gaps of man pages in modern times and likely having hindered the adoption of the Linux kernel's new mount API, it took more than six years for those system calls to be properly documented within man pages. The Linux "new" mount API was introduced back in mid-2019 with Linux 5.2 and since supported by key file-systems after several years but not until weeks ago was this file descriptor based mount API scoped out within man pages.

The "new" mount API for Linux is a set of system calls like fsopen and fsconfig for offering more flexibility than the Linux kernel's long-used mount system call that is a one-shot approach compared to this modern multi-step design for better flexibility. In the kernels since Linux 5.2, various file-systems have transitioned to supporting the modern mount API. It was only earlier this year that F2FS added support for it as one of the last major file-systems without it.

you are viewing a single comment's thread
view the rest of the comments
[-] onlinepersona@programming.dev 5 points 23 hours ago

Description lists?

Richtext? Like this or this ?

SVG handling? I've never seen a manpage with SVGs nor have I seen a manpage with images, much less image captions.

[-] linuxPIPEpower@discuss.tchncs.de 1 points 10 hours ago

That's not rich text. Rich text is when a format is applied without structural reason.

You could have a markdown interpreter that displayed **this** *this* or _this_ using any arbitrary format. You could change the color, weight, border, drop shadow, opacity, mouse over effects, font face... Any attribute.

Lemmy has conventions but all * really means is emphasis.

[-] MonkderVierte@lemmy.zip 1 points 23 hours ago* (last edited 23 hours ago)

Richtext? Like this or this ?

No, like the mentioned <u>underline</u> (this is how you write it in ~~markdown~~ html).

[-] MonkderVierte@lemmy.zip -1 points 23 hours ago* (last edited 23 hours ago)

SVG handling? I've never seen a manpage with SVG … image captions

This is from wanting to use markdown for more than tech. documentation, like saving some simple websites.

[-] linuxPIPEpower@discuss.tchncs.de 1 points 10 hours ago

If you want to save a website use html

[-] MonkderVierte@lemmy.zip 1 points 36 minutes ago* (last edited 34 minutes ago)

It's only rich text anyway, so why would i want to save it in a hard-to-read format with scripts and inline style noise and with frames and headers and footers in the way even if rendered? I care for the info only, it should look how i as the reader want it to look.

Typora has a convenient convert-on-paste feature. Sadly, there's no such tool for asciidoctor and pandoc does noisy convert (lots of artifacts).

this post was submitted on 30 Dec 2025
112 points (97.5% liked)

Linux

10835 readers
402 users here now

A community for everything relating to the GNU/Linux operating system (except the memes!)

Also, check out:

Original icon base courtesy of lewing@isc.tamu.edu and The GIMP

founded 2 years ago
MODERATORS