News for hackers. Stuff that matters.
Re:Creating Shazam in Java (2010) by thethirdone on Tuesday August 23, 2022 @10:10PM (#32574215)
Are the comments in the `AudioFormat getFormat()` example useful to anyone?

The most useful one to me is the `channels = 1; // mono`; it gives a second way that is often used to describe the value and saved me maybe half a second.

All of the words in the signed comment are useless except "unsigned", but I think that is a clear opposite of `signed = true`. The fact that the setting pertains to data in SOME way is super obvious.

The endian comment adds in the keywords little-endian and order, but if you don't already know what endian means, googling "bigEndian" would already get you useful results.

The `format = getFormat();` comment is the most useless to me because it actually confused me. I thought because there was a comment it couldn't be referring the code above. Additionally, the only additional info it gives me is the word "settings".

There are no comments on this comment yet.