Fix / clean up man pages

Fix / clean up man pages (bug#1386)

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 

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 

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.

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%

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.