add -S #s documentation

This commit is contained in:
Josh Coalson 2002-11-07 05:06:36 +00:00
parent bd6c68fd58
commit 0dad163d95
2 changed files with 13 additions and 7 deletions

View File

@ -483,7 +483,7 @@
</TR> </TR>
<TR> <TR>
<TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC"> <TD NOWRAP ALIGN="RIGHT" VALIGN="TOP" BGCOLOR="#F4F4CC">
<TT>-S {#|X|#x}</TT>,<BR><TT>--seekpoint={#|X|#x}</TT> <TT>-S {#|X|#x|#s}</TT>,<BR><TT>--seekpoint={#|X|#x|#s}</TT>
</TD> </TD>
<TD> <TD>
Include a point or points in a SEEKTABLE:<BR> Include a point or points in a SEEKTABLE:<BR>
@ -497,10 +497,13 @@
<LI> <LI>
<TT>#x</TT> : # evenly spaced seekpoints, the first being at sample 0 <TT>#x</TT> : # evenly spaced seekpoints, the first being at sample 0
</LI> </LI>
<LI>
<TT>#s</TT> : a seekpoint every # seconds; # does not have to be a whole number, it can be, for example, <TT>9.5</TT>, meaning a seekpoint every 9.5 seconds
</LI>
</UL> </UL>
You may use many -S options; the resulting SEEKTABLE will be the unique-ified union of all such values.<BR> You may use many -S options; the resulting SEEKTABLE will be the unique-ified union of all such values.<BR>
With no -S options, flac defaults to '-S 100x'. Use --no-seektable for no SEEKTABLE.<BR> With no -S options, flac defaults to '-S 100x'. Use --no-seektable for no SEEKTABLE.<BR>
<B>NOTE:</B> -S #x will not work if the encoder can't determine the input size before starting.<BR> <B>NOTE:</B> -S #x and -S #s will not work if the encoder can't determine the input size before starting.<BR>
<B>NOTE:</B> if you use -S # and # is &gt;= samples in the input, there will be either no seek point entered (if the input size is determinable before encoding starts) or a placeholder point (if input size is not determinable).<BR> <B>NOTE:</B> if you use -S # and # is &gt;= samples in the input, there will be either no seek point entered (if the input size is determinable before encoding starts) or a placeholder point (if input size is not determinable).<BR>
</TD> </TD>
</TR> </TR>

View File

@ -4,7 +4,7 @@
<!ENTITY dhfirstname "<firstname>Matt</firstname>"> <!ENTITY dhfirstname "<firstname>Matt</firstname>">
<!ENTITY dhsurname "<surname>Zimmerman</surname>"> <!ENTITY dhsurname "<surname>Zimmerman</surname>">
<!-- Please adjust the date whenever revising the manpage. --> <!-- Please adjust the date whenever revising the manpage. -->
<!ENTITY dhdate "<date>October 30, 2002</date>"> <!ENTITY dhdate "<date>November 6, 2002</date>">
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
allowed: see man(7), man(1). --> allowed: see man(7), man(1). -->
<!ENTITY dhsection "<manvolnum>1</manvolnum>"> <!ENTITY dhsection "<manvolnum>1</manvolnum>">
@ -316,7 +316,7 @@
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>-S</option> {<replaceable>#</replaceable>|<replaceable>X</replaceable>|<replaceable>#x</replaceable>}, <option>--seekpoint</option>={<replaceable>#</replaceable>|<replaceable>X</replaceable>|<replaceable>#x</replaceable>}</term> <term><option>-S</option> {<replaceable>#</replaceable>|<replaceable>X</replaceable>|<replaceable>#x</replaceable>|<replaceable>#s</replaceable>}, <option>--seekpoint</option>={<replaceable>#</replaceable>|<replaceable>X</replaceable>|<replaceable>#x</replaceable>|<replaceable>#s</replaceable>}</term>
<listitem> <listitem>
<para> <para>
@ -324,12 +324,15 @@
a seek point at that sample number is added. Using a seek point at that sample number is added. Using
X, a placeholder point is added at the end of a the X, a placeholder point is added at the end of a the
table. Using #x, # evenly spaced seek points will table. Using #x, # evenly spaced seek points will
be added, the first being at sample 0. You may use be added, the first being at sample 0. Using #s, a
seekpoint will be added every # seconds (# does not
have to be a whole number; it can be, for example, 9.5,
meaning a seekpoint every 9.5 seconds). You may use
many -S options; the resulting SEEKTABLE will be the many -S options; the resulting SEEKTABLE will be the
unique-ified union of all such values. With no -S unique-ified union of all such values. With no -S
options, flac defaults to '-S 100x'. Use --no-seektable options, flac defaults to '-S 100x'. Use --no-seektable
for no SEEKTABLE. Note: '-S #x' will not work if the for no SEEKTABLE. Note: '-S #x' and '-S #s' will not
encoder can't determine the input size before work if the encoder can't determine the input size before
starting. Note: if you use '-S #' and # is >= starting. Note: if you use '-S #' and # is >=
samples in the input, there will be either no seek samples in the input, there will be either no seek
point entered (if the input size is determinable point entered (if the input size is determinable