From 8daa39deaee81929cce060d74d356b26174b8143 Mon Sep 17 00:00:00 2001
From: Lars Immisch <lars@ibp.de>
Date: Thu, 14 May 2015 00:02:14 +0200
Subject: [PATCH] Minor improvements

---
 doc/libalsaaudio.rst | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/doc/libalsaaudio.rst b/doc/libalsaaudio.rst
index 08ec735..67592bf 100644
--- a/doc/libalsaaudio.rst
+++ b/doc/libalsaaudio.rst
@@ -35,11 +35,8 @@ The :mod:`alsaaudio` module defines functions and classes for using ALSA.
 
 .. function:: pcms([type=PCM_PLAYBACK])
 
-   List available PCM objects by name.
+   List available PCM devices by name.
    
-   Items from this list can be used as the `device` keyword argument for the
-   :class:`PCM` constructor). 
-
    Arguments are:
 
    * *type* - can be either :const:`PCM_CAPTURE` or :const:`PCM_PLAYBACK`
@@ -59,10 +56,13 @@ The :mod:`alsaaudio` module defines functions and classes for using ALSA.
       $ arecord -L
 
    *New in 0.8*
-      
+
 .. function:: cards()
 
-   List the available cards by name.
+   List the available ALSA cards by name. This function is only moderately
+   useful. If you want to see a list of available PCM devices, use :func:`pcms`
+   instead.
+   
 
 .. function:: mixers(cardindex=-1, device='default')
 
@@ -508,12 +508,12 @@ Examples
 
 The following example are provided:
 
-* playwav.py
-* recordtest.py
-* playbacktest.py
-* mixertest.py
+* `playwav.py`
+* `recordtest.py`
+* `playbacktest.py`
+* `mixertest.py`
 
-All examples (except mixertest.py) accept the commandline option 
+All examples (except `mixertest.py`) accept the commandline option 
 *-c <cardname>*.
 
 To determine a valid card name, use the commandline ALSA player::