1 /* vi:set ts=8 sts=4 sw=4:
3 * VIM - Vi IMproved by Bram Moolenaar
5 * Do ":help uganda" in Vim to read copying and usage conditions.
6 * Do ":help credits" in Vim to see a list of people who contributed.
7 * See README.txt for an overview of the Vim source code.
11 * Code to handle tags and the tag stack
14 #if defined(MSDOS) || defined(WIN16) || defined(WIN32) || defined(_WIN64)
15 # include "vimio.h" /* for lseek(), must be before vim.h */
21 * Structure to hold pointers to various items in a tag line.
23 typedef struct tag_pointers
25 /* filled in by parse_tag_line(): */
26 char_u
*tagname
; /* start of tag name (skip "file:") */
27 char_u
*tagname_end
; /* char after tag name */
28 char_u
*fname
; /* first char of file name */
29 char_u
*fname_end
; /* char after file name */
30 char_u
*command
; /* first char of command */
31 /* filled in by parse_match(): */
32 char_u
*command_end
; /* first char after command */
33 char_u
*tag_fname
; /* file name of the tags file */
34 #ifdef FEAT_EMACS_TAGS
35 int is_etag
; /* TRUE for emacs tag */
37 char_u
*tagkind
; /* "kind:" value */
38 char_u
*tagkind_end
; /* end of tagkind */
42 * The matching tags are first stored in ga_match[]. In which one depends on
43 * the priority of the match.
44 * At the end, the matches from ga_match[] are concatenated, to make a list
47 #define MT_ST_CUR 0 /* static match in current file */
48 #define MT_GL_CUR 1 /* global match in current file */
49 #define MT_GL_OTH 2 /* global match in other file */
50 #define MT_ST_OTH 3 /* static match in other file */
51 #define MT_IC_ST_CUR 4 /* icase static match in current file */
52 #define MT_IC_GL_CUR 5 /* icase global match in current file */
53 #define MT_IC_GL_OTH 6 /* icase global match in other file */
54 #define MT_IC_ST_OTH 7 /* icase static match in other file */
55 #define MT_IC_OFF 4 /* add for icase match */
56 #define MT_RE_OFF 8 /* add for regexp match */
57 #define MT_MASK 7 /* mask for printing priority */
60 static char *mt_names
[MT_COUNT
/2] =
61 {"FSC", "F C", "F ", "FS ", " SC", " C", " ", " S "};
63 #define NOTAGFILE 99 /* return value for jumpto_tag */
64 static char_u
*nofile_fname
= NULL
; /* fname for NOTAGFILE error */
66 static void taglen_advance
__ARGS((int l
));
68 static int jumpto_tag
__ARGS((char_u
*lbuf
, int forceit
, int keep_help
));
69 #ifdef FEAT_EMACS_TAGS
70 static int parse_tag_line
__ARGS((char_u
*lbuf
, int is_etag
, tagptrs_T
*tagp
));
72 static int parse_tag_line
__ARGS((char_u
*lbuf
, tagptrs_T
*tagp
));
74 static int test_for_static
__ARGS((tagptrs_T
*));
75 static int parse_match
__ARGS((char_u
*lbuf
, tagptrs_T
*tagp
));
76 static char_u
*tag_full_fname
__ARGS((tagptrs_T
*tagp
));
77 static char_u
*expand_tag_fname
__ARGS((char_u
*fname
, char_u
*tag_fname
, int expand
));
78 #ifdef FEAT_EMACS_TAGS
79 static int test_for_current
__ARGS((int, char_u
*, char_u
*, char_u
*, char_u
*));
81 static int test_for_current
__ARGS((char_u
*, char_u
*, char_u
*, char_u
*));
83 static int find_extra
__ARGS((char_u
**pp
));
85 static char_u
*bottommsg
= (char_u
*)N_("E555: at bottom of tag stack");
86 static char_u
*topmsg
= (char_u
*)N_("E556: at top of tag stack");
88 static char_u
*tagmatchname
= NULL
; /* name of last used tag */
91 * We use ftello() here, if available. It returns off_t instead of long,
92 * which helps if long is 32 bit and off_t is 64 bit.
93 * We assume that when fseeko() is available then ftello() is too.
99 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
101 * Tag for preview window is remembered separately, to avoid messing up the
104 static taggy_T ptag_entry
= {NULL
, {INIT_POS_T(0, 0, 0), 0}, 0, 0};
108 * Jump to tag; handling of tag commands and tag stack
110 * *tag != NUL: ":tag {tag}", jump to new tag, add to tag stack
112 * type == DT_TAG: ":tag [tag]", jump to newer position or same tag again
113 * type == DT_HELP: like DT_TAG, but don't use regexp.
114 * type == DT_POP: ":pop" or CTRL-T, jump to old position
115 * type == DT_NEXT: jump to next match of same tag
116 * type == DT_PREV: jump to previous match of same tag
117 * type == DT_FIRST: jump to first match of same tag
118 * type == DT_LAST: jump to last match of same tag
119 * type == DT_SELECT: ":tselect [tag]", select tag from a list of all matches
120 * type == DT_JUMP: ":tjump [tag]", jump to tag or select tag from a list
121 * type == DT_CSCOPE: use cscope to find the tag
122 * type == DT_LTAG: use location list for displaying tag matches
123 * type == DT_FREE: free cached matches
125 * for cscope, returns TRUE if we jumped to tag or aborted, FALSE otherwise
128 do_tag(tag
, type
, count
, forceit
, verbose
)
129 char_u
*tag
; /* tag (pattern) to jump to */
132 int forceit
; /* :ta with ! */
133 int verbose
; /* print "tag not found" message */
135 taggy_T
*tagstack
= curwin
->w_tagstack
;
136 int tagstackidx
= curwin
->w_tagstackidx
;
137 int tagstacklen
= curwin
->w_tagstacklen
;
139 int cur_fnum
= curbuf
->b_fnum
;
140 int oldtagstackidx
= tagstackidx
;
141 int prevtagstackidx
= tagstackidx
;
142 int prev_num_matches
;
150 int no_regexp
= FALSE
;
151 int error_cur_match
= 0;
153 int save_pos
= FALSE
;
157 int jumped_to_tag
= FALSE
;
159 tagptrs_T tagp
, tagp2
;
161 char_u
**new_matches
;
164 int skip_msg
= FALSE
;
165 char_u
*buf_ffname
= curbuf
->b_ffname
; /* name to use for
166 priority computation */
168 /* remember the matches for the last used tag */
169 static int num_matches
= 0;
170 static int max_num_matches
= 0; /* limit used for match search */
171 static char_u
**matches
= NULL
;
177 /* remove the list of matches */
178 FreeWild(num_matches
, matches
);
193 prev_num_matches
= num_matches
;
194 free_string_option(nofile_fname
);
197 clearpos(&saved_fmark
.mark
); /* shutup gcc 4.0 */
198 saved_fmark
.fnum
= 0;
201 * Don't add a tag to the tagstack if 'tagstack' has been reset.
203 if ((!p_tgst
&& *tag
!= NUL
))
205 use_tagstack
= FALSE
;
210 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
212 use_tagstack
= FALSE
;
217 /* new pattern, add to the tag stack */
219 && (type
== DT_TAG
|| type
== DT_SELECT
|| type
== DT_JUMP
228 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
231 if (ptag_entry
.tagname
!= NULL
232 && STRCMP(ptag_entry
.tagname
, tag
) == 0)
234 /* Jumping to same tag: keep the current match, so that
235 * the CursorHold autocommand example works. */
236 cur_match
= ptag_entry
.cur_match
;
237 cur_fnum
= ptag_entry
.cur_fnum
;
241 vim_free(ptag_entry
.tagname
);
242 if ((ptag_entry
.tagname
= vim_strsave(tag
)) == NULL
)
250 * If the last used entry is not at the top, delete all tag
251 * stack entries above it.
253 while (tagstackidx
< tagstacklen
)
254 vim_free(tagstack
[--tagstacklen
].tagname
);
256 /* if the tagstack is full: remove oldest entry */
257 if (++tagstacklen
> TAGSTACKSIZE
)
259 tagstacklen
= TAGSTACKSIZE
;
260 vim_free(tagstack
[0].tagname
);
261 for (i
= 1; i
< tagstacklen
; ++i
)
262 tagstack
[i
- 1] = tagstack
[i
];
267 * put the tag name in the tag stack
269 if ((tagstack
[tagstackidx
].tagname
= vim_strsave(tag
)) == NULL
)
271 curwin
->w_tagstacklen
= tagstacklen
- 1;
274 curwin
->w_tagstacklen
= tagstacklen
;
276 save_pos
= TRUE
; /* save the cursor position below */
284 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
285 g_do_tagpreview
? ptag_entry
.tagname
== NULL
:
294 if (type
== DT_POP
) /* go to older position */
297 int old_KeyTyped
= KeyTyped
;
299 if ((tagstackidx
-= count
) < 0)
302 if (tagstackidx
+ count
== 0)
304 /* We did [num]^T from the bottom of the stack */
308 /* We weren't at the bottom of the stack, so jump all the
309 * way to the bottom now.
313 else if (tagstackidx
>= tagstacklen
) /* count == 0? */
319 /* Make a copy of the fmark, autocommands may invalidate the
320 * tagstack before it's used. */
321 saved_fmark
= tagstack
[tagstackidx
].fmark
;
322 if (saved_fmark
.fnum
!= curbuf
->b_fnum
)
325 * Jump to other file. If this fails (e.g. because the
326 * file was changed) keep original position in tag stack.
328 if (buflist_getfile(saved_fmark
.fnum
, saved_fmark
.mark
.lnum
,
329 GETF_SETMARK
, forceit
) == FAIL
)
331 tagstackidx
= oldtagstackidx
; /* back to old posn */
334 /* An BufReadPost autocommand may jump to the '" mark, but
335 * we don't what that here. */
336 curwin
->w_cursor
.lnum
= saved_fmark
.mark
.lnum
;
341 curwin
->w_cursor
.lnum
= saved_fmark
.mark
.lnum
;
343 curwin
->w_cursor
.col
= saved_fmark
.mark
.col
;
344 curwin
->w_set_curswant
= TRUE
;
347 if ((fdo_flags
& FDO_TAG
) && old_KeyTyped
)
351 /* remove the old list of matches */
352 FreeWild(num_matches
, matches
);
362 #if defined(FEAT_QUICKFIX)
367 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
370 cur_match
= ptag_entry
.cur_match
;
371 cur_fnum
= ptag_entry
.cur_fnum
;
376 /* ":tag" (no argument): go to newer pattern */
377 save_pos
= TRUE
; /* save the cursor position below */
378 if ((tagstackidx
+= count
- 1) >= tagstacklen
)
381 * Beyond the last one, just give an error message and
382 * go to the last one. Don't store the cursor
385 tagstackidx
= tagstacklen
- 1;
389 else if (tagstackidx
< 0) /* must have been count == 0 */
395 cur_match
= tagstack
[tagstackidx
].cur_match
;
396 cur_fnum
= tagstack
[tagstackidx
].cur_fnum
;
400 else /* go to other matching tag */
402 /* Save index for when selection is cancelled. */
403 prevtagstackidx
= tagstackidx
;
405 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
408 cur_match
= ptag_entry
.cur_match
;
409 cur_fnum
= ptag_entry
.cur_fnum
;
414 if (--tagstackidx
< 0)
416 cur_match
= tagstack
[tagstackidx
].cur_match
;
417 cur_fnum
= tagstack
[tagstackidx
].cur_fnum
;
421 case DT_FIRST
: cur_match
= count
- 1; break;
427 case DT_LAST
: cur_match
= MAXCOL
- 1; break;
428 case DT_NEXT
: cur_match
+= count
; break;
429 case DT_PREV
: cur_match
-= count
; break;
431 if (cur_match
>= MAXCOL
)
432 cur_match
= MAXCOL
- 1;
433 else if (cur_match
< 0)
435 EMSG(_("E425: Cannot go before first matching tag"));
438 cur_fnum
= curbuf
->b_fnum
;
443 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
446 if (type
!= DT_SELECT
&& type
!= DT_JUMP
)
448 ptag_entry
.cur_match
= cur_match
;
449 ptag_entry
.cur_fnum
= cur_fnum
;
456 * For ":tag [arg]" or ":tselect" remember position before the jump.
458 saved_fmark
= tagstack
[tagstackidx
].fmark
;
461 tagstack
[tagstackidx
].fmark
.mark
= curwin
->w_cursor
;
462 tagstack
[tagstackidx
].fmark
.fnum
= curbuf
->b_fnum
;
465 /* Curwin will change in the call to jumpto_tag() if ":stag" was
466 * used or an autocommand jumps to another window; store value of
467 * tagstackidx now. */
468 curwin
->w_tagstackidx
= tagstackidx
;
469 if (type
!= DT_SELECT
&& type
!= DT_JUMP
)
471 curwin
->w_tagstack
[tagstackidx
].cur_match
= cur_match
;
472 curwin
->w_tagstack
[tagstackidx
].cur_fnum
= cur_fnum
;
477 /* When not using the current buffer get the name of buffer "cur_fnum".
478 * Makes sure that the tag order doesn't change when using a remembered
479 * position for "cur_match". */
480 if (cur_fnum
!= curbuf
->b_fnum
)
482 buf_T
*buf
= buflist_findnr(cur_fnum
);
485 buf_ffname
= buf
->b_ffname
;
489 * Repeat searching for tags, when a file has not been found.
494 * When desired match not found yet, try to find it (and others).
497 name
= tagstack
[tagstackidx
].tagname
;
498 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
499 else if (g_do_tagpreview
)
500 name
= ptag_entry
.tagname
;
504 other_name
= (tagmatchname
== NULL
|| STRCMP(tagmatchname
, name
) != 0);
506 || (cur_match
>= num_matches
&& max_num_matches
!= MAXCOL
)
511 vim_free(tagmatchname
);
512 tagmatchname
= vim_strsave(name
);
516 * If a count is supplied to the ":tag <name>" command, then
517 * jump to count'th matching tag.
519 if (type
== DT_TAG
&& *tag
!= NUL
&& count
> 0)
520 cur_match
= count
- 1;
522 if (type
== DT_SELECT
|| type
== DT_JUMP
523 #if defined(FEAT_QUICKFIX)
527 cur_match
= MAXCOL
- 1;
528 max_num_matches
= cur_match
+ 1;
530 /* when the argument starts with '/', use it as a regexp */
531 if (!no_regexp
&& *name
== '/')
540 if (type
== DT_CSCOPE
)
544 flags
|= TAG_VERBOSE
;
545 if (find_tags(name
, &new_num_matches
, &new_matches
, flags
,
546 max_num_matches
, buf_ffname
) == OK
547 && new_num_matches
< max_num_matches
)
548 max_num_matches
= MAXCOL
; /* If less than max_num_matches
549 found: all matches found. */
551 /* If there already were some matches for the same name, move them
552 * to the start. Avoids that the order changes when using
553 * ":tnext" and jumping to another file. */
554 if (!new_tag
&& !other_name
)
556 /* Find the position of each old match in the new list. Need
557 * to use parse_match() to find the tag line. */
559 for (j
= 0; j
< num_matches
; ++j
)
561 parse_match(matches
[j
], &tagp
);
562 for (i
= idx
; i
< new_num_matches
; ++i
)
564 parse_match(new_matches
[i
], &tagp2
);
565 if (STRCMP(tagp
.tagname
, tagp2
.tagname
) == 0)
568 for (k
= i
; k
> idx
; --k
)
569 new_matches
[k
] = new_matches
[k
- 1];
570 new_matches
[idx
++] = p
;
576 FreeWild(num_matches
, matches
);
577 num_matches
= new_num_matches
;
578 matches
= new_matches
;
581 if (num_matches
<= 0)
584 EMSG2(_("E426: tag not found: %s"), name
);
585 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
591 int ask_for_selection
= FALSE
;
594 if (type
== DT_CSCOPE
&& num_matches
> 1)
597 ask_for_selection
= TRUE
;
601 if (type
== DT_SELECT
|| (type
== DT_JUMP
&& num_matches
> 1))
604 * List all the matching tags.
605 * Assume that the first match indicates how long the tags can
606 * be, and align the file names to that.
608 parse_match(matches
[0], &tagp
);
609 taglen
= (int)(tagp
.tagname_end
- tagp
.tagname
+ 2);
612 if (taglen
> Columns
- 25)
615 msg_didout
= FALSE
; /* overwrite previous message */
617 MSG_PUTS_ATTR(_(" # pri kind tag"), hl_attr(HLF_T
));
619 taglen_advance(taglen
);
620 MSG_PUTS_ATTR(_("file\n"), hl_attr(HLF_T
));
622 for (i
= 0; i
< num_matches
&& !got_int
; ++i
)
624 parse_match(matches
[i
], &tagp
);
626 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
628 && i
== ptag_entry
.cur_match
) ||
631 && i
== tagstack
[tagstackidx
].cur_match
)))
635 vim_snprintf((char *)IObuff
+ 1, IOSIZE
- 1,
637 mt_names
[matches
[i
][0] & MT_MASK
]);
639 if (tagp
.tagkind
!= NULL
)
640 msg_outtrans_len(tagp
.tagkind
,
641 (int)(tagp
.tagkind_end
- tagp
.tagkind
));
643 msg_outtrans_len_attr(tagp
.tagname
,
644 (int)(tagp
.tagname_end
- tagp
.tagname
),
647 taglen_advance(taglen
);
649 /* Find out the actual file name. If it is long, truncate
650 * it and put "..." in the middle */
651 p
= tag_full_fname(&tagp
);
654 msg_puts_long_attr(p
, hl_attr(HLF_D
));
663 /* print any extra fields */
664 command_end
= tagp
.command_end
;
665 if (command_end
!= NULL
)
668 while (*p
&& *p
!= '\r' && *p
!= '\n')
673 /* skip "file:" without a value (static tag) */
674 if (STRNCMP(p
, "file:", 5) == 0
675 && vim_isspace(p
[5]))
680 /* skip "kind:<kind>" and "<kind>" */
681 if (p
== tagp
.tagkind
682 || (p
+ 5 == tagp
.tagkind
683 && STRNCMP(p
, "kind:", 5) == 0))
685 p
= tagp
.tagkind_end
;
688 /* print all other extra fields */
689 attr
= hl_attr(HLF_CM
);
690 while (*p
&& *p
!= '\r' && *p
!= '\n')
692 if (msg_col
+ ptr2cells(p
) >= Columns
)
699 p
= msg_outtrans_one(p
, attr
);
702 msg_puts_attr((char_u
*)" ", attr
);
719 for (p
= tagp
.command
;
720 *p
&& *p
!= '\r' && *p
!= '\n'; ++p
)
726 * Put the info (in several lines) at column 15.
727 * Don't display "/^" and "?^".
730 if (*p
== '/' || *p
== '?')
736 /* Remove leading whitespace from pattern */
737 while (p
!= command_end
&& vim_isspace(*p
))
740 while (p
!= command_end
)
742 if (msg_col
+ (*p
== TAB
? 1 : ptr2cells(p
)) > Columns
)
748 /* skip backslash used for escaping command char */
749 if (*p
== '\\' && *(p
+ 1) == *tagp
.command
)
758 p
= msg_outtrans_one(p
, 0);
760 /* don't display the "$/;\"" and "$?;\"" */
761 if (p
== command_end
- 2 && *p
== '$'
762 && *(p
+ 1) == *tagp
.command
)
764 /* don't display matching '/' or '?' */
765 if (p
== command_end
- 1 && *p
== *tagp
.command
766 && (*p
== '/' || *p
== '?'))
774 got_int
= FALSE
; /* only stop the listing */
775 ask_for_selection
= TRUE
;
777 #if defined(FEAT_QUICKFIX) && defined(FEAT_EVAL)
778 else if (type
== DT_LTAG
)
781 char_u tag_name
[128 + 1];
782 char_u fname
[MAXPATHL
+ 1];
783 char_u cmd
[CMDBUFFSIZE
+ 1];
786 * Add the matching tags to the location list for the current
794 for (i
= 0; i
< num_matches
; ++i
)
800 parse_match(matches
[i
], &tagp
);
802 /* Save the tag name */
803 len
= (int)(tagp
.tagname_end
- tagp
.tagname
);
806 vim_strncpy(tag_name
, tagp
.tagname
, len
);
809 /* Save the tag file name */
810 p
= tag_full_fname(&tagp
);
817 * Get the line number or the search pattern used to locate
821 if (isdigit(*tagp
.command
))
822 /* Line number is used to locate the tag */
823 lnum
= atol((char *)tagp
.command
);
826 char_u
*cmd_start
, *cmd_end
;
828 /* Search pattern is used to locate the tag */
830 /* Locate the end of the command */
831 cmd_start
= tagp
.command
;
832 cmd_end
= tagp
.command_end
;
835 for (p
= tagp
.command
;
836 *p
&& *p
!= '\r' && *p
!= '\n'; ++p
)
842 * Now, cmd_end points to the character after the
843 * command. Adjust it to point to the last
844 * character of the command.
849 * Skip the '/' and '?' characters at the
850 * beginning and end of the search pattern.
852 if (*cmd_start
== '/' || *cmd_start
== '?')
855 if (*cmd_end
== '/' || *cmd_end
== '?')
862 * If "^" is present in the tag search pattern, then
865 if (*cmd_start
== '^')
873 * Precede the tag pattern with \V to make it very
879 cmd_len
= (int)(cmd_end
- cmd_start
+ 1);
880 if (cmd_len
> (CMDBUFFSIZE
- 5))
881 cmd_len
= CMDBUFFSIZE
- 5;
882 STRNCAT(cmd
, cmd_start
, cmd_len
);
885 if (cmd
[len
- 1] == '$')
888 * Replace '$' at the end of the search pattern
899 if ((dict
= dict_alloc()) == NULL
)
901 if (list_append_dict(list
, dict
) == FAIL
)
907 dict_add_nr_str(dict
, "text", 0L, tag_name
);
908 dict_add_nr_str(dict
, "filename", 0L, fname
);
909 dict_add_nr_str(dict
, "lnum", lnum
, NULL
);
911 dict_add_nr_str(dict
, "pattern", 0L, cmd
);
914 set_errorlist(curwin
, list
, ' ');
916 list_free(list
, TRUE
);
918 cur_match
= 0; /* Jump to the first tag */
922 if (ask_for_selection
== TRUE
)
925 * Ask to select a tag from the list.
927 i
= prompt_for_number(NULL
);
928 if (i
<= 0 || i
> num_matches
|| got_int
)
930 /* no valid choice: don't change anything */
933 tagstack
[tagstackidx
].fmark
= saved_fmark
;
934 tagstackidx
= prevtagstackidx
;
938 jumped_to_tag
= TRUE
;
945 if (cur_match
>= num_matches
)
947 /* Avoid giving this error when a file wasn't found and we're
948 * looking for a match in another file, which wasn't found.
949 * There will be an EMSG("file doesn't exist") below then. */
950 if ((type
== DT_NEXT
|| type
== DT_FIRST
)
951 && nofile_fname
== NULL
)
953 if (num_matches
== 1)
954 EMSG(_("E427: There is only one matching tag"));
956 EMSG(_("E428: Cannot go beyond last matching tag"));
959 cur_match
= num_matches
- 1;
963 tagstack
[tagstackidx
].cur_match
= cur_match
;
964 tagstack
[tagstackidx
].cur_fnum
= cur_fnum
;
967 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
968 else if (g_do_tagpreview
)
970 ptag_entry
.cur_match
= cur_match
;
971 ptag_entry
.cur_fnum
= cur_fnum
;
976 * Only when going to try the next match, report that the previous
977 * file didn't exist. Otherwise an EMSG() is given below.
979 if (nofile_fname
!= NULL
&& error_cur_match
!= cur_match
)
980 smsg((char_u
*)_("File \"%s\" does not exist"), nofile_fname
);
983 ic
= (matches
[cur_match
][0] & MT_IC_OFF
);
984 if (type
!= DT_SELECT
&& type
!= DT_JUMP
988 && (num_matches
> 1 || ic
)
991 /* Give an indication of the number of matching tags */
992 sprintf((char *)IObuff
, _("tag %d of %d%s"),
995 max_num_matches
!= MAXCOL
? _(" or more") : "");
997 STRCAT(IObuff
, _(" Using tag with different case!"));
998 if ((num_matches
> prev_num_matches
|| new_tag
)
1002 msg_attr(IObuff
, hl_attr(HLF_W
));
1005 msg_scroll
= TRUE
; /* don't overwrite this message */
1008 give_warning(IObuff
, ic
);
1009 if (ic
&& !msg_scrolled
&& msg_silent
== 0)
1012 ui_delay(1000L, TRUE
);
1017 /* Let the SwapExists event know what tag we are jumping to. */
1018 vim_snprintf((char *)IObuff
, IOSIZE
, ":ta %s\r", name
);
1019 set_vim_var_string(VV_SWAPCOMMAND
, IObuff
, -1);
1023 * Jump to the desired match.
1025 i
= jumpto_tag(matches
[cur_match
], forceit
, type
!= DT_CSCOPE
);
1028 set_vim_var_string(VV_SWAPCOMMAND
, NULL
, -1);
1033 /* File not found: try again with another matching tag */
1034 if ((type
== DT_PREV
&& cur_match
> 0)
1035 || ((type
== DT_TAG
|| type
== DT_NEXT
1036 || type
== DT_FIRST
)
1037 && (max_num_matches
!= MAXCOL
1038 || cur_match
< num_matches
- 1)))
1040 error_cur_match
= cur_match
;
1043 if (type
== DT_PREV
)
1052 EMSG2(_("E429: File \"%s\" does not exist"), nofile_fname
);
1056 /* We may have jumped to another window, check that
1057 * tagstackidx is still valid. */
1058 if (use_tagstack
&& tagstackidx
> curwin
->w_tagstacklen
)
1059 tagstackidx
= curwin
->w_tagstackidx
;
1061 jumped_to_tag
= TRUE
;
1069 /* Only store the new index when using the tagstack and it's valid. */
1070 if (use_tagstack
&& tagstackidx
<= curwin
->w_tagstacklen
)
1071 curwin
->w_tagstackidx
= tagstackidx
;
1073 postponed_split
= 0; /* don't split next time */
1077 return jumped_to_tag
;
1089 vim_free(tagmatchname
);
1090 tagmatchname
= NULL
;
1103 msg_advance(13 + l
);
1107 * Print the tag stack
1111 exarg_T
*eap UNUSED
;
1115 taggy_T
*tagstack
= curwin
->w_tagstack
;
1116 int tagstackidx
= curwin
->w_tagstackidx
;
1117 int tagstacklen
= curwin
->w_tagstacklen
;
1119 /* Highlight title */
1120 MSG_PUTS_TITLE(_("\n # TO tag FROM line in file/text"));
1121 for (i
= 0; i
< tagstacklen
; ++i
)
1123 if (tagstack
[i
].tagname
!= NULL
)
1125 name
= fm_getname(&(tagstack
[i
].fmark
), 30);
1126 if (name
== NULL
) /* file name not available */
1130 sprintf((char *)IObuff
, "%c%2d %2d %-15s %5ld ",
1131 i
== tagstackidx
? '>' : ' ',
1133 tagstack
[i
].cur_match
+ 1,
1134 tagstack
[i
].tagname
,
1135 tagstack
[i
].fmark
.mark
.lnum
);
1136 msg_outtrans(IObuff
);
1137 msg_outtrans_attr(name
, tagstack
[i
].fmark
.fnum
== curbuf
->b_fnum
1138 ? hl_attr(HLF_D
) : 0);
1141 out_flush(); /* show one line at a time */
1143 if (tagstackidx
== tagstacklen
) /* idx at top of stack */
1147 /* When not using a CR for line separator, use vim_fgets() to read tag lines.
1148 * For the Mac use tag_fgets(). It can handle any line separator, but is much
1149 * slower than vim_fgets().
1152 # define tag_fgets vim_fgets
1155 #ifdef FEAT_TAG_BINS
1156 static int tag_strnicmp
__ARGS((char_u
*s1
, char_u
*s2
, size_t len
));
1159 * Compare two strings, for length "len", ignoring case the ASCII way.
1160 * return 0 for match, < 0 for smaller, > 0 for bigger
1161 * Make sure case is folded to uppercase in comparison (like for 'sort -f')
1164 tag_strnicmp(s1
, s2
, len
)
1173 i
= (int)TOUPPER_ASC(*s1
) - (int)TOUPPER_ASC(*s2
);
1175 return i
; /* this character different */
1177 break; /* strings match until NUL */
1182 return 0; /* strings match */
1187 * Structure to hold info about the tag pattern being used.
1191 char_u
*pat
; /* the pattern */
1192 int len
; /* length of pat[] */
1193 char_u
*head
; /* start of pattern head */
1194 int headlen
; /* length of head[] */
1195 regmatch_T regmatch
; /* regexp program, may be NULL */
1198 static void prepare_pats
__ARGS((pat_T
*pats
, int has_re
));
1201 * Extract info from the tag search pattern "pats->pat".
1204 prepare_pats(pats
, has_re
)
1208 pats
->head
= pats
->pat
;
1209 pats
->headlen
= pats
->len
;
1212 /* When the pattern starts with '^' or "\\<", binary searching can be
1213 * used (much faster). */
1214 if (pats
->pat
[0] == '^')
1215 pats
->head
= pats
->pat
+ 1;
1216 else if (pats
->pat
[0] == '\\' && pats
->pat
[1] == '<')
1217 pats
->head
= pats
->pat
+ 2;
1218 if (pats
->head
== pats
->pat
)
1221 for (pats
->headlen
= 0; pats
->head
[pats
->headlen
] != NUL
;
1223 if (vim_strchr((char_u
*)(p_magic
? ".[~*\\$" : "\\$"),
1224 pats
->head
[pats
->headlen
]) != NULL
)
1226 if (p_tl
!= 0 && pats
->headlen
> p_tl
) /* adjust for 'taglength' */
1227 pats
->headlen
= p_tl
;
1231 pats
->regmatch
.regprog
= vim_regcomp(pats
->pat
, p_magic
? RE_MAGIC
: 0);
1233 pats
->regmatch
.regprog
= NULL
;
1237 * find_tags() - search for tags in tags files
1239 * Return FAIL if search completely failed (*num_matches will be 0, *matchesp
1240 * will be NULL), OK otherwise.
1242 * There is a priority in which type of tag is recognized.
1244 * 6. A static or global tag with a full matching tag for the current file.
1245 * 5. A global tag with a full matching tag for another file.
1246 * 4. A static tag with a full matching tag for another file.
1247 * 3. A static or global tag with an ignore-case matching tag for the
1249 * 2. A global tag with an ignore-case matching tag for another file.
1250 * 1. A static tag with an ignore-case matching tag for another file.
1252 * Tags in an emacs-style tags file are always global.
1255 * TAG_HELP only search for help tags
1256 * TAG_NAMES only return name of tag
1257 * TAG_REGEXP use "pat" as a regexp
1258 * TAG_NOIC don't always ignore case
1259 * TAG_KEEP_LANG keep language
1262 find_tags(pat
, num_matches
, matchesp
, flags
, mincount
, buf_ffname
)
1263 char_u
*pat
; /* pattern to search for */
1264 int *num_matches
; /* return: number of matches found */
1265 char_u
***matchesp
; /* return: array of matches found */
1267 int mincount
; /* MAXCOL: find all matches
1268 other: minimal number of matches */
1269 char_u
*buf_ffname
; /* name of buffer for priority */
1272 char_u
*lbuf
; /* line buffer */
1273 char_u
*tag_fname
; /* name of tag file */
1274 tagname_T tn
; /* info for get_tagfname() */
1275 int first_file
; /* trying first tag file */
1277 int did_open
= FALSE
; /* did open a tag file */
1278 int stop_searching
= FALSE
; /* stop when match found or error */
1279 int retval
= FAIL
; /* return value */
1280 int is_static
; /* current tag line is static */
1281 int is_current
; /* file name matches */
1282 int eof
= FALSE
; /* found end-of-file */
1286 #ifdef FEAT_TAG_BINS
1287 struct tag_search_info
/* Binary search file offsets */
1289 off_t low_offset
; /* offset for first char of first line that
1291 off_t high_offset
; /* offset of char after last line that could
1293 off_t curr_offset
; /* Current file offset in search range */
1294 off_t curr_offset_used
; /* curr_offset used when skipping back */
1295 off_t match_offset
; /* Where the binary search found a tag */
1296 int low_char
; /* first char at low_offset */
1297 int high_char
; /* first char at high_offset */
1306 TS_START
, /* at start of file */
1307 TS_LINEAR
/* linear searching forward, till EOF */
1308 #ifdef FEAT_TAG_BINS
1309 , TS_BINARY
, /* binary searching */
1310 TS_SKIP_BACK
, /* skipping backwards */
1311 TS_STEP_FORWARD
/* stepping forwards */
1313 } state
; /* Current search state */
1316 int match
; /* matches */
1317 int match_no_ic
= 0;/* matches with rm_ic == FALSE */
1318 int match_re
; /* match with regexp */
1321 #ifdef FEAT_EMACS_TAGS
1323 * Stack for included emacs-tags file.
1324 * It has a fixed size, to truncate cyclic includes. jw
1326 # define INCSTACK_SIZE 42
1331 } incstack
[INCSTACK_SIZE
];
1333 int incstack_idx
= 0; /* index in incstack */
1334 char_u
*ebuf
; /* additional buffer for etag fname */
1335 int is_etag
; /* current file is emaces style */
1340 int len
; /* nr of chars of match[] to be compared */
1341 char_u match
[1]; /* actually longer */
1343 garray_T ga_match
[MT_COUNT
];
1344 int match_count
= 0; /* number of matches found */
1349 #ifdef FEAT_MULTI_LANG
1351 char_u
*help_lang_find
= NULL
; /* lang to be found */
1352 char_u help_lang
[3]; /* lang of current tags file */
1353 char_u
*saved_pat
= NULL
; /* copy of pat[] */
1356 /* Use two sets of variables for the pattern: "orgpat" holds the values
1357 * for the original pattern and "convpat" converted from 'encoding' to
1358 * encoding of the tags file. "pats" point to either one of these. */
1360 pat_T orgpat
; /* holds unconverted pattern info */
1362 pat_T convpat
; /* holds converted pattern info */
1366 #ifdef FEAT_TAG_BINS
1367 int findall
= (mincount
== MAXCOL
|| mincount
== TAG_MANY
);
1368 /* find all matching tags */
1369 int sort_error
= FALSE
; /* tags file not sorted */
1370 int linear
; /* do a linear search */
1371 int sortic
= FALSE
; /* tag file sorted in nocase */
1373 int line_error
= FALSE
; /* syntax error */
1374 int has_re
= (flags
& TAG_REGEXP
); /* regexp used */
1375 int help_only
= (flags
& TAG_HELP
);
1376 int name_only
= (flags
& TAG_NAMES
);
1377 int noic
= (flags
& TAG_NOIC
);
1378 int get_it_again
= FALSE
;
1380 int use_cscope
= (flags
& TAG_CSCOPE
);
1382 int verbose
= (flags
& TAG_VERBOSE
);
1384 help_save
= curbuf
->b_help
;
1388 vimconv
.vc_type
= CONV_NONE
;
1392 * Allocate memory for the buffers that are used
1394 lbuf
= alloc(LSIZE
);
1395 tag_fname
= alloc(MAXPATHL
+ 1);
1396 #ifdef FEAT_EMACS_TAGS
1397 ebuf
= alloc(LSIZE
);
1399 for (mtt
= 0; mtt
< MT_COUNT
; ++mtt
)
1400 ga_init2(&ga_match
[mtt
], (int)sizeof(struct match_found
*), 100);
1402 /* check for out of memory situation */
1403 if (lbuf
== NULL
|| tag_fname
== NULL
1404 #ifdef FEAT_EMACS_TAGS
1411 STRCPY(tag_fname
, "from cscope"); /* for error messages */
1415 * Initialize a few variables
1417 if (help_only
) /* want tags from help file */
1418 curbuf
->b_help
= TRUE
; /* will be restored later */
1420 pats
->len
= (int)STRLEN(pat
);
1421 #ifdef FEAT_MULTI_LANG
1424 /* When "@ab" is specified use only the "ab" language, otherwise
1425 * search all languages. */
1426 if (pats
->len
> 3 && pat
[pats
->len
- 3] == '@'
1427 && ASCII_ISALPHA(pat
[pats
->len
- 2])
1428 && ASCII_ISALPHA(pat
[pats
->len
- 1]))
1430 saved_pat
= vim_strnsave(pat
, pats
->len
- 3);
1431 if (saved_pat
!= NULL
)
1433 help_lang_find
= &pat
[pats
->len
- 2];
1434 pats
->pat
= saved_pat
;
1440 if (p_tl
!= 0 && pats
->len
> p_tl
) /* adjust for 'taglength' */
1443 prepare_pats(pats
, has_re
);
1445 #ifdef FEAT_TAG_BINS
1446 /* This is only to avoid a compiler warning for using search_info
1448 vim_memset(&search_info
, 0, (size_t)1);
1452 * When finding a specified number of matches, first try with matching
1453 * case, so binary search can be used, and try ignore-case matches in a
1455 * When finding all matches, 'tagbsearch' is off, or there is no fixed
1456 * string to look for, ignore case right away to avoid going though the
1458 * When the tag file is case-fold sorted, it is either one or the other.
1459 * Only ignore case when TAG_NOIC not used or 'ignorecase' set.
1461 #ifdef FEAT_TAG_BINS
1462 pats
->regmatch
.rm_ic
= ((p_ic
|| !noic
)
1463 && (findall
|| pats
->headlen
== 0 || !p_tbs
));
1464 for (round
= 1; round
<= 2; ++round
)
1466 linear
= (pats
->headlen
== 0 || !p_tbs
|| round
== 2);
1468 pats
->regmatch
.rm_ic
= (p_ic
|| !noic
);
1472 * Try tag file names from tags option one by one.
1474 for (first_file
= TRUE
;
1478 get_tagfname(&tn
, first_file
, tag_fname
) == OK
;
1482 * A file that doesn't exist is silently ignored. Only when not a
1483 * single file is found, an error message is given (further on).
1487 fp
= NULL
; /* avoid GCC warning */
1491 #ifdef FEAT_MULTI_LANG
1494 /* Prefer help tags according to 'helplang'. Put the
1495 * two-letter language name in help_lang[]. */
1496 i
= (int)STRLEN(tag_fname
);
1497 if (i
> 3 && tag_fname
[i
- 3] == '-')
1498 STRCPY(help_lang
, tag_fname
+ i
- 2);
1500 STRCPY(help_lang
, "en");
1502 /* When searching for a specific language skip tags files
1503 * for other languages. */
1504 if (help_lang_find
!= NULL
1505 && STRICMP(help_lang
, help_lang_find
) != 0)
1508 /* For CTRL-] in a help file prefer a match with the same
1510 if ((flags
& TAG_KEEP_LANG
)
1511 && help_lang_find
== NULL
1512 && curbuf
->b_fname
!= NULL
1513 && (i
= (int)STRLEN(curbuf
->b_fname
)) > 4
1514 && curbuf
->b_fname
[i
- 1] == 'x'
1515 && curbuf
->b_fname
[i
- 4] == '.'
1516 && STRNICMP(curbuf
->b_fname
+ i
- 3, help_lang
, 2) == 0)
1521 for (s
= p_hlg
; *s
!= NUL
; ++s
)
1523 if (STRNICMP(s
, help_lang
, 2) == 0)
1526 if ((s
= vim_strchr(s
, ',')) == NULL
)
1529 if (s
== NULL
|| *s
== NUL
)
1531 /* Language not in 'helplang': use last, prefer English,
1532 * unless found already. */
1534 if (STRICMP(help_lang
, "en") != 0)
1541 if ((fp
= mch_fopen((char *)tag_fname
, "r")) == NULL
)
1547 smsg((char_u
*)_("Searching tags file %s"), tag_fname
);
1551 did_open
= TRUE
; /* remember that we found at least one file */
1553 state
= TS_START
; /* we're at the start of the file */
1554 #ifdef FEAT_EMACS_TAGS
1555 is_etag
= 0; /* default is: not emacs style */
1559 * Read and parse the lines in the file one by one
1563 line_breakcheck(); /* check for CTRL-C typed */
1564 #ifdef FEAT_INS_EXPAND
1565 if ((flags
& TAG_INS_COMP
)) /* Double brackets for gcc */
1566 ins_compl_check_keys(30);
1567 if (got_int
|| compl_interrupted
)
1572 stop_searching
= TRUE
;
1575 /* When mincount is TAG_MANY, stop when enough matches have been
1576 * found (for completion). */
1577 if (mincount
== TAG_MANY
&& match_count
>= TAG_MANY
)
1579 stop_searching
= TRUE
;
1585 #ifdef FEAT_TAG_BINS
1587 * For binary search: compute the next offset to use.
1589 if (state
== TS_BINARY
)
1591 offset
= search_info
.low_offset
+ ((search_info
.high_offset
1592 - search_info
.low_offset
) / 2);
1593 if (offset
== search_info
.curr_offset
)
1594 break; /* End the binary search without a match. */
1596 search_info
.curr_offset
= offset
;
1600 * Skipping back (after a match during binary search).
1602 else if (state
== TS_SKIP_BACK
)
1604 search_info
.curr_offset
-= LSIZE
* 2;
1605 if (search_info
.curr_offset
< 0)
1607 search_info
.curr_offset
= 0;
1609 state
= TS_STEP_FORWARD
;
1614 * When jumping around in the file, first read a line to find the
1615 * start of the next line.
1617 if (state
== TS_BINARY
|| state
== TS_SKIP_BACK
)
1619 /* Adjust the search file offset to the correct position */
1620 search_info
.curr_offset_used
= search_info
.curr_offset
;
1622 fseeko(fp
, search_info
.curr_offset
, SEEK_SET
);
1624 fseek(fp
, (long)search_info
.curr_offset
, SEEK_SET
);
1626 eof
= tag_fgets(lbuf
, LSIZE
, fp
);
1627 if (!eof
&& search_info
.curr_offset
!= 0)
1629 /* The explicit cast is to work around a bug in gcc 3.4.2
1630 * (repeated below). */
1631 search_info
.curr_offset
= ftell(fp
);
1632 if (search_info
.curr_offset
== search_info
.high_offset
)
1634 /* oops, gone a bit too far; try from low offset */
1636 fseeko(fp
, search_info
.low_offset
, SEEK_SET
);
1638 fseek(fp
, (long)search_info
.low_offset
, SEEK_SET
);
1640 search_info
.curr_offset
= search_info
.low_offset
;
1642 eof
= tag_fgets(lbuf
, LSIZE
, fp
);
1644 /* skip empty and blank lines */
1645 while (!eof
&& vim_isblankline(lbuf
))
1647 search_info
.curr_offset
= ftell(fp
);
1648 eof
= tag_fgets(lbuf
, LSIZE
, fp
);
1652 /* Hit end of file. Skip backwards. */
1653 state
= TS_SKIP_BACK
;
1654 search_info
.match_offset
= ftell(fp
);
1655 search_info
.curr_offset
= search_info
.curr_offset_used
;
1661 * Not jumping around in the file: Read the next line.
1666 /* skip empty and blank lines */
1671 eof
= cs_fgets(lbuf
, LSIZE
);
1674 eof
= tag_fgets(lbuf
, LSIZE
, fp
);
1675 } while (!eof
&& vim_isblankline(lbuf
));
1679 #ifdef FEAT_EMACS_TAGS
1680 if (incstack_idx
) /* this was an included file */
1683 fclose(fp
); /* end of this file ... */
1684 fp
= incstack
[incstack_idx
].fp
;
1685 STRCPY(tag_fname
, incstack
[incstack_idx
].etag_fname
);
1686 vim_free(incstack
[incstack_idx
].etag_fname
);
1687 is_etag
= 1; /* (only etags can include) */
1688 continue; /* ... continue with parent file */
1692 break; /* end of file */
1697 #ifdef FEAT_EMACS_TAGS
1699 * Emacs tags line with CTRL-L: New file name on next line.
1700 * The file name is followed by a ','.
1702 if (*lbuf
== Ctrl_L
) /* remember etag file name in ebuf */
1704 is_etag
= 1; /* in case at the start */
1706 if (!tag_fgets(ebuf
, LSIZE
, fp
))
1708 for (p
= ebuf
; *p
&& *p
!= ','; p
++)
1713 * atoi(p+1) is the number of bytes before the next ^L
1714 * unless it is an include statement.
1716 if (STRNCMP(p
+ 1, "include", 7) == 0
1717 && incstack_idx
< INCSTACK_SIZE
)
1719 /* Save current "fp" and "tag_fname" in the stack. */
1720 if ((incstack
[incstack_idx
].etag_fname
=
1721 vim_strsave(tag_fname
)) != NULL
)
1723 char_u
*fullpath_ebuf
;
1725 incstack
[incstack_idx
].fp
= fp
;
1728 /* Figure out "tag_fname" and "fp" to use for
1730 fullpath_ebuf
= expand_tag_fname(ebuf
,
1732 if (fullpath_ebuf
!= NULL
)
1734 fp
= mch_fopen((char *)fullpath_ebuf
, "r");
1737 if (STRLEN(fullpath_ebuf
) > LSIZE
)
1738 EMSG2(_("E430: Tag file path truncated for %s\n"), ebuf
);
1739 vim_strncpy(tag_fname
, fullpath_ebuf
,
1742 is_etag
= 0; /* we can include anything */
1744 vim_free(fullpath_ebuf
);
1748 /* Can't open the included file, skip it and
1749 * restore old value of "fp". */
1750 fp
= incstack
[incstack_idx
].fp
;
1751 vim_free(incstack
[incstack_idx
].etag_fname
);
1761 * When still at the start of the file, check for Emacs tags file
1762 * format, and for "not sorted" flag.
1764 if (state
== TS_START
)
1766 #ifdef FEAT_TAG_BINS
1768 * When there is no tag head, or ignoring case, need to do a
1770 * When no "!_TAG_" is found, default to binary search. If
1771 * the tag file isn't sorted, the second loop will find it.
1772 * When "!_TAG_FILE_SORTED" found: start binary search if
1774 * For cscope, it's always linear.
1777 if (linear
|| use_cscope
)
1782 else if (STRNCMP(lbuf
, "!_TAG_", 6) > 0)
1784 else if (STRNCMP(lbuf
, "!_TAG_FILE_SORTED\t", 18) == 0)
1786 /* Check sorted flag */
1787 if (lbuf
[18] == '1')
1789 else if (lbuf
[18] == '2')
1793 pats
->regmatch
.rm_ic
= (p_ic
|| !noic
);
1799 if (state
== TS_BINARY
&& pats
->regmatch
.rm_ic
&& !sortic
)
1801 /* binary search won't work for ignoring case, use linear
1810 #ifdef FEAT_TAG_BINS
1812 * When starting a binary search, get the size of the file and
1813 * compute the first offset.
1815 if (state
== TS_BINARY
)
1817 /* Get the tag file size (don't use mch_fstat(), it's not
1819 if ((filesize
= lseek(fileno(fp
),
1820 (off_t
)0L, SEEK_END
)) <= 0)
1824 lseek(fileno(fp
), (off_t
)0L, SEEK_SET
);
1826 /* Calculate the first read offset in the file. Start
1827 * the search in the middle of the file. */
1828 search_info
.low_offset
= 0;
1829 search_info
.low_char
= 0;
1830 search_info
.high_offset
= filesize
;
1831 search_info
.curr_offset
= 0;
1832 search_info
.high_char
= 0xff;
1840 if (lbuf
[0] == '!' && pats
== &orgpat
1841 && STRNCMP(lbuf
, "!_TAG_FILE_ENCODING\t", 20) == 0)
1843 /* Convert the search pattern from 'encoding' to the
1844 * specified encoding. */
1845 for (p
= lbuf
+ 20; *p
> ' ' && *p
< 127; ++p
)
1848 convert_setup(&vimconv
, p_enc
, lbuf
+ 20);
1849 if (vimconv
.vc_type
!= CONV_NONE
)
1851 convpat
.pat
= string_convert(&vimconv
, pats
->pat
, NULL
);
1852 if (convpat
.pat
!= NULL
)
1855 pats
->len
= (int)STRLEN(pats
->pat
);
1856 prepare_pats(pats
, has_re
);
1857 pats
->regmatch
.rm_ic
= orgpat
.regmatch
.rm_ic
;
1861 /* Prepare for converting a match the other way around. */
1862 convert_setup(&vimconv
, lbuf
+ 20, p_enc
);
1868 * Figure out where the different strings are in this line.
1869 * For "normal" tags: Do a quick check if the tag matches.
1870 * This speeds up tag searching a lot!
1873 #ifdef FEAT_EMACS_TAGS
1878 tagp
.tagname
= lbuf
;
1879 #ifdef FEAT_TAG_ANYWHITE
1880 tagp
.tagname_end
= skiptowhite(lbuf
);
1881 if (*tagp
.tagname_end
== NUL
) /* corrupted tag line */
1883 tagp
.tagname_end
= vim_strchr(lbuf
, TAB
);
1884 if (tagp
.tagname_end
== NULL
) /* corrupted tag line */
1891 #ifdef FEAT_TAG_OLDSTATIC
1893 * Check for old style static tag: "file:tag file .."
1896 for (p
= lbuf
; p
< tagp
.tagname_end
; ++p
)
1900 if (tagp
.fname
== NULL
)
1901 #ifdef FEAT_TAG_ANYWHITE
1902 tagp
.fname
= skipwhite(tagp
.tagname_end
);
1904 tagp
.fname
= tagp
.tagname_end
+ 1;
1906 if ( fnamencmp(lbuf
, tagp
.fname
, p
- lbuf
) == 0
1907 #ifdef FEAT_TAG_ANYWHITE
1908 && vim_iswhite(tagp
.fname
[p
- lbuf
])
1910 && tagp
.fname
[p
- lbuf
] == TAB
1915 tagp
.tagname
= p
+ 1;
1923 * Skip this line if the length of the tag is different and
1924 * there is no regexp, or the tag is too short.
1926 cmplen
= (int)(tagp
.tagname_end
- tagp
.tagname
);
1927 if (p_tl
!= 0 && cmplen
> p_tl
) /* adjust for 'taglength' */
1929 if (has_re
&& pats
->headlen
< cmplen
)
1930 cmplen
= pats
->headlen
;
1931 else if (state
== TS_LINEAR
&& pats
->headlen
!= cmplen
)
1934 #ifdef FEAT_TAG_BINS
1935 if (state
== TS_BINARY
)
1938 * Simplistic check for unsorted tags file.
1940 i
= (int)tagp
.tagname
[0];
1942 i
= (int)TOUPPER_ASC(tagp
.tagname
[0]);
1943 if (i
< search_info
.low_char
|| i
> search_info
.high_char
)
1947 * Compare the current tag with the searched tag.
1950 tagcmp
= tag_strnicmp(tagp
.tagname
, pats
->head
,
1953 tagcmp
= STRNCMP(tagp
.tagname
, pats
->head
, cmplen
);
1956 * A match with a shorter tag means to search forward.
1957 * A match with a longer tag means to search backward.
1961 if (cmplen
< pats
->headlen
)
1963 else if (cmplen
> pats
->headlen
)
1969 /* We've located the tag, now skip back and search
1970 * forward until the first matching tag is found.
1972 state
= TS_SKIP_BACK
;
1973 search_info
.match_offset
= search_info
.curr_offset
;
1978 search_info
.curr_offset
= ftell(fp
);
1979 if (search_info
.curr_offset
< search_info
.high_offset
)
1981 search_info
.low_offset
= search_info
.curr_offset
;
1983 search_info
.low_char
=
1984 TOUPPER_ASC(tagp
.tagname
[0]);
1986 search_info
.low_char
= tagp
.tagname
[0];
1991 && search_info
.curr_offset
!= search_info
.high_offset
)
1993 search_info
.high_offset
= search_info
.curr_offset
;
1995 search_info
.high_char
=
1996 TOUPPER_ASC(tagp
.tagname
[0]);
1998 search_info
.high_char
= tagp
.tagname
[0];
2002 /* No match yet and are at the end of the binary search. */
2005 else if (state
== TS_SKIP_BACK
)
2007 if (MB_STRNICMP(tagp
.tagname
, pats
->head
, cmplen
) != 0)
2008 state
= TS_STEP_FORWARD
;
2010 /* Have to skip back more. Restore the curr_offset
2011 * used, otherwise we get stuck at a long line. */
2012 search_info
.curr_offset
= search_info
.curr_offset_used
;
2015 else if (state
== TS_STEP_FORWARD
)
2017 if (MB_STRNICMP(tagp
.tagname
, pats
->head
, cmplen
) != 0)
2019 if ((off_t
)ftell(fp
) > search_info
.match_offset
)
2020 break; /* past last match */
2022 continue; /* before first match */
2027 /* skip this match if it can't match */
2028 if (MB_STRNICMP(tagp
.tagname
, pats
->head
, cmplen
) != 0)
2032 * Can be a matching tag, isolate the file name and command.
2034 #ifdef FEAT_TAG_OLDSTATIC
2035 if (tagp
.fname
== NULL
)
2037 #ifdef FEAT_TAG_ANYWHITE
2038 tagp
.fname
= skipwhite(tagp
.tagname_end
);
2040 tagp
.fname
= tagp
.tagname_end
+ 1;
2042 #ifdef FEAT_TAG_ANYWHITE
2043 tagp
.fname_end
= skiptowhite(tagp
.fname
);
2044 tagp
.command
= skipwhite(tagp
.fname_end
);
2045 if (*tagp
.command
== NUL
)
2047 tagp
.fname_end
= vim_strchr(tagp
.fname
, TAB
);
2048 tagp
.command
= tagp
.fname_end
+ 1;
2049 if (tagp
.fname_end
== NULL
)
2056 i
= parse_tag_line(lbuf
,
2057 #ifdef FEAT_EMACS_TAGS
2067 #ifdef FEAT_EMACS_TAGS
2072 * First try matching with the pattern literally (also when it is
2075 cmplen
= (int)(tagp
.tagname_end
- tagp
.tagname
);
2076 if (p_tl
!= 0 && cmplen
> p_tl
) /* adjust for 'taglength' */
2078 /* if tag length does not match, don't try comparing */
2079 if (pats
->len
!= cmplen
)
2083 if (pats
->regmatch
.rm_ic
)
2085 match
= (MB_STRNICMP(tagp
.tagname
, pats
->pat
, cmplen
) == 0);
2087 match_no_ic
= (STRNCMP(tagp
.tagname
, pats
->pat
,
2091 match
= (STRNCMP(tagp
.tagname
, pats
->pat
, cmplen
) == 0);
2095 * Has a regexp: Also find tags matching regexp.
2098 if (!match
&& pats
->regmatch
.regprog
!= NULL
)
2102 cc
= *tagp
.tagname_end
;
2103 *tagp
.tagname_end
= NUL
;
2104 match
= vim_regexec(&pats
->regmatch
, tagp
.tagname
, (colnr_T
)0);
2107 matchoff
= (int)(pats
->regmatch
.startp
[0] - tagp
.tagname
);
2108 if (pats
->regmatch
.rm_ic
)
2110 pats
->regmatch
.rm_ic
= FALSE
;
2111 match_no_ic
= vim_regexec(&pats
->regmatch
, tagp
.tagname
,
2113 pats
->regmatch
.rm_ic
= TRUE
;
2116 *tagp
.tagname_end
= cc
;
2121 * If a match is found, add it to ga_match[].
2128 /* Don't change the ordering, always use the same table. */
2134 /* Decide in which array to store this match. */
2135 is_current
= test_for_current(
2136 #ifdef FEAT_EMACS_TAGS
2139 tagp
.fname
, tagp
.fname_end
, tag_fname
,
2141 #ifdef FEAT_EMACS_TAGS
2143 if (!is_etag
) /* emacs tags are never static */
2146 #ifdef FEAT_TAG_OLDSTATIC
2147 if (tagp
.tagname
!= lbuf
)
2148 is_static
= TRUE
; /* detected static tag before */
2151 is_static
= test_for_static(&tagp
);
2154 /* decide in which of the sixteen tables to store this
2170 if (pats
->regmatch
.rm_ic
&& !match_no_ic
)
2177 * Add the found match in ga_match[mtt], avoiding duplicates.
2178 * Store the info we need later, which depends on the kind of
2179 * tags we are dealing with.
2181 if (ga_grow(&ga_match
[mtt
], 1) == OK
)
2184 char_u
*conv_line
= NULL
;
2185 char_u
*lbuf_line
= lbuf
;
2187 if (vimconv
.vc_type
!= CONV_NONE
)
2189 /* Convert the tag line from the encoding of the tags
2190 * file to 'encoding'. Then parse the line again. */
2191 conv_line
= string_convert(&vimconv
, lbuf
, NULL
);
2192 if (conv_line
!= NULL
)
2194 if (parse_tag_line(conv_line
,
2195 #ifdef FEAT_EMACS_TAGS
2199 lbuf_line
= conv_line
;
2201 /* doesn't work, go back to unconverted line. */
2202 (void)parse_tag_line(lbuf
,
2203 #ifdef FEAT_EMACS_TAGS
2210 # define lbuf_line lbuf
2214 #ifdef FEAT_MULTI_LANG
2220 * Append the help-heuristic number after the
2221 * tagname, for sorting it later.
2223 *tagp
.tagname_end
= NUL
;
2224 len
= (int)(tagp
.tagname_end
- tagp
.tagname
);
2225 mfp
= (struct match_found
*)
2226 alloc((int)sizeof(struct match_found
) + len
2230 /* "len" includes the language and the NUL, but
2231 * not the priority. */
2232 mfp
->len
= len
+ ML_EXTRA
+ 1;
2233 #define ML_HELP_LEN 6
2235 STRCPY(p
, tagp
.tagname
);
2236 #ifdef FEAT_MULTI_LANG
2238 STRCPY(p
+ len
+ 1, help_lang
);
2240 sprintf((char *)p
+ len
+ 1 + ML_EXTRA
, "%06d",
2241 help_heuristic(tagp
.tagname
,
2242 match_re
? matchoff
: 0, !match_no_ic
)
2243 #ifdef FEAT_MULTI_LANG
2248 *tagp
.tagname_end
= TAB
;
2254 char_u
*temp_end
= tagp
.command
;
2256 if (*temp_end
== '/')
2257 while (*temp_end
&& *temp_end
!= '\r'
2258 && *temp_end
!= '\n'
2259 && *temp_end
!= '$')
2262 if (tagp
.command
+ 2 < temp_end
)
2264 len
= (int)(temp_end
- tagp
.command
- 2);
2265 mfp
= (struct match_found
*)alloc(
2266 (int)sizeof(struct match_found
) + len
);
2269 mfp
->len
= len
+ 1; /* include the NUL */
2271 vim_strncpy(p
, tagp
.command
+ 2, len
);
2276 get_it_again
= FALSE
;
2280 len
= (int)(tagp
.tagname_end
- tagp
.tagname
);
2281 mfp
= (struct match_found
*)alloc(
2282 (int)sizeof(struct match_found
) + len
);
2285 mfp
->len
= len
+ 1; /* include the NUL */
2287 vim_strncpy(p
, tagp
.tagname
, len
);
2290 /* if wanted, re-read line to get long form too */
2292 get_it_again
= p_sft
;
2297 /* Save the tag in a buffer.
2298 * Emacs tag: <mtt><tag_fname><NUL><ebuf><NUL><lbuf>
2299 * other tag: <mtt><tag_fname><NUL><NUL><lbuf>
2300 * without Emacs tags: <mtt><tag_fname><NUL><lbuf>
2302 len
= (int)STRLEN(tag_fname
)
2303 + (int)STRLEN(lbuf_line
) + 3;
2304 #ifdef FEAT_EMACS_TAGS
2306 len
+= (int)STRLEN(ebuf
) + 1;
2310 mfp
= (struct match_found
*)alloc(
2311 (int)sizeof(struct match_found
) + len
);
2317 STRCPY(p
+ 1, tag_fname
);
2318 #ifdef BACKSLASH_IN_FILENAME
2319 /* Ignore differences in slashes, avoid adding
2320 * both path/file and path\file. */
2321 slash_adjust(p
+ 1);
2323 s
= p
+ 1 + STRLEN(tag_fname
) + 1;
2324 #ifdef FEAT_EMACS_TAGS
2328 s
+= STRLEN(ebuf
) + 1;
2333 STRCPY(s
, lbuf_line
);
2340 * Don't add identical matches.
2341 * This can take a lot of time when finding many
2342 * matches, check for CTRL-C now and then.
2343 * Add all cscope tags, because they are all listed.
2350 for (i
= ga_match
[mtt
].ga_len
; --i
>= 0 && !got_int
; )
2352 mfp2
= ((struct match_found
**)
2353 (ga_match
[mtt
].ga_data
))[i
];
2354 if (mfp2
->len
== mfp
->len
2355 && vim_memcmp(mfp2
->match
, mfp
->match
,
2356 (size_t)mfp
->len
) == 0)
2362 ((struct match_found
**)(ga_match
[mtt
].ga_data
))
2363 [ga_match
[mtt
].ga_len
++] = mfp
;
2370 /* Note: this makes the values in "tagp" invalid! */
2371 vim_free(conv_line
);
2374 else /* Out of memory! Just forget about the rest. */
2377 stop_searching
= TRUE
;
2382 if (use_cscope
&& eof
)
2389 EMSG2(_("E431: Format error in tags file \"%s\""), tag_fname
);
2393 EMSGN(_("Before byte %ld"), (long)ftell(fp
));
2394 stop_searching
= TRUE
;
2402 #ifdef FEAT_EMACS_TAGS
2403 while (incstack_idx
)
2406 fclose(incstack
[incstack_idx
].fp
);
2407 vim_free(incstack
[incstack_idx
].etag_fname
);
2411 if (pats
== &convpat
)
2413 /* Go back from converted pattern to original pattern. */
2414 vim_free(pats
->pat
);
2415 vim_free(pats
->regmatch
.regprog
);
2416 orgpat
.regmatch
.rm_ic
= pats
->regmatch
.rm_ic
;
2419 if (vimconv
.vc_type
!= CONV_NONE
)
2420 convert_setup(&vimconv
, NULL
, NULL
);
2423 #ifdef FEAT_TAG_BINS
2426 EMSG2(_("E432: Tags file not sorted: %s"), tag_fname
);
2432 * Stop searching if sufficient tags have been found.
2434 if (match_count
>= mincount
)
2437 stop_searching
= TRUE
;
2441 if (stop_searching
|| use_cscope
)
2447 } /* end of for-each-file loop */
2454 #ifdef FEAT_TAG_BINS
2455 /* stop searching when already did a linear search, or when TAG_NOIC
2456 * used, and 'ignorecase' not set or already did case-ignore search */
2457 if (stop_searching
|| linear
|| (!p_ic
&& noic
) || pats
->regmatch
.rm_ic
)
2463 pats
->regmatch
.rm_ic
= TRUE
; /* try another time while ignoring case */
2467 if (!stop_searching
)
2469 if (!did_open
&& verbose
) /* never opened any tags file */
2470 EMSG(_("E433: No tags file"));
2471 retval
= OK
; /* It's OK even when no tag found */
2476 vim_free(pats
->regmatch
.regprog
);
2477 vim_free(tag_fname
);
2478 #ifdef FEAT_EMACS_TAGS
2483 * Move the matches from the ga_match[] arrays into one list of
2484 * matches. When retval == FAIL, free the matches.
2489 if (match_count
> 0)
2490 matches
= (char_u
**)lalloc((long_u
)(match_count
* sizeof(char_u
*)),
2495 for (mtt
= 0; mtt
< MT_COUNT
; ++mtt
)
2497 for (i
= 0; i
< ga_match
[mtt
].ga_len
; ++i
)
2499 mfp
= ((struct match_found
**)(ga_match
[mtt
].ga_data
))[i
];
2500 if (matches
== NULL
)
2504 /* To avoid allocating memory again we turn the struct
2505 * match_found into a string. For help the priority was not
2506 * included in the length. */
2507 mch_memmove(mfp
, mfp
->match
,
2508 (size_t)(mfp
->len
+ (help_only
? ML_HELP_LEN
: 0)));
2509 matches
[match_count
++] = (char_u
*)mfp
;
2512 ga_clear(&ga_match
[mtt
]);
2515 *matchesp
= matches
;
2516 *num_matches
= match_count
;
2518 curbuf
->b_help
= help_save
;
2519 #ifdef FEAT_MULTI_LANG
2520 vim_free(saved_pat
);
2526 static garray_T tag_fnames
= GA_EMPTY
;
2527 static void found_tagfile_cb
__ARGS((char_u
*fname
, void *cookie
));
2530 * Callback function for finding all "tags" and "tags-??" files in
2531 * 'runtimepath' doc directories.
2534 found_tagfile_cb(fname
, cookie
)
2536 void *cookie UNUSED
;
2538 if (ga_grow(&tag_fnames
, 1) == OK
)
2539 ((char_u
**)(tag_fnames
.ga_data
))[tag_fnames
.ga_len
++] =
2543 #if defined(EXITFREE) || defined(PROTO)
2547 ga_clear_strings(&tag_fnames
);
2548 do_tag(NULL
, DT_FREE
, 0, 0, 0);
2551 # if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
2552 if (ptag_entry
.tagname
)
2554 vim_free(ptag_entry
.tagname
);
2555 ptag_entry
.tagname
= NULL
;
2562 * Get the next name of a tag file from the tag file list.
2563 * For help files, use "tags" file only.
2565 * Return FAIL if no more tag file names, OK otherwise.
2568 get_tagfname(tnp
, first
, buf
)
2569 tagname_T
*tnp
; /* holds status info */
2570 int first
; /* TRUE when first file name is wanted */
2571 char_u
*buf
; /* pointer to buffer of MAXPATHL chars */
2573 char_u
*fname
= NULL
;
2577 vim_memset(tnp
, 0, sizeof(tagname_T
));
2582 * For help files it's done in a completely different way:
2583 * Find "doc/tags" and "doc/tags-??" in all directories in
2588 ga_clear_strings(&tag_fnames
);
2589 ga_init2(&tag_fnames
, (int)sizeof(char_u
*), 10);
2590 do_in_runtimepath((char_u
*)
2591 #ifdef FEAT_MULTI_LANG
2593 /* Functions decc$to_vms() and decc$translate_vms() crash
2594 * on some VMS systems with wildcards "??". Seems ECO
2595 * patches do fix the problem in C RTL, but we can't use
2596 * an #ifdef for that. */
2597 "doc/tags doc/tags-*"
2599 "doc/tags doc/tags-??"
2604 , TRUE
, found_tagfile_cb
, NULL
);
2607 if (tnp
->tn_hf_idx
>= tag_fnames
.ga_len
)
2609 /* Not found in 'runtimepath', use 'helpfile', if it exists and
2610 * wasn't used yet, replacing "help.txt" with "tags". */
2611 if (tnp
->tn_hf_idx
> tag_fnames
.ga_len
|| *p_hf
== NUL
)
2615 STRCPY(gettail(buf
), "tags");
2618 vim_strncpy(buf
, ((char_u
**)(tag_fnames
.ga_data
))[
2619 tnp
->tn_hf_idx
++], MAXPATHL
- 1);
2625 /* Init. We make a copy of 'tags', because autocommands may change
2626 * the value without notifying us. */
2627 tnp
->tn_tags
= vim_strsave((*curbuf
->b_p_tags
!= NUL
)
2628 ? curbuf
->b_p_tags
: p_tags
);
2629 if (tnp
->tn_tags
== NULL
)
2631 tnp
->tn_np
= tnp
->tn_tags
;
2635 * Loop until we have found a file name that can be used.
2636 * There are two states:
2637 * tnp->tn_did_filefind_init == FALSE: setup for next part in 'tags'.
2638 * tnp->tn_did_filefind_init == TRUE: find next file in this part.
2642 if (tnp
->tn_did_filefind_init
)
2644 fname
= vim_findfile(tnp
->tn_search_ctx
);
2648 tnp
->tn_did_filefind_init
= FALSE
;
2652 char_u
*filename
= NULL
;
2654 /* Stop when used all parts of 'tags'. */
2655 if (*tnp
->tn_np
== NUL
)
2657 vim_findfile_cleanup(tnp
->tn_search_ctx
);
2658 tnp
->tn_search_ctx
= NULL
;
2663 * Copy next file name into buf.
2666 (void)copy_option_part(&tnp
->tn_np
, buf
, MAXPATHL
- 1, " ,");
2668 #ifdef FEAT_PATH_EXTRA
2669 r_ptr
= vim_findfile_stopdir(buf
);
2673 /* move the filename one char forward and truncate the
2674 * filepath with a NUL */
2675 filename
= gettail(buf
);
2676 STRMOVE(filename
+ 1, filename
);
2679 tnp
->tn_search_ctx
= vim_findfile_init(buf
, filename
,
2681 FALSE
, /* don't free visited list */
2682 FINDFILE_FILE
, /* we search for a file */
2683 tnp
->tn_search_ctx
, TRUE
, curbuf
->b_ffname
);
2684 if (tnp
->tn_search_ctx
!= NULL
)
2685 tnp
->tn_did_filefind_init
= TRUE
;
2695 * Free the contents of a tagname_T that was filled by get_tagfname().
2701 vim_free(tnp
->tn_tags
);
2702 vim_findfile_cleanup(tnp
->tn_search_ctx
);
2703 tnp
->tn_search_ctx
= NULL
;
2704 ga_clear_strings(&tag_fnames
);
2708 * Parse one line from the tags file. Find start/end of tag name, start/end of
2709 * file name and start of search pattern.
2711 * If is_etag is TRUE, tagp->fname and tagp->fname_end are not set.
2713 * Return FAIL if there is a format error in this line, OK otherwise.
2716 parse_tag_line(lbuf
,
2717 #ifdef FEAT_EMACS_TAGS
2721 char_u
*lbuf
; /* line to be parsed */
2722 #ifdef FEAT_EMACS_TAGS
2729 #ifdef FEAT_EMACS_TAGS
2735 * There are two formats for an emacs tag line:
2736 * 1: struct EnvBase ^?EnvBase^A139,4627
2737 * 2: #define ARPB_WILD_WORLD ^?153,5194
2739 p_7f
= vim_strchr(lbuf
, 0x7f);
2743 if (vim_strchr(lbuf
, '\n') == NULL
)
2745 /* Truncated line. Ignore it. */
2749 MSG(_("Ignoring long line in tags file"));
2752 tagp
->command
= lbuf
;
2753 tagp
->tagname
= lbuf
;
2754 tagp
->tagname_end
= lbuf
;
2760 /* Find ^A. If not found the line number is after the 0x7f */
2761 p
= vim_strchr(p_7f
, Ctrl_A
);
2767 if (!VIM_ISDIGIT(*p
)) /* check for start of line number */
2772 if (p
[-1] == Ctrl_A
) /* first format: explicit tagname given */
2774 tagp
->tagname
= p_7f
+ 1;
2775 tagp
->tagname_end
= p
- 1;
2777 else /* second format: isolate tagname */
2779 /* find end of tagname */
2780 for (p
= p_7f
- 1; !vim_iswordc(*p
); --p
)
2783 tagp
->tagname_end
= p
+ 1;
2784 while (p
>= lbuf
&& vim_iswordc(*p
))
2786 tagp
->tagname
= p
+ 1;
2789 else /* not an Emacs tag */
2792 /* Isolate the tagname, from lbuf up to the first white */
2793 tagp
->tagname
= lbuf
;
2794 #ifdef FEAT_TAG_ANYWHITE
2795 p
= skiptowhite(lbuf
);
2797 p
= vim_strchr(lbuf
, TAB
);
2801 tagp
->tagname_end
= p
;
2803 /* Isolate file name, from first to second white space */
2804 #ifdef FEAT_TAG_ANYWHITE
2811 #ifdef FEAT_TAG_ANYWHITE
2814 p
= vim_strchr(p
, TAB
);
2818 tagp
->fname_end
= p
;
2820 /* find start of search command, after second white space */
2821 #ifdef FEAT_TAG_ANYWHITE
2830 #ifdef FEAT_EMACS_TAGS
2838 * Check if tagname is a static tag
2840 * Static tags produced by the older ctags program have the format:
2841 * 'file:tag file /pattern'.
2842 * This is only recognized when both occurrence of 'file' are the same, to
2843 * avoid recognizing "string::string" or ":exit".
2845 * Static tags produced by the new ctags program have the format:
2846 * 'tag file /pattern/;"<Tab>file:' "
2848 * Return TRUE if it is a static tag and adjust *tagname to the real tag.
2849 * Return FALSE if it is not a static tag.
2852 test_for_static(tagp
)
2857 #ifdef FEAT_TAG_OLDSTATIC
2861 * Check for old style static tag: "file:tag file .."
2863 len
= (int)(tagp
->fname_end
- tagp
->fname
);
2864 p
= tagp
->tagname
+ len
;
2865 if ( p
< tagp
->tagname_end
2867 && fnamencmp(tagp
->tagname
, tagp
->fname
, len
) == 0)
2869 tagp
->tagname
= p
+ 1;
2875 * Check for new style static tag ":...<Tab>file:[<Tab>...]"
2878 while ((p
= vim_strchr(p
, '\t')) != NULL
)
2881 if (STRNCMP(p
, "file:", 5) == 0)
2889 * Parse a line from a matching tag. Does not change the line itself.
2891 * The line that we get looks like this:
2892 * Emacs tag: <mtt><tag_fname><NUL><ebuf><NUL><lbuf>
2893 * other tag: <mtt><tag_fname><NUL><NUL><lbuf>
2894 * without Emacs tags: <mtt><tag_fname><NUL><lbuf>
2896 * Return OK or FAIL.
2899 parse_match(lbuf
, tagp
)
2900 char_u
*lbuf
; /* input: matching line */
2901 tagptrs_T
*tagp
; /* output: pointers into the line */
2907 tagp
->tag_fname
= lbuf
+ 1;
2908 lbuf
+= STRLEN(tagp
->tag_fname
) + 2;
2909 #ifdef FEAT_EMACS_TAGS
2912 tagp
->is_etag
= TRUE
;
2914 lbuf
+= STRLEN(lbuf
);
2915 tagp
->fname_end
= lbuf
++;
2919 tagp
->is_etag
= FALSE
;
2924 /* Find search pattern and the file name for non-etags. */
2925 retval
= parse_tag_line(lbuf
,
2926 #ifdef FEAT_EMACS_TAGS
2931 tagp
->tagkind
= NULL
;
2932 tagp
->command_end
= NULL
;
2936 /* Try to find a kind field: "kind:<kind>" or just "<kind>"*/
2938 if (find_extra(&p
) == OK
)
2940 tagp
->command_end
= p
;
2941 p
+= 2; /* skip ";\"" */
2943 while (ASCII_ISALPHA(*p
))
2945 if (STRNCMP(p
, "kind:", 5) == 0)
2947 tagp
->tagkind
= p
+ 5;
2950 pc
= vim_strchr(p
, ':');
2951 pt
= vim_strchr(p
, '\t');
2952 if (pc
== NULL
|| (pt
!= NULL
&& pc
> pt
))
2962 if (tagp
->tagkind
!= NULL
)
2964 for (p
= tagp
->tagkind
;
2965 *p
&& *p
!= '\t' && *p
!= '\r' && *p
!= '\n'; ++p
)
2967 tagp
->tagkind_end
= p
;
2974 * Find out the actual file name of a tag. Concatenate the tags file name
2975 * with the matching tag file name.
2976 * Returns an allocated string or NULL (out of memory).
2979 tag_full_fname(tagp
)
2985 #ifdef FEAT_EMACS_TAGS
2987 c
= 0; /* to shut up GCC */
2991 c
= *tagp
->fname_end
;
2992 *tagp
->fname_end
= NUL
;
2994 fullname
= expand_tag_fname(tagp
->fname
, tagp
->tag_fname
, FALSE
);
2996 #ifdef FEAT_EMACS_TAGS
2999 *tagp
->fname_end
= c
;
3005 * Jump to a tag that has been found in one of the tag files
3007 * returns OK for success, NOTAGFILE when file not found, FAIL otherwise.
3010 jumpto_tag(lbuf
, forceit
, keep_help
)
3011 char_u
*lbuf
; /* line from the tags file for this tag */
3012 int forceit
; /* :ta with ! */
3013 int keep_help
; /* keep help flag (FALSE for cscope) */
3017 int save_p_ws
, save_p_scs
, save_p_ic
;
3021 char_u
*pbuf
; /* search pattern buffer */
3023 char_u
*tofree_fname
= NULL
;
3029 #ifdef FEAT_SEARCH_EXTRA
3030 int save_no_hlsearch
;
3032 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
3033 win_T
*curwin_save
= NULL
;
3035 char_u
*full_fname
= NULL
;
3037 int old_KeyTyped
= KeyTyped
; /* getting the file may reset it */
3040 pbuf
= alloc(LSIZE
);
3042 /* parse the match line into the tagp structure */
3043 if (pbuf
== NULL
|| parse_match(lbuf
, &tagp
) == FAIL
)
3045 tagp
.fname_end
= NULL
;
3049 /* truncate the file name, so it can be used as a string */
3050 csave
= *tagp
.fname_end
;
3051 *tagp
.fname_end
= NUL
;
3054 /* copy the command to pbuf[], remove trailing CR/NL */
3056 for (pbuf_end
= pbuf
; *str
&& *str
!= '\n' && *str
!= '\r'; )
3058 #ifdef FEAT_EMACS_TAGS
3059 if (tagp
.is_etag
&& *str
== ',')/* stop at ',' after line number */
3062 *pbuf_end
++ = *str
++;
3066 #ifdef FEAT_EMACS_TAGS
3071 * Remove the "<Tab>fieldname:value" stuff; we don't need it here.
3074 if (find_extra(&str
) == OK
)
3082 * Expand file name, when needed (for environment variables).
3083 * If 'tagrelative' option set, may change file name.
3085 fname
= expand_tag_fname(fname
, tagp
.tag_fname
, TRUE
);
3088 tofree_fname
= fname
; /* free() it later */
3091 * Check if the file with the tag exists before abandoning the current
3092 * file. Also accept a file name for which there is a matching BufReadCmd
3093 * autocommand event (e.g., http://sys/file).
3095 if (mch_getperm(fname
) < 0
3097 && !has_autocmd(EVENT_BUFREADCMD
, fname
, NULL
)
3102 vim_free(nofile_fname
);
3103 nofile_fname
= vim_strsave(fname
);
3104 if (nofile_fname
== NULL
)
3105 nofile_fname
= empty_option
;
3109 ++RedrawingDisabled
;
3112 need_mouse_correct
= TRUE
;
3115 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
3116 if (g_do_tagpreview
)
3118 postponed_split
= 0; /* don't split again below */
3119 curwin_save
= curwin
; /* Save current window */
3122 * If we are reusing a window, we may change dir when
3123 * entering it (autocommands) so turn the tag filename
3126 if (!curwin
->w_p_pvw
)
3128 full_fname
= FullName_save(fname
, FALSE
);
3132 * Make the preview window the current window.
3133 * Open a preview window when needed.
3135 prepare_tagpreview(TRUE
);
3139 /* If it was a CTRL-W CTRL-] command split window now. For ":tab tag"
3140 * open a new tab page. */
3141 if (postponed_split
|| cmdmod
.tab
!= 0)
3143 win_split(postponed_split
> 0 ? postponed_split
: 0,
3144 postponed_split_flags
);
3145 # ifdef FEAT_SCROLLBIND
3146 curwin
->w_p_scb
= FALSE
;
3153 /* A :ta from a help file will keep the b_help flag set. For ":ptag"
3154 * we need to use the flag from the window where we came from. */
3155 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
3156 if (g_do_tagpreview
)
3157 keep_help_flag
= curwin_save
->w_buffer
->b_help
;
3160 keep_help_flag
= curbuf
->b_help
;
3162 getfile_result
= getfile(0, fname
, NULL
, TRUE
, (linenr_T
)0, forceit
);
3163 keep_help_flag
= FALSE
;
3165 if (getfile_result
<= 0) /* got to the right file */
3167 curwin
->w_set_curswant
= TRUE
;
3169 postponed_split
= 0;
3172 save_secure
= secure
;
3177 save_magic
= p_magic
;
3178 p_magic
= FALSE
; /* always execute with 'nomagic' */
3179 #ifdef FEAT_SEARCH_EXTRA
3180 /* Save value of no_hlsearch, jumping to a tag is not a real search */
3181 save_no_hlsearch
= no_hlsearch
;
3185 * If 'cpoptions' contains 't', store the search pattern for the "n"
3186 * command. If 'cpoptions' does not contain 't', the search pattern
3189 if (vim_strchr(p_cpo
, CPO_TAGPAT
) != NULL
)
3192 search_options
= SEARCH_KEEP
;
3195 * If the command is a search, try here.
3197 * Reset 'smartcase' for the search, since the search pattern was not
3198 * typed by the user.
3199 * Only use do_search() when there is a full search command, without
3200 * anything following.
3203 if (pbuf
[0] == '/' || pbuf
[0] == '?')
3204 str
= skip_regexp(pbuf
+ 1, pbuf
[0], FALSE
, NULL
) + 1;
3205 if (str
> pbuf_end
- 1) /* search command with nothing following */
3210 p_ws
= TRUE
; /* need 'wrapscan' for backward searches */
3211 p_ic
= FALSE
; /* don't ignore case now */
3213 #if 0 /* disabled for now */
3215 /* put pattern in search history */
3216 add_to_history(HIST_SEARCH
, pbuf
+ 1, TRUE
, pbuf
[0]);
3219 save_lnum
= curwin
->w_cursor
.lnum
;
3220 curwin
->w_cursor
.lnum
= 0; /* start search before first line */
3221 if (do_search(NULL
, pbuf
[0], pbuf
+ 1, (long)1,
3222 search_options
, NULL
))
3230 * try again, ignore case now
3233 if (!do_search(NULL
, pbuf
[0], pbuf
+ 1, (long)1,
3234 search_options
, NULL
))
3237 * Failed to find pattern, take a guess: "^func ("
3240 (void)test_for_static(&tagp
);
3241 cc
= *tagp
.tagname_end
;
3242 *tagp
.tagname_end
= NUL
;
3243 sprintf((char *)pbuf
, "^%s\\s\\*(", tagp
.tagname
);
3244 if (!do_search(NULL
, '/', pbuf
, (long)1,
3245 search_options
, NULL
))
3247 /* Guess again: "^char * \<func (" */
3248 sprintf((char *)pbuf
, "^\\[#a-zA-Z_]\\.\\*\\<%s\\s\\*(",
3250 if (!do_search(NULL
, '/', pbuf
, (long)1,
3251 search_options
, NULL
))
3254 *tagp
.tagname_end
= cc
;
3258 EMSG(_("E434: Can't find tag pattern"));
3259 curwin
->w_cursor
.lnum
= save_lnum
;
3264 * Only give a message when really guessed, not when 'ic'
3265 * is set and match found while ignoring case.
3267 if (found
== 2 || !save_p_ic
)
3269 MSG(_("E435: Couldn't find tag, just guessing!"));
3270 if (!msg_scrolled
&& msg_silent
== 0)
3273 ui_delay(1000L, TRUE
);
3283 /* A search command may have positioned the cursor beyond the end
3284 * of the line. May need to correct that here. */
3289 curwin
->w_cursor
.lnum
= 1; /* start command in line 1 */
3290 do_cmdline_cmd(pbuf
);
3295 * When the command has done something that is not allowed make sure
3296 * the error message can be seen.
3300 secure
= save_secure
;
3301 p_magic
= save_magic
;
3305 #ifdef FEAT_SEARCH_EXTRA
3306 /* restore no_hlsearch when keeping the old search pattern */
3308 no_hlsearch
= save_no_hlsearch
;
3311 /* Return OK if jumped to another file (at least we found the file!). */
3312 if (getfile_result
== -1)
3318 * For a help buffer: Put the cursor line at the top of the window,
3319 * the help subject will be below it.
3322 set_topline(curwin
, curwin
->w_cursor
.lnum
);
3324 if ((fdo_flags
& FDO_TAG
) && old_KeyTyped
)
3329 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
3330 if (g_do_tagpreview
&& curwin
!= curwin_save
&& win_valid(curwin_save
))
3332 /* Return cursor to where we were */
3334 redraw_later(VALID
);
3335 win_enter(curwin_save
, TRUE
);
3339 --RedrawingDisabled
;
3343 --RedrawingDisabled
;
3345 if (postponed_split
) /* close the window */
3347 win_close(curwin
, FALSE
);
3348 postponed_split
= 0;
3354 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
3355 g_do_tagpreview
= 0; /* For next time */
3357 if (tagp
.fname_end
!= NULL
)
3358 *tagp
.fname_end
= csave
;
3360 vim_free(tofree_fname
);
3361 vim_free(full_fname
);
3367 * If "expand" is TRUE, expand wildcards in fname.
3368 * If 'tagrelative' option set, change fname (name of file containing tag)
3369 * according to tag_fname (name of tag file containing fname).
3370 * Returns a pointer to allocated memory (or NULL when out of memory).
3373 expand_tag_fname(fname
, tag_fname
, expand
)
3380 char_u
*expanded_fname
= NULL
;
3384 * Expand file name (for environment variables) when needed.
3386 if (expand
&& mch_has_wildcard(fname
))
3389 xpc
.xp_context
= EXPAND_FILES
;
3390 expanded_fname
= ExpandOne(&xpc
, (char_u
*)fname
, NULL
,
3391 WILD_LIST_NOTFOUND
|WILD_SILENT
, WILD_EXPAND_FREE
);
3392 if (expanded_fname
!= NULL
)
3393 fname
= expanded_fname
;
3396 if ((p_tr
|| curbuf
->b_help
)
3397 && !vim_isAbsName(fname
)
3398 && (p
= gettail(tag_fname
)) != tag_fname
)
3400 retval
= alloc(MAXPATHL
);
3403 STRCPY(retval
, tag_fname
);
3404 vim_strncpy(retval
+ (p
- tag_fname
), fname
,
3405 MAXPATHL
- (p
- tag_fname
) - 1);
3407 * Translate names like "src/a/../b/file.c" into "src/b/file.c".
3409 simplify_filename(retval
);
3413 retval
= vim_strsave(fname
);
3415 vim_free(expanded_fname
);
3421 * Converts a file name into a canonical form. It simplifies a file name into
3422 * its simplest form by stripping out unneeded components, if any. The
3423 * resulting file name is simplified in place and will either be the same
3424 * length as that supplied, or shorter.
3427 simplify_filename(filename
)
3430 #ifndef AMIGA /* Amiga doesn't have "..", it uses "/" */
3432 char_u
*p
, *tail
, *start
;
3433 int stripping_disabled
= FALSE
;
3434 int relative
= TRUE
;
3437 #ifdef BACKSLASH_IN_FILENAME
3438 if (p
[1] == ':') /* skip "x:" */
3442 if (vim_ispathsep(*p
))
3447 while (vim_ispathsep(*p
));
3449 start
= p
; /* remember start after "c:/" or "/" or "///" */
3453 /* At this point "p" is pointing to the char following a single "/"
3454 * or "p" is at the "start" of the (absolute or relative) path name. */
3456 /* VMS allows device:[path] - don't strip the [ in directory */
3457 if ((*p
== '[' || *p
== '<') && p
> filename
&& p
[-1] == ':')
3459 /* :[ or :< composition: vms directory component */
3461 p
= getnextcomp(p
+ 1);
3463 /* allow remote calls as host"user passwd"::device:[path] */
3464 else if (p
[0] == ':' && p
[1] == ':' && p
> filename
&& p
[-1] == '"' )
3466 /* ":: composition: vms host/passwd component */
3468 p
= getnextcomp(p
+ 2);
3472 if (vim_ispathsep(*p
))
3473 STRMOVE(p
, p
+ 1); /* remove duplicate "/" */
3474 else if (p
[0] == '.' && (vim_ispathsep(p
[1]) || p
[1] == NUL
))
3476 if (p
== start
&& relative
)
3477 p
+= 1 + (p
[1] != NUL
); /* keep single "." or leading "./" */
3480 /* Strip "./" or ".///". If we are at the end of the file name
3481 * and there is no trailing path separator, either strip "/." if
3482 * we are after "start", or strip "." if we are at the beginning
3483 * of an absolute path name . */
3486 while (vim_ispathsep(*tail
))
3489 --p
; /* strip preceding path separator */
3493 else if (p
[0] == '.' && p
[1] == '.' &&
3494 (vim_ispathsep(p
[2]) || p
[2] == NUL
))
3496 /* Skip to after ".." or "../" or "..///". */
3498 while (vim_ispathsep(*tail
))
3501 if (components
> 0) /* strip one preceding component */
3503 int do_strip
= FALSE
;
3507 /* Don't strip for an erroneous file name. */
3508 if (!stripping_disabled
)
3510 /* If the preceding component does not exist in the file
3511 * system, we strip it. On Unix, we don't accept a symbolic
3512 * link that refers to a non-existent file. */
3516 if (mch_lstat((char *)filename
, &st
) < 0)
3518 if (mch_stat((char *)filename
, &st
) < 0)
3524 /* Skip back to after previous '/'. */
3525 while (p
> start
&& !after_pathsep(start
, p
))
3526 mb_ptr_back(start
, p
);
3530 /* If the component exists in the file system, check
3531 * that stripping it won't change the meaning of the
3532 * file name. First get information about the
3533 * unstripped file name. This may fail if the component
3534 * to strip is not a searchable directory (but a regular
3535 * file, for instance), since the trailing "/.." cannot
3536 * be applied then. We don't strip it then since we
3537 * don't want to replace an erroneous file name by
3538 * a valid one, and we disable stripping of later
3542 if (mch_stat((char *)filename
, &st
) >= 0)
3545 stripping_disabled
= TRUE
;
3552 /* On Unix, the check for the unstripped file name
3553 * above works also for a symbolic link pointing to
3554 * a searchable directory. But then the parent of
3555 * the directory pointed to by the link must be the
3556 * same as the stripped file name. (The latter
3557 * exists in the file system since it is the
3558 * component's parent directory.) */
3559 if (p
== start
&& relative
)
3560 (void)mch_stat(".", &new_st
);
3565 (void)mch_stat((char *)filename
, &new_st
);
3569 if (new_st
.st_ino
!= st
.st_ino
||
3570 new_st
.st_dev
!= st
.st_dev
)
3573 /* We don't disable stripping of later
3574 * components since the unstripped path name is
3584 /* Skip the ".." or "../" and reset the counter for the
3585 * components that might be stripped later on. */
3591 /* Strip previous component. If the result would get empty
3592 * and there is no trailing path separator, leave a single
3593 * "." instead. If we are at the end of the file name and
3594 * there is no trailing path separator and a preceding
3595 * component is left after stripping, strip its trailing
3596 * path separator as well. */
3597 if (p
== start
&& relative
&& tail
[-1] == '.')
3604 if (p
> start
&& tail
[-1] == '.')
3606 STRMOVE(p
, tail
); /* strip previous component */
3612 else if (p
== start
&& !relative
) /* leading "/.." or "/../" */
3613 STRMOVE(p
, tail
); /* strip ".." or "../" */
3616 if (p
== start
+ 2 && p
[-2] == '.') /* leading "./../" */
3618 STRMOVE(p
- 2, p
); /* strip leading "./" */
3621 p
= tail
; /* skip to char after ".." or "../" */
3626 ++components
; /* simple path component */
3629 } while (*p
!= NUL
);
3634 * Check if we have a tag for the buffer with name "buf_ffname".
3635 * This is a bit slow, because of the full path compare in fullpathcmp().
3636 * Return TRUE if tag for file "fname" if tag file "tag_fname" is for current
3640 #ifdef FEAT_EMACS_TAGS
3641 test_for_current(is_etag
, fname
, fname_end
, tag_fname
, buf_ffname
)
3644 test_for_current(fname
, fname_end
, tag_fname
, buf_ffname
)
3655 if (buf_ffname
!= NULL
) /* if the buffer has a name */
3657 #ifdef FEAT_EMACS_TAGS
3659 c
= 0; /* to shut up GCC */
3666 fullname
= expand_tag_fname(fname
, tag_fname
, TRUE
);
3667 if (fullname
!= NULL
)
3669 retval
= (fullpathcmp(fullname
, buf_ffname
, TRUE
) & FPC_SAME
);
3672 #ifdef FEAT_EMACS_TAGS
3682 * Find the end of the tagaddress.
3683 * Return OK if ";\"" is following, FAIL otherwise.
3691 /* Repeat for addresses separated with ';' */
3694 if (VIM_ISDIGIT(*str
))
3695 str
= skipdigits(str
);
3696 else if (*str
== '/' || *str
== '?')
3698 str
= skip_regexp(str
+ 1, *str
, FALSE
, NULL
);
3706 if (str
== NULL
|| *str
!= ';'
3707 || !(VIM_ISDIGIT(str
[1]) || str
[1] == '/' || str
[1] == '?'))
3709 ++str
; /* skip ';' */
3712 if (str
!= NULL
&& STRNCMP(str
, ";\"", 2) == 0)
3720 #if defined(FEAT_CMDL_COMPL) || defined(PROTO)
3722 expand_tags(tagnames
, pat
, num_file
, file
)
3723 int tagnames
; /* expand tag names */
3736 tagnmflag
= TAG_NAMES
;
3740 ret
= find_tags(pat
+ 1, num_file
, file
,
3741 TAG_REGEXP
| tagnmflag
| TAG_VERBOSE
,
3742 TAG_MANY
, curbuf
->b_ffname
);
3744 ret
= find_tags(pat
, num_file
, file
,
3745 TAG_REGEXP
| tagnmflag
| TAG_VERBOSE
| TAG_NOIC
,
3746 TAG_MANY
, curbuf
->b_ffname
);
3747 if (ret
== OK
&& !tagnames
)
3749 /* Reorganize the tags for display and matching as strings of:
3750 * "<tagname>\0<kind>\0<filename>\0"
3752 for (i
= 0; i
< *num_file
; i
++)
3754 parse_match((*file
)[i
], &t_p
);
3755 c
= (int)(t_p
.tagname_end
- t_p
.tagname
);
3756 mch_memmove(tagnm
, t_p
.tagname
, (size_t)c
);
3758 tagnm
[c
++] = (t_p
.tagkind
!= NULL
&& *t_p
.tagkind
)
3759 ? *t_p
.tagkind
: 'f';
3761 mch_memmove((*file
)[i
] + c
, t_p
.fname
, t_p
.fname_end
- t_p
.fname
);
3762 (*file
)[i
][c
+ (t_p
.fname_end
- t_p
.fname
)] = 0;
3763 mch_memmove((*file
)[i
], tagnm
, (size_t)c
);
3770 #if defined(FEAT_EVAL) || defined(PROTO)
3771 static int add_tag_field
__ARGS((dict_T
*dict
, char *field_name
, char_u
*start
, char_u
*end
));
3774 * Add a tag field to the dictionary "dict"
3777 add_tag_field(dict
, field_name
, start
, end
)
3780 char_u
*start
; /* start of the value */
3781 char_u
*end
; /* after the value; can be NULL */
3783 char_u buf
[MAXPATHL
];
3790 end
= start
+ STRLEN(start
);
3791 while (end
> start
&& (end
[-1] == '\r' || end
[-1] == '\n'))
3794 len
= (int)(end
- start
);
3795 if (len
> (int)sizeof(buf
) - 1)
3796 len
= sizeof(buf
) - 1;
3797 vim_strncpy(buf
, start
, len
);
3800 return dict_add_nr_str(dict
, field_name
, 0L, buf
);
3804 * Add the tags matching the specified pattern to the list "list"
3812 int num_matches
, i
, ret
;
3813 char_u
**matches
, *p
;
3819 ret
= find_tags(pat
, &num_matches
, &matches
,
3820 TAG_REGEXP
| TAG_NOIC
, (int)MAXCOL
, NULL
);
3821 if (ret
== OK
&& num_matches
> 0)
3823 for (i
= 0; i
< num_matches
; ++i
)
3825 parse_match(matches
[i
], &tp
);
3826 is_static
= test_for_static(&tp
);
3828 /* Skip pseudo-tag lines. */
3829 if (STRNCMP(tp
.tagname
, "!_TAG_", 6) == 0)
3832 if ((dict
= dict_alloc()) == NULL
)
3834 if (list_append_dict(list
, dict
) == FAIL
)
3837 full_fname
= tag_full_fname(&tp
);
3838 if (add_tag_field(dict
, "name", tp
.tagname
, tp
.tagname_end
) == FAIL
3839 || add_tag_field(dict
, "filename", full_fname
,
3841 || add_tag_field(dict
, "cmd", tp
.command
,
3842 tp
.command_end
) == FAIL
3843 || add_tag_field(dict
, "kind", tp
.tagkind
,
3844 tp
.tagkind_end
) == FAIL
3845 || dict_add_nr_str(dict
, "static", is_static
, NULL
) == FAIL
)
3848 vim_free(full_fname
);
3850 if (tp
.command_end
!= NULL
)
3852 for (p
= tp
.command_end
+ 3;
3853 *p
!= NUL
&& *p
!= '\n' && *p
!= '\r'; ++p
)
3855 if (p
== tp
.tagkind
|| (p
+ 5 == tp
.tagkind
3856 && STRNCMP(p
, "kind:", 5) == 0))
3857 /* skip "kind:<kind>" and "<kind>" */
3858 p
= tp
.tagkind_end
- 1;
3859 else if (STRNCMP(p
, "file:", 5) == 0)
3860 /* skip "file:" (static tag) */
3862 else if (!vim_iswhite(*p
))
3867 /* Add extra field as a dict entry. Fields are
3868 * separated by Tabs. */
3870 while (*p
!= NUL
&& *p
>= ' ' && *p
< 127 && *p
!= ':')
3873 if (*p
== ':' && len
> 0)
3876 while (*p
!= NUL
&& *p
>= ' ')
3879 if (add_tag_field(dict
, (char *)n
, s
, p
) == FAIL
)
3884 /* Skip field without colon. */
3885 while (*p
!= NUL
&& *p
>= ' ')
3893 vim_free(matches
[i
]);