<commit_before><?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://www.gnome.org/~shaunm/mallard"
      type="topic"
      id="mal_inline_app">

<info>
  <link type="guide" xref="mal_inline#elements"/>
  <link type="seealso" xref="mal_attr_link"/>

  <version number="0.1" date="2007-02-08" status="review"/>

  <desc>The <code>app</code> element marks the human-readable name of an
  application or the title of a window within an application.</desc>

  <credit type="author">
    <name><NAME></name>
    <email><EMAIL></email>
  </credit>
  <copyright>
    <year>2007</year>
    <name><NAME></name>
  </copyright>

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

<title>Application Names</title>

<synopsis><code mime="application/relax-ng-compact-syntax">
mal_inline_app = element app
  { <link xref="mal_attr_link">mal_attr_link</link>?,
    <link xref="mal_inline#simple">mal_inline__simple</link>+
  }
</code></synopsis>

<p>The <code>app</code> element marks the human-readable name of an application
or the title of a window within an application.  It should not be used to mark
the name of the command used to run an application; use
<code xref="mal_inline_cmd">cmd</code> for this purpose instead.</p>

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

  <p>Application names are usually nouns, and are often common words or phrases
  that are indicative of their functionality.  Frequently, they are simply the
  name of what the application is.  In English and many other languages, the
  use of an application name in a sentence may sound like the author has simply
  mistakenly omitted an article, if the application name is not understood to
  be a title.</p>

  <p>For example, the calculator application that comes with Gnome is called
  <app>Calculator</app>.  If an author were to write <quote>To start
  Calculator…</quote>, then a reader may confuse this for <quote>To
  start the calculator…</quote> with an error.  This is even more pronounced
  in languages such as German where nouns are always capitalized.</p>

  <p>For this reason, it is recommended that application names marked with the
  <code>app</code> element are rendered in italics or using some other font
  variation.</p>
</section>
<!-- END processing -->

</page><commit_msg>Update attributes in app definition, add docbook comparison<commit_after><?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://www.gnome.org/~shaunm/mallard"
      type="topic"
      id="mal_inline_app">

<info>
  <link type="guide" xref="mal_inline#elements"/>
  <link type="seealso" xref="mal_attr_link"/>

  <version number="0.1" date="2007-02-08" status="review"/>

  <desc>The <code>app</code> element marks the human-readable name of an
  application or the title of a window within an application.</desc>

  <credit type="author">
    <name><NAME></name>
    <email><EMAIL></email>
  </credit>
  <copyright>
    <year>2007</year>
    <name><NAME></name>
  </copyright>

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

<title>Application Names</title>

<synopsis><code mime="application/relax-ng-compact-syntax">
mal_inline_app = element app {
  <link xref="mal_attr_link">mal_attr_link</link> ?,
  attribute style { xsd:NMTOKENS } ?,
  attribute * - (mal:* | local:*) { text } *,
  <link xref="mal_inline#simple">mal_inline__simple</link>+
}
</code></synopsis>

<p>The <code>app</code> element marks the human-readable name of an application
or the title of a window within an application.  It should not be used to mark
the name of the command used to run an application; use
<code xref="mal_inline_cmd">cmd</code> for this purpose instead.</p>


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

  <p>Application names are usually nouns, and are often common words or phrases
  that are indicative of their functionality.  Frequently, they are simply the
  name of what the application is.  In English and many other languages, the
  use of an application name in a sentence may sound like the author has simply
  mistakenly omitted an article, if the application name is not understood to
  be a title.</p>

  <p>For example, the calculator application that comes with Gnome is called
  <app>Calculator</app>.  If an author were to write <quote>To start
  Calculator…</quote>, then a reader may confuse this for <quote>To
  start the calculator…</quote> with an error.  This is even more pronounced
  in languages such as German where nouns are always capitalized.</p>

  <p>For this reason, it is recommended that application names marked with the
  <code>app</code> element are rendered in italics or using some other font
  variation.</p>
</section>
<!-- END processing -->


<!-- BEGIN docbook -->
<section id="docbook">
  <title>Comparison to DocBook</title>
  <p>The <code>app</code> element is functionally similar to DocBook's
  <code href="http://www.docbook.org/tdg/en/html/application.html">application</code>
  element.</p>
</section>
<!-- END docbook -->

</page>
{'fraction_non_alphanumeric': 0.1278592375366569, 'fraction_numerical': 0.008602150537634409, 'mean_word_length': 4.3125649013499485, 'pattern_counts': {'":': 0, '<': 143, '<?xml version=': 2, '>': 143, 'https://': 0, 'lorem ipsum': 0, 'www.': 5, 'xml': 8}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '905717', 'n_tokens_mistral': 1609, 'n_tokens_neox': 1526, 'n_words': 544}