From 61fd93f867fd6a5223124b406cd1f529b31993b3 Mon Sep 17 00:00:00 2001
From: Josh Coalson <jcoalson@users.sourceforce.net>
Date: Sat, 11 Jan 2003 06:28:44 +0000
Subject: [PATCH] update verbiage about -P, now that the default is -P 4096

---
 doc/html/documentation.html | 2 +-
 man/flac.1                  | 6 +++---
 man/flac.sgml               | 7 ++++---
 src/flac/main.c             | 3 ++-
 4 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/doc/html/documentation.html b/doc/html/documentation.html
index 95bb530b..b8214d79 100644
--- a/doc/html/documentation.html
+++ b/doc/html/documentation.html
@@ -538,7 +538,7 @@
 				<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>
diff --git a/man/flac.1 b/man/flac.1
index e14c8a55..f959ab3f 100644
--- a/man/flac.1
+++ b/man/flac.1
@@ -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
diff --git a/man/flac.sgml b/man/flac.sgml
index ea44c4f9..6c6b27b2 100644
--- a/man/flac.sgml
+++ b/man/flac.sgml
@@ -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>">
@@ -384,8 +384,9 @@
 		    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>
 
diff --git a/src/flac/main.c b/src/flac/main.c
index 05d05a98..ad06748c 100644
--- a/src/flac/main.c
+++ b/src/flac/main.c
@@ -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");