Highlight documentation: add include keywords

Summary: The documentation of the syntax highlighting is updated, adding a brief description and example of include-keywords.

Reviewers: Kate, dhaumann, cullmann

Reviewed By: Kate, cullmann

Subscribers: kwrite-devel, kde-doc-english

Tags: Kate, Documentation

Differential Revision: https://phabricator.kde.org/D23050