135
submitted 1 week 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 39 points 6 days ago

Groff is indeed such a crap format to write documentation in. It nearly reads like zalgo.

I can't wait for the anti markdown people to come out of the woodwork though and complain that it's "the progressivist agenda" to be more user friendly because devs aren't users.

"If you can't write Groff, maybe you dont deserve to read the output"

"The markdown evangelists are so annoying. You can't just rewrite everything in markdown"

"When will this markdown craze stop??? I can't hear it anymore!"

Identity politics entered the developer arena.

[-] MonkderVierte@lemmy.zip -4 points 6 days ago* (last edited 6 days ago)

Missing features in Markdown:

  • description lists (some have them, commonmark doesn't)
  • image captions & resizing
  • basic richtext like underline without html syntax
  • native vector (svg) handling

I'm not saying not to use md (vs. asciidoc/tor, restex or orgmode) but to add the features please.

Someone can correct this but iirc some implementations of markdown have image options like this:

![alt text](/path/to/IMG.png|200px "description text")

Others put the size in { } after the main image item.

Rich text is contrary to the structural focus of markdown. Why should it be added?

[-] MonkderVierte@lemmy.zip 0 points 5 days ago* (last edited 5 days ago)

Guess we have a semantics problem here. I understand under "rich text" text with formatting, not the long since dead file format. Markup is the language used to add richness to the plain text, no?

Sorry I was trying to follow your meaning, because the example of absent rich text you gave was underlines. There is already basic text formatting support such as strong, emphasis, headings and links.

You could style any, all or none of those to have underlining. Whatever chosen rendering, they all have meaning independent from the applied style. What you are asking for is to have something that is purely a display style without any structural value. This is not coming to markdown any time soon. Hardly anyone uses underline as its own thing in html anymore, for good reasons.

Maybe this article will help to further explain.

Native SVG handling would be completely out of scope. The point of markdown is that it is supposed to be understandable in its plain text format. SVG is incompatible with that. The closest thing would be like mermaid charts but I think it's quite a stretch even then.

I think you should just use HTML, it has a much larger array of tools that would suit your needs. Markdown is purposely constrained because it enables much more portability.

load more comments (9 replies)
load more comments (15 replies)
this post was submitted on 30 Dec 2025
135 points (97.9% liked)

Linux

10937 readers
672 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