<page xmlns="http://projectmallard.org/1.0/"
      type="topic"
      id="mal_info_years">

<info>
  <link type="guide" xref="mal_info#additional"/>

  <revision version="0.1" date="2009-09-08" status="stub"/>

  <credit type="author">
    <name>Shaun McCance</name>
    <email>shaunm@gnome.org</email>
    <years>2009</years>
  </credit>

  <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" />

  <desc>FIXME</desc>
</info>

<title>Copyright Years</title>

<synopsis><code mime="application/relax-ng-compact-syntax">
mal_info_years = element years {
  attribute * - (mal:* | local:*) { text } *,
  <link xref="mal_inline">mal_inline</link>
}
</code></synopsis>

<p>Use the <code>years</code> element to mark up the years for which
a person or organization holds a copyright.</p>


<!-- BEGIN notes -->
<section id="notes">
  <title>Notes</title>
  <list>
    <item><p>The <code>years</code> element can contain a mixture of text and
    any <link xref="mal_inline">general inline elements</link>.</p></item>

    <item><p>The <code>years</code> element can occur in the
    <code xref="mal_info_credit">credit</code> element.</p></item>

    <item><p>The <code>years</code> element can have attributes from external
    namespaces.  See <link xref="mal_external"/> for more information
    on external-namespace attributes.</p></item>
  </list>
</section>
<!-- END notes -->


<!-- BEGIN processing -->
<section id="processing">
  <title>Processing Expectations</title>

  <p>See the processing expectations for the
  <code xref="mal_info_credit">credit</code> element.</p>
</section>
<!-- END processing -->


<!-- BEGIN comparison -->
<section id="comparison">
  <title>Comparison to Other Formats</title>

  <p>The <code>years</code> element is similar to the
  <code href="http://www.docbook.org/tdg/en/html/year.html">year</code> element
  in DocBook.  In DocBook, each year is listed separately, and processing tools
  are expected to join them appropriately.  In Mallard, all years are listed in
  a single <code>years</code> element, formatted as they should be displayed.</p>
</section>
<!-- END comparison -->

</page>
