Introduce LIST_HEAD macro and use it in audiod_command.

[paraslash.git] / README.afs

diff --git a/README.afs b/README.afs
index 7889bda9d29d72b1804ba507b0c6fdc53bbed7ed..edd2d17be98591391a7d3ceab0a820cf12b77763 100644 (file)
--- a/README.afs
+++ b/README.afs
@@ -174,12 +174,24 @@ Takes an extended regular expression and matches iff the text of the
 corresponding tag of the audio file matches the pattern. If the tag
 is not set, the empty string is matched against the pattern.
 
-       year
+       year ~ <num>
+       bitrate ~ <num>
+       frequency ~ <num>
+       channels ~ <num>
 
 Takes a comparator ~ of the set {<, =, <=, >, >=, !=} and a number
-N. Matches iff the year tag Y of the audio file is a number that
-satisfies the condition Y ~ N. If the audio file has no year tag,
-or if the tag is not a number, the file does not match.
+<num>. Matches an audio file iff the condition <val> ~ <num> is
+satisfied where val is the corresponding value of the audio file
+(bitrate in kbit/s, frequency in Hz, channel count, value of the
+year tag).
+
+The year tag is special as its value is undefined if the audio file
+has no year tag or the content of the year tag is not a number. Such
+audio files never match. Another difference is the special treatment
+if the year tag is a two-digit number. In this case either 1900 or
+2000 are added to the tag value, depending on whether the number is
+greater than 2000 plus the current year.
+
 
 ----------
 Mood usage