From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org
X-Spam-Level: 
X-Spam-Status: No, score=0.0 required=5.0 tests=DKIM_SIGNED,DKIM_VALID
	autolearn=ham autolearn_force=no version=3.4.4
Received: (qmail 537 invoked from network); 1 Sep 2021 07:03:35 -0000
Received: from 4ess.inri.net (216.126.196.42)
  by inbox.vuxu.org with ESMTPUTF8; 1 Sep 2021 07:03:35 -0000
Received: from pb-smtp21.pobox.com ([173.228.157.53]) by 4ess; Wed Sep  1 01:58:28 -0400 2021
Received: from pb-smtp21.pobox.com (unknown [127.0.0.1])
	by pb-smtp21.pobox.com (Postfix) with ESMTP id D86B914A8B5
	for <9front@9front.org>; Wed,  1 Sep 2021 01:58:08 -0400 (EDT)
	(envelope-from unobe@cpan.org)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=pobox.com; h=message-id
	:to:subject:date:from:in-reply-to:mime-version:content-type
	:content-transfer-encoding; s=sasl; bh=RNdaMlIrmoI0uxVr9N1wwXhA7
	3MPVBj8slU6fOaJWv0=; b=G2AcpLsADyth/FOHb/2kHSxC4WLJnGemRLJQ6L3YK
	dzYsvXNK/tuhbl/vJk9SlWIe/SHLS0kvkJd4o7VI+Pjd7Z5IgCTTzg+Z2tlfXdLm
	W4V1xOrp4VnzrMjJCPWXpPRMxjiAy8gkkdue9eZd36ab0IOqRQ7zVplGyytwmoXj
	SI=
Received: from pb-smtp21.sea.icgroup.com (unknown [127.0.0.1])
	by pb-smtp21.pobox.com (Postfix) with ESMTP id C58BF14A8B3
	for <9front@9front.org>; Wed,  1 Sep 2021 01:58:08 -0400 (EDT)
	(envelope-from unobe@cpan.org)
Received: from strider (unknown [47.34.135.186])
	(using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
	(No client certificate requested)
	by pb-smtp21.pobox.com (Postfix) with ESMTPSA id 40CAC14A8B1
	for <9front@9front.org>; Wed,  1 Sep 2021 01:58:06 -0400 (EDT)
	(envelope-from unobe@cpan.org)
Message-ID: <9375AAE3C729054168124C036967F66D@smtp.pobox.com>
To: 9front@9front.org
Date: Tue, 31 Aug 2021 22:58:04 -0700
From: unobe@cpan.org
In-Reply-To: <B949ACF6CF1FCD18AAD7B7F7DBF51A27@wopr.sciops.net>
MIME-Version: 1.0
Content-Type: text/plain; charset="US-ASCII"
Content-Transfer-Encoding: 7bit
X-Pobox-Relay-ID:
 93B1D166-0AE9-11EC-9E3E-9BA3EF469F85-09620299!pb-smtp21.pobox.com
List-ID: <9front.9front.org>
List-Help: <http://lists.9front.org>
X-Glyph: ➈
X-Bullshit: proxy content-driven event 
Subject: Re: [9front] joystick support docs
Reply-To: 9front@9front.org
Precedence: bulk

Minor questions inline.

Quoth qwx <qwx@sciops.net>:
> ...
> --- /tmp/diff100000015479
> +++ b//sys/man/1/joy
> @@ -1,0 +1,45 @@
> +.TH MUS 1
> +.SH NAME
> +joy \- joystick input for games
> +.SH SYNOPSIS
> +.B joy
> +[
> +.I player
> +]
> +.SH DESCRIPTION
> +.I Joy
> +interprets input from a USB joystick device
> +(see
> +.IR nusb (4))
> +to pass it on to a console emulator
> +as a string of controller keys
> +which are pressed down.
> +.PP
> +The optional
> +.B player
> +argument specifies a player number
> +for those emulators that support it.
> +It should be an integer equal to 1 or greater.
> +Currently only players 1 and 2 are supported.
> +.PP
> +Note that each USB controller has its own mappings
> +and the program may have to be modified
> +to use its own key id's.

id's -> ids ?

> +.SH EXAMPLES
> +Use USB device 10 as a joystick
> +for the player number 1's controller
> +with the Nintendo Entertainment System (NES) emulator:
> +.IP
> +.EX
> +% nusb/joy /dev/usb/ep10.0 | joy 1 | games/nes -a rom.nes
> +.EE
> +.SH "SEE ALSO"
> +.IR atari (1),
> +.IR nintendo (1),
> +.IR sega (1),
> +.IR nusb (4)

I'm new to ths, but am wondering: should the SEE ALSO list be
alphabetized, or is it first by man page section, then alphabetized?
Same question for /sys/man/4/nusb diff below, so won't comment there.

> ...