Re: creating manual pages like it is 2025

Path	csiph.com!weretis.net!feeder8.news.weretis.net!news.samoylyk.net!gothmog.csi.it!bofh.it!news.nic.it!robomod
From	Baptiste Jammet <baptiste@mailoo.org>
Newsgroups	linux.debian.doc
Subject	Re: creating manual pages like it is 2025
Date	Tue, 09 Sep 2025 22:20:01 +0200
Message-ID	<LtcYN-e71m-5@gated-at.bofh.it> (permalink)
References	<Ls7HP-dl3X-5@gated-at.bofh.it>
X-Mailbox-Line	From debian-doc-request@lists.debian.org Tue Sep 9 20:14:56 2025
Old-Return-Path	<baptiste@mailoo.org>
X-Amavis-Spam-Status	No, score=-2.197 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, LDO_WHITELIST=-5, RCVDMAILO=5, RCVD_IN_MSPIKE_H2=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001] autolearn=no autolearn_force=no
X-Policyd-Weight	using cached result; rate: -4.7
X-Ea-Auth	ZIu0ZTXuDyn1fJb0/B3+iT6BhM8FJCHCGLZyh4aEvS1hIvibd0LHXkuY2lLy8CL/L6oy+IJs4DSLJpTl0yBgWKkSmW0nb6a0ovCpwLQqbUs=
X-Mailer	Claws Mail 4.1.1 (GTK 3.24.38; x86_64-pc-linux-gnu)
MIME-Version	1.0
Content-Type	text/plain; charset=UTF-8
Content-Transfer-Encoding	quoted-printable
X-Mailing-List	<debian-doc@lists.debian.org> archive/latest/21308
List-ID	<debian-doc.lists.debian.org>
List-URL	<https://lists.debian.org/debian-doc/>
List-Archive	https://lists.debian.org/msgid-search/20250909221428.3d420be1@kamino.maison
Approved	robomod@news.nic.it
Lines	20
Organization	linux.* mail to news gateway
Sender	robomod@news.nic.it
X-Original-Date	Tue, 9 Sep 2025 22:14:28 +0200
X-Original-Message-ID	<20250909221428.3d420be1@kamino.maison>
X-Original-References	<aLyYkfdyzQeboe9N@gpm.stappers.nl>
Xref	csiph.com linux.debian.doc:7778

Show key headers only | View raw

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

Back to linux.debian.doc | Previous | Next — Previous in thread | Find similar | Unroll thread

Thread

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

csiph-web