From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <9front-bounces@9front.inri.net>
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org
X-Spam-Level: 
X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIM_SIGNED,DKIM_VALID,
	DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,
	T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.4
Received: from 9front.inri.net (9front.inri.net [168.235.81.73])
	by inbox.vuxu.org (Postfix) with ESMTP id 610A228CC9
	for <ml@inbox.vuxu.org>; Sat,  9 Mar 2024 00:53:35 +0100 (CET)
Received: from mimir.eigenstate.org ([206.124.132.107]) by 9front; Fri Mar  8 18:50:15 -0500 2024
Received: from mimir.eigenstate.org (localhost [127.0.0.1])
	by mimir.eigenstate.org (OpenSMTPD) with ESMTP id cef1e4f1
	for <9front@9front.org>;
	Fri, 8 Mar 2024 15:50:12 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=eigenstate.org; h=
	message-id:to:subject:date:from:in-reply-to:mime-version
	:content-type:content-transfer-encoding; s=mail; bh=af3s729MrmW2
	G7k2iYVrfqbRQcI=; b=VsZRR0tH257Dzrte6Y2yC05zISFKv3pLwPGVSRaUwszg
	s4rXV4y0MvAW4OlO+7qk7Vzik6LQf1nKouJ29xZDUBLRSUzPxlAWWSx+kJsaM50G
	e4JGBwIB9i/J4vq5DUSlOSPQf1vlCPAhawHB8xHx6VOWEoGd35uiFbY+zdpK4nw=
DomainKey-Signature: a=rsa-sha1; c=nofws; d=eigenstate.org; h=message-id
	:to:subject:date:from:in-reply-to:mime-version:content-type
	:content-transfer-encoding; q=dns; s=mail; b=nhArsw4XBJg02dGYXCS
	ndXh6tQsdEmRsJOD/wQnqCEORlOFTygySmK8pmuKlfSvCwKloGe4o81fNhWcP1S1
	M0EKF0zfctOYqeNvPHWeiUO93tXUvTaiFlVbecVlVQdCTZf4mcslBOxYLk8zgeMn
	SjJRiJVjJtJMNY1CTcKyptAY=
Received: from abbatoir (pool-108-6-24-2.nycmny.fios.verizon.net [108.6.24.2])
	by mimir.eigenstate.org (OpenSMTPD) with ESMTPSA id deb91950 (TLSv1.2:ECDHE-RSA-AES256-SHA:256:NO)
	for <9front@9front.org>;
	Fri, 8 Mar 2024 15:50:12 -0800 (PST)
Message-ID: <E841C88429B559D28FC250CD34B41D09@eigenstate.org>
To: 9front@9front.org
Date: Fri, 08 Mar 2024 18:50:10 -0500
From: ori@eigenstate.org
In-Reply-To: <84739D44A8CF59B9081CC67816FA3D8D@prosimetrum.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="US-ASCII"
Content-Transfer-Encoding: 7bit
List-ID: <9front.9front.org>
List-Help: <http://lists.9front.org>
X-Glyph: ➈
X-Bullshit: module-oriented event content-driven manager 
Subject: Re: [9front] 9front man pages
Reply-To: 9front@9front.org
Precedence: bulk

Quoth umbraticus@prosimetrum.com:
> > they are. in the source-code.
> 
> indeed. you could have a tool called usage that greps for lines like
> 
> case 'f': /* explanation of f flag */
> 
> within ARGBEGIN{}ARGEND, with a matching style convention.
> 
> and whatever the equivalent for rc scripts is.
> 
> or maybe src(1) is good enough.
> 
> umbraticus

We could also add a semantic tag to the manpage macro
set for tags, so they render inline, but can be found
with some tool.

	The flag
	.FL -a sends all output to stderr

and the flags can be indexed/searched from this.

	wtf grep -a

(wtf, of course, stands for 'whats the flag')