1
<page xmlns="http://projectmallard.org/1.0/"
3
id="mal_info_copyright">
6
<link type="guide" xref="mal_info#elements"/>
8
<revision version="0.1" date="2009-05-28" status="review"/>
10
<credit type="author">
11
<name>Shaun McCance</name>
12
<email>shaunm@gnome.org</email>
16
<name>Shaun McCance</name>
19
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" />
21
<desc>Record information about copyright holders.</desc>
24
<title>Copyright Information</title>
26
<synopsis><code mime="application/relax-ng-compact-syntax">
27
mal_info_copyright = element copyright {
28
attribute * - (mal:* | local:*) { text } *,
31
element year { text } + &
32
<link xref="mal_info_name">mal_info_name</link> &
33
<link xref="mal_info_email">mal_info_email</link> ? &
34
element * - (mal:* | local:*) { mal_inline } *
39
<p>Use the <code>copyright</code> element to include information about the
40
copyright holders of the page or section. You can record the name and email
41
address of the copyright holder, as well as any years in which the holder
42
contributed copyrighted material.</p>
49
<item><p>The <code>copyright</code> element contains one or more <code>year</code>
50
elements, a <code>name</code> element, and an optional <code>email</code> element.
51
The <code>copyright</code> element can also contain elements from external
52
namespaces. The order of the child elements does not matter.</p></item>
54
<item><p>The <code>copyright</code> element can occur in any
55
<code xref="mal_info">info</code> element.</p></item>
57
<item><p>The <code>copyright</code> element can have attributes from external
58
namespaces. See <link xref="mal_external"/> for more information
59
on external-namespace attributes.</p></item>
65
<!-- BEGIN processing -->
66
<section id="processing">
67
<title>Processing Expectations</title>
69
<p>There are no specific processing expectations for the <code>copyright</code>
70
element. As an informational element, it is not necessarily displayed. Some
71
tools, however, may choose to display copyrights at the bottom of a page, on a
72
separate information page, or in a dialog.</p>
74
<p>When processing the children of a <code>copyright</code> element, tools
75
should select the child elements they understand and ignore all other child
78
<!-- END processing -->
81
<!-- BEGIN comparison -->
82
<section id="comparison">
83
<title>Comparison to Other Formats</title>
85
<p>The <code>copyright</code> element is similar to the
86
<code href="http://www.docbook.org/tdg/en/html/copyright.html">copyright</code>
87
element in DocBook. Mallard allows more information to be recorded about a
88
particular copyright holder through informational child elements. In DocBook,
89
a single <code>copyright</code> element can have multiple
90
<code href="http://www.docbook.org/tdg/en/html/holder.html">holder</code>
91
children. In Mallard, each <code>copyright</code> element is restricted to
92
a single copyright holder.</p>
94
<!-- END comparison -->