Wow, since I rarely use this module (even in the 3.x days), I never realized how flexible this was.<br><br>Perhaps I'm using an old edition of the KDE Help Center (the Colors section refers to a Revision 3.2), but I don't actually see this documentation anywhere. So either I'm looking in the wrong place, or this revision is old, or this is a new addition to that document. Either way, I couldn't compare this to anything preexisting.<br>
<br>Fortunately, I just got done and tried everything as described in the help document below, and for the most part I understand what is being said. I do have a few small adjustments I'd like to suggest, if they're not too unreasonable:<br>
<br>
<br>
=============================================================================================<br>
=============================================================================================<br><br><br>1 ##################################################################<br>In the line:<br><br>+ a custom scheme.</para><br>
<br>I would suggest "custom scheme" if possible. The wording "color scheme" as used in the sentence almost seemed to imply I could take any scheme from the list (say, Magma), change it to all sorts of wacky colors, and then have that scheme save permanently with said wacky colors. The reality, however, is that the color changes will ONLY affect the virtual scheme called "Current", which will not be permanent unless explicitly saved with the Save Scheme button.<br>
<br><br>2 ##################################################################<br>In the line:<br><br> that you save your scheme when you are done.</para><br><br>I would recommend referencing the Scheme tab, as in "save your scheme in the Scheme tab". It sounds like an obsessive precaution, but it may not be necessarily obvious to the initiate where the Save Scheme button is.<br>
<br><br>3 ##################################################################<br>The entire section from:<br><br> + <para>The <guilabel>Common Colors</guilabel> set, which is displayed<br><br>to<br><br>
+ all, and can only be changed (if needed) by selecting the appropriate<br> + set.</para><br><br>...is not technically wrong -- in fact, it's admirably detailed. However, it does seem like it goes into too great length to explain what Common Colors is, which, as I would describe it, is merely the "Simple View" of the Colors tab, whereas the View, Window, Button, Selection and Tooltip combined make up a kind of "Advanced View". <br>
<br>Perhaps the detail is necessary after all since Common Colors is, unfortunately, mixed in with the other sets and easy to confuse as one.<br><br>Perhaps this is really more of a UI issue, and could be fixed if that color set dropdown were replaced by a toggle between "Quickly Modify Common Colors" and "Fine Tune Color Sets", the latter of which would enable the dropdown with only View, Window, Button, Selection and Tooltip.<br>
<br>But I'm not a dev, so I'll just mention that in passing -- if anything, the current setup likely has a rhyme-and-reason to it. ^^;<br><br><br>4 ##################################################################<br>
I'm not sure what:<br><br> <para>The choice of color role is left to the developer; the above are<br> guidelines intended to represent typical usage.</para><br><br>...refers to unfortunately. :(<br>
<br>Judging by the symbols, it seems this is only a DIFF from the source document, so there are likely snippets here and there of unrelated documentation left over.<br><br><br>5 ##################################################################<br>
In the lines:<br><br> + used to draw the title bar background, borders, and/or decorations for<br> + active window (that is, the one with input focus). Not all window<br><br>I would add the "the" before "active window", so the phrase will read as "used to draw the title bar background, borders, and/or decorations for the active window...".<br>
<br><br>6 ###################################################################<br>For the section:<br><br> + used to draw the title bar text when Active Titlebar is used to draw<br> + the title bar background. May also be used for other foreground<br>
+ elements which use Active Titlebar as the background.<br><br>I understand what it means, but I can't shake the feeling that "Active Titlebar" alone sounds a bit broken. But I can't really say that "the Active Titlebar role" will make it any better. :(<br>
<br><br>7 ###################################################################<br><br>Looking back on the entire section of Window Manager Roles, I can't help but feel a small contradiction regarding the role of Common Colors, given it does indeed contain UNIQUE elements not found in View, Window, Button, Selection, or Tooltip. In reality, there really should be a Window Manager set too in order for the Common Colors pseudo-set to be true to its name. But again, this is a dev issue. ;)<br>
<br><br>=============================================================================================<br>=============================================================================================<br><br>And that concludes my analysis. Sorry for the length, and also for not actually doing these changes myself, but I don't know how and besides these are really suggestions only. The last call is yours. ^^b<br>
<br>Thank you for allowing me to use this as my first substantial contribution to KDE. It's not much, but I hope it's a start. ^___^<br><br><br>Cheers!<br><br>--Arturo "C-quel" Silva<br><br><br><br><br>
<div class="gmail_quote">On Tue, Sep 1, 2009 at 3:05 PM, Matthew Woehlke <span dir="ltr"><<a href="mailto:mw_triad@users.sourceforge.net">mw_triad@users.sourceforge.net</a>></span> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
SVN commit 1018504 by mwoehlke:<br>
<br>
Update color kcm doc based on comments from Burkhard Lück.<br>
<br>
Further comments/suggestions welcomed, please send to me and/or k-doc-en.<br>
<br>
CCMAIL: <a href="mailto:kde-doc-english@kde.org">kde-doc-english@kde.org</a><br>
<br>
<br>
M +46 -6 index.docbook<br>
<br>
<br>
--- trunk/KDE/kdebase/workspace/doc/kcontrol/colors/index.docbook #1018503:1018504<br>
@@ -147,18 +147,31 @@<br>
<title>Colors</title><br>
<br>
<para>The <guilabel>Colors</guilabel> tab allows you to change the colors in<br>
- a color scheme. The <guilabel>Common Colors</guilabel> set, which is displayed<br>
- initially, is not actually a "set" in the sense used by &kde; (see next<br>
- section), but presents a number of color roles in a way that makes it<br>
- easier to edit the scheme as a whole. When creating a new color scheme, you<br>
- will usually change these colors first, and use the other sets to tweak<br>
- specific colors if needed.</para><br>
+ a color scheme.</para><br>
<br>
<para>Creating or changing a scheme is a simple matter of clicking on the<br>
swatch in the color list and selecting a new color. You can check your<br>
changes at any time by pressing <guibutton>Apply</guibutton>. It is suggested<br>
that you save your scheme when you are done.</para><br>
<br>
+ <para>The <guilabel>Common Colors</guilabel> set, which is displayed<br>
+ initially, is not actually a &quot;set&quot; in the sense used by &kde; (see<br>
+ next section), but presents a number of color roles in a way that makes it<br>
+ easier to edit the scheme as a whole. When creating a new color scheme, you<br>
+ will usually change these colors first, and use the other sets to tweak<br>
+ specific colors if needed.</para><br>
+<br>
+ <para>Note that <guilabel>Common Colors</guilabel> makes available roles from<br>
+ all sets. For example, &quot;View Background&quot; here is shorthand for the<br>
+ Normal Background role from the View set. Also, setting colors that do not<br>
+ refer to a specific set will change that color in <emphasis>all</emphasis><br>
+ sets. (As an exception, &quot;Inactive Text&quot; will change the color for<br>
+ all sets <emphasis>except</emphasis> for Selection; there is a separate<br>
+ &quot;Selection Inactive Text&quot; for Inactive Text in the Selection set.)<br>
+ Some roles may not be visible under <guilabel>Common Colors</guilabel> at<br>
+ all, and can only be changed (if needed) by selecting the appropriate<br>
+ set.</para><br>
+<br>
<sect3><br>
<title>Color Sets</title><br>
<br>
@@ -261,6 +274,32 @@<br>
<para>The choice of color role is left to the developer; the above are<br>
guidelines intended to represent typical usage.</para><br>
</sect3><br>
+<br>
+ <sect3><br>
+ <title>Window Manager Roles</title><br>
+<br>
+ <para>As previously stated, the Window Manager set has its own roles,<br>
+ independent of those in other sets. These are (currently) only accessible<br>
+ via <guilabel>Common Colors</guilabel>, and are as follows:</para><br>
+<br>
+ <itemizedlist><br>
+ <listitem><para>Active Titlebar &mdash;<br>
+ used to draw the title bar background, borders, and/or decorations for<br>
+ active window (that is, the one with input focus). Not all window<br>
+ decorations will use this in the same way, and some may even use the<br>
+ Normal Background from the Window set to draw the title bar.<br>
+ </para></listitem><br>
+ <listitem><para>Active Titlebar Text &mdash;<br>
+ used to draw the title bar text when Active Titlebar is used to draw<br>
+ the title bar background. May also be used for other foreground<br>
+ elements which use Active Titlebar as the background.<br>
+ </para></listitem><br>
+ </itemizedlist><br>
+<br>
+ <para>The Inactive Titlebar [Text] roles are the same as the above, but for<br>
+ inactive windows, rather than active windows.</para><br>
+ </sect3><br>
+<br>
</sect2><br>
<br>
<sect2 id="color-effects"><br>
@@ -350,6 +389,7 @@<br>
slider produces no change, while maximum causes the text to completely<br>
disappear into the background.</para><br>
</sect3><br>
+<br>
</sect2><br>
<br>
</sect1><br>
_______________________________________________<br>
kde-doc-english mailing list<br>
<a href="mailto:kde-doc-english@kde.org">kde-doc-english@kde.org</a><br>
<a href="https://mail.kde.org/mailman/listinfo/kde-doc-english" target="_blank">https://mail.kde.org/mailman/listinfo/kde-doc-english</a><br>
</blockquote></div><br>