[xiph-cvs] cvs commit: vorbis-tools/oggenc encode.c encode.h oggenc.c

[Kenneth Arnold]

On Sat, Jan 26, 2002 at 10:21:49PM -0800, Michael Smith wrote:
> +static void print_deprecated_message(void) {
> +    fprintf(stderr, "WARNING: Usage of the bitrate options (-b, -m, -M) has been deprecated\n"
> +                    "To use these, you must specify that you wish to use managed mode, using\n"
> +                    "the --managed option.\n"
> +                    "This will cause oggenc to enable the full bitrate management engine.\n"
> +                    "You should do this ONLY if bitrate management is critical to your usage\n"
> +                    "(for example, certain audio streaming applications).\n"
> +                    "Usage of the bitrate management engine will generally decrease quality,\n"
> +                    "using the normal fully VBR modes (quality specified using -q) is\n"
> +                    "very highly recommended for most users.\n"
> +                    "Usage of the -managed option will become MANDATORY in the next release.\n\n");
                                     ^ double-dash.

Also, unless I missed something and it already is, the estimated
mapping of quality to bitrate (the image whose URL I don't have handy
right now) should be somewhere in the documentation, or at least
linked to.

Perhaps a short note like "Transition Guide -- From Bitrate to
Quality", that might also mention comparisons to bitrates of other
formats as well.


-- 
Kenneth Arnold <ken at arnoldnet.net>

<p>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: part
Type: application/pgp-signature
Size: 233 bytes
Desc: not available
Url : http://lists.xiph.org/pipermail/commits/attachments/20020127/f7218a9b/part.pgp