Fork as galsauseHEAD1.0master

Signed-off-by: Mattias Andrée <m@maandree.se>

1 files changed, 21 insertions, 60 deletions

diff --git a/alsause.1 b/galsause.1
index d433d58..5a8c551 100644
--- a/alsause.1
+++ b/galsause.1
@@ -1,60 +1,29 @@
-.TH ALSAUSE 1 ALSAUSE
+.TH GALSAUSE 1 GALSAUSE
 .SH NAME
-alsause - Set default ALSA PCM device
+galsause - Set default ALSA PCM device
 .SH SYNPOSIS
-.B alsause
-.RB [( \-r
-|
-.I name
-|
-.IR card \fB:\fP device )
+.B galsause
 .RI [ command
-.RI [ argument "] ...]]"
+.RI [ argument "] ...]"
 .SH DESCRIPTION
 The
-.B alsause
-utility lists all ALSA PCM devices or
-sets, either for the user or for a program
-it starts, the default ALSA PCM device.
-.PP
-No options or operands are specified,
-.B alsause
-will list all ALSA PCM devices, otherwise
-it will set the default ALSA PCM device.
+.B galsause
+utility is a graphical utility for setting the default
+ALSA PCM device for the user or a program it starts.
 .PP
 If
 .I command
-is specified,
-.B alsause
-will run that command with the default
-ALSA PCM device set only for that process
-and it's child processes.
+is specified, galsause will run that command with the default
+ALSA PCM device set only for that process and it's child processes.
 .SH OPTIONS
 The
-.B alsause
+.B galsause
 utility conforms to the Base Definitions volume of POSIX.1-2017,
 .IR "Section 12.2" ", " "Utility Syntax Guidelines" .
 .PP
-The following option is supported:
-.TP
-.B \-r
-Remove the user-specified default ALSA PCM device,
-falling back to the system-wide default ALSA PCM device.
+No options are supported.
 .SH OPERANDS
-The following operands shall be supported:
-.TP
-.IR card : device
-The card number and device number to use as the default
-ALSA PCM device.
-.TP
-.I name
-The card and device, by name, to use as the default
-ALSA PCM device. This string is on the form output by the
-.B alsause
-utility itself:
-.BR "\(dq%s - %s\(dq" ,
-.RI < "card name" >,
-.RI < "device name" >.
+The following operands are supported:
 .TP
 .I command
 The name of the utility to be invoked.
@@ -79,25 +48,17 @@ as described in the Base Definitions volume of POSIX.1-2017,
 .PP
 Additionally, environment variables that affect ALSA takes
 precedence over the default device set by the
-.B alsause
+.B galsause
 utility.
 .SH ASYNCHRONOUS EVENTS
 Default.
 .SH STDOUT
-If no option or operand is specified, each ALSA PCM device is the form:
-.RS
-
-\fB\(dq%u:%u\et%s - %s\en\(dq,\fP <\fIcard number\fP>\fB,\fP <\fIdevice number\fP>\fB,\fP <\fIcard name\fP>\fB,\fP <\fIdevice name\fP>
-
-.RE
-Otherwise, the
-.B alsause
-utility does not write to standard output.
+Not used.
 .SH STDERR
-The standard error shall be used only for diagnostic messages.
+The standard error is only used for diagnostic messages.
 .SH OUTPUT FILES
 If the the default ALSA PCM device is set, the
-.B alsause
+.B galsause
 utility may create, modify, replace, or unlink the file
 .I .asoundrc
 placed in the user's home directory.
@@ -107,21 +68,21 @@ None.
 If
 .I command
 is invoked, the exit status of
-.B alsause
+.B galsause
 is the exit status of
 .IR command ;
 otherwise, the
-.B alsause
+.B galsause
 utility exits with one of the following values.
 .TP
 0
 The
-.I alsause
+.I galsause
 utility completed successfully.
 .TP
 125
 An error occurred in the
-.I alsause
+.I galsause
 utility.
 .TP
 126
@@ -134,4 +95,4 @@ The utility specified by
 .I command
 could not be found.
 .SH SEE ALSO
-None.
+.BR alsause (1)