I'm thinking we could switch to another format for the #libcurl documentation: github.com/curl/curl/pull/1273…
introducing "curldown" for libcurl man page format by bagder · Pull Request #12730 · curl/curl
curldown is this new file format for libcurl man pages. It is markdown inspired with differences: Each file has a set of leading headers with meta-data Supports a small subset of markdown cd2nrof...GitHub
Martin Peck
in reply to daniel:// stenberg:// • • •daniel:// stenberg://
in reply to Martin Peck • • •Martin Peck
in reply to daniel:// stenberg:// • • •right...so, take what you need and nothing else? Makes sense. And would stripping/ignoring unwanted/unsupported stuff from a MD file be harder?
The reason I ask is partly editor support for MD is pretty good, so if users are editing something with a .md extension they get a bunch of stuff for free. Even GitHub will nicely render a .MD file for you.
I suspect your approach is a safer approach though. Just thinking out loud.
daniel:// stenberg://
in reply to Martin Peck • • •Martin Peck
in reply to daniel:// stenberg:// • • •Tc001
in reply to daniel:// stenberg:// • • •Looks cool! Btw how does this differ from something like a yaml frontmatter? Can you have more than on in a page?
(sorry if a dumb question, I couldn't find any examples of the actual syntax)
daniel:// stenberg://
in reply to Tc001 • • •Tc001
in reply to daniel:// stenberg:// • • •Either way, good luck with the format, will be interesting to see how it pans out!
daniel:// stenberg://
in reply to Tc001 • • •Wez Furlong
in reply to daniel:// stenberg:// • • •big +1 on making it easier to contribute. I opted to skip man pages entirely in my more recent projects largely because I find that the *roffs are so unfriendly to use and maintain.
PS: scrolling through the PR I smiled when I got to the perl parts: definitely written by someone, like me, that did tech stuff in the 90's and early 00's 🙂
daniel:// stenberg://
in reply to Wez Furlong • • •Tristan Partin
in reply to daniel:// stenberg:// • • •~sircmpwn/scdoc - Small man page generator - sourcehut git
git.sr.htStefan Eissing
in reply to daniel:// stenberg:// • • •daniel:// stenberg://
in reply to daniel:// stenberg:// • • •Eugene
in reply to daniel:// stenberg:// • • •towo
in reply to daniel:// stenberg:// • • •Alex
in reply to daniel:// stenberg:// • • •daniel:// stenberg://
in reply to Alex • • •manchicken moved!
in reply to daniel:// stenberg:// • • •Mark Eichin
in reply to daniel:// stenberg:// • • •Authoring man pages in Markdown with Pandoc
Eddie Antonio Santos (eddieantonio/blog)daniel:// stenberg://
in reply to Mark Eichin • • •Mangdries
in reply to daniel:// stenberg:// • • •daniel:// stenberg://
in reply to Mangdries • • •