Bug 318592 - Missing syntax highlighting documentation for #pop!contextname
Summary: Missing syntax highlighting documentation for #pop!contextname
Status: RESOLVED FIXED
Alias: None
Product: kate
Classification: Applications
Component: general (show other bugs)
Version: 3.10.0
Platform: openSUSE Linux
: NOR normal
Target Milestone: ---
Assignee: KWrite Developers
URL: http://docs.kde.org/stable/en/applica...
Keywords:
Depends on:
Blocks:
 
Reported: 2013-04-19 15:02 UTC by Russell
Modified: 2013-08-17 08:13 UTC (History)
1 user (show)

See Also:
Latest Commit:
Version Fixed In:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Russell 2013-04-19 15:02:31 UTC
The feature described in bug #120544 is not documented in the KDE Kate manual Revision 3.10.1 KDE 4.10.1 (2013-02-10).

Links:
  kate: syntax highlighting needs more flexible context rules
  http://bugs.kde.org/show_bug.cgi?id=120544
  http://docs.kde.org/stable/en/applications/kate/kate-highlight-rules-detailled.html

The current text:
  To go back more steps, the #pop keyword can be repeated: #pop#pop#pop

Suggestion for the new text:
  To go back more steps, the #pop keyword can be repeated: #pop#pop#pop
  To go back two contexts and push "contextname" onto the stack: #pop#pop!contextname

It is a very useful feature.


Reproducible: Always
Comment 1 steveL 2013-04-26 00:33:21 UTC
I have to agree: this would have saved me a lot of work in the last couple of years. I can't believe it was implemented in September 2006.

Thanks for bringing it to attention.
Comment 2 Dominik Haumann 2013-08-09 12:29:20 UTC
Git commit 0b3ec5422da9456fb699c0a93adf22da7201ecd3 by Dominik Haumann.
Committed on 09/08/2013 at 12:29.
Pushed by dhaumann into branch 'master'.

mention #pop!Context again

It's in the docs already since commit
http://commits.kde.org/kate/c588e9f1f75d19a2916dff4b0c2b080242a716b9

Mentioning it explicitly again won't harm, though.

M  +1    -1    doc/kate/highlighting.docbook

http://commits.kde.org/kate/0b3ec5422da9456fb699c0a93adf22da7201ecd3
Comment 3 Dominik Haumann 2013-08-09 12:41:10 UTC
From the code, it may even be possible to write things like #pop#pop!SomeContext##C++. Not tested, though ;)
Comment 4 Burkhard Lück 2013-08-17 08:13:15 UTC
Git commit 2efd91dbe4feef7d2d9359d91479e18b5449af4d by Burkhard Lück, on behalf of Dominik Haumann.
Committed on 09/08/2013 at 12:29.
Pushed by lueck into branch 'KDE/4.11'.

mention #pop!Context again

It's in the docs already since commit
http://commits.kde.org/kate/c588e9f1f75d19a2916dff4b0c2b080242a716b9

Mentioning it explicitly again won't harm, though.
(cherry picked from commit 0b3ec5422da9456fb699c0a93adf22da7201ecd3)
backport to 4.11.1

M  +1    -1    doc/kate/highlighting.docbook

http://commits.kde.org/kate/2efd91dbe4feef7d2d9359d91479e18b5449af4d