aseqsend: Refine man page

Make man page a bit nicer; reformatting and setting bold/italic
properly, typo fixes, and adding a few more words and sections.

Signed-off-by: Takashi Iwai <tiwai@suse.de>
This commit is contained in:
Takashi Iwai 2024-07-23 13:42:16 +02:00
parent df68ec3343
commit dec1ef064a

View file

@ -1,55 +1,63 @@
.TH ASEQSEND 1 "11 Mar 2024" .TH ASEQSEND 1 "11 Mar 2024"
.SH NAME .SH NAME
.B aseqsend aseqsend \- send arbitrary messages to selected ALSA MIDI seqencer port
\- send arbitrary messages to selected ALSA MIDI seqencer port
.SH SYNOPSIS .SH SYNOPSIS
aseqsend \-p client:port -s file-name|"hex encoded byte-string" \fBaseqsend\fP \-p client:port -s file-name
.br
\fBaseqsend\fP \-p client:port "hex encoded byte-string"
.SH DESCRIPTION .SH DESCRIPTION
.B aseqsend \fBaseqsend\fP is a command-line utility which allows one to send
is a command-line utility which allows one to send SysEx (system exclusive) data to ALSA MIDI seqencer port. SysEx (system exclusive) data to ALSA MIDI sequencer port.
It can also send any other MIDI commands. It can also send any other MIDI commands.
Messages to be send can be given in the last argument as hex encoded byte string or can be read from raw binary file. Messages to be sent can be given in the last argument as hex encoded
When sending several SysEx messages at once there is a delay of 1ms after each message as deafult and can be set to different value with option \-i. byte string or can be read from raw binary file.
When sending several SysEx messages at once there is a delay of 1ms
after each message as default and can be set to different value with
option \-i.
A client can be specified by its number, its name, or a prefix of its A client can be specified by its number, its name, or a prefix of its
name. A port is specified by its number; for port 0 of a client, the name. A port is specified by its number; for port 0 of a client, the
":0" part of the port specification can be omitted. ":0" part of the port specification can be omitted.
\fBaseqsend\fP can send UMP packets as MIDI 2.0 device by specifying
via \-u option as well, while the default operation is the legacy MIDI
1.0 byte stream.
.SH OPTIONS .SH OPTIONS
.TP .TP
\-h, \-\-help \fI\-h, \-\-help\fP
Prints a list of options. Prints a list of options.
.TP .TP
\-V, \-\-version \fI\-V, \-\-version\fP
Prints the current version. Prints the current version.
.TP .TP
\-l, \-\-list \fI\-l, \-\-list\FP
Prints a list of possible output ports. Prints a list of possible output ports.
.TP .TP
\-v, \-\-verbose \fI\-v, \-\-verbose\fP
Prints number of bytes actually sent Prints number of bytes actually sent
.TP .TP
\-p, -\-port=client:port \fI\-p, -\-port=client:port\fP
Target port by number or name Target port by number or name
.TP .TP
\-s, \-\-file=filename \fI\-s, \-\-file=filename\fP
Send raw binary data from given file name Send raw binary data from given file name
.TP .TP
\-i, \-\-interval=msec \fI\-i, \-\-interval=msec\fP
Interval between SysEx messages in miliseconds Interval between SysEx messages in milliseconds
.TP .TP
\-u, \-\-ump=version \fI\-u, \-\-ump=version\fP
Specify the MIDI version. 0 for the legacy MIDI 1.0 (default), Specify the MIDI version. 0 for the legacy MIDI 1.0 (default),
1 for UMP MIDI 1.0 protocol and 2 for UMP MIDI 2.0 protocol. 1 for UMP MIDI 1.0 protocol and 2 for UMP MIDI 2.0 protocol.
@ -58,9 +66,12 @@ reads the input as raw UMP packets, 4 each byte in big endian.
.SH EXAMPLES .SH EXAMPLES
aseqsend -p 128:0 "F0 41 10 00 00 64 12 18 00 21 06 59 41 59 4E F7" \fBaseqsend -p 128:0 "F0 41 10 00 00 64 12 18 00 21 06 59 41 59 4E F7"\fP
aseqsend -p 128:0 -s I7BulkDump.syx \fBaseqsend -p 128:0 -s I7BulkDump.syx\fP
.SH SEE ALSO
\fBaseqdump(1)\fP
.SH AUTHOR .SH AUTHOR
Miroslav Kovac <mixxoo@gmail.com> Miroslav Kovac <mixxoo@gmail.com>