xref: /vim-8.2.3635/src/buffer.c (revision 56994d21)
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  * buffer.c: functions for dealing with the buffer structure
12  */
13 
14 /*
15  * The buffer list is a double linked list of all buffers.
16  * Each buffer can be in one of these states:
17  * never loaded: BF_NEVERLOADED is set, only the file name is valid
18  *   not loaded: b_ml.ml_mfp == NULL, no memfile allocated
19  *	 hidden: b_nwindows == 0, loaded but not displayed in a window
20  *	 normal: loaded and displayed in a window
21  *
22  * Instead of storing file names all over the place, each file name is
23  * stored in the buffer list. It can be referenced by a number.
24  *
25  * The current implementation remembers all file names ever used.
26  */
27 
28 #include "vim.h"
29 
30 static void	enter_buffer(buf_T *buf);
31 static void	buflist_getfpos(void);
32 static char_u	*buflist_match(regmatch_T *rmp, buf_T *buf, int ignore_case);
33 static char_u	*fname_match(regmatch_T *rmp, char_u *name, int ignore_case);
34 #ifdef UNIX
35 static buf_T	*buflist_findname_stat(char_u *ffname, stat_T *st);
36 static int	otherfile_buf(buf_T *buf, char_u *ffname, stat_T *stp);
37 static int	buf_same_ino(buf_T *buf, stat_T *stp);
38 #else
39 static int	otherfile_buf(buf_T *buf, char_u *ffname);
40 #endif
41 #ifdef FEAT_TITLE
42 static int	value_changed(char_u *str, char_u **last);
43 #endif
44 static int	append_arg_number(win_T *wp, char_u *buf, int buflen, int add_file);
45 static void	free_buffer(buf_T *);
46 static void	free_buffer_stuff(buf_T *buf, int free_options);
47 static void	clear_wininfo(buf_T *buf);
48 
49 #ifdef UNIX
50 # define dev_T dev_t
51 #else
52 # define dev_T unsigned
53 #endif
54 
55 #define FOR_ALL_BUFS_FROM_LAST(buf) \
56     for ((buf) = lastbuf; (buf) != NULL; (buf) = (buf)->b_prev)
57 
58 #if defined(FEAT_QUICKFIX)
59 static char *msg_loclist = N_("[Location List]");
60 static char *msg_qflist = N_("[Quickfix List]");
61 #endif
62 static char *e_auabort = N_("E855: Autocommands caused command to abort");
63 
64 // Number of times free_buffer() was called.
65 static int	buf_free_count = 0;
66 
67 static int	top_file_num = 1;	// highest file number
68 static garray_T buf_reuse = GA_EMPTY;	// file numbers to recycle
69 
70 /*
71  * Return the highest possible buffer number.
72  */
73     int
74 get_highest_fnum(void)
75 {
76     return top_file_num - 1;
77 }
78 
79 /*
80  * Read data from buffer for retrying.
81  */
82     static int
83 read_buffer(
84     int		read_stdin,	    // read file from stdin, otherwise fifo
85     exarg_T	*eap,		    // for forced 'ff' and 'fenc' or NULL
86     int		flags)		    // extra flags for readfile()
87 {
88     int		retval = OK;
89     linenr_T	line_count;
90 
91     /*
92      * Read from the buffer which the text is already filled in and append at
93      * the end.  This makes it possible to retry when 'fileformat' or
94      * 'fileencoding' was guessed wrong.
95      */
96     line_count = curbuf->b_ml.ml_line_count;
97     retval = readfile(
98 	    read_stdin ? NULL : curbuf->b_ffname,
99 	    read_stdin ? NULL : curbuf->b_fname,
100 	    (linenr_T)line_count, (linenr_T)0, (linenr_T)MAXLNUM, eap,
101 	    flags | READ_BUFFER);
102     if (retval == OK)
103     {
104 	// Delete the binary lines.
105 	while (--line_count >= 0)
106 	    ml_delete((linenr_T)1);
107     }
108     else
109     {
110 	// Delete the converted lines.
111 	while (curbuf->b_ml.ml_line_count > line_count)
112 	    ml_delete(line_count);
113     }
114     // Put the cursor on the first line.
115     curwin->w_cursor.lnum = 1;
116     curwin->w_cursor.col = 0;
117 
118     if (read_stdin)
119     {
120 	// Set or reset 'modified' before executing autocommands, so that
121 	// it can be changed there.
122 	if (!readonlymode && !BUFEMPTY())
123 	    changed();
124 	else if (retval == OK)
125 	    unchanged(curbuf, FALSE, TRUE);
126 
127 	if (retval == OK)
128 	{
129 #ifdef FEAT_EVAL
130 	    apply_autocmds_retval(EVENT_STDINREADPOST, NULL, NULL, FALSE,
131 							      curbuf, &retval);
132 #else
133 	    apply_autocmds(EVENT_STDINREADPOST, NULL, NULL, FALSE, curbuf);
134 #endif
135 	}
136     }
137     return retval;
138 }
139 
140 /*
141  * Ensure buffer "buf" is loaded.  Does not trigger the swap-exists action.
142  */
143     void
144 buffer_ensure_loaded(buf_T *buf)
145 {
146     if (buf->b_ml.ml_mfp == NULL)
147     {
148 	aco_save_T	aco;
149 
150 	aucmd_prepbuf(&aco, buf);
151 	swap_exists_action = SEA_NONE;
152 	open_buffer(FALSE, NULL, 0);
153 	aucmd_restbuf(&aco);
154     }
155 }
156 
157 /*
158  * Open current buffer, that is: open the memfile and read the file into
159  * memory.
160  * Return FAIL for failure, OK otherwise.
161  */
162     int
163 open_buffer(
164     int		read_stdin,	    // read file from stdin
165     exarg_T	*eap,		    // for forced 'ff' and 'fenc' or NULL
166     int		flags)		    // extra flags for readfile()
167 {
168     int		retval = OK;
169     bufref_T	old_curbuf;
170 #ifdef FEAT_SYN_HL
171     long	old_tw = curbuf->b_p_tw;
172 #endif
173     int		read_fifo = FALSE;
174 
175     /*
176      * The 'readonly' flag is only set when BF_NEVERLOADED is being reset.
177      * When re-entering the same buffer, it should not change, because the
178      * user may have reset the flag by hand.
179      */
180     if (readonlymode && curbuf->b_ffname != NULL
181 					&& (curbuf->b_flags & BF_NEVERLOADED))
182 	curbuf->b_p_ro = TRUE;
183 
184     if (ml_open(curbuf) == FAIL)
185     {
186 	/*
187 	 * There MUST be a memfile, otherwise we can't do anything
188 	 * If we can't create one for the current buffer, take another buffer
189 	 */
190 	close_buffer(NULL, curbuf, 0, FALSE, FALSE);
191 	FOR_ALL_BUFFERS(curbuf)
192 	    if (curbuf->b_ml.ml_mfp != NULL)
193 		break;
194 	/*
195 	 * If there is no memfile at all, exit.
196 	 * This is OK, since there are no changes to lose.
197 	 */
198 	if (curbuf == NULL)
199 	{
200 	    emsg(_("E82: Cannot allocate any buffer, exiting..."));
201 
202 	    // Don't try to do any saving, with "curbuf" NULL almost nothing
203 	    // will work.
204 	    v_dying = 2;
205 	    getout(2);
206 	}
207 
208 	emsg(_("E83: Cannot allocate buffer, using other one..."));
209 	enter_buffer(curbuf);
210 #ifdef FEAT_SYN_HL
211 	if (old_tw != curbuf->b_p_tw)
212 	    check_colorcolumn(curwin);
213 #endif
214 	return FAIL;
215     }
216 
217     // The autocommands in readfile() may change the buffer, but only AFTER
218     // reading the file.
219     set_bufref(&old_curbuf, curbuf);
220     modified_was_set = FALSE;
221 
222     // mark cursor position as being invalid
223     curwin->w_valid = 0;
224 
225     if (curbuf->b_ffname != NULL
226 #ifdef FEAT_NETBEANS_INTG
227 	    && netbeansReadFile
228 #endif
229        )
230     {
231 	int old_msg_silent = msg_silent;
232 #ifdef UNIX
233 	int save_bin = curbuf->b_p_bin;
234 	int perm;
235 #endif
236 #ifdef FEAT_NETBEANS_INTG
237 	int oldFire = netbeansFireChanges;
238 
239 	netbeansFireChanges = 0;
240 #endif
241 #ifdef UNIX
242 	perm = mch_getperm(curbuf->b_ffname);
243 	if (perm >= 0 && (S_ISFIFO(perm)
244 		      || S_ISSOCK(perm)
245 # ifdef OPEN_CHR_FILES
246 		      || (S_ISCHR(perm) && is_dev_fd_file(curbuf->b_ffname))
247 # endif
248 		    ))
249 		read_fifo = TRUE;
250 	if (read_fifo)
251 	    curbuf->b_p_bin = TRUE;
252 #endif
253 	if (shortmess(SHM_FILEINFO))
254 	    msg_silent = 1;
255 	retval = readfile(curbuf->b_ffname, curbuf->b_fname,
256 		  (linenr_T)0, (linenr_T)0, (linenr_T)MAXLNUM, eap,
257 		  flags | READ_NEW | (read_fifo ? READ_FIFO : 0));
258 #ifdef UNIX
259 	if (read_fifo)
260 	{
261 	    curbuf->b_p_bin = save_bin;
262 	    if (retval == OK)
263 		retval = read_buffer(FALSE, eap, flags);
264 	}
265 #endif
266 	msg_silent = old_msg_silent;
267 #ifdef FEAT_NETBEANS_INTG
268 	netbeansFireChanges = oldFire;
269 #endif
270 	// Help buffer is filtered.
271 	if (bt_help(curbuf))
272 	    fix_help_buffer();
273     }
274     else if (read_stdin)
275     {
276 	int	save_bin = curbuf->b_p_bin;
277 
278 	/*
279 	 * First read the text in binary mode into the buffer.
280 	 * Then read from that same buffer and append at the end.  This makes
281 	 * it possible to retry when 'fileformat' or 'fileencoding' was
282 	 * guessed wrong.
283 	 */
284 	curbuf->b_p_bin = TRUE;
285 	retval = readfile(NULL, NULL, (linenr_T)0,
286 		  (linenr_T)0, (linenr_T)MAXLNUM, NULL,
287 		  flags | (READ_NEW + READ_STDIN));
288 	curbuf->b_p_bin = save_bin;
289 	if (retval == OK)
290 	    retval = read_buffer(TRUE, eap, flags);
291     }
292 
293     // if first time loading this buffer, init b_chartab[]
294     if (curbuf->b_flags & BF_NEVERLOADED)
295     {
296 	(void)buf_init_chartab(curbuf, FALSE);
297 #ifdef FEAT_CINDENT
298 	parse_cino(curbuf);
299 #endif
300     }
301 
302     /*
303      * Set/reset the Changed flag first, autocmds may change the buffer.
304      * Apply the automatic commands, before processing the modelines.
305      * So the modelines have priority over autocommands.
306      */
307     // When reading stdin, the buffer contents always needs writing, so set
308     // the changed flag.  Unless in readonly mode: "ls | gview -".
309     // When interrupted and 'cpoptions' contains 'i' set changed flag.
310     if ((got_int && vim_strchr(p_cpo, CPO_INTMOD) != NULL)
311 		|| modified_was_set	// ":set modified" used in autocmd
312 #ifdef FEAT_EVAL
313 		|| (aborting() && vim_strchr(p_cpo, CPO_INTMOD) != NULL)
314 #endif
315        )
316 	changed();
317     else if (retval == OK && !read_stdin && !read_fifo)
318 	unchanged(curbuf, FALSE, TRUE);
319     save_file_ff(curbuf);		// keep this fileformat
320 
321     // Set last_changedtick to avoid triggering a TextChanged autocommand right
322     // after it was added.
323     curbuf->b_last_changedtick = CHANGEDTICK(curbuf);
324     curbuf->b_last_changedtick_pum = CHANGEDTICK(curbuf);
325 
326     // require "!" to overwrite the file, because it wasn't read completely
327 #ifdef FEAT_EVAL
328     if (aborting())
329 #else
330     if (got_int)
331 #endif
332 	curbuf->b_flags |= BF_READERR;
333 
334 #ifdef FEAT_FOLDING
335     // Need to update automatic folding.  Do this before the autocommands,
336     // they may use the fold info.
337     foldUpdateAll(curwin);
338 #endif
339 
340     // need to set w_topline, unless some autocommand already did that.
341     if (!(curwin->w_valid & VALID_TOPLINE))
342     {
343 	curwin->w_topline = 1;
344 #ifdef FEAT_DIFF
345 	curwin->w_topfill = 0;
346 #endif
347     }
348 #ifdef FEAT_EVAL
349     apply_autocmds_retval(EVENT_BUFENTER, NULL, NULL, FALSE, curbuf, &retval);
350 #else
351     apply_autocmds(EVENT_BUFENTER, NULL, NULL, FALSE, curbuf);
352 #endif
353 
354     if (retval == OK)
355     {
356 	/*
357 	 * The autocommands may have changed the current buffer.  Apply the
358 	 * modelines to the correct buffer, if it still exists and is loaded.
359 	 */
360 	if (bufref_valid(&old_curbuf) && old_curbuf.br_buf->b_ml.ml_mfp != NULL)
361 	{
362 	    aco_save_T	aco;
363 
364 	    // Go to the buffer that was opened.
365 	    aucmd_prepbuf(&aco, old_curbuf.br_buf);
366 	    do_modelines(0);
367 	    curbuf->b_flags &= ~(BF_CHECK_RO | BF_NEVERLOADED);
368 
369 #ifdef FEAT_EVAL
370 	    apply_autocmds_retval(EVENT_BUFWINENTER, NULL, NULL, FALSE, curbuf,
371 								      &retval);
372 #else
373 	    apply_autocmds(EVENT_BUFWINENTER, NULL, NULL, FALSE, curbuf);
374 #endif
375 
376 	    // restore curwin/curbuf and a few other things
377 	    aucmd_restbuf(&aco);
378 	}
379     }
380 
381     return retval;
382 }
383 
384 /*
385  * Store "buf" in "bufref" and set the free count.
386  */
387     void
388 set_bufref(bufref_T *bufref, buf_T *buf)
389 {
390     bufref->br_buf = buf;
391     bufref->br_fnum = buf == NULL ? 0 : buf->b_fnum;
392     bufref->br_buf_free_count = buf_free_count;
393 }
394 
395 /*
396  * Return TRUE if "bufref->br_buf" points to the same buffer as when
397  * set_bufref() was called and it is a valid buffer.
398  * Only goes through the buffer list if buf_free_count changed.
399  * Also checks if b_fnum is still the same, a :bwipe followed by :new might get
400  * the same allocated memory, but it's a different buffer.
401  */
402     int
403 bufref_valid(bufref_T *bufref)
404 {
405     return bufref->br_buf_free_count == buf_free_count
406 	? TRUE : buf_valid(bufref->br_buf)
407 				  && bufref->br_fnum == bufref->br_buf->b_fnum;
408 }
409 
410 /*
411  * Return TRUE if "buf" points to a valid buffer (in the buffer list).
412  * This can be slow if there are many buffers, prefer using bufref_valid().
413  */
414     int
415 buf_valid(buf_T *buf)
416 {
417     buf_T	*bp;
418 
419     // Assume that we more often have a recent buffer, start with the last
420     // one.
421     FOR_ALL_BUFS_FROM_LAST(bp)
422 	if (bp == buf)
423 	    return TRUE;
424     return FALSE;
425 }
426 
427 /*
428  * A hash table used to quickly lookup a buffer by its number.
429  */
430 static hashtab_T buf_hashtab;
431 
432     static void
433 buf_hashtab_add(buf_T *buf)
434 {
435     sprintf((char *)buf->b_key, "%x", buf->b_fnum);
436     if (hash_add(&buf_hashtab, buf->b_key) == FAIL)
437 	emsg(_("E931: Buffer cannot be registered"));
438 }
439 
440     static void
441 buf_hashtab_remove(buf_T *buf)
442 {
443     hashitem_T *hi = hash_find(&buf_hashtab, buf->b_key);
444 
445     if (!HASHITEM_EMPTY(hi))
446 	hash_remove(&buf_hashtab, hi);
447 }
448 
449 /*
450  * Return TRUE when buffer "buf" can be unloaded.
451  * Give an error message and return FALSE when the buffer is locked or the
452  * screen is being redrawn and the buffer is in a window.
453  */
454     static int
455 can_unload_buffer(buf_T *buf)
456 {
457     int	    can_unload = !buf->b_locked;
458 
459     if (can_unload && updating_screen)
460     {
461 	win_T	*wp;
462 
463 	FOR_ALL_WINDOWS(wp)
464 	    if (wp->w_buffer == buf)
465 	    {
466 		can_unload = FALSE;
467 		break;
468 	    }
469     }
470     if (!can_unload)
471 	semsg(_("E937: Attempt to delete a buffer that is in use: %s"),
472 								 buf->b_fname);
473     return can_unload;
474 }
475 
476 /*
477  * Close the link to a buffer.
478  * "action" is used when there is no longer a window for the buffer.
479  * It can be:
480  * 0			buffer becomes hidden
481  * DOBUF_UNLOAD		buffer is unloaded
482  * DOBUF_DELETE		buffer is unloaded and removed from buffer list
483  * DOBUF_WIPE		buffer is unloaded and really deleted
484  * DOBUF_WIPE_REUSE	idem, and add to buf_reuse list
485  * When doing all but the first one on the current buffer, the caller should
486  * get a new buffer very soon!
487  *
488  * The 'bufhidden' option can force freeing and deleting.
489  *
490  * When "abort_if_last" is TRUE then do not close the buffer if autocommands
491  * cause there to be only one window with this buffer.  e.g. when ":quit" is
492  * supposed to close the window but autocommands close all other windows.
493  *
494  * When "ignore_abort" is TRUE don't abort even when aborting() returns TRUE.
495  *
496  * Return TRUE when we got to the end and b_nwindows was decremented.
497  */
498     int
499 close_buffer(
500     win_T	*win,		// if not NULL, set b_last_cursor
501     buf_T	*buf,
502     int		action,
503     int		abort_if_last,
504     int		ignore_abort)
505 {
506     int		is_curbuf;
507     int		nwindows;
508     bufref_T	bufref;
509     int		is_curwin = (curwin != NULL && curwin->w_buffer == buf);
510     win_T	*the_curwin = curwin;
511     tabpage_T	*the_curtab = curtab;
512     int		unload_buf = (action != 0);
513     int		wipe_buf = (action == DOBUF_WIPE || action == DOBUF_WIPE_REUSE);
514     int		del_buf = (action == DOBUF_DEL || wipe_buf);
515 
516     CHECK_CURBUF;
517     /*
518      * Force unloading or deleting when 'bufhidden' says so.
519      * The caller must take care of NOT deleting/freeing when 'bufhidden' is
520      * "hide" (otherwise we could never free or delete a buffer).
521      */
522     if (buf->b_p_bh[0] == 'd')		// 'bufhidden' == "delete"
523     {
524 	del_buf = TRUE;
525 	unload_buf = TRUE;
526     }
527     else if (buf->b_p_bh[0] == 'w')	// 'bufhidden' == "wipe"
528     {
529 	del_buf = TRUE;
530 	unload_buf = TRUE;
531 	wipe_buf = TRUE;
532     }
533     else if (buf->b_p_bh[0] == 'u')	// 'bufhidden' == "unload"
534 	unload_buf = TRUE;
535 
536 #ifdef FEAT_TERMINAL
537     if (bt_terminal(buf) && (buf->b_nwindows == 1 || del_buf))
538     {
539 	CHECK_CURBUF;
540 	if (term_job_running(buf->b_term))
541 	{
542 	    if (wipe_buf || unload_buf)
543 	    {
544 		if (!can_unload_buffer(buf))
545 		    return FALSE;
546 
547 		// Wiping out or unloading a terminal buffer kills the job.
548 		free_terminal(buf);
549 	    }
550 	    else
551 	    {
552 		// The job keeps running, hide the buffer.
553 		del_buf = FALSE;
554 		unload_buf = FALSE;
555 	    }
556 	}
557 	else if (buf->b_p_bh[0] == 'h' && !del_buf)
558 	{
559 	    // Hide a terminal buffer.
560 	    unload_buf = FALSE;
561 	}
562 	else
563 	{
564 	    // A terminal buffer is wiped out if the job has finished.
565 	    del_buf = TRUE;
566 	    unload_buf = TRUE;
567 	    wipe_buf = TRUE;
568 	}
569 	CHECK_CURBUF;
570     }
571 #endif
572 
573     // Disallow deleting the buffer when it is locked (already being closed or
574     // halfway a command that relies on it). Unloading is allowed.
575     if ((del_buf || wipe_buf) && !can_unload_buffer(buf))
576 	return FALSE;
577 
578     // check no autocommands closed the window
579     if (win != NULL && win_valid_any_tab(win))
580     {
581 	// Set b_last_cursor when closing the last window for the buffer.
582 	// Remember the last cursor position and window options of the buffer.
583 	// This used to be only for the current window, but then options like
584 	// 'foldmethod' may be lost with a ":only" command.
585 	if (buf->b_nwindows == 1)
586 	    set_last_cursor(win);
587 	buflist_setfpos(buf, win,
588 		    win->w_cursor.lnum == 1 ? 0 : win->w_cursor.lnum,
589 		    win->w_cursor.col, TRUE);
590     }
591 
592     set_bufref(&bufref, buf);
593 
594     // When the buffer is no longer in a window, trigger BufWinLeave
595     if (buf->b_nwindows == 1)
596     {
597 	++buf->b_locked;
598 	++buf->b_locked_split;
599 	if (apply_autocmds(EVENT_BUFWINLEAVE, buf->b_fname, buf->b_fname,
600 								  FALSE, buf)
601 		&& !bufref_valid(&bufref))
602 	{
603 	    // Autocommands deleted the buffer.
604 aucmd_abort:
605 	    emsg(_(e_auabort));
606 	    return FALSE;
607 	}
608 	--buf->b_locked;
609 	--buf->b_locked_split;
610 	if (abort_if_last && one_window())
611 	    // Autocommands made this the only window.
612 	    goto aucmd_abort;
613 
614 	// When the buffer becomes hidden, but is not unloaded, trigger
615 	// BufHidden
616 	if (!unload_buf)
617 	{
618 	    ++buf->b_locked;
619 	    ++buf->b_locked_split;
620 	    if (apply_autocmds(EVENT_BUFHIDDEN, buf->b_fname, buf->b_fname,
621 								  FALSE, buf)
622 		    && !bufref_valid(&bufref))
623 		// Autocommands deleted the buffer.
624 		goto aucmd_abort;
625 	    --buf->b_locked;
626 	    --buf->b_locked_split;
627 	    if (abort_if_last && one_window())
628 		// Autocommands made this the only window.
629 		goto aucmd_abort;
630 	}
631 #ifdef FEAT_EVAL
632 	// autocmds may abort script processing
633 	if (!ignore_abort && aborting())
634 	    return FALSE;
635 #endif
636     }
637 
638     // If the buffer was in curwin and the window has changed, go back to that
639     // window, if it still exists.  This avoids that ":edit x" triggering a
640     // "tabnext" BufUnload autocmd leaves a window behind without a buffer.
641     if (is_curwin && curwin != the_curwin &&  win_valid_any_tab(the_curwin))
642     {
643 	block_autocmds();
644 	goto_tabpage_win(the_curtab, the_curwin);
645 	unblock_autocmds();
646     }
647 
648     nwindows = buf->b_nwindows;
649 
650     // decrease the link count from windows (unless not in any window)
651     if (buf->b_nwindows > 0)
652 	--buf->b_nwindows;
653 
654 #ifdef FEAT_DIFF
655     if (diffopt_hiddenoff() && !unload_buf && buf->b_nwindows == 0)
656 	diff_buf_delete(buf);	// Clear 'diff' for hidden buffer.
657 #endif
658 
659     // Return when a window is displaying the buffer or when it's not
660     // unloaded.
661     if (buf->b_nwindows > 0 || !unload_buf)
662 	return FALSE;
663 
664     // Always remove the buffer when there is no file name.
665     if (buf->b_ffname == NULL)
666 	del_buf = TRUE;
667 
668     // When closing the current buffer stop Visual mode before freeing
669     // anything.
670     if (buf == curbuf && VIsual_active
671 #if defined(EXITFREE)
672 	    && !entered_free_all_mem
673 #endif
674 	    )
675 	end_visual_mode();
676 
677     /*
678      * Free all things allocated for this buffer.
679      * Also calls the "BufDelete" autocommands when del_buf is TRUE.
680      */
681     // Remember if we are closing the current buffer.  Restore the number of
682     // windows, so that autocommands in buf_freeall() don't get confused.
683     is_curbuf = (buf == curbuf);
684     buf->b_nwindows = nwindows;
685 
686     buf_freeall(buf, (del_buf ? BFA_DEL : 0)
687 		   + (wipe_buf ? BFA_WIPE : 0)
688 		   + (ignore_abort ? BFA_IGNORE_ABORT : 0));
689 
690     // Autocommands may have deleted the buffer.
691     if (!bufref_valid(&bufref))
692 	return FALSE;
693 #ifdef FEAT_EVAL
694     // autocmds may abort script processing
695     if (!ignore_abort && aborting())
696 	return FALSE;
697 #endif
698 
699     /*
700      * It's possible that autocommands change curbuf to the one being deleted.
701      * This might cause the previous curbuf to be deleted unexpectedly.  But
702      * in some cases it's OK to delete the curbuf, because a new one is
703      * obtained anyway.  Therefore only return if curbuf changed to the
704      * deleted buffer.
705      */
706     if (buf == curbuf && !is_curbuf)
707 	return FALSE;
708 
709     if (win_valid_any_tab(win) && win->w_buffer == buf)
710 	win->w_buffer = NULL;  // make sure we don't use the buffer now
711 
712     // Autocommands may have opened or closed windows for this buffer.
713     // Decrement the count for the close we do here.
714     if (buf->b_nwindows > 0)
715 	--buf->b_nwindows;
716 
717     /*
718      * Remove the buffer from the list.
719      */
720     if (wipe_buf)
721     {
722 	if (action == DOBUF_WIPE_REUSE)
723 	{
724 	    // we can re-use this buffer number, store it
725 	    if (buf_reuse.ga_itemsize == 0)
726 		ga_init2(&buf_reuse, sizeof(int), 50);
727 	    if (ga_grow(&buf_reuse, 1) == OK)
728 		((int *)buf_reuse.ga_data)[buf_reuse.ga_len++] = buf->b_fnum;
729 	}
730 	if (buf->b_sfname != buf->b_ffname)
731 	    VIM_CLEAR(buf->b_sfname);
732 	else
733 	    buf->b_sfname = NULL;
734 	VIM_CLEAR(buf->b_ffname);
735 	if (buf->b_prev == NULL)
736 	    firstbuf = buf->b_next;
737 	else
738 	    buf->b_prev->b_next = buf->b_next;
739 	if (buf->b_next == NULL)
740 	    lastbuf = buf->b_prev;
741 	else
742 	    buf->b_next->b_prev = buf->b_prev;
743 	free_buffer(buf);
744     }
745     else
746     {
747 	if (del_buf)
748 	{
749 	    // Free all internal variables and reset option values, to make
750 	    // ":bdel" compatible with Vim 5.7.
751 	    free_buffer_stuff(buf, TRUE);
752 
753 	    // Make it look like a new buffer.
754 	    buf->b_flags = BF_CHECK_RO | BF_NEVERLOADED;
755 
756 	    // Init the options when loaded again.
757 	    buf->b_p_initialized = FALSE;
758 	}
759 	buf_clear_file(buf);
760 	if (del_buf)
761 	    buf->b_p_bl = FALSE;
762     }
763     // NOTE: at this point "curbuf" may be invalid!
764     return TRUE;
765 }
766 
767 /*
768  * Make buffer not contain a file.
769  */
770     void
771 buf_clear_file(buf_T *buf)
772 {
773     buf->b_ml.ml_line_count = 1;
774     unchanged(buf, TRUE, TRUE);
775     buf->b_shortname = FALSE;
776     buf->b_p_eol = TRUE;
777     buf->b_start_eol = TRUE;
778     buf->b_p_bomb = FALSE;
779     buf->b_start_bomb = FALSE;
780     buf->b_ml.ml_mfp = NULL;
781     buf->b_ml.ml_flags = ML_EMPTY;		// empty buffer
782 #ifdef FEAT_NETBEANS_INTG
783     netbeans_deleted_all_lines(buf);
784 #endif
785 }
786 
787 /*
788  * buf_freeall() - free all things allocated for a buffer that are related to
789  * the file.  Careful: get here with "curwin" NULL when exiting.
790  * flags:
791  * BFA_DEL	     buffer is going to be deleted
792  * BFA_WIPE	     buffer is going to be wiped out
793  * BFA_KEEP_UNDO     do not free undo information
794  * BFA_IGNORE_ABORT  don't abort even when aborting() returns TRUE
795  */
796     void
797 buf_freeall(buf_T *buf, int flags)
798 {
799     int		is_curbuf = (buf == curbuf);
800     bufref_T	bufref;
801     int		is_curwin = (curwin != NULL && curwin->w_buffer == buf);
802     win_T	*the_curwin = curwin;
803     tabpage_T	*the_curtab = curtab;
804 
805     // Make sure the buffer isn't closed by autocommands.
806     ++buf->b_locked;
807     ++buf->b_locked_split;
808     set_bufref(&bufref, buf);
809     if (buf->b_ml.ml_mfp != NULL)
810     {
811 	if (apply_autocmds(EVENT_BUFUNLOAD, buf->b_fname, buf->b_fname,
812 								  FALSE, buf)
813 		&& !bufref_valid(&bufref))
814 	    // autocommands deleted the buffer
815 	    return;
816     }
817     if ((flags & BFA_DEL) && buf->b_p_bl)
818     {
819 	if (apply_autocmds(EVENT_BUFDELETE, buf->b_fname, buf->b_fname,
820 								   FALSE, buf)
821 		&& !bufref_valid(&bufref))
822 	    // autocommands deleted the buffer
823 	    return;
824     }
825     if (flags & BFA_WIPE)
826     {
827 	if (apply_autocmds(EVENT_BUFWIPEOUT, buf->b_fname, buf->b_fname,
828 								  FALSE, buf)
829 		&& !bufref_valid(&bufref))
830 	    // autocommands deleted the buffer
831 	    return;
832     }
833     --buf->b_locked;
834     --buf->b_locked_split;
835 
836     // If the buffer was in curwin and the window has changed, go back to that
837     // window, if it still exists.  This avoids that ":edit x" triggering a
838     // "tabnext" BufUnload autocmd leaves a window behind without a buffer.
839     if (is_curwin && curwin != the_curwin &&  win_valid_any_tab(the_curwin))
840     {
841 	block_autocmds();
842 	goto_tabpage_win(the_curtab, the_curwin);
843 	unblock_autocmds();
844     }
845 
846 #ifdef FEAT_EVAL
847     // autocmds may abort script processing
848     if ((flags & BFA_IGNORE_ABORT) == 0 && aborting())
849 	return;
850 #endif
851 
852     /*
853      * It's possible that autocommands change curbuf to the one being deleted.
854      * This might cause curbuf to be deleted unexpectedly.  But in some cases
855      * it's OK to delete the curbuf, because a new one is obtained anyway.
856      * Therefore only return if curbuf changed to the deleted buffer.
857      */
858     if (buf == curbuf && !is_curbuf)
859 	return;
860 #ifdef FEAT_DIFF
861     diff_buf_delete(buf);	    // Can't use 'diff' for unloaded buffer.
862 #endif
863 #ifdef FEAT_SYN_HL
864     // Remove any ownsyntax, unless exiting.
865     if (curwin != NULL && curwin->w_buffer == buf)
866 	reset_synblock(curwin);
867 #endif
868 
869 #ifdef FEAT_FOLDING
870     // No folds in an empty buffer.
871     {
872 	win_T		*win;
873 	tabpage_T	*tp;
874 
875 	FOR_ALL_TAB_WINDOWS(tp, win)
876 	    if (win->w_buffer == buf)
877 		clearFolding(win);
878     }
879 #endif
880 
881 #ifdef FEAT_TCL
882     tcl_buffer_free(buf);
883 #endif
884     ml_close(buf, TRUE);	    // close and delete the memline/memfile
885     buf->b_ml.ml_line_count = 0;    // no lines in buffer
886     if ((flags & BFA_KEEP_UNDO) == 0)
887     {
888 	u_blockfree(buf);	    // free the memory allocated for undo
889 	u_clearall(buf);	    // reset all undo information
890     }
891 #ifdef FEAT_SYN_HL
892     syntax_clear(&buf->b_s);	    // reset syntax info
893 #endif
894 #ifdef FEAT_PROP_POPUP
895     clear_buf_prop_types(buf);
896 #endif
897     buf->b_flags &= ~BF_READERR;    // a read error is no longer relevant
898 }
899 
900 /*
901  * Free a buffer structure and the things it contains related to the buffer
902  * itself (not the file, that must have been done already).
903  */
904     static void
905 free_buffer(buf_T *buf)
906 {
907     ++buf_free_count;
908     free_buffer_stuff(buf, TRUE);
909 #ifdef FEAT_EVAL
910     // b:changedtick uses an item in buf_T, remove it now
911     dictitem_remove(buf->b_vars, (dictitem_T *)&buf->b_ct_di);
912     unref_var_dict(buf->b_vars);
913     remove_listeners(buf);
914 #endif
915 #ifdef FEAT_LUA
916     lua_buffer_free(buf);
917 #endif
918 #ifdef FEAT_MZSCHEME
919     mzscheme_buffer_free(buf);
920 #endif
921 #ifdef FEAT_PERL
922     perl_buf_free(buf);
923 #endif
924 #ifdef FEAT_PYTHON
925     python_buffer_free(buf);
926 #endif
927 #ifdef FEAT_PYTHON3
928     python3_buffer_free(buf);
929 #endif
930 #ifdef FEAT_RUBY
931     ruby_buffer_free(buf);
932 #endif
933 #ifdef FEAT_JOB_CHANNEL
934     channel_buffer_free(buf);
935 #endif
936 #ifdef FEAT_TERMINAL
937     free_terminal(buf);
938 #endif
939 #ifdef FEAT_JOB_CHANNEL
940     vim_free(buf->b_prompt_text);
941     free_callback(&buf->b_prompt_callback);
942     free_callback(&buf->b_prompt_interrupt);
943 #endif
944 
945     buf_hashtab_remove(buf);
946 
947     aubuflocal_remove(buf);
948 
949     if (autocmd_busy)
950     {
951 	// Do not free the buffer structure while autocommands are executing,
952 	// it's still needed. Free it when autocmd_busy is reset.
953 	buf->b_next = au_pending_free_buf;
954 	au_pending_free_buf = buf;
955     }
956     else
957     {
958 	vim_free(buf);
959 	if (curbuf == buf)
960 	    curbuf = NULL;  // make clear it's not to be used
961     }
962 }
963 
964 /*
965  * Initializes b:changedtick.
966  */
967     static void
968 init_changedtick(buf_T *buf)
969 {
970     dictitem_T *di = (dictitem_T *)&buf->b_ct_di;
971 
972     di->di_flags = DI_FLAGS_FIX | DI_FLAGS_RO;
973     di->di_tv.v_type = VAR_NUMBER;
974     di->di_tv.v_lock = VAR_FIXED;
975     di->di_tv.vval.v_number = 0;
976 
977 #ifdef FEAT_EVAL
978     STRCPY(buf->b_ct_di.di_key, "changedtick");
979     (void)dict_add(buf->b_vars, di);
980 #endif
981 }
982 
983 /*
984  * Free stuff in the buffer for ":bdel" and when wiping out the buffer.
985  */
986     static void
987 free_buffer_stuff(
988     buf_T	*buf,
989     int		free_options)		// free options as well
990 {
991     if (free_options)
992     {
993 	clear_wininfo(buf);		// including window-local options
994 	free_buf_options(buf, TRUE);
995 #ifdef FEAT_SPELL
996 	ga_clear(&buf->b_s.b_langp);
997 #endif
998     }
999 #ifdef FEAT_EVAL
1000     {
1001 	varnumber_T tick = CHANGEDTICK(buf);
1002 
1003 	vars_clear(&buf->b_vars->dv_hashtab); // free all buffer variables
1004 	hash_init(&buf->b_vars->dv_hashtab);
1005 	init_changedtick(buf);
1006 	CHANGEDTICK(buf) = tick;
1007 	remove_listeners(buf);
1008     }
1009 #endif
1010     uc_clear(&buf->b_ucmds);		// clear local user commands
1011 #ifdef FEAT_SIGNS
1012     buf_delete_signs(buf, (char_u *)"*");	// delete any signs
1013 #endif
1014 #ifdef FEAT_NETBEANS_INTG
1015     netbeans_file_killed(buf);
1016 #endif
1017     map_clear_int(buf, MAP_ALL_MODES, TRUE, FALSE);  // clear local mappings
1018     map_clear_int(buf, MAP_ALL_MODES, TRUE, TRUE);   // clear local abbrevs
1019     VIM_CLEAR(buf->b_start_fenc);
1020 }
1021 
1022 /*
1023  * Free one wininfo_T.
1024  */
1025     void
1026 free_wininfo(wininfo_T *wip)
1027 {
1028     if (wip->wi_optset)
1029     {
1030 	clear_winopt(&wip->wi_opt);
1031 #ifdef FEAT_FOLDING
1032 	deleteFoldRecurse(&wip->wi_folds);
1033 #endif
1034     }
1035     vim_free(wip);
1036 }
1037 
1038 /*
1039  * Free the b_wininfo list for buffer "buf".
1040  */
1041     static void
1042 clear_wininfo(buf_T *buf)
1043 {
1044     wininfo_T	*wip;
1045 
1046     while (buf->b_wininfo != NULL)
1047     {
1048 	wip = buf->b_wininfo;
1049 	buf->b_wininfo = wip->wi_next;
1050 	free_wininfo(wip);
1051     }
1052 }
1053 
1054 /*
1055  * Go to another buffer.  Handles the result of the ATTENTION dialog.
1056  */
1057     void
1058 goto_buffer(
1059     exarg_T	*eap,
1060     int		start,
1061     int		dir,
1062     int		count)
1063 {
1064     bufref_T	old_curbuf;
1065 
1066     set_bufref(&old_curbuf, curbuf);
1067 
1068     swap_exists_action = SEA_DIALOG;
1069     (void)do_buffer(*eap->cmd == 's' ? DOBUF_SPLIT : DOBUF_GOTO,
1070 					     start, dir, count, eap->forceit);
1071     if (swap_exists_action == SEA_QUIT && *eap->cmd == 's')
1072     {
1073 #if defined(FEAT_EVAL)
1074 	cleanup_T   cs;
1075 
1076 	// Reset the error/interrupt/exception state here so that
1077 	// aborting() returns FALSE when closing a window.
1078 	enter_cleanup(&cs);
1079 #endif
1080 
1081 	// Quitting means closing the split window, nothing else.
1082 	win_close(curwin, TRUE);
1083 	swap_exists_action = SEA_NONE;
1084 	swap_exists_did_quit = TRUE;
1085 
1086 #if defined(FEAT_EVAL)
1087 	// Restore the error/interrupt/exception state if not discarded by a
1088 	// new aborting error, interrupt, or uncaught exception.
1089 	leave_cleanup(&cs);
1090 #endif
1091     }
1092     else
1093 	handle_swap_exists(&old_curbuf);
1094 }
1095 
1096 /*
1097  * Handle the situation of swap_exists_action being set.
1098  * It is allowed for "old_curbuf" to be NULL or invalid.
1099  */
1100     void
1101 handle_swap_exists(bufref_T *old_curbuf)
1102 {
1103 #if defined(FEAT_EVAL)
1104     cleanup_T	cs;
1105 #endif
1106 #ifdef FEAT_SYN_HL
1107     long	old_tw = curbuf->b_p_tw;
1108 #endif
1109     buf_T	*buf;
1110 
1111     if (swap_exists_action == SEA_QUIT)
1112     {
1113 #if defined(FEAT_EVAL)
1114 	// Reset the error/interrupt/exception state here so that
1115 	// aborting() returns FALSE when closing a buffer.
1116 	enter_cleanup(&cs);
1117 #endif
1118 
1119 	// User selected Quit at ATTENTION prompt.  Go back to previous
1120 	// buffer.  If that buffer is gone or the same as the current one,
1121 	// open a new, empty buffer.
1122 	swap_exists_action = SEA_NONE;	// don't want it again
1123 	swap_exists_did_quit = TRUE;
1124 	close_buffer(curwin, curbuf, DOBUF_UNLOAD, FALSE, FALSE);
1125 	if (old_curbuf == NULL || !bufref_valid(old_curbuf)
1126 					      || old_curbuf->br_buf == curbuf)
1127 	    buf = buflist_new(NULL, NULL, 1L, BLN_CURBUF | BLN_LISTED);
1128 	else
1129 	    buf = old_curbuf->br_buf;
1130 	if (buf != NULL)
1131 	{
1132 	    int old_msg_silent = msg_silent;
1133 
1134 	    if (shortmess(SHM_FILEINFO))
1135 		msg_silent = 1;  // prevent fileinfo message
1136 	    enter_buffer(buf);
1137 	    // restore msg_silent, so that the command line will be shown
1138 	    msg_silent = old_msg_silent;
1139 
1140 #ifdef FEAT_SYN_HL
1141 	    if (old_tw != curbuf->b_p_tw)
1142 		check_colorcolumn(curwin);
1143 #endif
1144 	}
1145 	// If "old_curbuf" is NULL we are in big trouble here...
1146 
1147 #if defined(FEAT_EVAL)
1148 	// Restore the error/interrupt/exception state if not discarded by a
1149 	// new aborting error, interrupt, or uncaught exception.
1150 	leave_cleanup(&cs);
1151 #endif
1152     }
1153     else if (swap_exists_action == SEA_RECOVER)
1154     {
1155 #if defined(FEAT_EVAL)
1156 	// Reset the error/interrupt/exception state here so that
1157 	// aborting() returns FALSE when closing a buffer.
1158 	enter_cleanup(&cs);
1159 #endif
1160 
1161 	// User selected Recover at ATTENTION prompt.
1162 	msg_scroll = TRUE;
1163 	ml_recover(FALSE);
1164 	msg_puts("\n");	// don't overwrite the last message
1165 	cmdline_row = msg_row;
1166 	do_modelines(0);
1167 
1168 #if defined(FEAT_EVAL)
1169 	// Restore the error/interrupt/exception state if not discarded by a
1170 	// new aborting error, interrupt, or uncaught exception.
1171 	leave_cleanup(&cs);
1172 #endif
1173     }
1174     swap_exists_action = SEA_NONE;
1175 }
1176 
1177 /*
1178  * do_bufdel() - delete or unload buffer(s)
1179  *
1180  * addr_count == 0: ":bdel" - delete current buffer
1181  * addr_count == 1: ":N bdel" or ":bdel N [N ..]" - first delete
1182  *		    buffer "end_bnr", then any other arguments.
1183  * addr_count == 2: ":N,N bdel" - delete buffers in range
1184  *
1185  * command can be DOBUF_UNLOAD (":bunload"), DOBUF_WIPE (":bwipeout") or
1186  * DOBUF_DEL (":bdel")
1187  *
1188  * Returns error message or NULL
1189  */
1190     char *
1191 do_bufdel(
1192     int		command,
1193     char_u	*arg,		// pointer to extra arguments
1194     int		addr_count,
1195     int		start_bnr,	// first buffer number in a range
1196     int		end_bnr,	// buffer nr or last buffer nr in a range
1197     int		forceit)
1198 {
1199     int		do_current = 0;	// delete current buffer?
1200     int		deleted = 0;	// number of buffers deleted
1201     char	*errormsg = NULL; // return value
1202     int		bnr;		// buffer number
1203     char_u	*p;
1204 
1205     if (addr_count == 0)
1206     {
1207 	(void)do_buffer(command, DOBUF_CURRENT, FORWARD, 0, forceit);
1208     }
1209     else
1210     {
1211 	if (addr_count == 2)
1212 	{
1213 	    if (*arg)		// both range and argument is not allowed
1214 		return ex_errmsg(e_trailing_arg, arg);
1215 	    bnr = start_bnr;
1216 	}
1217 	else	// addr_count == 1
1218 	    bnr = end_bnr;
1219 
1220 	for ( ;!got_int; ui_breakcheck())
1221 	{
1222 	    /*
1223 	     * delete the current buffer last, otherwise when the
1224 	     * current buffer is deleted, the next buffer becomes
1225 	     * the current one and will be loaded, which may then
1226 	     * also be deleted, etc.
1227 	     */
1228 	    if (bnr == curbuf->b_fnum)
1229 		do_current = bnr;
1230 	    else if (do_buffer(command, DOBUF_FIRST, FORWARD, (int)bnr,
1231 							       forceit) == OK)
1232 		++deleted;
1233 
1234 	    /*
1235 	     * find next buffer number to delete/unload
1236 	     */
1237 	    if (addr_count == 2)
1238 	    {
1239 		if (++bnr > end_bnr)
1240 		    break;
1241 	    }
1242 	    else    // addr_count == 1
1243 	    {
1244 		arg = skipwhite(arg);
1245 		if (*arg == NUL)
1246 		    break;
1247 		if (!VIM_ISDIGIT(*arg))
1248 		{
1249 		    p = skiptowhite_esc(arg);
1250 		    bnr = buflist_findpat(arg, p,
1251 			  command == DOBUF_WIPE || command == DOBUF_WIPE_REUSE,
1252 								FALSE, FALSE);
1253 		    if (bnr < 0)	    // failed
1254 			break;
1255 		    arg = p;
1256 		}
1257 		else
1258 		    bnr = getdigits(&arg);
1259 	    }
1260 	}
1261 	if (!got_int && do_current && do_buffer(command, DOBUF_FIRST,
1262 					  FORWARD, do_current, forceit) == OK)
1263 	    ++deleted;
1264 
1265 	if (deleted == 0)
1266 	{
1267 	    if (command == DOBUF_UNLOAD)
1268 		STRCPY(IObuff, _("E515: No buffers were unloaded"));
1269 	    else if (command == DOBUF_DEL)
1270 		STRCPY(IObuff, _("E516: No buffers were deleted"));
1271 	    else
1272 		STRCPY(IObuff, _("E517: No buffers were wiped out"));
1273 	    errormsg = (char *)IObuff;
1274 	}
1275 	else if (deleted >= p_report)
1276 	{
1277 	    if (command == DOBUF_UNLOAD)
1278 		smsg(NGETTEXT("%d buffer unloaded",
1279 			    "%d buffers unloaded", deleted), deleted);
1280 	    else if (command == DOBUF_DEL)
1281 		smsg(NGETTEXT("%d buffer deleted",
1282 			    "%d buffers deleted", deleted), deleted);
1283 	    else
1284 		smsg(NGETTEXT("%d buffer wiped out",
1285 			    "%d buffers wiped out", deleted), deleted);
1286 	}
1287     }
1288 
1289 
1290     return errormsg;
1291 }
1292 
1293 /*
1294  * Make the current buffer empty.
1295  * Used when it is wiped out and it's the last buffer.
1296  */
1297     static int
1298 empty_curbuf(
1299     int close_others,
1300     int forceit,
1301     int action)
1302 {
1303     int	    retval;
1304     buf_T   *buf = curbuf;
1305     bufref_T bufref;
1306 
1307     if (action == DOBUF_UNLOAD)
1308     {
1309 	emsg(_("E90: Cannot unload last buffer"));
1310 	return FAIL;
1311     }
1312 
1313     set_bufref(&bufref, buf);
1314     if (close_others)
1315 	// Close any other windows on this buffer, then make it empty.
1316 	close_windows(buf, TRUE);
1317 
1318     setpcmark();
1319     retval = do_ecmd(0, NULL, NULL, NULL, ECMD_ONE,
1320 					  forceit ? ECMD_FORCEIT : 0, curwin);
1321 
1322     /*
1323      * do_ecmd() may create a new buffer, then we have to delete
1324      * the old one.  But do_ecmd() may have done that already, check
1325      * if the buffer still exists.
1326      */
1327     if (buf != curbuf && bufref_valid(&bufref) && buf->b_nwindows == 0)
1328 	close_buffer(NULL, buf, action, FALSE, FALSE);
1329     if (!close_others)
1330 	need_fileinfo = FALSE;
1331     return retval;
1332 }
1333 
1334 /*
1335  * Implementation of the commands for the buffer list.
1336  *
1337  * action == DOBUF_GOTO	    go to specified buffer
1338  * action == DOBUF_SPLIT    split window and go to specified buffer
1339  * action == DOBUF_UNLOAD   unload specified buffer(s)
1340  * action == DOBUF_DEL	    delete specified buffer(s) from buffer list
1341  * action == DOBUF_WIPE	    delete specified buffer(s) really
1342  * action == DOBUF_WIPE_REUSE idem, and add number to "buf_reuse"
1343  *
1344  * start == DOBUF_CURRENT   go to "count" buffer from current buffer
1345  * start == DOBUF_FIRST	    go to "count" buffer from first buffer
1346  * start == DOBUF_LAST	    go to "count" buffer from last buffer
1347  * start == DOBUF_MOD	    go to "count" modified buffer from current buffer
1348  *
1349  * Return FAIL or OK.
1350  */
1351     int
1352 do_buffer(
1353     int		action,
1354     int		start,
1355     int		dir,		// FORWARD or BACKWARD
1356     int		count,		// buffer number or number of buffers
1357     int		forceit)	// TRUE for :...!
1358 {
1359     buf_T	*buf;
1360     buf_T	*bp;
1361     int		unload = (action == DOBUF_UNLOAD || action == DOBUF_DEL
1362 			|| action == DOBUF_WIPE || action == DOBUF_WIPE_REUSE);
1363 
1364     switch (start)
1365     {
1366 	case DOBUF_FIRST:   buf = firstbuf; break;
1367 	case DOBUF_LAST:    buf = lastbuf;  break;
1368 	default:	    buf = curbuf;   break;
1369     }
1370     if (start == DOBUF_MOD)	    // find next modified buffer
1371     {
1372 	while (count-- > 0)
1373 	{
1374 	    do
1375 	    {
1376 		buf = buf->b_next;
1377 		if (buf == NULL)
1378 		    buf = firstbuf;
1379 	    }
1380 	    while (buf != curbuf && !bufIsChanged(buf));
1381 	}
1382 	if (!bufIsChanged(buf))
1383 	{
1384 	    emsg(_("E84: No modified buffer found"));
1385 	    return FAIL;
1386 	}
1387     }
1388     else if (start == DOBUF_FIRST && count) // find specified buffer number
1389     {
1390 	while (buf != NULL && buf->b_fnum != count)
1391 	    buf = buf->b_next;
1392     }
1393     else
1394     {
1395 	bp = NULL;
1396 	while (count > 0 || (!unload && !buf->b_p_bl && bp != buf))
1397 	{
1398 	    // remember the buffer where we start, we come back there when all
1399 	    // buffers are unlisted.
1400 	    if (bp == NULL)
1401 		bp = buf;
1402 	    if (dir == FORWARD)
1403 	    {
1404 		buf = buf->b_next;
1405 		if (buf == NULL)
1406 		    buf = firstbuf;
1407 	    }
1408 	    else
1409 	    {
1410 		buf = buf->b_prev;
1411 		if (buf == NULL)
1412 		    buf = lastbuf;
1413 	    }
1414 	    // don't count unlisted buffers
1415 	    if (unload || buf->b_p_bl)
1416 	    {
1417 		 --count;
1418 		 bp = NULL;	// use this buffer as new starting point
1419 	    }
1420 	    if (bp == buf)
1421 	    {
1422 		// back where we started, didn't find anything.
1423 		emsg(_("E85: There is no listed buffer"));
1424 		return FAIL;
1425 	    }
1426 	}
1427     }
1428 
1429     if (buf == NULL)	    // could not find it
1430     {
1431 	if (start == DOBUF_FIRST)
1432 	{
1433 	    // don't warn when deleting
1434 	    if (!unload)
1435 		semsg(_(e_nobufnr), count);
1436 	}
1437 	else if (dir == FORWARD)
1438 	    emsg(_("E87: Cannot go beyond last buffer"));
1439 	else
1440 	    emsg(_("E88: Cannot go before first buffer"));
1441 	return FAIL;
1442     }
1443 
1444 #ifdef FEAT_GUI
1445     need_mouse_correct = TRUE;
1446 #endif
1447 
1448     /*
1449      * delete buffer buf from memory and/or the list
1450      */
1451     if (unload)
1452     {
1453 	int	forward;
1454 	bufref_T bufref;
1455 
1456 	if (!can_unload_buffer(buf))
1457 	    return FAIL;
1458 
1459 	set_bufref(&bufref, buf);
1460 
1461 	// When unloading or deleting a buffer that's already unloaded and
1462 	// unlisted: fail silently.
1463 	if (action != DOBUF_WIPE && action != DOBUF_WIPE_REUSE
1464 				   && buf->b_ml.ml_mfp == NULL && !buf->b_p_bl)
1465 	    return FAIL;
1466 
1467 	if (!forceit && bufIsChanged(buf))
1468 	{
1469 #if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
1470 	    if ((p_confirm || (cmdmod.cmod_flags & CMOD_CONFIRM)) && p_write)
1471 	    {
1472 		dialog_changed(buf, FALSE);
1473 		if (!bufref_valid(&bufref))
1474 		    // Autocommand deleted buffer, oops!  It's not changed
1475 		    // now.
1476 		    return FAIL;
1477 		// If it's still changed fail silently, the dialog already
1478 		// mentioned why it fails.
1479 		if (bufIsChanged(buf))
1480 		    return FAIL;
1481 	    }
1482 	    else
1483 #endif
1484 	    {
1485 		semsg(_("E89: No write since last change for buffer %d (add ! to override)"),
1486 								 buf->b_fnum);
1487 		return FAIL;
1488 	    }
1489 	}
1490 
1491 	// When closing the current buffer stop Visual mode.
1492 	if (buf == curbuf && VIsual_active)
1493 	    end_visual_mode();
1494 
1495 	/*
1496 	 * If deleting the last (listed) buffer, make it empty.
1497 	 * The last (listed) buffer cannot be unloaded.
1498 	 */
1499 	FOR_ALL_BUFFERS(bp)
1500 	    if (bp->b_p_bl && bp != buf)
1501 		break;
1502 	if (bp == NULL && buf == curbuf)
1503 	    return empty_curbuf(TRUE, forceit, action);
1504 
1505 	/*
1506 	 * If the deleted buffer is the current one, close the current window
1507 	 * (unless it's the only window).  Repeat this so long as we end up in
1508 	 * a window with this buffer.
1509 	 */
1510 	while (buf == curbuf
1511 		   && !(curwin->w_closing || curwin->w_buffer->b_locked > 0)
1512 		   && (!ONE_WINDOW || first_tabpage->tp_next != NULL))
1513 	{
1514 	    if (win_close(curwin, FALSE) == FAIL)
1515 		break;
1516 	}
1517 
1518 	/*
1519 	 * If the buffer to be deleted is not the current one, delete it here.
1520 	 */
1521 	if (buf != curbuf)
1522 	{
1523 	    close_windows(buf, FALSE);
1524 	    if (buf != curbuf && bufref_valid(&bufref) && buf->b_nwindows <= 0)
1525 		    close_buffer(NULL, buf, action, FALSE, FALSE);
1526 	    return OK;
1527 	}
1528 
1529 	/*
1530 	 * Deleting the current buffer: Need to find another buffer to go to.
1531 	 * There should be another, otherwise it would have been handled
1532 	 * above.  However, autocommands may have deleted all buffers.
1533 	 * First use au_new_curbuf.br_buf, if it is valid.
1534 	 * Then prefer the buffer we most recently visited.
1535 	 * Else try to find one that is loaded, after the current buffer,
1536 	 * then before the current buffer.
1537 	 * Finally use any buffer.
1538 	 */
1539 	buf = NULL;	// selected buffer
1540 	bp = NULL;	// used when no loaded buffer found
1541 	if (au_new_curbuf.br_buf != NULL && bufref_valid(&au_new_curbuf))
1542 	    buf = au_new_curbuf.br_buf;
1543 #ifdef FEAT_JUMPLIST
1544 	else if (curwin->w_jumplistlen > 0)
1545 	{
1546 	    int     jumpidx;
1547 
1548 	    jumpidx = curwin->w_jumplistidx - 1;
1549 	    if (jumpidx < 0)
1550 		jumpidx = curwin->w_jumplistlen - 1;
1551 
1552 	    forward = jumpidx;
1553 	    while (jumpidx != curwin->w_jumplistidx)
1554 	    {
1555 		buf = buflist_findnr(curwin->w_jumplist[jumpidx].fmark.fnum);
1556 		if (buf != NULL)
1557 		{
1558 		    if (buf == curbuf || !buf->b_p_bl)
1559 			buf = NULL;	// skip current and unlisted bufs
1560 		    else if (buf->b_ml.ml_mfp == NULL)
1561 		    {
1562 			// skip unloaded buf, but may keep it for later
1563 			if (bp == NULL)
1564 			    bp = buf;
1565 			buf = NULL;
1566 		    }
1567 		}
1568 		if (buf != NULL)   // found a valid buffer: stop searching
1569 		    break;
1570 		// advance to older entry in jump list
1571 		if (!jumpidx && curwin->w_jumplistidx == curwin->w_jumplistlen)
1572 		    break;
1573 		if (--jumpidx < 0)
1574 		    jumpidx = curwin->w_jumplistlen - 1;
1575 		if (jumpidx == forward)		// List exhausted for sure
1576 		    break;
1577 	    }
1578 	}
1579 #endif
1580 
1581 	if (buf == NULL)	// No previous buffer, Try 2'nd approach
1582 	{
1583 	    forward = TRUE;
1584 	    buf = curbuf->b_next;
1585 	    for (;;)
1586 	    {
1587 		if (buf == NULL)
1588 		{
1589 		    if (!forward)	// tried both directions
1590 			break;
1591 		    buf = curbuf->b_prev;
1592 		    forward = FALSE;
1593 		    continue;
1594 		}
1595 		// in non-help buffer, try to skip help buffers, and vv
1596 		if (buf->b_help == curbuf->b_help && buf->b_p_bl)
1597 		{
1598 		    if (buf->b_ml.ml_mfp != NULL)   // found loaded buffer
1599 			break;
1600 		    if (bp == NULL)	// remember unloaded buf for later
1601 			bp = buf;
1602 		}
1603 		if (forward)
1604 		    buf = buf->b_next;
1605 		else
1606 		    buf = buf->b_prev;
1607 	    }
1608 	}
1609 	if (buf == NULL)	// No loaded buffer, use unloaded one
1610 	    buf = bp;
1611 	if (buf == NULL)	// No loaded buffer, find listed one
1612 	{
1613 	    FOR_ALL_BUFFERS(buf)
1614 		if (buf->b_p_bl && buf != curbuf)
1615 		    break;
1616 	}
1617 	if (buf == NULL)	// Still no buffer, just take one
1618 	{
1619 	    if (curbuf->b_next != NULL)
1620 		buf = curbuf->b_next;
1621 	    else
1622 		buf = curbuf->b_prev;
1623 	}
1624     }
1625 
1626     if (buf == NULL)
1627     {
1628 	// Autocommands must have wiped out all other buffers.  Only option
1629 	// now is to make the current buffer empty.
1630 	return empty_curbuf(FALSE, forceit, action);
1631     }
1632 
1633     /*
1634      * make buf current buffer
1635      */
1636     if (action == DOBUF_SPLIT)	    // split window first
1637     {
1638 	// If 'switchbuf' contains "useopen": jump to first window containing
1639 	// "buf" if one exists
1640 	if ((swb_flags & SWB_USEOPEN) && buf_jump_open_win(buf))
1641 	    return OK;
1642 	// If 'switchbuf' contains "usetab": jump to first window in any tab
1643 	// page containing "buf" if one exists
1644 	if ((swb_flags & SWB_USETAB) && buf_jump_open_tab(buf))
1645 	    return OK;
1646 	if (win_split(0, 0) == FAIL)
1647 	    return FAIL;
1648     }
1649 
1650     // go to current buffer - nothing to do
1651     if (buf == curbuf)
1652 	return OK;
1653 
1654     /*
1655      * Check if the current buffer may be abandoned.
1656      */
1657     if (action == DOBUF_GOTO && !can_abandon(curbuf, forceit))
1658     {
1659 #if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
1660 	if ((p_confirm || (cmdmod.cmod_flags & CMOD_CONFIRM)) && p_write)
1661 	{
1662 	    bufref_T bufref;
1663 
1664 	    set_bufref(&bufref, buf);
1665 	    dialog_changed(curbuf, FALSE);
1666 	    if (!bufref_valid(&bufref))
1667 		// Autocommand deleted buffer, oops!
1668 		return FAIL;
1669 	}
1670 	if (bufIsChanged(curbuf))
1671 #endif
1672 	{
1673 	    no_write_message();
1674 	    return FAIL;
1675 	}
1676     }
1677 
1678     // Go to the other buffer.
1679     set_curbuf(buf, action);
1680 
1681     if (action == DOBUF_SPLIT)
1682 	RESET_BINDING(curwin);	// reset 'scrollbind' and 'cursorbind'
1683 
1684 #if defined(FEAT_EVAL)
1685     if (aborting())	    // autocmds may abort script processing
1686 	return FAIL;
1687 #endif
1688 
1689     return OK;
1690 }
1691 
1692 /*
1693  * Set current buffer to "buf".  Executes autocommands and closes current
1694  * buffer.  "action" tells how to close the current buffer:
1695  * DOBUF_GOTO	    free or hide it
1696  * DOBUF_SPLIT	    nothing
1697  * DOBUF_UNLOAD	    unload it
1698  * DOBUF_DEL	    delete it
1699  * DOBUF_WIPE	    wipe it out
1700  * DOBUF_WIPE_REUSE wipe it out and add to "buf_reuse"
1701  */
1702     void
1703 set_curbuf(buf_T *buf, int action)
1704 {
1705     buf_T	*prevbuf;
1706     int		unload = (action == DOBUF_UNLOAD || action == DOBUF_DEL
1707 			|| action == DOBUF_WIPE || action == DOBUF_WIPE_REUSE);
1708 #ifdef FEAT_SYN_HL
1709     long	old_tw = curbuf->b_p_tw;
1710 #endif
1711     bufref_T	newbufref;
1712     bufref_T	prevbufref;
1713 
1714     setpcmark();
1715     if ((cmdmod.cmod_flags & CMOD_KEEPALT) == 0)
1716 	curwin->w_alt_fnum = curbuf->b_fnum; // remember alternate file
1717     buflist_altfpos(curwin);			 // remember curpos
1718 
1719     // Don't restart Select mode after switching to another buffer.
1720     VIsual_reselect = FALSE;
1721 
1722     // close_windows() or apply_autocmds() may change curbuf and wipe out "buf"
1723     prevbuf = curbuf;
1724     set_bufref(&prevbufref, prevbuf);
1725     set_bufref(&newbufref, buf);
1726 
1727     // Autocommands may delete the current buffer and/or the buffer we want to
1728     // go to.  In those cases don't close the buffer.
1729     if (!apply_autocmds(EVENT_BUFLEAVE, NULL, NULL, FALSE, curbuf)
1730 	    || (bufref_valid(&prevbufref)
1731 		&& bufref_valid(&newbufref)
1732 #ifdef FEAT_EVAL
1733 		&& !aborting()
1734 #endif
1735 	       ))
1736     {
1737 #ifdef FEAT_SYN_HL
1738 	if (prevbuf == curwin->w_buffer)
1739 	    reset_synblock(curwin);
1740 #endif
1741 	if (unload)
1742 	    close_windows(prevbuf, FALSE);
1743 #if defined(FEAT_EVAL)
1744 	if (bufref_valid(&prevbufref) && !aborting())
1745 #else
1746 	if (bufref_valid(&prevbufref))
1747 #endif
1748 	{
1749 	    win_T  *previouswin = curwin;
1750 
1751 	    if (prevbuf == curbuf)
1752 		u_sync(FALSE);
1753 	    close_buffer(prevbuf == curwin->w_buffer ? curwin : NULL, prevbuf,
1754 		    unload ? action : (action == DOBUF_GOTO
1755 			&& !buf_hide(prevbuf)
1756 			&& !bufIsChanged(prevbuf)) ? DOBUF_UNLOAD : 0,
1757 		    FALSE, FALSE);
1758 	    if (curwin != previouswin && win_valid(previouswin))
1759 	      // autocommands changed curwin, Grr!
1760 	      curwin = previouswin;
1761 	}
1762     }
1763     // An autocommand may have deleted "buf", already entered it (e.g., when
1764     // it did ":bunload") or aborted the script processing.
1765     // If curwin->w_buffer is null, enter_buffer() will make it valid again
1766     if ((buf_valid(buf) && buf != curbuf
1767 #ifdef FEAT_EVAL
1768 		&& !aborting()
1769 #endif
1770 	) || curwin->w_buffer == NULL)
1771     {
1772 	enter_buffer(buf);
1773 #ifdef FEAT_SYN_HL
1774 	if (old_tw != curbuf->b_p_tw)
1775 	    check_colorcolumn(curwin);
1776 #endif
1777     }
1778 }
1779 
1780 /*
1781  * Enter a new current buffer.
1782  * Old curbuf must have been abandoned already!  This also means "curbuf" may
1783  * be pointing to freed memory.
1784  */
1785     static void
1786 enter_buffer(buf_T *buf)
1787 {
1788     // Get the buffer in the current window.
1789     curwin->w_buffer = buf;
1790     curbuf = buf;
1791     ++curbuf->b_nwindows;
1792 
1793     // Copy buffer and window local option values.  Not for a help buffer.
1794     buf_copy_options(buf, BCO_ENTER | BCO_NOHELP);
1795     if (!buf->b_help)
1796 	get_winopts(buf);
1797 #ifdef FEAT_FOLDING
1798     else
1799 	// Remove all folds in the window.
1800 	clearFolding(curwin);
1801     foldUpdateAll(curwin);	// update folds (later).
1802 #endif
1803 
1804 #ifdef FEAT_DIFF
1805     if (curwin->w_p_diff)
1806 	diff_buf_add(curbuf);
1807 #endif
1808 
1809 #ifdef FEAT_SYN_HL
1810     curwin->w_s = &(curbuf->b_s);
1811 #endif
1812 
1813     // Cursor on first line by default.
1814     curwin->w_cursor.lnum = 1;
1815     curwin->w_cursor.col = 0;
1816     curwin->w_cursor.coladd = 0;
1817     curwin->w_set_curswant = TRUE;
1818     curwin->w_topline_was_set = FALSE;
1819 
1820     // mark cursor position as being invalid
1821     curwin->w_valid = 0;
1822 
1823     buflist_setfpos(curbuf, curwin, curbuf->b_last_cursor.lnum,
1824 					      curbuf->b_last_cursor.col, TRUE);
1825 
1826     // Make sure the buffer is loaded.
1827     if (curbuf->b_ml.ml_mfp == NULL)	// need to load the file
1828     {
1829 	// If there is no filetype, allow for detecting one.  Esp. useful for
1830 	// ":ball" used in a autocommand.  If there already is a filetype we
1831 	// might prefer to keep it.
1832 	if (*curbuf->b_p_ft == NUL)
1833 	    did_filetype = FALSE;
1834 
1835 	open_buffer(FALSE, NULL, 0);
1836     }
1837     else
1838     {
1839 	if (!msg_silent && !shortmess(SHM_FILEINFO))
1840 	    need_fileinfo = TRUE;	// display file info after redraw
1841 
1842 	// check if file changed
1843 	(void)buf_check_timestamp(curbuf, FALSE);
1844 
1845 	curwin->w_topline = 1;
1846 #ifdef FEAT_DIFF
1847 	curwin->w_topfill = 0;
1848 #endif
1849 	apply_autocmds(EVENT_BUFENTER, NULL, NULL, FALSE, curbuf);
1850 	apply_autocmds(EVENT_BUFWINENTER, NULL, NULL, FALSE, curbuf);
1851     }
1852 
1853     // If autocommands did not change the cursor position, restore cursor lnum
1854     // and possibly cursor col.
1855     if (curwin->w_cursor.lnum == 1 && inindent(0))
1856 	buflist_getfpos();
1857 
1858     check_arg_idx(curwin);		// check for valid arg_idx
1859 #ifdef FEAT_TITLE
1860     maketitle();
1861 #endif
1862 	// when autocmds didn't change it
1863     if (curwin->w_topline == 1 && !curwin->w_topline_was_set)
1864 	scroll_cursor_halfway(FALSE);	// redisplay at correct position
1865 
1866 #ifdef FEAT_NETBEANS_INTG
1867     // Send fileOpened event because we've changed buffers.
1868     netbeans_file_activated(curbuf);
1869 #endif
1870 
1871     // Change directories when the 'acd' option is set.
1872     DO_AUTOCHDIR;
1873 
1874 #ifdef FEAT_KEYMAP
1875     if (curbuf->b_kmap_state & KEYMAP_INIT)
1876 	(void)keymap_init();
1877 #endif
1878 #ifdef FEAT_SPELL
1879     // May need to set the spell language.  Can only do this after the buffer
1880     // has been properly setup.
1881     if (!curbuf->b_help && curwin->w_p_spell && *curwin->w_s->b_p_spl != NUL)
1882 	(void)did_set_spelllang(curwin);
1883 #endif
1884 #ifdef FEAT_VIMINFO
1885     curbuf->b_last_used = vim_time();
1886 #endif
1887 
1888     redraw_later(NOT_VALID);
1889 }
1890 
1891 #if defined(FEAT_AUTOCHDIR) || defined(PROTO)
1892 /*
1893  * Change to the directory of the current buffer.
1894  * Don't do this while still starting up.
1895  */
1896     void
1897 do_autochdir(void)
1898 {
1899     if ((starting == 0 || test_autochdir)
1900 	    && curbuf->b_ffname != NULL
1901 	    && vim_chdirfile(curbuf->b_ffname, "auto") == OK)
1902 	shorten_fnames(TRUE);
1903 }
1904 #endif
1905 
1906     void
1907 no_write_message(void)
1908 {
1909 #ifdef FEAT_TERMINAL
1910     if (term_job_running(curbuf->b_term))
1911 	emsg(_("E948: Job still running (add ! to end the job)"));
1912     else
1913 #endif
1914 	emsg(_("E37: No write since last change (add ! to override)"));
1915 }
1916 
1917     void
1918 no_write_message_nobang(buf_T *buf UNUSED)
1919 {
1920 #ifdef FEAT_TERMINAL
1921     if (term_job_running(buf->b_term))
1922 	emsg(_("E948: Job still running"));
1923     else
1924 #endif
1925 	emsg(_("E37: No write since last change"));
1926 }
1927 
1928 /*
1929  * functions for dealing with the buffer list
1930  */
1931 
1932 /*
1933  * Return TRUE if the current buffer is empty, unnamed, unmodified and used in
1934  * only one window.  That means it can be re-used.
1935  */
1936     int
1937 curbuf_reusable(void)
1938 {
1939     return (curbuf != NULL
1940 	&& curbuf->b_ffname == NULL
1941 	&& curbuf->b_nwindows <= 1
1942 	&& (curbuf->b_ml.ml_mfp == NULL || BUFEMPTY())
1943 #if defined(FEAT_QUICKFIX)
1944 	&& !bt_quickfix(curbuf)
1945 #endif
1946 	&& !curbufIsChanged());
1947 }
1948 
1949 /*
1950  * Add a file name to the buffer list.  Return a pointer to the buffer.
1951  * If the same file name already exists return a pointer to that buffer.
1952  * If it does not exist, or if fname == NULL, a new entry is created.
1953  * If (flags & BLN_CURBUF) is TRUE, may use current buffer.
1954  * If (flags & BLN_LISTED) is TRUE, add new buffer to buffer list.
1955  * If (flags & BLN_DUMMY) is TRUE, don't count it as a real buffer.
1956  * If (flags & BLN_NEW) is TRUE, don't use an existing buffer.
1957  * If (flags & BLN_NOOPT) is TRUE, don't copy options from the current buffer
1958  *				    if the buffer already exists.
1959  * If (flags & BLN_REUSE) is TRUE, may use buffer number from "buf_reuse".
1960  * This is the ONLY way to create a new buffer.
1961  */
1962     buf_T *
1963 buflist_new(
1964     char_u	*ffname_arg,	// full path of fname or relative
1965     char_u	*sfname_arg,	// short fname or NULL
1966     linenr_T	lnum,		// preferred cursor line
1967     int		flags)		// BLN_ defines
1968 {
1969     char_u	*ffname = ffname_arg;
1970     char_u	*sfname = sfname_arg;
1971     buf_T	*buf;
1972 #ifdef UNIX
1973     stat_T	st;
1974 #endif
1975 
1976     if (top_file_num == 1)
1977 	hash_init(&buf_hashtab);
1978 
1979     fname_expand(curbuf, &ffname, &sfname);	// will allocate ffname
1980 
1981     /*
1982      * If file name already exists in the list, update the entry.
1983      */
1984 #ifdef UNIX
1985     // On Unix we can use inode numbers when the file exists.  Works better
1986     // for hard links.
1987     if (sfname == NULL || mch_stat((char *)sfname, &st) < 0)
1988 	st.st_dev = (dev_T)-1;
1989 #endif
1990     if (ffname != NULL && !(flags & (BLN_DUMMY | BLN_NEW)) && (buf =
1991 #ifdef UNIX
1992 		buflist_findname_stat(ffname, &st)
1993 #else
1994 		buflist_findname(ffname)
1995 #endif
1996 		) != NULL)
1997     {
1998 	vim_free(ffname);
1999 	if (lnum != 0)
2000 	    buflist_setfpos(buf, (flags & BLN_NOCURWIN) ? NULL : curwin,
2001 						      lnum, (colnr_T)0, FALSE);
2002 
2003 	if ((flags & BLN_NOOPT) == 0)
2004 	    // copy the options now, if 'cpo' doesn't have 's' and not done
2005 	    // already
2006 	    buf_copy_options(buf, 0);
2007 
2008 	if ((flags & BLN_LISTED) && !buf->b_p_bl)
2009 	{
2010 	    bufref_T bufref;
2011 
2012 	    buf->b_p_bl = TRUE;
2013 	    set_bufref(&bufref, buf);
2014 	    if (!(flags & BLN_DUMMY))
2015 	    {
2016 		if (apply_autocmds(EVENT_BUFADD, NULL, NULL, FALSE, buf)
2017 			&& !bufref_valid(&bufref))
2018 		    return NULL;
2019 	    }
2020 	}
2021 	return buf;
2022     }
2023 
2024     /*
2025      * If the current buffer has no name and no contents, use the current
2026      * buffer.	Otherwise: Need to allocate a new buffer structure.
2027      *
2028      * This is the ONLY place where a new buffer structure is allocated!
2029      * (A spell file buffer is allocated in spell.c, but that's not a normal
2030      * buffer.)
2031      */
2032     buf = NULL;
2033     if ((flags & BLN_CURBUF) && curbuf_reusable())
2034     {
2035 	buf = curbuf;
2036 	// It's like this buffer is deleted.  Watch out for autocommands that
2037 	// change curbuf!  If that happens, allocate a new buffer anyway.
2038 	if (curbuf->b_p_bl)
2039 	    apply_autocmds(EVENT_BUFDELETE, NULL, NULL, FALSE, curbuf);
2040 	if (buf == curbuf)
2041 	    apply_autocmds(EVENT_BUFWIPEOUT, NULL, NULL, FALSE, curbuf);
2042 #ifdef FEAT_EVAL
2043 	if (aborting())		// autocmds may abort script processing
2044 	{
2045 	    vim_free(ffname);
2046 	    return NULL;
2047 	}
2048 #endif
2049 	if (buf == curbuf)
2050 	{
2051 	    // Make sure 'bufhidden' and 'buftype' are empty
2052 	    clear_string_option(&buf->b_p_bh);
2053 	    clear_string_option(&buf->b_p_bt);
2054 	}
2055     }
2056     if (buf != curbuf || curbuf == NULL)
2057     {
2058 	buf = ALLOC_CLEAR_ONE(buf_T);
2059 	if (buf == NULL)
2060 	{
2061 	    vim_free(ffname);
2062 	    return NULL;
2063 	}
2064 #ifdef FEAT_EVAL
2065 	// init b: variables
2066 	buf->b_vars = dict_alloc();
2067 	if (buf->b_vars == NULL)
2068 	{
2069 	    vim_free(ffname);
2070 	    vim_free(buf);
2071 	    return NULL;
2072 	}
2073 	init_var_dict(buf->b_vars, &buf->b_bufvar, VAR_SCOPE);
2074 #endif
2075 	init_changedtick(buf);
2076     }
2077 
2078     if (ffname != NULL)
2079     {
2080 	buf->b_ffname = ffname;
2081 	buf->b_sfname = vim_strsave(sfname);
2082     }
2083 
2084     clear_wininfo(buf);
2085     buf->b_wininfo = ALLOC_CLEAR_ONE(wininfo_T);
2086 
2087     if ((ffname != NULL && (buf->b_ffname == NULL || buf->b_sfname == NULL))
2088 	    || buf->b_wininfo == NULL)
2089     {
2090 	if (buf->b_sfname != buf->b_ffname)
2091 	    VIM_CLEAR(buf->b_sfname);
2092 	else
2093 	    buf->b_sfname = NULL;
2094 	VIM_CLEAR(buf->b_ffname);
2095 	if (buf != curbuf)
2096 	    free_buffer(buf);
2097 	return NULL;
2098     }
2099 
2100     if (buf == curbuf)
2101     {
2102 	// free all things allocated for this buffer
2103 	buf_freeall(buf, 0);
2104 	if (buf != curbuf)	 // autocommands deleted the buffer!
2105 	    return NULL;
2106 #if defined(FEAT_EVAL)
2107 	if (aborting())		// autocmds may abort script processing
2108 	    return NULL;
2109 #endif
2110 	free_buffer_stuff(buf, FALSE);	// delete local variables et al.
2111 
2112 	// Init the options.
2113 	buf->b_p_initialized = FALSE;
2114 	buf_copy_options(buf, BCO_ENTER);
2115 
2116 #ifdef FEAT_KEYMAP
2117 	// need to reload lmaps and set b:keymap_name
2118 	curbuf->b_kmap_state |= KEYMAP_INIT;
2119 #endif
2120     }
2121     else
2122     {
2123 	/*
2124 	 * put new buffer at the end of the buffer list
2125 	 */
2126 	buf->b_next = NULL;
2127 	if (firstbuf == NULL)		// buffer list is empty
2128 	{
2129 	    buf->b_prev = NULL;
2130 	    firstbuf = buf;
2131 	}
2132 	else				// append new buffer at end of list
2133 	{
2134 	    lastbuf->b_next = buf;
2135 	    buf->b_prev = lastbuf;
2136 	}
2137 	lastbuf = buf;
2138 
2139 	if ((flags & BLN_REUSE) && buf_reuse.ga_len > 0)
2140 	{
2141 	    // Recycle a previously used buffer number.  Used for buffers which
2142 	    // are normally hidden, e.g. in a popup window.  Avoids that the
2143 	    // buffer number grows rapidly.
2144 	    --buf_reuse.ga_len;
2145 	    buf->b_fnum = ((int *)buf_reuse.ga_data)[buf_reuse.ga_len];
2146 
2147 	    // Move buffer to the right place in the buffer list.
2148 	    while (buf->b_prev != NULL && buf->b_fnum < buf->b_prev->b_fnum)
2149 	    {
2150 		buf_T	*prev = buf->b_prev;
2151 
2152 		prev->b_next = buf->b_next;
2153 		if (prev->b_next != NULL)
2154 		    prev->b_next->b_prev = prev;
2155 		buf->b_next = prev;
2156 		buf->b_prev = prev->b_prev;
2157 		if (buf->b_prev != NULL)
2158 		    buf->b_prev->b_next = buf;
2159 		prev->b_prev = buf;
2160 		if (lastbuf == buf)
2161 		    lastbuf = prev;
2162 		if (firstbuf == prev)
2163 		    firstbuf = buf;
2164 	    }
2165 	}
2166 	else
2167 	    buf->b_fnum = top_file_num++;
2168 	if (top_file_num < 0)		// wrap around (may cause duplicates)
2169 	{
2170 	    emsg(_("W14: Warning: List of file names overflow"));
2171 	    if (emsg_silent == 0 && !in_assert_fails)
2172 	    {
2173 		out_flush();
2174 		ui_delay(3001L, TRUE);	// make sure it is noticed
2175 	    }
2176 	    top_file_num = 1;
2177 	}
2178 	buf_hashtab_add(buf);
2179 
2180 	/*
2181 	 * Always copy the options from the current buffer.
2182 	 */
2183 	buf_copy_options(buf, BCO_ALWAYS);
2184     }
2185 
2186     buf->b_wininfo->wi_fpos.lnum = lnum;
2187     buf->b_wininfo->wi_win = curwin;
2188 
2189 #ifdef FEAT_SYN_HL
2190     hash_init(&buf->b_s.b_keywtab);
2191     hash_init(&buf->b_s.b_keywtab_ic);
2192 #endif
2193 
2194     buf->b_fname = buf->b_sfname;
2195 #ifdef UNIX
2196     if (st.st_dev == (dev_T)-1)
2197 	buf->b_dev_valid = FALSE;
2198     else
2199     {
2200 	buf->b_dev_valid = TRUE;
2201 	buf->b_dev = st.st_dev;
2202 	buf->b_ino = st.st_ino;
2203     }
2204 #endif
2205     buf->b_u_synced = TRUE;
2206     buf->b_flags = BF_CHECK_RO | BF_NEVERLOADED;
2207     if (flags & BLN_DUMMY)
2208 	buf->b_flags |= BF_DUMMY;
2209     buf_clear_file(buf);
2210     clrallmarks(buf);			// clear marks
2211     fmarks_check_names(buf);		// check file marks for this file
2212     buf->b_p_bl = (flags & BLN_LISTED) ? TRUE : FALSE;	// init 'buflisted'
2213     if (!(flags & BLN_DUMMY))
2214     {
2215 	bufref_T bufref;
2216 
2217 	// Tricky: these autocommands may change the buffer list.  They could
2218 	// also split the window with re-using the one empty buffer. This may
2219 	// result in unexpectedly losing the empty buffer.
2220 	set_bufref(&bufref, buf);
2221 	if (apply_autocmds(EVENT_BUFNEW, NULL, NULL, FALSE, buf)
2222 		&& !bufref_valid(&bufref))
2223 	    return NULL;
2224 	if (flags & BLN_LISTED)
2225 	{
2226 	    if (apply_autocmds(EVENT_BUFADD, NULL, NULL, FALSE, buf)
2227 		    && !bufref_valid(&bufref))
2228 		return NULL;
2229 	}
2230 #ifdef FEAT_EVAL
2231 	if (aborting())		// autocmds may abort script processing
2232 	    return NULL;
2233 #endif
2234     }
2235 
2236     return buf;
2237 }
2238 
2239 /*
2240  * Free the memory for the options of a buffer.
2241  * If "free_p_ff" is TRUE also free 'fileformat', 'buftype' and
2242  * 'fileencoding'.
2243  */
2244     void
2245 free_buf_options(
2246     buf_T	*buf,
2247     int		free_p_ff)
2248 {
2249     if (free_p_ff)
2250     {
2251 	clear_string_option(&buf->b_p_fenc);
2252 	clear_string_option(&buf->b_p_ff);
2253 	clear_string_option(&buf->b_p_bh);
2254 	clear_string_option(&buf->b_p_bt);
2255     }
2256 #ifdef FEAT_FIND_ID
2257     clear_string_option(&buf->b_p_def);
2258     clear_string_option(&buf->b_p_inc);
2259 # ifdef FEAT_EVAL
2260     clear_string_option(&buf->b_p_inex);
2261 # endif
2262 #endif
2263 #if defined(FEAT_CINDENT) && defined(FEAT_EVAL)
2264     clear_string_option(&buf->b_p_inde);
2265     clear_string_option(&buf->b_p_indk);
2266 #endif
2267 #if defined(FEAT_BEVAL) && defined(FEAT_EVAL)
2268     clear_string_option(&buf->b_p_bexpr);
2269 #endif
2270 #if defined(FEAT_CRYPT)
2271     clear_string_option(&buf->b_p_cm);
2272 #endif
2273     clear_string_option(&buf->b_p_fp);
2274 #if defined(FEAT_EVAL)
2275     clear_string_option(&buf->b_p_fex);
2276 #endif
2277 #ifdef FEAT_CRYPT
2278     clear_string_option(&buf->b_p_key);
2279 #endif
2280     clear_string_option(&buf->b_p_kp);
2281     clear_string_option(&buf->b_p_mps);
2282     clear_string_option(&buf->b_p_fo);
2283     clear_string_option(&buf->b_p_flp);
2284     clear_string_option(&buf->b_p_isk);
2285 #ifdef FEAT_VARTABS
2286     clear_string_option(&buf->b_p_vsts);
2287     vim_free(buf->b_p_vsts_nopaste);
2288     buf->b_p_vsts_nopaste = NULL;
2289     vim_free(buf->b_p_vsts_array);
2290     buf->b_p_vsts_array = NULL;
2291     clear_string_option(&buf->b_p_vts);
2292     VIM_CLEAR(buf->b_p_vts_array);
2293 #endif
2294 #ifdef FEAT_KEYMAP
2295     clear_string_option(&buf->b_p_keymap);
2296     keymap_clear(&buf->b_kmap_ga);
2297     ga_clear(&buf->b_kmap_ga);
2298 #endif
2299     clear_string_option(&buf->b_p_com);
2300 #ifdef FEAT_FOLDING
2301     clear_string_option(&buf->b_p_cms);
2302 #endif
2303     clear_string_option(&buf->b_p_nf);
2304 #ifdef FEAT_SYN_HL
2305     clear_string_option(&buf->b_p_syn);
2306     clear_string_option(&buf->b_s.b_syn_isk);
2307 #endif
2308 #ifdef FEAT_SPELL
2309     clear_string_option(&buf->b_s.b_p_spc);
2310     clear_string_option(&buf->b_s.b_p_spf);
2311     vim_regfree(buf->b_s.b_cap_prog);
2312     buf->b_s.b_cap_prog = NULL;
2313     clear_string_option(&buf->b_s.b_p_spl);
2314     clear_string_option(&buf->b_s.b_p_spo);
2315 #endif
2316 #ifdef FEAT_SEARCHPATH
2317     clear_string_option(&buf->b_p_sua);
2318 #endif
2319     clear_string_option(&buf->b_p_ft);
2320 #ifdef FEAT_CINDENT
2321     clear_string_option(&buf->b_p_cink);
2322     clear_string_option(&buf->b_p_cino);
2323 #endif
2324 #if defined(FEAT_CINDENT) || defined(FEAT_SMARTINDENT)
2325     clear_string_option(&buf->b_p_cinw);
2326 #endif
2327     clear_string_option(&buf->b_p_cpt);
2328 #ifdef FEAT_COMPL_FUNC
2329     clear_string_option(&buf->b_p_cfu);
2330     clear_string_option(&buf->b_p_ofu);
2331 #endif
2332 #ifdef FEAT_QUICKFIX
2333     clear_string_option(&buf->b_p_gp);
2334     clear_string_option(&buf->b_p_mp);
2335     clear_string_option(&buf->b_p_efm);
2336 #endif
2337     clear_string_option(&buf->b_p_ep);
2338     clear_string_option(&buf->b_p_path);
2339     clear_string_option(&buf->b_p_tags);
2340     clear_string_option(&buf->b_p_tc);
2341 #ifdef FEAT_EVAL
2342     clear_string_option(&buf->b_p_tfu);
2343 #endif
2344     clear_string_option(&buf->b_p_dict);
2345     clear_string_option(&buf->b_p_tsr);
2346 #ifdef FEAT_TEXTOBJ
2347     clear_string_option(&buf->b_p_qe);
2348 #endif
2349     buf->b_p_ar = -1;
2350     buf->b_p_ul = NO_LOCAL_UNDOLEVEL;
2351 #ifdef FEAT_LISP
2352     clear_string_option(&buf->b_p_lw);
2353 #endif
2354     clear_string_option(&buf->b_p_bkc);
2355     clear_string_option(&buf->b_p_menc);
2356 }
2357 
2358 /*
2359  * Get alternate file "n".
2360  * Set linenr to "lnum" or altfpos.lnum if "lnum" == 0.
2361  *	Also set cursor column to altfpos.col if 'startofline' is not set.
2362  * if (options & GETF_SETMARK) call setpcmark()
2363  * if (options & GETF_ALT) we are jumping to an alternate file.
2364  * if (options & GETF_SWITCH) respect 'switchbuf' settings when jumping
2365  *
2366  * Return FAIL for failure, OK for success.
2367  */
2368     int
2369 buflist_getfile(
2370     int		n,
2371     linenr_T	lnum,
2372     int		options,
2373     int		forceit)
2374 {
2375     buf_T	*buf;
2376     win_T	*wp = NULL;
2377     pos_T	*fpos;
2378     colnr_T	col;
2379 
2380     buf = buflist_findnr(n);
2381     if (buf == NULL)
2382     {
2383 	if ((options & GETF_ALT) && n == 0)
2384 	    emsg(_(e_noalt));
2385 	else
2386 	    semsg(_("E92: Buffer %d not found"), n);
2387 	return FAIL;
2388     }
2389 
2390     // if alternate file is the current buffer, nothing to do
2391     if (buf == curbuf)
2392 	return OK;
2393 
2394     if (text_locked())
2395     {
2396 	text_locked_msg();
2397 	return FAIL;
2398     }
2399     if (curbuf_locked())
2400 	return FAIL;
2401 
2402     // altfpos may be changed by getfile(), get it now
2403     if (lnum == 0)
2404     {
2405 	fpos = buflist_findfpos(buf);
2406 	lnum = fpos->lnum;
2407 	col = fpos->col;
2408     }
2409     else
2410 	col = 0;
2411 
2412     if (options & GETF_SWITCH)
2413     {
2414 	// If 'switchbuf' contains "useopen": jump to first window containing
2415 	// "buf" if one exists
2416 	if (swb_flags & SWB_USEOPEN)
2417 	    wp = buf_jump_open_win(buf);
2418 
2419 	// If 'switchbuf' contains "usetab": jump to first window in any tab
2420 	// page containing "buf" if one exists
2421 	if (wp == NULL && (swb_flags & SWB_USETAB))
2422 	    wp = buf_jump_open_tab(buf);
2423 
2424 	// If 'switchbuf' contains "split", "vsplit" or "newtab" and the
2425 	// current buffer isn't empty: open new tab or window
2426 	if (wp == NULL && (swb_flags & (SWB_VSPLIT | SWB_SPLIT | SWB_NEWTAB))
2427 							       && !BUFEMPTY())
2428 	{
2429 	    if (swb_flags & SWB_NEWTAB)
2430 		tabpage_new();
2431 	    else if (win_split(0, (swb_flags & SWB_VSPLIT) ? WSP_VERT : 0)
2432 								      == FAIL)
2433 		return FAIL;
2434 	    RESET_BINDING(curwin);
2435 	}
2436     }
2437 
2438     ++RedrawingDisabled;
2439     if (GETFILE_SUCCESS(getfile(buf->b_fnum, NULL, NULL,
2440 				     (options & GETF_SETMARK), lnum, forceit)))
2441     {
2442 	--RedrawingDisabled;
2443 
2444 	// cursor is at to BOL and w_cursor.lnum is checked due to getfile()
2445 	if (!p_sol && col != 0)
2446 	{
2447 	    curwin->w_cursor.col = col;
2448 	    check_cursor_col();
2449 	    curwin->w_cursor.coladd = 0;
2450 	    curwin->w_set_curswant = TRUE;
2451 	}
2452 	return OK;
2453     }
2454     --RedrawingDisabled;
2455     return FAIL;
2456 }
2457 
2458 /*
2459  * go to the last know line number for the current buffer
2460  */
2461     static void
2462 buflist_getfpos(void)
2463 {
2464     pos_T	*fpos;
2465 
2466     fpos = buflist_findfpos(curbuf);
2467 
2468     curwin->w_cursor.lnum = fpos->lnum;
2469     check_cursor_lnum();
2470 
2471     if (p_sol)
2472 	curwin->w_cursor.col = 0;
2473     else
2474     {
2475 	curwin->w_cursor.col = fpos->col;
2476 	check_cursor_col();
2477 	curwin->w_cursor.coladd = 0;
2478 	curwin->w_set_curswant = TRUE;
2479     }
2480 }
2481 
2482 #if defined(FEAT_QUICKFIX) || defined(FEAT_EVAL) || defined(PROTO)
2483 /*
2484  * Find file in buffer list by name (it has to be for the current window).
2485  * Returns NULL if not found.
2486  */
2487     buf_T *
2488 buflist_findname_exp(char_u *fname)
2489 {
2490     char_u	*ffname;
2491     buf_T	*buf = NULL;
2492 
2493     // First make the name into a full path name
2494     ffname = FullName_save(fname,
2495 #ifdef UNIX
2496 	    TRUE	    // force expansion, get rid of symbolic links
2497 #else
2498 	    FALSE
2499 #endif
2500 	    );
2501     if (ffname != NULL)
2502     {
2503 	buf = buflist_findname(ffname);
2504 	vim_free(ffname);
2505     }
2506     return buf;
2507 }
2508 #endif
2509 
2510 /*
2511  * Find file in buffer list by name (it has to be for the current window).
2512  * "ffname" must have a full path.
2513  * Skips dummy buffers.
2514  * Returns NULL if not found.
2515  */
2516     buf_T *
2517 buflist_findname(char_u *ffname)
2518 {
2519 #ifdef UNIX
2520     stat_T	st;
2521 
2522     if (mch_stat((char *)ffname, &st) < 0)
2523 	st.st_dev = (dev_T)-1;
2524     return buflist_findname_stat(ffname, &st);
2525 }
2526 
2527 /*
2528  * Same as buflist_findname(), but pass the stat structure to avoid getting it
2529  * twice for the same file.
2530  * Returns NULL if not found.
2531  */
2532     static buf_T *
2533 buflist_findname_stat(
2534     char_u	*ffname,
2535     stat_T	*stp)
2536 {
2537 #endif
2538     buf_T	*buf;
2539 
2540     // Start at the last buffer, expect to find a match sooner.
2541     FOR_ALL_BUFS_FROM_LAST(buf)
2542 	if ((buf->b_flags & BF_DUMMY) == 0 && !otherfile_buf(buf, ffname
2543 #ifdef UNIX
2544 		    , stp
2545 #endif
2546 		    ))
2547 	    return buf;
2548     return NULL;
2549 }
2550 
2551 /*
2552  * Find file in buffer list by a regexp pattern.
2553  * Return fnum of the found buffer.
2554  * Return < 0 for error.
2555  */
2556     int
2557 buflist_findpat(
2558     char_u	*pattern,
2559     char_u	*pattern_end,	// pointer to first char after pattern
2560     int		unlisted,	// find unlisted buffers
2561     int		diffmode UNUSED, // find diff-mode buffers only
2562     int		curtab_only)	// find buffers in current tab only
2563 {
2564     buf_T	*buf;
2565     int		match = -1;
2566     int		find_listed;
2567     char_u	*pat;
2568     char_u	*patend;
2569     int		attempt;
2570     char_u	*p;
2571     int		toggledollar;
2572 
2573     // "%" is current file, "%%" or "#" is alternate file
2574     if ((pattern_end == pattern + 1 && (*pattern == '%' || *pattern == '#'))
2575 	    || (in_vim9script() && pattern_end == pattern + 2
2576 				    && pattern[0] == '%' && pattern[1] == '%'))
2577     {
2578 	if (*pattern == '#' || pattern_end == pattern + 2)
2579 	    match = curwin->w_alt_fnum;
2580 	else
2581 	    match = curbuf->b_fnum;
2582 #ifdef FEAT_DIFF
2583 	if (diffmode && !diff_mode_buf(buflist_findnr(match)))
2584 	    match = -1;
2585 #endif
2586     }
2587 
2588     /*
2589      * Try four ways of matching a listed buffer:
2590      * attempt == 0: without '^' or '$' (at any position)
2591      * attempt == 1: with '^' at start (only at position 0)
2592      * attempt == 2: with '$' at end (only match at end)
2593      * attempt == 3: with '^' at start and '$' at end (only full match)
2594      * Repeat this for finding an unlisted buffer if there was no matching
2595      * listed buffer.
2596      */
2597     else
2598     {
2599 	pat = file_pat_to_reg_pat(pattern, pattern_end, NULL, FALSE);
2600 	if (pat == NULL)
2601 	    return -1;
2602 	patend = pat + STRLEN(pat) - 1;
2603 	toggledollar = (patend > pat && *patend == '$');
2604 
2605 	// First try finding a listed buffer.  If not found and "unlisted"
2606 	// is TRUE, try finding an unlisted buffer.
2607 	find_listed = TRUE;
2608 	for (;;)
2609 	{
2610 	    for (attempt = 0; attempt <= 3; ++attempt)
2611 	    {
2612 		regmatch_T	regmatch;
2613 
2614 		// may add '^' and '$'
2615 		if (toggledollar)
2616 		    *patend = (attempt < 2) ? NUL : '$'; // add/remove '$'
2617 		p = pat;
2618 		if (*p == '^' && !(attempt & 1))	 // add/remove '^'
2619 		    ++p;
2620 		regmatch.regprog = vim_regcomp(p, magic_isset() ? RE_MAGIC : 0);
2621 		if (regmatch.regprog == NULL)
2622 		{
2623 		    vim_free(pat);
2624 		    return -1;
2625 		}
2626 
2627 		FOR_ALL_BUFS_FROM_LAST(buf)
2628 		    if (buf->b_p_bl == find_listed
2629 #ifdef FEAT_DIFF
2630 			    && (!diffmode || diff_mode_buf(buf))
2631 #endif
2632 			    && buflist_match(&regmatch, buf, FALSE) != NULL)
2633 		    {
2634 			if (curtab_only)
2635 			{
2636 			    // Ignore the match if the buffer is not open in
2637 			    // the current tab.
2638 			    win_T	*wp;
2639 
2640 			    FOR_ALL_WINDOWS(wp)
2641 				if (wp->w_buffer == buf)
2642 				    break;
2643 			    if (wp == NULL)
2644 				continue;
2645 			}
2646 			if (match >= 0)		// already found a match
2647 			{
2648 			    match = -2;
2649 			    break;
2650 			}
2651 			match = buf->b_fnum;	// remember first match
2652 		    }
2653 
2654 		vim_regfree(regmatch.regprog);
2655 		if (match >= 0)			// found one match
2656 		    break;
2657 	    }
2658 
2659 	    // Only search for unlisted buffers if there was no match with
2660 	    // a listed buffer.
2661 	    if (!unlisted || !find_listed || match != -1)
2662 		break;
2663 	    find_listed = FALSE;
2664 	}
2665 
2666 	vim_free(pat);
2667     }
2668 
2669     if (match == -2)
2670 	semsg(_("E93: More than one match for %s"), pattern);
2671     else if (match < 0)
2672 	semsg(_("E94: No matching buffer for %s"), pattern);
2673     return match;
2674 }
2675 
2676 #ifdef FEAT_VIMINFO
2677 typedef struct {
2678     buf_T   *buf;
2679     char_u  *match;
2680 } bufmatch_T;
2681 #endif
2682 
2683 /*
2684  * Find all buffer names that match.
2685  * For command line expansion of ":buf" and ":sbuf".
2686  * Return OK if matches found, FAIL otherwise.
2687  */
2688     int
2689 ExpandBufnames(
2690     char_u	*pat,
2691     int		*num_file,
2692     char_u	***file,
2693     int		options)
2694 {
2695     int		count = 0;
2696     buf_T	*buf;
2697     int		round;
2698     char_u	*p;
2699     int		attempt;
2700     char_u	*patc;
2701 #ifdef FEAT_VIMINFO
2702     bufmatch_T	*matches = NULL;
2703 #endif
2704 
2705     *num_file = 0;		    // return values in case of FAIL
2706     *file = NULL;
2707 
2708 #ifdef FEAT_DIFF
2709     if ((options & BUF_DIFF_FILTER) && !curwin->w_p_diff)
2710 	return FAIL;
2711 #endif
2712 
2713     // Make a copy of "pat" and change "^" to "\(^\|[\/]\)".
2714     if (*pat == '^')
2715     {
2716 	patc = alloc(STRLEN(pat) + 11);
2717 	if (patc == NULL)
2718 	    return FAIL;
2719 	STRCPY(patc, "\\(^\\|[\\/]\\)");
2720 	STRCPY(patc + 11, pat + 1);
2721     }
2722     else
2723 	patc = pat;
2724 
2725     /*
2726      * attempt == 0: try match with    '\<', match at start of word
2727      * attempt == 1: try match without '\<', match anywhere
2728      */
2729     for (attempt = 0; attempt <= 1; ++attempt)
2730     {
2731 	regmatch_T	regmatch;
2732 
2733 	if (attempt > 0 && patc == pat)
2734 	    break;	// there was no anchor, no need to try again
2735 	regmatch.regprog = vim_regcomp(patc + attempt * 11, RE_MAGIC);
2736 	if (regmatch.regprog == NULL)
2737 	{
2738 	    if (patc != pat)
2739 		vim_free(patc);
2740 	    return FAIL;
2741 	}
2742 
2743 	/*
2744 	 * round == 1: Count the matches.
2745 	 * round == 2: Build the array to keep the matches.
2746 	 */
2747 	for (round = 1; round <= 2; ++round)
2748 	{
2749 	    count = 0;
2750 	    FOR_ALL_BUFFERS(buf)
2751 	    {
2752 		if (!buf->b_p_bl)	// skip unlisted buffers
2753 		    continue;
2754 #ifdef FEAT_DIFF
2755 		if (options & BUF_DIFF_FILTER)
2756 		    // Skip buffers not suitable for
2757 		    // :diffget or :diffput completion.
2758 		    if (buf == curbuf || !diff_mode_buf(buf))
2759 			continue;
2760 #endif
2761 
2762 		p = buflist_match(&regmatch, buf, p_wic);
2763 		if (p != NULL)
2764 		{
2765 		    if (round == 1)
2766 			++count;
2767 		    else
2768 		    {
2769 			if (options & WILD_HOME_REPLACE)
2770 			    p = home_replace_save(buf, p);
2771 			else
2772 			    p = vim_strsave(p);
2773 #ifdef FEAT_VIMINFO
2774 			if (matches != NULL)
2775 			{
2776 			    matches[count].buf = buf;
2777 			    matches[count].match = p;
2778 			    count++;
2779 			}
2780 			else
2781 #endif
2782 			    (*file)[count++] = p;
2783 		    }
2784 		}
2785 	    }
2786 	    if (count == 0)	// no match found, break here
2787 		break;
2788 	    if (round == 1)
2789 	    {
2790 		*file = ALLOC_MULT(char_u *, count);
2791 		if (*file == NULL)
2792 		{
2793 		    vim_regfree(regmatch.regprog);
2794 		    if (patc != pat)
2795 			vim_free(patc);
2796 		    return FAIL;
2797 		}
2798 #ifdef FEAT_VIMINFO
2799 		if (options & WILD_BUFLASTUSED)
2800 		    matches = ALLOC_MULT(bufmatch_T, count);
2801 #endif
2802 	    }
2803 	}
2804 	vim_regfree(regmatch.regprog);
2805 	if (count)		// match(es) found, break here
2806 	    break;
2807     }
2808 
2809     if (patc != pat)
2810 	vim_free(patc);
2811 
2812 #ifdef FEAT_VIMINFO
2813     if (matches != NULL)
2814     {
2815 	int i;
2816 	if (count > 1)
2817 	    qsort(matches, count, sizeof(bufmatch_T), buf_compare);
2818 	// if the current buffer is first in the list, place it at the end
2819 	if (matches[0].buf == curbuf)
2820 	{
2821 	    for (i = 1; i < count; i++)
2822 		(*file)[i-1] = matches[i].match;
2823 	    (*file)[count-1] = matches[0].match;
2824 	}
2825 	else
2826 	{
2827 	    for (i = 0; i < count; i++)
2828 		(*file)[i] = matches[i].match;
2829 	}
2830 	vim_free(matches);
2831     }
2832 #endif
2833 
2834     *num_file = count;
2835     return (count == 0 ? FAIL : OK);
2836 }
2837 
2838 /*
2839  * Check for a match on the file name for buffer "buf" with regprog "prog".
2840  */
2841     static char_u *
2842 buflist_match(
2843     regmatch_T	*rmp,
2844     buf_T	*buf,
2845     int		ignore_case)  // when TRUE ignore case, when FALSE use 'fic'
2846 {
2847     char_u	*match;
2848 
2849     // First try the short file name, then the long file name.
2850     match = fname_match(rmp, buf->b_sfname, ignore_case);
2851     if (match == NULL)
2852 	match = fname_match(rmp, buf->b_ffname, ignore_case);
2853 
2854     return match;
2855 }
2856 
2857 /*
2858  * Try matching the regexp in "prog" with file name "name".
2859  * Return "name" when there is a match, NULL when not.
2860  */
2861     static char_u *
2862 fname_match(
2863     regmatch_T	*rmp,
2864     char_u	*name,
2865     int		ignore_case)  // when TRUE ignore case, when FALSE use 'fic'
2866 {
2867     char_u	*match = NULL;
2868     char_u	*p;
2869 
2870     if (name != NULL)
2871     {
2872 	// Ignore case when 'fileignorecase' or the argument is set.
2873 	rmp->rm_ic = p_fic || ignore_case;
2874 	if (vim_regexec(rmp, name, (colnr_T)0))
2875 	    match = name;
2876 	else
2877 	{
2878 	    // Replace $(HOME) with '~' and try matching again.
2879 	    p = home_replace_save(NULL, name);
2880 	    if (p != NULL && vim_regexec(rmp, p, (colnr_T)0))
2881 		match = name;
2882 	    vim_free(p);
2883 	}
2884     }
2885 
2886     return match;
2887 }
2888 
2889 /*
2890  * Find a file in the buffer list by buffer number.
2891  */
2892     buf_T *
2893 buflist_findnr(int nr)
2894 {
2895     char_u	key[VIM_SIZEOF_INT * 2 + 1];
2896     hashitem_T	*hi;
2897 
2898     if (nr == 0)
2899 	nr = curwin->w_alt_fnum;
2900     sprintf((char *)key, "%x", nr);
2901     hi = hash_find(&buf_hashtab, key);
2902 
2903     if (!HASHITEM_EMPTY(hi))
2904 	return (buf_T *)(hi->hi_key
2905 			     - ((unsigned)(curbuf->b_key - (char_u *)curbuf)));
2906     return NULL;
2907 }
2908 
2909 /*
2910  * Get name of file 'n' in the buffer list.
2911  * When the file has no name an empty string is returned.
2912  * home_replace() is used to shorten the file name (used for marks).
2913  * Returns a pointer to allocated memory, of NULL when failed.
2914  */
2915     char_u *
2916 buflist_nr2name(
2917     int		n,
2918     int		fullname,
2919     int		helptail)	// for help buffers return tail only
2920 {
2921     buf_T	*buf;
2922 
2923     buf = buflist_findnr(n);
2924     if (buf == NULL)
2925 	return NULL;
2926     return home_replace_save(helptail ? buf : NULL,
2927 				     fullname ? buf->b_ffname : buf->b_fname);
2928 }
2929 
2930 /*
2931  * Set the "lnum" and "col" for the buffer "buf" and the current window.
2932  * When "copy_options" is TRUE save the local window option values.
2933  * When "lnum" is 0 only do the options.
2934  */
2935     void
2936 buflist_setfpos(
2937     buf_T	*buf,
2938     win_T	*win,		// may be NULL when using :badd
2939     linenr_T	lnum,
2940     colnr_T	col,
2941     int		copy_options)
2942 {
2943     wininfo_T	*wip;
2944 
2945     FOR_ALL_BUF_WININFO(buf, wip)
2946 	if (wip->wi_win == win)
2947 	    break;
2948     if (wip == NULL)
2949     {
2950 	// allocate a new entry
2951 	wip = ALLOC_CLEAR_ONE(wininfo_T);
2952 	if (wip == NULL)
2953 	    return;
2954 	wip->wi_win = win;
2955 	if (lnum == 0)		// set lnum even when it's 0
2956 	    lnum = 1;
2957     }
2958     else
2959     {
2960 	// remove the entry from the list
2961 	if (wip->wi_prev)
2962 	    wip->wi_prev->wi_next = wip->wi_next;
2963 	else
2964 	    buf->b_wininfo = wip->wi_next;
2965 	if (wip->wi_next)
2966 	    wip->wi_next->wi_prev = wip->wi_prev;
2967 	if (copy_options && wip->wi_optset)
2968 	{
2969 	    clear_winopt(&wip->wi_opt);
2970 #ifdef FEAT_FOLDING
2971 	    deleteFoldRecurse(&wip->wi_folds);
2972 #endif
2973 	}
2974     }
2975     if (lnum != 0)
2976     {
2977 	wip->wi_fpos.lnum = lnum;
2978 	wip->wi_fpos.col = col;
2979     }
2980     if (copy_options && win != NULL)
2981     {
2982 	// Save the window-specific option values.
2983 	copy_winopt(&win->w_onebuf_opt, &wip->wi_opt);
2984 #ifdef FEAT_FOLDING
2985 	wip->wi_fold_manual = win->w_fold_manual;
2986 	cloneFoldGrowArray(&win->w_folds, &wip->wi_folds);
2987 #endif
2988 	wip->wi_optset = TRUE;
2989     }
2990 
2991     // insert the entry in front of the list
2992     wip->wi_next = buf->b_wininfo;
2993     buf->b_wininfo = wip;
2994     wip->wi_prev = NULL;
2995     if (wip->wi_next)
2996 	wip->wi_next->wi_prev = wip;
2997 
2998     return;
2999 }
3000 
3001 #ifdef FEAT_DIFF
3002 /*
3003  * Return TRUE when "wip" has 'diff' set and the diff is only for another tab
3004  * page.  That's because a diff is local to a tab page.
3005  */
3006     static int
3007 wininfo_other_tab_diff(wininfo_T *wip)
3008 {
3009     win_T	*wp;
3010 
3011     if (wip->wi_opt.wo_diff)
3012     {
3013 	FOR_ALL_WINDOWS(wp)
3014 	    // return FALSE when it's a window in the current tab page, thus
3015 	    // the buffer was in diff mode here
3016 	    if (wip->wi_win == wp)
3017 		return FALSE;
3018 	return TRUE;
3019     }
3020     return FALSE;
3021 }
3022 #endif
3023 
3024 /*
3025  * Find info for the current window in buffer "buf".
3026  * If not found, return the info for the most recently used window.
3027  * When "need_options" is TRUE skip entries where wi_optset is FALSE.
3028  * When "skip_diff_buffer" is TRUE avoid windows with 'diff' set that is in
3029  * another tab page.
3030  * Returns NULL when there isn't any info.
3031  */
3032     static wininfo_T *
3033 find_wininfo(
3034     buf_T	*buf,
3035     int		need_options,
3036     int		skip_diff_buffer UNUSED)
3037 {
3038     wininfo_T	*wip;
3039 
3040     FOR_ALL_BUF_WININFO(buf, wip)
3041 	if (wip->wi_win == curwin
3042 #ifdef FEAT_DIFF
3043 		&& (!skip_diff_buffer || !wininfo_other_tab_diff(wip))
3044 #endif
3045 
3046 		&& (!need_options || wip->wi_optset))
3047 	    break;
3048 
3049     // If no wininfo for curwin, use the first in the list (that doesn't have
3050     // 'diff' set and is in another tab page).
3051     // If "need_options" is TRUE skip entries that don't have options set,
3052     // unless the window is editing "buf", so we can copy from the window
3053     // itself.
3054     if (wip == NULL)
3055     {
3056 #ifdef FEAT_DIFF
3057 	if (skip_diff_buffer)
3058 	{
3059 	    FOR_ALL_BUF_WININFO(buf, wip)
3060 		if (!wininfo_other_tab_diff(wip)
3061 			&& (!need_options || wip->wi_optset
3062 			    || (wip->wi_win != NULL
3063 					     && wip->wi_win->w_buffer == buf)))
3064 		    break;
3065 	}
3066 	else
3067 #endif
3068 	    wip = buf->b_wininfo;
3069     }
3070     return wip;
3071 }
3072 
3073 /*
3074  * Reset the local window options to the values last used in this window.
3075  * If the buffer wasn't used in this window before, use the values from
3076  * the most recently used window.  If the values were never set, use the
3077  * global values for the window.
3078  */
3079     void
3080 get_winopts(buf_T *buf)
3081 {
3082     wininfo_T	*wip;
3083 
3084     clear_winopt(&curwin->w_onebuf_opt);
3085 #ifdef FEAT_FOLDING
3086     clearFolding(curwin);
3087 #endif
3088 
3089     wip = find_wininfo(buf, TRUE, TRUE);
3090     if (wip != NULL && wip->wi_win != NULL
3091 	    && wip->wi_win != curwin && wip->wi_win->w_buffer == buf)
3092     {
3093 	// The buffer is currently displayed in the window: use the actual
3094 	// option values instead of the saved (possibly outdated) values.
3095 	win_T *wp = wip->wi_win;
3096 
3097 	copy_winopt(&wp->w_onebuf_opt, &curwin->w_onebuf_opt);
3098 #ifdef FEAT_FOLDING
3099 	curwin->w_fold_manual = wp->w_fold_manual;
3100 	curwin->w_foldinvalid = TRUE;
3101 	cloneFoldGrowArray(&wp->w_folds, &curwin->w_folds);
3102 #endif
3103     }
3104     else if (wip != NULL && wip->wi_optset)
3105     {
3106 	// the buffer was displayed in the current window earlier
3107 	copy_winopt(&wip->wi_opt, &curwin->w_onebuf_opt);
3108 #ifdef FEAT_FOLDING
3109 	curwin->w_fold_manual = wip->wi_fold_manual;
3110 	curwin->w_foldinvalid = TRUE;
3111 	cloneFoldGrowArray(&wip->wi_folds, &curwin->w_folds);
3112 #endif
3113     }
3114     else
3115 	copy_winopt(&curwin->w_allbuf_opt, &curwin->w_onebuf_opt);
3116 
3117 #ifdef FEAT_FOLDING
3118     // Set 'foldlevel' to 'foldlevelstart' if it's not negative.
3119     if (p_fdls >= 0)
3120 	curwin->w_p_fdl = p_fdls;
3121 #endif
3122     after_copy_winopt(curwin);
3123 }
3124 
3125 /*
3126  * Find the position (lnum and col) for the buffer 'buf' for the current
3127  * window.
3128  * Returns a pointer to no_position if no position is found.
3129  */
3130     pos_T *
3131 buflist_findfpos(buf_T *buf)
3132 {
3133     wininfo_T	*wip;
3134     static pos_T no_position = {1, 0, 0};
3135 
3136     wip = find_wininfo(buf, FALSE, FALSE);
3137     if (wip != NULL)
3138 	return &(wip->wi_fpos);
3139     else
3140 	return &no_position;
3141 }
3142 
3143 /*
3144  * Find the lnum for the buffer 'buf' for the current window.
3145  */
3146     linenr_T
3147 buflist_findlnum(buf_T *buf)
3148 {
3149     return buflist_findfpos(buf)->lnum;
3150 }
3151 
3152 /*
3153  * List all known file names (for :files and :buffers command).
3154  */
3155     void
3156 buflist_list(exarg_T *eap)
3157 {
3158     buf_T	*buf = firstbuf;
3159     int		len;
3160     int		i;
3161     int		ro_char;
3162     int		changed_char;
3163 #ifdef FEAT_TERMINAL
3164     int		job_running;
3165     int		job_none_open;
3166 #endif
3167 
3168 #ifdef FEAT_VIMINFO
3169     garray_T	buflist;
3170     buf_T	**buflist_data = NULL, **p;
3171 
3172     if (vim_strchr(eap->arg, 't'))
3173     {
3174 	ga_init2(&buflist, sizeof(buf_T *), 50);
3175 	FOR_ALL_BUFFERS(buf)
3176 	{
3177 	    if (ga_grow(&buflist, 1) == OK)
3178 		((buf_T **)buflist.ga_data)[buflist.ga_len++] = buf;
3179 	}
3180 
3181 	qsort(buflist.ga_data, (size_t)buflist.ga_len,
3182 		sizeof(buf_T *), buf_compare);
3183 
3184 	buflist_data = (buf_T **)buflist.ga_data;
3185 	buf = *buflist_data;
3186     }
3187     p = buflist_data;
3188 
3189     for (; buf != NULL && !got_int; buf = buflist_data != NULL
3190 	    ? (++p < buflist_data + buflist.ga_len ? *p : NULL)
3191 	    : buf->b_next)
3192 #else
3193     for (buf = firstbuf; buf != NULL && !got_int; buf = buf->b_next)
3194 #endif
3195     {
3196 #ifdef FEAT_TERMINAL
3197 	job_running = term_job_running(buf->b_term);
3198 	job_none_open = job_running && term_none_open(buf->b_term);
3199 #endif
3200 	// skip unlisted buffers, unless ! was used
3201 	if ((!buf->b_p_bl && !eap->forceit && !vim_strchr(eap->arg, 'u'))
3202 		|| (vim_strchr(eap->arg, 'u') && buf->b_p_bl)
3203 		|| (vim_strchr(eap->arg, '+')
3204 			&& ((buf->b_flags & BF_READERR) || !bufIsChanged(buf)))
3205 		|| (vim_strchr(eap->arg, 'a')
3206 			&& (buf->b_ml.ml_mfp == NULL || buf->b_nwindows == 0))
3207 		|| (vim_strchr(eap->arg, 'h')
3208 			&& (buf->b_ml.ml_mfp == NULL || buf->b_nwindows != 0))
3209 #ifdef FEAT_TERMINAL
3210 		|| (vim_strchr(eap->arg, 'R')
3211 			&& (!job_running || (job_running && job_none_open)))
3212 		|| (vim_strchr(eap->arg, '?')
3213 			&& (!job_running || (job_running && !job_none_open)))
3214 		|| (vim_strchr(eap->arg, 'F')
3215 			&& (job_running || buf->b_term == NULL))
3216 #endif
3217 		|| (vim_strchr(eap->arg, '-') && buf->b_p_ma)
3218 		|| (vim_strchr(eap->arg, '=') && !buf->b_p_ro)
3219 		|| (vim_strchr(eap->arg, 'x') && !(buf->b_flags & BF_READERR))
3220 		|| (vim_strchr(eap->arg, '%') && buf != curbuf)
3221 		|| (vim_strchr(eap->arg, '#')
3222 		      && (buf == curbuf || curwin->w_alt_fnum != buf->b_fnum)))
3223 	    continue;
3224 	if (buf_spname(buf) != NULL)
3225 	    vim_strncpy(NameBuff, buf_spname(buf), MAXPATHL - 1);
3226 	else
3227 	    home_replace(buf, buf->b_fname, NameBuff, MAXPATHL, TRUE);
3228 	if (message_filtered(NameBuff))
3229 	    continue;
3230 
3231 	changed_char = (buf->b_flags & BF_READERR) ? 'x'
3232 					     : (bufIsChanged(buf) ? '+' : ' ');
3233 #ifdef FEAT_TERMINAL
3234 	if (term_job_running(buf->b_term))
3235 	{
3236 	    if (term_none_open(buf->b_term))
3237 		ro_char = '?';
3238 	    else
3239 		ro_char = 'R';
3240 	    changed_char = ' ';  // bufIsChanged() returns TRUE to avoid
3241 				 // closing, but it's not actually changed.
3242 	}
3243 	else if (buf->b_term != NULL)
3244 	    ro_char = 'F';
3245 	else
3246 #endif
3247 	    ro_char = !buf->b_p_ma ? '-' : (buf->b_p_ro ? '=' : ' ');
3248 
3249 	msg_putchar('\n');
3250 	len = vim_snprintf((char *)IObuff, IOSIZE - 20, "%3d%c%c%c%c%c \"%s\"",
3251 		buf->b_fnum,
3252 		buf->b_p_bl ? ' ' : 'u',
3253 		buf == curbuf ? '%' :
3254 			(curwin->w_alt_fnum == buf->b_fnum ? '#' : ' '),
3255 		buf->b_ml.ml_mfp == NULL ? ' ' :
3256 			(buf->b_nwindows == 0 ? 'h' : 'a'),
3257 		ro_char,
3258 		changed_char,
3259 		NameBuff);
3260 	if (len > IOSIZE - 20)
3261 	    len = IOSIZE - 20;
3262 
3263 	// put "line 999" in column 40 or after the file name
3264 	i = 40 - vim_strsize(IObuff);
3265 	do
3266 	    IObuff[len++] = ' ';
3267 	while (--i > 0 && len < IOSIZE - 18);
3268 #ifdef FEAT_VIMINFO
3269 	if (vim_strchr(eap->arg, 't') && buf->b_last_used)
3270 	    add_time(IObuff + len, (size_t)(IOSIZE - len), buf->b_last_used);
3271 	else
3272 #endif
3273 	    vim_snprintf((char *)IObuff + len, (size_t)(IOSIZE - len),
3274 		    _("line %ld"), buf == curbuf ? curwin->w_cursor.lnum
3275 					       : (long)buflist_findlnum(buf));
3276 	msg_outtrans(IObuff);
3277 	out_flush();	    // output one line at a time
3278 	ui_breakcheck();
3279     }
3280 
3281 #ifdef FEAT_VIMINFO
3282     if (buflist_data)
3283 	ga_clear(&buflist);
3284 #endif
3285 }
3286 
3287 /*
3288  * Get file name and line number for file 'fnum'.
3289  * Used by DoOneCmd() for translating '%' and '#'.
3290  * Used by insert_reg() and cmdline_paste() for '#' register.
3291  * Return FAIL if not found, OK for success.
3292  */
3293     int
3294 buflist_name_nr(
3295     int		fnum,
3296     char_u	**fname,
3297     linenr_T	*lnum)
3298 {
3299     buf_T	*buf;
3300 
3301     buf = buflist_findnr(fnum);
3302     if (buf == NULL || buf->b_fname == NULL)
3303 	return FAIL;
3304 
3305     *fname = buf->b_fname;
3306     *lnum = buflist_findlnum(buf);
3307 
3308     return OK;
3309 }
3310 
3311 /*
3312  * Set the file name for "buf"' to "ffname_arg", short file name to
3313  * "sfname_arg".
3314  * The file name with the full path is also remembered, for when :cd is used.
3315  * Returns FAIL for failure (file name already in use by other buffer)
3316  *	OK otherwise.
3317  */
3318     int
3319 setfname(
3320     buf_T	*buf,
3321     char_u	*ffname_arg,
3322     char_u	*sfname_arg,
3323     int		message)	// give message when buffer already exists
3324 {
3325     char_u	*ffname = ffname_arg;
3326     char_u	*sfname = sfname_arg;
3327     buf_T	*obuf = NULL;
3328 #ifdef UNIX
3329     stat_T	st;
3330 #endif
3331 
3332     if (ffname == NULL || *ffname == NUL)
3333     {
3334 	// Removing the name.
3335 	if (buf->b_sfname != buf->b_ffname)
3336 	    VIM_CLEAR(buf->b_sfname);
3337 	else
3338 	    buf->b_sfname = NULL;
3339 	VIM_CLEAR(buf->b_ffname);
3340 #ifdef UNIX
3341 	st.st_dev = (dev_T)-1;
3342 #endif
3343     }
3344     else
3345     {
3346 	fname_expand(buf, &ffname, &sfname); // will allocate ffname
3347 	if (ffname == NULL)		    // out of memory
3348 	    return FAIL;
3349 
3350 	/*
3351 	 * if the file name is already used in another buffer:
3352 	 * - if the buffer is loaded, fail
3353 	 * - if the buffer is not loaded, delete it from the list
3354 	 */
3355 #ifdef UNIX
3356 	if (mch_stat((char *)ffname, &st) < 0)
3357 	    st.st_dev = (dev_T)-1;
3358 #endif
3359 	if (!(buf->b_flags & BF_DUMMY))
3360 #ifdef UNIX
3361 	    obuf = buflist_findname_stat(ffname, &st);
3362 #else
3363 	    obuf = buflist_findname(ffname);
3364 #endif
3365 	if (obuf != NULL && obuf != buf)
3366 	{
3367 	    if (obuf->b_ml.ml_mfp != NULL)	// it's loaded, fail
3368 	    {
3369 		if (message)
3370 		    emsg(_("E95: Buffer with this name already exists"));
3371 		vim_free(ffname);
3372 		return FAIL;
3373 	    }
3374 	    // delete from the list
3375 	    close_buffer(NULL, obuf, DOBUF_WIPE, FALSE, FALSE);
3376 	}
3377 	sfname = vim_strsave(sfname);
3378 	if (ffname == NULL || sfname == NULL)
3379 	{
3380 	    vim_free(sfname);
3381 	    vim_free(ffname);
3382 	    return FAIL;
3383 	}
3384 #ifdef USE_FNAME_CASE
3385 	fname_case(sfname, 0);    // set correct case for short file name
3386 #endif
3387 	if (buf->b_sfname != buf->b_ffname)
3388 	    vim_free(buf->b_sfname);
3389 	vim_free(buf->b_ffname);
3390 	buf->b_ffname = ffname;
3391 	buf->b_sfname = sfname;
3392     }
3393     buf->b_fname = buf->b_sfname;
3394 #ifdef UNIX
3395     if (st.st_dev == (dev_T)-1)
3396 	buf->b_dev_valid = FALSE;
3397     else
3398     {
3399 	buf->b_dev_valid = TRUE;
3400 	buf->b_dev = st.st_dev;
3401 	buf->b_ino = st.st_ino;
3402     }
3403 #endif
3404 
3405     buf->b_shortname = FALSE;
3406 
3407     buf_name_changed(buf);
3408     return OK;
3409 }
3410 
3411 /*
3412  * Crude way of changing the name of a buffer.  Use with care!
3413  * The name should be relative to the current directory.
3414  */
3415     void
3416 buf_set_name(int fnum, char_u *name)
3417 {
3418     buf_T	*buf;
3419 
3420     buf = buflist_findnr(fnum);
3421     if (buf != NULL)
3422     {
3423 	if (buf->b_sfname != buf->b_ffname)
3424 	    vim_free(buf->b_sfname);
3425 	vim_free(buf->b_ffname);
3426 	buf->b_ffname = vim_strsave(name);
3427 	buf->b_sfname = NULL;
3428 	// Allocate ffname and expand into full path.  Also resolves .lnk
3429 	// files on Win32.
3430 	fname_expand(buf, &buf->b_ffname, &buf->b_sfname);
3431 	buf->b_fname = buf->b_sfname;
3432     }
3433 }
3434 
3435 /*
3436  * Take care of what needs to be done when the name of buffer "buf" has
3437  * changed.
3438  */
3439     void
3440 buf_name_changed(buf_T *buf)
3441 {
3442     /*
3443      * If the file name changed, also change the name of the swapfile
3444      */
3445     if (buf->b_ml.ml_mfp != NULL)
3446 	ml_setname(buf);
3447 
3448     if (curwin->w_buffer == buf)
3449 	check_arg_idx(curwin);	// check file name for arg list
3450 #ifdef FEAT_TITLE
3451     maketitle();		// set window title
3452 #endif
3453     status_redraw_all();	// status lines need to be redrawn
3454     fmarks_check_names(buf);	// check named file marks
3455     ml_timestamp(buf);		// reset timestamp
3456 }
3457 
3458 /*
3459  * set alternate file name for current window
3460  *
3461  * Used by do_one_cmd(), do_write() and do_ecmd().
3462  * Return the buffer.
3463  */
3464     buf_T *
3465 setaltfname(
3466     char_u	*ffname,
3467     char_u	*sfname,
3468     linenr_T	lnum)
3469 {
3470     buf_T	*buf;
3471 
3472     // Create a buffer.  'buflisted' is not set if it's a new buffer
3473     buf = buflist_new(ffname, sfname, lnum, 0);
3474     if (buf != NULL && (cmdmod.cmod_flags & CMOD_KEEPALT) == 0)
3475 	curwin->w_alt_fnum = buf->b_fnum;
3476     return buf;
3477 }
3478 
3479 /*
3480  * Get alternate file name for current window.
3481  * Return NULL if there isn't any, and give error message if requested.
3482  */
3483     char_u  *
3484 getaltfname(
3485     int		errmsg)		// give error message
3486 {
3487     char_u	*fname;
3488     linenr_T	dummy;
3489 
3490     if (buflist_name_nr(0, &fname, &dummy) == FAIL)
3491     {
3492 	if (errmsg)
3493 	    emsg(_(e_noalt));
3494 	return NULL;
3495     }
3496     return fname;
3497 }
3498 
3499 /*
3500  * Add a file name to the buflist and return its number.
3501  * Uses same flags as buflist_new(), except BLN_DUMMY.
3502  *
3503  * used by qf_init(), main() and doarglist()
3504  */
3505     int
3506 buflist_add(char_u *fname, int flags)
3507 {
3508     buf_T	*buf;
3509 
3510     buf = buflist_new(fname, NULL, (linenr_T)0, flags);
3511     if (buf != NULL)
3512 	return buf->b_fnum;
3513     return 0;
3514 }
3515 
3516 #if defined(BACKSLASH_IN_FILENAME) || defined(PROTO)
3517 /*
3518  * Adjust slashes in file names.  Called after 'shellslash' was set.
3519  */
3520     void
3521 buflist_slash_adjust(void)
3522 {
3523     buf_T	*bp;
3524 
3525     FOR_ALL_BUFFERS(bp)
3526     {
3527 	if (bp->b_ffname != NULL)
3528 	    slash_adjust(bp->b_ffname);
3529 	if (bp->b_sfname != NULL)
3530 	    slash_adjust(bp->b_sfname);
3531     }
3532 }
3533 #endif
3534 
3535 /*
3536  * Set alternate cursor position for the current buffer and window "win".
3537  * Also save the local window option values.
3538  */
3539     void
3540 buflist_altfpos(win_T *win)
3541 {
3542     buflist_setfpos(curbuf, win, win->w_cursor.lnum, win->w_cursor.col, TRUE);
3543 }
3544 
3545 /*
3546  * Return TRUE if 'ffname' is not the same file as current file.
3547  * Fname must have a full path (expanded by mch_FullName()).
3548  */
3549     int
3550 otherfile(char_u *ffname)
3551 {
3552     return otherfile_buf(curbuf, ffname
3553 #ifdef UNIX
3554 	    , NULL
3555 #endif
3556 	    );
3557 }
3558 
3559     static int
3560 otherfile_buf(
3561     buf_T		*buf,
3562     char_u		*ffname
3563 #ifdef UNIX
3564     , stat_T		*stp
3565 #endif
3566     )
3567 {
3568     // no name is different
3569     if (ffname == NULL || *ffname == NUL || buf->b_ffname == NULL)
3570 	return TRUE;
3571     if (fnamecmp(ffname, buf->b_ffname) == 0)
3572 	return FALSE;
3573 #ifdef UNIX
3574     {
3575 	stat_T	    st;
3576 
3577 	// If no stat_T given, get it now
3578 	if (stp == NULL)
3579 	{
3580 	    if (!buf->b_dev_valid || mch_stat((char *)ffname, &st) < 0)
3581 		st.st_dev = (dev_T)-1;
3582 	    stp = &st;
3583 	}
3584 	// Use dev/ino to check if the files are the same, even when the names
3585 	// are different (possible with links).  Still need to compare the
3586 	// name above, for when the file doesn't exist yet.
3587 	// Problem: The dev/ino changes when a file is deleted (and created
3588 	// again) and remains the same when renamed/moved.  We don't want to
3589 	// mch_stat() each buffer each time, that would be too slow.  Get the
3590 	// dev/ino again when they appear to match, but not when they appear
3591 	// to be different: Could skip a buffer when it's actually the same
3592 	// file.
3593 	if (buf_same_ino(buf, stp))
3594 	{
3595 	    buf_setino(buf);
3596 	    if (buf_same_ino(buf, stp))
3597 		return FALSE;
3598 	}
3599     }
3600 #endif
3601     return TRUE;
3602 }
3603 
3604 #if defined(UNIX) || defined(PROTO)
3605 /*
3606  * Set inode and device number for a buffer.
3607  * Must always be called when b_fname is changed!.
3608  */
3609     void
3610 buf_setino(buf_T *buf)
3611 {
3612     stat_T	st;
3613 
3614     if (buf->b_fname != NULL && mch_stat((char *)buf->b_fname, &st) >= 0)
3615     {
3616 	buf->b_dev_valid = TRUE;
3617 	buf->b_dev = st.st_dev;
3618 	buf->b_ino = st.st_ino;
3619     }
3620     else
3621 	buf->b_dev_valid = FALSE;
3622 }
3623 
3624 /*
3625  * Return TRUE if dev/ino in buffer "buf" matches with "stp".
3626  */
3627     static int
3628 buf_same_ino(
3629     buf_T	*buf,
3630     stat_T	*stp)
3631 {
3632     return (buf->b_dev_valid
3633 	    && stp->st_dev == buf->b_dev
3634 	    && stp->st_ino == buf->b_ino);
3635 }
3636 #endif
3637 
3638 /*
3639  * Print info about the current buffer.
3640  */
3641     void
3642 fileinfo(
3643     int fullname,	    // when non-zero print full path
3644     int shorthelp,
3645     int	dont_truncate)
3646 {
3647     char_u	*name;
3648     int		n;
3649     char	*p;
3650     char	*buffer;
3651     size_t	len;
3652 
3653     buffer = alloc(IOSIZE);
3654     if (buffer == NULL)
3655 	return;
3656 
3657     if (fullname > 1)	    // 2 CTRL-G: include buffer number
3658     {
3659 	vim_snprintf(buffer, IOSIZE, "buf %d: ", curbuf->b_fnum);
3660 	p = buffer + STRLEN(buffer);
3661     }
3662     else
3663 	p = buffer;
3664 
3665     *p++ = '"';
3666     if (buf_spname(curbuf) != NULL)
3667 	vim_strncpy((char_u *)p, buf_spname(curbuf), IOSIZE - (p - buffer) - 1);
3668     else
3669     {
3670 	if (!fullname && curbuf->b_fname != NULL)
3671 	    name = curbuf->b_fname;
3672 	else
3673 	    name = curbuf->b_ffname;
3674 	home_replace(shorthelp ? curbuf : NULL, name, (char_u *)p,
3675 					  (int)(IOSIZE - (p - buffer)), TRUE);
3676     }
3677 
3678     vim_snprintf_add(buffer, IOSIZE, "\"%s%s%s%s%s%s",
3679 	    curbufIsChanged() ? (shortmess(SHM_MOD)
3680 					  ?  " [+]" : _(" [Modified]")) : " ",
3681 	    (curbuf->b_flags & BF_NOTEDITED)
3682 #ifdef FEAT_QUICKFIX
3683 		    && !bt_dontwrite(curbuf)
3684 #endif
3685 					? _("[Not edited]") : "",
3686 	    (curbuf->b_flags & BF_NEW)
3687 #ifdef FEAT_QUICKFIX
3688 		    && !bt_dontwrite(curbuf)
3689 #endif
3690 					   ? new_file_message() : "",
3691 	    (curbuf->b_flags & BF_READERR) ? _("[Read errors]") : "",
3692 	    curbuf->b_p_ro ? (shortmess(SHM_RO) ? _("[RO]")
3693 						      : _("[readonly]")) : "",
3694 	    (curbufIsChanged() || (curbuf->b_flags & BF_WRITE_MASK)
3695 							  || curbuf->b_p_ro) ?
3696 								    " " : "");
3697     // With 32 bit longs and more than 21,474,836 lines multiplying by 100
3698     // causes an overflow, thus for large numbers divide instead.
3699     if (curwin->w_cursor.lnum > 1000000L)
3700 	n = (int)(((long)curwin->w_cursor.lnum) /
3701 				   ((long)curbuf->b_ml.ml_line_count / 100L));
3702     else
3703 	n = (int)(((long)curwin->w_cursor.lnum * 100L) /
3704 					    (long)curbuf->b_ml.ml_line_count);
3705     if (curbuf->b_ml.ml_flags & ML_EMPTY)
3706 	vim_snprintf_add(buffer, IOSIZE, "%s", _(no_lines_msg));
3707 #ifdef FEAT_CMDL_INFO
3708     else if (p_ru)
3709 	// Current line and column are already on the screen -- webb
3710 	vim_snprintf_add(buffer, IOSIZE,
3711 		NGETTEXT("%ld line --%d%%--", "%ld lines --%d%%--",
3712 						   curbuf->b_ml.ml_line_count),
3713 		(long)curbuf->b_ml.ml_line_count, n);
3714 #endif
3715     else
3716     {
3717 	vim_snprintf_add(buffer, IOSIZE,
3718 		_("line %ld of %ld --%d%%-- col "),
3719 		(long)curwin->w_cursor.lnum,
3720 		(long)curbuf->b_ml.ml_line_count,
3721 		n);
3722 	validate_virtcol();
3723 	len = STRLEN(buffer);
3724 	col_print((char_u *)buffer + len, IOSIZE - len,
3725 		   (int)curwin->w_cursor.col + 1, (int)curwin->w_virtcol + 1);
3726     }
3727 
3728     (void)append_arg_number(curwin, (char_u *)buffer, IOSIZE,
3729 							 !shortmess(SHM_FILE));
3730 
3731     if (dont_truncate)
3732     {
3733 	// Temporarily set msg_scroll to avoid the message being truncated.
3734 	// First call msg_start() to get the message in the right place.
3735 	msg_start();
3736 	n = msg_scroll;
3737 	msg_scroll = TRUE;
3738 	msg(buffer);
3739 	msg_scroll = n;
3740     }
3741     else
3742     {
3743 	p = (char *)msg_trunc_attr(buffer, FALSE, 0);
3744 	if (restart_edit != 0 || (msg_scrolled && !need_wait_return))
3745 	    // Need to repeat the message after redrawing when:
3746 	    // - When restart_edit is set (otherwise there will be a delay
3747 	    //   before redrawing).
3748 	    // - When the screen was scrolled but there is no wait-return
3749 	    //   prompt.
3750 	    set_keep_msg((char_u *)p, 0);
3751     }
3752 
3753     vim_free(buffer);
3754 }
3755 
3756     void
3757 col_print(
3758     char_u  *buf,
3759     size_t  buflen,
3760     int	    col,
3761     int	    vcol)
3762 {
3763     if (col == vcol)
3764 	vim_snprintf((char *)buf, buflen, "%d", col);
3765     else
3766 	vim_snprintf((char *)buf, buflen, "%d-%d", col, vcol);
3767 }
3768 
3769 #if defined(FEAT_TITLE) || defined(PROTO)
3770 static char_u *lasttitle = NULL;
3771 static char_u *lasticon = NULL;
3772 
3773 /*
3774  * Put the file name in the title bar and icon of the window.
3775  */
3776     void
3777 maketitle(void)
3778 {
3779     char_u	*p;
3780     char_u	*title_str = NULL;
3781     char_u	*icon_str = NULL;
3782     int		maxlen = 0;
3783     int		len;
3784     int		mustset;
3785     char_u	buf[IOSIZE];
3786     int		off;
3787 
3788     if (!redrawing())
3789     {
3790 	// Postpone updating the title when 'lazyredraw' is set.
3791 	need_maketitle = TRUE;
3792 	return;
3793     }
3794 
3795     need_maketitle = FALSE;
3796     if (!p_title && !p_icon && lasttitle == NULL && lasticon == NULL)
3797 	return;  // nothing to do
3798 
3799     if (p_title)
3800     {
3801 	if (p_titlelen > 0)
3802 	{
3803 	    maxlen = p_titlelen * Columns / 100;
3804 	    if (maxlen < 10)
3805 		maxlen = 10;
3806 	}
3807 
3808 	title_str = buf;
3809 	if (*p_titlestring != NUL)
3810 	{
3811 #ifdef FEAT_STL_OPT
3812 	    if (stl_syntax & STL_IN_TITLE)
3813 	    {
3814 		int	use_sandbox = FALSE;
3815 		int	called_emsg_before = called_emsg;
3816 
3817 # ifdef FEAT_EVAL
3818 		use_sandbox = was_set_insecurely((char_u *)"titlestring", 0);
3819 # endif
3820 		build_stl_str_hl(curwin, title_str, sizeof(buf),
3821 					      p_titlestring, use_sandbox,
3822 					      0, maxlen, NULL, NULL);
3823 		if (called_emsg > called_emsg_before)
3824 		    set_string_option_direct((char_u *)"titlestring", -1,
3825 					   (char_u *)"", OPT_FREE, SID_ERROR);
3826 	    }
3827 	    else
3828 #endif
3829 		title_str = p_titlestring;
3830 	}
3831 	else
3832 	{
3833 	    // format: "fname + (path) (1 of 2) - VIM"
3834 
3835 #define SPACE_FOR_FNAME (IOSIZE - 100)
3836 #define SPACE_FOR_DIR   (IOSIZE - 20)
3837 #define SPACE_FOR_ARGNR (IOSIZE - 10)  // at least room for " - VIM"
3838 	    if (curbuf->b_fname == NULL)
3839 		vim_strncpy(buf, (char_u *)_("[No Name]"), SPACE_FOR_FNAME);
3840 #ifdef FEAT_TERMINAL
3841 	    else if (curbuf->b_term != NULL)
3842 	    {
3843 		vim_strncpy(buf, term_get_status_text(curbuf->b_term),
3844 							      SPACE_FOR_FNAME);
3845 	    }
3846 #endif
3847 	    else
3848 	    {
3849 		p = transstr(gettail(curbuf->b_fname));
3850 		vim_strncpy(buf, p, SPACE_FOR_FNAME);
3851 		vim_free(p);
3852 	    }
3853 
3854 #ifdef FEAT_TERMINAL
3855 	    if (curbuf->b_term == NULL)
3856 #endif
3857 		switch (bufIsChanged(curbuf)
3858 			+ (curbuf->b_p_ro * 2)
3859 			+ (!curbuf->b_p_ma * 4))
3860 		{
3861 		    case 1: STRCAT(buf, " +"); break;
3862 		    case 2: STRCAT(buf, " ="); break;
3863 		    case 3: STRCAT(buf, " =+"); break;
3864 		    case 4:
3865 		    case 6: STRCAT(buf, " -"); break;
3866 		    case 5:
3867 		    case 7: STRCAT(buf, " -+"); break;
3868 		}
3869 
3870 	    if (curbuf->b_fname != NULL
3871 #ifdef FEAT_TERMINAL
3872 		    && curbuf->b_term == NULL
3873 #endif
3874 		    )
3875 	    {
3876 		// Get path of file, replace home dir with ~
3877 		off = (int)STRLEN(buf);
3878 		buf[off++] = ' ';
3879 		buf[off++] = '(';
3880 		home_replace(curbuf, curbuf->b_ffname,
3881 					buf + off, SPACE_FOR_DIR - off, TRUE);
3882 #ifdef BACKSLASH_IN_FILENAME
3883 		// avoid "c:/name" to be reduced to "c"
3884 		if (isalpha(buf[off]) && buf[off + 1] == ':')
3885 		    off += 2;
3886 #endif
3887 		// remove the file name
3888 		p = gettail_sep(buf + off);
3889 		if (p == buf + off)
3890 		{
3891 		    // must be a help buffer
3892 		    vim_strncpy(buf + off, (char_u *)_("help"),
3893 					   (size_t)(SPACE_FOR_DIR - off - 1));
3894 		}
3895 		else
3896 		    *p = NUL;
3897 
3898 		// Translate unprintable chars and concatenate.  Keep some
3899 		// room for the server name.  When there is no room (very long
3900 		// file name) use (...).
3901 		if (off < SPACE_FOR_DIR)
3902 		{
3903 		    p = transstr(buf + off);
3904 		    vim_strncpy(buf + off, p, (size_t)(SPACE_FOR_DIR - off));
3905 		    vim_free(p);
3906 		}
3907 		else
3908 		{
3909 		    vim_strncpy(buf + off, (char_u *)"...",
3910 					     (size_t)(SPACE_FOR_ARGNR - off));
3911 		}
3912 		STRCAT(buf, ")");
3913 	    }
3914 
3915 	    append_arg_number(curwin, buf, SPACE_FOR_ARGNR, FALSE);
3916 
3917 #if defined(FEAT_CLIENTSERVER)
3918 	    if (serverName != NULL)
3919 	    {
3920 		STRCAT(buf, " - ");
3921 		vim_strcat(buf, serverName, IOSIZE);
3922 	    }
3923 	    else
3924 #endif
3925 		STRCAT(buf, " - VIM");
3926 
3927 	    if (maxlen > 0)
3928 	    {
3929 		// make it shorter by removing a bit in the middle
3930 		if (vim_strsize(buf) > maxlen)
3931 		    trunc_string(buf, buf, maxlen, IOSIZE);
3932 	    }
3933 	}
3934     }
3935     mustset = value_changed(title_str, &lasttitle);
3936 
3937     if (p_icon)
3938     {
3939 	icon_str = buf;
3940 	if (*p_iconstring != NUL)
3941 	{
3942 #ifdef FEAT_STL_OPT
3943 	    if (stl_syntax & STL_IN_ICON)
3944 	    {
3945 		int	use_sandbox = FALSE;
3946 		int	called_emsg_before = called_emsg;
3947 
3948 # ifdef FEAT_EVAL
3949 		use_sandbox = was_set_insecurely((char_u *)"iconstring", 0);
3950 # endif
3951 		build_stl_str_hl(curwin, icon_str, sizeof(buf),
3952 						    p_iconstring, use_sandbox,
3953 						    0, 0, NULL, NULL);
3954 		if (called_emsg > called_emsg_before)
3955 		    set_string_option_direct((char_u *)"iconstring", -1,
3956 					   (char_u *)"", OPT_FREE, SID_ERROR);
3957 	    }
3958 	    else
3959 #endif
3960 		icon_str = p_iconstring;
3961 	}
3962 	else
3963 	{
3964 	    if (buf_spname(curbuf) != NULL)
3965 		p = buf_spname(curbuf);
3966 	    else		    // use file name only in icon
3967 		p = gettail(curbuf->b_ffname);
3968 	    *icon_str = NUL;
3969 	    // Truncate name at 100 bytes.
3970 	    len = (int)STRLEN(p);
3971 	    if (len > 100)
3972 	    {
3973 		len -= 100;
3974 		if (has_mbyte)
3975 		    len += (*mb_tail_off)(p, p + len) + 1;
3976 		p += len;
3977 	    }
3978 	    STRCPY(icon_str, p);
3979 	    trans_characters(icon_str, IOSIZE);
3980 	}
3981     }
3982 
3983     mustset |= value_changed(icon_str, &lasticon);
3984 
3985     if (mustset)
3986 	resettitle();
3987 }
3988 
3989 /*
3990  * Used for title and icon: Check if "str" differs from "*last".  Set "*last"
3991  * from "str" if it does.
3992  * Return TRUE if resettitle() is to be called.
3993  */
3994     static int
3995 value_changed(char_u *str, char_u **last)
3996 {
3997     if ((str == NULL) != (*last == NULL)
3998 	    || (str != NULL && *last != NULL && STRCMP(str, *last) != 0))
3999     {
4000 	vim_free(*last);
4001 	if (str == NULL)
4002 	{
4003 	    *last = NULL;
4004 	    mch_restore_title(
4005 		  last == &lasttitle ? SAVE_RESTORE_TITLE : SAVE_RESTORE_ICON);
4006 	}
4007 	else
4008 	{
4009 	    *last = vim_strsave(str);
4010 	    return TRUE;
4011 	}
4012     }
4013     return FALSE;
4014 }
4015 
4016 /*
4017  * Put current window title back (used after calling a shell)
4018  */
4019     void
4020 resettitle(void)
4021 {
4022     mch_settitle(lasttitle, lasticon);
4023 }
4024 
4025 # if defined(EXITFREE) || defined(PROTO)
4026     void
4027 free_titles(void)
4028 {
4029     vim_free(lasttitle);
4030     vim_free(lasticon);
4031 }
4032 # endif
4033 
4034 #endif // FEAT_TITLE
4035 
4036 #if defined(FEAT_STL_OPT) || defined(FEAT_GUI_TABLINE) || defined(PROTO)
4037 
4038 /*
4039  * Used for building in the status line.
4040  */
4041 typedef struct
4042 {
4043     char_u	*stl_start;
4044     int		stl_minwid;
4045     int		stl_maxwid;
4046     enum {
4047 	Normal,
4048 	Empty,
4049 	Group,
4050 	Middle,
4051 	Highlight,
4052 	TabPage,
4053 	Trunc
4054     }		stl_type;
4055 } stl_item_T;
4056 
4057 static size_t		stl_items_len = 20; // Initial value, grows as needed.
4058 static stl_item_T      *stl_items = NULL;
4059 static int	       *stl_groupitem = NULL;
4060 static stl_hlrec_T     *stl_hltab = NULL;
4061 static stl_hlrec_T     *stl_tabtab = NULL;
4062 
4063 /*
4064  * Build a string from the status line items in "fmt".
4065  * Return length of string in screen cells.
4066  *
4067  * Normally works for window "wp", except when working for 'tabline' then it
4068  * is "curwin".
4069  *
4070  * Items are drawn interspersed with the text that surrounds it
4071  * Specials: %-<wid>(xxx%) => group, %= => middle marker, %< => truncation
4072  * Item: %-<minwid>.<maxwid><itemch> All but <itemch> are optional
4073  *
4074  * If maxwidth is not zero, the string will be filled at any middle marker
4075  * or truncated if too long, fillchar is used for all whitespace.
4076  */
4077     int
4078 build_stl_str_hl(
4079     win_T	*wp,
4080     char_u	*out,		// buffer to write into != NameBuff
4081     size_t	outlen,		// length of out[]
4082     char_u	*fmt,
4083     int		use_sandbox UNUSED, // "fmt" was set insecurely, use sandbox
4084     int		fillchar,
4085     int		maxwidth,
4086     stl_hlrec_T **hltab,	// return: HL attributes (can be NULL)
4087     stl_hlrec_T **tabtab)	// return: tab page nrs (can be NULL)
4088 {
4089     linenr_T	lnum;
4090     size_t	len;
4091     char_u	*p;
4092     char_u	*s;
4093     char_u	*t;
4094     int		byteval;
4095 #ifdef FEAT_EVAL
4096     win_T	*save_curwin;
4097     buf_T	*save_curbuf;
4098     int		save_VIsual_active;
4099 #endif
4100     int		empty_line;
4101     colnr_T	virtcol;
4102     long	l;
4103     long	n;
4104     int		prevchar_isflag;
4105     int		prevchar_isitem;
4106     int		itemisflag;
4107     int		fillable;
4108     char_u	*str;
4109     long	num;
4110     int		width;
4111     int		itemcnt;
4112     int		curitem;
4113     int		group_end_userhl;
4114     int		group_start_userhl;
4115     int		groupdepth;
4116     int		minwid;
4117     int		maxwid;
4118     int		zeropad;
4119     char_u	base;
4120     char_u	opt;
4121 #define TMPLEN 70
4122     char_u	buf_tmp[TMPLEN];
4123     char_u	win_tmp[TMPLEN];
4124     char_u	*usefmt = fmt;
4125     stl_hlrec_T *sp;
4126     int		save_must_redraw = must_redraw;
4127     int		save_redr_type = curwin->w_redr_type;
4128 
4129     if (stl_items == NULL)
4130     {
4131 	stl_items = ALLOC_MULT(stl_item_T, stl_items_len);
4132 	stl_groupitem = ALLOC_MULT(int, stl_items_len);
4133 	stl_hltab  = ALLOC_MULT(stl_hlrec_T, stl_items_len);
4134 	stl_tabtab = ALLOC_MULT(stl_hlrec_T, stl_items_len);
4135     }
4136 
4137 #ifdef FEAT_EVAL
4138     /*
4139      * When the format starts with "%!" then evaluate it as an expression and
4140      * use the result as the actual format string.
4141      */
4142     if (fmt[0] == '%' && fmt[1] == '!')
4143     {
4144 	typval_T	tv;
4145 
4146 	tv.v_type = VAR_NUMBER;
4147 	tv.vval.v_number = wp->w_id;
4148 	set_var((char_u *)"g:statusline_winid", &tv, FALSE);
4149 
4150 	usefmt = eval_to_string_safe(fmt + 2, use_sandbox);
4151 	if (usefmt == NULL)
4152 	    usefmt = fmt;
4153 
4154 	do_unlet((char_u *)"g:statusline_winid", TRUE);
4155     }
4156 #endif
4157 
4158     if (fillchar == 0)
4159 	fillchar = ' ';
4160 
4161     // The cursor in windows other than the current one isn't always
4162     // up-to-date, esp. because of autocommands and timers.
4163     lnum = wp->w_cursor.lnum;
4164     if (lnum > wp->w_buffer->b_ml.ml_line_count)
4165     {
4166 	lnum = wp->w_buffer->b_ml.ml_line_count;
4167 	wp->w_cursor.lnum = lnum;
4168     }
4169 
4170     // Get line & check if empty (cursorpos will show "0-1").  Note that
4171     // p will become invalid when getting another buffer line.
4172     p = ml_get_buf(wp->w_buffer, lnum, FALSE);
4173     empty_line = (*p == NUL);
4174 
4175     // Get the byte value now, in case we need it below. This is more efficient
4176     // than making a copy of the line.
4177     len = STRLEN(p);
4178     if (wp->w_cursor.col > (colnr_T)len)
4179     {
4180 	// Line may have changed since checking the cursor column, or the lnum
4181 	// was adjusted above.
4182 	wp->w_cursor.col = (colnr_T)len;
4183 	wp->w_cursor.coladd = 0;
4184 	byteval = 0;
4185     }
4186     else
4187 	byteval = (*mb_ptr2char)(p + wp->w_cursor.col);
4188 
4189     groupdepth = 0;
4190     p = out;
4191     curitem = 0;
4192     prevchar_isflag = TRUE;
4193     prevchar_isitem = FALSE;
4194     for (s = usefmt; *s; )
4195     {
4196 	if (curitem == (int)stl_items_len)
4197 	{
4198 	    size_t	new_len = stl_items_len * 3 / 2;
4199 	    stl_item_T	*new_items;
4200 	    int		*new_groupitem;
4201 	    stl_hlrec_T	*new_hlrec;
4202 
4203 	    new_items = vim_realloc(stl_items, sizeof(stl_item_T) * new_len);
4204 	    if (new_items == NULL)
4205 		break;
4206 	    stl_items = new_items;
4207 	    new_groupitem = vim_realloc(stl_groupitem, sizeof(int) * new_len);
4208 	    if (new_groupitem == NULL)
4209 		break;
4210 	    stl_groupitem = new_groupitem;
4211 	    new_hlrec = vim_realloc(stl_hltab, sizeof(stl_hlrec_T) * new_len);
4212 	    if (new_hlrec == NULL)
4213 		break;
4214 	    stl_hltab = new_hlrec;
4215 	    new_hlrec = vim_realloc(stl_tabtab, sizeof(stl_hlrec_T) * new_len);
4216 	    if (new_hlrec == NULL)
4217 		break;
4218 	    stl_tabtab = new_hlrec;
4219 	    stl_items_len = new_len;
4220 	}
4221 
4222 	if (*s != NUL && *s != '%')
4223 	    prevchar_isflag = prevchar_isitem = FALSE;
4224 
4225 	/*
4226 	 * Handle up to the next '%' or the end.
4227 	 */
4228 	while (*s != NUL && *s != '%' && p + 1 < out + outlen)
4229 	    *p++ = *s++;
4230 	if (*s == NUL || p + 1 >= out + outlen)
4231 	    break;
4232 
4233 	/*
4234 	 * Handle one '%' item.
4235 	 */
4236 	s++;
4237 	if (*s == NUL)  // ignore trailing %
4238 	    break;
4239 	if (*s == '%')
4240 	{
4241 	    if (p + 1 >= out + outlen)
4242 		break;
4243 	    *p++ = *s++;
4244 	    prevchar_isflag = prevchar_isitem = FALSE;
4245 	    continue;
4246 	}
4247 	if (*s == STL_MIDDLEMARK)
4248 	{
4249 	    s++;
4250 	    if (groupdepth > 0)
4251 		continue;
4252 	    stl_items[curitem].stl_type = Middle;
4253 	    stl_items[curitem++].stl_start = p;
4254 	    continue;
4255 	}
4256 	if (*s == STL_TRUNCMARK)
4257 	{
4258 	    s++;
4259 	    stl_items[curitem].stl_type = Trunc;
4260 	    stl_items[curitem++].stl_start = p;
4261 	    continue;
4262 	}
4263 	if (*s == ')')
4264 	{
4265 	    s++;
4266 	    if (groupdepth < 1)
4267 		continue;
4268 	    groupdepth--;
4269 
4270 	    t = stl_items[stl_groupitem[groupdepth]].stl_start;
4271 	    *p = NUL;
4272 	    l = vim_strsize(t);
4273 	    if (curitem > stl_groupitem[groupdepth] + 1
4274 		    && stl_items[stl_groupitem[groupdepth]].stl_minwid == 0)
4275 	    {
4276 		// remove group if all items are empty and highlight group
4277 		// doesn't change
4278 		group_start_userhl = group_end_userhl = 0;
4279 		for (n = stl_groupitem[groupdepth] - 1; n >= 0; n--)
4280 		{
4281 		    if (stl_items[n].stl_type == Highlight)
4282 		    {
4283 			group_start_userhl = group_end_userhl =
4284 						       stl_items[n].stl_minwid;
4285 			break;
4286 		    }
4287 		}
4288 		for (n = stl_groupitem[groupdepth] + 1; n < curitem; n++)
4289 		{
4290 		    if (stl_items[n].stl_type == Normal)
4291 			break;
4292 		    if (stl_items[n].stl_type == Highlight)
4293 			group_end_userhl = stl_items[n].stl_minwid;
4294 		}
4295 		if (n == curitem && group_start_userhl == group_end_userhl)
4296 		{
4297 		    // empty group
4298 		    p = t;
4299 		    l = 0;
4300 		    for (n = stl_groupitem[groupdepth] + 1; n < curitem; n++)
4301 		    {
4302 			// do not use the highlighting from the removed group
4303 			if (stl_items[n].stl_type == Highlight)
4304 			    stl_items[n].stl_type = Empty;
4305 			// adjust the start position of TabPage to the next
4306 			// item position
4307 			if (stl_items[n].stl_type == TabPage)
4308 			    stl_items[n].stl_start = p;
4309 		    }
4310 		}
4311 	    }
4312 	    if (l > stl_items[stl_groupitem[groupdepth]].stl_maxwid)
4313 	    {
4314 		// truncate, remove n bytes of text at the start
4315 		if (has_mbyte)
4316 		{
4317 		    // Find the first character that should be included.
4318 		    n = 0;
4319 		    while (l >= stl_items[stl_groupitem[groupdepth]].stl_maxwid)
4320 		    {
4321 			l -= ptr2cells(t + n);
4322 			n += (*mb_ptr2len)(t + n);
4323 		    }
4324 		}
4325 		else
4326 		    n = (long)(p - t) - stl_items[stl_groupitem[groupdepth]]
4327 							       .stl_maxwid + 1;
4328 
4329 		*t = '<';
4330 		mch_memmove(t + 1, t + n, (size_t)(p - (t + n)));
4331 		p = p - n + 1;
4332 
4333 		// Fill up space left over by half a double-wide char.
4334 		while (++l < stl_items[stl_groupitem[groupdepth]].stl_minwid)
4335 		    MB_CHAR2BYTES(fillchar, p);
4336 
4337 		// correct the start of the items for the truncation
4338 		for (l = stl_groupitem[groupdepth] + 1; l < curitem; l++)
4339 		{
4340 		    stl_items[l].stl_start -= n;
4341 		    if (stl_items[l].stl_start < t)
4342 			stl_items[l].stl_start = t;
4343 		}
4344 	    }
4345 	    else if (abs(stl_items[stl_groupitem[groupdepth]].stl_minwid) > l)
4346 	    {
4347 		// fill
4348 		n = stl_items[stl_groupitem[groupdepth]].stl_minwid;
4349 		if (n < 0)
4350 		{
4351 		    // fill by appending characters
4352 		    n = 0 - n;
4353 		    while (l++ < n && p + 1 < out + outlen)
4354 			MB_CHAR2BYTES(fillchar, p);
4355 		}
4356 		else
4357 		{
4358 		    // fill by inserting characters
4359 		    l = (n - l) * MB_CHAR2LEN(fillchar);
4360 		    mch_memmove(t + l, t, (size_t)(p - t));
4361 		    if (p + l >= out + outlen)
4362 			l = (long)((out + outlen) - p - 1);
4363 		    p += l;
4364 		    for (n = stl_groupitem[groupdepth] + 1; n < curitem; n++)
4365 			stl_items[n].stl_start += l;
4366 		    for ( ; l > 0; l--)
4367 			MB_CHAR2BYTES(fillchar, t);
4368 		}
4369 	    }
4370 	    continue;
4371 	}
4372 	minwid = 0;
4373 	maxwid = 9999;
4374 	zeropad = FALSE;
4375 	l = 1;
4376 	if (*s == '0')
4377 	{
4378 	    s++;
4379 	    zeropad = TRUE;
4380 	}
4381 	if (*s == '-')
4382 	{
4383 	    s++;
4384 	    l = -1;
4385 	}
4386 	if (VIM_ISDIGIT(*s))
4387 	{
4388 	    minwid = (int)getdigits(&s);
4389 	    if (minwid < 0)	// overflow
4390 		minwid = 0;
4391 	}
4392 	if (*s == STL_USER_HL)
4393 	{
4394 	    stl_items[curitem].stl_type = Highlight;
4395 	    stl_items[curitem].stl_start = p;
4396 	    stl_items[curitem].stl_minwid = minwid > 9 ? 1 : minwid;
4397 	    s++;
4398 	    curitem++;
4399 	    continue;
4400 	}
4401 	if (*s == STL_TABPAGENR || *s == STL_TABCLOSENR)
4402 	{
4403 	    if (*s == STL_TABCLOSENR)
4404 	    {
4405 		if (minwid == 0)
4406 		{
4407 		    // %X ends the close label, go back to the previously
4408 		    // define tab label nr.
4409 		    for (n = curitem - 1; n >= 0; --n)
4410 			if (stl_items[n].stl_type == TabPage
4411 					       && stl_items[n].stl_minwid >= 0)
4412 			{
4413 			    minwid = stl_items[n].stl_minwid;
4414 			    break;
4415 			}
4416 		}
4417 		else
4418 		    // close nrs are stored as negative values
4419 		    minwid = - minwid;
4420 	    }
4421 	    stl_items[curitem].stl_type = TabPage;
4422 	    stl_items[curitem].stl_start = p;
4423 	    stl_items[curitem].stl_minwid = minwid;
4424 	    s++;
4425 	    curitem++;
4426 	    continue;
4427 	}
4428 	if (*s == '.')
4429 	{
4430 	    s++;
4431 	    if (VIM_ISDIGIT(*s))
4432 	    {
4433 		maxwid = (int)getdigits(&s);
4434 		if (maxwid <= 0)	// overflow
4435 		    maxwid = 50;
4436 	    }
4437 	}
4438 	minwid = (minwid > 50 ? 50 : minwid) * l;
4439 	if (*s == '(')
4440 	{
4441 	    stl_groupitem[groupdepth++] = curitem;
4442 	    stl_items[curitem].stl_type = Group;
4443 	    stl_items[curitem].stl_start = p;
4444 	    stl_items[curitem].stl_minwid = minwid;
4445 	    stl_items[curitem].stl_maxwid = maxwid;
4446 	    s++;
4447 	    curitem++;
4448 	    continue;
4449 	}
4450 	if (vim_strchr(STL_ALL, *s) == NULL)
4451 	{
4452 	    s++;
4453 	    continue;
4454 	}
4455 	opt = *s++;
4456 
4457 	// OK - now for the real work
4458 	base = 'D';
4459 	itemisflag = FALSE;
4460 	fillable = TRUE;
4461 	num = -1;
4462 	str = NULL;
4463 	switch (opt)
4464 	{
4465 	case STL_FILEPATH:
4466 	case STL_FULLPATH:
4467 	case STL_FILENAME:
4468 	    fillable = FALSE;	// don't change ' ' to fillchar
4469 	    if (buf_spname(wp->w_buffer) != NULL)
4470 		vim_strncpy(NameBuff, buf_spname(wp->w_buffer), MAXPATHL - 1);
4471 	    else
4472 	    {
4473 		t = (opt == STL_FULLPATH) ? wp->w_buffer->b_ffname
4474 					  : wp->w_buffer->b_fname;
4475 		home_replace(wp->w_buffer, t, NameBuff, MAXPATHL, TRUE);
4476 	    }
4477 	    trans_characters(NameBuff, MAXPATHL);
4478 	    if (opt != STL_FILENAME)
4479 		str = NameBuff;
4480 	    else
4481 		str = gettail(NameBuff);
4482 	    break;
4483 
4484 	case STL_VIM_EXPR: // '{'
4485 	    itemisflag = TRUE;
4486 	    t = p;
4487 	    while (*s != '}' && *s != NUL && p + 1 < out + outlen)
4488 		*p++ = *s++;
4489 	    if (*s != '}')	// missing '}' or out of space
4490 		break;
4491 	    s++;
4492 	    *p = 0;
4493 	    p = t;
4494 
4495 #ifdef FEAT_EVAL
4496 	    vim_snprintf((char *)buf_tmp, sizeof(buf_tmp),
4497 							 "%d", curbuf->b_fnum);
4498 	    set_internal_string_var((char_u *)"g:actual_curbuf", buf_tmp);
4499 	    vim_snprintf((char *)win_tmp, sizeof(win_tmp), "%d", curwin->w_id);
4500 	    set_internal_string_var((char_u *)"g:actual_curwin", win_tmp);
4501 
4502 	    save_curbuf = curbuf;
4503 	    save_curwin = curwin;
4504 	    save_VIsual_active = VIsual_active;
4505 	    curwin = wp;
4506 	    curbuf = wp->w_buffer;
4507 	    // Visual mode is only valid in the current window.
4508 	    if (curwin != save_curwin)
4509 		VIsual_active = FALSE;
4510 
4511 	    str = eval_to_string_safe(p, use_sandbox);
4512 
4513 	    curwin = save_curwin;
4514 	    curbuf = save_curbuf;
4515 	    VIsual_active = save_VIsual_active;
4516 	    do_unlet((char_u *)"g:actual_curbuf", TRUE);
4517 	    do_unlet((char_u *)"g:actual_curwin", TRUE);
4518 
4519 	    if (str != NULL && *str != 0)
4520 	    {
4521 		if (*skipdigits(str) == NUL)
4522 		{
4523 		    num = atoi((char *)str);
4524 		    VIM_CLEAR(str);
4525 		    itemisflag = FALSE;
4526 		}
4527 	    }
4528 #endif
4529 	    break;
4530 
4531 	case STL_LINE:
4532 	    num = (wp->w_buffer->b_ml.ml_flags & ML_EMPTY)
4533 		  ? 0L : (long)(wp->w_cursor.lnum);
4534 	    break;
4535 
4536 	case STL_NUMLINES:
4537 	    num = wp->w_buffer->b_ml.ml_line_count;
4538 	    break;
4539 
4540 	case STL_COLUMN:
4541 	    num = !(State & INSERT) && empty_line
4542 		  ? 0 : (int)wp->w_cursor.col + 1;
4543 	    break;
4544 
4545 	case STL_VIRTCOL:
4546 	case STL_VIRTCOL_ALT:
4547 	    // In list mode virtcol needs to be recomputed
4548 	    virtcol = wp->w_virtcol;
4549 	    if (wp->w_p_list && wp->w_lcs_chars.tab1 == NUL)
4550 	    {
4551 		wp->w_p_list = FALSE;
4552 		getvcol(wp, &wp->w_cursor, NULL, &virtcol, NULL);
4553 		wp->w_p_list = TRUE;
4554 	    }
4555 	    ++virtcol;
4556 	    // Don't display %V if it's the same as %c.
4557 	    if (opt == STL_VIRTCOL_ALT
4558 		    && (virtcol == (colnr_T)(!(State & INSERT) && empty_line
4559 			    ? 0 : (int)wp->w_cursor.col + 1)))
4560 		break;
4561 	    num = (long)virtcol;
4562 	    break;
4563 
4564 	case STL_PERCENTAGE:
4565 	    num = (int)(((long)wp->w_cursor.lnum * 100L) /
4566 			(long)wp->w_buffer->b_ml.ml_line_count);
4567 	    break;
4568 
4569 	case STL_ALTPERCENT:
4570 	    str = buf_tmp;
4571 	    get_rel_pos(wp, str, TMPLEN);
4572 	    break;
4573 
4574 	case STL_ARGLISTSTAT:
4575 	    fillable = FALSE;
4576 	    buf_tmp[0] = 0;
4577 	    if (append_arg_number(wp, buf_tmp, (int)sizeof(buf_tmp), FALSE))
4578 		str = buf_tmp;
4579 	    break;
4580 
4581 	case STL_KEYMAP:
4582 	    fillable = FALSE;
4583 	    if (get_keymap_str(wp, (char_u *)"<%s>", buf_tmp, TMPLEN))
4584 		str = buf_tmp;
4585 	    break;
4586 	case STL_PAGENUM:
4587 #if defined(FEAT_PRINTER) || defined(FEAT_GUI_TABLINE)
4588 	    num = printer_page_num;
4589 #else
4590 	    num = 0;
4591 #endif
4592 	    break;
4593 
4594 	case STL_BUFNO:
4595 	    num = wp->w_buffer->b_fnum;
4596 	    break;
4597 
4598 	case STL_OFFSET_X:
4599 	    base = 'X';
4600 	    // FALLTHROUGH
4601 	case STL_OFFSET:
4602 #ifdef FEAT_BYTEOFF
4603 	    l = ml_find_line_or_offset(wp->w_buffer, wp->w_cursor.lnum, NULL);
4604 	    num = (wp->w_buffer->b_ml.ml_flags & ML_EMPTY) || l < 0 ?
4605 		  0L : l + 1 + (!(State & INSERT) && empty_line ?
4606 				0 : (int)wp->w_cursor.col);
4607 #endif
4608 	    break;
4609 
4610 	case STL_BYTEVAL_X:
4611 	    base = 'X';
4612 	    // FALLTHROUGH
4613 	case STL_BYTEVAL:
4614 	    num = byteval;
4615 	    if (num == NL)
4616 		num = 0;
4617 	    else if (num == CAR && get_fileformat(wp->w_buffer) == EOL_MAC)
4618 		num = NL;
4619 	    break;
4620 
4621 	case STL_ROFLAG:
4622 	case STL_ROFLAG_ALT:
4623 	    itemisflag = TRUE;
4624 	    if (wp->w_buffer->b_p_ro)
4625 		str = (char_u *)((opt == STL_ROFLAG_ALT) ? ",RO" : _("[RO]"));
4626 	    break;
4627 
4628 	case STL_HELPFLAG:
4629 	case STL_HELPFLAG_ALT:
4630 	    itemisflag = TRUE;
4631 	    if (wp->w_buffer->b_help)
4632 		str = (char_u *)((opt == STL_HELPFLAG_ALT) ? ",HLP"
4633 							       : _("[Help]"));
4634 	    break;
4635 
4636 	case STL_FILETYPE:
4637 	    if (*wp->w_buffer->b_p_ft != NUL
4638 		    && STRLEN(wp->w_buffer->b_p_ft) < TMPLEN - 3)
4639 	    {
4640 		vim_snprintf((char *)buf_tmp, sizeof(buf_tmp), "[%s]",
4641 							wp->w_buffer->b_p_ft);
4642 		str = buf_tmp;
4643 	    }
4644 	    break;
4645 
4646 	case STL_FILETYPE_ALT:
4647 	    itemisflag = TRUE;
4648 	    if (*wp->w_buffer->b_p_ft != NUL
4649 		    && STRLEN(wp->w_buffer->b_p_ft) < TMPLEN - 2)
4650 	    {
4651 		vim_snprintf((char *)buf_tmp, sizeof(buf_tmp), ",%s",
4652 							wp->w_buffer->b_p_ft);
4653 		for (t = buf_tmp; *t != 0; t++)
4654 		    *t = TOUPPER_LOC(*t);
4655 		str = buf_tmp;
4656 	    }
4657 	    break;
4658 
4659 #if defined(FEAT_QUICKFIX)
4660 	case STL_PREVIEWFLAG:
4661 	case STL_PREVIEWFLAG_ALT:
4662 	    itemisflag = TRUE;
4663 	    if (wp->w_p_pvw)
4664 		str = (char_u *)((opt == STL_PREVIEWFLAG_ALT) ? ",PRV"
4665 							    : _("[Preview]"));
4666 	    break;
4667 
4668 	case STL_QUICKFIX:
4669 	    if (bt_quickfix(wp->w_buffer))
4670 		str = (char_u *)(wp->w_llist_ref
4671 			    ? _(msg_loclist)
4672 			    : _(msg_qflist));
4673 	    break;
4674 #endif
4675 
4676 	case STL_MODIFIED:
4677 	case STL_MODIFIED_ALT:
4678 	    itemisflag = TRUE;
4679 	    switch ((opt == STL_MODIFIED_ALT)
4680 		    + bufIsChanged(wp->w_buffer) * 2
4681 		    + (!wp->w_buffer->b_p_ma) * 4)
4682 	    {
4683 		case 2: str = (char_u *)"[+]"; break;
4684 		case 3: str = (char_u *)",+"; break;
4685 		case 4: str = (char_u *)"[-]"; break;
4686 		case 5: str = (char_u *)",-"; break;
4687 		case 6: str = (char_u *)"[+-]"; break;
4688 		case 7: str = (char_u *)",+-"; break;
4689 	    }
4690 	    break;
4691 
4692 	case STL_HIGHLIGHT:
4693 	    t = s;
4694 	    while (*s != '#' && *s != NUL)
4695 		++s;
4696 	    if (*s == '#')
4697 	    {
4698 		stl_items[curitem].stl_type = Highlight;
4699 		stl_items[curitem].stl_start = p;
4700 		stl_items[curitem].stl_minwid = -syn_namen2id(t, (int)(s - t));
4701 		curitem++;
4702 	    }
4703 	    if (*s != NUL)
4704 		++s;
4705 	    continue;
4706 	}
4707 
4708 	stl_items[curitem].stl_start = p;
4709 	stl_items[curitem].stl_type = Normal;
4710 	if (str != NULL && *str)
4711 	{
4712 	    t = str;
4713 	    if (itemisflag)
4714 	    {
4715 		if ((t[0] && t[1])
4716 			&& ((!prevchar_isitem && *t == ',')
4717 			      || (prevchar_isflag && *t == ' ')))
4718 		    t++;
4719 		prevchar_isflag = TRUE;
4720 	    }
4721 	    l = vim_strsize(t);
4722 	    if (l > 0)
4723 		prevchar_isitem = TRUE;
4724 	    if (l > maxwid)
4725 	    {
4726 		while (l >= maxwid)
4727 		    if (has_mbyte)
4728 		    {
4729 			l -= ptr2cells(t);
4730 			t += (*mb_ptr2len)(t);
4731 		    }
4732 		    else
4733 			l -= byte2cells(*t++);
4734 		if (p + 1 >= out + outlen)
4735 		    break;
4736 		*p++ = '<';
4737 	    }
4738 	    if (minwid > 0)
4739 	    {
4740 		for (; l < minwid && p + 1 < out + outlen; l++)
4741 		{
4742 		    // Don't put a "-" in front of a digit.
4743 		    if (l + 1 == minwid && fillchar == '-' && VIM_ISDIGIT(*t))
4744 			*p++ = ' ';
4745 		    else
4746 			MB_CHAR2BYTES(fillchar, p);
4747 		}
4748 		minwid = 0;
4749 	    }
4750 	    else
4751 		minwid *= -1;
4752 	    for (; *t && p + 1 < out + outlen; t++)
4753 	    {
4754 		// Change a space by fillchar, unless fillchar is '-' and a
4755 		// digit follows.
4756 		if (fillable && *t == ' '
4757 				&& (!VIM_ISDIGIT(*(t + 1)) || fillchar != '-'))
4758 		    MB_CHAR2BYTES(fillchar, p);
4759 		else
4760 		    *p++ = *t;
4761 	    }
4762 	    for (; l < minwid && p + 1 < out + outlen; l++)
4763 		MB_CHAR2BYTES(fillchar, p);
4764 	}
4765 	else if (num >= 0)
4766 	{
4767 	    int nbase = (base == 'D' ? 10 : (base == 'O' ? 8 : 16));
4768 	    char_u nstr[20];
4769 
4770 	    if (p + 20 >= out + outlen)
4771 		break;		// not sufficient space
4772 	    prevchar_isitem = TRUE;
4773 	    t = nstr;
4774 	    if (opt == STL_VIRTCOL_ALT)
4775 	    {
4776 		*t++ = '-';
4777 		minwid--;
4778 	    }
4779 	    *t++ = '%';
4780 	    if (zeropad)
4781 		*t++ = '0';
4782 	    *t++ = '*';
4783 	    *t++ = nbase == 16 ? base : (char_u)(nbase == 8 ? 'o' : 'd');
4784 	    *t = 0;
4785 
4786 	    for (n = num, l = 1; n >= nbase; n /= nbase)
4787 		l++;
4788 	    if (opt == STL_VIRTCOL_ALT)
4789 		l++;
4790 	    if (l > maxwid)
4791 	    {
4792 		l += 2;
4793 		n = l - maxwid;
4794 		while (l-- > maxwid)
4795 		    num /= nbase;
4796 		*t++ = '>';
4797 		*t++ = '%';
4798 		*t = t[-3];
4799 		*++t = 0;
4800 		vim_snprintf((char *)p, outlen - (p - out), (char *)nstr,
4801 								   0, num, n);
4802 	    }
4803 	    else
4804 		vim_snprintf((char *)p, outlen - (p - out), (char *)nstr,
4805 								 minwid, num);
4806 	    p += STRLEN(p);
4807 	}
4808 	else
4809 	    stl_items[curitem].stl_type = Empty;
4810 
4811 	if (opt == STL_VIM_EXPR)
4812 	    vim_free(str);
4813 
4814 	if (num >= 0 || (!itemisflag && str && *str))
4815 	    prevchar_isflag = FALSE;	    // Item not NULL, but not a flag
4816 	curitem++;
4817     }
4818     *p = NUL;
4819     itemcnt = curitem;
4820 
4821 #ifdef FEAT_EVAL
4822     if (usefmt != fmt)
4823 	vim_free(usefmt);
4824 #endif
4825 
4826     width = vim_strsize(out);
4827     if (maxwidth > 0 && width > maxwidth)
4828     {
4829 	// Result is too long, must truncate somewhere.
4830 	l = 0;
4831 	if (itemcnt == 0)
4832 	    s = out;
4833 	else
4834 	{
4835 	    for ( ; l < itemcnt; l++)
4836 		if (stl_items[l].stl_type == Trunc)
4837 		{
4838 		    // Truncate at %< item.
4839 		    s = stl_items[l].stl_start;
4840 		    break;
4841 		}
4842 	    if (l == itemcnt)
4843 	    {
4844 		// No %< item, truncate first item.
4845 		s = stl_items[0].stl_start;
4846 		l = 0;
4847 	    }
4848 	}
4849 
4850 	if (width - vim_strsize(s) >= maxwidth)
4851 	{
4852 	    // Truncation mark is beyond max length
4853 	    if (has_mbyte)
4854 	    {
4855 		s = out;
4856 		width = 0;
4857 		for (;;)
4858 		{
4859 		    width += ptr2cells(s);
4860 		    if (width >= maxwidth)
4861 			break;
4862 		    s += (*mb_ptr2len)(s);
4863 		}
4864 		// Fill up for half a double-wide character.
4865 		while (++width < maxwidth)
4866 		    MB_CHAR2BYTES(fillchar, s);
4867 	    }
4868 	    else
4869 		s = out + maxwidth - 1;
4870 	    for (l = 0; l < itemcnt; l++)
4871 		if (stl_items[l].stl_start > s)
4872 		    break;
4873 	    itemcnt = l;
4874 	    *s++ = '>';
4875 	    *s = 0;
4876 	}
4877 	else
4878 	{
4879 	    if (has_mbyte)
4880 	    {
4881 		n = 0;
4882 		while (width >= maxwidth)
4883 		{
4884 		    width -= ptr2cells(s + n);
4885 		    n += (*mb_ptr2len)(s + n);
4886 		}
4887 	    }
4888 	    else
4889 		n = width - maxwidth + 1;
4890 	    p = s + n;
4891 	    STRMOVE(s + 1, p);
4892 	    *s = '<';
4893 
4894 	    // Fill up for half a double-wide character.
4895 	    while (++width < maxwidth)
4896 	    {
4897 		s = s + STRLEN(s);
4898 		MB_CHAR2BYTES(fillchar, s);
4899 		*s = NUL;
4900 	    }
4901 
4902 	    --n;	// count the '<'
4903 	    for (; l < itemcnt; l++)
4904 	    {
4905 		if (stl_items[l].stl_start - n >= s)
4906 		    stl_items[l].stl_start -= n;
4907 		else
4908 		    stl_items[l].stl_start = s;
4909 	    }
4910 	}
4911 	width = maxwidth;
4912     }
4913     else if (width < maxwidth && STRLEN(out) + maxwidth - width + 1 < outlen)
4914     {
4915 	// Apply STL_MIDDLE if any
4916 	for (l = 0; l < itemcnt; l++)
4917 	    if (stl_items[l].stl_type == Middle)
4918 		break;
4919 	if (l < itemcnt)
4920 	{
4921 	    int middlelength = (maxwidth - width) * MB_CHAR2LEN(fillchar);
4922 	    p = stl_items[l].stl_start + middlelength;
4923 	    STRMOVE(p, stl_items[l].stl_start);
4924 	    for (s = stl_items[l].stl_start; s < p;)
4925 		MB_CHAR2BYTES(fillchar, s);
4926 	    for (l++; l < itemcnt; l++)
4927 		stl_items[l].stl_start += middlelength;
4928 	    width = maxwidth;
4929 	}
4930     }
4931 
4932     // Store the info about highlighting.
4933     if (hltab != NULL)
4934     {
4935 	*hltab = stl_hltab;
4936 	sp = stl_hltab;
4937 	for (l = 0; l < itemcnt; l++)
4938 	{
4939 	    if (stl_items[l].stl_type == Highlight)
4940 	    {
4941 		sp->start = stl_items[l].stl_start;
4942 		sp->userhl = stl_items[l].stl_minwid;
4943 		sp++;
4944 	    }
4945 	}
4946 	sp->start = NULL;
4947 	sp->userhl = 0;
4948     }
4949 
4950     // Store the info about tab pages labels.
4951     if (tabtab != NULL)
4952     {
4953 	*tabtab = stl_tabtab;
4954 	sp = stl_tabtab;
4955 	for (l = 0; l < itemcnt; l++)
4956 	{
4957 	    if (stl_items[l].stl_type == TabPage)
4958 	    {
4959 		sp->start = stl_items[l].stl_start;
4960 		sp->userhl = stl_items[l].stl_minwid;
4961 		sp++;
4962 	    }
4963 	}
4964 	sp->start = NULL;
4965 	sp->userhl = 0;
4966     }
4967 
4968     // When inside update_screen we do not want redrawing a stausline, ruler,
4969     // title, etc. to trigger another redraw, it may cause an endless loop.
4970     if (updating_screen)
4971     {
4972 	must_redraw = save_must_redraw;
4973 	curwin->w_redr_type = save_redr_type;
4974     }
4975 
4976     return width;
4977 }
4978 #endif // FEAT_STL_OPT
4979 
4980 #if defined(FEAT_STL_OPT) || defined(FEAT_CMDL_INFO) \
4981 	    || defined(FEAT_GUI_TABLINE) || defined(PROTO)
4982 /*
4983  * Get relative cursor position in window into "buf[buflen]", in the form 99%,
4984  * using "Top", "Bot" or "All" when appropriate.
4985  */
4986     void
4987 get_rel_pos(
4988     win_T	*wp,
4989     char_u	*buf,
4990     int		buflen)
4991 {
4992     long	above; // number of lines above window
4993     long	below; // number of lines below window
4994 
4995     if (buflen < 3) // need at least 3 chars for writing
4996 	return;
4997     above = wp->w_topline - 1;
4998 #ifdef FEAT_DIFF
4999     above += diff_check_fill(wp, wp->w_topline) - wp->w_topfill;
5000     if (wp->w_topline == 1 && wp->w_topfill >= 1)
5001 	above = 0;  // All buffer lines are displayed and there is an
5002 		    // indication of filler lines, that can be considered
5003 		    // seeing all lines.
5004 #endif
5005     below = wp->w_buffer->b_ml.ml_line_count - wp->w_botline + 1;
5006     if (below <= 0)
5007 	vim_strncpy(buf, (char_u *)(above == 0 ? _("All") : _("Bot")),
5008 							(size_t)(buflen - 1));
5009     else if (above <= 0)
5010 	vim_strncpy(buf, (char_u *)_("Top"), (size_t)(buflen - 1));
5011     else
5012 	vim_snprintf((char *)buf, (size_t)buflen, "%2d%%", above > 1000000L
5013 				    ? (int)(above / ((above + below) / 100L))
5014 				    : (int)(above * 100L / (above + below)));
5015 }
5016 #endif
5017 
5018 /*
5019  * Append (file 2 of 8) to "buf[buflen]", if editing more than one file.
5020  * Return TRUE if it was appended.
5021  */
5022     static int
5023 append_arg_number(
5024     win_T	*wp,
5025     char_u	*buf,
5026     int		buflen,
5027     int		add_file)	// Add "file" before the arg number
5028 {
5029     char_u	*p;
5030 
5031     if (ARGCOUNT <= 1)		// nothing to do
5032 	return FALSE;
5033 
5034     p = buf + STRLEN(buf);	// go to the end of the buffer
5035     if (p - buf + 35 >= buflen)	// getting too long
5036 	return FALSE;
5037     *p++ = ' ';
5038     *p++ = '(';
5039     if (add_file)
5040     {
5041 	STRCPY(p, "file ");
5042 	p += 5;
5043     }
5044     vim_snprintf((char *)p, (size_t)(buflen - (p - buf)),
5045 		wp->w_arg_idx_invalid ? "(%d) of %d)"
5046 				  : "%d of %d)", wp->w_arg_idx + 1, ARGCOUNT);
5047     return TRUE;
5048 }
5049 
5050 /*
5051  * If fname is not a full path, make it a full path.
5052  * Returns pointer to allocated memory (NULL for failure).
5053  */
5054     char_u  *
5055 fix_fname(char_u  *fname)
5056 {
5057     /*
5058      * Force expanding the path always for Unix, because symbolic links may
5059      * mess up the full path name, even though it starts with a '/'.
5060      * Also expand when there is ".." in the file name, try to remove it,
5061      * because "c:/src/../README" is equal to "c:/README".
5062      * Similarly "c:/src//file" is equal to "c:/src/file".
5063      * For MS-Windows also expand names like "longna~1" to "longname".
5064      */
5065 #ifdef UNIX
5066     return FullName_save(fname, TRUE);
5067 #else
5068     if (!vim_isAbsName(fname)
5069 	    || strstr((char *)fname, "..") != NULL
5070 	    || strstr((char *)fname, "//") != NULL
5071 # ifdef BACKSLASH_IN_FILENAME
5072 	    || strstr((char *)fname, "\\\\") != NULL
5073 # endif
5074 # if defined(MSWIN)
5075 	    || vim_strchr(fname, '~') != NULL
5076 # endif
5077 	    )
5078 	return FullName_save(fname, FALSE);
5079 
5080     fname = vim_strsave(fname);
5081 
5082 # ifdef USE_FNAME_CASE
5083     if (fname != NULL)
5084 	fname_case(fname, 0);	// set correct case for file name
5085 # endif
5086 
5087     return fname;
5088 #endif
5089 }
5090 
5091 /*
5092  * Make "*ffname" a full file name, set "*sfname" to "*ffname" if not NULL.
5093  * "*ffname" becomes a pointer to allocated memory (or NULL).
5094  * When resolving a link both "*sfname" and "*ffname" will point to the same
5095  * allocated memory.
5096  * The "*ffname" and "*sfname" pointer values on call will not be freed.
5097  * Note that the resulting "*ffname" pointer should be considered not allocated.
5098  */
5099     void
5100 fname_expand(
5101     buf_T	*buf UNUSED,
5102     char_u	**ffname,
5103     char_u	**sfname)
5104 {
5105     if (*ffname == NULL)	    // no file name given, nothing to do
5106 	return;
5107     if (*sfname == NULL)	    // no short file name given, use ffname
5108 	*sfname = *ffname;
5109     *ffname = fix_fname(*ffname);   // expand to full path
5110 
5111 #ifdef FEAT_SHORTCUT
5112     if (!buf->b_p_bin)
5113     {
5114 	char_u  *rfname;
5115 
5116 	// If the file name is a shortcut file, use the file it links to.
5117 	rfname = mch_resolve_path(*ffname, FALSE);
5118 	if (rfname != NULL)
5119 	{
5120 	    vim_free(*ffname);
5121 	    *ffname = rfname;
5122 	    *sfname = rfname;
5123 	}
5124     }
5125 #endif
5126 }
5127 
5128 /*
5129  * Open a window for a number of buffers.
5130  */
5131     void
5132 ex_buffer_all(exarg_T *eap)
5133 {
5134     buf_T	*buf;
5135     win_T	*wp, *wpnext;
5136     int		split_ret = OK;
5137     int		p_ea_save;
5138     int		open_wins = 0;
5139     int		r;
5140     int		count;		// Maximum number of windows to open.
5141     int		all;		// When TRUE also load inactive buffers.
5142     int		had_tab = cmdmod.cmod_tab;
5143     tabpage_T	*tpnext;
5144 
5145     if (eap->addr_count == 0)	// make as many windows as possible
5146 	count = 9999;
5147     else
5148 	count = eap->line2;	// make as many windows as specified
5149     if (eap->cmdidx == CMD_unhide || eap->cmdidx == CMD_sunhide)
5150 	all = FALSE;
5151     else
5152 	all = TRUE;
5153 
5154     setpcmark();
5155 
5156 #ifdef FEAT_GUI
5157     need_mouse_correct = TRUE;
5158 #endif
5159 
5160     /*
5161      * Close superfluous windows (two windows for the same buffer).
5162      * Also close windows that are not full-width.
5163      */
5164     if (had_tab > 0)
5165 	goto_tabpage_tp(first_tabpage, TRUE, TRUE);
5166     for (;;)
5167     {
5168 	tpnext = curtab->tp_next;
5169 	for (wp = firstwin; wp != NULL; wp = wpnext)
5170 	{
5171 	    wpnext = wp->w_next;
5172 	    if ((wp->w_buffer->b_nwindows > 1
5173 		    || ((cmdmod.cmod_split & WSP_VERT)
5174 			? wp->w_height + wp->w_status_height < Rows - p_ch
5175 							    - tabline_height()
5176 			: wp->w_width != Columns)
5177 		    || (had_tab > 0 && wp != firstwin)) && !ONE_WINDOW
5178 			     && !(wp->w_closing || wp->w_buffer->b_locked > 0))
5179 	    {
5180 		win_close(wp, FALSE);
5181 		wpnext = firstwin;	// just in case an autocommand does
5182 					// something strange with windows
5183 		tpnext = first_tabpage;	// start all over...
5184 		open_wins = 0;
5185 	    }
5186 	    else
5187 		++open_wins;
5188 	}
5189 
5190 	// Without the ":tab" modifier only do the current tab page.
5191 	if (had_tab == 0 || tpnext == NULL)
5192 	    break;
5193 	goto_tabpage_tp(tpnext, TRUE, TRUE);
5194     }
5195 
5196     /*
5197      * Go through the buffer list.  When a buffer doesn't have a window yet,
5198      * open one.  Otherwise move the window to the right position.
5199      * Watch out for autocommands that delete buffers or windows!
5200      */
5201     // Don't execute Win/Buf Enter/Leave autocommands here.
5202     ++autocmd_no_enter;
5203     win_enter(lastwin, FALSE);
5204     ++autocmd_no_leave;
5205     for (buf = firstbuf; buf != NULL && open_wins < count; buf = buf->b_next)
5206     {
5207 	// Check if this buffer needs a window
5208 	if ((!all && buf->b_ml.ml_mfp == NULL) || !buf->b_p_bl)
5209 	    continue;
5210 
5211 	if (had_tab != 0)
5212 	{
5213 	    // With the ":tab" modifier don't move the window.
5214 	    if (buf->b_nwindows > 0)
5215 		wp = lastwin;	    // buffer has a window, skip it
5216 	    else
5217 		wp = NULL;
5218 	}
5219 	else
5220 	{
5221 	    // Check if this buffer already has a window
5222 	    FOR_ALL_WINDOWS(wp)
5223 		if (wp->w_buffer == buf)
5224 		    break;
5225 	    // If the buffer already has a window, move it
5226 	    if (wp != NULL)
5227 		win_move_after(wp, curwin);
5228 	}
5229 
5230 	if (wp == NULL && split_ret == OK)
5231 	{
5232 	    bufref_T	bufref;
5233 
5234 	    set_bufref(&bufref, buf);
5235 
5236 	    // Split the window and put the buffer in it
5237 	    p_ea_save = p_ea;
5238 	    p_ea = TRUE;		// use space from all windows
5239 	    split_ret = win_split(0, WSP_ROOM | WSP_BELOW);
5240 	    ++open_wins;
5241 	    p_ea = p_ea_save;
5242 	    if (split_ret == FAIL)
5243 		continue;
5244 
5245 	    // Open the buffer in this window.
5246 	    swap_exists_action = SEA_DIALOG;
5247 	    set_curbuf(buf, DOBUF_GOTO);
5248 	    if (!bufref_valid(&bufref))
5249 	    {
5250 		// autocommands deleted the buffer!!!
5251 		swap_exists_action = SEA_NONE;
5252 		break;
5253 	    }
5254 	    if (swap_exists_action == SEA_QUIT)
5255 	    {
5256 #if defined(FEAT_EVAL)
5257 		cleanup_T   cs;
5258 
5259 		// Reset the error/interrupt/exception state here so that
5260 		// aborting() returns FALSE when closing a window.
5261 		enter_cleanup(&cs);
5262 #endif
5263 
5264 		// User selected Quit at ATTENTION prompt; close this window.
5265 		win_close(curwin, TRUE);
5266 		--open_wins;
5267 		swap_exists_action = SEA_NONE;
5268 		swap_exists_did_quit = TRUE;
5269 
5270 #if defined(FEAT_EVAL)
5271 		// Restore the error/interrupt/exception state if not
5272 		// discarded by a new aborting error, interrupt, or uncaught
5273 		// exception.
5274 		leave_cleanup(&cs);
5275 #endif
5276 	    }
5277 	    else
5278 		handle_swap_exists(NULL);
5279 	}
5280 
5281 	ui_breakcheck();
5282 	if (got_int)
5283 	{
5284 	    (void)vgetc();	// only break the file loading, not the rest
5285 	    break;
5286 	}
5287 #ifdef FEAT_EVAL
5288 	// Autocommands deleted the buffer or aborted script processing!!!
5289 	if (aborting())
5290 	    break;
5291 #endif
5292 	// When ":tab" was used open a new tab for a new window repeatedly.
5293 	if (had_tab > 0 && tabpage_index(NULL) <= p_tpm)
5294 	    cmdmod.cmod_tab = 9999;
5295     }
5296     --autocmd_no_enter;
5297     win_enter(firstwin, FALSE);		// back to first window
5298     --autocmd_no_leave;
5299 
5300     /*
5301      * Close superfluous windows.
5302      */
5303     for (wp = lastwin; open_wins > count; )
5304     {
5305 	r = (buf_hide(wp->w_buffer) || !bufIsChanged(wp->w_buffer)
5306 				     || autowrite(wp->w_buffer, FALSE) == OK);
5307 	if (!win_valid(wp))
5308 	{
5309 	    // BufWrite Autocommands made the window invalid, start over
5310 	    wp = lastwin;
5311 	}
5312 	else if (r)
5313 	{
5314 	    win_close(wp, !buf_hide(wp->w_buffer));
5315 	    --open_wins;
5316 	    wp = lastwin;
5317 	}
5318 	else
5319 	{
5320 	    wp = wp->w_prev;
5321 	    if (wp == NULL)
5322 		break;
5323 	}
5324     }
5325 }
5326 
5327 
5328 static int  chk_modeline(linenr_T, int);
5329 
5330 /*
5331  * do_modelines() - process mode lines for the current file
5332  *
5333  * "flags" can be:
5334  * OPT_WINONLY	    only set options local to window
5335  * OPT_NOWIN	    don't set options local to window
5336  *
5337  * Returns immediately if the "ml" option isn't set.
5338  */
5339     void
5340 do_modelines(int flags)
5341 {
5342     linenr_T	lnum;
5343     int		nmlines;
5344     static int	entered = 0;
5345 
5346     if (!curbuf->b_p_ml || (nmlines = (int)p_mls) == 0)
5347 	return;
5348 
5349     // Disallow recursive entry here.  Can happen when executing a modeline
5350     // triggers an autocommand, which reloads modelines with a ":do".
5351     if (entered)
5352 	return;
5353 
5354     ++entered;
5355     for (lnum = 1; lnum <= curbuf->b_ml.ml_line_count && lnum <= nmlines;
5356 								       ++lnum)
5357 	if (chk_modeline(lnum, flags) == FAIL)
5358 	    nmlines = 0;
5359 
5360     for (lnum = curbuf->b_ml.ml_line_count; lnum > 0 && lnum > nmlines
5361 		       && lnum > curbuf->b_ml.ml_line_count - nmlines; --lnum)
5362 	if (chk_modeline(lnum, flags) == FAIL)
5363 	    nmlines = 0;
5364     --entered;
5365 }
5366 
5367 #include "version.h"		// for version number
5368 
5369 /*
5370  * chk_modeline() - check a single line for a mode string
5371  * Return FAIL if an error encountered.
5372  */
5373     static int
5374 chk_modeline(
5375     linenr_T	lnum,
5376     int		flags)		// Same as for do_modelines().
5377 {
5378     char_u	*s;
5379     char_u	*e;
5380     char_u	*linecopy;		// local copy of any modeline found
5381     int		prev;
5382     int		vers;
5383     int		end;
5384     int		retval = OK;
5385     sctx_T	save_current_sctx;
5386 
5387     ESTACK_CHECK_DECLARATION
5388 
5389     prev = -1;
5390     for (s = ml_get(lnum); *s != NUL; ++s)
5391     {
5392 	if (prev == -1 || vim_isspace(prev))
5393 	{
5394 	    if ((prev != -1 && STRNCMP(s, "ex:", (size_t)3) == 0)
5395 		    || STRNCMP(s, "vi:", (size_t)3) == 0)
5396 		break;
5397 	    // Accept both "vim" and "Vim".
5398 	    if ((s[0] == 'v' || s[0] == 'V') && s[1] == 'i' && s[2] == 'm')
5399 	    {
5400 		if (s[3] == '<' || s[3] == '=' || s[3] == '>')
5401 		    e = s + 4;
5402 		else
5403 		    e = s + 3;
5404 		vers = getdigits(&e);
5405 		if (*e == ':'
5406 			&& (s[0] != 'V'
5407 				  || STRNCMP(skipwhite(e + 1), "set", 3) == 0)
5408 			&& (s[3] == ':'
5409 			    || (VIM_VERSION_100 >= vers && isdigit(s[3]))
5410 			    || (VIM_VERSION_100 < vers && s[3] == '<')
5411 			    || (VIM_VERSION_100 > vers && s[3] == '>')
5412 			    || (VIM_VERSION_100 == vers && s[3] == '=')))
5413 		    break;
5414 	    }
5415 	}
5416 	prev = *s;
5417     }
5418 
5419     if (*s)
5420     {
5421 	do				// skip over "ex:", "vi:" or "vim:"
5422 	    ++s;
5423 	while (s[-1] != ':');
5424 
5425 	s = linecopy = vim_strsave(s);	// copy the line, it will change
5426 	if (linecopy == NULL)
5427 	    return FAIL;
5428 
5429 	// prepare for emsg()
5430 	estack_push(ETYPE_MODELINE, (char_u *)"modelines", lnum);
5431 	ESTACK_CHECK_SETUP
5432 
5433 	end = FALSE;
5434 	while (end == FALSE)
5435 	{
5436 	    s = skipwhite(s);
5437 	    if (*s == NUL)
5438 		break;
5439 
5440 	    /*
5441 	     * Find end of set command: ':' or end of line.
5442 	     * Skip over "\:", replacing it with ":".
5443 	     */
5444 	    for (e = s; *e != ':' && *e != NUL; ++e)
5445 		if (e[0] == '\\' && e[1] == ':')
5446 		    STRMOVE(e, e + 1);
5447 	    if (*e == NUL)
5448 		end = TRUE;
5449 
5450 	    /*
5451 	     * If there is a "set" command, require a terminating ':' and
5452 	     * ignore the stuff after the ':'.
5453 	     * "vi:set opt opt opt: foo" -- foo not interpreted
5454 	     * "vi:opt opt opt: foo" -- foo interpreted
5455 	     * Accept "se" for compatibility with Elvis.
5456 	     */
5457 	    if (STRNCMP(s, "set ", (size_t)4) == 0
5458 		    || STRNCMP(s, "se ", (size_t)3) == 0)
5459 	    {
5460 		if (*e != ':')		// no terminating ':'?
5461 		    break;
5462 		end = TRUE;
5463 		s = vim_strchr(s, ' ') + 1;
5464 	    }
5465 	    *e = NUL;			// truncate the set command
5466 
5467 	    if (*s != NUL)		// skip over an empty "::"
5468 	    {
5469 		int secure_save = secure;
5470 
5471 		save_current_sctx = current_sctx;
5472 		current_sctx.sc_version = 1;
5473 #ifdef FEAT_EVAL
5474 		current_sctx.sc_sid = SID_MODELINE;
5475 		current_sctx.sc_seq = 0;
5476 		current_sctx.sc_lnum = lnum;
5477 #endif
5478 
5479 		// Make sure no risky things are executed as a side effect.
5480 		secure = 1;
5481 
5482 		retval = do_set(s, OPT_MODELINE | OPT_LOCAL | flags);
5483 
5484 		secure = secure_save;
5485 		current_sctx = save_current_sctx;
5486 		if (retval == FAIL)		// stop if error found
5487 		    break;
5488 	    }
5489 	    s = e + 1;			// advance to next part
5490 	}
5491 
5492 	ESTACK_CHECK_NOW
5493 	estack_pop();
5494 	vim_free(linecopy);
5495     }
5496     return retval;
5497 }
5498 
5499 /*
5500  * Return TRUE if "buf" is a normal buffer, 'buftype' is empty.
5501  */
5502     int
5503 bt_normal(buf_T *buf)
5504 {
5505     return buf != NULL && buf->b_p_bt[0] == NUL;
5506 }
5507 
5508 #if defined(FEAT_QUICKFIX) || defined(PROTO)
5509 /*
5510  * Return TRUE if "buf" is the quickfix buffer.
5511  */
5512     int
5513 bt_quickfix(buf_T *buf)
5514 {
5515     return buf != NULL && buf->b_p_bt[0] == 'q';
5516 }
5517 #endif
5518 
5519 #if defined(FEAT_TERMINAL) || defined(PROTO)
5520 /*
5521  * Return TRUE if "buf" is a terminal buffer.
5522  */
5523     int
5524 bt_terminal(buf_T *buf)
5525 {
5526     return buf != NULL && buf->b_p_bt[0] == 't';
5527 }
5528 #endif
5529 
5530 /*
5531  * Return TRUE if "buf" is a help buffer.
5532  */
5533     int
5534 bt_help(buf_T *buf)
5535 {
5536     return buf != NULL && buf->b_help;
5537 }
5538 
5539 /*
5540  * Return TRUE if "buf" is a prompt buffer.
5541  */
5542     int
5543 bt_prompt(buf_T *buf)
5544 {
5545     return buf != NULL && buf->b_p_bt[0] == 'p' && buf->b_p_bt[1] == 'r';
5546 }
5547 
5548 /*
5549  * Return TRUE if "buf" is a buffer for a popup window.
5550  */
5551     int
5552 bt_popup(buf_T *buf)
5553 {
5554     return buf != NULL && buf->b_p_bt != NULL
5555 	&& buf->b_p_bt[0] == 'p' && buf->b_p_bt[1] == 'o';
5556 }
5557 
5558 /*
5559  * Return TRUE if "buf" is a "nofile", "acwrite", "terminal" or "prompt"
5560  * buffer.  This means the buffer name is not a file name.
5561  */
5562     int
5563 bt_nofilename(buf_T *buf)
5564 {
5565     return buf != NULL && ((buf->b_p_bt[0] == 'n' && buf->b_p_bt[2] == 'f')
5566 	    || buf->b_p_bt[0] == 'a'
5567 	    || buf->b_p_bt[0] == 't'
5568 	    || buf->b_p_bt[0] == 'p');
5569 }
5570 
5571 /*
5572  * Return TRUE if "buf" has 'buftype' set to "nofile".
5573  */
5574     int
5575 bt_nofile(buf_T *buf)
5576 {
5577     return buf != NULL && buf->b_p_bt[0] == 'n' && buf->b_p_bt[2] == 'f';
5578 }
5579 
5580 /*
5581  * Return TRUE if "buf" is a "nowrite", "nofile", "terminal" or "prompt"
5582  * buffer.
5583  */
5584     int
5585 bt_dontwrite(buf_T *buf)
5586 {
5587     return buf != NULL && (buf->b_p_bt[0] == 'n'
5588 		 || buf->b_p_bt[0] == 't'
5589 		 || buf->b_p_bt[0] == 'p');
5590 }
5591 
5592 #if defined(FEAT_QUICKFIX) || defined(PROTO)
5593     int
5594 bt_dontwrite_msg(buf_T *buf)
5595 {
5596     if (bt_dontwrite(buf))
5597     {
5598 	emsg(_("E382: Cannot write, 'buftype' option is set"));
5599 	return TRUE;
5600     }
5601     return FALSE;
5602 }
5603 #endif
5604 
5605 /*
5606  * Return TRUE if the buffer should be hidden, according to 'hidden', ":hide"
5607  * and 'bufhidden'.
5608  */
5609     int
5610 buf_hide(buf_T *buf)
5611 {
5612     // 'bufhidden' overrules 'hidden' and ":hide", check it first
5613     switch (buf->b_p_bh[0])
5614     {
5615 	case 'u':		    // "unload"
5616 	case 'w':		    // "wipe"
5617 	case 'd': return FALSE;	    // "delete"
5618 	case 'h': return TRUE;	    // "hide"
5619     }
5620     return (p_hid || (cmdmod.cmod_flags & CMOD_HIDE));
5621 }
5622 
5623 /*
5624  * Return special buffer name.
5625  * Returns NULL when the buffer has a normal file name.
5626  */
5627     char_u *
5628 buf_spname(buf_T *buf)
5629 {
5630 #if defined(FEAT_QUICKFIX)
5631     if (bt_quickfix(buf))
5632     {
5633 	/*
5634 	 * Differentiate between the quickfix and location list buffers using
5635 	 * the buffer number stored in the global quickfix stack.
5636 	 */
5637 	if (buf->b_fnum == qf_stack_get_bufnr())
5638 	    return (char_u *)_(msg_qflist);
5639 	else
5640 	    return (char_u *)_(msg_loclist);
5641     }
5642 #endif
5643 
5644     // There is no _file_ when 'buftype' is "nofile", b_sfname
5645     // contains the name as specified by the user.
5646     if (bt_nofilename(buf))
5647     {
5648 #ifdef FEAT_TERMINAL
5649 	if (buf->b_term != NULL)
5650 	    return term_get_status_text(buf->b_term);
5651 #endif
5652 	if (buf->b_fname != NULL)
5653 	    return buf->b_fname;
5654 #ifdef FEAT_JOB_CHANNEL
5655 	if (bt_prompt(buf))
5656 	    return (char_u *)_("[Prompt]");
5657 #endif
5658 #ifdef FEAT_PROP_POPUP
5659 	if (bt_popup(buf))
5660 	    return (char_u *)_("[Popup]");
5661 #endif
5662 	return (char_u *)_("[Scratch]");
5663     }
5664 
5665     if (buf->b_fname == NULL)
5666 	return buf_get_fname(buf);
5667     return NULL;
5668 }
5669 
5670 /*
5671  * Get "buf->b_fname", use "[No Name]" if it is NULL.
5672  */
5673     char_u *
5674 buf_get_fname(buf_T *buf)
5675 {
5676     if (buf->b_fname == NULL)
5677 	return (char_u *)_("[No Name]");
5678     return buf->b_fname;
5679 }
5680 
5681 /*
5682  * Set 'buflisted' for curbuf to "on" and trigger autocommands if it changed.
5683  */
5684     void
5685 set_buflisted(int on)
5686 {
5687     if (on != curbuf->b_p_bl)
5688     {
5689 	curbuf->b_p_bl = on;
5690 	if (on)
5691 	    apply_autocmds(EVENT_BUFADD, NULL, NULL, FALSE, curbuf);
5692 	else
5693 	    apply_autocmds(EVENT_BUFDELETE, NULL, NULL, FALSE, curbuf);
5694     }
5695 }
5696 
5697 /*
5698  * Read the file for "buf" again and check if the contents changed.
5699  * Return TRUE if it changed or this could not be checked.
5700  */
5701     int
5702 buf_contents_changed(buf_T *buf)
5703 {
5704     buf_T	*newbuf;
5705     int		differ = TRUE;
5706     linenr_T	lnum;
5707     aco_save_T	aco;
5708     exarg_T	ea;
5709 
5710     // Allocate a buffer without putting it in the buffer list.
5711     newbuf = buflist_new(NULL, NULL, (linenr_T)1, BLN_DUMMY);
5712     if (newbuf == NULL)
5713 	return TRUE;
5714 
5715     // Force the 'fileencoding' and 'fileformat' to be equal.
5716     if (prep_exarg(&ea, buf) == FAIL)
5717     {
5718 	wipe_buffer(newbuf, FALSE);
5719 	return TRUE;
5720     }
5721 
5722     // set curwin/curbuf to buf and save a few things
5723     aucmd_prepbuf(&aco, newbuf);
5724 
5725     if (ml_open(curbuf) == OK
5726 	    && readfile(buf->b_ffname, buf->b_fname,
5727 				  (linenr_T)0, (linenr_T)0, (linenr_T)MAXLNUM,
5728 					    &ea, READ_NEW | READ_DUMMY) == OK)
5729     {
5730 	// compare the two files line by line
5731 	if (buf->b_ml.ml_line_count == curbuf->b_ml.ml_line_count)
5732 	{
5733 	    differ = FALSE;
5734 	    for (lnum = 1; lnum <= curbuf->b_ml.ml_line_count; ++lnum)
5735 		if (STRCMP(ml_get_buf(buf, lnum, FALSE), ml_get(lnum)) != 0)
5736 		{
5737 		    differ = TRUE;
5738 		    break;
5739 		}
5740 	}
5741     }
5742     vim_free(ea.cmd);
5743 
5744     // restore curwin/curbuf and a few other things
5745     aucmd_restbuf(&aco);
5746 
5747     if (curbuf != newbuf)	// safety check
5748 	wipe_buffer(newbuf, FALSE);
5749 
5750     return differ;
5751 }
5752 
5753 /*
5754  * Wipe out a buffer and decrement the last buffer number if it was used for
5755  * this buffer.  Call this to wipe out a temp buffer that does not contain any
5756  * marks.
5757  */
5758     void
5759 wipe_buffer(
5760     buf_T	*buf,
5761     int		aucmd)	    // When TRUE trigger autocommands.
5762 {
5763     if (buf->b_fnum == top_file_num - 1)
5764 	--top_file_num;
5765 
5766     if (!aucmd)		    // Don't trigger BufDelete autocommands here.
5767 	block_autocmds();
5768 
5769     close_buffer(NULL, buf, DOBUF_WIPE, FALSE, TRUE);
5770 
5771     if (!aucmd)
5772 	unblock_autocmds();
5773 }
5774