update verbiage about -P, now that the default is -P 4096
authorJosh Coalson <jcoalson@users.sourceforce.net>
Sat, 11 Jan 2003 06:28:44 +0000 (06:28 +0000)
committerJosh Coalson <jcoalson@users.sourceforce.net>
Sat, 11 Jan 2003 06:28:44 +0000 (06:28 +0000)
doc/html/documentation.html
man/flac.1
man/flac.sgml
src/flac/main.c

index 95bb530..b8214d7 100644 (file)
                                <TT>-P #</TT>, <TT>--padding=#</TT>
                        </TD>
                        <TD>
-                               Tell the encoder to write a <TT>PADDING</TT> metadata block of the given length (in bytes) after the <TT>STREAMINFO</TT> block.  This is useful if you plan to tag the file later with an <TT>APPLICATION</TT> block; instead of having to rewrite the entire file later just to insert your block, you can write directly over the <TT>PADDING</TT> block.  Note that the total length of the <TT>PADDING</TT> block will be 4 bytes longer than the length given because of the 4 metadata block header bytes.  You can force no <TT>PADDING</TT> block at all to be written with <TT>--no-padding</TT>, which is the default.
+                               Tell the encoder to write a <TT>PADDING</TT> metadata block of the given length (in bytes) after the <TT>STREAMINFO</TT> block.  This is useful if you plan to tag the file later with an <TT>APPLICATION</TT> block; instead of having to rewrite the entire file later just to insert your block, you can write directly over the <TT>PADDING</TT> block.  Note that the total length of the <TT>PADDING</TT> block will be 4 bytes longer than the length given because of the 4 metadata block header bytes.  You can force no <TT>PADDING</TT> block at all to be written with <TT>--no-padding</TT>.  The encoder writes a PADDING block of 4096 bytes by default.
                        </TD>
                </TR>
                <TR>
index e14c8a5..f959ab3 100644 (file)
@@ -3,7 +3,7 @@
 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
 .\" Please send any bug reports, improvements, comments, patches, 
 .\" etc. to Steve Cheng <steve@ggi-project.org>.
-.TH "FLAC" "1" "02 January 2003" "" ""
+.TH "FLAC" "1" "10 January 2003" "" ""
 .SH NAME
 flac \- Free Lossless Audio Codec
 .SH SYNOPSIS
@@ -198,8 +198,8 @@ over the PADDING block.  Note that the total length
 of the PADDING block will be 4 bytes longer than
 the length given because of the 4 metadata block
 header bytes.  You can force no PADDING block at
-all to be written with --no-padding, which is the
-default.
+all to be written with --no-padding.  The encoder
+writes a PADDING block of 4096 bytes by default.
 .TP
 \fB-T \fIFIELD=VALUE\fB, --tag=\fIFIELD=VALUE\fB\fR
 Add a Vorbis comment.  The comment must adhere
index ea44c4f..6c6b27b 100644 (file)
@@ -4,7 +4,7 @@
   <!ENTITY dhfirstname "<firstname>Matt</firstname>">
   <!ENTITY dhsurname   "<surname>Zimmerman</surname>">
   <!-- Please adjust the date whenever revising the manpage. -->
-  <!ENTITY dhdate      "<date>January 02, 2003</date>">
+  <!ENTITY dhdate      "<date>January 10, 2003</date>">
   <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
        allowed: see man(7), man(1). -->
   <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
                    of the PADDING block will be 4 bytes longer than
                    the length given because of the 4 metadata block
                    header bytes.  You can force no PADDING block at
-                   all to be written with --no-padding, which is the
-                   default.</para>
+                   all to be written with --no-padding.  The encoder
+                   writes a PADDING block of 4096 bytes by default.
+                   </para>
                </listitem>
              </varlistentry>
 
index 05d05a9..ad06748 100644 (file)
@@ -1323,7 +1323,8 @@ void show_explain()
        printf("                               be 4 bytes longer than the length given because\n");
        printf("                               of the 4 metadata block header bytes.  You can\n");
        printf("                               force no PADDING block at all to be written with\n");
-       printf("                               --no-padding, which is the default.\n");
+       printf("                               --no-padding.  The encoder writes a PADDING\n");
+       printf("                               block of 4096 bytes by default.\n");
        printf("  -b, --blocksize=#            Specify the blocksize in samples; the default is\n");
        printf("                               1152 for -l 0, else 4608; must be one of 192,\n");
        printf("                               576, 1152, 2304, 4608, 256, 512, 1024, 2048,\n");