summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2008-07-25 16:06:36 +0200
committerLennart Poettering <lennart@poettering.net>2008-07-25 16:06:36 +0200
commit4b1ba679f6d806e6f077b05846ff1e7bce76453f (patch)
tree2b9a8fc92baa2346552b05d92094cc1f20cc9070
parente56e693455d80509da875ef43a870a72d6622eb7 (diff)
document why dialog-error and not error-dialog
-rw-r--r--spec/sound-naming-spec.xml12
1 files changed, 11 insertions, 1 deletions
diff --git a/spec/sound-naming-spec.xml b/spec/sound-naming-spec.xml
index 9d63860..f313c3b 100644
--- a/spec/sound-naming-spec.xml
+++ b/spec/sound-naming-spec.xml
@@ -158,7 +158,17 @@ usage.
result. However, if the more specific item does not exist
in the current theme, and does exist in a parent theme,
the generic sound from the current theme is preferred, in
- order to keep consistent style.
+ order to keep consistent style. From left to right the
+ words in a sound name become more specific. In some cases
+ what word in a name is more specific is
+ ambiguous. (i.e. "dialog-error" and "error-dialog" both
+ make sense, the former would ease defining the same sound
+ for all dialogs popping up, regardless of its context, the
+ latter would ease defining the same sound for all errors,
+ regardless of how it is presented to the user). In such
+ cases it is generally preferred to put the UI element noun
+ left -- if there is one --, however exceptions of this
+ rule are acceptable.
</para>
</listitem>
<listitem>