flac icon indicating copy to clipboard operation
flac copied to clipboard

Documentation: the "Known bugs" webpage https://xiph.org/flac/documentation_bugs.html

Open H2Swine opened this issue 9 months ago • 5 comments

The only bug listed is a behaviour that has later been changed because it doesn't make sense to even write seekpoints?

flac hasn't adhered to the tradition of listing known bugs in the man document, so that makes a case for such a webpage. I do think though, that several of the issues users may have are not outright bugs. Like how 1.4.0 rejects out-of-range signals (while some of these files, which do violate the spec, are even decoded as intended with 1.2.1) or ID3 tags. Users could be advised to try the application that wrote an offending file, to decode it and then listen carefully to the output (at low volume first).

I might try to draft such a text if it is welcome.

Apart from that, what are the known bugs? Inconsistent ".aifc" handling, and issue #808 if verified?

H2Swine avatar Mar 06 '25 18:03 H2Swine

The only bug listed is a behaviour that has later been changed because it doesn't make sense to even write seekpoints?

The reason is that ffmpeg flac native encoder does not write SEEKTABLE?

ValeZAA avatar Mar 08 '25 07:03 ValeZAA

No, this is something else - it is about Ogg FLAC. The 1.4.3 changelog says No longer write seektables to Ogg, even when specifically asked for. Seektables in Ogg are not defined The "bug" listed on https://xiph.org/flac/documentation_bugs.html is back to version 1.3.1, which behaves as follows: When encoding to Ogg FLAC, the number of seek points is limited to 240.

But in the larger picture, this issue is about that web page. Which could maybe include compatibility issues, because some of those have arisen when various tools have written non-compliant files that all for sudden are rejected.

H2Swine avatar Mar 08 '25 16:03 H2Swine

When encoding to Ogg FLAC, the number of seek points is limited to 240.

What is a seek point in this context? SEEKTABLE is inside flac or maybe even inside headerless flac. If ogg seek point on container level is what this is about do you still think ffmpeg should implement SEEKTABLE?

ValeZAA avatar Mar 14 '25 19:03 ValeZAA

I think the web page should be removed.

Yes, there have been some changes in behaviour which are nice to document, but I don't think drafting it somewhere in the official documentation is necessary. I'm counting on people using search engines will end up on relevant forum topics discussing these issues.

ktmf01 avatar Mar 16 '25 18:03 ktmf01

No objections to removing the web page. Or there could be a wiki here or somewhere.

Looking at the other pages at https://xiph.org/flac , there is other information that is long obsolete and wrong. In more than one document, Sir Josh wrote -v for the verify option, that has been capital -V since ... who knows when. And https://xiph.org/flac/faq.html claims wildcards are not supported.

Outdated I think, is also the claim on https://xiph.org/flac/documentation_format_overview.html that the right prediction order gets inaccurately estimated above 9 or so. Nowadays -7 and -8 happily use -l12 without -e, and it's been years and years since the retune where -e was dropped from -8. Sure we we have kinda identified that it isn't fool-proof when the top octave is spectrally empty, -e is rarely of much use for CDDA.

H2Swine avatar Jul 07 '25 13:07 H2Swine