Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.debian.doc > #7773 > unrolled thread

creating manual pages like it is 2025

Started byGeert Stappers <stappers@stappers.nl>
First post2025-09-06 22:30 +0200
Last post2025-09-09 22:20 +0200
Articles 2 — 2 participants

Back to article view | Back to linux.debian.doc


Contents

  creating manual pages like it is 2025 Geert Stappers <stappers@stappers.nl> - 2025-09-06 22:30 +0200
    Re: creating manual pages like it is 2025 Baptiste Jammet <baptiste@mailoo.org> - 2025-09-09 22:20 +0200

#7773 — creating manual pages like it is 2025

FromGeert Stappers <stappers@stappers.nl>
Date2025-09-06 22:30 +0200
Subjectcreating manual pages like it is 2025
Message-ID<Ls7HP-dl3X-5@gated-at.bofh.it>
Hi,


Lintian warns: no manaul page for /usr/bin/foo.
So a good reason to create /usr/share/man/man1/foo.1.gz

However, I would like to avoid create manually nroff files.

My guess is there are markdown files that pandoc converts
into nroff.

Where to find such prior art?


Regards
Geert Stappers
-- 
Silence is hard to parse

[toc] | [next] | [standalone]


#7778

FromBaptiste Jammet <baptiste@mailoo.org>
Date2025-09-09 22:20 +0200
Message-ID<LtcYN-e71m-5@gated-at.bofh.it>
In reply to#7773
Hello,

Geert Stappers le 06/09/2025 :
> My guess is there are markdown files that pandoc converts
> into nroff.
Interresting.
 
> Where to find such prior art?
I found
https://www.pragmaticlinux.com/2021/01/create-a-man-page-for-your-own-program-or-script-with-pandoc/
which globally says that with a specific header and sections declared
as first level titles, you can callĀ : 
	pandoc foo.1.md -s -t man -o foo.1

Maybe ronn (https://manpages.debian.org/trixie/ronn/ronn.1.en.html) can
do the job too.

Hope that will help.
Baptiste

[toc] | [prev] | [standalone]


Back to top | Article view | linux.debian.doc


csiph-web