|
1 | | -*tagsrch.txt* For Vim version 8.1. Last change: 2019 Mar 23 |
| 1 | +*tagsrch.txt* For Vim version 8.1. Last change: 2019 Mar 30 |
2 | 2 |
|
3 | 3 |
|
4 | 4 | VIM REFERENCE MANUAL by Bram Moolenaar |
@@ -529,28 +529,21 @@ gnatxref For Ada. See http://www.gnuada.org/. gnatxref is |
529 | 529 | part of the gnat package. |
530 | 530 |
|
531 | 531 |
|
532 | | -The lines in the tags file must have one of these three formats: |
| 532 | +The lines in the tags file must have one of these two formats: |
533 | 533 |
|
534 | 534 | 1. {tagname} {TAB} {tagfile} {TAB} {tagaddress} |
535 | | -2. {tagfile}:{tagname} {TAB} {tagfile} {TAB} {tagaddress} |
536 | | -3. {tagname} {TAB} {tagfile} {TAB} {tagaddress} {term} {field} .. |
| 535 | +2. {tagname} {TAB} {tagfile} {TAB} {tagaddress} {term} {field} .. |
537 | 536 |
|
538 | | -The first is a normal tag, which is completely compatible with Vi. It is the |
539 | | -only format produced by traditional ctags implementations. This is often used |
540 | | -for functions that are global, also referenced in other files. |
| 537 | +Previously an old format was supported, see |tag-old-static|. |
| 538 | + |
| 539 | +The first format is a normal tag, which is completely compatible with Vi. It |
| 540 | +is the only format produced by traditional ctags implementations. This is |
| 541 | +often used for functions that are global, also referenced in other files. |
541 | 542 |
|
542 | 543 | The lines in the tags file can end in <LF> or <CR><LF>. On the Macintosh <CR> |
543 | 544 | also works. The <CR> and <NL> characters can never appear inside a line. |
544 | 545 |
|
545 | | - *tag-old-static* |
546 | | -The second format is for a static tag only. It is obsolete now, replaced by |
547 | | -the third format. It is only supported by Elvis 1.x and Vim and a few |
548 | | -versions of ctags. A static tag is often used for functions that are local, |
549 | | -only referenced in the file {tagfile}. Note that for the static tag, the two |
550 | | -occurrences of {tagfile} must be exactly the same. Also see |tags-option| |
551 | | -below, for how static tags are used. |
552 | | - |
553 | | -The third format is new. It includes additional information in optional |
| 546 | +The second format is new. It includes additional information in optional |
554 | 547 | fields at the end of each line. It is backwards compatible with Vi. It is |
555 | 548 | only supported by new versions of ctags (such as Exuberant ctags). |
556 | 549 |
|
@@ -598,6 +591,7 @@ only supported by new versions of ctags (such as Exuberant ctags). |
598 | 591 | The only other field currently recognized by Vim is "file:" |
599 | 592 | (with an empty value). It is used for a static tag. |
600 | 593 |
|
| 594 | + |
601 | 595 | The first lines in the tags file can contain lines that start with |
602 | 596 | !_TAG_ |
603 | 597 | These are sorted to the first lines, only rare tags that start with "!" can |
@@ -651,6 +645,21 @@ If the command is a normal search command (it starts and ends with "/" or |
651 | 645 | followed by white space and a '('. This will find macro names and function |
652 | 646 | names with a type prepended. {the extra searches are not in Vi} |
653 | 647 |
|
| 648 | + |
| 649 | + *tag-old-static* |
| 650 | +Until March 2019 (patch 8.1.1092) an outdated format was supported: |
| 651 | + {tagfile}:{tagname} {TAB} {tagfile} {TAB} {tagaddress} |
| 652 | + |
| 653 | +This format is for a static tag only. It is obsolete now, replaced by |
| 654 | +the second format. It is only supported by Elvis 1.x, older Vim versions and |
| 655 | +a few versions of ctags. A static tag is often used for functions that are |
| 656 | +local, only referenced in the file {tagfile}. Note that for the static tag, |
| 657 | +the two occurrences of {tagfile} must be exactly the same. Also see |
| 658 | +|tags-option| below, for how static tags are used. |
| 659 | + |
| 660 | +The support was removed, since when you can update to the new Vim version you |
| 661 | +should also be able to update ctags to one that supports the second format. |
| 662 | + |
654 | 663 | ============================================================================== |
655 | 664 | 6. Include file searches *include-search* *definition-search* |
656 | 665 | *E387* *E388* *E389* |
|
0 commit comments