feedc0de/qt-creator
1
0
Fork 0
forked from qt-creator/qt-creator
Code Pull Requests Activity

Doc: Update info about generic highlighting

Browse Source 
- You can select from several applicable definition files and
  save your selection
- Update Definitions was renamed as Download Definitions
- Reload Definitions and Reset Remembered Definitions we added
- Fixed a broken link to Kate docs

Task-number: QTCREATORBUG-25642
Change-Id: I7b3b62f4e4e7935e2e008f974036aaa5177229bf
Reviewed-by: David Schulz <david.schulz@qt.io>
This commit is contained in:
Leena Miettinen
2021-06-30 17:08:10 +02:00
parent 9287b1a3be
commit 51e5616a28
2 changed files with 16 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
doc/qtcreator/images/qtcreator-syntax-highlighter.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 28 KiB

After

Width:  |  Height:  |  Size: 8.5 KiB

24
doc/qtcreator/src/editors/creator-semantic-highlighting.qdoc
View File

@@ -1,6 +1,6 @@
/**************************************************************************** /****************************************************************************
** **
** Copyright (C) 2018 The Qt Company Ltd. ** Copyright (C) 2021 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/ ** Contact: https://www.qt.io/licensing/
** **
** This file is part of the Qt Creator documentation. ** This file is part of the Qt Creator documentation.
@@ -56,16 +56,25 @@
syntax definitions. \QC comes with most of the commonly used syntax files, syntax definitions. \QC comes with most of the commonly used syntax files,
and you can download additional files. For more information about the and you can download additional files. For more information about the
definition files, see definition files, see
\l{https://docs.kde.org/stable5/en/applications/katepart/highlight.html} \l{https://docs.kde.org/trunk5/en/kate/katepart/highlight.html}
{Working with Syntax Highlighting}. {Working with Syntax Highlighting}.
Font attributes that a syntax definition file explicitly specifies, such as Font attributes that a syntax definition file explicitly specifies, such as
bold, italic, underline, or strike through, are applied. Colors are applied bold, italic, underline, or strike through, are applied. Colors are applied
if they are readable with \QC themes. if they are readable with \QC themes.
If more than one highlight definition is available for the file that you
open for editing, the editor asks you to select the one to use. To save
the selection, select \uicontrol {Remember My Choice}. To reset the
remembered definitions, select \uicontrol Tools > \uicontrol Options >
\uicontrol {Text Editor} > \uicontrol {Generic Highlighter} >
\uicontrol {Reset Remembered Definitions}.
If the editor cannot find the highlight definition for a file that you open If the editor cannot find the highlight definition for a file that you open
for editing, it prompts you to update the highlight definition files. Select for editing, it prompts you to download additional highlight definition
\uicontrol {Update Definitions} to update the files. files. Select \uicontrol {Download Definitions} to download the files.
Information about the downloaded files is displayed in the
\uicontrol {General Messages} \l{Viewing Output}{output pane}.
To suppress the message for a particular file pattern, select To suppress the message for a particular file pattern, select
\uicontrol Tools > \uicontrol Options > \uicontrol {Text Editor} \uicontrol Tools > \uicontrol Options > \uicontrol {Text Editor}
@@ -76,10 +85,9 @@
If you have written your own syntax definition files, you If you have written your own syntax definition files, you
can provide an additional definition search path in the can provide an additional definition search path in the
\uicontrol {User Highlight Definition Files} field. \uicontrol {User Highlight Definition Files} field. To
apply the changes you make to the definition files, select
To manually update the highlight definition files, select \uicontrol {Reload Definitions}.
\uicontrol {Update Definitions}.
\section1 Highlighting and Folding Blocks \section1 Highlighting and Folding Blocks