← Back to branch summary

~ubuntu-branches/ubuntu/trusty/gnome-doc-utils/trusty-proposed

« back to all changes in this revision

Viewing changes to doc/mallard/C/mal_info_name.page

  • Committer: Bazaar Package Importer
  • Author(s): Didier Roche
  • Date: 2010-02-23 15:55:38 UTC
  • mfrom: (1.1.29 upstream)
  • Revision ID: james.westby@ubuntu.com-20100223155538-odq0bbr5tl0p2lpv
Tags: 0.19.5-0ubuntu1
* New upstream release:
  - Updated the Mallard RNG schema (Shaun McCance)
  - Bold userinput inside programlisting (Shaun McCance)
  - Updated translations
* debian/control.in:
  - bump Standards-Version

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/mallard/C/mal_info_name.page
1
 
<page xmlns="http://projectmallard.org/1.0/"
2
 
      type="topic"
3
 
      id="mal_info_name">
4
 
 
5
 
<info>
6
 
  <link type="guide" xref="mal_info#additional"/>
7
 
 
8
 
  <revision version="0.1" date="2009-08-01" status="review"/>
9
 
 
10
 
  <credit type="author">
11
 
    <name>Shaun McCance</name>
12
 
    <email>shaunm@gnome.org</email>
13
 
    <years>2009</years>
14
 
  </credit>
15
 
 
16
 
  <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" />
17
 
 
18
 
  <desc>FIXME</desc>
19
 
</info>
20
 
 
21
 
<title>Names</title>
22
 
 
23
 
<synopsis><code mime="application/relax-ng-compact-syntax">
24
 
mal_info_name = element name {
25
 
  attribute * - (mal:* | local:*) { text } *,
26
 
  <link xref="mal_inline">mal_inline</link>
27
 
}
28
 
</code></synopsis>
29
 
 
30
 
<p>Use the <code>name</code> element to mark up the name of a person or
31
 
organization in a <code xref="mal_info_credit">credit</code> element.</p>
32
 
 
33
 
 
34
 
<!-- BEGIN notes -->
35
 
<section id="notes">
36
 
  <title>Notes</title>
37
 
  <list>
38
 
    <item><p>The <code>name</code> element can contain a mixture of text and
39
 
    any <link xref="mal_inline">general inline elements</link>.</p></item>
40
 
 
41
 
    <item><p>The <code>name</code> element can occur in the
42
 
    <code xref="mal_info_credit">credit</code> element.</p></item>
43
 
 
44
 
    <item><p>The <code>name</code> element can have attributes from external
45
 
    namespaces.  See <link xref="mal_external"/> for more information
46
 
    on external-namespace attributes.</p></item>
47
 
  </list>
48
 
</section>
49
 
<!-- END notes -->
50
 
 
51
 
 
52
 
<!-- BEGIN processing -->
53
 
<section id="processing">
54
 
  <title>Processing Expectations</title>
55
 
 
56
 
  <p>See the processing expectations for the
57
 
  <code xref="mal_info_credit">credit</code> element.</p>
58
 
</section>
59
 
<!-- END processing -->
60
 
 
61
 
 
62
 
<!-- BEGIN comparison -->
63
 
<section id="comparison">
64
 
  <title>Comparison to Other Formats</title>
65
 
 
66
 
  <p>The <code>name</code> element fulfills the same role as numerous DocBook
67
 
  elements, including
68
 
  <link href="http://www.docbook.org/tdg/en/html/collabname.html">collabname</link>,
69
 
  <link xref="http://www.docbook.org/tdg/en/html/personname.html">personname</link>, and
70
 
  <link xref="http://www.docbook.org/tdg/en/html/publishername.html">publishername</link>.
71
 
  Note that Mallard does not attempt to model the names of people, as the rules for
72
 
  how to display names from their constituent parts vary considerably.  If parts of
73
 
  a name are needed for a domain-specific purpose, they can be included using elements
74
 
  from external namespaces on the parent element.</p>
75
 
</section>
76
 
<!-- END comparison -->
77
 
 
78
 
 
79
 
</page>