@@ -462,13 +462,14 @@ Encoding will default to -5, -A "tukey(5e-1)" and one CPU thread.
462462 internet streaming.
463463
464464** -j** \# , ** \- -threads** =\#
465- : Try to set a maximum number of threads to use for encoding. If
466- multithreading was not enabled on compilation or when setting a
467- number of threads that is too high, this fails with a warning. The
468- value of 0 means a default set by the encoder; currently that is 1
469- thread (i.e. no multithreading), but that could change in the
470- future. Currently, up to 128 threads are supported. Using a value
471- higher than the number of available CPU threads harms performance.
465+ : By default, ** flac** will encode with one thread. This option enables
466+ multithreading with max \# number of threads, although "0" to let the
467+ encoder decide. Currently, -j 0 is synonymous with -j 1 (i.e. no
468+ multithreading), and the max supported number is 64; both could change
469+ in the future. If \# exceeds the supported maximum (64), ** flac** will
470+ encode with a single thread (and throw a warning). The same happens
471+ (for any \# ) if ** flac** was compiled with multithreading disabled.
472+ NOTE: Exceeding the * actual* available CPU threads, harms speed.
472473
473474** \- -ignore-chunk-sizes**
474475: When encoding to flac, ignore the file size headers in WAV and AIFF
0 commit comments