From d19021e3673d178f62b2c6c6cd5bee569d2f3354 Mon Sep 17 00:00:00 2001 From: Marc Fonvieille Date: Tue, 31 Jul 2007 06:23:43 +0000 Subject: [PATCH] - Various rewordings, style and grammar fixes. - Some common sense changes: use of 50 instead of 100 for the volume channel example. PR: docs/114718 Submitted by: Ben Kaduk --- .../books/handbook/multimedia/chapter.sgml | 79 +++++++++---------- 1 file changed, 38 insertions(+), 41 deletions(-) diff --git a/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml b/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml index eb21714180..dbc7a6747f 100644 --- a/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml @@ -27,7 +27,7 @@ applications allowing you to edit your recorded audio, add sound effects, and control attached MIDI devices. - With some willingness to experiment, FreeBSD can support + With some experimentation, &os; can support playback of video files and DVD's. The number of applications to encode, convert, and playback various video media is more limited than the number of sound applications. For example as @@ -52,8 +52,7 @@ - Methods to test that your card is working using - sample applications. + Methods to test whether your card is working. @@ -78,7 +77,7 @@ - How to rip CD and DVD information into files. + How to rip CD and DVD content into files. @@ -140,7 +139,7 @@ FreeBSD supports a wide variety of both PCI and ISA cards. Check the supported audio devices list of the Hardware Notes to see if - your card is supported. This document will also mention which + your card is supported. The Hardware Notes will also mention which driver supports your card. @@ -190,14 +189,14 @@ Configuring a Custom Kernel with Sound Support - The first thing to do is adding the generic audio driver - &man.sound.4; to the kernel, for that you will need to + The first thing to do is add the audio framework driver + &man.sound.4; to the kernel; for that you will need to add the following line to the kernel configuration file: device sound - Then we have to add the support for our sound card. - Therefore, we need to know which driver supports the card. + Next, you have to add the support for your sound card. + Therefore, you need to know which driver supports the card. Check the supported audio devices list of the Hardware Notes, to determine the correct driver for your sound card. For @@ -208,24 +207,24 @@ device snd_emu10k1 Be sure to read the manual page of the driver for the - syntax to use. Information regarding the syntax of sound - drivers in the kernel configuration can also be found in the + syntax to use. The explicit syntax for the kernel configuration + of every supported sound driver can also be found in the /usr/src/sys/conf/NOTES file. - Non-PnP ISA cards may require you to provide the kernel - with information on the sound card settings (IRQ, I/O port, - etc). This is done via the - /boot/device.hints file. At system boot, + Non-PnP ISA sound cards may require you to provide the kernel + with information on the card settings (IRQ, I/O port, + etc), as is true of all non-PnP ISA cards. This is done via the + /boot/device.hints file. During the boot process, the &man.loader.8; will read this file and pass the settings to the kernel. For example, an old Creative &soundblaster; 16 ISA non-PnP card will use the - &man.snd.sbc.4; driver in conjunction with snd_sb16(4). For this card the following lines have to be added to + &man.snd.sbc.4; driver in conjunction with snd_sb16. For this card the following lines must be added to the kernel configuration file: device snd_sbc device snd_sb16 - as well as the following in + and these to /boot/device.hints: hint.sbc.0.at="isa" @@ -239,12 +238,13 @@ hint.sbc.0.flags="0x15" The syntax used in the /boot/device.hints file is covered in the - sound driver manual page. + &man.sound.4; driver manual page and the manual page + for the driver in question. The settings shown above are the defaults. In some cases, you may need to change the IRQ or the other settings to match your card. See the &man.snd.sbc.4; manual page for more - information. + information about this card. @@ -269,14 +269,14 @@ pcm0: <Intel ICH3 (82801CA)> at io 0xd800, 0xdc80 irq 5 bufsz 16384 kld snd_ich (1p/2r/0v channels duplex default) The output from your system may vary. If no - pcm devices show up, go back and review + pcm devices are listed, go back and review what was done earlier. Go through your kernel configuration file again and make sure the correct - device is chosen. Common problems are listed in . If all goes well, you should now have a functioning sound - card. If your CD-ROM or DVD-ROM drive is properly coupled to + card. If your CD-ROM or DVD-ROM drive's audio-out pins are properly connected to your sound card, you can put a CD in the drive and play it with &man.cdcontrol.1;: @@ -286,8 +286,10 @@ kld snd_ich (1p/2r/0v channels duplex default) role="package">audio/workman can provide a friendlier interface. You may want to install an application such as audio/mpg123 to listen to - MP3 audio files. A quick way to test the card is sending data - to the /dev/dsp, like this: + MP3 audio files. + + Another quick way to test the card is sending data + to /dev/dsp, like this: &prompt.user; cat filename > /dev/dsp @@ -317,12 +319,6 @@ kld snd_ich (1p/2r/0v channels duplex default) - - unsupported subdevice XX - One or more of the device nodes was not created - correctly. Repeat the steps above. - - sb_dspwr(XX) timed out The I/O port is not set correctly. @@ -372,9 +368,9 @@ kld snd_ich (1p/2r/0v channels duplex default) sound device with a certain application. FreeBSD lets you do this through Virtual Sound - Channels, which can be set with the &man.sysctl.8; + Channels, which can be enabled with the &man.sysctl.8; facility. Virtual channels allow you to multiplex your sound - card's playback channels by mixing sound in the kernel. + card's playback by mixing sound in the kernel. To set the number of virtual channels, there are two sysctl knobs which, if you are the root user, can @@ -406,7 +402,8 @@ kld snd_ich (1p/2r/0v channels duplex default) where x is 0 to 3 if hw.snd.pcm.0.vchans is set to 4 as in the above example. On a system using &man.devfs.5;, the above will - automatically be allocated transparently to the user. + automatically be allocated transparently to a program + that requests /dev/dsp0. @@ -424,17 +421,17 @@ kld snd_ich (1p/2r/0v channels duplex default) The default values for the different mixer channels are hardcoded in the sourcecode of the &man.pcm.4; driver. There are - a lot of different applications and daemons that allow - you to set values for the mixer they remember and set - each time they are started, but this is not a clean - solution, we want to have default values at the driver - level. This is accomplished by defining the appropriate - values in /boot/device.hints. E.g.: + many different applications and daemons that allow + you to set values for the mixer that are remembered between + invocations, but this is not a clean solution. It is possible + to set default mixer values at the driver level — this + is accomplished by defining the appropriate + values in /boot/device.hints, e.g.: -hint.pcm.0.vol="100" +hint.pcm.0.vol="50" This will set the volume channel to a default value of - 100, when the &man.pcm.4; module is loaded. + 50 when the &man.pcm.4; module is loaded.