[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kwrite-devel
Subject:    Re: Default Styles
From:       Michal Humpula <michal.humpula () seznam ! cz>
Date:       2014-02-18 6:40:30
Message-ID: 2979407.o4padneRzu () amonsul
[Download RAW message or body]

On Monday 17 of February 2014 22:43:08 Dominik Haumann wrote:
> Some time ago, I've made a list of default styles. This list is now extended
> by the few additions proposed in the last thread. Further, I think it makes
> a lot of sense if we add categories. These categories should be followed when
> using a default style (i.e. one should not use dsFunction in a comment).
> 
> The current list looks as follows:
> Legend:
>  '-': already exists
>  '+': new, and makes a lot of sense
>  '?': new, really needed?
> 
> Text
> - dsNormal
> - dsKeyword
> + dsExtension   (new, same as keyword, e.g. Qt, tr1, and other extensions)
> + dsControlFlow (new, or dsStructure, if, else, switch, continue)
> - dsFunction
> - dsDataType
> + dsVariable    (new, $bla in php or perl, or dsIdentifier?)
> ? dsSection     (new, e.g. [general] in ini file, or \section in LaTeX)
> 
> Strings
> - dsChar
> - dsString
> ? dsRawString   (new, '' in Perl, CoffeeScript and Bash, r'' or r"" in Python)

ruby & puppet might use it.

> + dsRegExp      (new, JavaScript and other languages heavily rely on it)

ruby & puppet would use it.

> ? dsRegExpOp    (new, RegExp semantics: ^\., [:space:], ...)
> 
> Numbers
> - dsDecVal
> - dsBaseN
> - dsFloat
> + dsOperator    (new, for +-*/::<> etc..., lots of languages define this)
> ? dsConstant    (new, if needed? maybe M_PI or similar things? not sure...)

ruby would use it, puppet might use it.

> 
> Misc
> - dsOthers
> ? dsLink        (new, url, path)
> ? dsDeprecated  (new: maybe for deprecated stuff?)
> 
> Comments & Documentation
> - dsComment
> + dsDescription (new, e.g. @brief in doxygen, or """ in Python?)
> + dsAnnotation  (new, e.g. @... in Java, @param in Doxygen)
> + dsCommentVar  (new, e.g. foobar in "@param foobar", etc...)
> ? dsExample     (new, e.g. @code ... @endcode, or dsVerbatim ? )
> - dsRegionMarker
> 
> Notifications
> - dsError
> - dsAlert
> ? dsPositive    (new, e.g. NOTE)
> ? dsInformation (new, e.g. TODO)
> ? dsWarning     (new, HACK, ###, FIXME)
> 
> This makes 8 new default styles (+), and again 10 new default styles marked with "?".
> 
> 
> I'm currently not convinced of:
> ? dsInterface: C# interfaces, Scala mixins, declarations, protocols
> ? dsReference: Markdown links, C pointers, LaTeX refs
> ? dsBuiltin: Value keywords like Java's true, R's FALSE, Python's None,
>              JS' null, as well as Python's open, reversed, ..., and Go's
>              predeclared identifiers like new, print, ...
> ? dsBuiltinValue
> ? dsBuiltinFunction
> ? dsException: Often with Exception or Error in the name
> ? dsSymbol

ruby would use it, puppet might use it.

> I think it would be nice to discuss this a bit, update the list again, and
> then add at least the default styles that we agree on.
> 
> The big question is:
> Will these default styles enable us to ditch many/most of the hard-coded colors?
> (I have not checked in detail)
> 
> Greetings,
> Dominik
> _______________________________________________
> KWrite-Devel mailing list
> KWrite-Devel@kde.org
> https://mail.kde.org/mailman/listinfo/kwrite-devel
> 

_______________________________________________
KWrite-Devel mailing list
KWrite-Devel@kde.org
https://mail.kde.org/mailman/listinfo/kwrite-devel

[prev in list] [next in list] [prev in thread] [next in thread]