From 87ffccedfd85687dae1a1635553949f3870bdb09 Mon Sep 17 00:00:00 2001
From: Takashi Iwai <tiwai@suse.de>
Date: Fri, 2 Sep 2005 17:36:40 +0000
Subject: [PATCH] Fix / clean up man pages

Fix / clean up man pages (bug#1386)
---
 alsactl/alsactl.1     |  8 ++------
 alsamixer/alsamixer.1 |  6 +-----
 amidi/amidi.1         |  6 +-----
 amixer/amixer.1       | 12 ++----------
 aplay/aplay.1         |  9 ++-------
 5 files changed, 8 insertions(+), 33 deletions(-)

diff --git a/alsactl/alsactl.1 b/alsactl/alsactl.1
index f01ec49..246fdc4 100644
--- a/alsactl/alsactl.1
+++ b/alsactl/alsactl.1
@@ -12,11 +12,7 @@ soundcard drivers. It supports multiple soundcards. If your card has
 features that you can't seem to control from a mixer application,
 you have come to the right place.
 
-.SH INVOKING
-
-\fBalsactl\fP [\fIoptions\fP] [\fIstore\fP|\fIrestore\fP|\fInames\fP] <card # or id>
-
-.SS Commands
+.SH COMMANDS
 
 \fIstore\fP saves the current driver state for the selected soundcard
 to the configuration file.
@@ -31,7 +27,7 @@ generated for all available cards.
 If no soundcards are specified, setup for all cards will be saved or
 loaded.
 
-.SS Options
+.SH OPTIONS
 
 .TP
 \fI\-h, \-\-help\fP 
diff --git a/alsamixer/alsamixer.1 b/alsamixer/alsamixer.1
index f3131d0..87fa3b7 100644
--- a/alsamixer/alsamixer.1
+++ b/alsamixer/alsamixer.1
@@ -9,11 +9,7 @@ alsamixer \- soundcard mixer for ALSA soundcard driver, with ncurses interface
 \fBalsamixer\fP is an ncurses mixer program for use with the ALSA
 soundcard drivers. It supports multiple soundcards with multiple devices.
 
-.SH INVOKING
-
-\fBalsamixer\fP [\fIoptions\fP]
-
-.SS Options
+.SH OPTIONS
 
 .TP
 \fI\-h, \-help\fP 
diff --git a/amidi/amidi.1 b/amidi/amidi.1
index faae32c..a3c85db 100644
--- a/amidi/amidi.1
+++ b/amidi/amidi.1
@@ -23,9 +23,7 @@ and
 .B arecordmidi(1)
 do.
 
-.SH INVOKING
-.B amidi
-.I options
+.SH OPTIONS
 
 Use the
 .I \-h,
@@ -42,8 +40,6 @@ or
 .I \-d
 options to specify what data to send or receive.
 
-.SS Options
-
 .TP
 .I \-h, \-\-help
 Help: prints a list of options.
diff --git a/amixer/amixer.1 b/amixer/amixer.1
index a174006..2f24183 100644
--- a/amixer/amixer.1
+++ b/amixer/amixer.1
@@ -7,7 +7,6 @@ amixer \- command-line mixer for ALSA soundcard driver
 \fBamixer\fP allows command-line control of the mixer for the ALSA
 soundcard driver.
 \fBamixer\fP supports multiple soundcards.
-.SH INVOKING
 
 \fBamixer\fR with no arguments will display the current mixer settings
 for the default soundcard and device. This is a good way to see a list
@@ -71,7 +70,7 @@ of control.
 Shows the card control contents. The identifier has same syntax as for
 the \fIcset\fP command.
 
-.SS Options
+.SH OPTIONS
 
 .TP
 [\fI\-c\fP card]
@@ -91,8 +90,7 @@ Help: show syntax.
 \fI\-q\fP
 Quiet mode. Do not show results of changes.
 
-.SS
-Example #1:
+.SH EXAMPLES
 
 .TP
 \fBamixer \-c 1 sset Line,0 80%,40% unmute cap\fR
@@ -100,16 +98,10 @@ will set the second soundcard's left line input volume to 80% and
 right line input to 40%, unmute it, and select it as a source for
 capture (recording).\fR
 
-.SS
-Example #2:
-
 .TP
 \fBamixer \-c 2 cset iface=MIXER,name='Line Playback Volume",index=1 40%\fR
 will set the third soundcard's second line playback volume(s) to 40%
 
-.SS
-Example #3:
-
 .TP
 \fBamixer \-c 2 cset numid=34 40%\fR
 will set the 34th soundcard element to 40%
diff --git a/aplay/aplay.1 b/aplay/aplay.1
index 9c14eb0..c1538f4 100644
--- a/aplay/aplay.1
+++ b/aplay/aplay.1
@@ -4,7 +4,7 @@ arecord, aplay \- command-line sound recorder and player for ALSA
 soundcard driver
 .SH SYNOPSIS
 \fBarecord\fP [\fIflags\fP] [filename]
-.SH SYNOPSIS
+.br
 \fBaplay\fP [\fIflags\fP] [filename [filename]] ...
 
 .SH DESCRIPTION
@@ -16,14 +16,9 @@ multiple devices.
 supported soundfile formats, the sampling rate, bit depth, and so
 forth can be automatically determined from the soundfile header.
 
-.SH INVOKING
-
-[\fBarecord\fP | \fBaplay\fP ] [\fIflags\fP] filename
-.TP
 If filename is not specified, the standard output or input is used. The \fBaplay\fP utility accepts multiple filenames.
 
-
-.SS Options
+.SH OPTIONS
 .TP
 \fI\-h, \-\-help\fP
 Help: show syntax.