At Sat, 4 Jun 2011 17:51:26 -0400, Daniel Chen wrote:

Hi,

Here's a forwarded patch from a Debian bug report for the man page of the speaker-test utility. It gives examples for using speaker-test alongside aplay. Please consider applying.

Applied now. Thanks.

Takashi

Cheers, -Dan [2 0001-speaker-test.1-Clarify-man-page-by-giving-examples.patch <text/x-diff; UTF-8 (base64)>] From 91e06478e2d31cbb6786858472cb2a9e55258609 Mon Sep 17 00:00:00 2001 From: Daniel T Chen crimsun@ubuntu.com Date: Sat, 4 Jun 2011 17:44:43 -0400 Subject: [PATCH] speaker-test.1: Clarify man page by giving examples MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit

BugLink: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=620513

From the Debian bug report: "The speaker-test manpage could be improved somewhat by helping a little bit the user determine how to find out the devices he can test.

Based on http://alsa.opensrc.org/Speaker-test I have make some changes to the manpage (diff attached) to describe a little bit more how speaker-test can be used alongside 'aplay'.

Please consider the following patch for alsa-utils-1.0.23/speaker-test/speaker-test.1"

Signed-off-by: Javier Fernández-Sanguino Peña jfs@debian.org

speaker-test/speaker-test.1 | 46 ++++++++++++++++++++++++++++++++++++++++++- 1 files changed, 45 insertions(+), 1 deletions(-)

diff --git a/speaker-test/speaker-test.1 b/speaker-test/speaker-test.1 index f0948a6..6ef0814 100644 --- a/speaker-test/speaker-test.1 +++ b/speaker-test/speaker-test.1 @@ -11,7 +11,7 @@ . fi . PP .. -.TH SPEAKER-TEST 1 "20 September 2004" speaker-test +.TH SPEAKER-TEST 1 "April 2nd, 2011" speaker-test .SH NAME speaker-test - command-line speaker test tone generator for ALSA .SH SYNOPSIS @@ -20,6 +20,41 @@ speaker-test - command-line speaker test tone generator for ALSA .SH DESCRIPTION \fBspeaker-test\fP generates a tone that can be used to test the speakers of a computer.

+\fBspeaker-test\fP by default will test the \fIdefault\fP device. If you +want to test another sound device you will have first to get a list of +all of the sound cards in your system and the devices associated with +those cards. Notice that there might be for example, one device for +analog sound, one for digital sound and one for HDMI sound. +To get the list of available cards and devices you can run \fBaplay -L\fR.

+.P \fBaplay\fR's output will be similar to this one:

+.nf +$ aplay -L +null

• Discard all samples (playback) or generate zero samples (capture)

+default:CARD=ICH5

• Intel ICH5, Intel ICH5
• Default Audio Device

+front:CARD=ICH5,DEV=0

• Intel ICH5, Intel ICH5
• Front speakers

+surround40:CARD=ICH5,DEV=0

• Intel ICH5, Intel ICH5
• 4.0 Surround output to Front and Rear speakers

+(...) +.fi

+.P Each of the devices is listed in the beginning of the definition so, +in the above example, there are four devices listed: null, default, front +and surround40. So, if you want to test the last device you can +run \fBspeaker-test -Dsurround40:ICH5 -c 6\fR. The \fB-c\fR option will +indicate that the six audio channels in the device have to be tested.

.SH OPTIONS

.TP @@ -119,6 +154,15 @@ To send a nice low 75Hz tone to the Woofer and then exit without touching any ot speaker-test -Dplug:surround51 -c6 -s1 -f75 .EE

+To do a 2-speaker test using the spdif (coax or optical) output: +.EX

• speaker-test -Dplug:spdif -c2

+.EE

+.SH SEE ALSO +.BR aplay(1)

.SH AUTHOR The speaker-test program was written by James Courtier-Dutton. Pink noise support was added by Nathan Hurst. -- 1.7.5.3