Help History

# author:

Lists one or more authors for a source file.

• Should typically just be a name

  # author: Susan Examplary
  

• Or a comma-separated list of authors.

  # author: main man, contributor1, contributor2
  

• URLs or email addresses are best listed behind author names instead:

  # author: Susan (http://example.org/), Miriam <miri@example.org>
  

Having separate author-url: and author-email: fields does not really help anywhere. Typically authorship is just shown once during plugin installation. And having a mini parser/renderer there is just less effort than maintaining two PMD fields.

(This is also advised because of Wordpress´ abhorrent "Author URI:" field → asking for an "URI:" but crapping out on urn:, data:, mailto: values.)