comparison runtime/doc/tagsrch.txt @ 16553:0e473e9e70c2 v8.1.1280

patch 8.1.1280: remarks about functionality not in Vi clutters the help commit https://github.com/vim/vim/commit/25c9c680ec4dfbb51f4ef21c3460a48d3c67ffc8 Author: Bram Moolenaar <Bram@vim.org> Date: Sun May 5 18:13:34 2019 +0200 patch 8.1.1280: remarks about functionality not in Vi clutters the help Problem: Remarks about functionality not in Vi clutters the help. Solution: Move all info about what is new in Vim or already existed in Vi to vi_diff.txt. Remove {not in Vi} remarks. (closes #4268) Add "noet" to the help files modeline. Also include many other help file improvements.
author Bram Moolenaar <Bram@vim.org>
date Sun, 05 May 2019 18:15:06 +0200
parents 54ffc82f38a8
children 1eaf34420bb3
comparison
equal deleted inserted replaced
16552:deb3d4f5be8b 16553:0e473e9e70c2
1 *tagsrch.txt* For Vim version 8.1. Last change: 2019 Apr 28 1 *tagsrch.txt* For Vim version 8.1. Last change: 2019 May 05
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
58 jumping to other matching tags. 58 jumping to other matching tags.
59 {Vi: identifier after the cursor} 59 {Vi: identifier after the cursor}
60 60
61 *v_CTRL-]* 61 *v_CTRL-]*
62 {Visual}CTRL-] Same as ":tag {name}", where {name} is the text that 62 {Visual}CTRL-] Same as ":tag {name}", where {name} is the text that
63 is highlighted. {not in Vi} 63 is highlighted.
64 64
65 *telnet-CTRL-]* 65 *telnet-CTRL-]*
66 CTRL-] is the default telnet escape key. When you type CTRL-] to jump to a 66 CTRL-] is the default telnet escape key. When you type CTRL-] to jump to a
67 tag, you will get the telnet prompt instead. Most versions of telnet allow 67 tag, you will get the telnet prompt instead. Most versions of telnet allow
68 changing or disabling the default escape key. See the telnet man page. You 68 changing or disabling the default escape key. See the telnet man page. You
110 Tags are only pushed onto the stack when the 'tagstack' option is set. 110 Tags are only pushed onto the stack when the 'tagstack' option is set.
111 111
112 g<RightMouse> *g<RightMouse>* 112 g<RightMouse> *g<RightMouse>*
113 <C-RightMouse> *<C-RightMouse>* *CTRL-T* 113 <C-RightMouse> *<C-RightMouse>* *CTRL-T*
114 CTRL-T Jump to [count] older entry in the tag stack 114 CTRL-T Jump to [count] older entry in the tag stack
115 (default 1). {not in Vi} 115 (default 1).
116 116
117 *:po* *:pop* *E555* *E556* 117 *:po* *:pop* *E555* *E556*
118 :[count]po[p][!] Jump to [count] older entry in tag stack (default 1). 118 :[count]po[p][!] Jump to [count] older entry in tag stack (default 1).
119 See |tag-!| for [!]. {not in Vi} 119 See |tag-!| for [!].
120 120
121 :[count]ta[g][!] Jump to [count] newer entry in tag stack (default 1). 121 :[count]ta[g][!] Jump to [count] newer entry in tag stack (default 1).
122 See |tag-!| for [!]. {not in Vi} 122 See |tag-!| for [!].
123 123
124 *:tags* 124 *:tags*
125 :tags Show the contents of the tag stack. The active 125 :tags Show the contents of the tag stack. The active
126 entry is marked with a '>'. {not in Vi} 126 entry is marked with a '>'.
127 127
128 The output of ":tags" looks like this: 128 The output of ":tags" looks like this:
129 129
130 # TO tag FROM line in file/text 130 # TO tag FROM line in file/text
131 1 1 main 1 harddisk2:text/vim/test 131 1 1 main 1 harddisk2:text/vim/test
202 See |tag-!| for [!]. 202 See |tag-!| for [!].
203 With a '>' in the first column is indicated which is 203 With a '>' in the first column is indicated which is
204 the current position in the list (if there is one). 204 the current position in the list (if there is one).
205 [name] can be a regexp pattern, see |tag-regexp|. 205 [name] can be a regexp pattern, see |tag-regexp|.
206 See |tag-priority| for the priorities used in the 206 See |tag-priority| for the priorities used in the
207 listing. {not in Vi} 207 listing.
208 Example output: 208 Example output:
209 209
210 > 210 >
211 nr pri kind tag file 211 nr pri kind tag file
212 1 F f mch_delay os_amiga.c 212 1 F f mch_delay os_amiga.c
229 If you already see the tag you want to use, you can 229 If you already see the tag you want to use, you can
230 type 'q' and enter the number. 230 type 'q' and enter the number.
231 231
232 *:sts* *:stselect* 232 *:sts* *:stselect*
233 :sts[elect][!] [name] Does ":tselect[!] [name]" and splits the window for 233 :sts[elect][!] [name] Does ":tselect[!] [name]" and splits the window for
234 the selected tag. {not in Vi} 234 the selected tag.
235 235
236 *g]* 236 *g]*
237 g] Like CTRL-], but use ":tselect" instead of ":tag". 237 g] Like CTRL-], but use ":tselect" instead of ":tag".
238 {not in Vi}
239 238
240 *v_g]* 239 *v_g]*
241 {Visual}g] Same as "g]", but use the highlighted text as the 240 {Visual}g] Same as "g]", but use the highlighted text as the
242 identifier. {not in Vi} 241 identifier.
243 242
244 *:tj* *:tjump* 243 *:tj* *:tjump*
245 :tj[ump][!] [name] Like ":tselect", but jump to the tag directly when 244 :tj[ump][!] [name] Like ":tselect", but jump to the tag directly when
246 there is only one match. {not in Vi} 245 there is only one match.
247 246
248 *:stj* *:stjump* 247 *:stj* *:stjump*
249 :stj[ump][!] [name] Does ":tjump[!] [name]" and splits the window for the 248 :stj[ump][!] [name] Does ":tjump[!] [name]" and splits the window for the
250 selected tag. {not in Vi} 249 selected tag.
251 250
252 *g_CTRL-]* 251 *g_CTRL-]*
253 g CTRL-] Like CTRL-], but use ":tjump" instead of ":tag". 252 g CTRL-] Like CTRL-], but use ":tjump" instead of ":tag".
254 {not in Vi}
255 253
256 *v_g_CTRL-]* 254 *v_g_CTRL-]*
257 {Visual}g CTRL-] Same as "g CTRL-]", but use the highlighted text as 255 {Visual}g CTRL-] Same as "g CTRL-]", but use the highlighted text as
258 the identifier. {not in Vi} 256 the identifier.
259 257
260 *:tn* *:tnext* 258 *:tn* *:tnext*
261 :[count]tn[ext][!] Jump to [count] next matching tag (default 1). See 259 :[count]tn[ext][!] Jump to [count] next matching tag (default 1). See
262 |tag-!| for [!]. {not in Vi} 260 |tag-!| for [!].
263 261
264 *:tp* *:tprevious* 262 *:tp* *:tprevious*
265 :[count]tp[revious][!] Jump to [count] previous matching tag (default 1). 263 :[count]tp[revious][!] Jump to [count] previous matching tag (default 1).
266 See |tag-!| for [!]. {not in Vi} 264 See |tag-!| for [!].
267 265
268 *:tN* *:tNext* 266 *:tN* *:tNext*
269 :[count]tN[ext][!] Same as ":tprevious". {not in Vi} 267 :[count]tN[ext][!] Same as ":tprevious".
270 268
271 *:tr* *:trewind* 269 *:tr* *:trewind*
272 :[count]tr[ewind][!] Jump to first matching tag. If [count] is given, jump 270 :[count]tr[ewind][!] Jump to first matching tag. If [count] is given, jump
273 to [count]th matching tag. See |tag-!| for [!]. {not 271 to [count]th matching tag. See |tag-!| for [!].
274 in Vi}
275 272
276 *:tf* *:tfirst* 273 *:tf* *:tfirst*
277 :[count]tf[irst][!] Same as ":trewind". {not in Vi} 274 :[count]tf[irst][!] Same as ":trewind".
278 275
279 *:tl* *:tlast* 276 *:tl* *:tlast*
280 :tl[ast][!] Jump to last matching tag. See |tag-!| for [!]. {not 277 :tl[ast][!] Jump to last matching tag. See |tag-!| for [!].
281 in Vi}
282 278
283 *:lt* *:ltag* 279 *:lt* *:ltag*
284 :lt[ag][!] [name] Jump to tag [name] and add the matching tags to a new 280 :lt[ag][!] [name] Jump to tag [name] and add the matching tags to a new
285 location list for the current window. [name] can be 281 location list for the current window. [name] can be
286 a regexp pattern, see |tag-regexp|. When [name] is 282 a regexp pattern, see |tag-regexp|. When [name] is
288 used. The search pattern to locate the tag line is 284 used. The search pattern to locate the tag line is
289 prefixed with "\V" to escape all the special 285 prefixed with "\V" to escape all the special
290 characters (very nomagic). The location list showing 286 characters (very nomagic). The location list showing
291 the matching tags is independent of the tag stack. 287 the matching tags is independent of the tag stack.
292 See |tag-!| for [!]. 288 See |tag-!| for [!].
293 {not in Vi}
294 289
295 When there is no other message, Vim shows which matching tag has been jumped 290 When there is no other message, Vim shows which matching tag has been jumped
296 to, and the number of matching tags: > 291 to, and the number of matching tags: >
297 tag 1 of 3 or more 292 tag 1 of 3 or more
298 The " or more" is used to indicate that Vim didn't try all the tags files yet. 293 The " or more" is used to indicate that Vim didn't try all the tags files yet.
315 {not available when compiled without the |+quickfix| feature} 310 {not available when compiled without the |+quickfix| feature}
316 311
317 *:pts* *:ptselect* 312 *:pts* *:ptselect*
318 :pts[elect][!] [name] Does ":tselect[!] [name]" and shows the new tag in a 313 :pts[elect][!] [name] Does ":tselect[!] [name]" and shows the new tag in a
319 "Preview" window. See |:ptag| for more info. 314 "Preview" window. See |:ptag| for more info.
320 {not in Vi}
321 315
322 *:ptj* *:ptjump* 316 *:ptj* *:ptjump*
323 :ptj[ump][!] [name] Does ":tjump[!] [name]" and shows the new tag in a 317 :ptj[ump][!] [name] Does ":tjump[!] [name]" and shows the new tag in a
324 "Preview" window. See |:ptag| for more info. 318 "Preview" window. See |:ptag| for more info.
325 {not in Vi}
326 319
327 *:ptn* *:ptnext* 320 *:ptn* *:ptnext*
328 :[count]ptn[ext][!] ":tnext" in the preview window. See |:ptag|. 321 :[count]ptn[ext][!] ":tnext" in the preview window. See |:ptag|.
329 {not in Vi}
330 322
331 *:ptp* *:ptprevious* 323 *:ptp* *:ptprevious*
332 :[count]ptp[revious][!] ":tprevious" in the preview window. See |:ptag|. 324 :[count]ptp[revious][!] ":tprevious" in the preview window. See |:ptag|.
333 {not in Vi}
334 325
335 *:ptN* *:ptNext* 326 *:ptN* *:ptNext*
336 :[count]ptN[ext][!] Same as ":ptprevious". {not in Vi} 327 :[count]ptN[ext][!] Same as ":ptprevious".
337 328
338 *:ptr* *:ptrewind* 329 *:ptr* *:ptrewind*
339 :[count]ptr[ewind][!] ":trewind" in the preview window. See |:ptag|. 330 :[count]ptr[ewind][!] ":trewind" in the preview window. See |:ptag|.
340 {not in Vi}
341 331
342 *:ptf* *:ptfirst* 332 *:ptf* *:ptfirst*
343 :[count]ptf[irst][!] Same as ":ptrewind". {not in Vi} 333 :[count]ptf[irst][!] Same as ":ptrewind".
344 334
345 *:ptl* *:ptlast* 335 *:ptl* *:ptlast*
346 :ptl[ast][!] ":tlast" in the preview window. See |:ptag|. 336 :ptl[ast][!] ":tlast" in the preview window. See |:ptag|.
347 {not in Vi}
348 337
349 ============================================================================== 338 ==============================================================================
350 4. Tags details *tag-details* 339 4. Tags details *tag-details*
351 340
352 *static-tag* 341 *static-tag*
628 *E434* *E435* 617 *E434* *E435*
629 If the command is a normal search command (it starts and ends with "/" or 618 If the command is a normal search command (it starts and ends with "/" or
630 "?"), some special handling is done: 619 "?"), some special handling is done:
631 - Searching starts on line 1 of the file. 620 - Searching starts on line 1 of the file.
632 The direction of the search is forward for "/", backward for "?". 621 The direction of the search is forward for "/", backward for "?".
633 Note that 'wrapscan' does not matter, the whole file is always searched. (Vi 622 Note that 'wrapscan' does not matter, the whole file is always searched.
634 does use 'wrapscan', which caused tags sometimes not be found.) {Vi starts
635 searching in line 2 of another file. It does not find a tag in line 1 of
636 another file when 'wrapscan' is not set}
637 - If the search fails, another try is done ignoring case. If that fails too, 623 - If the search fails, another try is done ignoring case. If that fails too,
638 a search is done for: 624 a search is done for:
639 "^tagname[ \t]*(" 625 "^tagname[ \t]*("
640 (the tag with '^' prepended and "[ \t]*(" appended). When using function 626 (the tag with '^' prepended and "[ \t]*(" appended). When using function
641 names, this will find the function name when it is in column 0. This will 627 names, this will find the function name when it is in column 0. This will
642 help when the arguments to the function have changed since the tags file was 628 help when the arguments to the function have changed since the tags file was
643 made. If this search also fails another search is done with: 629 made. If this search also fails another search is done with:
644 "^[#a-zA-Z_].*\<tagname[ \t]*(" 630 "^[#a-zA-Z_].*\<tagname[ \t]*("
645 This means: A line starting with '#' or an identifier and containing the tag 631 This means: A line starting with '#' or an identifier and containing the tag
646 followed by white space and a '('. This will find macro names and function 632 followed by white space and a '('. This will find macro names and function
647 names with a type prepended. {the extra searches are not in Vi} 633 names with a type prepended.
648 634
649 635
650 *tag-old-static* 636 *tag-old-static*
651 Until March 2019 (patch 8.1.1092) an outdated format was supported: 637 Until March 2019 (patch 8.1.1092) an outdated format was supported:
652 {tagfile}:{tagname} {TAB} {tagfile} {TAB} {tagaddress} 638 {tagfile}:{tagname} {TAB} {tagfile} {TAB} {tagaddress}
718 [i Display the first line that contains the keyword 704 [i Display the first line that contains the keyword
719 under the cursor. The search starts at the beginning 705 under the cursor. The search starts at the beginning
720 of the file. Lines that look like a comment are 706 of the file. Lines that look like a comment are
721 ignored (see 'comments' option). If a count is given, 707 ignored (see 'comments' option). If a count is given,
722 the count'th matching line is displayed, and comment 708 the count'th matching line is displayed, and comment
723 lines are not ignored. {not in Vi} 709 lines are not ignored.
724 710
725 *]i* 711 *]i*
726 ]i like "[i", but start at the current cursor position. 712 ]i like "[i", but start at the current cursor position.
727 {not in Vi}
728 713
729 *:is* *:isearch* 714 *:is* *:isearch*
730 :[range]is[earch][!] [count] [/]pattern[/] 715 :[range]is[earch][!] [count] [/]pattern[/]
731 Like "[i" and "]i", but search in [range] lines 716 Like "[i" and "]i", but search in [range] lines
732 (default: whole file). 717 (default: whole file).
733 See |:search-args| for [/] and [!]. {not in Vi} 718 See |:search-args| for [/] and [!].
734 719
735 *[I* 720 *[I*
736 [I Display all lines that contain the keyword under the 721 [I Display all lines that contain the keyword under the
737 cursor. Filenames and line numbers are displayed 722 cursor. Filenames and line numbers are displayed
738 for the found lines. The search starts at the 723 for the found lines. The search starts at the
739 beginning of the file. {not in Vi} 724 beginning of the file.
740 725
741 *]I* 726 *]I*
742 ]I like "[I", but start at the current cursor position. 727 ]I like "[I", but start at the current cursor position.
743 {not in Vi}
744 728
745 *:il* *:ilist* 729 *:il* *:ilist*
746 :[range]il[ist][!] [/]pattern[/] 730 :[range]il[ist][!] [/]pattern[/]
747 Like "[I" and "]I", but search in [range] lines 731 Like "[I" and "]I", but search in [range] lines
748 (default: whole file). 732 (default: whole file).
749 See |:search-args| for [/] and [!]. {not in Vi} 733 See |:search-args| for [/] and [!].
750 734
751 *[_CTRL-I* 735 *[_CTRL-I*
752 [ CTRL-I Jump to the first line that contains the keyword 736 [ CTRL-I Jump to the first line that contains the keyword
753 under the cursor. The search starts at the beginning 737 under the cursor. The search starts at the beginning
754 of the file. Lines that look like a comment are 738 of the file. Lines that look like a comment are
755 ignored (see 'comments' option). If a count is given, 739 ignored (see 'comments' option). If a count is given,
756 the count'th matching line is jumped to, and comment 740 the count'th matching line is jumped to, and comment
757 lines are not ignored. {not in Vi} 741 lines are not ignored.
758 742
759 *]_CTRL-I* 743 *]_CTRL-I*
760 ] CTRL-I like "[ CTRL-I", but start at the current cursor 744 ] CTRL-I like "[ CTRL-I", but start at the current cursor
761 position. {not in Vi} 745 position.
762 746
763 *:ij* *:ijump* 747 *:ij* *:ijump*
764 :[range]ij[ump][!] [count] [/]pattern[/] 748 :[range]ij[ump][!] [count] [/]pattern[/]
765 Like "[ CTRL-I" and "] CTRL-I", but search in 749 Like "[ CTRL-I" and "] CTRL-I", but search in
766 [range] lines (default: whole file). 750 [range] lines (default: whole file).
767 See |:search-args| for [/] and [!]. {not in Vi} 751 See |:search-args| for [/] and [!].
768 752
769 CTRL-W CTRL-I *CTRL-W_CTRL-I* *CTRL-W_i* 753 CTRL-W CTRL-I *CTRL-W_CTRL-I* *CTRL-W_i*
770 CTRL-W i Open a new window, with the cursor on the first line 754 CTRL-W i Open a new window, with the cursor on the first line
771 that contains the keyword under the cursor. The 755 that contains the keyword under the cursor. The
772 search starts at the beginning of the file. Lines 756 search starts at the beginning of the file. Lines
773 that look like a comment line are ignored (see 757 that look like a comment line are ignored (see
774 'comments' option). If a count is given, the count'th 758 'comments' option). If a count is given, the count'th
775 matching line is jumped to, and comment lines are not 759 matching line is jumped to, and comment lines are not
776 ignored. {not in Vi} 760 ignored.
777 761
778 *:isp* *:isplit* 762 *:isp* *:isplit*
779 :[range]isp[lit][!] [count] [/]pattern[/] 763 :[range]isp[lit][!] [count] [/]pattern[/]
780 Like "CTRL-W i" and "CTRL-W i", but search in 764 Like "CTRL-W i" and "CTRL-W i", but search in
781 [range] lines (default: whole file). 765 [range] lines (default: whole file).
782 See |:search-args| for [/] and [!]. {not in Vi} 766 See |:search-args| for [/] and [!].
783 767
784 *[d* 768 *[d*
785 [d Display the first macro definition that contains the 769 [d Display the first macro definition that contains the
786 macro under the cursor. The search starts from the 770 macro under the cursor. The search starts from the
787 beginning of the file. If a count is given, the 771 beginning of the file. If a count is given, the
788 count'th matching line is displayed. {not in Vi} 772 count'th matching line is displayed.
789 773
790 *]d* 774 *]d*
791 ]d like "[d", but start at the current cursor position. 775 ]d like "[d", but start at the current cursor position.
792 {not in Vi}
793 776
794 *:ds* *:dsearch* 777 *:ds* *:dsearch*
795 :[range]ds[earch][!] [count] [/]string[/] 778 :[range]ds[earch][!] [count] [/]string[/]
796 Like "[d" and "]d", but search in [range] lines 779 Like "[d" and "]d", but search in [range] lines
797 (default: whole file). 780 (default: whole file).
798 See |:search-args| for [/] and [!]. {not in Vi} 781 See |:search-args| for [/] and [!].
799 782
800 *[D* 783 *[D*
801 [D Display all macro definitions that contain the macro 784 [D Display all macro definitions that contain the macro
802 under the cursor. Filenames and line numbers are 785 under the cursor. Filenames and line numbers are
803 displayed for the found lines. The search starts 786 displayed for the found lines. The search starts
804 from the beginning of the file. {not in Vi} 787 from the beginning of the file.
805 788
806 *]D* 789 *]D*
807 ]D like "[D", but start at the current cursor position. 790 ]D like "[D", but start at the current cursor position.
808 {not in Vi}
809 791
810 *:dli* *:dlist* 792 *:dli* *:dlist*
811 :[range]dli[st][!] [/]string[/] 793 :[range]dli[st][!] [/]string[/]
812 Like `[D` and `]D`, but search in [range] lines 794 Like `[D` and `]D`, but search in [range] lines
813 (default: whole file). 795 (default: whole file).
814 See |:search-args| for [/] and [!]. {not in Vi} 796 See |:search-args| for [/] and [!].
815 Note that `:dl` works like `:delete` with the "l" 797 Note that `:dl` works like `:delete` with the "l"
816 flag, not `:dlist`. 798 flag, not `:dlist`.
817 799
818 *[_CTRL-D* 800 *[_CTRL-D*
819 [ CTRL-D Jump to the first macro definition that contains the 801 [ CTRL-D Jump to the first macro definition that contains the
820 keyword under the cursor. The search starts from 802 keyword under the cursor. The search starts from
821 the beginning of the file. If a count is given, the 803 the beginning of the file. If a count is given, the
822 count'th matching line is jumped to. {not in Vi} 804 count'th matching line is jumped to.
823 805
824 *]_CTRL-D* 806 *]_CTRL-D*
825 ] CTRL-D like "[ CTRL-D", but start at the current cursor 807 ] CTRL-D like "[ CTRL-D", but start at the current cursor
826 position. {not in Vi} 808 position.
827 809
828 *:dj* *:djump* 810 *:dj* *:djump*
829 :[range]dj[ump][!] [count] [/]string[/] 811 :[range]dj[ump][!] [count] [/]string[/]
830 Like "[ CTRL-D" and "] CTRL-D", but search in 812 Like "[ CTRL-D" and "] CTRL-D", but search in
831 [range] lines (default: whole file). 813 [range] lines (default: whole file).
832 See |:search-args| for [/] and [!]. {not in Vi} 814 See |:search-args| for [/] and [!].
833 815
834 CTRL-W CTRL-D *CTRL-W_CTRL-D* *CTRL-W_d* 816 CTRL-W CTRL-D *CTRL-W_CTRL-D* *CTRL-W_d*
835 CTRL-W d Open a new window, with the cursor on the first 817 CTRL-W d Open a new window, with the cursor on the first
836 macro definition line that contains the keyword 818 macro definition line that contains the keyword
837 under the cursor. The search starts from the 819 under the cursor. The search starts from the
838 beginning of the file. If a count is given, the 820 beginning of the file. If a count is given, the
839 count'th matching line is jumped to. {not in Vi} 821 count'th matching line is jumped to.
840 822
841 *:dsp* *:dsplit* 823 *:dsp* *:dsplit*
842 :[range]dsp[lit][!] [count] [/]string[/] 824 :[range]dsp[lit][!] [count] [/]string[/]
843 Like "CTRL-W d", but search in [range] lines 825 Like "CTRL-W d", but search in [range] lines
844 (default: whole file). 826 (default: whole file).
845 See |:search-args| for [/] and [!]. {not in Vi} 827 See |:search-args| for [/] and [!].
846 828
847 *:che* *:checkpath* 829 *:che* *:checkpath*
848 :che[ckpath] List all the included files that could not be found. 830 :che[ckpath] List all the included files that could not be found.
849 {not in Vi} 831
850 832 :che[ckpath]! List all the included files.
851 :che[ckpath]! List all the included files. {not in Vi}
852 833
853 *:search-args* 834 *:search-args*
854 Common arguments for the commands above: 835 Common arguments for the commands above:
855 [!] When included, find matches in lines that are recognized as comments. 836 [!] When included, find matches in lines that are recognized as comments.
856 When excluded, a match is ignored when the line is recognized as a 837 When excluded, a match is ignored when the line is recognized as a