[xiph-commits] r9031 - in trunk/vorbis-tools/oggenc: . man

[msmith at motherfish-iii.xiph.org]

Author: msmith
Date: 2005-03-03 14:59:16 -0800 (Thu, 03 Mar 2005)
New Revision: 9031

Modified:
   trunk/vorbis-tools/oggenc/man/oggenc.1
   trunk/vorbis-tools/oggenc/oggenc.c
Log:
Clean up help text some more, so that it doesn't imply in parts that negative
quality levels aren't permitted.


Modified: trunk/vorbis-tools/oggenc/man/oggenc.1
===================================================================
--- trunk/vorbis-tools/oggenc/man/oggenc.1	2005-03-03 18:30:50 UTC (rev 9030)
+++ trunk/vorbis-tools/oggenc/man/oggenc.1	2005-03-03 22:59:16 UTC (rev 9031)
@@ -135,7 +135,7 @@
 much slower, and may also be lower quality. It is primarily useful for creating
 files for streaming.
 .IP "-q n, --quality=n"
-Sets encoding quality to n, between -1 (low) and 10 (high). This is the default mode of operation, with a default quality level of 3. Fractional quality levels such as 2.5 are permitted. Normal quality range is 0 - 10.
+Sets encoding quality to n, between -1 (very low) and 10 (very high). This is the default mode of operation, with a default quality level of 3. Fractional quality levels such as 2.5 are permitted. Using this option allows the encoder to select an appropriate bitrate based on your desired quality level.
 .IP "--resample n"
 Resample input to the given sample rate (in Hz) before encoding. Primarily
 useful for downsampling for lower-bitrate encoding.

Modified: trunk/vorbis-tools/oggenc/oggenc.c
===================================================================
--- trunk/vorbis-tools/oggenc/oggenc.c	2005-03-03 18:30:50 UTC (rev 9030)
+++ trunk/vorbis-tools/oggenc/oggenc.c	2005-03-03 22:59:16 UTC (rev 9031)
@@ -415,12 +415,11 @@
         "                      in the man page supplied with this program. They are\n"
         "                      for advanced users only, and should be used with\n"
         "                      caution.\n"
-		" -q, --quality        Specify quality between 0 (low) and 10 (high),\n"
-		"                      instead of specifying a particular bitrate.\n"
+		" -q, --quality        Specify quality, between -1 (very low) and 10 (very\n"
+        "                      high), instead of specifying a particular bitrate.\n"
 		"                      This is the normal mode of operation.\n"
         "                      Fractional qualities (e.g. 2.75) are permitted\n"
-        "                      Quality -1 is also possible, but may not be of\n"
-        "                      acceptable quality.\n"
+        "                      The default quality level is 3.\n"
         " --resample n         Resample input data to sampling rate n (Hz)\n"
         " --downmix            Downmix stereo to mono. Only allowed on stereo\n"
         "                      input.\n"