xref: /vim-8.2.3635/src/quickfix.c (revision ad52f96a)
1 /* vi:set ts=8 sts=4 sw=4 noet:
2  *
3  * VIM - Vi IMproved	by Bram Moolenaar
4  *
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.
8  */
9 
10 /*
11  * quickfix.c: functions for quickfix mode, using a file with error messages
12  */
13 
14 #include "vim.h"
15 
16 #if defined(FEAT_QUICKFIX) || defined(PROTO)
17 
18 struct dir_stack_T
19 {
20     struct dir_stack_T	*next;
21     char_u		*dirname;
22 };
23 
24 /*
25  * For each error the next struct is allocated and linked in a list.
26  */
27 typedef struct qfline_S qfline_T;
28 struct qfline_S
29 {
30     qfline_T	*qf_next;	// pointer to next error in the list
31     qfline_T	*qf_prev;	// pointer to previous error in the list
32     linenr_T	qf_lnum;	// line number where the error occurred
33     int		qf_fnum;	// file number for the line
34     int		qf_col;		// column where the error occurred
35     int		qf_nr;		// error number
36     char_u	*qf_module;	// module name for this error
37     char_u	*qf_pattern;	// search pattern for the error
38     char_u	*qf_text;	// description of the error
39     char_u	qf_viscol;	// set to TRUE if qf_col is screen column
40     char_u	qf_cleared;	// set to TRUE if line has been deleted
41     char_u	qf_type;	// type of the error (mostly 'E'); 1 for
42 				// :helpgrep
43     char_u	qf_valid;	// valid error message detected
44 };
45 
46 /*
47  * There is a stack of error lists.
48  */
49 #define LISTCOUNT   10
50 #define INVALID_QFIDX (-1)
51 #define INVALID_QFBUFNR (0)
52 
53 /*
54  * Quickfix list type.
55  */
56 typedef enum
57 {
58     QFLT_QUICKFIX, // Quickfix list - global list
59     QFLT_LOCATION, // Location list - per window list
60     QFLT_INTERNAL  // Internal - Temporary list used by getqflist()/getloclist()
61 } qfltype_T;
62 
63 /*
64  * Quickfix/Location list definition
65  * Contains a list of entries (qfline_T). qf_start points to the first entry
66  * and qf_last points to the last entry. qf_count contains the list size.
67  *
68  * Usually the list contains one or more entries. But an empty list can be
69  * created using setqflist()/setloclist() with a title and/or user context
70  * information and entries can be added later using setqflist()/setloclist().
71  */
72 typedef struct qf_list_S
73 {
74     int_u	qf_id;		// Unique identifier for this list
75     qfltype_T	qfl_type;
76     qfline_T	*qf_start;	// pointer to the first error
77     qfline_T	*qf_last;	// pointer to the last error
78     qfline_T	*qf_ptr;	// pointer to the current error
79     int		qf_count;	// number of errors (0 means empty list)
80     int		qf_index;	// current index in the error list
81     int		qf_nonevalid;	// TRUE if not a single valid entry found
82     char_u	*qf_title;	// title derived from the command that created
83 				// the error list or set by setqflist
84     typval_T	*qf_ctx;	// context set by setqflist/setloclist
85     callback_T  qftf_cb;	// 'quickfixtextfunc' callback function
86 
87     struct dir_stack_T	*qf_dir_stack;
88     char_u		*qf_directory;
89     struct dir_stack_T	*qf_file_stack;
90     char_u		*qf_currfile;
91     int			qf_multiline;
92     int			qf_multiignore;
93     int			qf_multiscan;
94     long		qf_changedtick;
95 } qf_list_T;
96 
97 /*
98  * Quickfix/Location list stack definition
99  * Contains a list of quickfix/location lists (qf_list_T)
100  */
101 struct qf_info_S
102 {
103     // Count of references to this list. Used only for location lists.
104     // When a location list window reference this list, qf_refcount
105     // will be 2. Otherwise, qf_refcount will be 1. When qf_refcount
106     // reaches 0, the list is freed.
107     int		qf_refcount;
108     int		qf_listcount;	    // current number of lists
109     int		qf_curlist;	    // current error list
110     qf_list_T	qf_lists[LISTCOUNT];
111     qfltype_T	qfl_type;	    // type of list
112     int		qf_bufnr;	    // quickfix window buffer number
113 };
114 
115 static qf_info_T ql_info;	// global quickfix list
116 static int_u last_qf_id = 0;	// Last used quickfix list id
117 
118 #define FMT_PATTERNS 11		// maximum number of % recognized
119 
120 /*
121  * Structure used to hold the info of one part of 'errorformat'
122  */
123 typedef struct efm_S efm_T;
124 struct efm_S
125 {
126     regprog_T	    *prog;	// pre-formatted part of 'errorformat'
127     efm_T	    *next;	// pointer to next (NULL if last)
128     char_u	    addr[FMT_PATTERNS]; // indices of used % patterns
129     char_u	    prefix;	// prefix of this format line:
130 				//   'D' enter directory
131 				//   'X' leave directory
132 				//   'A' start of multi-line message
133 				//   'E' error message
134 				//   'W' warning message
135 				//   'I' informational message
136 				//   'N' note message
137 				//   'C' continuation line
138 				//   'Z' end of multi-line message
139 				//   'G' general, unspecific message
140 				//   'P' push file (partial) message
141 				//   'Q' pop/quit file (partial) message
142 				//   'O' overread (partial) message
143     char_u	    flags;	// additional flags given in prefix
144 				//   '-' do not include this line
145 				//   '+' include whole line in message
146     int		    conthere;	// %> used
147 };
148 
149 // List of location lists to be deleted.
150 // Used to delay the deletion of locations lists by autocmds.
151 typedef struct qf_delq_S
152 {
153     struct qf_delq_S	*next;
154     qf_info_T		*qi;
155 } qf_delq_T;
156 static qf_delq_T *qf_delq_head = NULL;
157 
158 // Counter to prevent autocmds from freeing up location lists when they are
159 // still being used.
160 static int	quickfix_busy = 0;
161 
162 static efm_T	*fmt_start = NULL; // cached across qf_parse_line() calls
163 
164 // callback function for 'quickfixtextfunc'
165 static callback_T qftf_cb;
166 
167 static void	qf_new_list(qf_info_T *qi, char_u *qf_title);
168 static int	qf_add_entry(qf_list_T *qfl, char_u *dir, char_u *fname, char_u *module, int bufnum, char_u *mesg, long lnum, int col, int vis_col, char_u *pattern, int nr, int type, int valid);
169 static void	qf_free(qf_list_T *qfl);
170 static char_u	*qf_types(int, int);
171 static int	qf_get_fnum(qf_list_T *qfl, char_u *, char_u *);
172 static char_u	*qf_push_dir(char_u *, struct dir_stack_T **, int is_file_stack);
173 static char_u	*qf_pop_dir(struct dir_stack_T **);
174 static char_u	*qf_guess_filepath(qf_list_T *qfl, char_u *);
175 static void	qf_jump_newwin(qf_info_T *qi, int dir, int errornr, int forceit, int newwin);
176 static void	qf_fmt_text(char_u *text, char_u *buf, int bufsize);
177 static int	qf_win_pos_update(qf_info_T *qi, int old_qf_index);
178 static win_T	*qf_find_win(qf_info_T *qi);
179 static buf_T	*qf_find_buf(qf_info_T *qi);
180 static void	qf_update_buffer(qf_info_T *qi, qfline_T *old_last);
181 static void	qf_fill_buffer(qf_list_T *qfl, buf_T *buf, qfline_T *old_last, int qf_winid);
182 static buf_T	*load_dummy_buffer(char_u *fname, char_u *dirname_start, char_u *resulting_dir);
183 static void	wipe_dummy_buffer(buf_T *buf, char_u *dirname_start);
184 static void	unload_dummy_buffer(buf_T *buf, char_u *dirname_start);
185 static qf_info_T *ll_get_or_alloc_list(win_T *);
186 static char_u	*e_no_more_items = (char_u *)N_("E553: No more items");
187 
188 // Quickfix window check helper macro
189 #define IS_QF_WINDOW(wp) (bt_quickfix(wp->w_buffer) && wp->w_llist_ref == NULL)
190 // Location list window check helper macro
191 #define IS_LL_WINDOW(wp) (bt_quickfix(wp->w_buffer) && wp->w_llist_ref != NULL)
192 
193 // Quickfix and location list stack check helper macros
194 #define IS_QF_STACK(qi)		(qi->qfl_type == QFLT_QUICKFIX)
195 #define IS_LL_STACK(qi)		(qi->qfl_type == QFLT_LOCATION)
196 #define IS_QF_LIST(qfl)		(qfl->qfl_type == QFLT_QUICKFIX)
197 #define IS_LL_LIST(qfl)		(qfl->qfl_type == QFLT_LOCATION)
198 
199 /*
200  * Return location list for window 'wp'
201  * For location list window, return the referenced location list
202  */
203 #define GET_LOC_LIST(wp) (IS_LL_WINDOW(wp) ? wp->w_llist_ref : wp->w_llist)
204 
205 // Macro to loop through all the items in a quickfix list
206 // Quickfix item index starts from 1, so i below starts at 1
207 #define FOR_ALL_QFL_ITEMS(qfl, qfp, i) \
208 		    for (i = 1, qfp = qfl->qf_start; \
209 			    !got_int && i <= qfl->qf_count && qfp != NULL; \
210 			    ++i, qfp = qfp->qf_next)
211 
212 /*
213  * Looking up a buffer can be slow if there are many.  Remember the last one
214  * to make this a lot faster if there are multiple matches in the same file.
215  */
216 static char_u   *qf_last_bufname = NULL;
217 static bufref_T  qf_last_bufref = {NULL, 0, 0};
218 
219 static char	*e_current_quickfix_list_was_changed =
220 				 N_("E925: Current quickfix list was changed");
221 static char	*e_current_location_list_was_changed =
222 				 N_("E926: Current location list was changed");
223 
224 /*
225  * Maximum number of bytes allowed per line while reading a errorfile.
226  */
227 #define LINE_MAXLEN 4096
228 
229 static struct fmtpattern
230 {
231     char_u	convchar;
232     char	*pattern;
233 } fmt_pat[FMT_PATTERNS] =
234     {
235 	{'f', ".\\+"},	    // only used when at end
236 	{'n', "\\d\\+"},
237 	{'l', "\\d\\+"},
238 	{'c', "\\d\\+"},
239 	{'t', "."},
240 	{'m', ".\\+"},
241 	{'r', ".*"},
242 	{'p', "[- 	.]*"},
243 	{'v', "\\d\\+"},
244 	{'s', ".\\+"},
245 	{'o', ".\\+"}
246     };
247 
248 /*
249  * Convert an errorformat pattern to a regular expression pattern.
250  * See fmt_pat definition above for the list of supported patterns.  The
251  * pattern specifier is supplied in "efmpat".  The converted pattern is stored
252  * in "regpat".  Returns a pointer to the location after the pattern.
253  */
254     static char_u *
255 efmpat_to_regpat(
256 	char_u	*efmpat,
257 	char_u	*regpat,
258 	efm_T	*efminfo,
259 	int	idx,
260 	int	round)
261 {
262     char_u	*srcptr;
263 
264     if (efminfo->addr[idx])
265     {
266 	// Each errorformat pattern can occur only once
267 	semsg(_("E372: Too many %%%c in format string"), *efmpat);
268 	return NULL;
269     }
270     if ((idx && idx < 6
271 		&& vim_strchr((char_u *)"DXOPQ", efminfo->prefix) != NULL)
272 	    || (idx == 6
273 		&& vim_strchr((char_u *)"OPQ", efminfo->prefix) == NULL))
274     {
275 	semsg(_("E373: Unexpected %%%c in format string"), *efmpat);
276 	return NULL;
277     }
278     efminfo->addr[idx] = (char_u)++round;
279     *regpat++ = '\\';
280     *regpat++ = '(';
281 #ifdef BACKSLASH_IN_FILENAME
282     if (*efmpat == 'f')
283     {
284 	// Also match "c:" in the file name, even when
285 	// checking for a colon next: "%f:".
286 	// "\%(\a:\)\="
287 	STRCPY(regpat, "\\%(\\a:\\)\\=");
288 	regpat += 10;
289     }
290 #endif
291     if (*efmpat == 'f' && efmpat[1] != NUL)
292     {
293 	if (efmpat[1] != '\\' && efmpat[1] != '%')
294 	{
295 	    // A file name may contain spaces, but this isn't
296 	    // in "\f".  For "%f:%l:%m" there may be a ":" in
297 	    // the file name.  Use ".\{-1,}x" instead (x is
298 	    // the next character), the requirement that :999:
299 	    // follows should work.
300 	    STRCPY(regpat, ".\\{-1,}");
301 	    regpat += 7;
302 	}
303 	else
304 	{
305 	    // File name followed by '\\' or '%': include as
306 	    // many file name chars as possible.
307 	    STRCPY(regpat, "\\f\\+");
308 	    regpat += 4;
309 	}
310     }
311     else
312     {
313 	srcptr = (char_u *)fmt_pat[idx].pattern;
314 	while ((*regpat = *srcptr++) != NUL)
315 	    ++regpat;
316     }
317     *regpat++ = '\\';
318     *regpat++ = ')';
319 
320     return regpat;
321 }
322 
323 /*
324  * Convert a scanf like format in 'errorformat' to a regular expression.
325  * Returns a pointer to the location after the pattern.
326  */
327     static char_u *
328 scanf_fmt_to_regpat(
329 	char_u	**pefmp,
330 	char_u	*efm,
331 	int	len,
332 	char_u	*regpat)
333 {
334     char_u	*efmp = *pefmp;
335 
336     if (*efmp == '[' || *efmp == '\\')
337     {
338 	if ((*regpat++ = *efmp) == '[')	// %*[^a-z0-9] etc.
339 	{
340 	    if (efmp[1] == '^')
341 		*regpat++ = *++efmp;
342 	    if (efmp < efm + len)
343 	    {
344 		*regpat++ = *++efmp;	    // could be ']'
345 		while (efmp < efm + len
346 			&& (*regpat++ = *++efmp) != ']')
347 		    // skip ;
348 		if (efmp == efm + len)
349 		{
350 		    emsg(_("E374: Missing ] in format string"));
351 		    return NULL;
352 		}
353 	    }
354 	}
355 	else if (efmp < efm + len)	// %*\D, %*\s etc.
356 	    *regpat++ = *++efmp;
357 	*regpat++ = '\\';
358 	*regpat++ = '+';
359     }
360     else
361     {
362 	// TODO: scanf()-like: %*ud, %*3c, %*f, ... ?
363 	semsg(_("E375: Unsupported %%%c in format string"), *efmp);
364 	return NULL;
365     }
366 
367     *pefmp = efmp;
368 
369     return regpat;
370 }
371 
372 /*
373  * Analyze/parse an errorformat prefix.
374  */
375     static char_u *
376 efm_analyze_prefix(char_u *efmp, efm_T *efminfo)
377 {
378     if (vim_strchr((char_u *)"+-", *efmp) != NULL)
379 	efminfo->flags = *efmp++;
380     if (vim_strchr((char_u *)"DXAEWINCZGOPQ", *efmp) != NULL)
381 	efminfo->prefix = *efmp;
382     else
383     {
384 	semsg(_("E376: Invalid %%%c in format string prefix"), *efmp);
385 	return NULL;
386     }
387 
388     return efmp;
389 }
390 
391 /*
392  * Converts a 'errorformat' string part in 'efm' to a regular expression
393  * pattern.  The resulting regex pattern is returned in "regpat". Additional
394  * information about the 'erroformat' pattern is returned in "fmt_ptr".
395  * Returns OK or FAIL.
396  */
397     static int
398 efm_to_regpat(
399 	char_u	*efm,
400 	int	len,
401 	efm_T	*fmt_ptr,
402 	char_u	*regpat)
403 {
404     char_u	*ptr;
405     char_u	*efmp;
406     int		round;
407     int		idx = 0;
408 
409     // Build a regexp pattern for a 'errorformat' option part
410     ptr = regpat;
411     *ptr++ = '^';
412     round = 0;
413     for (efmp = efm; efmp < efm + len; ++efmp)
414     {
415 	if (*efmp == '%')
416 	{
417 	    ++efmp;
418 	    for (idx = 0; idx < FMT_PATTERNS; ++idx)
419 		if (fmt_pat[idx].convchar == *efmp)
420 		    break;
421 	    if (idx < FMT_PATTERNS)
422 	    {
423 		ptr = efmpat_to_regpat(efmp, ptr, fmt_ptr, idx, round);
424 		if (ptr == NULL)
425 		    return FAIL;
426 		round++;
427 	    }
428 	    else if (*efmp == '*')
429 	    {
430 		++efmp;
431 		ptr = scanf_fmt_to_regpat(&efmp, efm, len, ptr);
432 		if (ptr == NULL)
433 		    return FAIL;
434 	    }
435 	    else if (vim_strchr((char_u *)"%\\.^$~[", *efmp) != NULL)
436 		*ptr++ = *efmp;		// regexp magic characters
437 	    else if (*efmp == '#')
438 		*ptr++ = '*';
439 	    else if (*efmp == '>')
440 		fmt_ptr->conthere = TRUE;
441 	    else if (efmp == efm + 1)		// analyse prefix
442 	    {
443 		// prefix is allowed only at the beginning of the errorformat
444 		// option part
445 		efmp = efm_analyze_prefix(efmp, fmt_ptr);
446 		if (efmp == NULL)
447 		    return FAIL;
448 	    }
449 	    else
450 	    {
451 		semsg(_("E377: Invalid %%%c in format string"), *efmp);
452 		return FAIL;
453 	    }
454 	}
455 	else			// copy normal character
456 	{
457 	    if (*efmp == '\\' && efmp + 1 < efm + len)
458 		++efmp;
459 	    else if (vim_strchr((char_u *)".*^$~[", *efmp) != NULL)
460 		*ptr++ = '\\';	// escape regexp atoms
461 	    if (*efmp)
462 		*ptr++ = *efmp;
463 	}
464     }
465     *ptr++ = '$';
466     *ptr = NUL;
467 
468     return OK;
469 }
470 
471 /*
472  * Free the 'errorformat' information list
473  */
474     static void
475 free_efm_list(efm_T **efm_first)
476 {
477     efm_T *efm_ptr;
478 
479     for (efm_ptr = *efm_first; efm_ptr != NULL; efm_ptr = *efm_first)
480     {
481 	*efm_first = efm_ptr->next;
482 	vim_regfree(efm_ptr->prog);
483 	vim_free(efm_ptr);
484     }
485     fmt_start = NULL;
486 }
487 
488 /*
489  * Compute the size of the buffer used to convert a 'errorformat' pattern into
490  * a regular expression pattern.
491  */
492     static int
493 efm_regpat_bufsz(char_u *efm)
494 {
495     int sz;
496     int i;
497 
498     sz = (FMT_PATTERNS * 3) + ((int)STRLEN(efm) << 2);
499     for (i = FMT_PATTERNS; i > 0; )
500 	sz += (int)STRLEN(fmt_pat[--i].pattern);
501 #ifdef BACKSLASH_IN_FILENAME
502     sz += 12; // "%f" can become twelve chars longer (see efm_to_regpat)
503 #else
504     sz += 2; // "%f" can become two chars longer
505 #endif
506 
507     return sz;
508 }
509 
510 /*
511  * Return the length of a 'errorformat' option part (separated by ",").
512  */
513     static int
514 efm_option_part_len(char_u *efm)
515 {
516     int len;
517 
518     for (len = 0; efm[len] != NUL && efm[len] != ','; ++len)
519 	if (efm[len] == '\\' && efm[len + 1] != NUL)
520 	    ++len;
521 
522     return len;
523 }
524 
525 /*
526  * Parse the 'errorformat' option. Multiple parts in the 'errorformat' option
527  * are parsed and converted to regular expressions. Returns information about
528  * the parsed 'errorformat' option.
529  */
530     static efm_T *
531 parse_efm_option(char_u *efm)
532 {
533     efm_T	*fmt_ptr = NULL;
534     efm_T	*fmt_first = NULL;
535     efm_T	*fmt_last = NULL;
536     char_u	*fmtstr = NULL;
537     int		len;
538     int		sz;
539 
540     // Each part of the format string is copied and modified from errorformat
541     // to regex prog.  Only a few % characters are allowed.
542 
543     // Get some space to modify the format string into.
544     sz = efm_regpat_bufsz(efm);
545     if ((fmtstr = alloc(sz)) == NULL)
546 	goto parse_efm_error;
547 
548     while (efm[0] != NUL)
549     {
550 	// Allocate a new eformat structure and put it at the end of the list
551 	fmt_ptr = ALLOC_CLEAR_ONE(efm_T);
552 	if (fmt_ptr == NULL)
553 	    goto parse_efm_error;
554 	if (fmt_first == NULL)	    // first one
555 	    fmt_first = fmt_ptr;
556 	else
557 	    fmt_last->next = fmt_ptr;
558 	fmt_last = fmt_ptr;
559 
560 	// Isolate one part in the 'errorformat' option
561 	len = efm_option_part_len(efm);
562 
563 	if (efm_to_regpat(efm, len, fmt_ptr, fmtstr) == FAIL)
564 	    goto parse_efm_error;
565 	if ((fmt_ptr->prog = vim_regcomp(fmtstr, RE_MAGIC + RE_STRING)) == NULL)
566 	    goto parse_efm_error;
567 	// Advance to next part
568 	efm = skip_to_option_part(efm + len);	// skip comma and spaces
569     }
570 
571     if (fmt_first == NULL)	// nothing found
572 	emsg(_("E378: 'errorformat' contains no pattern"));
573 
574     goto parse_efm_end;
575 
576 parse_efm_error:
577     free_efm_list(&fmt_first);
578 
579 parse_efm_end:
580     vim_free(fmtstr);
581 
582     return fmt_first;
583 }
584 
585 enum {
586     QF_FAIL = 0,
587     QF_OK = 1,
588     QF_END_OF_INPUT = 2,
589     QF_NOMEM = 3,
590     QF_IGNORE_LINE = 4,
591     QF_MULTISCAN = 5,
592 };
593 
594 /*
595  * State information used to parse lines and add entries to a quickfix/location
596  * list.
597  */
598 typedef struct {
599     char_u	*linebuf;
600     int		linelen;
601     char_u	*growbuf;
602     int		growbufsiz;
603     FILE	*fd;
604     typval_T	*tv;
605     char_u	*p_str;
606     listitem_T	*p_li;
607     buf_T	*buf;
608     linenr_T	buflnum;
609     linenr_T	lnumlast;
610     vimconv_T	vc;
611 } qfstate_T;
612 
613 /*
614  * Allocate more memory for the line buffer used for parsing lines.
615  */
616     static char_u *
617 qf_grow_linebuf(qfstate_T *state, int newsz)
618 {
619     char_u	*p;
620 
621     // If the line exceeds LINE_MAXLEN exclude the last
622     // byte since it's not a NL character.
623     state->linelen = newsz > LINE_MAXLEN ? LINE_MAXLEN - 1 : newsz;
624     if (state->growbuf == NULL)
625     {
626 	state->growbuf = alloc(state->linelen + 1);
627 	if (state->growbuf == NULL)
628 	    return NULL;
629 	state->growbufsiz = state->linelen;
630     }
631     else if (state->linelen > state->growbufsiz)
632     {
633 	if ((p = vim_realloc(state->growbuf, state->linelen + 1)) == NULL)
634 	    return NULL;
635 	state->growbuf = p;
636 	state->growbufsiz = state->linelen;
637     }
638     return state->growbuf;
639 }
640 
641 /*
642  * Get the next string (separated by newline) from state->p_str.
643  */
644     static int
645 qf_get_next_str_line(qfstate_T *state)
646 {
647     // Get the next line from the supplied string
648     char_u	*p_str = state->p_str;
649     char_u	*p;
650     int		len;
651 
652     if (*p_str == NUL) // Reached the end of the string
653 	return QF_END_OF_INPUT;
654 
655     p = vim_strchr(p_str, '\n');
656     if (p != NULL)
657 	len = (int)(p - p_str) + 1;
658     else
659 	len = (int)STRLEN(p_str);
660 
661     if (len > IOSIZE - 2)
662     {
663 	state->linebuf = qf_grow_linebuf(state, len);
664 	if (state->linebuf == NULL)
665 	    return QF_NOMEM;
666     }
667     else
668     {
669 	state->linebuf = IObuff;
670 	state->linelen = len;
671     }
672     vim_strncpy(state->linebuf, p_str, state->linelen);
673 
674     // Increment using len in order to discard the rest of the
675     // line if it exceeds LINE_MAXLEN.
676     p_str += len;
677     state->p_str = p_str;
678 
679     return QF_OK;
680 }
681 
682 /*
683  * Get the next string from state->p_Li.
684  */
685     static int
686 qf_get_next_list_line(qfstate_T *state)
687 {
688     listitem_T	*p_li = state->p_li;
689     int		len;
690 
691     while (p_li != NULL
692 	    && (p_li->li_tv.v_type != VAR_STRING
693 		|| p_li->li_tv.vval.v_string == NULL))
694 	p_li = p_li->li_next;	// Skip non-string items
695 
696     if (p_li == NULL)		// End of the list
697     {
698 	state->p_li = NULL;
699 	return QF_END_OF_INPUT;
700     }
701 
702     len = (int)STRLEN(p_li->li_tv.vval.v_string);
703     if (len > IOSIZE - 2)
704     {
705 	state->linebuf = qf_grow_linebuf(state, len);
706 	if (state->linebuf == NULL)
707 	    return QF_NOMEM;
708     }
709     else
710     {
711 	state->linebuf = IObuff;
712 	state->linelen = len;
713     }
714 
715     vim_strncpy(state->linebuf, p_li->li_tv.vval.v_string, state->linelen);
716 
717     state->p_li = p_li->li_next;	// next item
718     return QF_OK;
719 }
720 
721 /*
722  * Get the next string from state->buf.
723  */
724     static int
725 qf_get_next_buf_line(qfstate_T *state)
726 {
727     char_u	*p_buf = NULL;
728     int		len;
729 
730     // Get the next line from the supplied buffer
731     if (state->buflnum > state->lnumlast)
732 	return QF_END_OF_INPUT;
733 
734     p_buf = ml_get_buf(state->buf, state->buflnum, FALSE);
735     state->buflnum += 1;
736 
737     len = (int)STRLEN(p_buf);
738     if (len > IOSIZE - 2)
739     {
740 	state->linebuf = qf_grow_linebuf(state, len);
741 	if (state->linebuf == NULL)
742 	    return QF_NOMEM;
743     }
744     else
745     {
746 	state->linebuf = IObuff;
747 	state->linelen = len;
748     }
749     vim_strncpy(state->linebuf, p_buf, state->linelen);
750 
751     return QF_OK;
752 }
753 
754 /*
755  * Get the next string from file state->fd.
756  */
757     static int
758 qf_get_next_file_line(qfstate_T *state)
759 {
760     int	    discard;
761     int	    growbuflen;
762 
763     if (fgets((char *)IObuff, IOSIZE, state->fd) == NULL)
764 	return QF_END_OF_INPUT;
765 
766     discard = FALSE;
767     state->linelen = (int)STRLEN(IObuff);
768     if (state->linelen == IOSIZE - 1 && !(IObuff[state->linelen - 1] == '\n'))
769     {
770 	// The current line exceeds IObuff, continue reading using
771 	// growbuf until EOL or LINE_MAXLEN bytes is read.
772 	if (state->growbuf == NULL)
773 	{
774 	    state->growbufsiz = 2 * (IOSIZE - 1);
775 	    state->growbuf = alloc(state->growbufsiz);
776 	    if (state->growbuf == NULL)
777 		return QF_NOMEM;
778 	}
779 
780 	// Copy the read part of the line, excluding null-terminator
781 	memcpy(state->growbuf, IObuff, IOSIZE - 1);
782 	growbuflen = state->linelen;
783 
784 	for (;;)
785 	{
786 	    char_u	*p;
787 
788 	    if (fgets((char *)state->growbuf + growbuflen,
789 			state->growbufsiz - growbuflen, state->fd) == NULL)
790 		break;
791 	    state->linelen = (int)STRLEN(state->growbuf + growbuflen);
792 	    growbuflen += state->linelen;
793 	    if ((state->growbuf)[growbuflen - 1] == '\n')
794 		break;
795 	    if (state->growbufsiz == LINE_MAXLEN)
796 	    {
797 		discard = TRUE;
798 		break;
799 	    }
800 
801 	    state->growbufsiz = 2 * state->growbufsiz < LINE_MAXLEN
802 		? 2 * state->growbufsiz : LINE_MAXLEN;
803 	    if ((p = vim_realloc(state->growbuf, state->growbufsiz)) == NULL)
804 		return QF_NOMEM;
805 	    state->growbuf = p;
806 	}
807 
808 	while (discard)
809 	{
810 	    // The current line is longer than LINE_MAXLEN, continue
811 	    // reading but discard everything until EOL or EOF is
812 	    // reached.
813 	    if (fgets((char *)IObuff, IOSIZE, state->fd) == NULL
814 		    || (int)STRLEN(IObuff) < IOSIZE - 1
815 		    || IObuff[IOSIZE - 2] == '\n')
816 		break;
817 	}
818 
819 	state->linebuf = state->growbuf;
820 	state->linelen = growbuflen;
821     }
822     else
823 	state->linebuf = IObuff;
824 
825     // Convert a line if it contains a non-ASCII character.
826     if (state->vc.vc_type != CONV_NONE && has_non_ascii(state->linebuf))
827     {
828 	char_u	*line;
829 
830 	line = string_convert(&state->vc, state->linebuf, &state->linelen);
831 	if (line != NULL)
832 	{
833 	    if (state->linelen < IOSIZE)
834 	    {
835 		STRCPY(state->linebuf, line);
836 		vim_free(line);
837 	    }
838 	    else
839 	    {
840 		vim_free(state->growbuf);
841 		state->linebuf = state->growbuf = line;
842 		state->growbufsiz = state->linelen < LINE_MAXLEN
843 						? state->linelen : LINE_MAXLEN;
844 	    }
845 	}
846     }
847 
848     return QF_OK;
849 }
850 
851 /*
852  * Get the next string from a file/buffer/list/string.
853  */
854     static int
855 qf_get_nextline(qfstate_T *state)
856 {
857     int status = QF_FAIL;
858 
859     if (state->fd == NULL)
860     {
861 	if (state->tv != NULL)
862 	{
863 	    if (state->tv->v_type == VAR_STRING)
864 		// Get the next line from the supplied string
865 		status = qf_get_next_str_line(state);
866 	    else if (state->tv->v_type == VAR_LIST)
867 		// Get the next line from the supplied list
868 		status = qf_get_next_list_line(state);
869 	}
870 	else
871 	    // Get the next line from the supplied buffer
872 	    status = qf_get_next_buf_line(state);
873     }
874     else
875 	// Get the next line from the supplied file
876 	status = qf_get_next_file_line(state);
877 
878     if (status != QF_OK)
879 	return status;
880 
881     // remove newline/CR from the line
882     if (state->linelen > 0 && state->linebuf[state->linelen - 1] == '\n')
883     {
884 	state->linebuf[state->linelen - 1] = NUL;
885 #ifdef USE_CRNL
886 	if (state->linelen > 1 && state->linebuf[state->linelen - 2] == '\r')
887 	    state->linebuf[state->linelen - 2] = NUL;
888 #endif
889     }
890 
891     remove_bom(state->linebuf);
892 
893     return QF_OK;
894 }
895 
896 typedef struct {
897     char_u	*namebuf;
898     char_u	*module;
899     char_u	*errmsg;
900     int		errmsglen;
901     long	lnum;
902     int		col;
903     char_u	use_viscol;
904     char_u	*pattern;
905     int		enr;
906     int		type;
907     int		valid;
908 } qffields_T;
909 
910 /*
911  * Parse the match for filename ('%f') pattern in regmatch.
912  * Return the matched value in "fields->namebuf".
913  */
914     static int
915 qf_parse_fmt_f(regmatch_T *rmp, int midx, qffields_T *fields, int prefix)
916 {
917     int c;
918 
919     if (rmp->startp[midx] == NULL || rmp->endp[midx] == NULL)
920 	return QF_FAIL;
921 
922     // Expand ~/file and $HOME/file to full path.
923     c = *rmp->endp[midx];
924     *rmp->endp[midx] = NUL;
925     expand_env(rmp->startp[midx], fields->namebuf, CMDBUFFSIZE);
926     *rmp->endp[midx] = c;
927 
928     // For separate filename patterns (%O, %P and %Q), the specified file
929     // should exist.
930     if (vim_strchr((char_u *)"OPQ", prefix) != NULL
931 	    && mch_getperm(fields->namebuf) == -1)
932 	return QF_FAIL;
933 
934     return QF_OK;
935 }
936 
937 /*
938  * Parse the match for error number ('%n') pattern in regmatch.
939  * Return the matched value in "fields->enr".
940  */
941     static int
942 qf_parse_fmt_n(regmatch_T *rmp, int midx, qffields_T *fields)
943 {
944     if (rmp->startp[midx] == NULL)
945 	return QF_FAIL;
946     fields->enr = (int)atol((char *)rmp->startp[midx]);
947     return QF_OK;
948 }
949 
950 /*
951  * Parse the match for line number (%l') pattern in regmatch.
952  * Return the matched value in "fields->lnum".
953  */
954     static int
955 qf_parse_fmt_l(regmatch_T *rmp, int midx, qffields_T *fields)
956 {
957     if (rmp->startp[midx] == NULL)
958 	return QF_FAIL;
959     fields->lnum = atol((char *)rmp->startp[midx]);
960     return QF_OK;
961 }
962 
963 /*
964  * Parse the match for column number ('%c') pattern in regmatch.
965  * Return the matched value in "fields->col".
966  */
967     static int
968 qf_parse_fmt_c(regmatch_T *rmp, int midx, qffields_T *fields)
969 {
970     if (rmp->startp[midx] == NULL)
971 	return QF_FAIL;
972     fields->col = (int)atol((char *)rmp->startp[midx]);
973     return QF_OK;
974 }
975 
976 /*
977  * Parse the match for error type ('%t') pattern in regmatch.
978  * Return the matched value in "fields->type".
979  */
980     static int
981 qf_parse_fmt_t(regmatch_T *rmp, int midx, qffields_T *fields)
982 {
983     if (rmp->startp[midx] == NULL)
984 	return QF_FAIL;
985     fields->type = *rmp->startp[midx];
986     return QF_OK;
987 }
988 
989 /*
990  * Copy a non-error line into the error string.  Return the matched line in
991  * "fields->errmsg".
992  */
993     static int
994 copy_nonerror_line(char_u *linebuf, int linelen, qffields_T *fields)
995 {
996     char_u	*p;
997 
998     if (linelen >= fields->errmsglen)
999     {
1000 	// linelen + null terminator
1001 	if ((p = vim_realloc(fields->errmsg, linelen + 1)) == NULL)
1002 	    return QF_NOMEM;
1003 	fields->errmsg = p;
1004 	fields->errmsglen = linelen + 1;
1005     }
1006     // copy whole line to error message
1007     vim_strncpy(fields->errmsg, linebuf, linelen);
1008 
1009     return QF_OK;
1010 }
1011 
1012 /*
1013  * Parse the match for error message ('%m') pattern in regmatch.
1014  * Return the matched value in "fields->errmsg".
1015  */
1016     static int
1017 qf_parse_fmt_m(regmatch_T *rmp, int midx, qffields_T *fields)
1018 {
1019     char_u	*p;
1020     int		len;
1021 
1022     if (rmp->startp[midx] == NULL || rmp->endp[midx] == NULL)
1023 	return QF_FAIL;
1024     len = (int)(rmp->endp[midx] - rmp->startp[midx]);
1025     if (len >= fields->errmsglen)
1026     {
1027 	// len + null terminator
1028 	if ((p = vim_realloc(fields->errmsg, len + 1)) == NULL)
1029 	    return QF_NOMEM;
1030 	fields->errmsg = p;
1031 	fields->errmsglen = len + 1;
1032     }
1033     vim_strncpy(fields->errmsg, rmp->startp[midx], len);
1034     return QF_OK;
1035 }
1036 
1037 /*
1038  * Parse the match for rest of a single-line file message ('%r') pattern.
1039  * Return the matched value in "tail".
1040  */
1041     static int
1042 qf_parse_fmt_r(regmatch_T *rmp, int midx, char_u **tail)
1043 {
1044     if (rmp->startp[midx] == NULL)
1045 	return QF_FAIL;
1046     *tail = rmp->startp[midx];
1047     return QF_OK;
1048 }
1049 
1050 /*
1051  * Parse the match for the pointer line ('%p') pattern in regmatch.
1052  * Return the matched value in "fields->col".
1053  */
1054     static int
1055 qf_parse_fmt_p(regmatch_T *rmp, int midx, qffields_T *fields)
1056 {
1057     char_u	*match_ptr;
1058 
1059     if (rmp->startp[midx] == NULL || rmp->endp[midx] == NULL)
1060 	return QF_FAIL;
1061     fields->col = 0;
1062     for (match_ptr = rmp->startp[midx]; match_ptr != rmp->endp[midx];
1063 								++match_ptr)
1064     {
1065 	++fields->col;
1066 	if (*match_ptr == TAB)
1067 	{
1068 	    fields->col += 7;
1069 	    fields->col -= fields->col % 8;
1070 	}
1071     }
1072     ++fields->col;
1073     fields->use_viscol = TRUE;
1074     return QF_OK;
1075 }
1076 
1077 /*
1078  * Parse the match for the virtual column number ('%v') pattern in regmatch.
1079  * Return the matched value in "fields->col".
1080  */
1081     static int
1082 qf_parse_fmt_v(regmatch_T *rmp, int midx, qffields_T *fields)
1083 {
1084     if (rmp->startp[midx] == NULL)
1085 	return QF_FAIL;
1086     fields->col = (int)atol((char *)rmp->startp[midx]);
1087     fields->use_viscol = TRUE;
1088     return QF_OK;
1089 }
1090 
1091 /*
1092  * Parse the match for the search text ('%s') pattern in regmatch.
1093  * Return the matched value in "fields->pattern".
1094  */
1095     static int
1096 qf_parse_fmt_s(regmatch_T *rmp, int midx, qffields_T *fields)
1097 {
1098     int		len;
1099 
1100     if (rmp->startp[midx] == NULL || rmp->endp[midx] == NULL)
1101 	return QF_FAIL;
1102     len = (int)(rmp->endp[midx] - rmp->startp[midx]);
1103     if (len > CMDBUFFSIZE - 5)
1104 	len = CMDBUFFSIZE - 5;
1105     STRCPY(fields->pattern, "^\\V");
1106     STRNCAT(fields->pattern, rmp->startp[midx], len);
1107     fields->pattern[len + 3] = '\\';
1108     fields->pattern[len + 4] = '$';
1109     fields->pattern[len + 5] = NUL;
1110     return QF_OK;
1111 }
1112 
1113 /*
1114  * Parse the match for the module ('%o') pattern in regmatch.
1115  * Return the matched value in "fields->module".
1116  */
1117     static int
1118 qf_parse_fmt_o(regmatch_T *rmp, int midx, qffields_T *fields)
1119 {
1120     int		len;
1121 
1122     if (rmp->startp[midx] == NULL || rmp->endp[midx] == NULL)
1123 	return QF_FAIL;
1124     len = (int)(rmp->endp[midx] - rmp->startp[midx]);
1125     if (len > CMDBUFFSIZE)
1126 	len = CMDBUFFSIZE;
1127     STRNCAT(fields->module, rmp->startp[midx], len);
1128     return QF_OK;
1129 }
1130 
1131 /*
1132  * 'errorformat' format pattern parser functions.
1133  * The '%f' and '%r' formats are parsed differently from other formats.
1134  * See qf_parse_match() for details.
1135  */
1136 static int (*qf_parse_fmt[FMT_PATTERNS])(regmatch_T *, int, qffields_T *) =
1137 {
1138     NULL,
1139     qf_parse_fmt_n,
1140     qf_parse_fmt_l,
1141     qf_parse_fmt_c,
1142     qf_parse_fmt_t,
1143     qf_parse_fmt_m,
1144     NULL,
1145     qf_parse_fmt_p,
1146     qf_parse_fmt_v,
1147     qf_parse_fmt_s,
1148     qf_parse_fmt_o
1149 };
1150 
1151 /*
1152  * Parse the error format pattern matches in "regmatch" and set the values in
1153  * "fields".  fmt_ptr contains the 'efm' format specifiers/prefixes that have a
1154  * match.  Returns QF_OK if all the matches are successfully parsed. On
1155  * failure, returns QF_FAIL or QF_NOMEM.
1156  */
1157     static int
1158 qf_parse_match(
1159 	char_u		*linebuf,
1160 	int		linelen,
1161 	efm_T		*fmt_ptr,
1162 	regmatch_T	*regmatch,
1163 	qffields_T	*fields,
1164 	int		qf_multiline,
1165 	int		qf_multiscan,
1166 	char_u		**tail)
1167 {
1168     int		idx = fmt_ptr->prefix;
1169     int		i;
1170     int		midx;
1171     int		status;
1172 
1173     if ((idx == 'C' || idx == 'Z') && !qf_multiline)
1174 	return QF_FAIL;
1175     if (vim_strchr((char_u *)"EWIN", idx) != NULL)
1176 	fields->type = idx;
1177     else
1178 	fields->type = 0;
1179 
1180     // Extract error message data from matched line.
1181     // We check for an actual submatch, because "\[" and "\]" in
1182     // the 'errorformat' may cause the wrong submatch to be used.
1183     for (i = 0; i < FMT_PATTERNS; i++)
1184     {
1185 	status = QF_OK;
1186 	midx = (int)fmt_ptr->addr[i];
1187 	if (i == 0 && midx > 0)				// %f
1188 	    status = qf_parse_fmt_f(regmatch, midx, fields, idx);
1189 	else if (i == 5)
1190 	{
1191 	    if (fmt_ptr->flags == '+' && !qf_multiscan)	// %+
1192 		status = copy_nonerror_line(linebuf, linelen, fields);
1193 	    else if (midx > 0)				// %m
1194 		status = qf_parse_fmt_m(regmatch, midx, fields);
1195 	}
1196 	else if (i == 6 && midx > 0)			// %r
1197 	    status = qf_parse_fmt_r(regmatch, midx, tail);
1198 	else if (midx > 0)				// others
1199 	    status = (qf_parse_fmt[i])(regmatch, midx, fields);
1200 
1201 	if (status != QF_OK)
1202 	    return status;
1203     }
1204 
1205     return QF_OK;
1206 }
1207 
1208 /*
1209  * Parse an error line in 'linebuf' using a single error format string in
1210  * 'fmt_ptr->prog' and return the matching values in 'fields'.
1211  * Returns QF_OK if the efm format matches completely and the fields are
1212  * successfully copied. Otherwise returns QF_FAIL or QF_NOMEM.
1213  */
1214     static int
1215 qf_parse_get_fields(
1216 	char_u		*linebuf,
1217 	int		linelen,
1218 	efm_T		*fmt_ptr,
1219 	qffields_T	*fields,
1220 	int		qf_multiline,
1221 	int		qf_multiscan,
1222 	char_u		**tail)
1223 {
1224     regmatch_T	regmatch;
1225     int		status = QF_FAIL;
1226     int		r;
1227 
1228     if (qf_multiscan &&
1229 		vim_strchr((char_u *)"OPQ", fmt_ptr->prefix) == NULL)
1230 	return QF_FAIL;
1231 
1232     fields->namebuf[0] = NUL;
1233     fields->module[0] = NUL;
1234     fields->pattern[0] = NUL;
1235     if (!qf_multiscan)
1236 	fields->errmsg[0] = NUL;
1237     fields->lnum = 0;
1238     fields->col = 0;
1239     fields->use_viscol = FALSE;
1240     fields->enr = -1;
1241     fields->type = 0;
1242     *tail = NULL;
1243 
1244     // Always ignore case when looking for a matching error.
1245     regmatch.rm_ic = TRUE;
1246     regmatch.regprog = fmt_ptr->prog;
1247     r = vim_regexec(&regmatch, linebuf, (colnr_T)0);
1248     fmt_ptr->prog = regmatch.regprog;
1249     if (r)
1250 	status = qf_parse_match(linebuf, linelen, fmt_ptr, &regmatch,
1251 		fields, qf_multiline, qf_multiscan, tail);
1252 
1253     return status;
1254 }
1255 
1256 /*
1257  * Parse directory error format prefixes (%D and %X).
1258  * Push and pop directories from the directory stack when scanning directory
1259  * names.
1260  */
1261     static int
1262 qf_parse_dir_pfx(int idx, qffields_T *fields, qf_list_T *qfl)
1263 {
1264     if (idx == 'D')				// enter directory
1265     {
1266 	if (*fields->namebuf == NUL)
1267 	{
1268 	    emsg(_("E379: Missing or empty directory name"));
1269 	    return QF_FAIL;
1270 	}
1271 	qfl->qf_directory =
1272 	    qf_push_dir(fields->namebuf, &qfl->qf_dir_stack, FALSE);
1273 	if (qfl->qf_directory == NULL)
1274 	    return QF_FAIL;
1275     }
1276     else if (idx == 'X')			// leave directory
1277 	qfl->qf_directory = qf_pop_dir(&qfl->qf_dir_stack);
1278 
1279     return QF_OK;
1280 }
1281 
1282 /*
1283  * Parse global file name error format prefixes (%O, %P and %Q).
1284  */
1285     static int
1286 qf_parse_file_pfx(
1287 	int idx,
1288 	qffields_T *fields,
1289 	qf_list_T *qfl,
1290 	char_u *tail)
1291 {
1292     fields->valid = FALSE;
1293     if (*fields->namebuf == NUL || mch_getperm(fields->namebuf) >= 0)
1294     {
1295 	if (*fields->namebuf && idx == 'P')
1296 	    qfl->qf_currfile =
1297 		qf_push_dir(fields->namebuf, &qfl->qf_file_stack, TRUE);
1298 	else if (idx == 'Q')
1299 	    qfl->qf_currfile = qf_pop_dir(&qfl->qf_file_stack);
1300 	*fields->namebuf = NUL;
1301 	if (tail && *tail)
1302 	{
1303 	    STRMOVE(IObuff, skipwhite(tail));
1304 	    qfl->qf_multiscan = TRUE;
1305 	    return QF_MULTISCAN;
1306 	}
1307     }
1308 
1309     return QF_OK;
1310 }
1311 
1312 /*
1313  * Parse a non-error line (a line which doesn't match any of the error
1314  * format in 'efm').
1315  */
1316     static int
1317 qf_parse_line_nomatch(char_u *linebuf, int linelen, qffields_T *fields)
1318 {
1319     fields->namebuf[0] = NUL;	// no match found, remove file name
1320     fields->lnum = 0;		// don't jump to this line
1321     fields->valid = FALSE;
1322 
1323     return copy_nonerror_line(linebuf, linelen, fields);
1324 }
1325 
1326 /*
1327  * Parse multi-line error format prefixes (%C and %Z)
1328  */
1329     static int
1330 qf_parse_multiline_pfx(
1331 	int idx,
1332 	qf_list_T *qfl,
1333 	qffields_T *fields)
1334 {
1335     char_u		*ptr;
1336     int			len;
1337 
1338     if (!qfl->qf_multiignore)
1339     {
1340 	qfline_T *qfprev = qfl->qf_last;
1341 
1342 	if (qfprev == NULL)
1343 	    return QF_FAIL;
1344 	if (*fields->errmsg && !qfl->qf_multiignore)
1345 	{
1346 	    len = (int)STRLEN(qfprev->qf_text);
1347 	    if ((ptr = alloc(len + STRLEN(fields->errmsg) + 2))
1348 		    == NULL)
1349 		return QF_FAIL;
1350 	    STRCPY(ptr, qfprev->qf_text);
1351 	    vim_free(qfprev->qf_text);
1352 	    qfprev->qf_text = ptr;
1353 	    *(ptr += len) = '\n';
1354 	    STRCPY(++ptr, fields->errmsg);
1355 	}
1356 	if (qfprev->qf_nr == -1)
1357 	    qfprev->qf_nr = fields->enr;
1358 	if (vim_isprintc(fields->type) && !qfprev->qf_type)
1359 	    // only printable chars allowed
1360 	    qfprev->qf_type = fields->type;
1361 
1362 	if (!qfprev->qf_lnum)
1363 	    qfprev->qf_lnum = fields->lnum;
1364 	if (!qfprev->qf_col)
1365 	{
1366 	    qfprev->qf_col = fields->col;
1367 	    qfprev->qf_viscol = fields->use_viscol;
1368 	}
1369 	if (!qfprev->qf_fnum)
1370 	    qfprev->qf_fnum = qf_get_fnum(qfl,
1371 		    qfl->qf_directory,
1372 		    *fields->namebuf || qfl->qf_directory != NULL
1373 		    ? fields->namebuf
1374 		    : qfl->qf_currfile != NULL && fields->valid
1375 		    ? qfl->qf_currfile : 0);
1376     }
1377     if (idx == 'Z')
1378 	qfl->qf_multiline = qfl->qf_multiignore = FALSE;
1379     line_breakcheck();
1380 
1381     return QF_IGNORE_LINE;
1382 }
1383 
1384 /*
1385  * Parse a line and get the quickfix fields.
1386  * Return the QF_ status.
1387  */
1388     static int
1389 qf_parse_line(
1390 	qf_list_T	*qfl,
1391 	char_u		*linebuf,
1392 	int		linelen,
1393 	efm_T		*fmt_first,
1394 	qffields_T	*fields)
1395 {
1396     efm_T		*fmt_ptr;
1397     int			idx = 0;
1398     char_u		*tail = NULL;
1399     int			status;
1400 
1401 restofline:
1402     // If there was no %> item start at the first pattern
1403     if (fmt_start == NULL)
1404 	fmt_ptr = fmt_first;
1405     else
1406     {
1407 	// Otherwise start from the last used pattern
1408 	fmt_ptr = fmt_start;
1409 	fmt_start = NULL;
1410     }
1411 
1412     // Try to match each part of 'errorformat' until we find a complete
1413     // match or no match.
1414     fields->valid = TRUE;
1415     for ( ; fmt_ptr != NULL; fmt_ptr = fmt_ptr->next)
1416     {
1417 	idx = fmt_ptr->prefix;
1418 	status = qf_parse_get_fields(linebuf, linelen, fmt_ptr, fields,
1419 				qfl->qf_multiline, qfl->qf_multiscan, &tail);
1420 	if (status == QF_NOMEM)
1421 	    return status;
1422 	if (status == QF_OK)
1423 	    break;
1424     }
1425     qfl->qf_multiscan = FALSE;
1426 
1427     if (fmt_ptr == NULL || idx == 'D' || idx == 'X')
1428     {
1429 	if (fmt_ptr != NULL)
1430 	{
1431 	    // 'D' and 'X' directory specifiers
1432 	    status = qf_parse_dir_pfx(idx, fields, qfl);
1433 	    if (status != QF_OK)
1434 		return status;
1435 	}
1436 
1437 	status = qf_parse_line_nomatch(linebuf, linelen, fields);
1438 	if (status != QF_OK)
1439 	    return status;
1440 
1441 	if (fmt_ptr == NULL)
1442 	    qfl->qf_multiline = qfl->qf_multiignore = FALSE;
1443     }
1444     else if (fmt_ptr != NULL)
1445     {
1446 	// honor %> item
1447 	if (fmt_ptr->conthere)
1448 	    fmt_start = fmt_ptr;
1449 
1450 	if (vim_strchr((char_u *)"AEWIN", idx) != NULL)
1451 	{
1452 	    qfl->qf_multiline = TRUE;	// start of a multi-line message
1453 	    qfl->qf_multiignore = FALSE;// reset continuation
1454 	}
1455 	else if (vim_strchr((char_u *)"CZ", idx) != NULL)
1456 	{				// continuation of multi-line msg
1457 	    status = qf_parse_multiline_pfx(idx, qfl, fields);
1458 	    if (status != QF_OK)
1459 		return status;
1460 	}
1461 	else if (vim_strchr((char_u *)"OPQ", idx) != NULL)
1462 	{				// global file names
1463 	    status = qf_parse_file_pfx(idx, fields, qfl, tail);
1464 	    if (status == QF_MULTISCAN)
1465 		goto restofline;
1466 	}
1467 	if (fmt_ptr->flags == '-')	// generally exclude this line
1468 	{
1469 	    if (qfl->qf_multiline)
1470 		// also exclude continuation lines
1471 		qfl->qf_multiignore = TRUE;
1472 	    return QF_IGNORE_LINE;
1473 	}
1474     }
1475 
1476     return QF_OK;
1477 }
1478 
1479 /*
1480  * Returns TRUE if the specified quickfix/location stack is empty
1481  */
1482     static int
1483 qf_stack_empty(qf_info_T *qi)
1484 {
1485     return qi == NULL || qi->qf_listcount <= 0;
1486 }
1487 
1488 /*
1489  * Returns TRUE if the specified quickfix/location list is empty.
1490  */
1491     static int
1492 qf_list_empty(qf_list_T *qfl)
1493 {
1494     return qfl == NULL || qfl->qf_count <= 0;
1495 }
1496 
1497 /*
1498  * Returns TRUE if the specified quickfix/location list is not empty and
1499  * has valid entries.
1500  */
1501     static int
1502 qf_list_has_valid_entries(qf_list_T *qfl)
1503 {
1504     return !qf_list_empty(qfl) && !qfl->qf_nonevalid;
1505 }
1506 
1507 /*
1508  * Return a pointer to a list in the specified quickfix stack
1509  */
1510     static qf_list_T *
1511 qf_get_list(qf_info_T *qi, int idx)
1512 {
1513     return &qi->qf_lists[idx];
1514 }
1515 
1516 /*
1517  * Allocate the fields used for parsing lines and populating a quickfix list.
1518  */
1519     static int
1520 qf_alloc_fields(qffields_T *pfields)
1521 {
1522     pfields->namebuf = alloc_id(CMDBUFFSIZE + 1, aid_qf_namebuf);
1523     pfields->module = alloc_id(CMDBUFFSIZE + 1, aid_qf_module);
1524     pfields->errmsglen = CMDBUFFSIZE + 1;
1525     pfields->errmsg = alloc_id(pfields->errmsglen, aid_qf_errmsg);
1526     pfields->pattern = alloc_id(CMDBUFFSIZE + 1, aid_qf_pattern);
1527     if (pfields->namebuf == NULL || pfields->errmsg == NULL
1528 		|| pfields->pattern == NULL || pfields->module == NULL)
1529 	return FAIL;
1530 
1531     return OK;
1532 }
1533 
1534 /*
1535  * Free the fields used for parsing lines and populating a quickfix list.
1536  */
1537     static void
1538 qf_free_fields(qffields_T *pfields)
1539 {
1540     vim_free(pfields->namebuf);
1541     vim_free(pfields->module);
1542     vim_free(pfields->errmsg);
1543     vim_free(pfields->pattern);
1544 }
1545 
1546 /*
1547  * Setup the state information used for parsing lines and populating a
1548  * quickfix list.
1549  */
1550     static int
1551 qf_setup_state(
1552 	qfstate_T	*pstate,
1553 	char_u		*enc,
1554 	char_u		*efile,
1555 	typval_T	*tv,
1556 	buf_T		*buf,
1557 	linenr_T	lnumfirst,
1558 	linenr_T	lnumlast)
1559 {
1560     pstate->vc.vc_type = CONV_NONE;
1561     if (enc != NULL && *enc != NUL)
1562 	convert_setup(&pstate->vc, enc, p_enc);
1563 
1564     if (efile != NULL && (pstate->fd = mch_fopen((char *)efile, "r")) == NULL)
1565     {
1566 	semsg(_(e_openerrf), efile);
1567 	return FAIL;
1568     }
1569 
1570     if (tv != NULL)
1571     {
1572 	if (tv->v_type == VAR_STRING)
1573 	    pstate->p_str = tv->vval.v_string;
1574 	else if (tv->v_type == VAR_LIST)
1575 	    pstate->p_li = tv->vval.v_list->lv_first;
1576 	pstate->tv = tv;
1577     }
1578     pstate->buf = buf;
1579     pstate->buflnum = lnumfirst;
1580     pstate->lnumlast = lnumlast;
1581 
1582     return OK;
1583 }
1584 
1585 /*
1586  * Cleanup the state information used for parsing lines and populating a
1587  * quickfix list.
1588  */
1589     static void
1590 qf_cleanup_state(qfstate_T *pstate)
1591 {
1592     if (pstate->fd != NULL)
1593 	fclose(pstate->fd);
1594 
1595     vim_free(pstate->growbuf);
1596     if (pstate->vc.vc_type != CONV_NONE)
1597 	convert_setup(&pstate->vc, NULL, NULL);
1598 }
1599 
1600 /*
1601  * Process the next line from a file/buffer/list/string and add it
1602  * to the quickfix list 'qfl'.
1603  */
1604     static int
1605 qf_init_process_nextline(
1606 	qf_list_T	*qfl,
1607 	efm_T		*fmt_first,
1608 	qfstate_T	*state,
1609 	qffields_T	*fields)
1610 {
1611     int		    status;
1612 
1613     // Get the next line from a file/buffer/list/string
1614     status = qf_get_nextline(state);
1615     if (status != QF_OK)
1616 	return status;
1617 
1618     status = qf_parse_line(qfl, state->linebuf, state->linelen,
1619 	    fmt_first, fields);
1620     if (status != QF_OK)
1621 	return status;
1622 
1623     return qf_add_entry(qfl,
1624 		qfl->qf_directory,
1625 		(*fields->namebuf || qfl->qf_directory != NULL)
1626 		? fields->namebuf
1627 		: ((qfl->qf_currfile != NULL && fields->valid)
1628 		    ? qfl->qf_currfile : (char_u *)NULL),
1629 		fields->module,
1630 		0,
1631 		fields->errmsg,
1632 		fields->lnum,
1633 		fields->col,
1634 		fields->use_viscol,
1635 		fields->pattern,
1636 		fields->enr,
1637 		fields->type,
1638 		fields->valid);
1639 }
1640 
1641 /*
1642  * Read the errorfile "efile" into memory, line by line, building the error
1643  * list.
1644  * Alternative: when "efile" is NULL read errors from buffer "buf".
1645  * Alternative: when "tv" is not NULL get errors from the string or list.
1646  * Always use 'errorformat' from "buf" if there is a local value.
1647  * Then "lnumfirst" and "lnumlast" specify the range of lines to use.
1648  * Set the title of the list to "qf_title".
1649  * Return -1 for error, number of errors for success.
1650  */
1651     static int
1652 qf_init_ext(
1653     qf_info_T	    *qi,
1654     int		    qf_idx,
1655     char_u	    *efile,
1656     buf_T	    *buf,
1657     typval_T	    *tv,
1658     char_u	    *errorformat,
1659     int		    newlist,		// TRUE: start a new error list
1660     linenr_T	    lnumfirst,		// first line number to use
1661     linenr_T	    lnumlast,		// last line number to use
1662     char_u	    *qf_title,
1663     char_u	    *enc)
1664 {
1665     qf_list_T	    *qfl;
1666     qfstate_T	    state;
1667     qffields_T	    fields;
1668     qfline_T	    *old_last = NULL;
1669     int		    adding = FALSE;
1670     static efm_T    *fmt_first = NULL;
1671     char_u	    *efm;
1672     static char_u   *last_efm = NULL;
1673     int		    retval = -1;	// default: return error flag
1674     int		    status;
1675 
1676     // Do not used the cached buffer, it may have been wiped out.
1677     VIM_CLEAR(qf_last_bufname);
1678 
1679     CLEAR_FIELD(state);
1680     CLEAR_FIELD(fields);
1681     if ((qf_alloc_fields(&fields) == FAIL) ||
1682 		(qf_setup_state(&state, enc, efile, tv, buf,
1683 					lnumfirst, lnumlast) == FAIL))
1684 	goto qf_init_end;
1685 
1686     if (newlist || qf_idx == qi->qf_listcount)
1687     {
1688 	// make place for a new list
1689 	qf_new_list(qi, qf_title);
1690 	qf_idx = qi->qf_curlist;
1691 	qfl = qf_get_list(qi, qf_idx);
1692     }
1693     else
1694     {
1695 	// Adding to existing list, use last entry.
1696 	adding = TRUE;
1697 	qfl = qf_get_list(qi, qf_idx);
1698 	if (!qf_list_empty(qfl))
1699 	    old_last = qfl->qf_last;
1700     }
1701 
1702     // Use the local value of 'errorformat' if it's set.
1703     if (errorformat == p_efm && tv == NULL && *buf->b_p_efm != NUL)
1704 	efm = buf->b_p_efm;
1705     else
1706 	efm = errorformat;
1707 
1708     // If the errorformat didn't change between calls, then reuse the
1709     // previously parsed values.
1710     if (last_efm == NULL || (STRCMP(last_efm, efm) != 0))
1711     {
1712 	// free the previously parsed data
1713 	VIM_CLEAR(last_efm);
1714 	free_efm_list(&fmt_first);
1715 
1716 	// parse the current 'efm'
1717 	fmt_first = parse_efm_option(efm);
1718 	if (fmt_first != NULL)
1719 	    last_efm = vim_strsave(efm);
1720     }
1721 
1722     if (fmt_first == NULL)	// nothing found
1723 	goto error2;
1724 
1725     // got_int is reset here, because it was probably set when killing the
1726     // ":make" command, but we still want to read the errorfile then.
1727     got_int = FALSE;
1728 
1729     // Read the lines in the error file one by one.
1730     // Try to recognize one of the error formats in each line.
1731     while (!got_int)
1732     {
1733 	status = qf_init_process_nextline(qfl, fmt_first, &state, &fields);
1734 	if (status == QF_NOMEM)		// memory alloc failure
1735 	    goto qf_init_end;
1736 	if (status == QF_END_OF_INPUT)	// end of input
1737 	    break;
1738 	if (status == QF_FAIL)
1739 	    goto error2;
1740 
1741 	line_breakcheck();
1742     }
1743     if (state.fd == NULL || !ferror(state.fd))
1744     {
1745 	if (qfl->qf_index == 0)
1746 	{
1747 	    // no valid entry found
1748 	    qfl->qf_ptr = qfl->qf_start;
1749 	    qfl->qf_index = 1;
1750 	    qfl->qf_nonevalid = TRUE;
1751 	}
1752 	else
1753 	{
1754 	    qfl->qf_nonevalid = FALSE;
1755 	    if (qfl->qf_ptr == NULL)
1756 		qfl->qf_ptr = qfl->qf_start;
1757 	}
1758 	// return number of matches
1759 	retval = qfl->qf_count;
1760 	goto qf_init_end;
1761     }
1762     emsg(_(e_readerrf));
1763 error2:
1764     if (!adding)
1765     {
1766 	// Error when creating a new list. Free the new list
1767 	qf_free(qfl);
1768 	qi->qf_listcount--;
1769 	if (qi->qf_curlist > 0)
1770 	    --qi->qf_curlist;
1771     }
1772 qf_init_end:
1773     if (qf_idx == qi->qf_curlist)
1774 	qf_update_buffer(qi, old_last);
1775     qf_cleanup_state(&state);
1776     qf_free_fields(&fields);
1777 
1778     return retval;
1779 }
1780 
1781 /*
1782  * Read the errorfile "efile" into memory, line by line, building the error
1783  * list. Set the error list's title to qf_title.
1784  * Return -1 for error, number of errors for success.
1785  */
1786     int
1787 qf_init(win_T	    *wp,
1788 	char_u	    *efile,
1789 	char_u	    *errorformat,
1790 	int	    newlist,		// TRUE: start a new error list
1791 	char_u	    *qf_title,
1792 	char_u	    *enc)
1793 {
1794     qf_info_T	    *qi = &ql_info;
1795 
1796     if (wp != NULL)
1797     {
1798 	qi = ll_get_or_alloc_list(wp);
1799 	if (qi == NULL)
1800 	    return FAIL;
1801     }
1802 
1803     return qf_init_ext(qi, qi->qf_curlist, efile, curbuf, NULL, errorformat,
1804 	    newlist, (linenr_T)0, (linenr_T)0, qf_title, enc);
1805 }
1806 
1807 /*
1808  * Set the title of the specified quickfix list. Frees the previous title.
1809  * Prepends ':' to the title.
1810  */
1811     static void
1812 qf_store_title(qf_list_T *qfl, char_u *title)
1813 {
1814     VIM_CLEAR(qfl->qf_title);
1815 
1816     if (title != NULL)
1817     {
1818 	char_u *p = alloc(STRLEN(title) + 2);
1819 
1820 	qfl->qf_title = p;
1821 	if (p != NULL)
1822 	    STRCPY(p, title);
1823     }
1824 }
1825 
1826 /*
1827  * The title of a quickfix/location list is set, by default, to the command
1828  * that created the quickfix list with the ":" prefix.
1829  * Create a quickfix list title string by prepending ":" to a user command.
1830  * Returns a pointer to a static buffer with the title.
1831  */
1832     static char_u *
1833 qf_cmdtitle(char_u *cmd)
1834 {
1835     static char_u qftitle_str[IOSIZE];
1836 
1837     vim_snprintf((char *)qftitle_str, IOSIZE, ":%s", (char *)cmd);
1838     return qftitle_str;
1839 }
1840 
1841 /*
1842  * Return a pointer to the current list in the specified quickfix stack
1843  */
1844     static qf_list_T *
1845 qf_get_curlist(qf_info_T *qi)
1846 {
1847     return qf_get_list(qi, qi->qf_curlist);
1848 }
1849 
1850 /*
1851  * Prepare for adding a new quickfix list. If the current list is in the
1852  * middle of the stack, then all the following lists are freed and then
1853  * the new list is added.
1854  */
1855     static void
1856 qf_new_list(qf_info_T *qi, char_u *qf_title)
1857 {
1858     int		i;
1859     qf_list_T	*qfl;
1860 
1861     // If the current entry is not the last entry, delete entries beyond
1862     // the current entry.  This makes it possible to browse in a tree-like
1863     // way with ":grep".
1864     while (qi->qf_listcount > qi->qf_curlist + 1)
1865 	qf_free(&qi->qf_lists[--qi->qf_listcount]);
1866 
1867     // When the stack is full, remove to oldest entry
1868     // Otherwise, add a new entry.
1869     if (qi->qf_listcount == LISTCOUNT)
1870     {
1871 	qf_free(&qi->qf_lists[0]);
1872 	for (i = 1; i < LISTCOUNT; ++i)
1873 	    qi->qf_lists[i - 1] = qi->qf_lists[i];
1874 	qi->qf_curlist = LISTCOUNT - 1;
1875     }
1876     else
1877 	qi->qf_curlist = qi->qf_listcount++;
1878     qfl = qf_get_curlist(qi);
1879     CLEAR_POINTER(qfl);
1880     qf_store_title(qfl, qf_title);
1881     qfl->qfl_type = qi->qfl_type;
1882     qfl->qf_id = ++last_qf_id;
1883 }
1884 
1885 /*
1886  * Queue location list stack delete request.
1887  */
1888     static void
1889 locstack_queue_delreq(qf_info_T *qi)
1890 {
1891     qf_delq_T	*q;
1892 
1893     q = ALLOC_ONE(qf_delq_T);
1894     if (q != NULL)
1895     {
1896 	q->qi = qi;
1897 	q->next = qf_delq_head;
1898 	qf_delq_head = q;
1899     }
1900 }
1901 
1902 /*
1903  * Return the global quickfix stack window buffer number.
1904  */
1905     int
1906 qf_stack_get_bufnr(void)
1907 {
1908     return ql_info.qf_bufnr;
1909 }
1910 
1911 /*
1912  * Wipe the quickfix window buffer (if present) for the specified
1913  * quickfix/location list.
1914  */
1915     static void
1916 wipe_qf_buffer(qf_info_T *qi)
1917 {
1918     buf_T	*qfbuf;
1919 
1920     if (qi->qf_bufnr != INVALID_QFBUFNR)
1921     {
1922 	qfbuf = buflist_findnr(qi->qf_bufnr);
1923 	if (qfbuf != NULL && qfbuf->b_nwindows == 0)
1924 	{
1925 	    // If the quickfix buffer is not loaded in any window, then
1926 	    // wipe the buffer.
1927 	    close_buffer(NULL, qfbuf, DOBUF_WIPE, FALSE, FALSE);
1928 	    qi->qf_bufnr = INVALID_QFBUFNR;
1929 	}
1930     }
1931 }
1932 
1933 /*
1934  * Free a location list stack
1935  */
1936     static void
1937 ll_free_all(qf_info_T **pqi)
1938 {
1939     int		i;
1940     qf_info_T	*qi;
1941 
1942     qi = *pqi;
1943     if (qi == NULL)
1944 	return;
1945     *pqi = NULL;	// Remove reference to this list
1946 
1947     // If the location list is still in use, then queue the delete request
1948     // to be processed later.
1949     if (quickfix_busy > 0)
1950     {
1951 	locstack_queue_delreq(qi);
1952 	return;
1953     }
1954 
1955     qi->qf_refcount--;
1956     if (qi->qf_refcount < 1)
1957     {
1958 	// No references to this location list.
1959 	// If the quickfix window buffer is loaded, then wipe it
1960 	wipe_qf_buffer(qi);
1961 
1962 	for (i = 0; i < qi->qf_listcount; ++i)
1963 	    qf_free(qf_get_list(qi, i));
1964 	vim_free(qi);
1965     }
1966 }
1967 
1968 /*
1969  * Free all the quickfix/location lists in the stack.
1970  */
1971     void
1972 qf_free_all(win_T *wp)
1973 {
1974     int		i;
1975     qf_info_T	*qi = &ql_info;
1976 
1977     if (wp != NULL)
1978     {
1979 	// location list
1980 	ll_free_all(&wp->w_llist);
1981 	ll_free_all(&wp->w_llist_ref);
1982     }
1983     else
1984 	// quickfix list
1985 	for (i = 0; i < qi->qf_listcount; ++i)
1986 	    qf_free(qf_get_list(qi, i));
1987 }
1988 
1989 /*
1990  * Delay freeing of location list stacks when the quickfix code is running.
1991  * Used to avoid problems with autocmds freeing location list stacks when the
1992  * quickfix code is still referencing the stack.
1993  * Must always call decr_quickfix_busy() exactly once after this.
1994  */
1995     static void
1996 incr_quickfix_busy(void)
1997 {
1998     quickfix_busy++;
1999 }
2000 
2001 /*
2002  * Safe to free location list stacks. Process any delayed delete requests.
2003  */
2004     static void
2005 decr_quickfix_busy(void)
2006 {
2007     if (--quickfix_busy == 0)
2008     {
2009 	// No longer referencing the location lists. Process all the pending
2010 	// delete requests.
2011 	while (qf_delq_head != NULL)
2012 	{
2013 	    qf_delq_T	*q = qf_delq_head;
2014 
2015 	    qf_delq_head = q->next;
2016 	    ll_free_all(&q->qi);
2017 	    vim_free(q);
2018 	}
2019     }
2020 #ifdef ABORT_ON_INTERNAL_ERROR
2021     if (quickfix_busy < 0)
2022     {
2023 	emsg("quickfix_busy has become negative");
2024 	abort();
2025     }
2026 #endif
2027 }
2028 
2029 #if defined(EXITFREE) || defined(PROTO)
2030     void
2031 check_quickfix_busy(void)
2032 {
2033     if (quickfix_busy != 0)
2034     {
2035 	semsg("quickfix_busy not zero on exit: %ld", (long)quickfix_busy);
2036 # ifdef ABORT_ON_INTERNAL_ERROR
2037 	abort();
2038 # endif
2039     }
2040 }
2041 #endif
2042 
2043 /*
2044  * Add an entry to the end of the list of errors.
2045  * Returns QF_OK or QF_FAIL.
2046  */
2047     static int
2048 qf_add_entry(
2049     qf_list_T	*qfl,		// quickfix list entry
2050     char_u	*dir,		// optional directory name
2051     char_u	*fname,		// file name or NULL
2052     char_u	*module,	// module name or NULL
2053     int		bufnum,		// buffer number or zero
2054     char_u	*mesg,		// message
2055     long	lnum,		// line number
2056     int		col,		// column
2057     int		vis_col,	// using visual column
2058     char_u	*pattern,	// search pattern
2059     int		nr,		// error number
2060     int		type,		// type character
2061     int		valid)		// valid entry
2062 {
2063     qfline_T	*qfp;
2064     qfline_T	**lastp;	// pointer to qf_last or NULL
2065 
2066     if ((qfp = ALLOC_ONE(qfline_T)) == NULL)
2067 	return QF_FAIL;
2068     if (bufnum != 0)
2069     {
2070 	buf_T *buf = buflist_findnr(bufnum);
2071 
2072 	qfp->qf_fnum = bufnum;
2073 	if (buf != NULL)
2074 	    buf->b_has_qf_entry |=
2075 		IS_QF_LIST(qfl) ? BUF_HAS_QF_ENTRY : BUF_HAS_LL_ENTRY;
2076     }
2077     else
2078 	qfp->qf_fnum = qf_get_fnum(qfl, dir, fname);
2079     if ((qfp->qf_text = vim_strsave(mesg)) == NULL)
2080     {
2081 	vim_free(qfp);
2082 	return QF_FAIL;
2083     }
2084     qfp->qf_lnum = lnum;
2085     qfp->qf_col = col;
2086     qfp->qf_viscol = vis_col;
2087     if (pattern == NULL || *pattern == NUL)
2088 	qfp->qf_pattern = NULL;
2089     else if ((qfp->qf_pattern = vim_strsave(pattern)) == NULL)
2090     {
2091 	vim_free(qfp->qf_text);
2092 	vim_free(qfp);
2093 	return QF_FAIL;
2094     }
2095     if (module == NULL || *module == NUL)
2096 	qfp->qf_module = NULL;
2097     else if ((qfp->qf_module = vim_strsave(module)) == NULL)
2098     {
2099 	vim_free(qfp->qf_text);
2100 	vim_free(qfp->qf_pattern);
2101 	vim_free(qfp);
2102 	return QF_FAIL;
2103     }
2104     qfp->qf_nr = nr;
2105     if (type != 1 && !vim_isprintc(type)) // only printable chars allowed
2106 	type = 0;
2107     qfp->qf_type = type;
2108     qfp->qf_valid = valid;
2109 
2110     lastp = &qfl->qf_last;
2111     if (qf_list_empty(qfl))		// first element in the list
2112     {
2113 	qfl->qf_start = qfp;
2114 	qfl->qf_ptr = qfp;
2115 	qfl->qf_index = 0;
2116 	qfp->qf_prev = NULL;
2117     }
2118     else
2119     {
2120 	qfp->qf_prev = *lastp;
2121 	(*lastp)->qf_next = qfp;
2122     }
2123     qfp->qf_next = NULL;
2124     qfp->qf_cleared = FALSE;
2125     *lastp = qfp;
2126     ++qfl->qf_count;
2127     if (qfl->qf_index == 0 && qfp->qf_valid)	// first valid entry
2128     {
2129 	qfl->qf_index = qfl->qf_count;
2130 	qfl->qf_ptr = qfp;
2131     }
2132 
2133     return QF_OK;
2134 }
2135 
2136 /*
2137  * Allocate a new quickfix/location list stack
2138  */
2139     static qf_info_T *
2140 qf_alloc_stack(qfltype_T qfltype)
2141 {
2142     qf_info_T *qi;
2143 
2144     qi = ALLOC_CLEAR_ONE(qf_info_T);
2145     if (qi != NULL)
2146     {
2147 	qi->qf_refcount++;
2148 	qi->qfl_type = qfltype;
2149 	qi->qf_bufnr = INVALID_QFBUFNR;
2150     }
2151     return qi;
2152 }
2153 
2154 /*
2155  * Return the location list stack for window 'wp'.
2156  * If not present, allocate a location list stack
2157  */
2158     static qf_info_T *
2159 ll_get_or_alloc_list(win_T *wp)
2160 {
2161     if (IS_LL_WINDOW(wp))
2162 	// For a location list window, use the referenced location list
2163 	return wp->w_llist_ref;
2164 
2165     // For a non-location list window, w_llist_ref should not point to a
2166     // location list.
2167     ll_free_all(&wp->w_llist_ref);
2168 
2169     if (wp->w_llist == NULL)
2170 	wp->w_llist = qf_alloc_stack(QFLT_LOCATION);	// new location list
2171     return wp->w_llist;
2172 }
2173 
2174 /*
2175  * Get the quickfix/location list stack to use for the specified Ex command.
2176  * For a location list command, returns the stack for the current window.  If
2177  * the location list is not found, then returns NULL and prints an error
2178  * message if 'print_emsg' is TRUE.
2179  */
2180     static qf_info_T *
2181 qf_cmd_get_stack(exarg_T *eap, int print_emsg)
2182 {
2183     qf_info_T	*qi = &ql_info;
2184 
2185     if (is_loclist_cmd(eap->cmdidx))
2186     {
2187 	qi = GET_LOC_LIST(curwin);
2188 	if (qi == NULL)
2189 	{
2190 	    if (print_emsg)
2191 		emsg(_(e_loclist));
2192 	    return NULL;
2193 	}
2194     }
2195 
2196     return qi;
2197 }
2198 
2199 /*
2200  * Get the quickfix/location list stack to use for the specified Ex command.
2201  * For a location list command, returns the stack for the current window.
2202  * If the location list is not present, then allocates a new one.
2203  * Returns NULL if the allocation fails.  For a location list command, sets
2204  * 'pwinp' to curwin.
2205  */
2206     static qf_info_T *
2207 qf_cmd_get_or_alloc_stack(exarg_T *eap, win_T **pwinp)
2208 {
2209     qf_info_T	*qi = &ql_info;
2210 
2211     if (is_loclist_cmd(eap->cmdidx))
2212     {
2213 	qi = ll_get_or_alloc_list(curwin);
2214 	if (qi == NULL)
2215 	    return NULL;
2216 	*pwinp = curwin;
2217     }
2218 
2219     return qi;
2220 }
2221 
2222 /*
2223  * Copy location list entries from 'from_qfl' to 'to_qfl'.
2224  */
2225     static int
2226 copy_loclist_entries(qf_list_T *from_qfl, qf_list_T *to_qfl)
2227 {
2228     int		i;
2229     qfline_T    *from_qfp;
2230     qfline_T    *prevp;
2231 
2232     // copy all the location entries in this list
2233     FOR_ALL_QFL_ITEMS(from_qfl, from_qfp, i)
2234     {
2235 	if (qf_add_entry(to_qfl,
2236 		    NULL,
2237 		    NULL,
2238 		    from_qfp->qf_module,
2239 		    0,
2240 		    from_qfp->qf_text,
2241 		    from_qfp->qf_lnum,
2242 		    from_qfp->qf_col,
2243 		    from_qfp->qf_viscol,
2244 		    from_qfp->qf_pattern,
2245 		    from_qfp->qf_nr,
2246 		    0,
2247 		    from_qfp->qf_valid) == QF_FAIL)
2248 	    return FAIL;
2249 
2250 	// qf_add_entry() will not set the qf_num field, as the
2251 	// directory and file names are not supplied. So the qf_fnum
2252 	// field is copied here.
2253 	prevp = to_qfl->qf_last;
2254 	prevp->qf_fnum = from_qfp->qf_fnum;	// file number
2255 	prevp->qf_type = from_qfp->qf_type;	// error type
2256 	if (from_qfl->qf_ptr == from_qfp)
2257 	    to_qfl->qf_ptr = prevp;		// current location
2258     }
2259 
2260     return OK;
2261 }
2262 
2263 /*
2264  * Copy the specified location list 'from_qfl' to 'to_qfl'.
2265  */
2266     static int
2267 copy_loclist(qf_list_T *from_qfl, qf_list_T *to_qfl)
2268 {
2269     // Some of the fields are populated by qf_add_entry()
2270     to_qfl->qfl_type = from_qfl->qfl_type;
2271     to_qfl->qf_nonevalid = from_qfl->qf_nonevalid;
2272     to_qfl->qf_count = 0;
2273     to_qfl->qf_index = 0;
2274     to_qfl->qf_start = NULL;
2275     to_qfl->qf_last = NULL;
2276     to_qfl->qf_ptr = NULL;
2277     if (from_qfl->qf_title != NULL)
2278 	to_qfl->qf_title = vim_strsave(from_qfl->qf_title);
2279     else
2280 	to_qfl->qf_title = NULL;
2281     if (from_qfl->qf_ctx != NULL)
2282     {
2283 	to_qfl->qf_ctx = alloc_tv();
2284 	if (to_qfl->qf_ctx != NULL)
2285 	    copy_tv(from_qfl->qf_ctx, to_qfl->qf_ctx);
2286     }
2287     else
2288 	to_qfl->qf_ctx = NULL;
2289     if (from_qfl->qftf_cb.cb_name != NULL)
2290 	copy_callback(&to_qfl->qftf_cb, &from_qfl->qftf_cb);
2291     else
2292 	to_qfl->qftf_cb.cb_name = NULL;
2293 
2294     if (from_qfl->qf_count)
2295 	if (copy_loclist_entries(from_qfl, to_qfl) == FAIL)
2296 	    return FAIL;
2297 
2298     to_qfl->qf_index = from_qfl->qf_index;	// current index in the list
2299 
2300     // Assign a new ID for the location list
2301     to_qfl->qf_id = ++last_qf_id;
2302     to_qfl->qf_changedtick = 0L;
2303 
2304     // When no valid entries are present in the list, qf_ptr points to
2305     // the first item in the list
2306     if (to_qfl->qf_nonevalid)
2307     {
2308 	to_qfl->qf_ptr = to_qfl->qf_start;
2309 	to_qfl->qf_index = 1;
2310     }
2311 
2312     return OK;
2313 }
2314 
2315 /*
2316  * Copy the location list stack 'from' window to 'to' window.
2317  */
2318     void
2319 copy_loclist_stack(win_T *from, win_T *to)
2320 {
2321     qf_info_T	*qi;
2322     int		idx;
2323 
2324     // When copying from a location list window, copy the referenced
2325     // location list. For other windows, copy the location list for
2326     // that window.
2327     if (IS_LL_WINDOW(from))
2328 	qi = from->w_llist_ref;
2329     else
2330 	qi = from->w_llist;
2331 
2332     if (qi == NULL)		    // no location list to copy
2333 	return;
2334 
2335     // allocate a new location list
2336     if ((to->w_llist = qf_alloc_stack(QFLT_LOCATION)) == NULL)
2337 	return;
2338 
2339     to->w_llist->qf_listcount = qi->qf_listcount;
2340 
2341     // Copy the location lists one at a time
2342     for (idx = 0; idx < qi->qf_listcount; ++idx)
2343     {
2344 	to->w_llist->qf_curlist = idx;
2345 
2346 	if (copy_loclist(qf_get_list(qi, idx),
2347 			qf_get_list(to->w_llist, idx)) == FAIL)
2348 	{
2349 	    qf_free_all(to);
2350 	    return;
2351 	}
2352     }
2353 
2354     to->w_llist->qf_curlist = qi->qf_curlist;	// current list
2355 }
2356 
2357 /*
2358  * Get buffer number for file "directory/fname".
2359  * Also sets the b_has_qf_entry flag.
2360  */
2361     static int
2362 qf_get_fnum(qf_list_T *qfl, char_u *directory, char_u *fname)
2363 {
2364     char_u	*ptr = NULL;
2365     buf_T	*buf;
2366     char_u	*bufname;
2367 
2368     if (fname == NULL || *fname == NUL)		// no file name
2369 	return 0;
2370 
2371 #ifdef VMS
2372     vms_remove_version(fname);
2373 #endif
2374 #ifdef BACKSLASH_IN_FILENAME
2375     if (directory != NULL)
2376 	slash_adjust(directory);
2377     slash_adjust(fname);
2378 #endif
2379     if (directory != NULL && !vim_isAbsName(fname)
2380 	    && (ptr = concat_fnames(directory, fname, TRUE)) != NULL)
2381     {
2382 	// Here we check if the file really exists.
2383 	// This should normally be true, but if make works without
2384 	// "leaving directory"-messages we might have missed a
2385 	// directory change.
2386 	if (mch_getperm(ptr) < 0)
2387 	{
2388 	    vim_free(ptr);
2389 	    directory = qf_guess_filepath(qfl, fname);
2390 	    if (directory)
2391 		ptr = concat_fnames(directory, fname, TRUE);
2392 	    else
2393 		ptr = vim_strsave(fname);
2394 	}
2395 	// Use concatenated directory name and file name
2396 	bufname = ptr;
2397     }
2398     else
2399 	bufname = fname;
2400 
2401     if (qf_last_bufname != NULL && STRCMP(bufname, qf_last_bufname) == 0
2402 	    && bufref_valid(&qf_last_bufref))
2403     {
2404 	buf = qf_last_bufref.br_buf;
2405 	vim_free(ptr);
2406     }
2407     else
2408     {
2409 	vim_free(qf_last_bufname);
2410 	buf = buflist_new(bufname, NULL, (linenr_T)0, BLN_NOOPT);
2411 	if (bufname == ptr)
2412 	    qf_last_bufname = bufname;
2413 	else
2414 	    qf_last_bufname = vim_strsave(bufname);
2415 	set_bufref(&qf_last_bufref, buf);
2416     }
2417     if (buf == NULL)
2418 	return 0;
2419 
2420     buf->b_has_qf_entry =
2421 			IS_QF_LIST(qfl) ? BUF_HAS_QF_ENTRY : BUF_HAS_LL_ENTRY;
2422     return buf->b_fnum;
2423 }
2424 
2425 /*
2426  * Push dirbuf onto the directory stack and return pointer to actual dir or
2427  * NULL on error.
2428  */
2429     static char_u *
2430 qf_push_dir(char_u *dirbuf, struct dir_stack_T **stackptr, int is_file_stack)
2431 {
2432     struct dir_stack_T  *ds_new;
2433     struct dir_stack_T  *ds_ptr;
2434 
2435     // allocate new stack element and hook it in
2436     ds_new = ALLOC_ONE(struct dir_stack_T);
2437     if (ds_new == NULL)
2438 	return NULL;
2439 
2440     ds_new->next = *stackptr;
2441     *stackptr = ds_new;
2442 
2443     // store directory on the stack
2444     if (vim_isAbsName(dirbuf)
2445 	    || (*stackptr)->next == NULL
2446 	    || (*stackptr && is_file_stack))
2447 	(*stackptr)->dirname = vim_strsave(dirbuf);
2448     else
2449     {
2450 	// Okay we don't have an absolute path.
2451 	// dirbuf must be a subdir of one of the directories on the stack.
2452 	// Let's search...
2453 	ds_new = (*stackptr)->next;
2454 	(*stackptr)->dirname = NULL;
2455 	while (ds_new)
2456 	{
2457 	    vim_free((*stackptr)->dirname);
2458 	    (*stackptr)->dirname = concat_fnames(ds_new->dirname, dirbuf,
2459 		    TRUE);
2460 	    if (mch_isdir((*stackptr)->dirname) == TRUE)
2461 		break;
2462 
2463 	    ds_new = ds_new->next;
2464 	}
2465 
2466 	// clean up all dirs we already left
2467 	while ((*stackptr)->next != ds_new)
2468 	{
2469 	    ds_ptr = (*stackptr)->next;
2470 	    (*stackptr)->next = (*stackptr)->next->next;
2471 	    vim_free(ds_ptr->dirname);
2472 	    vim_free(ds_ptr);
2473 	}
2474 
2475 	// Nothing found -> it must be on top level
2476 	if (ds_new == NULL)
2477 	{
2478 	    vim_free((*stackptr)->dirname);
2479 	    (*stackptr)->dirname = vim_strsave(dirbuf);
2480 	}
2481     }
2482 
2483     if ((*stackptr)->dirname != NULL)
2484 	return (*stackptr)->dirname;
2485     else
2486     {
2487 	ds_ptr = *stackptr;
2488 	*stackptr = (*stackptr)->next;
2489 	vim_free(ds_ptr);
2490 	return NULL;
2491     }
2492 }
2493 
2494 /*
2495  * pop dirbuf from the directory stack and return previous directory or NULL if
2496  * stack is empty
2497  */
2498     static char_u *
2499 qf_pop_dir(struct dir_stack_T **stackptr)
2500 {
2501     struct dir_stack_T  *ds_ptr;
2502 
2503     // TODO: Should we check if dirbuf is the directory on top of the stack?
2504     // What to do if it isn't?
2505 
2506     // pop top element and free it
2507     if (*stackptr != NULL)
2508     {
2509 	ds_ptr = *stackptr;
2510 	*stackptr = (*stackptr)->next;
2511 	vim_free(ds_ptr->dirname);
2512 	vim_free(ds_ptr);
2513     }
2514 
2515     // return NEW top element as current dir or NULL if stack is empty
2516     return *stackptr ? (*stackptr)->dirname : NULL;
2517 }
2518 
2519 /*
2520  * clean up directory stack
2521  */
2522     static void
2523 qf_clean_dir_stack(struct dir_stack_T **stackptr)
2524 {
2525     struct dir_stack_T  *ds_ptr;
2526 
2527     while ((ds_ptr = *stackptr) != NULL)
2528     {
2529 	*stackptr = (*stackptr)->next;
2530 	vim_free(ds_ptr->dirname);
2531 	vim_free(ds_ptr);
2532     }
2533 }
2534 
2535 /*
2536  * Check in which directory of the directory stack the given file can be
2537  * found.
2538  * Returns a pointer to the directory name or NULL if not found.
2539  * Cleans up intermediate directory entries.
2540  *
2541  * TODO: How to solve the following problem?
2542  * If we have this directory tree:
2543  *     ./
2544  *     ./aa
2545  *     ./aa/bb
2546  *     ./bb
2547  *     ./bb/x.c
2548  * and make says:
2549  *     making all in aa
2550  *     making all in bb
2551  *     x.c:9: Error
2552  * Then qf_push_dir thinks we are in ./aa/bb, but we are in ./bb.
2553  * qf_guess_filepath will return NULL.
2554  */
2555     static char_u *
2556 qf_guess_filepath(qf_list_T *qfl, char_u *filename)
2557 {
2558     struct dir_stack_T     *ds_ptr;
2559     struct dir_stack_T     *ds_tmp;
2560     char_u		   *fullname;
2561 
2562     // no dirs on the stack - there's nothing we can do
2563     if (qfl->qf_dir_stack == NULL)
2564 	return NULL;
2565 
2566     ds_ptr = qfl->qf_dir_stack->next;
2567     fullname = NULL;
2568     while (ds_ptr)
2569     {
2570 	vim_free(fullname);
2571 	fullname = concat_fnames(ds_ptr->dirname, filename, TRUE);
2572 
2573 	// If concat_fnames failed, just go on. The worst thing that can happen
2574 	// is that we delete the entire stack.
2575 	if ((fullname != NULL) && (mch_getperm(fullname) >= 0))
2576 	    break;
2577 
2578 	ds_ptr = ds_ptr->next;
2579     }
2580 
2581     vim_free(fullname);
2582 
2583     // clean up all dirs we already left
2584     while (qfl->qf_dir_stack->next != ds_ptr)
2585     {
2586 	ds_tmp = qfl->qf_dir_stack->next;
2587 	qfl->qf_dir_stack->next = qfl->qf_dir_stack->next->next;
2588 	vim_free(ds_tmp->dirname);
2589 	vim_free(ds_tmp);
2590     }
2591 
2592     return ds_ptr == NULL ? NULL : ds_ptr->dirname;
2593 }
2594 
2595 /*
2596  * Returns TRUE if a quickfix/location list with the given identifier exists.
2597  */
2598     static int
2599 qflist_valid(win_T *wp, int_u qf_id)
2600 {
2601     qf_info_T	*qi = &ql_info;
2602     int		i;
2603 
2604     if (wp != NULL)
2605     {
2606 	if (!win_valid(wp))
2607 	    return FALSE;
2608 	qi = GET_LOC_LIST(wp);	    // Location list
2609 	if (qi == NULL)
2610 	    return FALSE;
2611     }
2612 
2613     for (i = 0; i < qi->qf_listcount; ++i)
2614 	if (qi->qf_lists[i].qf_id == qf_id)
2615 	    return TRUE;
2616 
2617     return FALSE;
2618 }
2619 
2620 /*
2621  * When loading a file from the quickfix, the autocommands may modify it.
2622  * This may invalidate the current quickfix entry.  This function checks
2623  * whether an entry is still present in the quickfix list.
2624  * Similar to location list.
2625  */
2626     static int
2627 is_qf_entry_present(qf_list_T *qfl, qfline_T *qf_ptr)
2628 {
2629     qfline_T	*qfp;
2630     int		i;
2631 
2632     // Search for the entry in the current list
2633     FOR_ALL_QFL_ITEMS(qfl, qfp, i)
2634 	if (qfp == qf_ptr)
2635 	    break;
2636 
2637     if (i > qfl->qf_count) // Entry is not found
2638 	return FALSE;
2639 
2640     return TRUE;
2641 }
2642 
2643 /*
2644  * Get the next valid entry in the current quickfix/location list. The search
2645  * starts from the current entry.  Returns NULL on failure.
2646  */
2647     static qfline_T *
2648 get_next_valid_entry(
2649 	qf_list_T	*qfl,
2650 	qfline_T	*qf_ptr,
2651 	int		*qf_index,
2652 	int		dir)
2653 {
2654     int			idx;
2655     int			old_qf_fnum;
2656 
2657     idx = *qf_index;
2658     old_qf_fnum = qf_ptr->qf_fnum;
2659 
2660     do
2661     {
2662 	if (idx == qfl->qf_count || qf_ptr->qf_next == NULL)
2663 	    return NULL;
2664 	++idx;
2665 	qf_ptr = qf_ptr->qf_next;
2666     } while ((!qfl->qf_nonevalid && !qf_ptr->qf_valid)
2667 	    || (dir == FORWARD_FILE && qf_ptr->qf_fnum == old_qf_fnum));
2668 
2669     *qf_index = idx;
2670     return qf_ptr;
2671 }
2672 
2673 /*
2674  * Get the previous valid entry in the current quickfix/location list. The
2675  * search starts from the current entry.  Returns NULL on failure.
2676  */
2677     static qfline_T *
2678 get_prev_valid_entry(
2679 	qf_list_T	*qfl,
2680 	qfline_T	*qf_ptr,
2681 	int		*qf_index,
2682 	int		dir)
2683 {
2684     int			idx;
2685     int			old_qf_fnum;
2686 
2687     idx = *qf_index;
2688     old_qf_fnum = qf_ptr->qf_fnum;
2689 
2690     do
2691     {
2692 	if (idx == 1 || qf_ptr->qf_prev == NULL)
2693 	    return NULL;
2694 	--idx;
2695 	qf_ptr = qf_ptr->qf_prev;
2696     } while ((!qfl->qf_nonevalid && !qf_ptr->qf_valid)
2697 	    || (dir == BACKWARD_FILE && qf_ptr->qf_fnum == old_qf_fnum));
2698 
2699     *qf_index = idx;
2700     return qf_ptr;
2701 }
2702 
2703 /*
2704  * Get the n'th (errornr) previous/next valid entry from the current entry in
2705  * the quickfix list.
2706  *   dir == FORWARD or FORWARD_FILE: next valid entry
2707  *   dir == BACKWARD or BACKWARD_FILE: previous valid entry
2708  */
2709     static qfline_T *
2710 get_nth_valid_entry(
2711 	qf_list_T	*qfl,
2712 	int		errornr,
2713 	int		dir,
2714 	int		*new_qfidx)
2715 {
2716     qfline_T		*qf_ptr = qfl->qf_ptr;
2717     int			qf_idx = qfl->qf_index;
2718     qfline_T		*prev_qf_ptr;
2719     int			prev_index;
2720     char_u		*err = e_no_more_items;
2721 
2722     while (errornr--)
2723     {
2724 	prev_qf_ptr = qf_ptr;
2725 	prev_index = qf_idx;
2726 
2727 	if (dir == FORWARD || dir == FORWARD_FILE)
2728 	    qf_ptr = get_next_valid_entry(qfl, qf_ptr, &qf_idx, dir);
2729 	else
2730 	    qf_ptr = get_prev_valid_entry(qfl, qf_ptr, &qf_idx, dir);
2731 	if (qf_ptr == NULL)
2732 	{
2733 	    qf_ptr = prev_qf_ptr;
2734 	    qf_idx = prev_index;
2735 	    if (err != NULL)
2736 	    {
2737 		emsg(_(err));
2738 		return NULL;
2739 	    }
2740 	    break;
2741 	}
2742 
2743 	err = NULL;
2744     }
2745 
2746     *new_qfidx = qf_idx;
2747     return qf_ptr;
2748 }
2749 
2750 /*
2751  * Get n'th (errornr) quickfix entry from the current entry in the quickfix
2752  * list 'qfl'. Returns a pointer to the new entry and the index in 'new_qfidx'
2753  */
2754     static qfline_T *
2755 get_nth_entry(qf_list_T *qfl, int errornr, int *new_qfidx)
2756 {
2757     qfline_T	*qf_ptr = qfl->qf_ptr;
2758     int		qf_idx = qfl->qf_index;
2759 
2760     // New error number is less than the current error number
2761     while (errornr < qf_idx && qf_idx > 1 && qf_ptr->qf_prev != NULL)
2762     {
2763 	--qf_idx;
2764 	qf_ptr = qf_ptr->qf_prev;
2765     }
2766     // New error number is greater than the current error number
2767     while (errornr > qf_idx && qf_idx < qfl->qf_count &&
2768 						qf_ptr->qf_next != NULL)
2769     {
2770 	++qf_idx;
2771 	qf_ptr = qf_ptr->qf_next;
2772     }
2773 
2774     *new_qfidx = qf_idx;
2775     return qf_ptr;
2776 }
2777 
2778 /*
2779  * Get a entry specified by 'errornr' and 'dir' from the current
2780  * quickfix/location list. 'errornr' specifies the index of the entry and 'dir'
2781  * specifies the direction (FORWARD/BACKWARD/FORWARD_FILE/BACKWARD_FILE).
2782  * Returns a pointer to the entry and the index of the new entry is stored in
2783  * 'new_qfidx'.
2784  */
2785     static qfline_T *
2786 qf_get_entry(
2787 	qf_list_T	*qfl,
2788 	int		errornr,
2789 	int		dir,
2790 	int		*new_qfidx)
2791 {
2792     qfline_T	*qf_ptr = qfl->qf_ptr;
2793     int		qfidx = qfl->qf_index;
2794 
2795     if (dir != 0)    // next/prev valid entry
2796 	qf_ptr = get_nth_valid_entry(qfl, errornr, dir, &qfidx);
2797     else if (errornr != 0)	// go to specified number
2798 	qf_ptr = get_nth_entry(qfl, errornr, &qfidx);
2799 
2800     *new_qfidx = qfidx;
2801     return qf_ptr;
2802 }
2803 
2804 /*
2805  * Find a window displaying a Vim help file.
2806  */
2807     static win_T *
2808 qf_find_help_win(void)
2809 {
2810     win_T *wp;
2811 
2812     FOR_ALL_WINDOWS(wp)
2813 	if (bt_help(wp->w_buffer))
2814 	    return wp;
2815 
2816     return NULL;
2817 }
2818 
2819 /*
2820  * Set the location list for the specified window to 'qi'.
2821  */
2822     static void
2823 win_set_loclist(win_T *wp, qf_info_T *qi)
2824 {
2825     wp->w_llist = qi;
2826     qi->qf_refcount++;
2827 }
2828 
2829 /*
2830  * Find a help window or open one. If 'newwin' is TRUE, then open a new help
2831  * window.
2832  */
2833     static int
2834 jump_to_help_window(qf_info_T *qi, int newwin, int *opened_window)
2835 {
2836     win_T	*wp;
2837     int		flags;
2838 
2839     if (cmdmod.cmod_tab != 0 || newwin)
2840 	wp = NULL;
2841     else
2842 	wp = qf_find_help_win();
2843     if (wp != NULL && wp->w_buffer->b_nwindows > 0)
2844 	win_enter(wp, TRUE);
2845     else
2846     {
2847 	// Split off help window; put it at far top if no position
2848 	// specified, the current window is vertically split and narrow.
2849 	flags = WSP_HELP;
2850 	if (cmdmod.cmod_split == 0 && curwin->w_width != Columns
2851 		&& curwin->w_width < 80)
2852 	    flags |= WSP_TOP;
2853 	// If the user asks to open a new window, then copy the location list.
2854 	// Otherwise, don't copy the location list.
2855 	if (IS_LL_STACK(qi) && !newwin)
2856 	    flags |= WSP_NEWLOC;
2857 
2858 	if (win_split(0, flags) == FAIL)
2859 	    return FAIL;
2860 
2861 	*opened_window = TRUE;
2862 
2863 	if (curwin->w_height < p_hh)
2864 	    win_setheight((int)p_hh);
2865 
2866 	// When using location list, the new window should use the supplied
2867 	// location list. If the user asks to open a new window, then the new
2868 	// window will get a copy of the location list.
2869 	if (IS_LL_STACK(qi) && !newwin)
2870 	    win_set_loclist(curwin, qi);
2871     }
2872 
2873     if (!p_im)
2874 	restart_edit = 0;	    // don't want insert mode in help file
2875 
2876     return OK;
2877 }
2878 
2879 /*
2880  * Find a non-quickfix window in the current tabpage using the given location
2881  * list stack.
2882  * Returns NULL if a matching window is not found.
2883  */
2884     static win_T *
2885 qf_find_win_with_loclist(qf_info_T *ll)
2886 {
2887     win_T	*wp;
2888 
2889     FOR_ALL_WINDOWS(wp)
2890 	if (wp->w_llist == ll && !bt_quickfix(wp->w_buffer))
2891 	    return wp;
2892 
2893     return NULL;
2894 }
2895 
2896 /*
2897  * Find a window containing a normal buffer
2898  */
2899     static win_T *
2900 qf_find_win_with_normal_buf(void)
2901 {
2902     win_T	*wp;
2903 
2904     FOR_ALL_WINDOWS(wp)
2905 	if (bt_normal(wp->w_buffer))
2906 	    return wp;
2907 
2908     return NULL;
2909 }
2910 
2911 /*
2912  * Go to a window in any tabpage containing the specified file.  Returns TRUE
2913  * if successfully jumped to the window. Otherwise returns FALSE.
2914  */
2915     static int
2916 qf_goto_tabwin_with_file(int fnum)
2917 {
2918     tabpage_T	*tp;
2919     win_T	*wp;
2920 
2921     FOR_ALL_TAB_WINDOWS(tp, wp)
2922 	if (wp->w_buffer->b_fnum == fnum)
2923 	{
2924 	    goto_tabpage_win(tp, wp);
2925 	    return TRUE;
2926 	}
2927 
2928     return FALSE;
2929 }
2930 
2931 /*
2932  * Create a new window to show a file above the quickfix window. Called when
2933  * only the quickfix window is present.
2934  */
2935     static int
2936 qf_open_new_file_win(qf_info_T *ll_ref)
2937 {
2938     int		flags;
2939 
2940     flags = WSP_ABOVE;
2941     if (ll_ref != NULL)
2942 	flags |= WSP_NEWLOC;
2943     if (win_split(0, flags) == FAIL)
2944 	return FAIL;		// not enough room for window
2945     p_swb = empty_option;	// don't split again
2946     swb_flags = 0;
2947     RESET_BINDING(curwin);
2948     if (ll_ref != NULL)
2949 	// The new window should use the location list from the
2950 	// location list window
2951 	win_set_loclist(curwin, ll_ref);
2952     return OK;
2953 }
2954 
2955 /*
2956  * Go to a window that shows the right buffer. If the window is not found, go
2957  * to the window just above the location list window. This is used for opening
2958  * a file from a location window and not from a quickfix window. If some usable
2959  * window is previously found, then it is supplied in 'use_win'.
2960  */
2961     static void
2962 qf_goto_win_with_ll_file(win_T *use_win, int qf_fnum, qf_info_T *ll_ref)
2963 {
2964     win_T	*win = use_win;
2965 
2966     if (win == NULL)
2967     {
2968 	// Find the window showing the selected file
2969 	FOR_ALL_WINDOWS(win)
2970 	    if (win->w_buffer->b_fnum == qf_fnum)
2971 		break;
2972 	if (win == NULL)
2973 	{
2974 	    // Find a previous usable window
2975 	    win = curwin;
2976 	    do
2977 	    {
2978 		if (bt_normal(win->w_buffer))
2979 		    break;
2980 		if (win->w_prev == NULL)
2981 		    win = lastwin;	// wrap around the top
2982 		else
2983 		    win = win->w_prev; // go to previous window
2984 	    } while (win != curwin);
2985 	}
2986     }
2987     win_goto(win);
2988 
2989     // If the location list for the window is not set, then set it
2990     // to the location list from the location window
2991     if (win->w_llist == NULL && ll_ref != NULL)
2992 	win_set_loclist(win, ll_ref);
2993 }
2994 
2995 /*
2996  * Go to a window that contains the specified buffer 'qf_fnum'. If a window is
2997  * not found, then go to the window just above the quickfix window. This is
2998  * used for opening a file from a quickfix window and not from a location
2999  * window.
3000  */
3001     static void
3002 qf_goto_win_with_qfl_file(int qf_fnum)
3003 {
3004     win_T	*win;
3005     win_T	*altwin;
3006 
3007     win = curwin;
3008     altwin = NULL;
3009     for (;;)
3010     {
3011 	if (win->w_buffer->b_fnum == qf_fnum)
3012 	    break;
3013 	if (win->w_prev == NULL)
3014 	    win = lastwin;	// wrap around the top
3015 	else
3016 	    win = win->w_prev;	// go to previous window
3017 
3018 	if (IS_QF_WINDOW(win))
3019 	{
3020 	    // Didn't find it, go to the window before the quickfix
3021 	    // window, unless 'switchbuf' contains 'uselast': in this case we
3022 	    // try to jump to the previously used window first.
3023 	    if ((swb_flags & SWB_USELAST) && win_valid(prevwin))
3024 		win = prevwin;
3025 	    else if (altwin != NULL)
3026 		win = altwin;
3027 	    else if (curwin->w_prev != NULL)
3028 		win = curwin->w_prev;
3029 	    else
3030 		win = curwin->w_next;
3031 	    break;
3032 	}
3033 
3034 	// Remember a usable window.
3035 	if (altwin == NULL && !win->w_p_pvw && bt_normal(win->w_buffer))
3036 	    altwin = win;
3037     }
3038 
3039     win_goto(win);
3040 }
3041 
3042 /*
3043  * Find a suitable window for opening a file (qf_fnum) from the
3044  * quickfix/location list and jump to it.  If the file is already opened in a
3045  * window, jump to it. Otherwise open a new window to display the file. If
3046  * 'newwin' is TRUE, then always open a new window. This is called from either
3047  * a quickfix or a location list window.
3048  */
3049     static int
3050 qf_jump_to_usable_window(int qf_fnum, int newwin, int *opened_window)
3051 {
3052     win_T	*usable_wp = NULL;
3053     int		usable_win = FALSE;
3054     qf_info_T	*ll_ref = NULL;
3055 
3056     // If opening a new window, then don't use the location list referred by
3057     // the current window.  Otherwise two windows will refer to the same
3058     // location list.
3059     if (!newwin)
3060 	ll_ref = curwin->w_llist_ref;
3061 
3062     if (ll_ref != NULL)
3063     {
3064 	// Find a non-quickfix window with this location list
3065 	usable_wp = qf_find_win_with_loclist(ll_ref);
3066 	if (usable_wp != NULL)
3067 	    usable_win = TRUE;
3068     }
3069 
3070     if (!usable_win)
3071     {
3072 	// Locate a window showing a normal buffer
3073 	win_T	*win = qf_find_win_with_normal_buf();
3074 	if (win != NULL)
3075 	    usable_win = TRUE;
3076     }
3077 
3078     // If no usable window is found and 'switchbuf' contains "usetab"
3079     // then search in other tabs.
3080     if (!usable_win && (swb_flags & SWB_USETAB))
3081 	usable_win = qf_goto_tabwin_with_file(qf_fnum);
3082 
3083     // If there is only one window and it is the quickfix window, create a
3084     // new one above the quickfix window.
3085     if ((ONE_WINDOW && bt_quickfix(curbuf)) || !usable_win || newwin)
3086     {
3087 	if (qf_open_new_file_win(ll_ref) != OK)
3088 	    return FAIL;
3089 	*opened_window = TRUE;	// close it when fail
3090     }
3091     else
3092     {
3093 	if (curwin->w_llist_ref != NULL)	// In a location window
3094 	    qf_goto_win_with_ll_file(usable_wp, qf_fnum, ll_ref);
3095 	else					// In a quickfix window
3096 	    qf_goto_win_with_qfl_file(qf_fnum);
3097     }
3098 
3099     return OK;
3100 }
3101 
3102 /*
3103  * Edit the selected file or help file.
3104  * Returns OK if successfully edited the file, FAIL on failing to open the
3105  * buffer and NOTDONE if the quickfix/location list was freed by an autocmd
3106  * when opening the buffer.
3107  */
3108     static int
3109 qf_jump_edit_buffer(
3110 	qf_info_T	*qi,
3111 	qfline_T	*qf_ptr,
3112 	int		forceit,
3113 	int		prev_winid,
3114 	int		*opened_window)
3115 {
3116     qf_list_T	*qfl = qf_get_curlist(qi);
3117     int		old_changedtick = qfl->qf_changedtick;
3118     qfltype_T	qfl_type = qfl->qfl_type;
3119     int		retval = OK;
3120     int		old_qf_curlist = qi->qf_curlist;
3121     int		save_qfid = qfl->qf_id;
3122 
3123     if (qf_ptr->qf_type == 1)
3124     {
3125 	// Open help file (do_ecmd() will set b_help flag, readfile() will
3126 	// set b_p_ro flag).
3127 	if (!can_abandon(curbuf, forceit))
3128 	{
3129 	    no_write_message();
3130 	    return FAIL;
3131 	}
3132 
3133 	retval = do_ecmd(qf_ptr->qf_fnum, NULL, NULL, NULL, (linenr_T)1,
3134 		ECMD_HIDE + ECMD_SET_HELP,
3135 		prev_winid == curwin->w_id ? curwin : NULL);
3136     }
3137     else
3138 	retval = buflist_getfile(qf_ptr->qf_fnum,
3139 		(linenr_T)1, GETF_SETMARK | GETF_SWITCH, forceit);
3140 
3141     // If a location list, check whether the associated window is still
3142     // present.
3143     if (qfl_type == QFLT_LOCATION)
3144     {
3145 	win_T	*wp = win_id2wp(prev_winid);
3146 	if (wp == NULL && curwin->w_llist != qi)
3147 	{
3148 	    emsg(_("E924: Current window was closed"));
3149 	    *opened_window = FALSE;
3150 	    return NOTDONE;
3151 	}
3152     }
3153 
3154     if (qfl_type == QFLT_QUICKFIX && !qflist_valid(NULL, save_qfid))
3155     {
3156 	emsg(_(e_current_quickfix_list_was_changed));
3157 	return NOTDONE;
3158     }
3159 
3160     // Check if the list was changed.  The pointers may happen to be identical,
3161     // thus also check qf_changedtick.
3162     if (old_qf_curlist != qi->qf_curlist
3163 	    || old_changedtick != qfl->qf_changedtick
3164 	    || !is_qf_entry_present(qfl, qf_ptr))
3165     {
3166 	if (qfl_type == QFLT_QUICKFIX)
3167 	    emsg(_(e_current_quickfix_list_was_changed));
3168 	else
3169 	    emsg(_(e_current_location_list_was_changed));
3170 	return NOTDONE;
3171     }
3172 
3173     return retval;
3174 }
3175 
3176 /*
3177  * Go to the error line in the current file using either line/column number or
3178  * a search pattern.
3179  */
3180     static void
3181 qf_jump_goto_line(
3182 	linenr_T	qf_lnum,
3183 	int		qf_col,
3184 	char_u		qf_viscol,
3185 	char_u		*qf_pattern)
3186 {
3187     linenr_T		i;
3188 
3189     if (qf_pattern == NULL)
3190     {
3191 	// Go to line with error, unless qf_lnum is 0.
3192 	i = qf_lnum;
3193 	if (i > 0)
3194 	{
3195 	    if (i > curbuf->b_ml.ml_line_count)
3196 		i = curbuf->b_ml.ml_line_count;
3197 	    curwin->w_cursor.lnum = i;
3198 	}
3199 	if (qf_col > 0)
3200 	{
3201 	    curwin->w_cursor.coladd = 0;
3202 	    if (qf_viscol == TRUE)
3203 		coladvance(qf_col - 1);
3204 	    else
3205 		curwin->w_cursor.col = qf_col - 1;
3206 	    curwin->w_set_curswant = TRUE;
3207 	    check_cursor();
3208 	}
3209 	else
3210 	    beginline(BL_WHITE | BL_FIX);
3211     }
3212     else
3213     {
3214 	pos_T save_cursor;
3215 
3216 	// Move the cursor to the first line in the buffer
3217 	save_cursor = curwin->w_cursor;
3218 	curwin->w_cursor.lnum = 0;
3219 	if (!do_search(NULL, '/', '/', qf_pattern, (long)1, SEARCH_KEEP, NULL))
3220 	    curwin->w_cursor = save_cursor;
3221     }
3222 }
3223 
3224 /*
3225  * Display quickfix list index and size message
3226  */
3227     static void
3228 qf_jump_print_msg(
3229 	qf_info_T	*qi,
3230 	int		qf_index,
3231 	qfline_T	*qf_ptr,
3232 	buf_T		*old_curbuf,
3233 	linenr_T	old_lnum)
3234 {
3235     linenr_T		i;
3236     int			len;
3237 
3238     // Update the screen before showing the message, unless the screen
3239     // scrolled up.
3240     if (!msg_scrolled)
3241 	update_topline_redraw();
3242     sprintf((char *)IObuff, _("(%d of %d)%s%s: "), qf_index,
3243 	    qf_get_curlist(qi)->qf_count,
3244 	    qf_ptr->qf_cleared ? _(" (line deleted)") : "",
3245 	    (char *)qf_types(qf_ptr->qf_type, qf_ptr->qf_nr));
3246     // Add the message, skipping leading whitespace and newlines.
3247     len = (int)STRLEN(IObuff);
3248     qf_fmt_text(skipwhite(qf_ptr->qf_text), IObuff + len, IOSIZE - len);
3249 
3250     // Output the message.  Overwrite to avoid scrolling when the 'O'
3251     // flag is present in 'shortmess'; But when not jumping, print the
3252     // whole message.
3253     i = msg_scroll;
3254     if (curbuf == old_curbuf && curwin->w_cursor.lnum == old_lnum)
3255 	msg_scroll = TRUE;
3256     else if (!msg_scrolled && shortmess(SHM_OVERALL))
3257 	msg_scroll = FALSE;
3258     msg_attr_keep((char *)IObuff, 0, TRUE);
3259     msg_scroll = i;
3260 }
3261 
3262 /*
3263  * Find a usable window for opening a file from the quickfix/location list. If
3264  * a window is not found then open a new window. If 'newwin' is TRUE, then open
3265  * a new window.
3266  * Returns OK if successfully jumped or opened a window. Returns FAIL if not
3267  * able to jump/open a window.  Returns NOTDONE if a file is not associated
3268  * with the entry.
3269  */
3270     static int
3271 qf_jump_open_window(
3272 	qf_info_T	*qi,
3273 	qfline_T	*qf_ptr,
3274 	int		newwin,
3275 	int		*opened_window)
3276 {
3277     qf_list_T	*qfl = qf_get_curlist(qi);
3278     int		old_changedtick = qfl->qf_changedtick;
3279     int		old_qf_curlist = qi->qf_curlist;
3280     qfltype_T	qfl_type = qfl->qfl_type;
3281 
3282     // For ":helpgrep" find a help window or open one.
3283     if (qf_ptr->qf_type == 1 && (!bt_help(curwin->w_buffer)
3284 						      || cmdmod.cmod_tab != 0))
3285 	if (jump_to_help_window(qi, newwin, opened_window) == FAIL)
3286 	    return FAIL;
3287     if (old_qf_curlist != qi->qf_curlist
3288 	    || old_changedtick != qfl->qf_changedtick
3289 	    || !is_qf_entry_present(qfl, qf_ptr))
3290     {
3291 	if (qfl_type == QFLT_QUICKFIX)
3292 	    emsg(_(e_current_quickfix_list_was_changed));
3293 	else
3294 	    emsg(_(e_current_location_list_was_changed));
3295 	return FAIL;
3296     }
3297 
3298     // If currently in the quickfix window, find another window to show the
3299     // file in.
3300     if (bt_quickfix(curbuf) && !*opened_window)
3301     {
3302 	// If there is no file specified, we don't know where to go.
3303 	// But do advance, otherwise ":cn" gets stuck.
3304 	if (qf_ptr->qf_fnum == 0)
3305 	    return NOTDONE;
3306 
3307 	if (qf_jump_to_usable_window(qf_ptr->qf_fnum, newwin,
3308 						opened_window) == FAIL)
3309 	    return FAIL;
3310     }
3311     if (old_qf_curlist != qi->qf_curlist
3312 	    || old_changedtick != qfl->qf_changedtick
3313 	    || !is_qf_entry_present(qfl, qf_ptr))
3314     {
3315 	if (qfl_type == QFLT_QUICKFIX)
3316 	    emsg(_(e_current_quickfix_list_was_changed));
3317 	else
3318 	    emsg(_(e_current_location_list_was_changed));
3319 	return FAIL;
3320     }
3321 
3322     return OK;
3323 }
3324 
3325 /*
3326  * Edit a selected file from the quickfix/location list and jump to a
3327  * particular line/column, adjust the folds and display a message about the
3328  * jump.
3329  * Returns OK on success and FAIL on failing to open the file/buffer.  Returns
3330  * NOTDONE if the quickfix/location list is freed by an autocmd when opening
3331  * the file.
3332  */
3333     static int
3334 qf_jump_to_buffer(
3335 	qf_info_T	*qi,
3336 	int		qf_index,
3337 	qfline_T	*qf_ptr,
3338 	int		forceit,
3339 	int		prev_winid,
3340 	int		*opened_window,
3341 	int		openfold,
3342 	int		print_message)
3343 {
3344     buf_T	*old_curbuf;
3345     linenr_T	old_lnum;
3346     int		retval = OK;
3347 
3348     // If there is a file name, read the wanted file if needed, and check
3349     // autowrite etc.
3350     old_curbuf = curbuf;
3351     old_lnum = curwin->w_cursor.lnum;
3352 
3353     if (qf_ptr->qf_fnum != 0)
3354     {
3355 	retval = qf_jump_edit_buffer(qi, qf_ptr, forceit, prev_winid,
3356 						opened_window);
3357 	if (retval != OK)
3358 	    return retval;
3359     }
3360 
3361     // When not switched to another buffer, still need to set pc mark
3362     if (curbuf == old_curbuf)
3363 	setpcmark();
3364 
3365     qf_jump_goto_line(qf_ptr->qf_lnum, qf_ptr->qf_col, qf_ptr->qf_viscol,
3366 	    qf_ptr->qf_pattern);
3367 
3368 #ifdef FEAT_FOLDING
3369     if ((fdo_flags & FDO_QUICKFIX) && openfold)
3370 	foldOpenCursor();
3371 #endif
3372     if (print_message)
3373 	qf_jump_print_msg(qi, qf_index, qf_ptr, old_curbuf, old_lnum);
3374 
3375     return retval;
3376 }
3377 
3378 /*
3379  * Jump to a quickfix line and try to use an existing window.
3380  */
3381     void
3382 qf_jump(qf_info_T	*qi,
3383 	int		dir,
3384 	int		errornr,
3385 	int		forceit)
3386 {
3387     qf_jump_newwin(qi, dir, errornr, forceit, FALSE);
3388 }
3389 
3390 /*
3391  * Jump to a quickfix line.
3392  * If dir == 0 go to entry "errornr".
3393  * If dir == FORWARD go "errornr" valid entries forward.
3394  * If dir == BACKWARD go "errornr" valid entries backward.
3395  * If dir == FORWARD_FILE go "errornr" valid entries files backward.
3396  * If dir == BACKWARD_FILE go "errornr" valid entries files backward
3397  * else if "errornr" is zero, redisplay the same line
3398  * If 'forceit' is TRUE, then can discard changes to the current buffer.
3399  * If 'newwin' is TRUE, then open the file in a new window.
3400  */
3401     static void
3402 qf_jump_newwin(qf_info_T	*qi,
3403 	int		dir,
3404 	int		errornr,
3405 	int		forceit,
3406 	int		newwin)
3407 {
3408     qf_list_T		*qfl;
3409     qfline_T		*qf_ptr;
3410     qfline_T		*old_qf_ptr;
3411     int			qf_index;
3412     int			old_qf_index;
3413     char_u		*old_swb = p_swb;
3414     unsigned		old_swb_flags = swb_flags;
3415     int			prev_winid;
3416     int			opened_window = FALSE;
3417     int			print_message = TRUE;
3418     int			old_KeyTyped = KeyTyped; // getting file may reset it
3419     int			retval = OK;
3420 
3421     if (qi == NULL)
3422 	qi = &ql_info;
3423 
3424     if (qf_stack_empty(qi) || qf_list_empty(qf_get_curlist(qi)))
3425     {
3426 	emsg(_(e_quickfix));
3427 	return;
3428     }
3429 
3430     incr_quickfix_busy();
3431 
3432     qfl = qf_get_curlist(qi);
3433 
3434     qf_ptr = qfl->qf_ptr;
3435     old_qf_ptr = qf_ptr;
3436     qf_index = qfl->qf_index;
3437     old_qf_index = qf_index;
3438 
3439     qf_ptr = qf_get_entry(qfl, errornr, dir, &qf_index);
3440     if (qf_ptr == NULL)
3441     {
3442 	qf_ptr = old_qf_ptr;
3443 	qf_index = old_qf_index;
3444 	goto theend;
3445     }
3446 
3447     qfl->qf_index = qf_index;
3448     if (qf_win_pos_update(qi, old_qf_index))
3449 	// No need to print the error message if it's visible in the error
3450 	// window
3451 	print_message = FALSE;
3452 
3453     prev_winid = curwin->w_id;
3454 
3455     retval = qf_jump_open_window(qi, qf_ptr, newwin, &opened_window);
3456     if (retval == FAIL)
3457 	goto failed;
3458     if (retval == NOTDONE)
3459 	goto theend;
3460 
3461     retval = qf_jump_to_buffer(qi, qf_index, qf_ptr, forceit, prev_winid,
3462 				  &opened_window, old_KeyTyped, print_message);
3463     if (retval == NOTDONE)
3464     {
3465 	// Quickfix/location list is freed by an autocmd
3466 	qi = NULL;
3467 	qf_ptr = NULL;
3468     }
3469 
3470     if (retval != OK)
3471     {
3472 	if (opened_window)
3473 	    win_close(curwin, TRUE);    // Close opened window
3474 	if (qf_ptr != NULL && qf_ptr->qf_fnum != 0)
3475 	{
3476 	    // Couldn't open file, so put index back where it was.  This could
3477 	    // happen if the file was readonly and we changed something.
3478 failed:
3479 	    qf_ptr = old_qf_ptr;
3480 	    qf_index = old_qf_index;
3481 	}
3482     }
3483 theend:
3484     if (qi != NULL)
3485     {
3486 	qfl->qf_ptr = qf_ptr;
3487 	qfl->qf_index = qf_index;
3488     }
3489     if (p_swb != old_swb && p_swb == empty_option)
3490     {
3491 	// Restore old 'switchbuf' value, but not when an autocommand or
3492 	// modeline has changed the value.
3493 	p_swb = old_swb;
3494 	swb_flags = old_swb_flags;
3495     }
3496     decr_quickfix_busy();
3497 }
3498 
3499 // Highlight attributes used for displaying entries from the quickfix list.
3500 static int	qfFileAttr;
3501 static int	qfSepAttr;
3502 static int	qfLineAttr;
3503 
3504 /*
3505  * Display information about a single entry from the quickfix/location list.
3506  * Used by ":clist/:llist" commands.
3507  * 'cursel' will be set to TRUE for the currently selected entry in the
3508  * quickfix list.
3509  */
3510     static void
3511 qf_list_entry(qfline_T *qfp, int qf_idx, int cursel)
3512 {
3513     char_u	*fname;
3514     buf_T	*buf;
3515     int		filter_entry;
3516 
3517     fname = NULL;
3518     if (qfp->qf_module != NULL && *qfp->qf_module != NUL)
3519 	vim_snprintf((char *)IObuff, IOSIZE, "%2d %s", qf_idx,
3520 						(char *)qfp->qf_module);
3521     else {
3522 	if (qfp->qf_fnum != 0
3523 		&& (buf = buflist_findnr(qfp->qf_fnum)) != NULL)
3524 	{
3525 	    fname = buf->b_fname;
3526 	    if (qfp->qf_type == 1)	// :helpgrep
3527 		fname = gettail(fname);
3528 	}
3529 	if (fname == NULL)
3530 	    sprintf((char *)IObuff, "%2d", qf_idx);
3531 	else
3532 	    vim_snprintf((char *)IObuff, IOSIZE, "%2d %s",
3533 		    qf_idx, (char *)fname);
3534     }
3535 
3536     // Support for filtering entries using :filter /pat/ clist
3537     // Match against the module name, file name, search pattern and
3538     // text of the entry.
3539     filter_entry = TRUE;
3540     if (qfp->qf_module != NULL && *qfp->qf_module != NUL)
3541 	filter_entry &= message_filtered(qfp->qf_module);
3542     if (filter_entry && fname != NULL)
3543 	filter_entry &= message_filtered(fname);
3544     if (filter_entry && qfp->qf_pattern != NULL)
3545 	filter_entry &= message_filtered(qfp->qf_pattern);
3546     if (filter_entry)
3547 	filter_entry &= message_filtered(qfp->qf_text);
3548     if (filter_entry)
3549 	return;
3550 
3551     msg_putchar('\n');
3552     msg_outtrans_attr(IObuff, cursel ? HL_ATTR(HLF_QFL) : qfFileAttr);
3553 
3554     if (qfp->qf_lnum != 0)
3555 	msg_puts_attr(":", qfSepAttr);
3556     if (qfp->qf_lnum == 0)
3557 	IObuff[0] = NUL;
3558     else if (qfp->qf_col == 0)
3559 	sprintf((char *)IObuff, "%ld", qfp->qf_lnum);
3560     else
3561 	sprintf((char *)IObuff, "%ld col %d",
3562 		qfp->qf_lnum, qfp->qf_col);
3563     sprintf((char *)IObuff + STRLEN(IObuff), "%s",
3564 	    (char *)qf_types(qfp->qf_type, qfp->qf_nr));
3565     msg_puts_attr((char *)IObuff, qfLineAttr);
3566     msg_puts_attr(":", qfSepAttr);
3567     if (qfp->qf_pattern != NULL)
3568     {
3569 	qf_fmt_text(qfp->qf_pattern, IObuff, IOSIZE);
3570 	msg_puts((char *)IObuff);
3571 	msg_puts_attr(":", qfSepAttr);
3572     }
3573     msg_puts(" ");
3574 
3575     // Remove newlines and leading whitespace from the text.  For an
3576     // unrecognized line keep the indent, the compiler may mark a word
3577     // with ^^^^.
3578     qf_fmt_text((fname != NULL || qfp->qf_lnum != 0)
3579 				? skipwhite(qfp->qf_text) : qfp->qf_text,
3580 				IObuff, IOSIZE);
3581     msg_prt_line(IObuff, FALSE);
3582     out_flush();		// show one line at a time
3583 }
3584 
3585 /*
3586  * ":clist": list all errors
3587  * ":llist": list all locations
3588  */
3589     void
3590 qf_list(exarg_T *eap)
3591 {
3592     qf_list_T	*qfl;
3593     qfline_T	*qfp;
3594     int		i;
3595     int		idx1 = 1;
3596     int		idx2 = -1;
3597     char_u	*arg = eap->arg;
3598     int		plus = FALSE;
3599     int		all = eap->forceit;	// if not :cl!, only show
3600 					// recognised errors
3601     qf_info_T	*qi;
3602 
3603     if ((qi = qf_cmd_get_stack(eap, TRUE)) == NULL)
3604 	return;
3605 
3606     if (qf_stack_empty(qi) || qf_list_empty(qf_get_curlist(qi)))
3607     {
3608 	emsg(_(e_quickfix));
3609 	return;
3610     }
3611     if (*arg == '+')
3612     {
3613 	++arg;
3614 	plus = TRUE;
3615     }
3616     if (!get_list_range(&arg, &idx1, &idx2) || *arg != NUL)
3617     {
3618 	semsg(_(e_trailing_arg), arg);
3619 	return;
3620     }
3621     qfl = qf_get_curlist(qi);
3622     if (plus)
3623     {
3624 	i = qfl->qf_index;
3625 	idx2 = i + idx1;
3626 	idx1 = i;
3627     }
3628     else
3629     {
3630 	i = qfl->qf_count;
3631 	if (idx1 < 0)
3632 	    idx1 = (-idx1 > i) ? 0 : idx1 + i + 1;
3633 	if (idx2 < 0)
3634 	    idx2 = (-idx2 > i) ? 0 : idx2 + i + 1;
3635     }
3636 
3637     // Shorten all the file names, so that it is easy to read
3638     shorten_fnames(FALSE);
3639 
3640     // Get the attributes for the different quickfix highlight items.  Note
3641     // that this depends on syntax items defined in the qf.vim syntax file
3642     qfFileAttr = syn_name2attr((char_u *)"qfFileName");
3643     if (qfFileAttr == 0)
3644 	qfFileAttr = HL_ATTR(HLF_D);
3645     qfSepAttr = syn_name2attr((char_u *)"qfSeparator");
3646     if (qfSepAttr == 0)
3647 	qfSepAttr = HL_ATTR(HLF_D);
3648     qfLineAttr = syn_name2attr((char_u *)"qfLineNr");
3649     if (qfLineAttr == 0)
3650 	qfLineAttr = HL_ATTR(HLF_N);
3651 
3652     if (qfl->qf_nonevalid)
3653 	all = TRUE;
3654     FOR_ALL_QFL_ITEMS(qfl, qfp, i)
3655     {
3656 	if ((qfp->qf_valid || all) && idx1 <= i && i <= idx2)
3657 	    qf_list_entry(qfp, i, i == qfl->qf_index);
3658 
3659 	ui_breakcheck();
3660     }
3661 }
3662 
3663 /*
3664  * Remove newlines and leading whitespace from an error message.
3665  * Put the result in "buf[bufsize]".
3666  */
3667     static void
3668 qf_fmt_text(char_u *text, char_u *buf, int bufsize)
3669 {
3670     int		i;
3671     char_u	*p = text;
3672 
3673     for (i = 0; *p != NUL && i < bufsize - 1; ++i)
3674     {
3675 	if (*p == '\n')
3676 	{
3677 	    buf[i] = ' ';
3678 	    while (*++p != NUL)
3679 		if (!VIM_ISWHITE(*p) && *p != '\n')
3680 		    break;
3681 	}
3682 	else
3683 	    buf[i] = *p++;
3684     }
3685     buf[i] = NUL;
3686 }
3687 
3688 /*
3689  * Display information (list number, list size and the title) about a
3690  * quickfix/location list.
3691  */
3692     static void
3693 qf_msg(qf_info_T *qi, int which, char *lead)
3694 {
3695     char   *title = (char *)qi->qf_lists[which].qf_title;
3696     int    count = qi->qf_lists[which].qf_count;
3697     char_u buf[IOSIZE];
3698 
3699     vim_snprintf((char *)buf, IOSIZE, _("%serror list %d of %d; %d errors "),
3700 	    lead,
3701 	    which + 1,
3702 	    qi->qf_listcount,
3703 	    count);
3704 
3705     if (title != NULL)
3706     {
3707 	size_t	len = STRLEN(buf);
3708 
3709 	if (len < 34)
3710 	{
3711 	    vim_memset(buf + len, ' ', 34 - len);
3712 	    buf[34] = NUL;
3713 	}
3714 	vim_strcat(buf, (char_u *)title, IOSIZE);
3715     }
3716     trunc_string(buf, buf, Columns - 1, IOSIZE);
3717     msg((char *)buf);
3718 }
3719 
3720 /*
3721  * ":colder [count]": Up in the quickfix stack.
3722  * ":cnewer [count]": Down in the quickfix stack.
3723  * ":lolder [count]": Up in the location list stack.
3724  * ":lnewer [count]": Down in the location list stack.
3725  */
3726     void
3727 qf_age(exarg_T *eap)
3728 {
3729     qf_info_T	*qi;
3730     int		count;
3731 
3732     if ((qi = qf_cmd_get_stack(eap, TRUE)) == NULL)
3733 	return;
3734 
3735     if (eap->addr_count != 0)
3736 	count = eap->line2;
3737     else
3738 	count = 1;
3739     while (count--)
3740     {
3741 	if (eap->cmdidx == CMD_colder || eap->cmdidx == CMD_lolder)
3742 	{
3743 	    if (qi->qf_curlist == 0)
3744 	    {
3745 		emsg(_("E380: At bottom of quickfix stack"));
3746 		break;
3747 	    }
3748 	    --qi->qf_curlist;
3749 	}
3750 	else
3751 	{
3752 	    if (qi->qf_curlist >= qi->qf_listcount - 1)
3753 	    {
3754 		emsg(_("E381: At top of quickfix stack"));
3755 		break;
3756 	    }
3757 	    ++qi->qf_curlist;
3758 	}
3759     }
3760     qf_msg(qi, qi->qf_curlist, "");
3761     qf_update_buffer(qi, NULL);
3762 }
3763 
3764 /*
3765  * Display the information about all the quickfix/location lists in the stack
3766  */
3767     void
3768 qf_history(exarg_T *eap)
3769 {
3770     qf_info_T	*qi = qf_cmd_get_stack(eap, FALSE);
3771     int		i;
3772 
3773     if (eap->addr_count > 0)
3774     {
3775 	if (qi == NULL)
3776 	{
3777 	    emsg(_(e_loclist));
3778 	    return;
3779 	}
3780 
3781 	// Jump to the specified quickfix list
3782 	if (eap->line2 > 0 && eap->line2 <= qi->qf_listcount)
3783 	{
3784 	    qi->qf_curlist = eap->line2 - 1;
3785 	    qf_msg(qi, qi->qf_curlist, "");
3786 	    qf_update_buffer(qi, NULL);
3787 	}
3788 	else
3789 	    emsg(_(e_invrange));
3790 
3791 	return;
3792     }
3793 
3794     if (qf_stack_empty(qi))
3795 	msg(_("No entries"));
3796     else
3797 	for (i = 0; i < qi->qf_listcount; ++i)
3798 	    qf_msg(qi, i, i == qi->qf_curlist ? "> " : "  ");
3799 }
3800 
3801 /*
3802  * Free all the entries in the error list "idx". Note that other information
3803  * associated with the list like context and title are not freed.
3804  */
3805     static void
3806 qf_free_items(qf_list_T *qfl)
3807 {
3808     qfline_T	*qfp;
3809     qfline_T	*qfpnext;
3810     int		stop = FALSE;
3811 
3812     while (qfl->qf_count && qfl->qf_start != NULL)
3813     {
3814 	qfp = qfl->qf_start;
3815 	qfpnext = qfp->qf_next;
3816 	if (!stop)
3817 	{
3818 	    vim_free(qfp->qf_module);
3819 	    vim_free(qfp->qf_text);
3820 	    vim_free(qfp->qf_pattern);
3821 	    stop = (qfp == qfpnext);
3822 	    vim_free(qfp);
3823 	    if (stop)
3824 		// Somehow qf_count may have an incorrect value, set it to 1
3825 		// to avoid crashing when it's wrong.
3826 		// TODO: Avoid qf_count being incorrect.
3827 		qfl->qf_count = 1;
3828 	}
3829 	qfl->qf_start = qfpnext;
3830 	--qfl->qf_count;
3831     }
3832 
3833     qfl->qf_index = 0;
3834     qfl->qf_start = NULL;
3835     qfl->qf_last = NULL;
3836     qfl->qf_ptr = NULL;
3837     qfl->qf_nonevalid = TRUE;
3838 
3839     qf_clean_dir_stack(&qfl->qf_dir_stack);
3840     qfl->qf_directory = NULL;
3841     qf_clean_dir_stack(&qfl->qf_file_stack);
3842     qfl->qf_currfile = NULL;
3843     qfl->qf_multiline = FALSE;
3844     qfl->qf_multiignore = FALSE;
3845     qfl->qf_multiscan = FALSE;
3846 }
3847 
3848 /*
3849  * Free error list "idx". Frees all the entries in the quickfix list,
3850  * associated context information and the title.
3851  */
3852     static void
3853 qf_free(qf_list_T *qfl)
3854 {
3855     qf_free_items(qfl);
3856 
3857     VIM_CLEAR(qfl->qf_title);
3858     free_tv(qfl->qf_ctx);
3859     qfl->qf_ctx = NULL;
3860     free_callback(&qfl->qftf_cb);
3861     qfl->qf_id = 0;
3862     qfl->qf_changedtick = 0L;
3863 }
3864 
3865 /*
3866  * qf_mark_adjust: adjust marks
3867  */
3868    void
3869 qf_mark_adjust(
3870 	win_T	*wp,
3871 	linenr_T	line1,
3872 	linenr_T	line2,
3873 	long	amount,
3874 	long	amount_after)
3875 {
3876     int		i;
3877     qfline_T	*qfp;
3878     int		idx;
3879     qf_info_T	*qi = &ql_info;
3880     int		found_one = FALSE;
3881     int		buf_has_flag = wp == NULL ? BUF_HAS_QF_ENTRY : BUF_HAS_LL_ENTRY;
3882 
3883     if (!(curbuf->b_has_qf_entry & buf_has_flag))
3884 	return;
3885     if (wp != NULL)
3886     {
3887 	if (wp->w_llist == NULL)
3888 	    return;
3889 	qi = wp->w_llist;
3890     }
3891 
3892     for (idx = 0; idx < qi->qf_listcount; ++idx)
3893     {
3894 	qf_list_T	*qfl = qf_get_list(qi, idx);
3895 
3896 	if (!qf_list_empty(qfl))
3897 	    FOR_ALL_QFL_ITEMS(qfl, qfp, i)
3898 		if (qfp->qf_fnum == curbuf->b_fnum)
3899 		{
3900 		    found_one = TRUE;
3901 		    if (qfp->qf_lnum >= line1 && qfp->qf_lnum <= line2)
3902 		    {
3903 			if (amount == MAXLNUM)
3904 			    qfp->qf_cleared = TRUE;
3905 			else
3906 			    qfp->qf_lnum += amount;
3907 		    }
3908 		    else if (amount_after && qfp->qf_lnum > line2)
3909 			qfp->qf_lnum += amount_after;
3910 		}
3911     }
3912 
3913     if (!found_one)
3914 	curbuf->b_has_qf_entry &= ~buf_has_flag;
3915 }
3916 
3917 /*
3918  * Make a nice message out of the error character and the error number:
3919  *  char    number	message
3920  *  e or E    0		" error"
3921  *  w or W    0		" warning"
3922  *  i or I    0		" info"
3923  *  n or N    0		" note"
3924  *  0	      0		""
3925  *  other     0		" c"
3926  *  e or E    n		" error n"
3927  *  w or W    n		" warning n"
3928  *  i or I    n		" info n"
3929  *  n or N    n		" note n"
3930  *  0	      n		" error n"
3931  *  other     n		" c n"
3932  *  1	      x		""	:helpgrep
3933  */
3934     static char_u *
3935 qf_types(int c, int nr)
3936 {
3937     static char_u	buf[20];
3938     static char_u	cc[3];
3939     char_u		*p;
3940 
3941     if (c == 'W' || c == 'w')
3942 	p = (char_u *)" warning";
3943     else if (c == 'I' || c == 'i')
3944 	p = (char_u *)" info";
3945     else if (c == 'N' || c == 'n')
3946 	p = (char_u *)" note";
3947     else if (c == 'E' || c == 'e' || (c == 0 && nr > 0))
3948 	p = (char_u *)" error";
3949     else if (c == 0 || c == 1)
3950 	p = (char_u *)"";
3951     else
3952     {
3953 	cc[0] = ' ';
3954 	cc[1] = c;
3955 	cc[2] = NUL;
3956 	p = cc;
3957     }
3958 
3959     if (nr <= 0)
3960 	return p;
3961 
3962     sprintf((char *)buf, "%s %3d", (char *)p, nr);
3963     return buf;
3964 }
3965 
3966 /*
3967  * When "split" is FALSE: Open the entry/result under the cursor.
3968  * When "split" is TRUE: Open the entry/result under the cursor in a new window.
3969  */
3970     void
3971 qf_view_result(int split)
3972 {
3973     qf_info_T   *qi = &ql_info;
3974 
3975     if (!bt_quickfix(curbuf))
3976 	return;
3977 
3978     if (IS_LL_WINDOW(curwin))
3979 	qi = GET_LOC_LIST(curwin);
3980 
3981     if (qf_list_empty(qf_get_curlist(qi)))
3982     {
3983 	emsg(_(e_quickfix));
3984 	return;
3985     }
3986 
3987     if (split)
3988     {
3989 	// Open the selected entry in a new window
3990 	qf_jump_newwin(qi, 0, (long)curwin->w_cursor.lnum, FALSE, TRUE);
3991 	do_cmdline_cmd((char_u *) "clearjumps");
3992 	return;
3993     }
3994 
3995     do_cmdline_cmd((char_u *)(IS_LL_WINDOW(curwin) ? ".ll" : ".cc"));
3996 }
3997 
3998 /*
3999  * ":cwindow": open the quickfix window if we have errors to display,
4000  *	       close it if not.
4001  * ":lwindow": open the location list window if we have locations to display,
4002  *	       close it if not.
4003  */
4004     void
4005 ex_cwindow(exarg_T *eap)
4006 {
4007     qf_info_T	*qi;
4008     qf_list_T	*qfl;
4009     win_T	*win;
4010 
4011     if ((qi = qf_cmd_get_stack(eap, TRUE)) == NULL)
4012 	return;
4013 
4014     qfl = qf_get_curlist(qi);
4015 
4016     // Look for an existing quickfix window.
4017     win = qf_find_win(qi);
4018 
4019     // If a quickfix window is open but we have no errors to display,
4020     // close the window.  If a quickfix window is not open, then open
4021     // it if we have errors; otherwise, leave it closed.
4022     if (qf_stack_empty(qi)
4023 	    || qfl->qf_nonevalid
4024 	    || qf_list_empty(qfl))
4025     {
4026 	if (win != NULL)
4027 	    ex_cclose(eap);
4028     }
4029     else if (win == NULL)
4030 	ex_copen(eap);
4031 }
4032 
4033 /*
4034  * ":cclose": close the window showing the list of errors.
4035  * ":lclose": close the window showing the location list
4036  */
4037     void
4038 ex_cclose(exarg_T *eap)
4039 {
4040     win_T	*win = NULL;
4041     qf_info_T	*qi;
4042 
4043     if ((qi = qf_cmd_get_stack(eap, FALSE)) == NULL)
4044 	return;
4045 
4046     // Find existing quickfix window and close it.
4047     win = qf_find_win(qi);
4048     if (win != NULL)
4049 	win_close(win, FALSE);
4050 }
4051 
4052 /*
4053  * Set "w:quickfix_title" if "qi" has a title.
4054  */
4055     static void
4056 qf_set_title_var(qf_list_T *qfl)
4057 {
4058     if (qfl->qf_title != NULL)
4059 	set_internal_string_var((char_u *)"w:quickfix_title", qfl->qf_title);
4060 }
4061 
4062 /*
4063  * Goto a quickfix or location list window (if present).
4064  * Returns OK if the window is found, FAIL otherwise.
4065  */
4066     static int
4067 qf_goto_cwindow(qf_info_T *qi, int resize, int sz, int vertsplit)
4068 {
4069     win_T	*win;
4070 
4071     win = qf_find_win(qi);
4072     if (win == NULL)
4073 	return FAIL;
4074 
4075     win_goto(win);
4076     if (resize)
4077     {
4078 	if (vertsplit)
4079 	{
4080 	    if (sz != win->w_width)
4081 		win_setwidth(sz);
4082 	}
4083 	else if (sz != win->w_height && win->w_height
4084 		       + win->w_status_height + tabline_height() < cmdline_row)
4085 	    win_setheight(sz);
4086     }
4087 
4088     return OK;
4089 }
4090 
4091 /*
4092  * Set options for the buffer in the quickfix or location list window.
4093  */
4094     static void
4095 qf_set_cwindow_options(void)
4096 {
4097     // switch off 'swapfile'
4098     set_option_value((char_u *)"swf", 0L, NULL, OPT_LOCAL);
4099     set_option_value((char_u *)"bt", 0L, (char_u *)"quickfix",
4100 	    OPT_LOCAL);
4101     set_option_value((char_u *)"bh", 0L, (char_u *)"hide", OPT_LOCAL);
4102     RESET_BINDING(curwin);
4103 #ifdef FEAT_DIFF
4104     curwin->w_p_diff = FALSE;
4105 #endif
4106 #ifdef FEAT_FOLDING
4107     set_option_value((char_u *)"fdm", 0L, (char_u *)"manual",
4108 	    OPT_LOCAL);
4109 #endif
4110 }
4111 
4112 /*
4113  * Open a new quickfix or location list window, load the quickfix buffer and
4114  * set the appropriate options for the window.
4115  * Returns FAIL if the window could not be opened.
4116  */
4117     static int
4118 qf_open_new_cwindow(qf_info_T *qi, int height)
4119 {
4120     buf_T	*qf_buf;
4121     win_T	*oldwin = curwin;
4122     tabpage_T	*prevtab = curtab;
4123     int		flags = 0;
4124     win_T	*win;
4125 
4126     qf_buf = qf_find_buf(qi);
4127 
4128     // The current window becomes the previous window afterwards.
4129     win = curwin;
4130 
4131     if (IS_QF_STACK(qi) && cmdmod.cmod_split == 0)
4132 	// Create the new quickfix window at the very bottom, except when
4133 	// :belowright or :aboveleft is used.
4134 	win_goto(lastwin);
4135     // Default is to open the window below the current window
4136     if (cmdmod.cmod_split == 0)
4137 	flags = WSP_BELOW;
4138     flags |= WSP_NEWLOC;
4139     if (win_split(height, flags) == FAIL)
4140 	return FAIL;		// not enough room for window
4141     RESET_BINDING(curwin);
4142 
4143     if (IS_LL_STACK(qi))
4144     {
4145 	// For the location list window, create a reference to the
4146 	// location list stack from the window 'win'.
4147 	curwin->w_llist_ref = qi;
4148 	qi->qf_refcount++;
4149     }
4150 
4151     if (oldwin != curwin)
4152 	oldwin = NULL;  // don't store info when in another window
4153     if (qf_buf != NULL)
4154     {
4155 	// Use the existing quickfix buffer
4156 	if (do_ecmd(qf_buf->b_fnum, NULL, NULL, NULL, ECMD_ONE,
4157 				      ECMD_HIDE + ECMD_OLDBUF, oldwin) == FAIL)
4158 	    return FAIL;
4159     }
4160     else
4161     {
4162 	// Create a new quickfix buffer
4163 	if (do_ecmd(0, NULL, NULL, NULL, ECMD_ONE, ECMD_HIDE, oldwin) == FAIL)
4164 	    return FAIL;
4165 
4166 	// save the number of the new buffer
4167 	qi->qf_bufnr = curbuf->b_fnum;
4168     }
4169 
4170     // Set the options for the quickfix buffer/window (if not already done)
4171     // Do this even if the quickfix buffer was already present, as an autocmd
4172     // might have previously deleted (:bdelete) the quickfix buffer.
4173     if (!bt_quickfix(curbuf))
4174 	qf_set_cwindow_options();
4175 
4176     // Only set the height when still in the same tab page and there is no
4177     // window to the side.
4178     if (curtab == prevtab && curwin->w_width == Columns)
4179 	win_setheight(height);
4180     curwin->w_p_wfh = TRUE;	    // set 'winfixheight'
4181     if (win_valid(win))
4182 	prevwin = win;
4183 
4184     return OK;
4185 }
4186 
4187 /*
4188  * ":copen": open a window that shows the list of errors.
4189  * ":lopen": open a window that shows the location list.
4190  */
4191     void
4192 ex_copen(exarg_T *eap)
4193 {
4194     qf_info_T	*qi;
4195     qf_list_T	*qfl;
4196     int		height;
4197     int		status = FAIL;
4198     int		lnum;
4199 
4200     if ((qi = qf_cmd_get_stack(eap, TRUE)) == NULL)
4201 	return;
4202 
4203     incr_quickfix_busy();
4204 
4205     if (eap->addr_count != 0)
4206 	height = eap->line2;
4207     else
4208 	height = QF_WINHEIGHT;
4209 
4210     reset_VIsual_and_resel();			// stop Visual mode
4211 #ifdef FEAT_GUI
4212     need_mouse_correct = TRUE;
4213 #endif
4214 
4215     // Find an existing quickfix window, or open a new one.
4216     if (cmdmod.cmod_tab == 0)
4217 	status = qf_goto_cwindow(qi, eap->addr_count != 0, height,
4218 						cmdmod.cmod_split & WSP_VERT);
4219     if (status == FAIL)
4220 	if (qf_open_new_cwindow(qi, height) == FAIL)
4221 	{
4222 	    decr_quickfix_busy();
4223 	    return;
4224 	}
4225 
4226     qfl = qf_get_curlist(qi);
4227     qf_set_title_var(qfl);
4228     // Save the current index here, as updating the quickfix buffer may free
4229     // the quickfix list
4230     lnum = qfl->qf_index;
4231 
4232     // Fill the buffer with the quickfix list.
4233     qf_fill_buffer(qfl, curbuf, NULL, curwin->w_id);
4234 
4235     decr_quickfix_busy();
4236 
4237     curwin->w_cursor.lnum = lnum;
4238     curwin->w_cursor.col = 0;
4239     check_cursor();
4240     update_topline();		// scroll to show the line
4241 }
4242 
4243 /*
4244  * Move the cursor in the quickfix window to "lnum".
4245  */
4246     static void
4247 qf_win_goto(win_T *win, linenr_T lnum)
4248 {
4249     win_T	*old_curwin = curwin;
4250 
4251     curwin = win;
4252     curbuf = win->w_buffer;
4253     curwin->w_cursor.lnum = lnum;
4254     curwin->w_cursor.col = 0;
4255     curwin->w_cursor.coladd = 0;
4256     curwin->w_curswant = 0;
4257     update_topline();		// scroll to show the line
4258     redraw_later(VALID);
4259     curwin->w_redr_status = TRUE;	// update ruler
4260     curwin = old_curwin;
4261     curbuf = curwin->w_buffer;
4262 }
4263 
4264 /*
4265  * :cbottom/:lbottom commands.
4266  */
4267     void
4268 ex_cbottom(exarg_T *eap)
4269 {
4270     qf_info_T	*qi;
4271     win_T	*win;
4272 
4273     if ((qi = qf_cmd_get_stack(eap, TRUE)) == NULL)
4274 	return;
4275 
4276     win = qf_find_win(qi);
4277     if (win != NULL && win->w_cursor.lnum != win->w_buffer->b_ml.ml_line_count)
4278 	qf_win_goto(win, win->w_buffer->b_ml.ml_line_count);
4279 }
4280 
4281 /*
4282  * Return the number of the current entry (line number in the quickfix
4283  * window).
4284  */
4285      linenr_T
4286 qf_current_entry(win_T *wp)
4287 {
4288     qf_info_T	*qi = &ql_info;
4289 
4290     if (IS_LL_WINDOW(wp))
4291 	// In the location list window, use the referenced location list
4292 	qi = wp->w_llist_ref;
4293 
4294     return qf_get_curlist(qi)->qf_index;
4295 }
4296 
4297 /*
4298  * Update the cursor position in the quickfix window to the current error.
4299  * Return TRUE if there is a quickfix window.
4300  */
4301     static int
4302 qf_win_pos_update(
4303     qf_info_T	*qi,
4304     int		old_qf_index)	// previous qf_index or zero
4305 {
4306     win_T	*win;
4307     int		qf_index = qf_get_curlist(qi)->qf_index;
4308 
4309     // Put the cursor on the current error in the quickfix window, so that
4310     // it's viewable.
4311     win = qf_find_win(qi);
4312     if (win != NULL
4313 	    && qf_index <= win->w_buffer->b_ml.ml_line_count
4314 	    && old_qf_index != qf_index)
4315     {
4316 	if (qf_index > old_qf_index)
4317 	{
4318 	    win->w_redraw_top = old_qf_index;
4319 	    win->w_redraw_bot = qf_index;
4320 	}
4321 	else
4322 	{
4323 	    win->w_redraw_top = qf_index;
4324 	    win->w_redraw_bot = old_qf_index;
4325 	}
4326 	qf_win_goto(win, qf_index);
4327     }
4328     return win != NULL;
4329 }
4330 
4331 /*
4332  * Check whether the given window is displaying the specified quickfix/location
4333  * stack.
4334  */
4335     static int
4336 is_qf_win(win_T *win, qf_info_T *qi)
4337 {
4338     // A window displaying the quickfix buffer will have the w_llist_ref field
4339     // set to NULL.
4340     // A window displaying a location list buffer will have the w_llist_ref
4341     // pointing to the location list.
4342     if (bt_quickfix(win->w_buffer))
4343 	if ((IS_QF_STACK(qi) && win->w_llist_ref == NULL)
4344 		|| (IS_LL_STACK(qi) && win->w_llist_ref == qi))
4345 	    return TRUE;
4346 
4347     return FALSE;
4348 }
4349 
4350 /*
4351  * Find a window displaying the quickfix/location stack 'qi'
4352  * Only searches in the current tabpage.
4353  */
4354     static win_T *
4355 qf_find_win(qf_info_T *qi)
4356 {
4357     win_T	*win;
4358 
4359     FOR_ALL_WINDOWS(win)
4360 	if (is_qf_win(win, qi))
4361 	    return win;
4362     return NULL;
4363 }
4364 
4365 /*
4366  * Find a quickfix buffer.
4367  * Searches in windows opened in all the tabs.
4368  */
4369     static buf_T *
4370 qf_find_buf(qf_info_T *qi)
4371 {
4372     tabpage_T	*tp;
4373     win_T	*win;
4374 
4375     if (qi->qf_bufnr != INVALID_QFBUFNR)
4376     {
4377 	buf_T	*qfbuf;
4378 	qfbuf = buflist_findnr(qi->qf_bufnr);
4379 	if (qfbuf != NULL)
4380 	    return qfbuf;
4381 	// buffer is no longer present
4382 	qi->qf_bufnr = INVALID_QFBUFNR;
4383     }
4384 
4385     FOR_ALL_TAB_WINDOWS(tp, win)
4386 	if (is_qf_win(win, qi))
4387 	    return win->w_buffer;
4388 
4389     return NULL;
4390 }
4391 
4392 /*
4393  * Process the 'quickfixtextfunc' option value.
4394  */
4395     int
4396 qf_process_qftf_option(void)
4397 {
4398     typval_T	*tv;
4399     callback_T	cb;
4400 
4401     if (p_qftf == NULL || *p_qftf == NUL)
4402     {
4403 	free_callback(&qftf_cb);
4404 	return TRUE;
4405     }
4406 
4407     if (*p_qftf == '{')
4408     {
4409 	// Lambda expression
4410 	tv = eval_expr(p_qftf, NULL);
4411 	if (tv == NULL)
4412 	    return FALSE;
4413     }
4414     else
4415     {
4416 	// treat everything else as a function name string
4417 	tv = alloc_string_tv(vim_strsave(p_qftf));
4418 	if (tv == NULL)
4419 	    return FALSE;
4420     }
4421 
4422     cb = get_callback(tv);
4423     if (cb.cb_name == NULL)
4424     {
4425 	free_tv(tv);
4426 	return FALSE;
4427     }
4428 
4429     free_callback(&qftf_cb);
4430     set_callback(&qftf_cb, &cb);
4431     free_tv(tv);
4432     return TRUE;
4433 }
4434 
4435 /*
4436  * Update the w:quickfix_title variable in the quickfix/location list window in
4437  * all the tab pages.
4438  */
4439     static void
4440 qf_update_win_titlevar(qf_info_T *qi)
4441 {
4442     qf_list_T	*qfl = qf_get_curlist(qi);
4443     tabpage_T	*tp;
4444     win_T	*win;
4445     win_T	*save_curwin = curwin;
4446 
4447     FOR_ALL_TAB_WINDOWS(tp, win)
4448     {
4449 	if (is_qf_win(win, qi))
4450 	{
4451 	    curwin = win;
4452 	    qf_set_title_var(qfl);
4453 	}
4454     }
4455     curwin = save_curwin;
4456 }
4457 
4458 /*
4459  * Find the quickfix buffer.  If it exists, update the contents.
4460  */
4461     static void
4462 qf_update_buffer(qf_info_T *qi, qfline_T *old_last)
4463 {
4464     buf_T	*buf;
4465     win_T	*win;
4466     aco_save_T	aco;
4467 
4468     // Check if a buffer for the quickfix list exists.  Update it.
4469     buf = qf_find_buf(qi);
4470     if (buf != NULL)
4471     {
4472 	linenr_T	old_line_count = buf->b_ml.ml_line_count;
4473 	int		qf_winid = 0;
4474 
4475 	if (IS_LL_STACK(qi))
4476 	{
4477 	    if (curwin->w_llist == qi)
4478 		win = curwin;
4479 	    else
4480 	    {
4481 		win = qf_find_win_with_loclist(qi);
4482 		if (win == NULL)
4483 		    return;
4484 	    }
4485 	    qf_winid = win->w_id;
4486 	}
4487 
4488 	if (old_last == NULL)
4489 	    // set curwin/curbuf to buf and save a few things
4490 	    aucmd_prepbuf(&aco, buf);
4491 
4492 	qf_update_win_titlevar(qi);
4493 
4494 	qf_fill_buffer(qf_get_curlist(qi), buf, old_last, qf_winid);
4495 	++CHANGEDTICK(buf);
4496 
4497 	if (old_last == NULL)
4498 	{
4499 	    (void)qf_win_pos_update(qi, 0);
4500 
4501 	    // restore curwin/curbuf and a few other things
4502 	    aucmd_restbuf(&aco);
4503 	}
4504 
4505 	// Only redraw when added lines are visible.  This avoids flickering
4506 	// when the added lines are not visible.
4507 	if ((win = qf_find_win(qi)) != NULL && old_line_count < win->w_botline)
4508 	    redraw_buf_later(buf, NOT_VALID);
4509     }
4510 }
4511 
4512 /*
4513  * Add an error line to the quickfix buffer.
4514  */
4515     static int
4516 qf_buf_add_line(
4517 	buf_T		*buf,		// quickfix window buffer
4518 	linenr_T	lnum,
4519 	qfline_T	*qfp,
4520 	char_u		*dirname,
4521 	int		first_bufline,
4522 	char_u		*qftf_str)
4523 {
4524     int		len;
4525     buf_T	*errbuf;
4526 
4527     // If the 'quickfixtextfunc' function returned an non-empty custom string
4528     // for this entry, then use it.
4529     if (qftf_str != NULL && *qftf_str != NUL)
4530 	vim_strncpy(IObuff, qftf_str, IOSIZE - 1);
4531     else
4532     {
4533 	if (qfp->qf_module != NULL)
4534 	{
4535 	    vim_strncpy(IObuff, qfp->qf_module, IOSIZE - 1);
4536 	    len = (int)STRLEN(IObuff);
4537 	}
4538 	else if (qfp->qf_fnum != 0
4539 		&& (errbuf = buflist_findnr(qfp->qf_fnum)) != NULL
4540 		&& errbuf->b_fname != NULL)
4541 	{
4542 	    if (qfp->qf_type == 1)	// :helpgrep
4543 		vim_strncpy(IObuff, gettail(errbuf->b_fname), IOSIZE - 1);
4544 	    else
4545 	    {
4546 		// Shorten the file name if not done already.
4547 		// For optimization, do this only for the first entry in a
4548 		// buffer.
4549 		if (first_bufline && (errbuf->b_sfname == NULL
4550 				|| mch_isFullName(errbuf->b_sfname)))
4551 		{
4552 		    if (*dirname == NUL)
4553 			mch_dirname(dirname, MAXPATHL);
4554 		    shorten_buf_fname(errbuf, dirname, FALSE);
4555 		}
4556 		vim_strncpy(IObuff, errbuf->b_fname, IOSIZE - 1);
4557 	    }
4558 	    len = (int)STRLEN(IObuff);
4559 	}
4560 	else
4561 	    len = 0;
4562 
4563 	if (len < IOSIZE - 1)
4564 	    IObuff[len++] = '|';
4565 
4566 	if (qfp->qf_lnum > 0)
4567 	{
4568 	    vim_snprintf((char *)IObuff + len, IOSIZE - len, "%ld",
4569 		    qfp->qf_lnum);
4570 	    len += (int)STRLEN(IObuff + len);
4571 
4572 	    if (qfp->qf_col > 0)
4573 	    {
4574 		vim_snprintf((char *)IObuff + len, IOSIZE - len,
4575 			" col %d", qfp->qf_col);
4576 		len += (int)STRLEN(IObuff + len);
4577 	    }
4578 
4579 	    vim_snprintf((char *)IObuff + len, IOSIZE - len, "%s",
4580 		    (char *)qf_types(qfp->qf_type, qfp->qf_nr));
4581 	    len += (int)STRLEN(IObuff + len);
4582 	}
4583 	else if (qfp->qf_pattern != NULL)
4584 	{
4585 	    qf_fmt_text(qfp->qf_pattern, IObuff + len, IOSIZE - len);
4586 	    len += (int)STRLEN(IObuff + len);
4587 	}
4588 	if (len < IOSIZE - 2)
4589 	{
4590 	    IObuff[len++] = '|';
4591 	    IObuff[len++] = ' ';
4592 	}
4593 
4594 	// Remove newlines and leading whitespace from the text.
4595 	// For an unrecognized line keep the indent, the compiler may
4596 	// mark a word with ^^^^.
4597 	qf_fmt_text(len > 3 ? skipwhite(qfp->qf_text) : qfp->qf_text,
4598 		IObuff + len, IOSIZE - len);
4599     }
4600 
4601     if (ml_append_buf(buf, lnum, IObuff,
4602 		(colnr_T)STRLEN(IObuff) + 1, FALSE) == FAIL)
4603 	return FAIL;
4604 
4605     return OK;
4606 }
4607 
4608 /*
4609  * Call the 'quickfixtextfunc' function to get the list of lines to display in
4610  * the quickfix window for the entries 'start_idx' to 'end_idx'.
4611  */
4612     static list_T *
4613 call_qftf_func(qf_list_T *qfl, int qf_winid, long start_idx, long end_idx)
4614 {
4615     callback_T	*cb = &qftf_cb;
4616     list_T	*qftf_list = NULL;
4617 
4618     // If 'quickfixtextfunc' is set, then use the user-supplied function to get
4619     // the text to display. Use the local value of 'quickfixtextfunc' if it is
4620     // set.
4621     if (qfl->qftf_cb.cb_name != NULL)
4622 	cb = &qfl->qftf_cb;
4623     if (cb != NULL && cb->cb_name != NULL)
4624     {
4625 	typval_T	args[1];
4626 	dict_T		*d;
4627 	typval_T	rettv;
4628 
4629 	// create the dict argument
4630 	if ((d = dict_alloc_lock(VAR_FIXED)) == NULL)
4631 	    return NULL;
4632 	dict_add_number(d, "quickfix", (long)IS_QF_LIST(qfl));
4633 	dict_add_number(d, "winid", (long)qf_winid);
4634 	dict_add_number(d, "id", (long)qfl->qf_id);
4635 	dict_add_number(d, "start_idx", start_idx);
4636 	dict_add_number(d, "end_idx", end_idx);
4637 	++d->dv_refcount;
4638 	args[0].v_type = VAR_DICT;
4639 	args[0].vval.v_dict = d;
4640 
4641 	qftf_list = NULL;
4642 	if (call_callback(cb, 0, &rettv, 1, args) != FAIL)
4643 	{
4644 	    if (rettv.v_type == VAR_LIST)
4645 	    {
4646 		qftf_list = rettv.vval.v_list;
4647 		qftf_list->lv_refcount++;
4648 	    }
4649 	    clear_tv(&rettv);
4650 	}
4651 	dict_unref(d);
4652     }
4653 
4654     return qftf_list;
4655 }
4656 
4657 /*
4658  * Fill current buffer with quickfix errors, replacing any previous contents.
4659  * curbuf must be the quickfix buffer!
4660  * If "old_last" is not NULL append the items after this one.
4661  * When "old_last" is NULL then "buf" must equal "curbuf"!  Because
4662  * ml_delete() is used and autocommands will be triggered.
4663  */
4664     static void
4665 qf_fill_buffer(qf_list_T *qfl, buf_T *buf, qfline_T *old_last, int qf_winid)
4666 {
4667     linenr_T	lnum;
4668     qfline_T	*qfp;
4669     int		old_KeyTyped = KeyTyped;
4670     list_T	*qftf_list = NULL;
4671     listitem_T	*qftf_li = NULL;
4672 
4673     if (old_last == NULL)
4674     {
4675 	if (buf != curbuf)
4676 	{
4677 	    internal_error("qf_fill_buffer()");
4678 	    return;
4679 	}
4680 
4681 	// delete all existing lines
4682 	while ((curbuf->b_ml.ml_flags & ML_EMPTY) == 0)
4683 	    (void)ml_delete((linenr_T)1);
4684     }
4685 
4686     // Check if there is anything to display
4687     if (qfl != NULL)
4688     {
4689 	char_u		dirname[MAXPATHL];
4690 	int		invalid_val = FALSE;
4691 	int		prev_bufnr = -1;
4692 
4693 	*dirname = NUL;
4694 
4695 	// Add one line for each error
4696 	if (old_last == NULL)
4697 	{
4698 	    qfp = qfl->qf_start;
4699 	    lnum = 0;
4700 	}
4701 	else
4702 	{
4703 	    if (old_last->qf_next != NULL)
4704 		qfp = old_last->qf_next;
4705 	    else
4706 		qfp = old_last;
4707 	    lnum = buf->b_ml.ml_line_count;
4708 	}
4709 
4710 	qftf_list = call_qftf_func(qfl, qf_winid, (long)(lnum + 1),
4711 							(long)qfl->qf_count);
4712 	if (qftf_list != NULL)
4713 	    qftf_li = qftf_list->lv_first;
4714 
4715 	while (lnum < qfl->qf_count)
4716 	{
4717 	    char_u	*qftf_str = NULL;
4718 
4719 	    // Use the text supplied by the user defined function (if any).
4720 	    // If the returned value is not string, then ignore the rest
4721 	    // of the returned values and use the default.
4722 	    if (qftf_li != NULL && !invalid_val)
4723 	    {
4724 		qftf_str = tv_get_string_chk(&qftf_li->li_tv);
4725 		if (qftf_str == NULL)
4726 		    invalid_val = TRUE;
4727 	    }
4728 
4729 	    if (qf_buf_add_line(buf, lnum, qfp, dirname,
4730 			prev_bufnr != qfp->qf_fnum, qftf_str) == FAIL)
4731 		break;
4732 
4733 	    prev_bufnr = qfp->qf_fnum;
4734 	    ++lnum;
4735 	    qfp = qfp->qf_next;
4736 	    if (qfp == NULL)
4737 		break;
4738 
4739 	    if (qftf_li != NULL)
4740 		qftf_li = qftf_li->li_next;
4741 	}
4742 
4743 	if (old_last == NULL)
4744 	    // Delete the empty line which is now at the end
4745 	    (void)ml_delete(lnum + 1);
4746     }
4747 
4748     // correct cursor position
4749     check_lnums(TRUE);
4750 
4751     if (old_last == NULL)
4752     {
4753 	// Set the 'filetype' to "qf" each time after filling the buffer.
4754 	// This resembles reading a file into a buffer, it's more logical when
4755 	// using autocommands.
4756 	++curbuf_lock;
4757 	set_option_value((char_u *)"ft", 0L, (char_u *)"qf", OPT_LOCAL);
4758 	curbuf->b_p_ma = FALSE;
4759 
4760 	keep_filetype = TRUE;		// don't detect 'filetype'
4761 	apply_autocmds(EVENT_BUFREADPOST, (char_u *)"quickfix", NULL,
4762 							       FALSE, curbuf);
4763 	apply_autocmds(EVENT_BUFWINENTER, (char_u *)"quickfix", NULL,
4764 							       FALSE, curbuf);
4765 	keep_filetype = FALSE;
4766 	--curbuf_lock;
4767 
4768 	// make sure it will be redrawn
4769 	redraw_curbuf_later(NOT_VALID);
4770     }
4771 
4772     // Restore KeyTyped, setting 'filetype' may reset it.
4773     KeyTyped = old_KeyTyped;
4774 }
4775 
4776 /*
4777  * For every change made to the quickfix list, update the changed tick.
4778  */
4779     static void
4780 qf_list_changed(qf_list_T *qfl)
4781 {
4782     qfl->qf_changedtick++;
4783 }
4784 
4785 /*
4786  * Return the quickfix/location list number with the given identifier.
4787  * Returns -1 if list is not found.
4788  */
4789     static int
4790 qf_id2nr(qf_info_T *qi, int_u qfid)
4791 {
4792     int		qf_idx;
4793 
4794     for (qf_idx = 0; qf_idx < qi->qf_listcount; qf_idx++)
4795 	if (qi->qf_lists[qf_idx].qf_id == qfid)
4796 	    return qf_idx;
4797     return INVALID_QFIDX;
4798 }
4799 
4800 /*
4801  * If the current list is not "save_qfid" and we can find the list with that ID
4802  * then make it the current list.
4803  * This is used when autocommands may have changed the current list.
4804  * Returns OK if successfully restored the list. Returns FAIL if the list with
4805  * the specified identifier (save_qfid) is not found in the stack.
4806  */
4807     static int
4808 qf_restore_list(qf_info_T *qi, int_u save_qfid)
4809 {
4810     int curlist;
4811 
4812     if (qf_get_curlist(qi)->qf_id != save_qfid)
4813     {
4814 	curlist = qf_id2nr(qi, save_qfid);
4815 	if (curlist < 0)
4816 	    // list is not present
4817 	    return FAIL;
4818 	qi->qf_curlist = curlist;
4819     }
4820     return OK;
4821 }
4822 
4823 /*
4824  * Jump to the first entry if there is one.
4825  */
4826     static void
4827 qf_jump_first(qf_info_T *qi, int_u save_qfid, int forceit)
4828 {
4829     if (qf_restore_list(qi, save_qfid) == FAIL)
4830 	return;
4831 
4832     // Autocommands might have cleared the list, check for that.
4833     if (!qf_list_empty(qf_get_curlist(qi)))
4834 	qf_jump(qi, 0, 0, forceit);
4835 }
4836 
4837 /*
4838  * Return TRUE when using ":vimgrep" for ":grep".
4839  */
4840     int
4841 grep_internal(cmdidx_T cmdidx)
4842 {
4843     return ((cmdidx == CMD_grep
4844 		|| cmdidx == CMD_lgrep
4845 		|| cmdidx == CMD_grepadd
4846 		|| cmdidx == CMD_lgrepadd)
4847 	    && STRCMP("internal",
4848 			*curbuf->b_p_gp == NUL ? p_gp : curbuf->b_p_gp) == 0);
4849 }
4850 
4851 /*
4852  * Return the make/grep autocmd name.
4853  */
4854     static char_u *
4855 make_get_auname(cmdidx_T cmdidx)
4856 {
4857     switch (cmdidx)
4858     {
4859 	case CMD_make:	    return (char_u *)"make";
4860 	case CMD_lmake:	    return (char_u *)"lmake";
4861 	case CMD_grep:	    return (char_u *)"grep";
4862 	case CMD_lgrep:	    return (char_u *)"lgrep";
4863 	case CMD_grepadd:   return (char_u *)"grepadd";
4864 	case CMD_lgrepadd:  return (char_u *)"lgrepadd";
4865 	default: return NULL;
4866     }
4867 }
4868 
4869 /*
4870  * Return the name for the errorfile, in allocated memory.
4871  * Find a new unique name when 'makeef' contains "##".
4872  * Returns NULL for error.
4873  */
4874     static char_u *
4875 get_mef_name(void)
4876 {
4877     char_u	*p;
4878     char_u	*name;
4879     static int	start = -1;
4880     static int	off = 0;
4881 #ifdef HAVE_LSTAT
4882     stat_T	sb;
4883 #endif
4884 
4885     if (*p_mef == NUL)
4886     {
4887 	name = vim_tempname('e', FALSE);
4888 	if (name == NULL)
4889 	    emsg(_(e_notmp));
4890 	return name;
4891     }
4892 
4893     for (p = p_mef; *p; ++p)
4894 	if (p[0] == '#' && p[1] == '#')
4895 	    break;
4896 
4897     if (*p == NUL)
4898 	return vim_strsave(p_mef);
4899 
4900     // Keep trying until the name doesn't exist yet.
4901     for (;;)
4902     {
4903 	if (start == -1)
4904 	    start = mch_get_pid();
4905 	else
4906 	    off += 19;
4907 
4908 	name = alloc(STRLEN(p_mef) + 30);
4909 	if (name == NULL)
4910 	    break;
4911 	STRCPY(name, p_mef);
4912 	sprintf((char *)name + (p - p_mef), "%d%d", start, off);
4913 	STRCAT(name, p + 2);
4914 	if (mch_getperm(name) < 0
4915 #ifdef HAVE_LSTAT
4916 		    // Don't accept a symbolic link, it's a security risk.
4917 		    && mch_lstat((char *)name, &sb) < 0
4918 #endif
4919 		)
4920 	    break;
4921 	vim_free(name);
4922     }
4923     return name;
4924 }
4925 
4926 /*
4927  * Form the complete command line to invoke 'make'/'grep'. Quote the command
4928  * using 'shellquote' and append 'shellpipe'. Echo the fully formed command.
4929  */
4930     static char_u *
4931 make_get_fullcmd(char_u *makecmd, char_u *fname)
4932 {
4933     char_u	*cmd;
4934     unsigned	len;
4935 
4936     len = (unsigned)STRLEN(p_shq) * 2 + (unsigned)STRLEN(makecmd) + 1;
4937     if (*p_sp != NUL)
4938 	len += (unsigned)STRLEN(p_sp) + (unsigned)STRLEN(fname) + 3;
4939     cmd = alloc(len);
4940     if (cmd == NULL)
4941 	return NULL;
4942     sprintf((char *)cmd, "%s%s%s", (char *)p_shq, (char *)makecmd,
4943 							       (char *)p_shq);
4944 
4945     // If 'shellpipe' empty: don't redirect to 'errorfile'.
4946     if (*p_sp != NUL)
4947 	append_redir(cmd, len, p_sp, fname);
4948 
4949     // Display the fully formed command.  Output a newline if there's something
4950     // else than the :make command that was typed (in which case the cursor is
4951     // in column 0).
4952     if (msg_col == 0)
4953 	msg_didout = FALSE;
4954     msg_start();
4955     msg_puts(":!");
4956     msg_outtrans(cmd);		// show what we are doing
4957 
4958     return cmd;
4959 }
4960 
4961 /*
4962  * Used for ":make", ":lmake", ":grep", ":lgrep", ":grepadd", and ":lgrepadd"
4963  */
4964     void
4965 ex_make(exarg_T *eap)
4966 {
4967     char_u	*fname;
4968     char_u	*cmd;
4969     char_u	*enc = NULL;
4970     win_T	*wp = NULL;
4971     qf_info_T	*qi = &ql_info;
4972     int		res;
4973     char_u	*au_name = NULL;
4974     int_u	save_qfid;
4975 
4976     // Redirect ":grep" to ":vimgrep" if 'grepprg' is "internal".
4977     if (grep_internal(eap->cmdidx))
4978     {
4979 	ex_vimgrep(eap);
4980 	return;
4981     }
4982 
4983     au_name = make_get_auname(eap->cmdidx);
4984     if (au_name != NULL && apply_autocmds(EVENT_QUICKFIXCMDPRE, au_name,
4985 					       curbuf->b_fname, TRUE, curbuf))
4986     {
4987 #ifdef FEAT_EVAL
4988 	if (aborting())
4989 	    return;
4990 #endif
4991     }
4992     enc = (*curbuf->b_p_menc != NUL) ? curbuf->b_p_menc : p_menc;
4993 
4994     if (is_loclist_cmd(eap->cmdidx))
4995 	wp = curwin;
4996 
4997     autowrite_all();
4998     fname = get_mef_name();
4999     if (fname == NULL)
5000 	return;
5001     mch_remove(fname);	    // in case it's not unique
5002 
5003     cmd = make_get_fullcmd(eap->arg, fname);
5004     if (cmd == NULL)
5005 	return;
5006 
5007     // let the shell know if we are redirecting output or not
5008     do_shell(cmd, *p_sp != NUL ? SHELL_DOOUT : 0);
5009 
5010 #ifdef AMIGA
5011     out_flush();
5012 		// read window status report and redraw before message
5013     (void)char_avail();
5014 #endif
5015 
5016     incr_quickfix_busy();
5017 
5018     res = qf_init(wp, fname, (eap->cmdidx != CMD_make
5019 			    && eap->cmdidx != CMD_lmake) ? p_gefm : p_efm,
5020 					   (eap->cmdidx != CMD_grepadd
5021 					    && eap->cmdidx != CMD_lgrepadd),
5022 					   qf_cmdtitle(*eap->cmdlinep), enc);
5023     if (wp != NULL)
5024     {
5025 	qi = GET_LOC_LIST(wp);
5026 	if (qi == NULL)
5027 	    goto cleanup;
5028     }
5029     if (res >= 0)
5030 	qf_list_changed(qf_get_curlist(qi));
5031 
5032     // Remember the current quickfix list identifier, so that we can
5033     // check for autocommands changing the current quickfix list.
5034     save_qfid = qf_get_curlist(qi)->qf_id;
5035     if (au_name != NULL)
5036 	apply_autocmds(EVENT_QUICKFIXCMDPOST, au_name,
5037 					       curbuf->b_fname, TRUE, curbuf);
5038     if (res > 0 && !eap->forceit && qflist_valid(wp, save_qfid))
5039 	// display the first error
5040 	qf_jump_first(qi, save_qfid, FALSE);
5041 
5042 cleanup:
5043     decr_quickfix_busy();
5044     mch_remove(fname);
5045     vim_free(fname);
5046     vim_free(cmd);
5047 }
5048 
5049 /*
5050  * Returns the number of entries in the current quickfix/location list.
5051  */
5052     int
5053 qf_get_size(exarg_T *eap)
5054 {
5055     qf_info_T	*qi;
5056 
5057     if ((qi = qf_cmd_get_stack(eap, FALSE)) == NULL)
5058 	return 0;
5059     return qf_get_curlist(qi)->qf_count;
5060 }
5061 
5062 /*
5063  * Returns the number of valid entries in the current quickfix/location list.
5064  */
5065     int
5066 qf_get_valid_size(exarg_T *eap)
5067 {
5068     qf_info_T	*qi;
5069     qf_list_T	*qfl;
5070     qfline_T	*qfp;
5071     int		i, sz = 0;
5072     int		prev_fnum = 0;
5073 
5074     if ((qi = qf_cmd_get_stack(eap, FALSE)) == NULL)
5075 	return 0;
5076 
5077     qfl = qf_get_curlist(qi);
5078     FOR_ALL_QFL_ITEMS(qfl, qfp, i)
5079     {
5080 	if (qfp->qf_valid)
5081 	{
5082 	    if (eap->cmdidx == CMD_cdo || eap->cmdidx == CMD_ldo)
5083 		sz++;	// Count all valid entries
5084 	    else if (qfp->qf_fnum > 0 && qfp->qf_fnum != prev_fnum)
5085 	    {
5086 		// Count the number of files
5087 		sz++;
5088 		prev_fnum = qfp->qf_fnum;
5089 	    }
5090 	}
5091     }
5092 
5093     return sz;
5094 }
5095 
5096 /*
5097  * Returns the current index of the quickfix/location list.
5098  * Returns 0 if there is an error.
5099  */
5100     int
5101 qf_get_cur_idx(exarg_T *eap)
5102 {
5103     qf_info_T	*qi;
5104 
5105     if ((qi = qf_cmd_get_stack(eap, FALSE)) == NULL)
5106 	return 0;
5107 
5108     return qf_get_curlist(qi)->qf_index;
5109 }
5110 
5111 /*
5112  * Returns the current index in the quickfix/location list (counting only valid
5113  * entries). If no valid entries are in the list, then returns 1.
5114  */
5115     int
5116 qf_get_cur_valid_idx(exarg_T *eap)
5117 {
5118     qf_info_T	*qi;
5119     qf_list_T	*qfl;
5120     qfline_T	*qfp;
5121     int		i, eidx = 0;
5122     int		prev_fnum = 0;
5123 
5124     if ((qi = qf_cmd_get_stack(eap, FALSE)) == NULL)
5125 	return 1;
5126 
5127     qfl = qf_get_curlist(qi);
5128     qfp = qfl->qf_start;
5129 
5130     // check if the list has valid errors
5131     if (!qf_list_has_valid_entries(qfl))
5132 	return 1;
5133 
5134     for (i = 1; i <= qfl->qf_index && qfp!= NULL; i++, qfp = qfp->qf_next)
5135     {
5136 	if (qfp->qf_valid)
5137 	{
5138 	    if (eap->cmdidx == CMD_cfdo || eap->cmdidx == CMD_lfdo)
5139 	    {
5140 		if (qfp->qf_fnum > 0 && qfp->qf_fnum != prev_fnum)
5141 		{
5142 		    // Count the number of files
5143 		    eidx++;
5144 		    prev_fnum = qfp->qf_fnum;
5145 		}
5146 	    }
5147 	    else
5148 		eidx++;
5149 	}
5150     }
5151 
5152     return eidx ? eidx : 1;
5153 }
5154 
5155 /*
5156  * Get the 'n'th valid error entry in the quickfix or location list.
5157  * Used by :cdo, :ldo, :cfdo and :lfdo commands.
5158  * For :cdo and :ldo returns the 'n'th valid error entry.
5159  * For :cfdo and :lfdo returns the 'n'th valid file entry.
5160  */
5161     static int
5162 qf_get_nth_valid_entry(qf_list_T *qfl, int n, int fdo)
5163 {
5164     qfline_T	*qfp;
5165     int		i, eidx;
5166     int		prev_fnum = 0;
5167 
5168     // check if the list has valid errors
5169     if (!qf_list_has_valid_entries(qfl))
5170 	return 1;
5171 
5172     eidx = 0;
5173     FOR_ALL_QFL_ITEMS(qfl, qfp, i)
5174     {
5175 	if (qfp->qf_valid)
5176 	{
5177 	    if (fdo)
5178 	    {
5179 		if (qfp->qf_fnum > 0 && qfp->qf_fnum != prev_fnum)
5180 		{
5181 		    // Count the number of files
5182 		    eidx++;
5183 		    prev_fnum = qfp->qf_fnum;
5184 		}
5185 	    }
5186 	    else
5187 		eidx++;
5188 	}
5189 
5190 	if (eidx == n)
5191 	    break;
5192     }
5193 
5194     if (i <= qfl->qf_count)
5195 	return i;
5196     else
5197 	return 1;
5198 }
5199 
5200 /*
5201  * ":cc", ":crewind", ":cfirst" and ":clast".
5202  * ":ll", ":lrewind", ":lfirst" and ":llast".
5203  * ":cdo", ":ldo", ":cfdo" and ":lfdo"
5204  */
5205     void
5206 ex_cc(exarg_T *eap)
5207 {
5208     qf_info_T	*qi;
5209     int		errornr;
5210 
5211     if ((qi = qf_cmd_get_stack(eap, TRUE)) == NULL)
5212 	return;
5213 
5214     if (eap->addr_count > 0)
5215 	errornr = (int)eap->line2;
5216     else
5217     {
5218 	switch (eap->cmdidx)
5219 	{
5220 	    case CMD_cc: case CMD_ll:
5221 		errornr = 0;
5222 		break;
5223 	    case CMD_crewind: case CMD_lrewind: case CMD_cfirst:
5224 	    case CMD_lfirst:
5225 		errornr = 1;
5226 		break;
5227 	    default:
5228 		errornr = 32767;
5229 	}
5230     }
5231 
5232     // For cdo and ldo commands, jump to the nth valid error.
5233     // For cfdo and lfdo commands, jump to the nth valid file entry.
5234     if (eap->cmdidx == CMD_cdo || eap->cmdidx == CMD_ldo
5235 	    || eap->cmdidx == CMD_cfdo || eap->cmdidx == CMD_lfdo)
5236 	errornr = qf_get_nth_valid_entry(qf_get_curlist(qi),
5237 		eap->addr_count > 0 ? (int)eap->line1 : 1,
5238 		eap->cmdidx == CMD_cfdo || eap->cmdidx == CMD_lfdo);
5239 
5240     qf_jump(qi, 0, errornr, eap->forceit);
5241 }
5242 
5243 /*
5244  * ":cnext", ":cnfile", ":cNext" and ":cprevious".
5245  * ":lnext", ":lNext", ":lprevious", ":lnfile", ":lNfile" and ":lpfile".
5246  * Also, used by ":cdo", ":ldo", ":cfdo" and ":lfdo" commands.
5247  */
5248     void
5249 ex_cnext(exarg_T *eap)
5250 {
5251     qf_info_T	*qi;
5252     int		errornr;
5253     int		dir;
5254 
5255     if ((qi = qf_cmd_get_stack(eap, TRUE)) == NULL)
5256 	return;
5257 
5258     if (eap->addr_count > 0
5259 	    && (eap->cmdidx != CMD_cdo && eap->cmdidx != CMD_ldo
5260 		&& eap->cmdidx != CMD_cfdo && eap->cmdidx != CMD_lfdo))
5261 	errornr = (int)eap->line2;
5262     else
5263 	errornr = 1;
5264 
5265     // Depending on the command jump to either next or previous entry/file.
5266     switch (eap->cmdidx)
5267     {
5268 	case CMD_cnext: case CMD_lnext: case CMD_cdo: case CMD_ldo:
5269 	    dir = FORWARD;
5270 	    break;
5271 	case CMD_cprevious: case CMD_lprevious: case CMD_cNext:
5272 	case CMD_lNext:
5273 	    dir = BACKWARD;
5274 	    break;
5275 	case CMD_cnfile: case CMD_lnfile: case CMD_cfdo: case CMD_lfdo:
5276 	    dir = FORWARD_FILE;
5277 	    break;
5278 	case CMD_cpfile: case CMD_lpfile: case CMD_cNfile: case CMD_lNfile:
5279 	    dir = BACKWARD_FILE;
5280 	    break;
5281 	default:
5282 	    dir = FORWARD;
5283 	    break;
5284     }
5285 
5286     qf_jump(qi, dir, errornr, eap->forceit);
5287 }
5288 
5289 /*
5290  * Find the first entry in the quickfix list 'qfl' from buffer 'bnr'.
5291  * The index of the entry is stored in 'errornr'.
5292  * Returns NULL if an entry is not found.
5293  */
5294     static qfline_T *
5295 qf_find_first_entry_in_buf(qf_list_T *qfl, int bnr, int *errornr)
5296 {
5297     qfline_T	*qfp = NULL;
5298     int		idx = 0;
5299 
5300     // Find the first entry in this file
5301     FOR_ALL_QFL_ITEMS(qfl, qfp, idx)
5302 	if (qfp->qf_fnum == bnr)
5303 	    break;
5304 
5305     *errornr = idx;
5306     return qfp;
5307 }
5308 
5309 /*
5310  * Find the first quickfix entry on the same line as 'entry'. Updates 'errornr'
5311  * with the error number for the first entry. Assumes the entries are sorted in
5312  * the quickfix list by line number.
5313  */
5314     static qfline_T *
5315 qf_find_first_entry_on_line(qfline_T *entry, int *errornr)
5316 {
5317     while (!got_int
5318 	    && entry->qf_prev != NULL
5319 	    && entry->qf_fnum == entry->qf_prev->qf_fnum
5320 	    && entry->qf_lnum == entry->qf_prev->qf_lnum)
5321     {
5322 	entry = entry->qf_prev;
5323 	--*errornr;
5324     }
5325 
5326     return entry;
5327 }
5328 
5329 /*
5330  * Find the last quickfix entry on the same line as 'entry'. Updates 'errornr'
5331  * with the error number for the last entry. Assumes the entries are sorted in
5332  * the quickfix list by line number.
5333  */
5334     static qfline_T *
5335 qf_find_last_entry_on_line(qfline_T *entry, int *errornr)
5336 {
5337     while (!got_int &&
5338 	    entry->qf_next != NULL
5339 	    && entry->qf_fnum == entry->qf_next->qf_fnum
5340 	    && entry->qf_lnum == entry->qf_next->qf_lnum)
5341     {
5342 	entry = entry->qf_next;
5343 	++*errornr;
5344     }
5345 
5346     return entry;
5347 }
5348 
5349 /*
5350  * Returns TRUE if the specified quickfix entry is
5351  *   after the given line (linewise is TRUE)
5352  *   or after the line and column.
5353  */
5354     static int
5355 qf_entry_after_pos(qfline_T *qfp, pos_T *pos, int linewise)
5356 {
5357     if (linewise)
5358 	return qfp->qf_lnum > pos->lnum;
5359     else
5360 	return (qfp->qf_lnum > pos->lnum ||
5361 		(qfp->qf_lnum == pos->lnum && qfp->qf_col > pos->col));
5362 }
5363 
5364 /*
5365  * Returns TRUE if the specified quickfix entry is
5366  *   before the given line (linewise is TRUE)
5367  *   or before the line and column.
5368  */
5369     static int
5370 qf_entry_before_pos(qfline_T *qfp, pos_T *pos, int linewise)
5371 {
5372     if (linewise)
5373 	return qfp->qf_lnum < pos->lnum;
5374     else
5375 	return (qfp->qf_lnum < pos->lnum ||
5376 		(qfp->qf_lnum == pos->lnum && qfp->qf_col < pos->col));
5377 }
5378 
5379 /*
5380  * Returns TRUE if the specified quickfix entry is
5381  *   on or after the given line (linewise is TRUE)
5382  *   or on or after the line and column.
5383  */
5384     static int
5385 qf_entry_on_or_after_pos(qfline_T *qfp, pos_T *pos, int linewise)
5386 {
5387     if (linewise)
5388 	return qfp->qf_lnum >= pos->lnum;
5389     else
5390 	return (qfp->qf_lnum > pos->lnum ||
5391 		(qfp->qf_lnum == pos->lnum && qfp->qf_col >= pos->col));
5392 }
5393 
5394 /*
5395  * Returns TRUE if the specified quickfix entry is
5396  *   on or before the given line (linewise is TRUE)
5397  *   or on or before the line and column.
5398  */
5399     static int
5400 qf_entry_on_or_before_pos(qfline_T *qfp, pos_T *pos, int linewise)
5401 {
5402     if (linewise)
5403 	return qfp->qf_lnum <= pos->lnum;
5404     else
5405 	return (qfp->qf_lnum < pos->lnum ||
5406 		(qfp->qf_lnum == pos->lnum && qfp->qf_col <= pos->col));
5407 }
5408 
5409 /*
5410  * Find the first quickfix entry after position 'pos' in buffer 'bnr'.
5411  * If 'linewise' is TRUE, returns the entry after the specified line and treats
5412  * multiple entries on a single line as one. Otherwise returns the entry after
5413  * the specified line and column.
5414  * 'qfp' points to the very first entry in the buffer and 'errornr' is the
5415  * index of the very first entry in the quickfix list.
5416  * Returns NULL if an entry is not found after 'pos'.
5417  */
5418     static qfline_T *
5419 qf_find_entry_after_pos(
5420 	int		bnr,
5421 	pos_T		*pos,
5422 	int		linewise,
5423 	qfline_T	*qfp,
5424 	int		*errornr)
5425 {
5426     if (qf_entry_after_pos(qfp, pos, linewise))
5427 	// First entry is after position 'pos'
5428 	return qfp;
5429 
5430     // Find the entry just before or at the position 'pos'
5431     while (qfp->qf_next != NULL
5432 	    && qfp->qf_next->qf_fnum == bnr
5433 	    && qf_entry_on_or_before_pos(qfp->qf_next, pos, linewise))
5434     {
5435 	qfp = qfp->qf_next;
5436 	++*errornr;
5437     }
5438 
5439     if (qfp->qf_next == NULL || qfp->qf_next->qf_fnum != bnr)
5440 	// No entries found after position 'pos'
5441 	return NULL;
5442 
5443     // Use the entry just after position 'pos'
5444     qfp = qfp->qf_next;
5445     ++*errornr;
5446 
5447     return qfp;
5448 }
5449 
5450 /*
5451  * Find the first quickfix entry before position 'pos' in buffer 'bnr'.
5452  * If 'linewise' is TRUE, returns the entry before the specified line and
5453  * treats multiple entries on a single line as one. Otherwise returns the entry
5454  * before the specified line and column.
5455  * 'qfp' points to the very first entry in the buffer and 'errornr' is the
5456  * index of the very first entry in the quickfix list.
5457  * Returns NULL if an entry is not found before 'pos'.
5458  */
5459     static qfline_T *
5460 qf_find_entry_before_pos(
5461 	int		bnr,
5462 	pos_T		*pos,
5463 	int		linewise,
5464 	qfline_T	*qfp,
5465 	int		*errornr)
5466 {
5467     // Find the entry just before the position 'pos'
5468     while (qfp->qf_next != NULL
5469 	    && qfp->qf_next->qf_fnum == bnr
5470 	    && qf_entry_before_pos(qfp->qf_next, pos, linewise))
5471     {
5472 	qfp = qfp->qf_next;
5473 	++*errornr;
5474     }
5475 
5476     if (qf_entry_on_or_after_pos(qfp, pos, linewise))
5477 	return NULL;
5478 
5479     if (linewise)
5480 	// If multiple entries are on the same line, then use the first entry
5481 	qfp = qf_find_first_entry_on_line(qfp, errornr);
5482 
5483     return qfp;
5484 }
5485 
5486 /*
5487  * Find a quickfix entry in 'qfl' closest to position 'pos' in buffer 'bnr' in
5488  * the direction 'dir'.
5489  */
5490     static qfline_T *
5491 qf_find_closest_entry(
5492 	qf_list_T	*qfl,
5493 	int		bnr,
5494 	pos_T		*pos,
5495 	int		dir,
5496 	int		linewise,
5497 	int		*errornr)
5498 {
5499     qfline_T	*qfp;
5500 
5501     *errornr = 0;
5502 
5503     // Find the first entry in this file
5504     qfp = qf_find_first_entry_in_buf(qfl, bnr, errornr);
5505     if (qfp == NULL)
5506 	return NULL;		// no entry in this file
5507 
5508     if (dir == FORWARD)
5509 	qfp = qf_find_entry_after_pos(bnr, pos, linewise, qfp, errornr);
5510     else
5511 	qfp = qf_find_entry_before_pos(bnr, pos, linewise, qfp, errornr);
5512 
5513     return qfp;
5514 }
5515 
5516 /*
5517  * Get the nth quickfix entry below the specified entry.  Searches forward in
5518  * the list. If linewise is TRUE, then treat multiple entries on a single line
5519  * as one.
5520  */
5521     static void
5522 qf_get_nth_below_entry(qfline_T *entry_arg, int n, int linewise, int *errornr)
5523 {
5524     qfline_T *entry = entry_arg;
5525 
5526     while (n-- > 0 && !got_int)
5527     {
5528 	int		first_errornr = *errornr;
5529 
5530 	if (linewise)
5531 	    // Treat all the entries on the same line in this file as one
5532 	    entry = qf_find_last_entry_on_line(entry, errornr);
5533 
5534 	if (entry->qf_next == NULL
5535 		|| entry->qf_next->qf_fnum != entry->qf_fnum)
5536 	{
5537 	    if (linewise)
5538 		*errornr = first_errornr;
5539 	    break;
5540 	}
5541 
5542 	entry = entry->qf_next;
5543 	++*errornr;
5544     }
5545 }
5546 
5547 /*
5548  * Get the nth quickfix entry above the specified entry.  Searches backwards in
5549  * the list. If linewise is TRUE, then treat multiple entries on a single line
5550  * as one.
5551  */
5552     static void
5553 qf_get_nth_above_entry(qfline_T *entry, int n, int linewise, int *errornr)
5554 {
5555     while (n-- > 0 && !got_int)
5556     {
5557 	if (entry->qf_prev == NULL
5558 		|| entry->qf_prev->qf_fnum != entry->qf_fnum)
5559 	    break;
5560 
5561 	entry = entry->qf_prev;
5562 	--*errornr;
5563 
5564 	// If multiple entries are on the same line, then use the first entry
5565 	if (linewise)
5566 	    entry = qf_find_first_entry_on_line(entry, errornr);
5567     }
5568 }
5569 
5570 /*
5571  * Find the n'th quickfix entry adjacent to position 'pos' in buffer 'bnr' in
5572  * the specified direction.  Returns the error number in the quickfix list or 0
5573  * if an entry is not found.
5574  */
5575     static int
5576 qf_find_nth_adj_entry(
5577 	qf_list_T	*qfl,
5578 	int		bnr,
5579 	pos_T		*pos,
5580 	int		n,
5581 	int		dir,
5582 	int		linewise)
5583 {
5584     qfline_T	*adj_entry;
5585     int		errornr;
5586 
5587     // Find an entry closest to the specified position
5588     adj_entry = qf_find_closest_entry(qfl, bnr, pos, dir, linewise, &errornr);
5589     if (adj_entry == NULL)
5590 	return 0;
5591 
5592     if (--n > 0)
5593     {
5594 	// Go to the n'th entry in the current buffer
5595 	if (dir == FORWARD)
5596 	    qf_get_nth_below_entry(adj_entry, n, linewise, &errornr);
5597 	else
5598 	    qf_get_nth_above_entry(adj_entry, n, linewise, &errornr);
5599     }
5600 
5601     return errornr;
5602 }
5603 
5604 /*
5605  * Jump to a quickfix entry in the current file nearest to the current line or
5606  * current line/col.
5607  * ":cabove", ":cbelow", ":labove", ":lbelow", ":cafter", ":cbefore",
5608  * ":lafter" and ":lbefore" commands
5609  */
5610     void
5611 ex_cbelow(exarg_T *eap)
5612 {
5613     qf_info_T	*qi;
5614     qf_list_T	*qfl;
5615     int		dir;
5616     int		buf_has_flag;
5617     int		errornr = 0;
5618     pos_T	pos;
5619 
5620     if (eap->addr_count > 0 && eap->line2 <= 0)
5621     {
5622 	emsg(_(e_invrange));
5623 	return;
5624     }
5625 
5626     // Check whether the current buffer has any quickfix entries
5627     if (eap->cmdidx == CMD_cabove || eap->cmdidx == CMD_cbelow
5628 	    || eap->cmdidx == CMD_cbefore || eap->cmdidx == CMD_cafter)
5629 	buf_has_flag = BUF_HAS_QF_ENTRY;
5630     else
5631 	buf_has_flag = BUF_HAS_LL_ENTRY;
5632     if (!(curbuf->b_has_qf_entry & buf_has_flag))
5633     {
5634 	emsg(_(e_quickfix));
5635 	return;
5636     }
5637 
5638     if ((qi = qf_cmd_get_stack(eap, TRUE)) == NULL)
5639 	return;
5640 
5641     qfl = qf_get_curlist(qi);
5642     // check if the list has valid errors
5643     if (!qf_list_has_valid_entries(qfl))
5644     {
5645 	emsg(_(e_quickfix));
5646 	return;
5647     }
5648 
5649     if (eap->cmdidx == CMD_cbelow
5650 	    || eap->cmdidx == CMD_lbelow
5651 	    || eap->cmdidx == CMD_cafter
5652 	    || eap->cmdidx == CMD_lafter)
5653 	// Forward motion commands
5654 	dir = FORWARD;
5655     else
5656 	dir = BACKWARD;
5657 
5658     pos = curwin->w_cursor;
5659     // A quickfix entry column number is 1 based whereas cursor column
5660     // number is 0 based. Adjust the column number.
5661     pos.col++;
5662     errornr = qf_find_nth_adj_entry(qfl, curbuf->b_fnum, &pos,
5663 				eap->addr_count > 0 ? eap->line2 : 0, dir,
5664 				eap->cmdidx == CMD_cbelow
5665 					|| eap->cmdidx == CMD_lbelow
5666 					|| eap->cmdidx == CMD_cabove
5667 					|| eap->cmdidx == CMD_labove);
5668 
5669     if (errornr > 0)
5670 	qf_jump(qi, 0, errornr, FALSE);
5671     else
5672 	emsg(_(e_no_more_items));
5673 }
5674 
5675 /*
5676  * Return the autocmd name for the :cfile Ex commands
5677  */
5678     static char_u *
5679 cfile_get_auname(cmdidx_T cmdidx)
5680 {
5681     switch (cmdidx)
5682     {
5683 	case CMD_cfile:	    return (char_u *)"cfile";
5684 	case CMD_cgetfile:  return (char_u *)"cgetfile";
5685 	case CMD_caddfile:  return (char_u *)"caddfile";
5686 	case CMD_lfile:	    return (char_u *)"lfile";
5687 	case CMD_lgetfile:  return (char_u *)"lgetfile";
5688 	case CMD_laddfile:  return (char_u *)"laddfile";
5689 	default:	    return NULL;
5690     }
5691 }
5692 
5693 /*
5694  * ":cfile"/":cgetfile"/":caddfile" commands.
5695  * ":lfile"/":lgetfile"/":laddfile" commands.
5696  */
5697     void
5698 ex_cfile(exarg_T *eap)
5699 {
5700     char_u	*enc = NULL;
5701     win_T	*wp = NULL;
5702     qf_info_T	*qi = &ql_info;
5703     char_u	*au_name = NULL;
5704     int_u	save_qfid = 0;		// init for gcc
5705     int		res;
5706 
5707     au_name = cfile_get_auname(eap->cmdidx);
5708     if (au_name != NULL && apply_autocmds(EVENT_QUICKFIXCMDPRE, au_name,
5709 							NULL, FALSE, curbuf))
5710     {
5711 #ifdef FEAT_EVAL
5712 	if (aborting())
5713 	    return;
5714 #endif
5715     }
5716 
5717     enc = (*curbuf->b_p_menc != NUL) ? curbuf->b_p_menc : p_menc;
5718 #ifdef FEAT_BROWSE
5719     if (cmdmod.cmod_flags & CMOD_BROWSE)
5720     {
5721 	char_u *browse_file = do_browse(0, (char_u *)_("Error file"), eap->arg,
5722 				   NULL, NULL,
5723 				   (char_u *)_(BROWSE_FILTER_ALL_FILES), NULL);
5724 	if (browse_file == NULL)
5725 	    return;
5726 	set_string_option_direct((char_u *)"ef", -1, browse_file, OPT_FREE, 0);
5727 	vim_free(browse_file);
5728     }
5729     else
5730 #endif
5731     if (*eap->arg != NUL)
5732 	set_string_option_direct((char_u *)"ef", -1, eap->arg, OPT_FREE, 0);
5733 
5734     if (is_loclist_cmd(eap->cmdidx))
5735 	wp = curwin;
5736 
5737     incr_quickfix_busy();
5738 
5739     // This function is used by the :cfile, :cgetfile and :caddfile
5740     // commands.
5741     // :cfile always creates a new quickfix list and jumps to the
5742     // first error.
5743     // :cgetfile creates a new quickfix list but doesn't jump to the
5744     // first error.
5745     // :caddfile adds to an existing quickfix list. If there is no
5746     // quickfix list then a new list is created.
5747     res = qf_init(wp, p_ef, p_efm, (eap->cmdidx != CMD_caddfile
5748 			&& eap->cmdidx != CMD_laddfile),
5749 			qf_cmdtitle(*eap->cmdlinep), enc);
5750     if (wp != NULL)
5751     {
5752 	qi = GET_LOC_LIST(wp);
5753 	if (qi == NULL)
5754 	{
5755 	    decr_quickfix_busy();
5756 	    return;
5757 	}
5758     }
5759     if (res >= 0)
5760 	qf_list_changed(qf_get_curlist(qi));
5761     save_qfid = qf_get_curlist(qi)->qf_id;
5762     if (au_name != NULL)
5763 	apply_autocmds(EVENT_QUICKFIXCMDPOST, au_name, NULL, FALSE, curbuf);
5764 
5765     // Jump to the first error for a new list and if autocmds didn't
5766     // free the list.
5767     if (res > 0 && (eap->cmdidx == CMD_cfile || eap->cmdidx == CMD_lfile)
5768 	    && qflist_valid(wp, save_qfid))
5769 	// display the first error
5770 	qf_jump_first(qi, save_qfid, eap->forceit);
5771 
5772     decr_quickfix_busy();
5773 }
5774 
5775 /*
5776  * Return the vimgrep autocmd name.
5777  */
5778     static char_u *
5779 vgr_get_auname(cmdidx_T cmdidx)
5780 {
5781     switch (cmdidx)
5782     {
5783 	case CMD_vimgrep:     return (char_u *)"vimgrep";
5784 	case CMD_lvimgrep:    return (char_u *)"lvimgrep";
5785 	case CMD_vimgrepadd:  return (char_u *)"vimgrepadd";
5786 	case CMD_lvimgrepadd: return (char_u *)"lvimgrepadd";
5787 	case CMD_grep:	      return (char_u *)"grep";
5788 	case CMD_lgrep:	      return (char_u *)"lgrep";
5789 	case CMD_grepadd:     return (char_u *)"grepadd";
5790 	case CMD_lgrepadd:    return (char_u *)"lgrepadd";
5791 	default: return NULL;
5792     }
5793 }
5794 
5795 /*
5796  * Initialize the regmatch used by vimgrep for pattern "s".
5797  */
5798     static void
5799 vgr_init_regmatch(regmmatch_T *regmatch, char_u *s)
5800 {
5801     // Get the search pattern: either white-separated or enclosed in //
5802     regmatch->regprog = NULL;
5803 
5804     if (s == NULL || *s == NUL)
5805     {
5806 	// Pattern is empty, use last search pattern.
5807 	if (last_search_pat() == NULL)
5808 	{
5809 	    emsg(_(e_noprevre));
5810 	    return;
5811 	}
5812 	regmatch->regprog = vim_regcomp(last_search_pat(), RE_MAGIC);
5813     }
5814     else
5815 	regmatch->regprog = vim_regcomp(s, RE_MAGIC);
5816 
5817     regmatch->rmm_ic = p_ic;
5818     regmatch->rmm_maxcol = 0;
5819 }
5820 
5821 /*
5822  * Display a file name when vimgrep is running.
5823  */
5824     static void
5825 vgr_display_fname(char_u *fname)
5826 {
5827     char_u	*p;
5828 
5829     msg_start();
5830     p = msg_strtrunc(fname, TRUE);
5831     if (p == NULL)
5832 	msg_outtrans(fname);
5833     else
5834     {
5835 	msg_outtrans(p);
5836 	vim_free(p);
5837     }
5838     msg_clr_eos();
5839     msg_didout = FALSE;	    // overwrite this message
5840     msg_nowait = TRUE;	    // don't wait for this message
5841     msg_col = 0;
5842     out_flush();
5843 }
5844 
5845 /*
5846  * Load a dummy buffer to search for a pattern using vimgrep.
5847  */
5848     static buf_T *
5849 vgr_load_dummy_buf(
5850 	char_u *fname,
5851 	char_u *dirname_start,
5852 	char_u *dirname_now)
5853 {
5854     int		save_mls;
5855 #if defined(FEAT_SYN_HL)
5856     char_u	*save_ei = NULL;
5857 #endif
5858     buf_T	*buf;
5859 
5860 #if defined(FEAT_SYN_HL)
5861     // Don't do Filetype autocommands to avoid loading syntax and
5862     // indent scripts, a great speed improvement.
5863     save_ei = au_event_disable(",Filetype");
5864 #endif
5865     // Don't use modelines here, it's useless.
5866     save_mls = p_mls;
5867     p_mls = 0;
5868 
5869     // Load file into a buffer, so that 'fileencoding' is detected,
5870     // autocommands applied, etc.
5871     buf = load_dummy_buffer(fname, dirname_start, dirname_now);
5872 
5873     p_mls = save_mls;
5874 #if defined(FEAT_SYN_HL)
5875     au_event_restore(save_ei);
5876 #endif
5877 
5878     return buf;
5879 }
5880 
5881 /*
5882  * Check whether a quickfix/location list is valid. Autocmds may remove or
5883  * change a quickfix list when vimgrep is running. If the list is not found,
5884  * create a new list.
5885  */
5886     static int
5887 vgr_qflist_valid(
5888 	win_T	    *wp,
5889 	qf_info_T   *qi,
5890 	int_u	    qfid,
5891 	char_u	    *title)
5892 {
5893     // Verify that the quickfix/location list was not freed by an autocmd
5894     if (!qflist_valid(wp, qfid))
5895     {
5896 	if (wp != NULL)
5897 	{
5898 	    // An autocmd has freed the location list.
5899 	    emsg(_(e_current_location_list_was_changed));
5900 	    return FALSE;
5901 	}
5902 	else
5903 	{
5904 	    // Quickfix list is not found, create a new one.
5905 	    qf_new_list(qi, title);
5906 	    return TRUE;
5907 	}
5908     }
5909 
5910     if (qf_restore_list(qi, qfid) == FAIL)
5911 	return FALSE;
5912 
5913     return TRUE;
5914 }
5915 
5916 /*
5917  * Search for a pattern in all the lines in a buffer and add the matching lines
5918  * to a quickfix list.
5919  */
5920     static int
5921 vgr_match_buflines(
5922 	qf_list_T   *qfl,
5923 	char_u	    *fname,
5924 	buf_T	    *buf,
5925 	char_u	    *spat,
5926 	regmmatch_T *regmatch,
5927 	long	    *tomatch,
5928 	int	    duplicate_name,
5929 	int	    flags)
5930 {
5931     int		found_match = FALSE;
5932     long	lnum;
5933     colnr_T	col;
5934     int		pat_len = (int)STRLEN(spat);
5935 
5936     for (lnum = 1; lnum <= buf->b_ml.ml_line_count && *tomatch > 0; ++lnum)
5937     {
5938 	col = 0;
5939 	if (!(flags & VGR_FUZZY))
5940 	{
5941 	    // Regular expression match
5942 	    while (vim_regexec_multi(regmatch, curwin, buf, lnum,
5943 			col, NULL, NULL) > 0)
5944 	    {
5945 		// Pass the buffer number so that it gets used even for a
5946 		// dummy buffer, unless duplicate_name is set, then the
5947 		// buffer will be wiped out below.
5948 		if (qf_add_entry(qfl,
5949 			    NULL,	// dir
5950 			    fname,
5951 			    NULL,
5952 			    duplicate_name ? 0 : buf->b_fnum,
5953 			    ml_get_buf(buf,
5954 				regmatch->startpos[0].lnum + lnum, FALSE),
5955 			    regmatch->startpos[0].lnum + lnum,
5956 			    regmatch->startpos[0].col + 1,
5957 			    FALSE,	// vis_col
5958 			    NULL,	// search pattern
5959 			    0,		// nr
5960 			    0,		// type
5961 			    TRUE	// valid
5962 			    ) == QF_FAIL)
5963 		{
5964 		    got_int = TRUE;
5965 		    break;
5966 		}
5967 		found_match = TRUE;
5968 		if (--*tomatch == 0)
5969 		    break;
5970 		if ((flags & VGR_GLOBAL) == 0
5971 			|| regmatch->endpos[0].lnum > 0)
5972 		    break;
5973 		col = regmatch->endpos[0].col
5974 		    + (col == regmatch->endpos[0].col);
5975 		if (col > (colnr_T)STRLEN(ml_get_buf(buf, lnum, FALSE)))
5976 		    break;
5977 	    }
5978 	}
5979 	else
5980 	{
5981 	    char_u  *str = ml_get_buf(buf, lnum, FALSE);
5982 	    int	    score;
5983 	    int_u   matches[MAX_FUZZY_MATCHES];
5984 	    int_u   sz = ARRAY_LENGTH(matches);
5985 
5986 	    // Fuzzy string match
5987 	    while (fuzzy_match(str + col, spat, FALSE, &score, matches, sz) > 0)
5988 	    {
5989 		// Pass the buffer number so that it gets used even for a
5990 		// dummy buffer, unless duplicate_name is set, then the
5991 		// buffer will be wiped out below.
5992 		if (qf_add_entry(qfl,
5993 			    NULL,	// dir
5994 			    fname,
5995 			    NULL,
5996 			    duplicate_name ? 0 : buf->b_fnum,
5997 			    str,
5998 			    lnum,
5999 			    matches[0] + col + 1,
6000 			    FALSE,	// vis_col
6001 			    NULL,	// search pattern
6002 			    0,		// nr
6003 			    0,		// type
6004 			    TRUE	// valid
6005 			    ) == QF_FAIL)
6006 		{
6007 		    got_int = TRUE;
6008 		    break;
6009 		}
6010 		found_match = TRUE;
6011 		if (--*tomatch == 0)
6012 		    break;
6013 		if ((flags & VGR_GLOBAL) == 0)
6014 		    break;
6015 		col = matches[pat_len - 1] + col + 1;
6016 		if (col > (colnr_T)STRLEN(str))
6017 		    break;
6018 	    }
6019 	}
6020 	line_breakcheck();
6021 	if (got_int)
6022 	    break;
6023     }
6024 
6025     return found_match;
6026 }
6027 
6028 /*
6029  * Jump to the first match and update the directory.
6030  */
6031     static void
6032 vgr_jump_to_match(
6033 	qf_info_T   *qi,
6034 	int	    forceit,
6035 	int	    *redraw_for_dummy,
6036 	buf_T	    *first_match_buf,
6037 	char_u	    *target_dir)
6038 {
6039     buf_T	*buf;
6040 
6041     buf = curbuf;
6042     qf_jump(qi, 0, 0, forceit);
6043     if (buf != curbuf)
6044 	// If we jumped to another buffer redrawing will already be
6045 	// taken care of.
6046 	*redraw_for_dummy = FALSE;
6047 
6048     // Jump to the directory used after loading the buffer.
6049     if (curbuf == first_match_buf && target_dir != NULL)
6050     {
6051 	exarg_T ea;
6052 
6053 	CLEAR_FIELD(ea);
6054 	ea.arg = target_dir;
6055 	ea.cmdidx = CMD_lcd;
6056 	ex_cd(&ea);
6057     }
6058 }
6059 
6060 /*
6061  * :vimgrep command arguments
6062  */
6063 typedef struct
6064 {
6065     long	tomatch;	// maximum number of matches to find
6066     char_u	*spat;		// search pattern
6067     int		flags;		// search modifier
6068     char_u	**fnames;	// list of files to search
6069     int		fcount;		// number of files
6070     regmmatch_T	regmatch;	// compiled search pattern
6071     char_u	*qf_title;	// quickfix list title
6072 } vgr_args_T;
6073 
6074 /*
6075  * Process :vimgrep command arguments. The command syntax is:
6076  *
6077  *	:{count}vimgrep /{pattern}/[g][j] {file} ...
6078  */
6079     static int
6080 vgr_process_args(
6081 	exarg_T		*eap,
6082 	vgr_args_T	*args)
6083 {
6084     char_u	*p;
6085 
6086     vim_memset(args, 0, sizeof(*args));
6087 
6088     args->regmatch.regprog = NULL;
6089     args->qf_title = vim_strsave(qf_cmdtitle(*eap->cmdlinep));
6090 
6091     if (eap->addr_count > 0)
6092 	args->tomatch = eap->line2;
6093     else
6094 	args->tomatch = MAXLNUM;
6095 
6096     // Get the search pattern: either white-separated or enclosed in //
6097     p = skip_vimgrep_pat(eap->arg, &args->spat, &args->flags);
6098     if (p == NULL)
6099     {
6100 	emsg(_(e_invalpat));
6101 	return FAIL;
6102     }
6103 
6104     vgr_init_regmatch(&args->regmatch, args->spat);
6105     if (args->regmatch.regprog == NULL)
6106 	return FAIL;
6107 
6108     p = skipwhite(p);
6109     if (*p == NUL)
6110     {
6111 	emsg(_("E683: File name missing or invalid pattern"));
6112 	return FAIL;
6113     }
6114 
6115     // Parse the list of arguments, wildcards have already been expanded.
6116     if (get_arglist_exp(p, &args->fcount, &args->fnames, TRUE) == FAIL)
6117 	return FAIL;
6118     if (args->fcount == 0)
6119     {
6120 	emsg(_(e_nomatch));
6121 	return FAIL;
6122     }
6123 
6124     return OK;
6125 }
6126 
6127 /*
6128  * Return TRUE if "buf" had an existing swap file, the current swap file does
6129  * not end in ".swp".
6130  */
6131     static int
6132 existing_swapfile(buf_T *buf)
6133 {
6134     if (buf->b_ml.ml_mfp != NULL && buf->b_ml.ml_mfp->mf_fname != NULL)
6135     {
6136 	char_u *fname = buf->b_ml.ml_mfp->mf_fname;
6137 	size_t len = STRLEN(fname);
6138 
6139 	return fname[len - 1] != 'p' || fname[len - 2] != 'w';
6140     }
6141     return FALSE;
6142 }
6143 
6144 /*
6145  * Search for a pattern in a list of files and populate the quickfix list with
6146  * the matches.
6147  */
6148     static int
6149 vgr_process_files(
6150 	win_T		*wp,
6151 	qf_info_T	*qi,
6152 	vgr_args_T	*cmd_args,
6153 	int		*redraw_for_dummy,
6154 	buf_T		**first_match_buf,
6155 	char_u		**target_dir)
6156 {
6157     int		status = FAIL;
6158     int_u	save_qfid = qf_get_curlist(qi)->qf_id;
6159     time_t	seconds = 0;
6160     char_u	*fname;
6161     int		fi;
6162     buf_T	*buf;
6163     int		duplicate_name = FALSE;
6164     int		using_dummy;
6165     char_u	*dirname_start = NULL;
6166     char_u	*dirname_now = NULL;
6167     int		found_match;
6168     aco_save_T	aco;
6169 
6170     dirname_start = alloc_id(MAXPATHL, aid_qf_dirname_start);
6171     dirname_now = alloc_id(MAXPATHL, aid_qf_dirname_now);
6172     if (dirname_start == NULL || dirname_now == NULL)
6173 	goto theend;
6174 
6175     // Remember the current directory, because a BufRead autocommand that does
6176     // ":lcd %:p:h" changes the meaning of short path names.
6177     mch_dirname(dirname_start, MAXPATHL);
6178 
6179     seconds = (time_t)0;
6180     for (fi = 0; fi < cmd_args->fcount && !got_int && cmd_args->tomatch > 0;
6181 									++fi)
6182     {
6183 	fname = shorten_fname1(cmd_args->fnames[fi]);
6184 	if (time(NULL) > seconds)
6185 	{
6186 	    // Display the file name every second or so, show the user we are
6187 	    // working on it.
6188 	    seconds = time(NULL);
6189 	    vgr_display_fname(fname);
6190 	}
6191 
6192 	buf = buflist_findname_exp(cmd_args->fnames[fi]);
6193 	if (buf == NULL || buf->b_ml.ml_mfp == NULL)
6194 	{
6195 	    // Remember that a buffer with this name already exists.
6196 	    duplicate_name = (buf != NULL);
6197 	    using_dummy = TRUE;
6198 	    *redraw_for_dummy = TRUE;
6199 
6200 	    buf = vgr_load_dummy_buf(fname, dirname_start, dirname_now);
6201 	}
6202 	else
6203 	    // Use existing, loaded buffer.
6204 	    using_dummy = FALSE;
6205 
6206 	// Check whether the quickfix list is still valid. When loading a
6207 	// buffer above, autocommands might have changed the quickfix list.
6208 	if (!vgr_qflist_valid(wp, qi, save_qfid, cmd_args->qf_title))
6209 	    goto theend;
6210 
6211 	save_qfid = qf_get_curlist(qi)->qf_id;
6212 
6213 	if (buf == NULL)
6214 	{
6215 	    if (!got_int)
6216 		smsg(_("Cannot open file \"%s\""), fname);
6217 	}
6218 	else
6219 	{
6220 	    // Try for a match in all lines of the buffer.
6221 	    // For ":1vimgrep" look for first match only.
6222 	    found_match = vgr_match_buflines(qf_get_curlist(qi),
6223 		    fname, buf, cmd_args->spat, &cmd_args->regmatch,
6224 		    &cmd_args->tomatch, duplicate_name, cmd_args->flags);
6225 
6226 	    if (using_dummy)
6227 	    {
6228 		if (found_match && *first_match_buf == NULL)
6229 		    *first_match_buf = buf;
6230 		if (duplicate_name)
6231 		{
6232 		    // Never keep a dummy buffer if there is another buffer
6233 		    // with the same name.
6234 		    wipe_dummy_buffer(buf, dirname_start);
6235 		    buf = NULL;
6236 		}
6237 		else if ((cmdmod.cmod_flags & CMOD_HIDE) == 0
6238 			    || buf->b_p_bh[0] == 'u'	// "unload"
6239 			    || buf->b_p_bh[0] == 'w'	// "wipe"
6240 			    || buf->b_p_bh[0] == 'd')	// "delete"
6241 		{
6242 		    // When no match was found we don't need to remember the
6243 		    // buffer, wipe it out.  If there was a match and it
6244 		    // wasn't the first one or we won't jump there: only
6245 		    // unload the buffer.
6246 		    // Ignore 'hidden' here, because it may lead to having too
6247 		    // many swap files.
6248 		    if (!found_match)
6249 		    {
6250 			wipe_dummy_buffer(buf, dirname_start);
6251 			buf = NULL;
6252 		    }
6253 		    else if (buf != *first_match_buf
6254 					|| (cmd_args->flags & VGR_NOJUMP)
6255 					|| existing_swapfile(buf))
6256 		    {
6257 			unload_dummy_buffer(buf, dirname_start);
6258 			// Keeping the buffer, remove the dummy flag.
6259 			buf->b_flags &= ~BF_DUMMY;
6260 			buf = NULL;
6261 		    }
6262 		}
6263 
6264 		if (buf != NULL)
6265 		{
6266 		    // Keeping the buffer, remove the dummy flag.
6267 		    buf->b_flags &= ~BF_DUMMY;
6268 
6269 		    // If the buffer is still loaded we need to use the
6270 		    // directory we jumped to below.
6271 		    if (buf == *first_match_buf
6272 			    && *target_dir == NULL
6273 			    && STRCMP(dirname_start, dirname_now) != 0)
6274 			*target_dir = vim_strsave(dirname_now);
6275 
6276 		    // The buffer is still loaded, the Filetype autocommands
6277 		    // need to be done now, in that buffer.  And the modelines
6278 		    // need to be done (again).  But not the window-local
6279 		    // options!
6280 		    aucmd_prepbuf(&aco, buf);
6281 #if defined(FEAT_SYN_HL)
6282 		    apply_autocmds(EVENT_FILETYPE, buf->b_p_ft,
6283 						     buf->b_fname, TRUE, buf);
6284 #endif
6285 		    do_modelines(OPT_NOWIN);
6286 		    aucmd_restbuf(&aco);
6287 		}
6288 	    }
6289 	}
6290     }
6291 
6292     status = OK;
6293 
6294 theend:
6295     vim_free(dirname_now);
6296     vim_free(dirname_start);
6297     return status;
6298 }
6299 
6300 /*
6301  * ":vimgrep {pattern} file(s)"
6302  * ":vimgrepadd {pattern} file(s)"
6303  * ":lvimgrep {pattern} file(s)"
6304  * ":lvimgrepadd {pattern} file(s)"
6305  */
6306     void
6307 ex_vimgrep(exarg_T *eap)
6308 {
6309     vgr_args_T	args;
6310     qf_info_T	*qi;
6311     qf_list_T	*qfl;
6312     int_u	save_qfid;
6313     win_T	*wp = NULL;
6314     int		redraw_for_dummy = FALSE;
6315     buf_T	*first_match_buf = NULL;
6316     char_u	*target_dir = NULL;
6317     char_u	*au_name =  NULL;
6318     int		status;
6319 
6320     au_name = vgr_get_auname(eap->cmdidx);
6321     if (au_name != NULL && apply_autocmds(EVENT_QUICKFIXCMDPRE, au_name,
6322 					       curbuf->b_fname, TRUE, curbuf))
6323     {
6324 #ifdef FEAT_EVAL
6325 	if (aborting())
6326 	    return;
6327 #endif
6328     }
6329 
6330     qi = qf_cmd_get_or_alloc_stack(eap, &wp);
6331     if (qi == NULL)
6332 	return;
6333 
6334     if (vgr_process_args(eap, &args) == FAIL)
6335 	goto theend;
6336 
6337     if ((eap->cmdidx != CMD_grepadd && eap->cmdidx != CMD_lgrepadd
6338 		&& eap->cmdidx != CMD_vimgrepadd
6339 		&& eap->cmdidx != CMD_lvimgrepadd)
6340 					|| qf_stack_empty(qi))
6341 	// make place for a new list
6342 	qf_new_list(qi, args.qf_title);
6343 
6344     incr_quickfix_busy();
6345 
6346     status = vgr_process_files(wp, qi, &args, &redraw_for_dummy,
6347 						&first_match_buf, &target_dir);
6348     if (status != OK)
6349     {
6350 	FreeWild(args.fcount, args.fnames);
6351 	decr_quickfix_busy();
6352 	goto theend;
6353     }
6354 
6355     FreeWild(args.fcount, args.fnames);
6356 
6357     qfl = qf_get_curlist(qi);
6358     qfl->qf_nonevalid = FALSE;
6359     qfl->qf_ptr = qfl->qf_start;
6360     qfl->qf_index = 1;
6361     qf_list_changed(qfl);
6362 
6363     qf_update_buffer(qi, NULL);
6364 
6365     // Remember the current quickfix list identifier, so that we can check for
6366     // autocommands changing the current quickfix list.
6367     save_qfid = qf_get_curlist(qi)->qf_id;
6368 
6369     if (au_name != NULL)
6370 	apply_autocmds(EVENT_QUICKFIXCMDPOST, au_name,
6371 					       curbuf->b_fname, TRUE, curbuf);
6372     // The QuickFixCmdPost autocmd may free the quickfix list. Check the list
6373     // is still valid.
6374     if (!qflist_valid(wp, save_qfid)
6375 	    || qf_restore_list(qi, save_qfid) == FAIL)
6376     {
6377 	decr_quickfix_busy();
6378 	goto theend;
6379     }
6380 
6381     // Jump to first match.
6382     if (!qf_list_empty(qf_get_curlist(qi)))
6383     {
6384 	if ((args.flags & VGR_NOJUMP) == 0)
6385 	    vgr_jump_to_match(qi, eap->forceit, &redraw_for_dummy,
6386 		    first_match_buf, target_dir);
6387     }
6388     else
6389 	semsg(_(e_nomatch2), args.spat);
6390 
6391     decr_quickfix_busy();
6392 
6393     // If we loaded a dummy buffer into the current window, the autocommands
6394     // may have messed up things, need to redraw and recompute folds.
6395     if (redraw_for_dummy)
6396     {
6397 #ifdef FEAT_FOLDING
6398 	foldUpdateAll(curwin);
6399 #else
6400 	redraw_later(NOT_VALID);
6401 #endif
6402     }
6403 
6404 theend:
6405     vim_free(args.qf_title);
6406     vim_free(target_dir);
6407     vim_regfree(args.regmatch.regprog);
6408 }
6409 
6410 /*
6411  * Restore current working directory to "dirname_start" if they differ, taking
6412  * into account whether it is set locally or globally.
6413  */
6414     static void
6415 restore_start_dir(char_u *dirname_start)
6416 {
6417     char_u *dirname_now = alloc(MAXPATHL);
6418 
6419     if (NULL != dirname_now)
6420     {
6421 	mch_dirname(dirname_now, MAXPATHL);
6422 	if (STRCMP(dirname_start, dirname_now) != 0)
6423 	{
6424 	    // If the directory has changed, change it back by building up an
6425 	    // appropriate ex command and executing it.
6426 	    exarg_T ea;
6427 
6428 	    CLEAR_FIELD(ea);
6429 	    ea.arg = dirname_start;
6430 	    ea.cmdidx = (curwin->w_localdir == NULL) ? CMD_cd : CMD_lcd;
6431 	    ex_cd(&ea);
6432 	}
6433 	vim_free(dirname_now);
6434     }
6435 }
6436 
6437 /*
6438  * Load file "fname" into a dummy buffer and return the buffer pointer,
6439  * placing the directory resulting from the buffer load into the
6440  * "resulting_dir" pointer. "resulting_dir" must be allocated by the caller
6441  * prior to calling this function. Restores directory to "dirname_start" prior
6442  * to returning, if autocmds or the 'autochdir' option have changed it.
6443  *
6444  * If creating the dummy buffer does not fail, must call unload_dummy_buffer()
6445  * or wipe_dummy_buffer() later!
6446  *
6447  * Returns NULL if it fails.
6448  */
6449     static buf_T *
6450 load_dummy_buffer(
6451     char_u	*fname,
6452     char_u	*dirname_start,  // in: old directory
6453     char_u	*resulting_dir)  // out: new directory
6454 {
6455     buf_T	*newbuf;
6456     bufref_T	newbufref;
6457     bufref_T	newbuf_to_wipe;
6458     int		failed = TRUE;
6459     aco_save_T	aco;
6460     int		readfile_result;
6461 
6462     // Allocate a buffer without putting it in the buffer list.
6463     newbuf = buflist_new(NULL, NULL, (linenr_T)1, BLN_DUMMY);
6464     if (newbuf == NULL)
6465 	return NULL;
6466     set_bufref(&newbufref, newbuf);
6467 
6468     // Init the options.
6469     buf_copy_options(newbuf, BCO_ENTER | BCO_NOHELP);
6470 
6471     // need to open the memfile before putting the buffer in a window
6472     if (ml_open(newbuf) == OK)
6473     {
6474 	// Make sure this buffer isn't wiped out by autocommands.
6475 	++newbuf->b_locked;
6476 
6477 	// set curwin/curbuf to buf and save a few things
6478 	aucmd_prepbuf(&aco, newbuf);
6479 
6480 	// Need to set the filename for autocommands.
6481 	(void)setfname(curbuf, fname, NULL, FALSE);
6482 
6483 	// Create swap file now to avoid the ATTENTION message.
6484 	check_need_swap(TRUE);
6485 
6486 	// Remove the "dummy" flag, otherwise autocommands may not
6487 	// work.
6488 	curbuf->b_flags &= ~BF_DUMMY;
6489 
6490 	newbuf_to_wipe.br_buf = NULL;
6491 	readfile_result = readfile(fname, NULL,
6492 		    (linenr_T)0, (linenr_T)0, (linenr_T)MAXLNUM,
6493 		    NULL, READ_NEW | READ_DUMMY);
6494 	--newbuf->b_locked;
6495 	if (readfile_result == OK
6496 		&& !got_int
6497 		&& !(curbuf->b_flags & BF_NEW))
6498 	{
6499 	    failed = FALSE;
6500 	    if (curbuf != newbuf)
6501 	    {
6502 		// Bloody autocommands changed the buffer!  Can happen when
6503 		// using netrw and editing a remote file.  Use the current
6504 		// buffer instead, delete the dummy one after restoring the
6505 		// window stuff.
6506 		set_bufref(&newbuf_to_wipe, newbuf);
6507 		newbuf = curbuf;
6508 	    }
6509 	}
6510 
6511 	// restore curwin/curbuf and a few other things
6512 	aucmd_restbuf(&aco);
6513 	if (newbuf_to_wipe.br_buf != NULL && bufref_valid(&newbuf_to_wipe))
6514 	    wipe_buffer(newbuf_to_wipe.br_buf, FALSE);
6515 
6516 	// Add back the "dummy" flag, otherwise buflist_findname_stat() won't
6517 	// skip it.
6518 	newbuf->b_flags |= BF_DUMMY;
6519     }
6520 
6521     // When autocommands/'autochdir' option changed directory: go back.
6522     // Let the caller know what the resulting dir was first, in case it is
6523     // important.
6524     mch_dirname(resulting_dir, MAXPATHL);
6525     restore_start_dir(dirname_start);
6526 
6527     if (!bufref_valid(&newbufref))
6528 	return NULL;
6529     if (failed)
6530     {
6531 	wipe_dummy_buffer(newbuf, dirname_start);
6532 	return NULL;
6533     }
6534     return newbuf;
6535 }
6536 
6537 /*
6538  * Wipe out the dummy buffer that load_dummy_buffer() created. Restores
6539  * directory to "dirname_start" prior to returning, if autocmds or the
6540  * 'autochdir' option have changed it.
6541  */
6542     static void
6543 wipe_dummy_buffer(buf_T *buf, char_u *dirname_start)
6544 {
6545     // If any autocommand opened a window on the dummy buffer, close that
6546     // window.  If we can't close them all then give up.
6547     while (buf->b_nwindows > 0)
6548     {
6549 	int	    did_one = FALSE;
6550 	win_T	    *wp;
6551 
6552 	if (firstwin->w_next != NULL)
6553 	    FOR_ALL_WINDOWS(wp)
6554 		if (wp->w_buffer == buf)
6555 		{
6556 		    if (win_close(wp, FALSE) == OK)
6557 			did_one = TRUE;
6558 		    break;
6559 		}
6560 	if (!did_one)
6561 	    return;
6562     }
6563 
6564     if (curbuf != buf && buf->b_nwindows == 0)	// safety check
6565     {
6566 #if defined(FEAT_EVAL)
6567 	cleanup_T   cs;
6568 
6569 	// Reset the error/interrupt/exception state here so that aborting()
6570 	// returns FALSE when wiping out the buffer.  Otherwise it doesn't
6571 	// work when got_int is set.
6572 	enter_cleanup(&cs);
6573 #endif
6574 
6575 	wipe_buffer(buf, TRUE);
6576 
6577 #if defined(FEAT_EVAL)
6578 	// Restore the error/interrupt/exception state if not discarded by a
6579 	// new aborting error, interrupt, or uncaught exception.
6580 	leave_cleanup(&cs);
6581 #endif
6582 	// When autocommands/'autochdir' option changed directory: go back.
6583 	restore_start_dir(dirname_start);
6584     }
6585 }
6586 
6587 /*
6588  * Unload the dummy buffer that load_dummy_buffer() created. Restores
6589  * directory to "dirname_start" prior to returning, if autocmds or the
6590  * 'autochdir' option have changed it.
6591  */
6592     static void
6593 unload_dummy_buffer(buf_T *buf, char_u *dirname_start)
6594 {
6595     if (curbuf != buf)		// safety check
6596     {
6597 	close_buffer(NULL, buf, DOBUF_UNLOAD, FALSE, TRUE);
6598 
6599 	// When autocommands/'autochdir' option changed directory: go back.
6600 	restore_start_dir(dirname_start);
6601     }
6602 }
6603 
6604 #if defined(FEAT_EVAL) || defined(PROTO)
6605 /*
6606  * Copy the specified quickfix entry items into a new dict and append the dict
6607  * to 'list'.  Returns OK on success.
6608  */
6609     static int
6610 get_qfline_items(qfline_T *qfp, list_T *list)
6611 {
6612     int		bufnum;
6613     dict_T	*dict;
6614     char_u	buf[2];
6615 
6616     // Handle entries with a non-existing buffer number.
6617     bufnum = qfp->qf_fnum;
6618     if (bufnum != 0 && (buflist_findnr(bufnum) == NULL))
6619 	bufnum = 0;
6620 
6621     if ((dict = dict_alloc()) == NULL)
6622 	return FAIL;
6623     if (list_append_dict(list, dict) == FAIL)
6624 	return FAIL;
6625 
6626     buf[0] = qfp->qf_type;
6627     buf[1] = NUL;
6628     if (dict_add_number(dict, "bufnr", (long)bufnum) == FAIL
6629 	    || dict_add_number(dict, "lnum",  (long)qfp->qf_lnum) == FAIL
6630 	    || dict_add_number(dict, "col",   (long)qfp->qf_col) == FAIL
6631 	    || dict_add_number(dict, "vcol",  (long)qfp->qf_viscol) == FAIL
6632 	    || dict_add_number(dict, "nr",    (long)qfp->qf_nr) == FAIL
6633 	    || dict_add_string(dict, "module", qfp->qf_module) == FAIL
6634 	    || dict_add_string(dict, "pattern", qfp->qf_pattern) == FAIL
6635 	    || dict_add_string(dict, "text", qfp->qf_text) == FAIL
6636 	    || dict_add_string(dict, "type", buf) == FAIL
6637 	    || dict_add_number(dict, "valid", (long)qfp->qf_valid) == FAIL)
6638 	return FAIL;
6639 
6640     return OK;
6641 }
6642 
6643 /*
6644  * Add each quickfix error to list "list" as a dictionary.
6645  * If qf_idx is -1, use the current list. Otherwise, use the specified list.
6646  * If eidx is not 0, then return only the specified entry. Otherwise return
6647  * all the entries.
6648  */
6649     static int
6650 get_errorlist(
6651 	qf_info_T	*qi_arg,
6652 	win_T		*wp,
6653 	int		qf_idx,
6654 	int		eidx,
6655 	list_T		*list)
6656 {
6657     qf_info_T	*qi = qi_arg;
6658     qf_list_T	*qfl;
6659     qfline_T	*qfp;
6660     int		i;
6661 
6662     if (qi == NULL)
6663     {
6664 	qi = &ql_info;
6665 	if (wp != NULL)
6666 	{
6667 	    qi = GET_LOC_LIST(wp);
6668 	    if (qi == NULL)
6669 		return FAIL;
6670 	}
6671     }
6672 
6673     if (eidx < 0)
6674 	return OK;
6675 
6676     if (qf_idx == INVALID_QFIDX)
6677 	qf_idx = qi->qf_curlist;
6678 
6679     if (qf_idx >= qi->qf_listcount)
6680 	return FAIL;
6681 
6682     qfl = qf_get_list(qi, qf_idx);
6683     if (qf_list_empty(qfl))
6684 	return FAIL;
6685 
6686     FOR_ALL_QFL_ITEMS(qfl, qfp, i)
6687     {
6688 	if (eidx > 0)
6689 	{
6690 	    if (eidx == i)
6691 		return get_qfline_items(qfp, list);
6692 	}
6693 	else if (get_qfline_items(qfp, list) == FAIL)
6694 	    return FAIL;
6695     }
6696 
6697     return OK;
6698 }
6699 
6700 // Flags used by getqflist()/getloclist() to determine which fields to return.
6701 enum {
6702     QF_GETLIST_NONE	= 0x0,
6703     QF_GETLIST_TITLE	= 0x1,
6704     QF_GETLIST_ITEMS	= 0x2,
6705     QF_GETLIST_NR	= 0x4,
6706     QF_GETLIST_WINID	= 0x8,
6707     QF_GETLIST_CONTEXT	= 0x10,
6708     QF_GETLIST_ID	= 0x20,
6709     QF_GETLIST_IDX	= 0x40,
6710     QF_GETLIST_SIZE	= 0x80,
6711     QF_GETLIST_TICK	= 0x100,
6712     QF_GETLIST_FILEWINID	= 0x200,
6713     QF_GETLIST_QFBUFNR	= 0x400,
6714     QF_GETLIST_QFTF	= 0x800,
6715     QF_GETLIST_ALL	= 0xFFF,
6716 };
6717 
6718 /*
6719  * Parse text from 'di' and return the quickfix list items.
6720  * Existing quickfix lists are not modified.
6721  */
6722     static int
6723 qf_get_list_from_lines(dict_T *what, dictitem_T *di, dict_T *retdict)
6724 {
6725     int		status = FAIL;
6726     qf_info_T	*qi;
6727     char_u	*errorformat = p_efm;
6728     dictitem_T	*efm_di;
6729     list_T	*l;
6730 
6731     // Only a List value is supported
6732     if (di->di_tv.v_type == VAR_LIST && di->di_tv.vval.v_list != NULL)
6733     {
6734 	// If errorformat is supplied then use it, otherwise use the 'efm'
6735 	// option setting
6736 	if ((efm_di = dict_find(what, (char_u *)"efm", -1)) != NULL)
6737 	{
6738 	    if (efm_di->di_tv.v_type != VAR_STRING ||
6739 		    efm_di->di_tv.vval.v_string == NULL)
6740 		return FAIL;
6741 	    errorformat = efm_di->di_tv.vval.v_string;
6742 	}
6743 
6744 	l = list_alloc();
6745 	if (l == NULL)
6746 	    return FAIL;
6747 
6748 	qi = qf_alloc_stack(QFLT_INTERNAL);
6749 	if (qi != NULL)
6750 	{
6751 	    if (qf_init_ext(qi, 0, NULL, NULL, &di->di_tv, errorformat,
6752 			TRUE, (linenr_T)0, (linenr_T)0, NULL, NULL) > 0)
6753 	    {
6754 		(void)get_errorlist(qi, NULL, 0, 0, l);
6755 		qf_free(&qi->qf_lists[0]);
6756 	    }
6757 	    free(qi);
6758 	}
6759 	dict_add_list(retdict, "items", l);
6760 	status = OK;
6761     }
6762 
6763     return status;
6764 }
6765 
6766 /*
6767  * Return the quickfix/location list window identifier in the current tabpage.
6768  */
6769     static int
6770 qf_winid(qf_info_T *qi)
6771 {
6772     win_T	*win;
6773 
6774     // The quickfix window can be opened even if the quickfix list is not set
6775     // using ":copen". This is not true for location lists.
6776     if (qi == NULL)
6777 	return 0;
6778     win = qf_find_win(qi);
6779     if (win != NULL)
6780 	return win->w_id;
6781     return 0;
6782 }
6783 
6784 /*
6785  * Returns the number of the buffer displayed in the quickfix/location list
6786  * window. If there is no buffer associated with the list, then returns 0.
6787  */
6788     static int
6789 qf_getprop_qfbufnr(qf_info_T *qi, dict_T *retdict)
6790 {
6791     return dict_add_number(retdict, "qfbufnr",
6792 					(qi == NULL) ? 0 : qi->qf_bufnr);
6793 }
6794 
6795 /*
6796  * Convert the keys in 'what' to quickfix list property flags.
6797  */
6798     static int
6799 qf_getprop_keys2flags(dict_T *what, int loclist)
6800 {
6801     int		flags = QF_GETLIST_NONE;
6802 
6803     if (dict_find(what, (char_u *)"all", -1) != NULL)
6804     {
6805 	flags |= QF_GETLIST_ALL;
6806 	if (!loclist)
6807 	    // File window ID is applicable only to location list windows
6808 	    flags &= ~ QF_GETLIST_FILEWINID;
6809     }
6810 
6811     if (dict_find(what, (char_u *)"title", -1) != NULL)
6812 	flags |= QF_GETLIST_TITLE;
6813 
6814     if (dict_find(what, (char_u *)"nr", -1) != NULL)
6815 	flags |= QF_GETLIST_NR;
6816 
6817     if (dict_find(what, (char_u *)"winid", -1) != NULL)
6818 	flags |= QF_GETLIST_WINID;
6819 
6820     if (dict_find(what, (char_u *)"context", -1) != NULL)
6821 	flags |= QF_GETLIST_CONTEXT;
6822 
6823     if (dict_find(what, (char_u *)"id", -1) != NULL)
6824 	flags |= QF_GETLIST_ID;
6825 
6826     if (dict_find(what, (char_u *)"items", -1) != NULL)
6827 	flags |= QF_GETLIST_ITEMS;
6828 
6829     if (dict_find(what, (char_u *)"idx", -1) != NULL)
6830 	flags |= QF_GETLIST_IDX;
6831 
6832     if (dict_find(what, (char_u *)"size", -1) != NULL)
6833 	flags |= QF_GETLIST_SIZE;
6834 
6835     if (dict_find(what, (char_u *)"changedtick", -1) != NULL)
6836 	flags |= QF_GETLIST_TICK;
6837 
6838     if (loclist && dict_find(what, (char_u *)"filewinid", -1) != NULL)
6839 	flags |= QF_GETLIST_FILEWINID;
6840 
6841     if (dict_find(what, (char_u *)"qfbufnr", -1) != NULL)
6842 	flags |= QF_GETLIST_QFBUFNR;
6843 
6844     if (dict_find(what, (char_u *)"quickfixtextfunc", -1) != NULL)
6845 	flags |= QF_GETLIST_QFTF;
6846 
6847     return flags;
6848 }
6849 
6850 /*
6851  * Return the quickfix list index based on 'nr' or 'id' in 'what'.
6852  * If 'nr' and 'id' are not present in 'what' then return the current
6853  * quickfix list index.
6854  * If 'nr' is zero then return the current quickfix list index.
6855  * If 'nr' is '$' then return the last quickfix list index.
6856  * If 'id' is present then return the index of the quickfix list with that id.
6857  * If 'id' is zero then return the quickfix list index specified by 'nr'.
6858  * Return -1, if quickfix list is not present or if the stack is empty.
6859  */
6860     static int
6861 qf_getprop_qfidx(qf_info_T *qi, dict_T *what)
6862 {
6863     int		qf_idx;
6864     dictitem_T	*di;
6865 
6866     qf_idx = qi->qf_curlist;	// default is the current list
6867     if ((di = dict_find(what, (char_u *)"nr", -1)) != NULL)
6868     {
6869 	// Use the specified quickfix/location list
6870 	if (di->di_tv.v_type == VAR_NUMBER)
6871 	{
6872 	    // for zero use the current list
6873 	    if (di->di_tv.vval.v_number != 0)
6874 	    {
6875 		qf_idx = di->di_tv.vval.v_number - 1;
6876 		if (qf_idx < 0 || qf_idx >= qi->qf_listcount)
6877 		    qf_idx = INVALID_QFIDX;
6878 	    }
6879 	}
6880 	else if (di->di_tv.v_type == VAR_STRING
6881 		&& di->di_tv.vval.v_string != NULL
6882 		&& STRCMP(di->di_tv.vval.v_string, "$") == 0)
6883 	    // Get the last quickfix list number
6884 	    qf_idx = qi->qf_listcount - 1;
6885 	else
6886 	    qf_idx = INVALID_QFIDX;
6887     }
6888 
6889     if ((di = dict_find(what, (char_u *)"id", -1)) != NULL)
6890     {
6891 	// Look for a list with the specified id
6892 	if (di->di_tv.v_type == VAR_NUMBER)
6893 	{
6894 	    // For zero, use the current list or the list specified by 'nr'
6895 	    if (di->di_tv.vval.v_number != 0)
6896 		qf_idx = qf_id2nr(qi, di->di_tv.vval.v_number);
6897 	}
6898 	else
6899 	    qf_idx = INVALID_QFIDX;
6900     }
6901 
6902     return qf_idx;
6903 }
6904 
6905 /*
6906  * Return default values for quickfix list properties in retdict.
6907  */
6908     static int
6909 qf_getprop_defaults(qf_info_T *qi, int flags, int locstack, dict_T *retdict)
6910 {
6911     int		status = OK;
6912 
6913     if (flags & QF_GETLIST_TITLE)
6914 	status = dict_add_string(retdict, "title", (char_u *)"");
6915     if ((status == OK) && (flags & QF_GETLIST_ITEMS))
6916     {
6917 	list_T	*l = list_alloc();
6918 	if (l != NULL)
6919 	    status = dict_add_list(retdict, "items", l);
6920 	else
6921 	    status = FAIL;
6922     }
6923     if ((status == OK) && (flags & QF_GETLIST_NR))
6924 	status = dict_add_number(retdict, "nr", 0);
6925     if ((status == OK) && (flags & QF_GETLIST_WINID))
6926 	status = dict_add_number(retdict, "winid", qf_winid(qi));
6927     if ((status == OK) && (flags & QF_GETLIST_CONTEXT))
6928 	status = dict_add_string(retdict, "context", (char_u *)"");
6929     if ((status == OK) && (flags & QF_GETLIST_ID))
6930 	status = dict_add_number(retdict, "id", 0);
6931     if ((status == OK) && (flags & QF_GETLIST_IDX))
6932 	status = dict_add_number(retdict, "idx", 0);
6933     if ((status == OK) && (flags & QF_GETLIST_SIZE))
6934 	status = dict_add_number(retdict, "size", 0);
6935     if ((status == OK) && (flags & QF_GETLIST_TICK))
6936 	status = dict_add_number(retdict, "changedtick", 0);
6937     if ((status == OK) && locstack && (flags & QF_GETLIST_FILEWINID))
6938 	status = dict_add_number(retdict, "filewinid", 0);
6939     if ((status == OK) && (flags & QF_GETLIST_QFBUFNR))
6940 	status = qf_getprop_qfbufnr(qi, retdict);
6941     if ((status == OK) && (flags & QF_GETLIST_QFTF))
6942 	status = dict_add_string(retdict, "quickfixtextfunc", (char_u *)"");
6943 
6944     return status;
6945 }
6946 
6947 /*
6948  * Return the quickfix list title as 'title' in retdict
6949  */
6950     static int
6951 qf_getprop_title(qf_list_T *qfl, dict_T *retdict)
6952 {
6953     return dict_add_string(retdict, "title", qfl->qf_title);
6954 }
6955 
6956 /*
6957  * Returns the identifier of the window used to display files from a location
6958  * list.  If there is no associated window, then returns 0. Useful only when
6959  * called from a location list window.
6960  */
6961     static int
6962 qf_getprop_filewinid(win_T *wp, qf_info_T *qi, dict_T *retdict)
6963 {
6964     int winid = 0;
6965 
6966     if (wp != NULL && IS_LL_WINDOW(wp))
6967     {
6968 	win_T	*ll_wp = qf_find_win_with_loclist(qi);
6969 	if (ll_wp != NULL)
6970 	    winid = ll_wp->w_id;
6971     }
6972 
6973     return dict_add_number(retdict, "filewinid", winid);
6974 }
6975 
6976 /*
6977  * Return the quickfix list items/entries as 'items' in retdict.
6978  * If eidx is not 0, then return the item at the specified index.
6979  */
6980     static int
6981 qf_getprop_items(qf_info_T *qi, int qf_idx, int eidx, dict_T *retdict)
6982 {
6983     int		status = OK;
6984     list_T	*l = list_alloc();
6985     if (l != NULL)
6986     {
6987 	(void)get_errorlist(qi, NULL, qf_idx, eidx, l);
6988 	dict_add_list(retdict, "items", l);
6989     }
6990     else
6991 	status = FAIL;
6992 
6993     return status;
6994 }
6995 
6996 /*
6997  * Return the quickfix list context (if any) as 'context' in retdict.
6998  */
6999     static int
7000 qf_getprop_ctx(qf_list_T *qfl, dict_T *retdict)
7001 {
7002     int		status;
7003     dictitem_T	*di;
7004 
7005     if (qfl->qf_ctx != NULL)
7006     {
7007 	di = dictitem_alloc((char_u *)"context");
7008 	if (di != NULL)
7009 	{
7010 	    copy_tv(qfl->qf_ctx, &di->di_tv);
7011 	    status = dict_add(retdict, di);
7012 	    if (status == FAIL)
7013 		dictitem_free(di);
7014 	}
7015 	else
7016 	    status = FAIL;
7017     }
7018     else
7019 	status = dict_add_string(retdict, "context", (char_u *)"");
7020 
7021     return status;
7022 }
7023 
7024 /*
7025  * Return the current quickfix list index as 'idx' in retdict.
7026  * If a specific entry index (eidx) is supplied, then use that.
7027  */
7028     static int
7029 qf_getprop_idx(qf_list_T *qfl, int eidx, dict_T *retdict)
7030 {
7031     if (eidx == 0)
7032     {
7033 	eidx = qfl->qf_index;
7034 	if (qf_list_empty(qfl))
7035 	    // For empty lists, current index is set to 0
7036 	    eidx = 0;
7037     }
7038     return dict_add_number(retdict, "idx", eidx);
7039 }
7040 
7041 /*
7042  * Return the 'quickfixtextfunc' function of a quickfix/location list
7043  */
7044     static int
7045 qf_getprop_qftf(qf_list_T *qfl, dict_T *retdict)
7046 {
7047     int		status;
7048 
7049     if (qfl->qftf_cb.cb_name != NULL)
7050     {
7051 	typval_T	tv;
7052 
7053 	put_callback(&qfl->qftf_cb, &tv);
7054 	status = dict_add_tv(retdict, "quickfixtextfunc", &tv);
7055 	clear_tv(&tv);
7056     }
7057     else
7058 	status = dict_add_string(retdict, "quickfixtextfunc", (char_u *)"");
7059 
7060     return status;
7061 }
7062 
7063 /*
7064  * Return quickfix/location list details (title) as a
7065  * dictionary. 'what' contains the details to return. If 'list_idx' is -1,
7066  * then current list is used. Otherwise the specified list is used.
7067  */
7068     static int
7069 qf_get_properties(win_T *wp, dict_T *what, dict_T *retdict)
7070 {
7071     qf_info_T	*qi = &ql_info;
7072     qf_list_T	*qfl;
7073     int		status = OK;
7074     int		qf_idx = INVALID_QFIDX;
7075     int		eidx = 0;
7076     dictitem_T	*di;
7077     int		flags = QF_GETLIST_NONE;
7078 
7079     if ((di = dict_find(what, (char_u *)"lines", -1)) != NULL)
7080 	return qf_get_list_from_lines(what, di, retdict);
7081 
7082     if (wp != NULL)
7083 	qi = GET_LOC_LIST(wp);
7084 
7085     flags = qf_getprop_keys2flags(what, (wp != NULL));
7086 
7087     if (!qf_stack_empty(qi))
7088 	qf_idx = qf_getprop_qfidx(qi, what);
7089 
7090     // List is not present or is empty
7091     if (qf_stack_empty(qi) || qf_idx == INVALID_QFIDX)
7092 	return qf_getprop_defaults(qi, flags, wp != NULL, retdict);
7093 
7094     qfl = qf_get_list(qi, qf_idx);
7095 
7096     // If an entry index is specified, use that
7097     if ((di = dict_find(what, (char_u *)"idx", -1)) != NULL)
7098     {
7099 	if (di->di_tv.v_type != VAR_NUMBER)
7100 	    return FAIL;
7101 	eidx = di->di_tv.vval.v_number;
7102     }
7103 
7104     if (flags & QF_GETLIST_TITLE)
7105 	status = qf_getprop_title(qfl, retdict);
7106     if ((status == OK) && (flags & QF_GETLIST_NR))
7107 	status = dict_add_number(retdict, "nr", qf_idx + 1);
7108     if ((status == OK) && (flags & QF_GETLIST_WINID))
7109 	status = dict_add_number(retdict, "winid", qf_winid(qi));
7110     if ((status == OK) && (flags & QF_GETLIST_ITEMS))
7111 	status = qf_getprop_items(qi, qf_idx, eidx, retdict);
7112     if ((status == OK) && (flags & QF_GETLIST_CONTEXT))
7113 	status = qf_getprop_ctx(qfl, retdict);
7114     if ((status == OK) && (flags & QF_GETLIST_ID))
7115 	status = dict_add_number(retdict, "id", qfl->qf_id);
7116     if ((status == OK) && (flags & QF_GETLIST_IDX))
7117 	status = qf_getprop_idx(qfl, eidx, retdict);
7118     if ((status == OK) && (flags & QF_GETLIST_SIZE))
7119 	status = dict_add_number(retdict, "size", qfl->qf_count);
7120     if ((status == OK) && (flags & QF_GETLIST_TICK))
7121 	status = dict_add_number(retdict, "changedtick", qfl->qf_changedtick);
7122     if ((status == OK) && (wp != NULL) && (flags & QF_GETLIST_FILEWINID))
7123 	status = qf_getprop_filewinid(wp, qi, retdict);
7124     if ((status == OK) && (flags & QF_GETLIST_QFBUFNR))
7125 	status = qf_getprop_qfbufnr(qi, retdict);
7126     if ((status == OK) && (flags & QF_GETLIST_QFTF))
7127 	status = qf_getprop_qftf(qfl, retdict);
7128 
7129     return status;
7130 }
7131 
7132 /*
7133  * Add a new quickfix entry to list at 'qf_idx' in the stack 'qi' from the
7134  * items in the dict 'd'. If it is a valid error entry, then set 'valid_entry'
7135  * to TRUE.
7136  */
7137     static int
7138 qf_add_entry_from_dict(
7139 	qf_list_T	*qfl,
7140 	dict_T		*d,
7141 	int		first_entry,
7142 	int		*valid_entry)
7143 {
7144     static int	did_bufnr_emsg;
7145     char_u	*filename, *module, *pattern, *text, *type;
7146     int		bufnum, valid, status, col, vcol, nr;
7147     long	lnum;
7148 
7149     if (first_entry)
7150 	did_bufnr_emsg = FALSE;
7151 
7152     filename = dict_get_string(d, (char_u *)"filename", TRUE);
7153     module = dict_get_string(d, (char_u *)"module", TRUE);
7154     bufnum = (int)dict_get_number(d, (char_u *)"bufnr");
7155     lnum = (int)dict_get_number(d, (char_u *)"lnum");
7156     col = (int)dict_get_number(d, (char_u *)"col");
7157     vcol = (int)dict_get_number(d, (char_u *)"vcol");
7158     nr = (int)dict_get_number(d, (char_u *)"nr");
7159     type = dict_get_string(d, (char_u *)"type", TRUE);
7160     pattern = dict_get_string(d, (char_u *)"pattern", TRUE);
7161     text = dict_get_string(d, (char_u *)"text", TRUE);
7162     if (text == NULL)
7163 	text = vim_strsave((char_u *)"");
7164 
7165     valid = TRUE;
7166     if ((filename == NULL && bufnum == 0) || (lnum == 0 && pattern == NULL))
7167 	valid = FALSE;
7168 
7169     // Mark entries with non-existing buffer number as not valid. Give the
7170     // error message only once.
7171     if (bufnum != 0 && (buflist_findnr(bufnum) == NULL))
7172     {
7173 	if (!did_bufnr_emsg)
7174 	{
7175 	    did_bufnr_emsg = TRUE;
7176 	    semsg(_("E92: Buffer %d not found"), bufnum);
7177 	}
7178 	valid = FALSE;
7179 	bufnum = 0;
7180     }
7181 
7182     // If the 'valid' field is present it overrules the detected value.
7183     if ((dict_find(d, (char_u *)"valid", -1)) != NULL)
7184 	valid = (int)dict_get_bool(d, (char_u *)"valid", FALSE);
7185 
7186     status =  qf_add_entry(qfl,
7187 			NULL,		// dir
7188 			filename,
7189 			module,
7190 			bufnum,
7191 			text,
7192 			lnum,
7193 			col,
7194 			vcol,		// vis_col
7195 			pattern,	// search pattern
7196 			nr,
7197 			type == NULL ? NUL : *type,
7198 			valid);
7199 
7200     vim_free(filename);
7201     vim_free(module);
7202     vim_free(pattern);
7203     vim_free(text);
7204     vim_free(type);
7205 
7206     if (valid)
7207 	*valid_entry = TRUE;
7208 
7209     return status;
7210 }
7211 
7212 /*
7213  * Add list of entries to quickfix/location list. Each list entry is
7214  * a dictionary with item information.
7215  */
7216     static int
7217 qf_add_entries(
7218 	qf_info_T	*qi,
7219 	int		qf_idx,
7220 	list_T		*list,
7221 	char_u		*title,
7222 	int		action)
7223 {
7224     qf_list_T	*qfl = qf_get_list(qi, qf_idx);
7225     listitem_T	*li;
7226     dict_T	*d;
7227     qfline_T	*old_last = NULL;
7228     int		retval = OK;
7229     int		valid_entry = FALSE;
7230 
7231     if (action == ' ' || qf_idx == qi->qf_listcount)
7232     {
7233 	// make place for a new list
7234 	qf_new_list(qi, title);
7235 	qf_idx = qi->qf_curlist;
7236 	qfl = qf_get_list(qi, qf_idx);
7237     }
7238     else if (action == 'a' && !qf_list_empty(qfl))
7239 	// Adding to existing list, use last entry.
7240 	old_last = qfl->qf_last;
7241     else if (action == 'r')
7242     {
7243 	qf_free_items(qfl);
7244 	qf_store_title(qfl, title);
7245     }
7246 
7247     FOR_ALL_LIST_ITEMS(list, li)
7248     {
7249 	if (li->li_tv.v_type != VAR_DICT)
7250 	    continue; // Skip non-dict items
7251 
7252 	d = li->li_tv.vval.v_dict;
7253 	if (d == NULL)
7254 	    continue;
7255 
7256 	retval = qf_add_entry_from_dict(qfl, d, li == list->lv_first,
7257 								&valid_entry);
7258 	if (retval == QF_FAIL)
7259 	    break;
7260     }
7261 
7262     // Check if any valid error entries are added to the list.
7263     if (valid_entry)
7264 	qfl->qf_nonevalid = FALSE;
7265     else if (qfl->qf_index == 0)
7266 	// no valid entry
7267 	qfl->qf_nonevalid = TRUE;
7268 
7269     // If not appending to the list, set the current error to the first entry
7270     if (action != 'a')
7271 	qfl->qf_ptr = qfl->qf_start;
7272 
7273     // Update the current error index if not appending to the list or if the
7274     // list was empty before and it is not empty now.
7275     if ((action != 'a' || qfl->qf_index == 0) && !qf_list_empty(qfl))
7276 	qfl->qf_index = 1;
7277 
7278     // Don't update the cursor in quickfix window when appending entries
7279     qf_update_buffer(qi, old_last);
7280 
7281     return retval;
7282 }
7283 
7284 /*
7285  * Get the quickfix list index from 'nr' or 'id'
7286  */
7287     static int
7288 qf_setprop_get_qfidx(
7289 	qf_info_T	*qi,
7290 	dict_T		*what,
7291 	int		action,
7292 	int		*newlist)
7293 {
7294     dictitem_T	*di;
7295     int		qf_idx = qi->qf_curlist;    // default is the current list
7296 
7297     if ((di = dict_find(what, (char_u *)"nr", -1)) != NULL)
7298     {
7299 	// Use the specified quickfix/location list
7300 	if (di->di_tv.v_type == VAR_NUMBER)
7301 	{
7302 	    // for zero use the current list
7303 	    if (di->di_tv.vval.v_number != 0)
7304 		qf_idx = di->di_tv.vval.v_number - 1;
7305 
7306 	    if ((action == ' ' || action == 'a') && qf_idx == qi->qf_listcount)
7307 	    {
7308 		// When creating a new list, accept qf_idx pointing to the next
7309 		// non-available list and add the new list at the end of the
7310 		// stack.
7311 		*newlist = TRUE;
7312 		qf_idx = qf_stack_empty(qi) ? 0 : qi->qf_listcount - 1;
7313 	    }
7314 	    else if (qf_idx < 0 || qf_idx >= qi->qf_listcount)
7315 		return INVALID_QFIDX;
7316 	    else if (action != ' ')
7317 		*newlist = FALSE;	// use the specified list
7318 	}
7319 	else if (di->di_tv.v_type == VAR_STRING
7320 		&& di->di_tv.vval.v_string != NULL
7321 		&& STRCMP(di->di_tv.vval.v_string, "$") == 0)
7322 	{
7323 	    if (!qf_stack_empty(qi))
7324 		qf_idx = qi->qf_listcount - 1;
7325 	    else if (*newlist)
7326 		qf_idx = 0;
7327 	    else
7328 		return INVALID_QFIDX;
7329 	}
7330 	else
7331 	    return INVALID_QFIDX;
7332     }
7333 
7334     if (!*newlist && (di = dict_find(what, (char_u *)"id", -1)) != NULL)
7335     {
7336 	// Use the quickfix/location list with the specified id
7337 	if (di->di_tv.v_type != VAR_NUMBER)
7338 	    return INVALID_QFIDX;
7339 
7340 	return qf_id2nr(qi, di->di_tv.vval.v_number);
7341     }
7342 
7343     return qf_idx;
7344 }
7345 
7346 /*
7347  * Set the quickfix list title.
7348  */
7349     static int
7350 qf_setprop_title(qf_info_T *qi, int qf_idx, dict_T *what, dictitem_T *di)
7351 {
7352     qf_list_T	*qfl = qf_get_list(qi, qf_idx);
7353 
7354     if (di->di_tv.v_type != VAR_STRING)
7355 	return FAIL;
7356 
7357     vim_free(qfl->qf_title);
7358     qfl->qf_title = dict_get_string(what, (char_u *)"title", TRUE);
7359     if (qf_idx == qi->qf_curlist)
7360 	qf_update_win_titlevar(qi);
7361 
7362     return OK;
7363 }
7364 
7365 /*
7366  * Set quickfix list items/entries.
7367  */
7368     static int
7369 qf_setprop_items(qf_info_T *qi, int qf_idx, dictitem_T *di, int action)
7370 {
7371     int		retval = FAIL;
7372     char_u	*title_save;
7373 
7374     if (di->di_tv.v_type != VAR_LIST)
7375 	return FAIL;
7376 
7377     title_save = vim_strsave(qi->qf_lists[qf_idx].qf_title);
7378     retval = qf_add_entries(qi, qf_idx, di->di_tv.vval.v_list,
7379 	    title_save, action == ' ' ? 'a' : action);
7380     vim_free(title_save);
7381 
7382     return retval;
7383 }
7384 
7385 /*
7386  * Set quickfix list items/entries from a list of lines.
7387  */
7388     static int
7389 qf_setprop_items_from_lines(
7390 	qf_info_T	*qi,
7391 	int		qf_idx,
7392 	dict_T		*what,
7393 	dictitem_T	*di,
7394 	int		action)
7395 {
7396     char_u	*errorformat = p_efm;
7397     dictitem_T	*efm_di;
7398     int		retval = FAIL;
7399 
7400     // Use the user supplied errorformat settings (if present)
7401     if ((efm_di = dict_find(what, (char_u *)"efm", -1)) != NULL)
7402     {
7403 	if (efm_di->di_tv.v_type != VAR_STRING ||
7404 		efm_di->di_tv.vval.v_string == NULL)
7405 	    return FAIL;
7406 	errorformat = efm_di->di_tv.vval.v_string;
7407     }
7408 
7409     // Only a List value is supported
7410     if (di->di_tv.v_type != VAR_LIST || di->di_tv.vval.v_list == NULL)
7411 	return FAIL;
7412 
7413     if (action == 'r')
7414 	qf_free_items(&qi->qf_lists[qf_idx]);
7415     if (qf_init_ext(qi, qf_idx, NULL, NULL, &di->di_tv, errorformat,
7416 		FALSE, (linenr_T)0, (linenr_T)0, NULL, NULL) >= 0)
7417 	retval = OK;
7418 
7419     return retval;
7420 }
7421 
7422 /*
7423  * Set quickfix list context.
7424  */
7425     static int
7426 qf_setprop_context(qf_list_T *qfl, dictitem_T *di)
7427 {
7428     typval_T	*ctx;
7429 
7430     free_tv(qfl->qf_ctx);
7431     ctx =  alloc_tv();
7432     if (ctx != NULL)
7433 	copy_tv(&di->di_tv, ctx);
7434     qfl->qf_ctx = ctx;
7435 
7436     return OK;
7437 }
7438 
7439 /*
7440  * Set the current index in the specified quickfix list
7441  */
7442     static int
7443 qf_setprop_curidx(qf_info_T *qi, qf_list_T *qfl, dictitem_T *di)
7444 {
7445     int		denote = FALSE;
7446     int		newidx;
7447     int		old_qfidx;
7448     qfline_T	*qf_ptr;
7449 
7450     // If the specified index is '$', then use the last entry
7451     if (di->di_tv.v_type == VAR_STRING
7452 	    && di->di_tv.vval.v_string != NULL
7453 	    && STRCMP(di->di_tv.vval.v_string, "$") == 0)
7454 	newidx = qfl->qf_count;
7455     else
7456     {
7457 	// Otherwise use the specified index
7458 	newidx = tv_get_number_chk(&di->di_tv, &denote);
7459 	if (denote)
7460 	    return FAIL;
7461     }
7462 
7463     if (newidx < 1)		// sanity check
7464 	return FAIL;
7465     if (newidx > qfl->qf_count)
7466 	newidx = qfl->qf_count;
7467 
7468     old_qfidx = qfl->qf_index;
7469     qf_ptr = get_nth_entry(qfl, newidx, &newidx);
7470     if (qf_ptr == NULL)
7471 	return FAIL;
7472     qfl->qf_ptr = qf_ptr;
7473     qfl->qf_index = newidx;
7474 
7475     // If the current list is modified and it is displayed in the quickfix
7476     // window, then Update it.
7477     if (qf_get_curlist(qi)->qf_id == qfl->qf_id)
7478 	qf_win_pos_update(qi, old_qfidx);
7479 
7480     return OK;
7481 }
7482 
7483 /*
7484  * Set the current index in the specified quickfix list
7485  */
7486     static int
7487 qf_setprop_qftf(qf_info_T *qi UNUSED, qf_list_T *qfl, dictitem_T *di)
7488 {
7489     callback_T	cb;
7490 
7491     free_callback(&qfl->qftf_cb);
7492     cb = get_callback(&di->di_tv);
7493     if (cb.cb_name != NULL && *cb.cb_name != NUL)
7494 	set_callback(&qfl->qftf_cb, &cb);
7495 
7496     return OK;
7497 }
7498 
7499 /*
7500  * Set quickfix/location list properties (title, items, context).
7501  * Also used to add items from parsing a list of lines.
7502  * Used by the setqflist() and setloclist() Vim script functions.
7503  */
7504     static int
7505 qf_set_properties(qf_info_T *qi, dict_T *what, int action, char_u *title)
7506 {
7507     dictitem_T	*di;
7508     int		retval = FAIL;
7509     int		qf_idx;
7510     int		newlist = FALSE;
7511     qf_list_T	*qfl;
7512 
7513     if (action == ' ' || qf_stack_empty(qi))
7514 	newlist = TRUE;
7515 
7516     qf_idx = qf_setprop_get_qfidx(qi, what, action, &newlist);
7517     if (qf_idx == INVALID_QFIDX)	// List not found
7518 	return FAIL;
7519 
7520     if (newlist)
7521     {
7522 	qi->qf_curlist = qf_idx;
7523 	qf_new_list(qi, title);
7524 	qf_idx = qi->qf_curlist;
7525     }
7526 
7527     qfl = qf_get_list(qi, qf_idx);
7528     if ((di = dict_find(what, (char_u *)"title", -1)) != NULL)
7529 	retval = qf_setprop_title(qi, qf_idx, what, di);
7530     if ((di = dict_find(what, (char_u *)"items", -1)) != NULL)
7531 	retval = qf_setprop_items(qi, qf_idx, di, action);
7532     if ((di = dict_find(what, (char_u *)"lines", -1)) != NULL)
7533 	retval = qf_setprop_items_from_lines(qi, qf_idx, what, di, action);
7534     if ((di = dict_find(what, (char_u *)"context", -1)) != NULL)
7535 	retval = qf_setprop_context(qfl, di);
7536     if ((di = dict_find(what, (char_u *)"idx", -1)) != NULL)
7537 	retval = qf_setprop_curidx(qi, qfl, di);
7538     if ((di = dict_find(what, (char_u *)"quickfixtextfunc", -1)) != NULL)
7539 	retval = qf_setprop_qftf(qi, qfl, di);
7540 
7541     if (newlist || retval == OK)
7542 	qf_list_changed(qfl);
7543     if (newlist)
7544 	qf_update_buffer(qi, NULL);
7545 
7546     return retval;
7547 }
7548 
7549 /*
7550  * Free the entire quickfix/location list stack.
7551  * If the quickfix/location list window is open, then clear it.
7552  */
7553     static void
7554 qf_free_stack(win_T *wp, qf_info_T *qi)
7555 {
7556     win_T	*qfwin = qf_find_win(qi);
7557     win_T	*llwin = NULL;
7558 
7559     if (qfwin != NULL)
7560     {
7561 	// If the quickfix/location list window is open, then clear it
7562 	if (qi->qf_curlist < qi->qf_listcount)
7563 	    qf_free(qf_get_curlist(qi));
7564 	qf_update_buffer(qi, NULL);
7565     }
7566 
7567     if (wp != NULL && IS_LL_WINDOW(wp))
7568     {
7569 	// If in the location list window, then use the non-location list
7570 	// window with this location list (if present)
7571 	llwin = qf_find_win_with_loclist(qi);
7572 	if (llwin != NULL)
7573 	    wp = llwin;
7574     }
7575 
7576     qf_free_all(wp);
7577     if (wp == NULL)
7578     {
7579 	// quickfix list
7580 	qi->qf_curlist = 0;
7581 	qi->qf_listcount = 0;
7582     }
7583     else if (qfwin != NULL)
7584     {
7585 	// If the location list window is open, then create a new empty
7586 	// location list
7587 	qf_info_T *new_ll = qf_alloc_stack(QFLT_LOCATION);
7588 
7589 	if (new_ll != NULL)
7590 	{
7591 	    new_ll->qf_bufnr = qfwin->w_buffer->b_fnum;
7592 
7593 	    // first free the list reference in the location list window
7594 	    ll_free_all(&qfwin->w_llist_ref);
7595 
7596 	    qfwin->w_llist_ref = new_ll;
7597 	    if (wp != qfwin)
7598 		win_set_loclist(wp, new_ll);
7599 	}
7600     }
7601 }
7602 
7603 /*
7604  * Populate the quickfix list with the items supplied in the list
7605  * of dictionaries. "title" will be copied to w:quickfix_title.
7606  * "action" is 'a' for add, 'r' for replace.  Otherwise create a new list.
7607  * When "what" is not NULL then only set some properties.
7608  */
7609     int
7610 set_errorlist(
7611 	win_T	*wp,
7612 	list_T	*list,
7613 	int	action,
7614 	char_u	*title,
7615 	dict_T	*what)
7616 {
7617     qf_info_T	*qi = &ql_info;
7618     int		retval = OK;
7619 
7620     if (wp != NULL)
7621     {
7622 	qi = ll_get_or_alloc_list(wp);
7623 	if (qi == NULL)
7624 	    return FAIL;
7625     }
7626 
7627     if (action == 'f')
7628     {
7629 	// Free the entire quickfix or location list stack
7630 	qf_free_stack(wp, qi);
7631 	return OK;
7632     }
7633 
7634     // A dict argument cannot be specified with a non-empty list argument
7635     if (list->lv_len != 0 && what != NULL)
7636     {
7637 	semsg(_(e_invarg2),
7638 			 _("cannot have both a list and a \"what\" argument"));
7639 	return FAIL;
7640     }
7641 
7642     incr_quickfix_busy();
7643 
7644     if (what != NULL)
7645 	retval = qf_set_properties(qi, what, action, title);
7646     else
7647     {
7648 	retval = qf_add_entries(qi, qi->qf_curlist, list, title, action);
7649 	if (retval == OK)
7650 	    qf_list_changed(qf_get_curlist(qi));
7651     }
7652 
7653     decr_quickfix_busy();
7654 
7655     return retval;
7656 }
7657 
7658 /*
7659  * Mark the context as in use for all the lists in a quickfix stack.
7660  */
7661     static int
7662 mark_quickfix_ctx(qf_info_T *qi, int copyID)
7663 {
7664     int		i;
7665     int		abort = FALSE;
7666     typval_T	*ctx;
7667 
7668     for (i = 0; i < LISTCOUNT && !abort; ++i)
7669     {
7670 	ctx = qi->qf_lists[i].qf_ctx;
7671 	if (ctx != NULL && ctx->v_type != VAR_NUMBER
7672 		&& ctx->v_type != VAR_STRING && ctx->v_type != VAR_FLOAT)
7673 	    abort = set_ref_in_item(ctx, copyID, NULL, NULL);
7674     }
7675 
7676     return abort;
7677 }
7678 
7679 /*
7680  * Mark the context of the quickfix list and the location lists (if present) as
7681  * "in use". So that garbage collection doesn't free the context.
7682  */
7683     int
7684 set_ref_in_quickfix(int copyID)
7685 {
7686     int		abort = FALSE;
7687     tabpage_T	*tp;
7688     win_T	*win;
7689 
7690     abort = mark_quickfix_ctx(&ql_info, copyID);
7691     if (abort)
7692 	return abort;
7693 
7694     FOR_ALL_TAB_WINDOWS(tp, win)
7695     {
7696 	if (win->w_llist != NULL)
7697 	{
7698 	    abort = mark_quickfix_ctx(win->w_llist, copyID);
7699 	    if (abort)
7700 		return abort;
7701 	}
7702 	if (IS_LL_WINDOW(win) && (win->w_llist_ref->qf_refcount == 1))
7703 	{
7704 	    // In a location list window and none of the other windows is
7705 	    // referring to this location list. Mark the location list
7706 	    // context as still in use.
7707 	    abort = mark_quickfix_ctx(win->w_llist_ref, copyID);
7708 	    if (abort)
7709 		return abort;
7710 	}
7711     }
7712 
7713     return abort;
7714 }
7715 #endif
7716 
7717 /*
7718  * Return the autocmd name for the :cbuffer Ex commands
7719  */
7720     static char_u *
7721 cbuffer_get_auname(cmdidx_T cmdidx)
7722 {
7723     switch (cmdidx)
7724     {
7725 	case CMD_cbuffer:	return (char_u *)"cbuffer";
7726 	case CMD_cgetbuffer:	return (char_u *)"cgetbuffer";
7727 	case CMD_caddbuffer:	return (char_u *)"caddbuffer";
7728 	case CMD_lbuffer:	return (char_u *)"lbuffer";
7729 	case CMD_lgetbuffer:	return (char_u *)"lgetbuffer";
7730 	case CMD_laddbuffer:	return (char_u *)"laddbuffer";
7731 	default:		return NULL;
7732     }
7733 }
7734 
7735 /*
7736  * Process and validate the arguments passed to the :cbuffer, :caddbuffer,
7737  * :cgetbuffer, :lbuffer, :laddbuffer, :lgetbuffer Ex commands.
7738  */
7739     static int
7740 cbuffer_process_args(
7741 	exarg_T		*eap,
7742 	buf_T		**bufp,
7743 	linenr_T	*line1,
7744 	linenr_T	*line2)
7745 {
7746     buf_T	*buf = NULL;
7747 
7748     if (*eap->arg == NUL)
7749 	buf = curbuf;
7750     else if (*skipwhite(skipdigits(eap->arg)) == NUL)
7751 	buf = buflist_findnr(atoi((char *)eap->arg));
7752 
7753     if (buf == NULL)
7754     {
7755 	emsg(_(e_invarg));
7756 	return FAIL;
7757     }
7758 
7759     if (buf->b_ml.ml_mfp == NULL)
7760     {
7761 	emsg(_("E681: Buffer is not loaded"));
7762 	return FAIL;
7763     }
7764 
7765     if (eap->addr_count == 0)
7766     {
7767 	eap->line1 = 1;
7768 	eap->line2 = buf->b_ml.ml_line_count;
7769     }
7770 
7771     if (eap->line1 < 1 || eap->line1 > buf->b_ml.ml_line_count
7772 	    || eap->line2 < 1 || eap->line2 > buf->b_ml.ml_line_count)
7773     {
7774 	emsg(_(e_invrange));
7775 	return FAIL;
7776     }
7777 
7778     *line1 = eap->line1;
7779     *line2 = eap->line2;
7780     *bufp = buf;
7781 
7782     return OK;
7783 }
7784 
7785 /*
7786  * ":[range]cbuffer [bufnr]" command.
7787  * ":[range]caddbuffer [bufnr]" command.
7788  * ":[range]cgetbuffer [bufnr]" command.
7789  * ":[range]lbuffer [bufnr]" command.
7790  * ":[range]laddbuffer [bufnr]" command.
7791  * ":[range]lgetbuffer [bufnr]" command.
7792  */
7793     void
7794 ex_cbuffer(exarg_T *eap)
7795 {
7796     buf_T	*buf = NULL;
7797     qf_info_T	*qi;
7798     char_u	*au_name = NULL;
7799     int		res;
7800     int_u	save_qfid;
7801     win_T	*wp = NULL;
7802     char_u	*qf_title;
7803     linenr_T	line1;
7804     linenr_T	line2;
7805 
7806     au_name = cbuffer_get_auname(eap->cmdidx);
7807     if (au_name != NULL && apply_autocmds(EVENT_QUICKFIXCMDPRE, au_name,
7808 					curbuf->b_fname, TRUE, curbuf))
7809     {
7810 #ifdef FEAT_EVAL
7811 	if (aborting())
7812 	    return;
7813 #endif
7814     }
7815 
7816     // Must come after autocommands.
7817     qi = qf_cmd_get_or_alloc_stack(eap, &wp);
7818     if (qi == NULL)
7819 	return;
7820 
7821     if (cbuffer_process_args(eap, &buf, &line1, &line2) == FAIL)
7822 	return;
7823 
7824     qf_title = qf_cmdtitle(*eap->cmdlinep);
7825 
7826     if (buf->b_sfname)
7827     {
7828 	vim_snprintf((char *)IObuff, IOSIZE, "%s (%s)",
7829 		(char *)qf_title, (char *)buf->b_sfname);
7830 	qf_title = IObuff;
7831     }
7832 
7833     incr_quickfix_busy();
7834 
7835     res = qf_init_ext(qi, qi->qf_curlist, NULL, buf, NULL, p_efm,
7836 	    (eap->cmdidx != CMD_caddbuffer
7837 	     && eap->cmdidx != CMD_laddbuffer),
7838 	    line1, line2,
7839 	    qf_title, NULL);
7840     if (qf_stack_empty(qi))
7841     {
7842 	decr_quickfix_busy();
7843 	return;
7844     }
7845     if (res >= 0)
7846 	qf_list_changed(qf_get_curlist(qi));
7847 
7848     // Remember the current quickfix list identifier, so that we can
7849     // check for autocommands changing the current quickfix list.
7850     save_qfid = qf_get_curlist(qi)->qf_id;
7851     if (au_name != NULL)
7852     {
7853 	buf_T *curbuf_old = curbuf;
7854 
7855 	apply_autocmds(EVENT_QUICKFIXCMDPOST, au_name, curbuf->b_fname,
7856 								TRUE, curbuf);
7857 	if (curbuf != curbuf_old)
7858 	    // Autocommands changed buffer, don't jump now, "qi" may
7859 	    // be invalid.
7860 	    res = 0;
7861     }
7862     // Jump to the first error for a new list and if autocmds didn't
7863     // free the list.
7864     if (res > 0 && (eap->cmdidx == CMD_cbuffer ||
7865 		eap->cmdidx == CMD_lbuffer)
7866 	    && qflist_valid(wp, save_qfid))
7867 	// display the first error
7868 	qf_jump_first(qi, save_qfid, eap->forceit);
7869 
7870     decr_quickfix_busy();
7871 }
7872 
7873 #if defined(FEAT_EVAL) || defined(PROTO)
7874 /*
7875  * Return the autocmd name for the :cexpr Ex commands.
7876  */
7877     char_u *
7878 cexpr_get_auname(cmdidx_T cmdidx)
7879 {
7880     switch (cmdidx)
7881     {
7882 	case CMD_cexpr:	    return (char_u *)"cexpr";
7883 	case CMD_cgetexpr:  return (char_u *)"cgetexpr";
7884 	case CMD_caddexpr:  return (char_u *)"caddexpr";
7885 	case CMD_lexpr:	    return (char_u *)"lexpr";
7886 	case CMD_lgetexpr:  return (char_u *)"lgetexpr";
7887 	case CMD_laddexpr:  return (char_u *)"laddexpr";
7888 	default:	    return NULL;
7889     }
7890 }
7891 
7892     int
7893 trigger_cexpr_autocmd(int cmdidx)
7894 {
7895     char_u	*au_name = cexpr_get_auname(cmdidx);
7896 
7897     if (au_name != NULL && apply_autocmds(EVENT_QUICKFIXCMDPRE, au_name,
7898 					       curbuf->b_fname, TRUE, curbuf))
7899     {
7900 	if (aborting())
7901 	    return FAIL;
7902     }
7903     return OK;
7904 }
7905 
7906     int
7907 cexpr_core(exarg_T *eap, typval_T *tv)
7908 {
7909     qf_info_T	*qi;
7910     win_T	*wp = NULL;
7911 
7912     qi = qf_cmd_get_or_alloc_stack(eap, &wp);
7913     if (qi == NULL)
7914 	return FAIL;
7915 
7916     if ((tv->v_type == VAR_STRING && tv->vval.v_string != NULL)
7917 	    || (tv->v_type == VAR_LIST && tv->vval.v_list != NULL))
7918     {
7919 	int	res;
7920 	int_u	save_qfid;
7921 	char_u	*au_name = cexpr_get_auname(eap->cmdidx);
7922 
7923 	incr_quickfix_busy();
7924 	res = qf_init_ext(qi, qi->qf_curlist, NULL, NULL, tv, p_efm,
7925 			(eap->cmdidx != CMD_caddexpr
7926 			 && eap->cmdidx != CMD_laddexpr),
7927 			     (linenr_T)0, (linenr_T)0,
7928 			     qf_cmdtitle(*eap->cmdlinep), NULL);
7929 	if (qf_stack_empty(qi))
7930 	{
7931 	    decr_quickfix_busy();
7932 	    return FAIL;
7933 	}
7934 	if (res >= 0)
7935 	    qf_list_changed(qf_get_curlist(qi));
7936 
7937 	// Remember the current quickfix list identifier, so that we can
7938 	// check for autocommands changing the current quickfix list.
7939 	save_qfid = qf_get_curlist(qi)->qf_id;
7940 	if (au_name != NULL)
7941 	    apply_autocmds(EVENT_QUICKFIXCMDPOST, au_name,
7942 					    curbuf->b_fname, TRUE, curbuf);
7943 
7944 	// Jump to the first error for a new list and if autocmds didn't
7945 	// free the list.
7946 	if (res > 0 && (eap->cmdidx == CMD_cexpr || eap->cmdidx == CMD_lexpr)
7947 		&& qflist_valid(wp, save_qfid))
7948 	    // display the first error
7949 	    qf_jump_first(qi, save_qfid, eap->forceit);
7950 	decr_quickfix_busy();
7951 	return OK;
7952     }
7953 
7954     emsg(_("E777: String or List expected"));
7955     return FAIL;
7956 }
7957 
7958 /*
7959  * ":cexpr {expr}", ":cgetexpr {expr}", ":caddexpr {expr}" command.
7960  * ":lexpr {expr}", ":lgetexpr {expr}", ":laddexpr {expr}" command.
7961  * Also: ":caddexpr", ":cgetexpr", "laddexpr" and "laddexpr".
7962  */
7963     void
7964 ex_cexpr(exarg_T *eap)
7965 {
7966     typval_T	*tv;
7967 
7968     if (trigger_cexpr_autocmd(eap->cmdidx) == FAIL)
7969 	return;
7970 
7971     // Evaluate the expression.  When the result is a string or a list we can
7972     // use it to fill the errorlist.
7973     tv = eval_expr(eap->arg, eap);
7974     if (tv != NULL)
7975     {
7976 	(void)cexpr_core(eap, tv);
7977 	free_tv(tv);
7978     }
7979 }
7980 #endif
7981 
7982 /*
7983  * Get the location list for ":lhelpgrep"
7984  */
7985     static qf_info_T *
7986 hgr_get_ll(int *new_ll)
7987 {
7988     win_T	*wp;
7989     qf_info_T	*qi;
7990 
7991     // If the current window is a help window, then use it
7992     if (bt_help(curwin->w_buffer))
7993 	wp = curwin;
7994     else
7995 	// Find an existing help window
7996 	wp = qf_find_help_win();
7997 
7998     if (wp == NULL)	    // Help window not found
7999 	qi = NULL;
8000     else
8001 	qi = wp->w_llist;
8002 
8003     if (qi == NULL)
8004     {
8005 	// Allocate a new location list for help text matches
8006 	if ((qi = qf_alloc_stack(QFLT_LOCATION)) == NULL)
8007 	    return NULL;
8008 	*new_ll = TRUE;
8009     }
8010 
8011     return qi;
8012 }
8013 
8014 /*
8015  * Search for a pattern in a help file.
8016  */
8017     static void
8018 hgr_search_file(
8019 	qf_list_T *qfl,
8020 	char_u *fname,
8021 	vimconv_T *p_vc,
8022 	regmatch_T *p_regmatch)
8023 {
8024     FILE	*fd;
8025     long	lnum;
8026 
8027     fd = mch_fopen((char *)fname, "r");
8028     if (fd == NULL)
8029 	return;
8030 
8031     lnum = 1;
8032     while (!vim_fgets(IObuff, IOSIZE, fd) && !got_int)
8033     {
8034 	char_u    *line = IObuff;
8035 
8036 	// Convert a line if 'encoding' is not utf-8 and
8037 	// the line contains a non-ASCII character.
8038 	if (p_vc->vc_type != CONV_NONE
8039 		&& has_non_ascii(IObuff))
8040 	{
8041 	    line = string_convert(p_vc, IObuff, NULL);
8042 	    if (line == NULL)
8043 		line = IObuff;
8044 	}
8045 
8046 	if (vim_regexec(p_regmatch, line, (colnr_T)0))
8047 	{
8048 	    int	l = (int)STRLEN(line);
8049 
8050 	    // remove trailing CR, LF, spaces, etc.
8051 	    while (l > 0 && line[l - 1] <= ' ')
8052 		line[--l] = NUL;
8053 
8054 	    if (qf_add_entry(qfl,
8055 			NULL,	// dir
8056 			fname,
8057 			NULL,
8058 			0,
8059 			line,
8060 			lnum,
8061 			(int)(p_regmatch->startp[0] - line)
8062 			+ 1,	// col
8063 			FALSE,	// vis_col
8064 			NULL,	// search pattern
8065 			0,	// nr
8066 			1,	// type
8067 			TRUE	// valid
8068 			) == QF_FAIL)
8069 	    {
8070 		got_int = TRUE;
8071 		if (line != IObuff)
8072 		    vim_free(line);
8073 		break;
8074 	    }
8075 	}
8076 	if (line != IObuff)
8077 	    vim_free(line);
8078 	++lnum;
8079 	line_breakcheck();
8080     }
8081     fclose(fd);
8082 }
8083 
8084 /*
8085  * Search for a pattern in all the help files in the doc directory under
8086  * the given directory.
8087  */
8088     static void
8089 hgr_search_files_in_dir(
8090 	qf_list_T *qfl,
8091 	char_u *dirname,
8092 	regmatch_T *p_regmatch,
8093 	vimconv_T *p_vc
8094 #ifdef FEAT_MULTI_LANG
8095 	, char_u *lang
8096 #endif
8097 	)
8098 {
8099     int		fcount;
8100     char_u	**fnames;
8101     int		fi;
8102 
8103     // Find all "*.txt" and "*.??x" files in the "doc" directory.
8104     add_pathsep(dirname);
8105     STRCAT(dirname, "doc/*.\\(txt\\|??x\\)");
8106     if (gen_expand_wildcards(1, &dirname, &fcount,
8107 		&fnames, EW_FILE|EW_SILENT) == OK
8108 	    && fcount > 0)
8109     {
8110 	for (fi = 0; fi < fcount && !got_int; ++fi)
8111 	{
8112 #ifdef FEAT_MULTI_LANG
8113 	    // Skip files for a different language.
8114 	    if (lang != NULL
8115 		    && STRNICMP(lang, fnames[fi]
8116 				    + STRLEN(fnames[fi]) - 3, 2) != 0
8117 		    && !(STRNICMP(lang, "en", 2) == 0
8118 			&& STRNICMP("txt", fnames[fi]
8119 			    + STRLEN(fnames[fi]) - 3, 3) == 0))
8120 		continue;
8121 #endif
8122 
8123 	    hgr_search_file(qfl, fnames[fi], p_vc, p_regmatch);
8124 	}
8125 	FreeWild(fcount, fnames);
8126     }
8127 }
8128 
8129 /*
8130  * Search for a pattern in all the help files in the 'runtimepath'
8131  * and add the matches to a quickfix list.
8132  * 'lang' is the language specifier.  If supplied, then only matches in the
8133  * specified language are found.
8134  */
8135     static void
8136 hgr_search_in_rtp(qf_list_T *qfl, regmatch_T *p_regmatch, char_u *lang)
8137 {
8138     char_u	*p;
8139 
8140     vimconv_T	vc;
8141 
8142     // Help files are in utf-8 or latin1, convert lines when 'encoding'
8143     // differs.
8144     vc.vc_type = CONV_NONE;
8145     if (!enc_utf8)
8146 	convert_setup(&vc, (char_u *)"utf-8", p_enc);
8147 
8148     // Go through all the directories in 'runtimepath'
8149     p = p_rtp;
8150     while (*p != NUL && !got_int)
8151     {
8152 	copy_option_part(&p, NameBuff, MAXPATHL, ",");
8153 
8154 	hgr_search_files_in_dir(qfl, NameBuff, p_regmatch, &vc
8155 #ifdef FEAT_MULTI_LANG
8156 		, lang
8157 #endif
8158 		);
8159     }
8160 
8161     if (vc.vc_type != CONV_NONE)
8162 	convert_setup(&vc, NULL, NULL);
8163 }
8164 
8165 /*
8166  * ":helpgrep {pattern}"
8167  */
8168     void
8169 ex_helpgrep(exarg_T *eap)
8170 {
8171     regmatch_T	regmatch;
8172     char_u	*save_cpo;
8173     qf_info_T	*qi = &ql_info;
8174     int		new_qi = FALSE;
8175     char_u	*au_name =  NULL;
8176     char_u	*lang = NULL;
8177     int		updated = FALSE;
8178 
8179     switch (eap->cmdidx)
8180     {
8181 	case CMD_helpgrep:  au_name = (char_u *)"helpgrep"; break;
8182 	case CMD_lhelpgrep: au_name = (char_u *)"lhelpgrep"; break;
8183 	default: break;
8184     }
8185     if (au_name != NULL && apply_autocmds(EVENT_QUICKFIXCMDPRE, au_name,
8186 					       curbuf->b_fname, TRUE, curbuf))
8187     {
8188 #ifdef FEAT_EVAL
8189 	if (aborting())
8190 	    return;
8191 #endif
8192     }
8193 
8194     if (is_loclist_cmd(eap->cmdidx))
8195     {
8196 	qi = hgr_get_ll(&new_qi);
8197 	if (qi == NULL)
8198 	    return;
8199     }
8200 
8201     // Make 'cpoptions' empty, the 'l' flag should not be used here.
8202     save_cpo = p_cpo;
8203     p_cpo = empty_option;
8204 
8205     incr_quickfix_busy();
8206 
8207 #ifdef FEAT_MULTI_LANG
8208     // Check for a specified language
8209     lang = check_help_lang(eap->arg);
8210 #endif
8211     regmatch.regprog = vim_regcomp(eap->arg, RE_MAGIC + RE_STRING);
8212     regmatch.rm_ic = FALSE;
8213     if (regmatch.regprog != NULL)
8214     {
8215 	qf_list_T	*qfl;
8216 
8217 	// create a new quickfix list
8218 	qf_new_list(qi, qf_cmdtitle(*eap->cmdlinep));
8219 	qfl = qf_get_curlist(qi);
8220 
8221 	hgr_search_in_rtp(qfl, &regmatch, lang);
8222 
8223 	vim_regfree(regmatch.regprog);
8224 
8225 	qfl->qf_nonevalid = FALSE;
8226 	qfl->qf_ptr = qfl->qf_start;
8227 	qfl->qf_index = 1;
8228 	qf_list_changed(qfl);
8229 	updated = TRUE;
8230     }
8231 
8232     if (p_cpo == empty_option)
8233 	p_cpo = save_cpo;
8234     else
8235     {
8236 	// Darn, some plugin changed the value.  If it's still empty it was
8237 	// changed and restored, need to restore in the complicated way.
8238 	if (*p_cpo == NUL)
8239 	    set_option_value((char_u *)"cpo", 0L, save_cpo, 0);
8240 	free_string_option(save_cpo);
8241     }
8242 
8243     if (updated)
8244 	// This may open a window and source scripts, do this after 'cpo' was
8245 	// restored.
8246 	qf_update_buffer(qi, NULL);
8247 
8248     if (au_name != NULL)
8249     {
8250 	apply_autocmds(EVENT_QUICKFIXCMDPOST, au_name,
8251 					       curbuf->b_fname, TRUE, curbuf);
8252 	// When adding a location list to an existing location list stack,
8253 	// if the autocmd made the stack invalid, then just return.
8254 	if (!new_qi && IS_LL_STACK(qi) && qf_find_win_with_loclist(qi) == NULL)
8255 	{
8256 	    decr_quickfix_busy();
8257 	    return;
8258 	}
8259     }
8260 
8261     // Jump to first match.
8262     if (!qf_list_empty(qf_get_curlist(qi)))
8263 	qf_jump(qi, 0, 0, FALSE);
8264     else
8265 	semsg(_(e_nomatch2), eap->arg);
8266 
8267     decr_quickfix_busy();
8268 
8269     if (eap->cmdidx == CMD_lhelpgrep)
8270     {
8271 	// If the help window is not opened or if it already points to the
8272 	// correct location list, then free the new location list.
8273 	if (!bt_help(curwin->w_buffer) || curwin->w_llist == qi)
8274 	{
8275 	    if (new_qi)
8276 		ll_free_all(&qi);
8277 	}
8278 	else if (curwin->w_llist == NULL)
8279 	    curwin->w_llist = qi;
8280     }
8281 }
8282 #endif // FEAT_QUICKFIX
8283 
8284 #if defined(FEAT_EVAL) || defined(PROTO)
8285 # ifdef FEAT_QUICKFIX
8286     static void
8287 get_qf_loc_list(int is_qf, win_T *wp, typval_T *what_arg, typval_T *rettv)
8288 {
8289     if (what_arg->v_type == VAR_UNKNOWN)
8290     {
8291 	if (rettv_list_alloc(rettv) == OK)
8292 	    if (is_qf || wp != NULL)
8293 		(void)get_errorlist(NULL, wp, -1, 0, rettv->vval.v_list);
8294     }
8295     else
8296     {
8297 	if (rettv_dict_alloc(rettv) == OK)
8298 	    if (is_qf || (wp != NULL))
8299 	    {
8300 		if (what_arg->v_type == VAR_DICT)
8301 		{
8302 		    dict_T	*d = what_arg->vval.v_dict;
8303 
8304 		    if (d != NULL)
8305 			qf_get_properties(wp, d, rettv->vval.v_dict);
8306 		}
8307 		else
8308 		    emsg(_(e_dictreq));
8309 	    }
8310     }
8311 }
8312 # endif
8313 
8314 /*
8315  * "getloclist()" function
8316  */
8317     void
8318 f_getloclist(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
8319 {
8320 # ifdef FEAT_QUICKFIX
8321     win_T	*wp;
8322 
8323     wp = find_win_by_nr_or_id(&argvars[0]);
8324     get_qf_loc_list(FALSE, wp, &argvars[1], rettv);
8325 # endif
8326 }
8327 
8328 /*
8329  * "getqflist()" function
8330  */
8331     void
8332 f_getqflist(typval_T *argvars UNUSED, typval_T *rettv UNUSED)
8333 {
8334 # ifdef FEAT_QUICKFIX
8335     get_qf_loc_list(TRUE, NULL, &argvars[0], rettv);
8336 # endif
8337 }
8338 
8339 /*
8340  * Used by "setqflist()" and "setloclist()" functions
8341  */
8342     static void
8343 set_qf_ll_list(
8344     win_T	*wp UNUSED,
8345     typval_T	*list_arg UNUSED,
8346     typval_T	*action_arg UNUSED,
8347     typval_T	*what_arg UNUSED,
8348     typval_T	*rettv)
8349 {
8350 # ifdef FEAT_QUICKFIX
8351     static char *e_invact = N_("E927: Invalid action: '%s'");
8352     char_u	*act;
8353     int		action = 0;
8354     static int	recursive = 0;
8355 # endif
8356 
8357     rettv->vval.v_number = -1;
8358 
8359 # ifdef FEAT_QUICKFIX
8360     if (list_arg->v_type != VAR_LIST)
8361 	emsg(_(e_listreq));
8362     else if (recursive != 0)
8363 	emsg(_(e_au_recursive));
8364     else
8365     {
8366 	list_T  *l = list_arg->vval.v_list;
8367 	dict_T	*what = NULL;
8368 	int	valid_dict = TRUE;
8369 
8370 	if (action_arg->v_type == VAR_STRING)
8371 	{
8372 	    act = tv_get_string_chk(action_arg);
8373 	    if (act == NULL)
8374 		return;		// type error; errmsg already given
8375 	    if ((*act == 'a' || *act == 'r' || *act == ' ' || *act == 'f') &&
8376 		    act[1] == NUL)
8377 		action = *act;
8378 	    else
8379 		semsg(_(e_invact), act);
8380 	}
8381 	else if (action_arg->v_type == VAR_UNKNOWN)
8382 	    action = ' ';
8383 	else
8384 	    emsg(_(e_stringreq));
8385 
8386 	if (action_arg->v_type != VAR_UNKNOWN
8387 		&& what_arg->v_type != VAR_UNKNOWN)
8388 	{
8389 	    if (what_arg->v_type == VAR_DICT && what_arg->vval.v_dict != NULL)
8390 		what = what_arg->vval.v_dict;
8391 	    else
8392 	    {
8393 		emsg(_(e_dictreq));
8394 		valid_dict = FALSE;
8395 	    }
8396 	}
8397 
8398 	++recursive;
8399 	if (l != NULL && action && valid_dict
8400 		    && set_errorlist(wp, l, action,
8401 		     (char_u *)(wp == NULL ? ":setqflist()" : ":setloclist()"),
8402 		     what) == OK)
8403 	    rettv->vval.v_number = 0;
8404 	--recursive;
8405     }
8406 # endif
8407 }
8408 
8409 /*
8410  * "setloclist()" function
8411  */
8412     void
8413 f_setloclist(typval_T *argvars, typval_T *rettv)
8414 {
8415     win_T	*win;
8416 
8417     rettv->vval.v_number = -1;
8418 
8419     win = find_win_by_nr_or_id(&argvars[0]);
8420     if (win != NULL)
8421 	set_qf_ll_list(win, &argvars[1], &argvars[2], &argvars[3], rettv);
8422 }
8423 
8424 /*
8425  * "setqflist()" function
8426  */
8427     void
8428 f_setqflist(typval_T *argvars, typval_T *rettv)
8429 {
8430     set_qf_ll_list(NULL, &argvars[0], &argvars[1], &argvars[2], rettv);
8431 }
8432 #endif
8433