os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Use replaceable elements appropriately [1]

Browse source 
- Enclose lame into application element [2]

PR:		docs/123132 [1], docs/123135 [2]
Submitted by:	pgj
This commit is contained in:
Gabor Kovesdan 2008-04-27 12:10:52 +00:00
parent 6ea22d1579
commit 6eb9277a95
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=31919
1 changed files with 22 additions and 22 deletions
Download patch file Download diff file Expand all files Collapse all files

44
en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
View file

@ -293,7 +293,7 @@ kld snd_ich (1p/2r/0v channels duplex default)</screen>
<screen>&prompt.user; <userinput>cat <replaceable>filename</replaceable> &gt; /dev/dsp</userinput></screen>
<para>where <replaceable>filename</replaceable> can be any file.
<para>where <filename><replaceable>filename</replaceable></filename> can be any file.
This command line should produce some noise, confirming the
sound card is actually working.</para>
@ -494,7 +494,7 @@ Playing MPEG stream from Foobar-GreatestHits.mp3 ...
MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
</screen>
<para><literal>/dev/dsp1.0</literal> should be replaced with the
<para><devicename><replaceable>/dev/dsp1.0</replaceable></devicename> should be replaced with the
<devicename>dsp</devicename> device entry on your system.</para>
</sect2>
@ -556,8 +556,8 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
<filename role="package">audio/lame</filename> in the ports tree.</para>
<para>Using the ripped WAV files, the following command will
convert <filename>audio01.wav</filename> to
<filename>audio01.mp3</filename>:</para>
convert <filename><replaceable>audio01.wav</replaceable></filename> to
<filename><replaceable>audio01.mp3</replaceable></filename>:</para>
<screen>&prompt.root; <userinput>lame -h -b <replaceable>128</replaceable> \
--tt "<replaceable>Foo Song Title</replaceable>" \
@ -577,7 +577,7 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
<option>--t</option> indicate ID3 tags, which usually contain
song information, to be embedded within the MP3 file.
Additional encoding options can be found by consulting the
lame man page.</para>
<application>lame</application> man page.</para>
</sect2>
<sect2 id="mp3-decoding">
@ -644,7 +644,7 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
<procedure>
<step>
<para>Run <command>mpg123 -s <replaceable>audio01.mp3</replaceable>
&gt; audio01.pcm</command></para>
&gt; <replaceable>audio01.pcm</replaceable></command></para>
</step>
</procedure>
@ -1069,18 +1069,18 @@ http://www.mplayerhq.hu/homepage/dload.html
through one of the various video interfaces set the
<option>-vo</option> option:</para>
<screen>&prompt.user; <userinput>mplayer -vo xv testfile.avi</userinput></screen>
<screen>&prompt.user; <userinput>mplayer -vo sdl testfile.avi</userinput></screen>
<screen>&prompt.user; <userinput>mplayer -vo x11 testfile.avi</userinput></screen>
<screen>&prompt.root; <userinput>mplayer -vo dga testfile.avi</userinput></screen>
<screen>&prompt.root; <userinput>mplayer -vo 'sdl:dga' testfile.avi</userinput></screen>
<screen>&prompt.user; <userinput>mplayer -vo xv <replaceable>testfile.avi</replaceable></userinput></screen>
<screen>&prompt.user; <userinput>mplayer -vo sdl <replaceable>testfile.avi</replaceable></userinput></screen>
<screen>&prompt.user; <userinput>mplayer -vo x11 <replaceable>testfile.avi</replaceable></userinput></screen>
<screen>&prompt.root; <userinput>mplayer -vo dga <replaceable>testfile.avi</replaceable></userinput></screen>
<screen>&prompt.root; <userinput>mplayer -vo 'sdl:dga' <replaceable>testfile.avi</replaceable></userinput></screen>
<para>It is worth trying all of these options, as their relative
performance depends on many factors and will vary significantly
with hardware.</para>
<para>To play from a DVD, replace the
<filename>testfile.avi</filename> with <option>dvd://<replaceable>N</replaceable> -dvd-device
<filename><replaceable>testfile.avi</replaceable></filename> with <option>dvd://<replaceable>N</replaceable> -dvd-device
<replaceable>DEVICE</replaceable></option> where <replaceable>N</replaceable> is
the title number to play and
<filename><replaceable>DEVICE</replaceable></filename> is the
@ -1141,7 +1141,7 @@ zoom=yes</programlisting>
or bad performance. Here are a couple of examples to get
you going. First a simple copy:</para>
<screen>&prompt.user; <userinput>mencoder input.avi -oac copy -ovc copy -o output.avi</userinput></screen>
<screen>&prompt.user; <userinput>mencoder <replaceable>input.avi</replaceable> -oac copy -ovc copy -o <replaceable>output.avi</replaceable></userinput></screen>
<para>Improper combinations of command line options can yield
output files that are
@ -1149,16 +1149,16 @@ zoom=yes</programlisting>
just want to rip to a file, stick to the <option>-dumpfile</option>
in <command>mplayer</command>.</para>
<para>To convert <filename>input.avi</filename> to the MPEG4
<para>To convert <filename><replaceable>input.avi</replaceable></filename> to the MPEG4
codec with MPEG3 audio encoding (<filename role="package">audio/lame</filename> is required):</para>
<screen>&prompt.user; <userinput>mencoder input.avi -oac mp3lame -lameopts br=192 \
-ovc lavc -lavcopts vcodec=mpeg4:vhq -o output.avi</userinput></screen>
<screen>&prompt.user; <userinput>mencoder <replaceable>input.avi</replaceable> -oac mp3lame -lameopts br=192 \
-ovc lavc -lavcopts vcodec=mpeg4:vhq -o <replaceable>output.avi</replaceable></userinput></screen>
<para>This has produced output playable by <command>mplayer</command>
and <command>xine</command>.</para>
<para><filename>input.avi</filename> can be replaced with
<para><filename><replaceable>input.avi</replaceable></filename> can be replaced with
<option>dvd://1 -dvd-device /dev/dvd</option> and run as
<username>root</username> to re-encode a DVD title
directly. Since you are likely to be dissatisfied with
@ -1202,7 +1202,7 @@ zoom=yes</programlisting>
<para>Alternatively, it may be invoked to play a file immediately
without the GUI with the command:</para>
<screen>&prompt.user; <userinput>xine -g -p mymovie.avi</userinput></screen>
<screen>&prompt.user; <userinput>xine -g -p <replaceable>mymovie.avi</replaceable></userinput></screen>
</sect3>
@ -1230,11 +1230,11 @@ WITH_MJPEG=yes -DWITH_XVID=yes</userinput></screen>
example to show how to convert a DivX file into a PAL MPEG-1
file (PAL VCD):</para>
<screen>&prompt.user; <userinput>transcode -i input.avi -V --export_prof vcd-pal -o output_vcd</userinput>
&prompt.user; <userinput>mplex -f 1 -o output_vcd.mpg output_vcd.m1v output_vcd.mpa</userinput></screen>
<screen>&prompt.user; <userinput>transcode -i <replaceable>input.avi</replaceable> -V --export_prof vcd-pal -o output_vcd</userinput>
&prompt.user; <userinput>mplex -f 1 -o <replaceable>output_vcd.mpg output_vcd.m1v output_vcd.mpa</replaceable></userinput></screen>
<para>The resulting MPEG file,
<filename>output_vcd.mpg</filename>, is ready to be played with
<filename><replaceable>output_vcd.mpg</replaceable></filename>, is ready to be played with
<application>MPlayer</application>. You could even burn the
file on a CD-R media to create a Video CD, in this case you will
need to install and use both <filename
@ -1728,7 +1728,7 @@ device `epson:/dev/uscanner0' is a Epson GT-8200 flatbed scanner</screen>
example, our USB scanner uses the device node
<filename>/dev/uscanner0</filename> which is owned by the
<groupname>operator</groupname> group. Adding the user
<username>joe</username> to the
<username><replaceable>joe</replaceable></username> to the
<groupname>operator</groupname> group will allow him to use
the scanner:</para>