dhaumann added a comment.

  Imho the API is currently not clear enough, see comment below. Can we somehow 
resolve this?

INLINE COMMENTS

> definition.h:339
> +     * @since 5.62
> +     */
> +    bool setKeywordList(const QString& name, const QStringList& content);

Please improve the API documentation and add, for instance:

- Only existing keywordLists() can be changed. For non-existent keyword lists, 
false is returned.
- @see keywordList(), keywordLists()

What I am currently also missing is a section about highlight invalidation: 
Does one have to trigger a document rehighlight oneself, and if so, how?

My point is: Assume a doc is highlighted up to line 100. Now you add keywords 
to a list that are used in these 100 lines, i.e. the highlighting may change 
arbitrarily.

How is the KSyntaxHighlighting user supposed to trigger a rehighlight? Or 
should one only change keyword lists before highlighting any document?

REPOSITORY
  R216 Syntax Highlighting

REVISION DETAIL
  https://phabricator.kde.org/D23061

To: sirgienko, dhaumann, cullmann, vkrause
Cc: kwrite-devel, kde-frameworks-devel, univerz, LeGast00n, gennad, bmortimer, 
domson, michaelh, genethomas, ngraham, bruns, demsking, cullmann, vkrause, 
sars, dhaumann

Reply via email to