[gnome-doc-utils/mallard: 79/87] Changed language to refer to "display tools" where appropriate



commit 3c4ce292b10f91bc65fbfb18e2b155a7e67c8e02
Author: Shaun McCance <shaunm gnome org>
Date:   Tue Dec 16 18:45:52 2008 -0600

    Changed language to refer to "display tools" where appropriate
---
 doc/mallard/C/mal_block_code.xml     |    8 ++++----
 doc/mallard/C/mal_block_note.xml     |    2 +-
 doc/mallard/C/mal_block_synopsis.xml |    2 +-
 doc/mallard/C/mal_inline_app.xml     |    2 +-
 doc/mallard/C/mal_inline_cmd.xml     |    6 +++---
 doc/mallard/C/mal_inline_code.xml    |    6 +++---
 doc/mallard/C/mal_inline_em.xml      |    8 ++++----
 doc/mallard/C/mal_inline_file.xml    |    2 +-
 doc/mallard/C/mal_inline_gui.xml     |    6 +++---
 doc/mallard/C/mal_inline_guiseq.xml  |    2 +-
 doc/mallard/C/mal_inline_input.xml   |    8 ++++----
 doc/mallard/C/mal_inline_key.xml     |    4 ++--
 doc/mallard/C/mal_inline_keyseq.xml  |    2 +-
 doc/mallard/C/mal_inline_link.xml    |    2 +-
 doc/mallard/C/mal_inline_output.xml  |    6 +++---
 doc/mallard/C/mal_inline_sys.xml     |    2 +-
 doc/mallard/C/mal_inline_var.xml     |    2 +-
 17 files changed, 35 insertions(+), 35 deletions(-)

diff --git a/doc/mallard/C/mal_block_code.xml b/doc/mallard/C/mal_block_code.xml
index 097e362..a11fe6a 100644
--- a/doc/mallard/C/mal_block_code.xml
+++ b/doc/mallard/C/mal_block_code.xml
@@ -55,7 +55,7 @@ mal_block_code = element code {
     <p>Add processing expectations.  For block, strip leading/trailing
     newline.  Do not strip leading indentation.</p>
   </comment>
-  <p>Processing tools should strip a leading newline and a trailing newline
+  <p>display tools should strip a leading newline and a trailing newline
   from the text content.  This allows people to write XML like the following:</p>
   <code>
 &lt;code&gt;
@@ -67,11 +67,11 @@ def frobnicate (foo, bar):
 &lt;/code&gt;
 </code>
   <p>This is much more natural to read and write, since every line is on its
-  own without markup.  Processing tools should strip no more than one newline
+  own without markup.  Display tools should strip no more than one newline
   from either end, in case authors need to insert intentional newlines.  If
-  the first or last child is an element, processing tools should not descend
+  the first or last child is an element, display tools should not descend
   into those elements to strip newlines.</p>
-  <p>Processing tools should not attempt to strip uniform indentation from
+  <p>Display tools should not attempt to strip uniform indentation from
   the text contents.  Authors sometimes indent preformatted text to match
   the indentation of the surrounding markup.  Handling this reliably is
   difficult and can lead to unexpected results.  Authors should fix their
diff --git a/doc/mallard/C/mal_block_note.xml b/doc/mallard/C/mal_block_note.xml
index f5c4b20..efd3d44 100644
--- a/doc/mallard/C/mal_block_note.xml
+++ b/doc/mallard/C/mal_block_note.xml
@@ -24,7 +24,7 @@ mal_block_note = element note {
   <title>Discussion</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item>
diff --git a/doc/mallard/C/mal_block_synopsis.xml b/doc/mallard/C/mal_block_synopsis.xml
index 87ac50e..cbc7749 100644
--- a/doc/mallard/C/mal_block_synopsis.xml
+++ b/doc/mallard/C/mal_block_synopsis.xml
@@ -36,7 +36,7 @@ control element.</p>
   <p>A <code>synopsis</code> element is rendered as a displayed block,
   with each of its child elements interpreted as block elements.  Since
   a <code>synopsis</code> element often contains large blocks, and is
-  generally offset from the running text, processing tools may opt to
+  generally offset from the running text, display tools may opt to
   render it inside a colored or screened box, with a border, or
   otherwise differently from the surrounding text.</p>
 
diff --git a/doc/mallard/C/mal_inline_app.xml b/doc/mallard/C/mal_inline_app.xml
index 1e71006..f87ffce 100644
--- a/doc/mallard/C/mal_inline_app.xml
+++ b/doc/mallard/C/mal_inline_app.xml
@@ -45,7 +45,7 @@ use <code xref="mal_inline_cmd">cmd</code> for this purpose instead.</p>
   <title>Notes</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item><p>The <code>app</code> element can link to other pages or documents.
diff --git a/doc/mallard/C/mal_inline_cmd.xml b/doc/mallard/C/mal_inline_cmd.xml
index add468b..6c741ff 100644
--- a/doc/mallard/C/mal_inline_cmd.xml
+++ b/doc/mallard/C/mal_inline_cmd.xml
@@ -57,11 +57,11 @@ by the user.</p>
   <title>Notes</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item><p>The <code>mime</code> attribute takes a valid MIME type.  Processing
-    tools may adjust their rendering for particular MIME types.</p></item>
+    tools may adjust their behavior for particular MIME types.</p></item>
 
     <item>
       <p>Typical values for the <code>mime</code> attribute include:</p>
@@ -142,7 +142,7 @@ you to filter files based on their modification times.
   how to use them to a particular effect.  This can make it difficult to find
   the end of the command quickly.  Surrounding text content, especially
   punctuation, can sometimes be confused for part of the command.  For this
-  reason, it is recommended that processing tools apply a border or background
+  reason, it is recommended that display tools apply a border or background
   color to commands.</p>
 </section>
 <!-- END processing -->
diff --git a/doc/mallard/C/mal_inline_code.xml b/doc/mallard/C/mal_inline_code.xml
index 08f387c..b2b9ace 100644
--- a/doc/mallard/C/mal_inline_code.xml
+++ b/doc/mallard/C/mal_inline_code.xml
@@ -53,11 +53,11 @@ by the user.</p>
   <title>Notes</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item><p>The <code>mime</code> attribute takes a valid MIME type.  Processing
-    tools may adjust their rendering for particular MIME types.</p></item>
+    tools may adjust their behavior for particular MIME types.</p></item>
 
     <item><p>The <code>code</code> element can link to other pages or documents.
     See <link xref="mal_attr_link"/> for more information.</p></item>
@@ -123,7 +123,7 @@ up code with a placeholder for an argument the user should supply.
   appear without the context of a known word that helps make them discernable
   in normal prose.</p>
 
-  <p>For particularly long code snippets, processing tools may use a background
+  <p>For particularly long code snippets, display tools may use a background
   color or border to make the beginning and end clear, although authors should
   prefer <link xref="mal_block_code">code blocks</link> for long code snippets.</p>
 </section>
diff --git a/doc/mallard/C/mal_inline_em.xml b/doc/mallard/C/mal_inline_em.xml
index 3eaa5e1..82c6337 100644
--- a/doc/mallard/C/mal_inline_em.xml
+++ b/doc/mallard/C/mal_inline_em.xml
@@ -34,7 +34,7 @@ mal_inline_em = element em {
 <p>Use the <code>em</code> element to emphasize text.  You may use <code>em</code>
 to stress certain words in a sentence.  Do not use <code>em</code> to effect a
 particular typographic style, since it may be rendered differently by different
-processing tools.</p>
+display tools.</p>
 
 
 <!-- BEGIN notes -->
@@ -42,7 +42,7 @@ processing tools.</p>
   <title>Notes</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item><p>The <code>em</code> element can link to other pages or documents.
@@ -104,10 +104,10 @@ Note that <em>accelerators</em> are different from <em>mnemonics</em>.
   <p>The <code>em</code> element is similar to the
   <code href="http://www.docbook.org/tdg/en/html/emphasis.html";>emphasis</code>
   element in DocBook.  Athough DocBook does not normatively specify a means of
-  controlling the presentation, most DocBook processing tools allow writers to
+  controlling the presentation, most DocBook display tools allow writers to
   set the <code>role</code> attribute to <code>bold</code> or <code>strong</code>
   to specify bold text.  We explicitly recommend against doing this in Mallard
-  documents and processing tools.</p>
+  documents and display tools.</p>
 </section>
 <!-- END docbook -->
 
diff --git a/doc/mallard/C/mal_inline_file.xml b/doc/mallard/C/mal_inline_file.xml
index 38e6202..2a07008 100644
--- a/doc/mallard/C/mal_inline_file.xml
+++ b/doc/mallard/C/mal_inline_file.xml
@@ -41,7 +41,7 @@ filenames, such as search paths and file extensions.</p>
   <title>Notes</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item><p>The <code>file</code> element can link to other pages or documents.
diff --git a/doc/mallard/C/mal_inline_gui.xml b/doc/mallard/C/mal_inline_gui.xml
index 5d794c2..2af9a4b 100644
--- a/doc/mallard/C/mal_inline_gui.xml
+++ b/doc/mallard/C/mal_inline_gui.xml
@@ -43,7 +43,7 @@ control is being marked up.</p>
   <title>Notes</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item><p>Typical style hints include:</p>
@@ -126,10 +126,10 @@ of your keyboard to meet certain accessibility needs.
   <title>Processing Expectations</title>
 
   <p>No particular special rendering is required for <code>gui</code> elements.
-  Processing tools may use subtle effects such as lightened text to distinguish
+  Display tools may use subtle effects such as lightened text to distinguish
   interface labels elements from the surrounding text.</p>
 
-  <p>In certain environments, processing tools may decorate interface labels
+  <p>In certain environments, display tools may decorate interface labels
   with an icon or other effect based on the <code>style</code> attribute.
   For example, in a table of options where the first element of each row is
   a <code>gui</code> element, those with the <code>checkbox</code> style
diff --git a/doc/mallard/C/mal_inline_guiseq.xml b/doc/mallard/C/mal_inline_guiseq.xml
index c76a30a..fefa4b6 100644
--- a/doc/mallard/C/mal_inline_guiseq.xml
+++ b/doc/mallard/C/mal_inline_guiseq.xml
@@ -41,7 +41,7 @@ items.</p>
   <title>Notes</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item><p>The <code>guiseq</code> element can have attributes from external
diff --git a/doc/mallard/C/mal_inline_input.xml b/doc/mallard/C/mal_inline_input.xml
index 7e94c06..403f2f4 100644
--- a/doc/mallard/C/mal_inline_input.xml
+++ b/doc/mallard/C/mal_inline_input.xml
@@ -42,13 +42,13 @@ or into a text field in a graphical application.</p>
   <title>Notes</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item><p>The <code>input</code> element, together with the
-    <code xref="mal_inline_outpu">output</code> element, may be used to mark up
+    <code xref="mal_inline_output">output</code> element, may be used to mark up
     the contents of a <code xref="mal_block_screen">screen</code> element,
-    allowing processing tools to render them differently.</p></item>
+    allowing processing tools to treat them differently.</p></item>
 
     <item><p>The <code>input</code> element can link to other pages or documents.
     See <link xref="mal_attr_link"/> for more information.</p></item>
@@ -77,7 +77,7 @@ or into a text field in a graphical application.</p>
 
   <p>User input should be displayed in a fixed-width or wide font.  Fixed-width
   fonts tend to have more distinction between visually similar characters.
-  Processing tools may use a background color or border to make the beginning
+  Display tools may use a background color or border to make the beginning
   and end of the intut clear.</p>
 </section>
 
diff --git a/doc/mallard/C/mal_inline_key.xml b/doc/mallard/C/mal_inline_key.xml
index 4c691b2..2b4c437 100644
--- a/doc/mallard/C/mal_inline_key.xml
+++ b/doc/mallard/C/mal_inline_key.xml
@@ -45,7 +45,7 @@ these instead.</p>
   <title>Notes</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item><p>The <code>key</code> element can link to other pages or documents.
@@ -99,7 +99,7 @@ Press the <key>Down</key> key to select the next item.
   <title>Processing Expectations</title>
 
   <p>No particular special rendering is required for <code>key</code> elements.
-  Processing tools may use subtle effects such as lightened text or borders to
+  Display tools may use subtle effects such as lightened text or borders to
   distinguish interface keys from the surrounding text.</p>
 </section>
 <!-- END processing -->
diff --git a/doc/mallard/C/mal_inline_keyseq.xml b/doc/mallard/C/mal_inline_keyseq.xml
index 36217e0..d443ef3 100644
--- a/doc/mallard/C/mal_inline_keyseq.xml
+++ b/doc/mallard/C/mal_inline_keyseq.xml
@@ -51,7 +51,7 @@ mal_inline_keyseq = element keyseq {
     The default is <code>"combo"</code>.</p></item>
 
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item><p>The <code>keyseq</code> element can have attributes from external
diff --git a/doc/mallard/C/mal_inline_link.xml b/doc/mallard/C/mal_inline_link.xml
index f56bc85..01dd244 100644
--- a/doc/mallard/C/mal_inline_link.xml
+++ b/doc/mallard/C/mal_inline_link.xml
@@ -46,7 +46,7 @@ mal_inline_link = element link {
   <title>Notes</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item><p>The <code>link</code> element can have attributes from external
diff --git a/doc/mallard/C/mal_inline_output.xml b/doc/mallard/C/mal_inline_output.xml
index bdb1f2e..0b04bb7 100644
--- a/doc/mallard/C/mal_inline_output.xml
+++ b/doc/mallard/C/mal_inline_output.xml
@@ -53,7 +53,7 @@ differently.</p>
   <title>Notes</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item>
@@ -73,7 +73,7 @@ differently.</p>
     <item><p>The <code>output</code> element, together with the
     <code xref="mal_inline_input">input</code> element, may be used to mark up
     the contents of a <code xref="mal_block_screen">screen</code> element,
-    allowing processing tools to render them differently.</p></item>
+    allowing processing tools to treat them differently.</p></item>
 
     <item><p>The <code>output</code> element can link to other pages or documents.
     See <link xref="mal_attr_link"/> for more information.</p></item>
@@ -141,7 +141,7 @@ if you use the Bourne-again shell.
 
   <p>Computer output should be displayed in a fixed-width or wide font.
   Fixed-width fonts tend to have more distinction between visually similar
-  characters.  Processing tools may use a background color or border to
+  characters.  Display tools may use a background color or border to
   make the beginning and end of the ouptut clear.</p>
 </section>
 
diff --git a/doc/mallard/C/mal_inline_sys.xml b/doc/mallard/C/mal_inline_sys.xml
index 80fd42d..fe195bd 100644
--- a/doc/mallard/C/mal_inline_sys.xml
+++ b/doc/mallard/C/mal_inline_sys.xml
@@ -28,7 +28,7 @@ mal_inline_sys = element sys {
   <title>Notes</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item><p>The <code>sys</code> element can link to other pages or documents.
diff --git a/doc/mallard/C/mal_inline_var.xml b/doc/mallard/C/mal_inline_var.xml
index 1c6a96a..4ef750d 100644
--- a/doc/mallard/C/mal_inline_var.xml
+++ b/doc/mallard/C/mal_inline_var.xml
@@ -36,7 +36,7 @@ an indicated argument.</p>
   <title>Notes</title>
   <list type="bullet">
     <item><p>The <code>style</code> attribute takes a space-separated list of
-    style hints.  Processing tools should adjust their rendering according to
+    style hints.  Processing tools should adjust their behavior according to
     those style hints they understand.</p></item>
 
     <item><p>The <code>var</code> element can link to other pages or documents.



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]