extra/id3/id3-docs.factor

   1 ! Coyright (C) 2007 Adam Wendt
   2 ! See http://factorcode.org/license.txt for BSD license.
   3 USING: id3 help.syntax help.markup ;
   4
   5 ARTICLE: "id3-tags" "ID3 Tags"
   6 "The " { $vocab-link "id3" } " vocabulary is used to read ID3 tags from MP3 audio streams."
   7 { $subsection id3v2 }
   8 { $subsection read-tag }
   9 { $subsection id3v2? }
  10 { $subsection read-id3v2 } ;
  11
  12 ABOUT: "id3-tags"
  13
  14 HELP: id3v2
  15 { $values { "filename" "a pathname string" } { "tag/f" "a tag or f" } }
  16 { $description "Outputs a " { $link tag } " or " { $link f } " if file does not start with an ID3 tag." } ;
  17
  18 HELP: read-tag
  19 { $values { "stream" "a stream" } { "tag/f" "a tag or f" } }
  20 { $description "Outputs a " { $link tag } " or " { $link f } " if stream does not start with an ID3 tag." } ;
  21
  22 HELP: id3v2?
  23 { $values { "?" "a boolean" } }
  24 { $description "Tests if the current input stream begins with an ID3 tag." } ;
  25
  26 HELP: read-id3v2
  27 { $values { "tag/f" "a tag or f" } }
  28 { $description "Outputs a " { $link tag } " or " { $link f } " if the current input stream does not start with an ID3 tag." } ;