xref: /vim-8.2.3635/src/message.c (revision 044b68f4)
1 /* vi:set ts=8 sts=4 sw=4:
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  * message.c: functions for displaying messages on the command line
12  */
13 
14 #define MESSAGE_FILE		/* don't include prototype for smsg() */
15 
16 #include "vim.h"
17 
18 static int other_sourcing_name __ARGS((void));
19 static char_u *get_emsg_source __ARGS((void));
20 static char_u *get_emsg_lnum __ARGS((void));
21 static void add_msg_hist __ARGS((char_u *s, int len, int attr));
22 static void hit_return_msg __ARGS((void));
23 static void msg_home_replace_attr __ARGS((char_u *fname, int attr));
24 #ifdef FEAT_MBYTE
25 static char_u *screen_puts_mbyte __ARGS((char_u *s, int l, int attr));
26 #endif
27 static void msg_puts_attr_len __ARGS((char_u *str, int maxlen, int attr));
28 static void msg_puts_display __ARGS((char_u *str, int maxlen, int attr, int recurse));
29 static void msg_scroll_up __ARGS((void));
30 static void inc_msg_scrolled __ARGS((void));
31 static void store_sb_text __ARGS((char_u **sb_str, char_u *s, int attr, int *sb_col, int finish));
32 static void t_puts __ARGS((int *t_col, char_u *t_s, char_u *s, int attr));
33 static void msg_puts_printf __ARGS((char_u *str, int maxlen));
34 static int do_more_prompt __ARGS((int typed_char));
35 static void msg_screen_putchar __ARGS((int c, int attr));
36 static int  msg_check_screen __ARGS((void));
37 static void redir_write __ARGS((char_u *s, int maxlen));
38 static void verbose_write __ARGS((char_u *s, int maxlen));
39 #ifdef FEAT_CON_DIALOG
40 static char_u *msg_show_console_dialog __ARGS((char_u *message, char_u *buttons, int dfltbutton));
41 static int	confirm_msg_used = FALSE;	/* displaying confirm_msg */
42 static char_u	*confirm_msg = NULL;		/* ":confirm" message */
43 static char_u	*confirm_msg_tail;		/* tail of confirm_msg */
44 #endif
45 
46 struct msg_hist
47 {
48     struct msg_hist	*next;
49     char_u		*msg;
50     int			attr;
51 };
52 
53 static struct msg_hist *first_msg_hist = NULL;
54 static struct msg_hist *last_msg_hist = NULL;
55 static int msg_hist_len = 0;
56 
57 /*
58  * When writing messages to the screen, there are many different situations.
59  * A number of variables is used to remember the current state:
60  * msg_didany	    TRUE when messages were written since the last time the
61  *		    user reacted to a prompt.
62  *		    Reset: After hitting a key for the hit-return prompt,
63  *		    hitting <CR> for the command line or input().
64  *		    Set: When any message is written to the screen.
65  * msg_didout	    TRUE when something was written to the current line.
66  *		    Reset: When advancing to the next line, when the current
67  *		    text can be overwritten.
68  *		    Set: When any message is written to the screen.
69  * msg_nowait	    No extra delay for the last drawn message.
70  *		    Used in normal_cmd() before the mode message is drawn.
71  * emsg_on_display  There was an error message recently.  Indicates that there
72  *		    should be a delay before redrawing.
73  * msg_scroll	    The next message should not overwrite the current one.
74  * msg_scrolled	    How many lines the screen has been scrolled (because of
75  *		    messages).  Used in update_screen() to scroll the screen
76  *		    back.  Incremented each time the screen scrolls a line.
77  * msg_scrolled_ign  TRUE when msg_scrolled is non-zero and msg_puts_attr()
78  *		    writes something without scrolling should not make
79  *		    need_wait_return to be set.  This is a hack to make ":ts"
80  *		    work without an extra prompt.
81  * lines_left	    Number of lines available for messages before the
82  *		    more-prompt is to be given.
83  * need_wait_return TRUE when the hit-return prompt is needed.
84  *		    Reset: After giving the hit-return prompt, when the user
85  *		    has answered some other prompt.
86  *		    Set: When the ruler or typeahead display is overwritten,
87  *		    scrolling the screen for some message.
88  * keep_msg	    Message to be displayed after redrawing the screen, in
89  *		    main_loop().
90  *		    This is an allocated string or NULL when not used.
91  */
92 
93 /*
94  * msg(s) - displays the string 's' on the status line
95  * When terminal not initialized (yet) mch_errmsg(..) is used.
96  * return TRUE if wait_return not called
97  */
98     int
99 msg(s)
100     char_u	*s;
101 {
102     return msg_attr_keep(s, 0, FALSE);
103 }
104 
105 #if defined(FEAT_EVAL) || defined(FEAT_X11) || defined(USE_XSMP) \
106     || defined(PROTO)
107 /*
108  * Like msg() but keep it silent when 'verbosefile' is set.
109  */
110     int
111 verb_msg(s)
112     char_u	*s;
113 {
114     int		n;
115 
116     verbose_enter();
117     n = msg_attr_keep(s, 0, FALSE);
118     verbose_leave();
119 
120     return n;
121 }
122 #endif
123 
124     int
125 msg_attr(s, attr)
126     char_u	*s;
127     int		attr;
128 {
129     return msg_attr_keep(s, attr, FALSE);
130 }
131 
132     int
133 msg_attr_keep(s, attr, keep)
134     char_u	*s;
135     int		attr;
136     int		keep;	    /* TRUE: set keep_msg if it doesn't scroll */
137 {
138     static int	entered = 0;
139     int		retval;
140     char_u	*buf = NULL;
141 
142 #ifdef FEAT_EVAL
143     if (attr == 0)
144 	set_vim_var_string(VV_STATUSMSG, s, -1);
145 #endif
146 
147     /*
148      * It is possible that displaying a messages causes a problem (e.g.,
149      * when redrawing the window), which causes another message, etc..	To
150      * break this loop, limit the recursiveness to 3 levels.
151      */
152     if (entered >= 3)
153 	return TRUE;
154     ++entered;
155 
156     /* Add message to history (unless it's a repeated kept message or a
157      * truncated message) */
158     if (s != keep_msg
159 	    || (*s != '<'
160 		&& last_msg_hist != NULL
161 		&& last_msg_hist->msg != NULL
162 		&& STRCMP(s, last_msg_hist->msg)))
163 	add_msg_hist(s, -1, attr);
164 
165     /* When displaying keep_msg, don't let msg_start() free it, caller must do
166      * that. */
167     if (s == keep_msg)
168 	keep_msg = NULL;
169 
170     /* Truncate the message if needed. */
171     msg_start();
172     buf = msg_strtrunc(s, FALSE);
173     if (buf != NULL)
174 	s = buf;
175 
176     msg_outtrans_attr(s, attr);
177     msg_clr_eos();
178     retval = msg_end();
179 
180     if (keep && retval && vim_strsize(s) < (int)(Rows - cmdline_row - 1)
181 							   * Columns + sc_col)
182 	set_keep_msg(s, 0);
183 
184     vim_free(buf);
185     --entered;
186     return retval;
187 }
188 
189 /*
190  * Truncate a string such that it can be printed without causing a scroll.
191  * Returns an allocated string or NULL when no truncating is done.
192  */
193     char_u *
194 msg_strtrunc(s, force)
195     char_u	*s;
196     int		force;	    /* always truncate */
197 {
198     char_u	*buf = NULL;
199     int		len;
200     int		room;
201 
202     /* May truncate message to avoid a hit-return prompt */
203     if ((!msg_scroll && !need_wait_return && shortmess(SHM_TRUNCALL)
204 			       && !exmode_active && msg_silent == 0) || force)
205     {
206 	len = vim_strsize(s);
207 	if (msg_scrolled != 0)
208 	    /* Use all the columns. */
209 	    room = (int)(Rows - msg_row) * Columns - 1;
210 	else
211 	    /* Use up to 'showcmd' column. */
212 	    room = (int)(Rows - msg_row - 1) * Columns + sc_col - 1;
213 	if (len > room && room > 0)
214 	{
215 #ifdef FEAT_MBYTE
216 	    if (enc_utf8)
217 		/* may have up to 18 bytes per cell (6 per char, up to two
218 		 * composing chars) */
219 		buf = alloc((room + 2) * 18);
220 	    else if (enc_dbcs == DBCS_JPNU)
221 		/* may have up to 2 bytes per cell for euc-jp */
222 		buf = alloc((room + 2) * 2);
223 	    else
224 #endif
225 		buf = alloc(room + 2);
226 	    if (buf != NULL)
227 		trunc_string(s, buf, room);
228 	}
229     }
230     return buf;
231 }
232 
233 /*
234  * Truncate a string "s" to "buf" with cell width "room".
235  * "s" and "buf" may be equal.
236  */
237     void
238 trunc_string(s, buf, room)
239     char_u	*s;
240     char_u	*buf;
241     int		room;
242 {
243     int		half;
244     int		len;
245     int		e;
246     int		i;
247     int		n;
248 
249     room -= 3;
250     half = room / 2;
251     len = 0;
252 
253     /* First part: Start of the string. */
254     for (e = 0; len < half; ++e)
255     {
256 	if (s[e] == NUL)
257 	{
258 	    /* text fits without truncating! */
259 	    buf[e] = NUL;
260 	    return;
261 	}
262 	n = ptr2cells(s + e);
263 	if (len + n >= half)
264 	    break;
265 	len += n;
266 	buf[e] = s[e];
267 #ifdef FEAT_MBYTE
268 	if (has_mbyte)
269 	    for (n = (*mb_ptr2len)(s + e); --n > 0; )
270 	    {
271 		++e;
272 		buf[e] = s[e];
273 	    }
274 #endif
275     }
276 
277     /* Last part: End of the string. */
278     i = e;
279 #ifdef FEAT_MBYTE
280     if (enc_dbcs != 0)
281     {
282 	/* For DBCS going backwards in a string is slow, but
283 	 * computing the cell width isn't too slow: go forward
284 	 * until the rest fits. */
285 	n = vim_strsize(s + i);
286 	while (len + n > room)
287 	{
288 	    n -= ptr2cells(s + i);
289 	    i += (*mb_ptr2len)(s + i);
290 	}
291     }
292     else if (enc_utf8)
293     {
294 	/* For UTF-8 we can go backwards easily. */
295 	half = i = (int)STRLEN(s);
296 	for (;;)
297 	{
298 	    do
299 		half = half - (*mb_head_off)(s, s + half - 1) - 1;
300 	    while (utf_iscomposing(utf_ptr2char(s + half)) && half > 0);
301 	    n = ptr2cells(s + half);
302 	    if (len + n > room)
303 		break;
304 	    len += n;
305 	    i = half;
306 	}
307     }
308     else
309 #endif
310     {
311 	for (i = (int)STRLEN(s); len + (n = ptr2cells(s + i - 1)) <= room; --i)
312 	    len += n;
313     }
314 
315     /* Set the middle and copy the last part. */
316     mch_memmove(buf + e, "...", (size_t)3);
317     mch_memmove(buf + e + 3, s + i, STRLEN(s + i) + 1);
318 }
319 
320 /*
321  * Automatic prototype generation does not understand this function.
322  * Note: Caller of smgs() and smsg_attr() must check the resulting string is
323  * shorter than IOSIZE!!!
324  */
325 #ifndef PROTO
326 # ifndef HAVE_STDARG_H
327 
328 int
329 #ifdef __BORLANDC__
330 _RTLENTRYF
331 #endif
332 smsg __ARGS((char_u *, long, long, long,
333 			long, long, long, long, long, long, long));
334 int
335 #ifdef __BORLANDC__
336 _RTLENTRYF
337 #endif
338 smsg_attr __ARGS((int, char_u *, long, long, long,
339 			long, long, long, long, long, long, long));
340 
341 int vim_snprintf __ARGS((char *, size_t, char *, long, long, long,
342 				   long, long, long, long, long, long, long));
343 
344 /*
345  * smsg(str, arg, ...) is like using sprintf(buf, str, arg, ...) and then
346  * calling msg(buf).
347  * The buffer used is IObuff, the message is truncated at IOSIZE.
348  */
349 
350 /* VARARGS */
351     int
352 #ifdef __BORLANDC__
353 _RTLENTRYF
354 #endif
355 smsg(s, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10)
356     char_u	*s;
357     long	a1, a2, a3, a4, a5, a6, a7, a8, a9, a10;
358 {
359     return smsg_attr(0, s, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10);
360 }
361 
362 /* VARARGS */
363     int
364 #ifdef __BORLANDC__
365 _RTLENTRYF
366 #endif
367 smsg_attr(attr, s, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10)
368     int		attr;
369     char_u	*s;
370     long	a1, a2, a3, a4, a5, a6, a7, a8, a9, a10;
371 {
372     vim_snprintf((char *)IObuff, IOSIZE, (char *)s,
373 				     a1, a2, a3, a4, a5, a6, a7, a8, a9, a10);
374     return msg_attr(IObuff, attr);
375 }
376 
377 # else /* HAVE_STDARG_H */
378 
379 int vim_snprintf(char *str, size_t str_m, char *fmt, ...);
380 
381     int
382 #ifdef __BORLANDC__
383 _RTLENTRYF
384 #endif
385 smsg(char_u *s, ...)
386 {
387     va_list arglist;
388 
389     va_start(arglist, s);
390     vim_vsnprintf((char *)IObuff, IOSIZE, (char *)s, arglist, NULL);
391     va_end(arglist);
392     return msg(IObuff);
393 }
394 
395     int
396 #ifdef __BORLANDC__
397 _RTLENTRYF
398 #endif
399 smsg_attr(int attr, char_u *s, ...)
400 {
401     va_list arglist;
402 
403     va_start(arglist, s);
404     vim_vsnprintf((char *)IObuff, IOSIZE, (char *)s, arglist, NULL);
405     va_end(arglist);
406     return msg_attr(IObuff, attr);
407 }
408 
409 # endif /* HAVE_STDARG_H */
410 #endif
411 
412 /*
413  * Remember the last sourcing name/lnum used in an error message, so that it
414  * isn't printed each time when it didn't change.
415  */
416 static int	last_sourcing_lnum = 0;
417 static char_u   *last_sourcing_name = NULL;
418 
419 /*
420  * Reset the last used sourcing name/lnum.  Makes sure it is displayed again
421  * for the next error message;
422  */
423     void
424 reset_last_sourcing()
425 {
426     vim_free(last_sourcing_name);
427     last_sourcing_name = NULL;
428     last_sourcing_lnum = 0;
429 }
430 
431 /*
432  * Return TRUE if "sourcing_name" differs from "last_sourcing_name".
433  */
434     static int
435 other_sourcing_name()
436 {
437     if (sourcing_name != NULL)
438     {
439 	if (last_sourcing_name != NULL)
440 	    return STRCMP(sourcing_name, last_sourcing_name) != 0;
441 	return TRUE;
442     }
443     return FALSE;
444 }
445 
446 /*
447  * Get the message about the source, as used for an error message.
448  * Returns an allocated string with room for one more character.
449  * Returns NULL when no message is to be given.
450  */
451     static char_u *
452 get_emsg_source()
453 {
454     char_u	*Buf, *p;
455 
456     if (sourcing_name != NULL && other_sourcing_name())
457     {
458 	p = (char_u *)_("Error detected while processing %s:");
459 	Buf = alloc((unsigned)(STRLEN(sourcing_name) + STRLEN(p)));
460 	if (Buf != NULL)
461 	    sprintf((char *)Buf, (char *)p, sourcing_name);
462 	return Buf;
463     }
464     return NULL;
465 }
466 
467 /*
468  * Get the message about the source lnum, as used for an error message.
469  * Returns an allocated string with room for one more character.
470  * Returns NULL when no message is to be given.
471  */
472     static char_u *
473 get_emsg_lnum()
474 {
475     char_u	*Buf, *p;
476 
477     /* lnum is 0 when executing a command from the command line
478      * argument, we don't want a line number then */
479     if (sourcing_name != NULL
480 	    && (other_sourcing_name() || sourcing_lnum != last_sourcing_lnum)
481 	    && sourcing_lnum != 0)
482     {
483 	p = (char_u *)_("line %4ld:");
484 	Buf = alloc((unsigned)(STRLEN(p) + 20));
485 	if (Buf != NULL)
486 	    sprintf((char *)Buf, (char *)p, (long)sourcing_lnum);
487 	return Buf;
488     }
489     return NULL;
490 }
491 
492 /*
493  * Display name and line number for the source of an error.
494  * Remember the file name and line number, so that for the next error the info
495  * is only displayed if it changed.
496  */
497     void
498 msg_source(attr)
499     int		attr;
500 {
501     char_u	*p;
502 
503     ++no_wait_return;
504     p = get_emsg_source();
505     if (p != NULL)
506     {
507 	msg_attr(p, attr);
508 	vim_free(p);
509     }
510     p = get_emsg_lnum();
511     if (p != NULL)
512     {
513 	msg_attr(p, hl_attr(HLF_N));
514 	vim_free(p);
515 	last_sourcing_lnum = sourcing_lnum;  /* only once for each line */
516     }
517 
518     /* remember the last sourcing name printed, also when it's empty */
519     if (sourcing_name == NULL || other_sourcing_name())
520     {
521 	vim_free(last_sourcing_name);
522 	if (sourcing_name == NULL)
523 	    last_sourcing_name = NULL;
524 	else
525 	    last_sourcing_name = vim_strsave(sourcing_name);
526     }
527     --no_wait_return;
528 }
529 
530 /*
531  * Return TRUE if not giving error messages right now:
532  * If "emsg_off" is set: no error messages at the moment.
533  * If "msg" is in 'debug': do error message but without side effects.
534  * If "emsg_skip" is set: never do error messages.
535  */
536     int
537 emsg_not_now()
538 {
539     if ((emsg_off > 0 && vim_strchr(p_debug, 'm') == NULL
540 					  && vim_strchr(p_debug, 't') == NULL)
541 #ifdef FEAT_EVAL
542 	    || emsg_skip > 0
543 #endif
544 	    )
545 	return TRUE;
546     return FALSE;
547 }
548 
549 /*
550  * emsg() - display an error message
551  *
552  * Rings the bell, if appropriate, and calls message() to do the real work
553  * When terminal not initialized (yet) mch_errmsg(..) is used.
554  *
555  * return TRUE if wait_return not called
556  */
557     int
558 emsg(s)
559     char_u	*s;
560 {
561     int		attr;
562     char_u	*p;
563 #ifdef FEAT_EVAL
564     int		ignore = FALSE;
565     int		severe;
566 #endif
567 
568     called_emsg = TRUE;
569     ex_exitval = 1;
570 
571     /*
572      * If "emsg_severe" is TRUE: When an error exception is to be thrown,
573      * prefer this message over previous messages for the same command.
574      */
575 #ifdef FEAT_EVAL
576     severe = emsg_severe;
577     emsg_severe = FALSE;
578 #endif
579 
580     /* Skip this if not giving error messages at the moment. */
581     if (emsg_not_now())
582 	return TRUE;
583 
584     if (!emsg_off || vim_strchr(p_debug, 't') != NULL)
585     {
586 #ifdef FEAT_EVAL
587 	/*
588 	 * Cause a throw of an error exception if appropriate.  Don't display
589 	 * the error message in this case.  (If no matching catch clause will
590 	 * be found, the message will be displayed later on.)  "ignore" is set
591 	 * when the message should be ignored completely (used for the
592 	 * interrupt message).
593 	 */
594 	if (cause_errthrow(s, severe, &ignore) == TRUE)
595 	{
596 	    if (!ignore)
597 		did_emsg = TRUE;
598 	    return TRUE;
599 	}
600 
601 	/* set "v:errmsg", also when using ":silent! cmd" */
602 	set_vim_var_string(VV_ERRMSG, s, -1);
603 #endif
604 
605 	/*
606 	 * When using ":silent! cmd" ignore error messsages.
607 	 * But do write it to the redirection file.
608 	 */
609 	if (emsg_silent != 0)
610 	{
611 	    msg_start();
612 	    p = get_emsg_source();
613 	    if (p != NULL)
614 	    {
615 		STRCAT(p, "\n");
616 		redir_write(p, -1);
617 		vim_free(p);
618 	    }
619 	    p = get_emsg_lnum();
620 	    if (p != NULL)
621 	    {
622 		STRCAT(p, "\n");
623 		redir_write(p, -1);
624 		vim_free(p);
625 	    }
626 	    redir_write(s, -1);
627 	    return TRUE;
628 	}
629 
630 	/* Reset msg_silent, an error causes messages to be switched back on. */
631 	msg_silent = 0;
632 	cmd_silent = FALSE;
633 
634 	if (global_busy)		/* break :global command */
635 	    ++global_busy;
636 
637 	if (p_eb)
638 	    beep_flush();		/* also includes flush_buffers() */
639 	else
640 	    flush_buffers(FALSE);	/* flush internal buffers */
641 	did_emsg = TRUE;		/* flag for DoOneCmd() */
642     }
643 
644     emsg_on_display = TRUE;	/* remember there is an error message */
645     ++msg_scroll;		/* don't overwrite a previous message */
646     attr = hl_attr(HLF_E);	/* set highlight mode for error messages */
647     if (msg_scrolled != 0)
648 	need_wait_return = TRUE;    /* needed in case emsg() is called after
649 				     * wait_return has reset need_wait_return
650 				     * and a redraw is expected because
651 				     * msg_scrolled is non-zero */
652 
653     /*
654      * Display name and line number for the source of the error.
655      */
656     msg_source(attr);
657 
658     /*
659      * Display the error message itself.
660      */
661     msg_nowait = FALSE;			/* wait for this msg */
662     return msg_attr(s, attr);
663 }
664 
665 /*
666  * Print an error message with one "%s" and one string argument.
667  */
668     int
669 emsg2(s, a1)
670     char_u *s, *a1;
671 {
672     return emsg3(s, a1, NULL);
673 }
674 
675 /* emsg3() and emsgn() are in misc2.c to avoid warnings for the prototypes. */
676 
677     void
678 emsg_invreg(name)
679     int	    name;
680 {
681     EMSG2(_("E354: Invalid register name: '%s'"), transchar(name));
682 }
683 
684 /*
685  * Like msg(), but truncate to a single line if p_shm contains 't', or when
686  * "force" is TRUE.  This truncates in another way as for normal messages.
687  * Careful: The string may be changed by msg_may_trunc()!
688  * Returns a pointer to the printed message, if wait_return() not called.
689  */
690     char_u *
691 msg_trunc_attr(s, force, attr)
692     char_u	*s;
693     int		force;
694     int		attr;
695 {
696     int		n;
697 
698     /* Add message to history before truncating */
699     add_msg_hist(s, -1, attr);
700 
701     s = msg_may_trunc(force, s);
702 
703     msg_hist_off = TRUE;
704     n = msg_attr(s, attr);
705     msg_hist_off = FALSE;
706 
707     if (n)
708 	return s;
709     return NULL;
710 }
711 
712 /*
713  * Check if message "s" should be truncated at the start (for filenames).
714  * Return a pointer to where the truncated message starts.
715  * Note: May change the message by replacing a character with '<'.
716  */
717     char_u *
718 msg_may_trunc(force, s)
719     int		force;
720     char_u	*s;
721 {
722     int		n;
723     int		room;
724 
725     room = (int)(Rows - cmdline_row - 1) * Columns + sc_col - 1;
726     if ((force || (shortmess(SHM_TRUNC) && !exmode_active))
727 	    && (n = (int)STRLEN(s) - room) > 0)
728     {
729 #ifdef FEAT_MBYTE
730 	if (has_mbyte)
731 	{
732 	    int	size = vim_strsize(s);
733 
734 	    /* There may be room anyway when there are multibyte chars. */
735 	    if (size <= room)
736 		return s;
737 
738 	    for (n = 0; size >= room; )
739 	    {
740 		size -= (*mb_ptr2cells)(s + n);
741 		n += (*mb_ptr2len)(s + n);
742 	    }
743 	    --n;
744 	}
745 #endif
746 	s += n;
747 	*s = '<';
748     }
749     return s;
750 }
751 
752     static void
753 add_msg_hist(s, len, attr)
754     char_u	*s;
755     int		len;		/* -1 for undetermined length */
756     int		attr;
757 {
758     struct msg_hist *p;
759 
760     if (msg_hist_off || msg_silent != 0)
761 	return;
762 
763     /* Don't let the message history get too big */
764     while (msg_hist_len > MAX_MSG_HIST_LEN)
765 	(void)delete_first_msg();
766 
767     /* allocate an entry and add the message at the end of the history */
768     p = (struct msg_hist *)alloc((int)sizeof(struct msg_hist));
769     if (p != NULL)
770     {
771 	if (len < 0)
772 	    len = (int)STRLEN(s);
773 	/* remove leading and trailing newlines */
774 	while (len > 0 && *s == '\n')
775 	{
776 	    ++s;
777 	    --len;
778 	}
779 	while (len > 0 && s[len - 1] == '\n')
780 	    --len;
781 	p->msg = vim_strnsave(s, len);
782 	p->next = NULL;
783 	p->attr = attr;
784 	if (last_msg_hist != NULL)
785 	    last_msg_hist->next = p;
786 	last_msg_hist = p;
787 	if (first_msg_hist == NULL)
788 	    first_msg_hist = last_msg_hist;
789 	++msg_hist_len;
790     }
791 }
792 
793 /*
794  * Delete the first (oldest) message from the history.
795  * Returns FAIL if there are no messages.
796  */
797     int
798 delete_first_msg()
799 {
800     struct msg_hist *p;
801 
802     if (msg_hist_len <= 0)
803 	return FAIL;
804     p = first_msg_hist;
805     first_msg_hist = p->next;
806     vim_free(p->msg);
807     vim_free(p);
808     --msg_hist_len;
809     return OK;
810 }
811 
812 /*
813  * ":messages" command.
814  */
815 /*ARGSUSED*/
816     void
817 ex_messages(eap)
818     exarg_T	*eap;
819 {
820     struct msg_hist *p;
821     char_u	    *s;
822 
823     msg_hist_off = TRUE;
824 
825     s = mch_getenv((char_u *)"LANG");
826     if (s != NULL && *s != NUL)
827 	msg_attr((char_u *)
828 		_("Messages maintainer: Bram Moolenaar <[email protected]>"),
829 		hl_attr(HLF_T));
830 
831     for (p = first_msg_hist; p != NULL; p = p->next)
832 	if (p->msg != NULL)
833 	    msg_attr(p->msg, p->attr);
834 
835     msg_hist_off = FALSE;
836 }
837 
838 #if defined(FEAT_CON_DIALOG) || defined(FIND_REPLACE_DIALOG) || defined(PROTO)
839 /*
840  * Call this after prompting the user.  This will avoid a hit-return message
841  * and a delay.
842  */
843     void
844 msg_end_prompt()
845 {
846     need_wait_return = FALSE;
847     emsg_on_display = FALSE;
848     cmdline_row = msg_row;
849     msg_col = 0;
850     msg_clr_eos();
851 }
852 #endif
853 
854 /*
855  * wait for the user to hit a key (normally a return)
856  * if 'redraw' is TRUE, clear and redraw the screen
857  * if 'redraw' is FALSE, just redraw the screen
858  * if 'redraw' is -1, don't redraw at all
859  */
860     void
861 wait_return(redraw)
862     int		redraw;
863 {
864     int		c;
865     int		oldState;
866     int		tmpState;
867     int		had_got_int;
868 
869     if (redraw == TRUE)
870 	must_redraw = CLEAR;
871 
872     /* If using ":silent cmd", don't wait for a return.  Also don't set
873      * need_wait_return to do it later. */
874     if (msg_silent != 0)
875 	return;
876 
877 /*
878  * With the global command (and some others) we only need one return at the
879  * end. Adjust cmdline_row to avoid the next message overwriting the last one.
880  * When inside vgetc(), we can't wait for a typed character at all.
881  */
882     if (vgetc_busy > 0)
883 	return;
884     if (no_wait_return)
885     {
886 	need_wait_return = TRUE;
887 	if (!exmode_active)
888 	    cmdline_row = msg_row;
889 	return;
890     }
891 
892     redir_off = TRUE;		/* don't redirect this message */
893     oldState = State;
894     if (quit_more)
895     {
896 	c = CAR;		/* just pretend CR was hit */
897 	quit_more = FALSE;
898 	got_int = FALSE;
899     }
900     else if (exmode_active)
901     {
902 	MSG_PUTS(" ");		/* make sure the cursor is on the right line */
903 	c = CAR;		/* no need for a return in ex mode */
904 	got_int = FALSE;
905     }
906     else
907     {
908 	/* Make sure the hit-return prompt is on screen when 'guioptions' was
909 	 * just changed. */
910 	screenalloc(FALSE);
911 
912 	State = HITRETURN;
913 #ifdef FEAT_MOUSE
914 	setmouse();
915 #endif
916 #ifdef USE_ON_FLY_SCROLL
917 	dont_scroll = TRUE;		/* disallow scrolling here */
918 #endif
919 	hit_return_msg();
920 
921 	do
922 	{
923 	    /* Remember "got_int", if it is set vgetc() probably returns a
924 	     * CTRL-C, but we need to loop then. */
925 	    had_got_int = got_int;
926 
927 	    /* Don't do mappings here, we put the character back in the
928 	     * typeahead buffer. */
929 	    ++no_mapping;
930 	    ++allow_keys;
931 	    c = safe_vgetc();
932 	    if (had_got_int && !global_busy)
933 		got_int = FALSE;
934 	    --no_mapping;
935 	    --allow_keys;
936 
937 #ifdef FEAT_CLIPBOARD
938 	    /* Strange way to allow copying (yanking) a modeless selection at
939 	     * the hit-enter prompt.  Use CTRL-Y, because the same is used in
940 	     * Cmdline-mode and it's harmless when there is no selection. */
941 	    if (c == Ctrl_Y && clip_star.state == SELECT_DONE)
942 	    {
943 		clip_copy_modeless_selection(TRUE);
944 		c = K_IGNORE;
945 	    }
946 #endif
947 	    /*
948 	     * Allow scrolling back in the messages.
949 	     * Also accept scroll-down commands when messages fill the screen,
950 	     * to avoid that typing one 'j' too many makes the messages
951 	     * disappear.
952 	     */
953 	    if (p_more && !p_cp)
954 	    {
955 		if (c == 'b' || c == 'k' || c == 'u' || c == 'g' || c == K_UP)
956 		{
957 		    /* scroll back to show older messages */
958 		    do_more_prompt(c);
959 		    if (quit_more)
960 		    {
961 			c = CAR;		/* just pretend CR was hit */
962 			quit_more = FALSE;
963 			got_int = FALSE;
964 		    }
965 		    else
966 		    {
967 			c = K_IGNORE;
968 			hit_return_msg();
969 		    }
970 		}
971 		else if (msg_scrolled > Rows - 2
972 				     && (c == 'j' || c == K_DOWN || c == 'd'))
973 		    c = K_IGNORE;
974 	    }
975 	} while ((had_got_int && c == Ctrl_C)
976 				|| c == K_IGNORE
977 #ifdef FEAT_GUI
978 				|| c == K_VER_SCROLLBAR || c == K_HOR_SCROLLBAR
979 #endif
980 #ifdef FEAT_MOUSE
981 				|| c == K_LEFTDRAG   || c == K_LEFTRELEASE
982 				|| c == K_MIDDLEDRAG || c == K_MIDDLERELEASE
983 				|| c == K_RIGHTDRAG  || c == K_RIGHTRELEASE
984 				|| c == K_MOUSEDOWN  || c == K_MOUSEUP
985 				|| (!mouse_has(MOUSE_RETURN)
986 				    && mouse_row < msg_row
987 				    && (c == K_LEFTMOUSE
988 					|| c == K_MIDDLEMOUSE
989 					|| c == K_RIGHTMOUSE
990 					|| c == K_X1MOUSE
991 					|| c == K_X2MOUSE))
992 #endif
993 				);
994 	ui_breakcheck();
995 #ifdef FEAT_MOUSE
996 	/*
997 	 * Avoid that the mouse-up event causes visual mode to start.
998 	 */
999 	if (c == K_LEFTMOUSE || c == K_MIDDLEMOUSE || c == K_RIGHTMOUSE
1000 					  || c == K_X1MOUSE || c == K_X2MOUSE)
1001 	    (void)jump_to_mouse(MOUSE_SETPOS, NULL, 0);
1002 	else
1003 #endif
1004 	    if (vim_strchr((char_u *)"\r\n ", c) == NULL && c != Ctrl_C)
1005 	{
1006 	    /* Put the character back in the typeahead buffer.  Don't use the
1007 	     * stuff buffer, because lmaps wouldn't work. */
1008 	    ins_char_typebuf(c);
1009 	    do_redraw = TRUE;	    /* need a redraw even though there is
1010 				       typeahead */
1011 	}
1012     }
1013     redir_off = FALSE;
1014 
1015     /*
1016      * If the user hits ':', '?' or '/' we get a command line from the next
1017      * line.
1018      */
1019     if (c == ':' || c == '?' || c == '/')
1020     {
1021 	if (!exmode_active)
1022 	    cmdline_row = msg_row;
1023 	skip_redraw = TRUE;	    /* skip redraw once */
1024 	do_redraw = FALSE;
1025     }
1026 
1027     /*
1028      * If the window size changed set_shellsize() will redraw the screen.
1029      * Otherwise the screen is only redrawn if 'redraw' is set and no ':'
1030      * typed.
1031      */
1032     tmpState = State;
1033     State = oldState;		    /* restore State before set_shellsize */
1034 #ifdef FEAT_MOUSE
1035     setmouse();
1036 #endif
1037     msg_check();
1038 
1039 #if defined(UNIX) || defined(VMS)
1040     /*
1041      * When switching screens, we need to output an extra newline on exit.
1042      */
1043     if (swapping_screen() && !termcap_active)
1044 	newline_on_exit = TRUE;
1045 #endif
1046 
1047     need_wait_return = FALSE;
1048     did_wait_return = TRUE;
1049     emsg_on_display = FALSE;	/* can delete error message now */
1050     lines_left = -1;		/* reset lines_left at next msg_start() */
1051     reset_last_sourcing();
1052     if (keep_msg != NULL && vim_strsize(keep_msg) >=
1053 				  (Rows - cmdline_row - 1) * Columns + sc_col)
1054     {
1055 	vim_free(keep_msg);
1056 	keep_msg = NULL;	    /* don't redisplay message, it's too long */
1057     }
1058 
1059     if (tmpState == SETWSIZE)	    /* got resize event while in vgetc() */
1060     {
1061 	starttermcap();		    /* start termcap before redrawing */
1062 	shell_resized();
1063     }
1064     else if (!skip_redraw
1065 	    && (redraw == TRUE || (msg_scrolled != 0 && redraw != -1)))
1066     {
1067 	starttermcap();		    /* start termcap before redrawing */
1068 	redraw_later(VALID);
1069     }
1070 }
1071 
1072 /*
1073  * Write the hit-return prompt.
1074  */
1075     static void
1076 hit_return_msg()
1077 {
1078     int		save_p_more = p_more;
1079 
1080     p_more = FALSE;	/* don't want see this message when scrolling back */
1081     if (msg_didout)	/* start on a new line */
1082 	msg_putchar('\n');
1083     if (got_int)
1084 	MSG_PUTS(_("Interrupt: "));
1085 
1086     MSG_PUTS_ATTR(_("Press ENTER or type command to continue"), hl_attr(HLF_R));
1087     if (!msg_use_printf())
1088 	msg_clr_eos();
1089     p_more = save_p_more;
1090 }
1091 
1092 /*
1093  * Set "keep_msg" to "s".  Free the old value and check for NULL pointer.
1094  */
1095     void
1096 set_keep_msg(s, attr)
1097     char_u	*s;
1098     int		attr;
1099 {
1100     vim_free(keep_msg);
1101     if (s != NULL && msg_silent == 0)
1102 	keep_msg = vim_strsave(s);
1103     else
1104 	keep_msg = NULL;
1105     keep_msg_more = FALSE;
1106     keep_msg_attr = attr;
1107 }
1108 
1109 #if defined(FEAT_TERMRESPONSE) || defined(PROTO)
1110 /*
1111  * If there currently is a message being displayed, set "keep_msg" to it, so
1112  * that it will be displayed again after redraw.
1113  */
1114     void
1115 set_keep_msg_from_hist()
1116 {
1117     if (keep_msg == NULL && last_msg_hist != NULL && msg_scrolled == 0
1118 							  && (State & NORMAL))
1119 	set_keep_msg(last_msg_hist->msg, last_msg_hist->attr);
1120 }
1121 #endif
1122 
1123 /*
1124  * Prepare for outputting characters in the command line.
1125  */
1126     void
1127 msg_start()
1128 {
1129     int		did_return = FALSE;
1130 
1131     vim_free(keep_msg);
1132     keep_msg = NULL;			/* don't display old message now */
1133     if (!msg_scroll && full_screen)	/* overwrite last message */
1134     {
1135 	msg_row = cmdline_row;
1136 	msg_col =
1137 #ifdef FEAT_RIGHTLEFT
1138 	    cmdmsg_rl ? Columns - 1 :
1139 #endif
1140 	    0;
1141     }
1142     else if (msg_didout)		    /* start message on next line */
1143     {
1144 	msg_putchar('\n');
1145 	did_return = TRUE;
1146 	if (exmode_active != EXMODE_NORMAL)
1147 	    cmdline_row = msg_row;
1148     }
1149     if (!msg_didany || lines_left < 0)
1150 	msg_starthere();
1151     if (msg_silent == 0)
1152     {
1153 	msg_didout = FALSE;		    /* no output on current line yet */
1154 	cursor_off();
1155     }
1156 
1157     /* when redirecting, may need to start a new line. */
1158     if (!did_return)
1159 	redir_write((char_u *)"\n", -1);
1160 }
1161 
1162 /*
1163  * Note that the current msg position is where messages start.
1164  */
1165     void
1166 msg_starthere()
1167 {
1168     lines_left = cmdline_row;
1169     msg_didany = FALSE;
1170 }
1171 
1172     void
1173 msg_putchar(c)
1174     int		c;
1175 {
1176     msg_putchar_attr(c, 0);
1177 }
1178 
1179     void
1180 msg_putchar_attr(c, attr)
1181     int		c;
1182     int		attr;
1183 {
1184 #ifdef FEAT_MBYTE
1185     char_u	buf[MB_MAXBYTES + 1];
1186 #else
1187     char_u	buf[4];
1188 #endif
1189 
1190     if (IS_SPECIAL(c))
1191     {
1192 	buf[0] = K_SPECIAL;
1193 	buf[1] = K_SECOND(c);
1194 	buf[2] = K_THIRD(c);
1195 	buf[3] = NUL;
1196     }
1197     else
1198     {
1199 #ifdef FEAT_MBYTE
1200 	buf[(*mb_char2bytes)(c, buf)] = NUL;
1201 #else
1202 	buf[0] = c;
1203 	buf[1] = NUL;
1204 #endif
1205     }
1206     msg_puts_attr(buf, attr);
1207 }
1208 
1209     void
1210 msg_outnum(n)
1211     long	n;
1212 {
1213     char_u	buf[20];
1214 
1215     sprintf((char *)buf, "%ld", n);
1216     msg_puts(buf);
1217 }
1218 
1219     void
1220 msg_home_replace(fname)
1221     char_u	*fname;
1222 {
1223     msg_home_replace_attr(fname, 0);
1224 }
1225 
1226 #if defined(FEAT_FIND_ID) || defined(PROTO)
1227     void
1228 msg_home_replace_hl(fname)
1229     char_u	*fname;
1230 {
1231     msg_home_replace_attr(fname, hl_attr(HLF_D));
1232 }
1233 #endif
1234 
1235     static void
1236 msg_home_replace_attr(fname, attr)
1237     char_u  *fname;
1238     int	    attr;
1239 {
1240     char_u	*name;
1241 
1242     name = home_replace_save(NULL, fname);
1243     if (name != NULL)
1244 	msg_outtrans_attr(name, attr);
1245     vim_free(name);
1246 }
1247 
1248 /*
1249  * Output 'len' characters in 'str' (including NULs) with translation
1250  * if 'len' is -1, output upto a NUL character.
1251  * Use attributes 'attr'.
1252  * Return the number of characters it takes on the screen.
1253  */
1254     int
1255 msg_outtrans(str)
1256     char_u	    *str;
1257 {
1258     return msg_outtrans_attr(str, 0);
1259 }
1260 
1261     int
1262 msg_outtrans_attr(str, attr)
1263     char_u	*str;
1264     int		attr;
1265 {
1266     return msg_outtrans_len_attr(str, (int)STRLEN(str), attr);
1267 }
1268 
1269     int
1270 msg_outtrans_len(str, len)
1271     char_u	*str;
1272     int		len;
1273 {
1274     return msg_outtrans_len_attr(str, len, 0);
1275 }
1276 
1277 /*
1278  * Output one character at "p".  Return pointer to the next character.
1279  * Handles multi-byte characters.
1280  */
1281     char_u *
1282 msg_outtrans_one(p, attr)
1283     char_u	*p;
1284     int		attr;
1285 {
1286 #ifdef FEAT_MBYTE
1287     int		l;
1288 
1289     if (has_mbyte && (l = (*mb_ptr2len)(p)) > 1)
1290     {
1291 	msg_outtrans_len_attr(p, l, attr);
1292 	return p + l;
1293     }
1294 #endif
1295     msg_puts_attr(transchar_byte(*p), attr);
1296     return p + 1;
1297 }
1298 
1299     int
1300 msg_outtrans_len_attr(msgstr, len, attr)
1301     char_u	*msgstr;
1302     int		len;
1303     int		attr;
1304 {
1305     int		retval = 0;
1306     char_u	*str = msgstr;
1307     char_u	*plain_start = msgstr;
1308     char_u	*s;
1309 #ifdef FEAT_MBYTE
1310     int		mb_l;
1311     int		c;
1312 #endif
1313 
1314     /* if MSG_HIST flag set, add message to history */
1315     if (attr & MSG_HIST)
1316     {
1317 	add_msg_hist(str, len, attr);
1318 	attr &= ~MSG_HIST;
1319     }
1320 
1321 #ifdef FEAT_MBYTE
1322     /* If the string starts with a composing character first draw a space on
1323      * which the composing char can be drawn. */
1324     if (enc_utf8 && utf_iscomposing(utf_ptr2char(msgstr)))
1325 	msg_puts_attr((char_u *)" ", attr);
1326 #endif
1327 
1328     /*
1329      * Go over the string.  Special characters are translated and printed.
1330      * Normal characters are printed several at a time.
1331      */
1332     while (--len >= 0)
1333     {
1334 #ifdef FEAT_MBYTE
1335 	if (enc_utf8)
1336 	    /* Don't include composing chars after the end. */
1337 	    mb_l = utfc_ptr2len_len(str, len + 1);
1338 	else if (has_mbyte)
1339 	    mb_l = (*mb_ptr2len)(str);
1340 	else
1341 	    mb_l = 1;
1342 	if (has_mbyte && mb_l > 1)
1343 	{
1344 	    c = (*mb_ptr2char)(str);
1345 	    if (vim_isprintc(c))
1346 		/* printable multi-byte char: count the cells. */
1347 		retval += (*mb_ptr2cells)(str);
1348 	    else
1349 	    {
1350 		/* unprintable multi-byte char: print the printable chars so
1351 		 * far and the translation of the unprintable char. */
1352 		if (str > plain_start)
1353 		    msg_puts_attr_len(plain_start, (int)(str - plain_start),
1354 									attr);
1355 		plain_start = str + mb_l;
1356 		msg_puts_attr(transchar(c), attr == 0 ? hl_attr(HLF_8) : attr);
1357 		retval += char2cells(c);
1358 	    }
1359 	    len -= mb_l - 1;
1360 	    str += mb_l;
1361 	}
1362 	else
1363 #endif
1364 	{
1365 	    s = transchar_byte(*str);
1366 	    if (s[1] != NUL)
1367 	    {
1368 		/* unprintable char: print the printable chars so far and the
1369 		 * translation of the unprintable char. */
1370 		if (str > plain_start)
1371 		    msg_puts_attr_len(plain_start, (int)(str - plain_start),
1372 									attr);
1373 		plain_start = str + 1;
1374 		msg_puts_attr(s, attr == 0 ? hl_attr(HLF_8) : attr);
1375 	    }
1376 	    retval += ptr2cells(str);
1377 	    ++str;
1378 	}
1379     }
1380 
1381     if (str > plain_start)
1382 	/* print the printable chars at the end */
1383 	msg_puts_attr_len(plain_start, (int)(str - plain_start), attr);
1384 
1385     return retval;
1386 }
1387 
1388 #if defined(FEAT_QUICKFIX) || defined(PROTO)
1389     void
1390 msg_make(arg)
1391     char_u  *arg;
1392 {
1393     int	    i;
1394     static char_u *str = (char_u *)"eeffoc", *rs = (char_u *)"Plon#dqg#vxjduB";
1395 
1396     arg = skipwhite(arg);
1397     for (i = 5; *arg && i >= 0; --i)
1398 	if (*arg++ != str[i])
1399 	    break;
1400     if (i < 0)
1401     {
1402 	msg_putchar('\n');
1403 	for (i = 0; rs[i]; ++i)
1404 	    msg_putchar(rs[i] - 3);
1405     }
1406 }
1407 #endif
1408 
1409 /*
1410  * Output the string 'str' upto a NUL character.
1411  * Return the number of characters it takes on the screen.
1412  *
1413  * If K_SPECIAL is encountered, then it is taken in conjunction with the
1414  * following character and shown as <F1>, <S-Up> etc.  Any other character
1415  * which is not printable shown in <> form.
1416  * If 'from' is TRUE (lhs of a mapping), a space is shown as <Space>.
1417  * If a character is displayed in one of these special ways, is also
1418  * highlighted (its highlight name is '8' in the p_hl variable).
1419  * Otherwise characters are not highlighted.
1420  * This function is used to show mappings, where we want to see how to type
1421  * the character/string -- webb
1422  */
1423     int
1424 msg_outtrans_special(strstart, from)
1425     char_u	*strstart;
1426     int		from;	/* TRUE for lhs of a mapping */
1427 {
1428     char_u	*str = strstart;
1429     int		retval = 0;
1430     char_u	*string;
1431     int		attr;
1432     int		len;
1433 
1434     attr = hl_attr(HLF_8);
1435     while (*str != NUL)
1436     {
1437 	/* Leading and trailing spaces need to be displayed in <> form. */
1438 	if ((str == strstart || str[1] == NUL) && *str == ' ')
1439 	{
1440 	    string = (char_u *)"<Space>";
1441 	    ++str;
1442 	}
1443 	else
1444 	    string = str2special(&str, from);
1445 	len = vim_strsize(string);
1446 	/* Highlight special keys */
1447 	msg_puts_attr(string, len > 1
1448 #ifdef FEAT_MBYTE
1449 		&& (*mb_ptr2len)(string) <= 1
1450 #endif
1451 		? attr : 0);
1452 	retval += len;
1453     }
1454     return retval;
1455 }
1456 
1457 /*
1458  * Return the printable string for the key codes at "*sp".
1459  * Used for translating the lhs or rhs of a mapping to printable chars.
1460  * Advances "sp" to the next code.
1461  */
1462     char_u *
1463 str2special(sp, from)
1464     char_u	**sp;
1465     int		from;	/* TRUE for lhs of mapping */
1466 {
1467     int			c;
1468     static char_u	buf[7];
1469     char_u		*str = *sp;
1470     int			modifiers = 0;
1471     int			special = FALSE;
1472 
1473 #ifdef FEAT_MBYTE
1474     if (has_mbyte)
1475     {
1476 	char_u	*p;
1477 
1478 	/* Try to un-escape a multi-byte character.  Return the un-escaped
1479 	 * string if it is a multi-byte character. */
1480 	p = mb_unescape(sp);
1481 	if (p != NULL)
1482 	    return p;
1483     }
1484 #endif
1485 
1486     c = *str;
1487     if (c == K_SPECIAL && str[1] != NUL && str[2] != NUL)
1488     {
1489 	if (str[1] == KS_MODIFIER)
1490 	{
1491 	    modifiers = str[2];
1492 	    str += 3;
1493 	    c = *str;
1494 	}
1495 	if (c == K_SPECIAL && str[1] != NUL && str[2] != NUL)
1496 	{
1497 	    c = TO_SPECIAL(str[1], str[2]);
1498 	    str += 2;
1499 	    if (c == K_ZERO)	/* display <Nul> as ^@ */
1500 		c = NUL;
1501 	}
1502 	if (IS_SPECIAL(c) || modifiers)	/* special key */
1503 	    special = TRUE;
1504     }
1505     *sp = str + 1;
1506 
1507 #ifdef FEAT_MBYTE
1508     /* For multi-byte characters check for an illegal byte. */
1509     if (has_mbyte && MB_BYTE2LEN(*str) > (*mb_ptr2len)(str))
1510     {
1511 	transchar_nonprint(buf, c);
1512 	return buf;
1513     }
1514 #endif
1515 
1516     /* Make unprintable characters in <> form, also <M-Space> and <Tab>.
1517      * Use <Space> only for lhs of a mapping. */
1518     if (special || char2cells(c) > 1 || (from && c == ' '))
1519 	return get_special_key_name(c, modifiers);
1520     buf[0] = c;
1521     buf[1] = NUL;
1522     return buf;
1523 }
1524 
1525 /*
1526  * Translate a key sequence into special key names.
1527  */
1528     void
1529 str2specialbuf(sp, buf, len)
1530     char_u	*sp;
1531     char_u	*buf;
1532     int		len;
1533 {
1534     char_u	*s;
1535 
1536     *buf = NUL;
1537     while (*sp)
1538     {
1539 	s = str2special(&sp, FALSE);
1540 	if ((int)(STRLEN(s) + STRLEN(buf)) < len)
1541 	    STRCAT(buf, s);
1542     }
1543 }
1544 
1545 /*
1546  * print line for :print or :list command
1547  */
1548     void
1549 msg_prt_line(s, list)
1550     char_u	*s;
1551     int		list;
1552 {
1553     int		c;
1554     int		col = 0;
1555     int		n_extra = 0;
1556     int		c_extra = 0;
1557     char_u	*p_extra = NULL;	    /* init to make SASC shut up */
1558     int		n;
1559     int		attr = 0;
1560     char_u	*trail = NULL;
1561 #ifdef FEAT_MBYTE
1562     int		l;
1563     char_u	buf[MB_MAXBYTES + 1];
1564 #endif
1565 
1566     if (curwin->w_p_list)
1567 	list = TRUE;
1568 
1569     /* find start of trailing whitespace */
1570     if (list && lcs_trail)
1571     {
1572 	trail = s + STRLEN(s);
1573 	while (trail > s && vim_iswhite(trail[-1]))
1574 	    --trail;
1575     }
1576 
1577     /* output a space for an empty line, otherwise the line will be
1578      * overwritten */
1579     if (*s == NUL && !(list && lcs_eol != NUL))
1580 	msg_putchar(' ');
1581 
1582     while (!got_int)
1583     {
1584 	if (n_extra > 0)
1585 	{
1586 	    --n_extra;
1587 	    if (c_extra)
1588 		c = c_extra;
1589 	    else
1590 		c = *p_extra++;
1591 	}
1592 #ifdef FEAT_MBYTE
1593 	else if (has_mbyte && (l = (*mb_ptr2len)(s)) > 1)
1594 	{
1595 	    col += (*mb_ptr2cells)(s);
1596 	    mch_memmove(buf, s, (size_t)l);
1597 	    buf[l] = NUL;
1598 	    msg_puts(buf);
1599 	    s += l;
1600 	    continue;
1601 	}
1602 #endif
1603 	else
1604 	{
1605 	    attr = 0;
1606 	    c = *s++;
1607 	    if (c == TAB && (!list || lcs_tab1))
1608 	    {
1609 		/* tab amount depends on current column */
1610 		n_extra = curbuf->b_p_ts - col % curbuf->b_p_ts - 1;
1611 		if (!list)
1612 		{
1613 		    c = ' ';
1614 		    c_extra = ' ';
1615 		}
1616 		else
1617 		{
1618 		    c = lcs_tab1;
1619 		    c_extra = lcs_tab2;
1620 		    attr = hl_attr(HLF_8);
1621 		}
1622 	    }
1623 	    else if (c == NUL && list && lcs_eol != NUL)
1624 	    {
1625 		p_extra = (char_u *)"";
1626 		c_extra = NUL;
1627 		n_extra = 1;
1628 		c = lcs_eol;
1629 		attr = hl_attr(HLF_AT);
1630 		--s;
1631 	    }
1632 	    else if (c != NUL && (n = byte2cells(c)) > 1)
1633 	    {
1634 		n_extra = n - 1;
1635 		p_extra = transchar_byte(c);
1636 		c_extra = NUL;
1637 		c = *p_extra++;
1638 		/* Use special coloring to be able to distinguish <hex> from
1639 		 * the same in plain text. */
1640 		attr = hl_attr(HLF_8);
1641 	    }
1642 	    else if (c == ' ' && trail != NULL && s > trail)
1643 	    {
1644 		c = lcs_trail;
1645 		attr = hl_attr(HLF_8);
1646 	    }
1647 	}
1648 
1649 	if (c == NUL)
1650 	    break;
1651 
1652 	msg_putchar_attr(c, attr);
1653 	col++;
1654     }
1655     msg_clr_eos();
1656 }
1657 
1658 #ifdef FEAT_MBYTE
1659 /*
1660  * Use screen_puts() to output one multi-byte character.
1661  * Return the pointer "s" advanced to the next character.
1662  */
1663     static char_u *
1664 screen_puts_mbyte(s, l, attr)
1665     char_u	*s;
1666     int		l;
1667     int		attr;
1668 {
1669     int		cw;
1670 
1671     msg_didout = TRUE;		/* remember that line is not empty */
1672     cw = (*mb_ptr2cells)(s);
1673     if (cw > 1 && (
1674 #ifdef FEAT_RIGHTLEFT
1675 		cmdmsg_rl ? msg_col <= 1 :
1676 #endif
1677 		msg_col == Columns - 1))
1678     {
1679 	/* Doesn't fit, print a highlighted '>' to fill it up. */
1680 	msg_screen_putchar('>', hl_attr(HLF_AT));
1681 	return s;
1682     }
1683 
1684     screen_puts_len(s, l, msg_row, msg_col, attr);
1685 #ifdef FEAT_RIGHTLEFT
1686     if (cmdmsg_rl)
1687     {
1688 	msg_col -= cw;
1689 	if (msg_col == 0)
1690 	{
1691 	    msg_col = Columns;
1692 	    ++msg_row;
1693 	}
1694     }
1695     else
1696 #endif
1697     {
1698 	msg_col += cw;
1699 	if (msg_col >= Columns)
1700 	{
1701 	    msg_col = 0;
1702 	    ++msg_row;
1703 	}
1704     }
1705     return s + l;
1706 }
1707 #endif
1708 
1709 /*
1710  * Output a string to the screen at position msg_row, msg_col.
1711  * Update msg_row and msg_col for the next message.
1712  */
1713     void
1714 msg_puts(s)
1715     char_u	*s;
1716 {
1717     msg_puts_attr(s, 0);
1718 }
1719 
1720     void
1721 msg_puts_title(s)
1722     char_u	*s;
1723 {
1724     msg_puts_attr(s, hl_attr(HLF_T));
1725 }
1726 
1727 /*
1728  * Show a message in such a way that it always fits in the line.  Cut out a
1729  * part in the middle and replace it with "..." when necessary.
1730  * Does not handle multi-byte characters!
1731  */
1732     void
1733 msg_puts_long_attr(longstr, attr)
1734     char_u	*longstr;
1735     int		attr;
1736 {
1737     msg_puts_long_len_attr(longstr, (int)STRLEN(longstr), attr);
1738 }
1739 
1740     void
1741 msg_puts_long_len_attr(longstr, len, attr)
1742     char_u	*longstr;
1743     int		len;
1744     int		attr;
1745 {
1746     int		slen = len;
1747     int		room;
1748 
1749     room = Columns - msg_col;
1750     if (len > room && room >= 20)
1751     {
1752 	slen = (room - 3) / 2;
1753 	msg_outtrans_len_attr(longstr, slen, attr);
1754 	msg_puts_attr((char_u *)"...", hl_attr(HLF_8));
1755     }
1756     msg_outtrans_len_attr(longstr + len - slen, slen, attr);
1757 }
1758 
1759 /*
1760  * Basic function for writing a message with highlight attributes.
1761  */
1762     void
1763 msg_puts_attr(s, attr)
1764     char_u	*s;
1765     int		attr;
1766 {
1767     msg_puts_attr_len(s, -1, attr);
1768 }
1769 
1770 /*
1771  * Like msg_puts_attr(), but with a maximum length "maxlen" (in bytes).
1772  * When "maxlen" is -1 there is no maximum length.
1773  * When "maxlen" is >= 0 the message is not put in the history.
1774  */
1775     static void
1776 msg_puts_attr_len(str, maxlen, attr)
1777     char_u	*str;
1778     int		maxlen;
1779     int		attr;
1780 {
1781     /*
1782      * If redirection is on, also write to the redirection file.
1783      */
1784     redir_write(str, maxlen);
1785 
1786     /*
1787      * Don't print anything when using ":silent cmd".
1788      */
1789     if (msg_silent != 0)
1790 	return;
1791 
1792     /* if MSG_HIST flag set, add message to history */
1793     if ((attr & MSG_HIST) && maxlen < 0)
1794     {
1795 	add_msg_hist(str, -1, attr);
1796 	attr &= ~MSG_HIST;
1797     }
1798 
1799     /*
1800      * When writing something to the screen after it has scrolled, requires a
1801      * wait-return prompt later.  Needed when scrolling, resetting
1802      * need_wait_return after some prompt, and then outputting something
1803      * without scrolling
1804      */
1805     if (msg_scrolled != 0 && !msg_scrolled_ign)
1806 	need_wait_return = TRUE;
1807     msg_didany = TRUE;		/* remember that something was outputted */
1808 
1809     /*
1810      * If there is no valid screen, use fprintf so we can see error messages.
1811      * If termcap is not active, we may be writing in an alternate console
1812      * window, cursor positioning may not work correctly (window size may be
1813      * different, e.g. for Win32 console) or we just don't know where the
1814      * cursor is.
1815      */
1816     if (msg_use_printf())
1817 	msg_puts_printf(str, maxlen);
1818     else
1819 	msg_puts_display(str, maxlen, attr, FALSE);
1820 }
1821 
1822 /*
1823  * The display part of msg_puts_attr_len().
1824  * May be called recursively to display scroll-back text.
1825  */
1826     static void
1827 msg_puts_display(str, maxlen, attr, recurse)
1828     char_u	*str;
1829     int		maxlen;
1830     int		attr;
1831     int		recurse;
1832 {
1833     char_u	*s = str;
1834     char_u	*t_s = str;	/* string from "t_s" to "s" is still todo */
1835     int		t_col = 0;	/* screen cells todo, 0 when "t_s" not used */
1836 #ifdef FEAT_MBYTE
1837     int		l;
1838     int		cw;
1839 #endif
1840     char_u	*sb_str = str;
1841     int		sb_col = msg_col;
1842     int		wrap;
1843 
1844     did_wait_return = FALSE;
1845     while (*s != NUL && (maxlen < 0 || (int)(s - str) < maxlen))
1846     {
1847 	/*
1848 	 * We are at the end of the screen line when:
1849 	 * - When outputting a newline.
1850 	 * - When outputting a character in the last column.
1851 	 */
1852 	if (!recurse && msg_row >= Rows - 1 && (*s == '\n' || (
1853 #ifdef FEAT_RIGHTLEFT
1854 		    cmdmsg_rl
1855 		    ? (
1856 			msg_col <= 1
1857 			|| (*s == TAB && msg_col <= 7)
1858 # ifdef FEAT_MBYTE
1859 			|| (has_mbyte && (*mb_ptr2cells)(s) > 1 && msg_col <= 2)
1860 # endif
1861 		      )
1862 		    :
1863 #endif
1864 		      (msg_col + t_col >= Columns - 1
1865 		       || (*s == TAB && msg_col + t_col >= ((Columns - 1) & ~7))
1866 # ifdef FEAT_MBYTE
1867 		       || (has_mbyte && (*mb_ptr2cells)(s) > 1
1868 					    && msg_col + t_col >= Columns - 2)
1869 # endif
1870 		      ))))
1871 	{
1872 	    /*
1873 	     * The screen is scrolled up when at the last row (some terminals
1874 	     * scroll automatically, some don't.  To avoid problems we scroll
1875 	     * ourselves).
1876 	     */
1877 	    if (t_col > 0)
1878 		/* output postponed text */
1879 		t_puts(&t_col, t_s, s, attr);
1880 
1881 	    /* When no more prompt an no more room, truncate here */
1882 	    if (msg_no_more && lines_left == 0)
1883 		break;
1884 
1885 	    /* Scroll the screen up one line. */
1886 	    msg_scroll_up();
1887 
1888 	    msg_row = Rows - 2;
1889 	    if (msg_col >= Columns)	/* can happen after screen resize */
1890 		msg_col = Columns - 1;
1891 
1892 	    /* Display char in last column before showing more-prompt. */
1893 	    if (*s >= ' '
1894 #ifdef FEAT_RIGHTLEFT
1895 		    && !cmdmsg_rl
1896 #endif
1897 	       )
1898 	    {
1899 #ifdef FEAT_MBYTE
1900 		if (has_mbyte)
1901 		{
1902 		    if (enc_utf8 && maxlen >= 0)
1903 			/* avoid including composing chars after the end */
1904 			l = utfc_ptr2len_len(s, (int)((str + maxlen) - s));
1905 		    else
1906 			l = (*mb_ptr2len)(s);
1907 		    s = screen_puts_mbyte(s, l, attr);
1908 		}
1909 		else
1910 #endif
1911 		    msg_screen_putchar(*s++, attr);
1912 	    }
1913 
1914 	    if (p_more)
1915 		/* store text for scrolling back */
1916 		store_sb_text(&sb_str, s, attr, &sb_col, TRUE);
1917 
1918 	    inc_msg_scrolled();
1919 	    need_wait_return = TRUE; /* may need wait_return in main() */
1920 	    if (must_redraw < VALID)
1921 		must_redraw = VALID;
1922 	    redraw_cmdline = TRUE;
1923 	    if (cmdline_row > 0 && !exmode_active)
1924 		--cmdline_row;
1925 
1926 	    /*
1927 	     * If screen is completely filled and 'more' is set then wait
1928 	     * for a character.
1929 	     */
1930 	    --lines_left;
1931 	    if (p_more && lines_left == 0 && State != HITRETURN
1932 					    && !msg_no_more && !exmode_active)
1933 	    {
1934 #ifdef FEAT_CON_DIALOG
1935 		if (do_more_prompt(NUL))
1936 		    s = confirm_msg_tail;
1937 #else
1938 		(void)do_more_prompt(NUL);
1939 #endif
1940 		if (quit_more)
1941 		    return;
1942 	    }
1943 
1944 	    /* When we displayed a char in last column need to check if there
1945 	     * is still more. */
1946 	    if (*s >= ' '
1947 #ifdef FEAT_RIGHTLEFT
1948 		    && !cmdmsg_rl
1949 #endif
1950 	       )
1951 		continue;
1952 	}
1953 
1954 	wrap = *s == '\n'
1955 		    || msg_col + t_col >= Columns
1956 #ifdef FEAT_MBYTE
1957 		    || (has_mbyte && (*mb_ptr2cells)(s) > 1
1958 					    && msg_col + t_col >= Columns - 1)
1959 #endif
1960 		    ;
1961 	if (t_col > 0 && (wrap || *s == '\r' || *s == '\b'
1962 						 || *s == '\t' || *s == BELL))
1963 	    /* output any postponed text */
1964 	    t_puts(&t_col, t_s, s, attr);
1965 
1966 	if (wrap && p_more && !recurse)
1967 	    /* store text for scrolling back */
1968 	    store_sb_text(&sb_str, s, attr, &sb_col, TRUE);
1969 
1970 	if (*s == '\n')		    /* go to next line */
1971 	{
1972 	    msg_didout = FALSE;	    /* remember that line is empty */
1973 #ifdef FEAT_RIGHTLEFT
1974 	    if (cmdmsg_rl)
1975 		msg_col = Columns - 1;
1976 	    else
1977 #endif
1978 		msg_col = 0;
1979 	    if (++msg_row >= Rows)  /* safety check */
1980 		msg_row = Rows - 1;
1981 	}
1982 	else if (*s == '\r')	    /* go to column 0 */
1983 	{
1984 	    msg_col = 0;
1985 	}
1986 	else if (*s == '\b')	    /* go to previous char */
1987 	{
1988 	    if (msg_col)
1989 		--msg_col;
1990 	}
1991 	else if (*s == TAB)	    /* translate Tab into spaces */
1992 	{
1993 	    do
1994 		msg_screen_putchar(' ', attr);
1995 	    while (msg_col & 7);
1996 	}
1997 	else if (*s == BELL)	    /* beep (from ":sh") */
1998 	    vim_beep();
1999 	else
2000 	{
2001 #ifdef FEAT_MBYTE
2002 	    if (has_mbyte)
2003 	    {
2004 		cw = (*mb_ptr2cells)(s);
2005 		if (enc_utf8 && maxlen >= 0)
2006 		    /* avoid including composing chars after the end */
2007 		    l = utfc_ptr2len_len(s, (int)((str + maxlen) - s));
2008 		else
2009 		    l = (*mb_ptr2len)(s);
2010 	    }
2011 	    else
2012 	    {
2013 		cw = 1;
2014 		l = 1;
2015 	    }
2016 #endif
2017 	    /* When drawing from right to left or when a double-wide character
2018 	     * doesn't fit, draw a single character here.  Otherwise collect
2019 	     * characters and draw them all at once later. */
2020 #if defined(FEAT_RIGHTLEFT) || defined(FEAT_MBYTE)
2021 	    if (
2022 # ifdef FEAT_RIGHTLEFT
2023 		    cmdmsg_rl
2024 #  ifdef FEAT_MBYTE
2025 		    ||
2026 #  endif
2027 # endif
2028 # ifdef FEAT_MBYTE
2029 		    (cw > 1 && msg_col + t_col >= Columns - 1)
2030 # endif
2031 		    )
2032 	    {
2033 # ifdef FEAT_MBYTE
2034 		if (l > 1)
2035 		    s = screen_puts_mbyte(s, l, attr) - 1;
2036 		else
2037 # endif
2038 		    msg_screen_putchar(*s, attr);
2039 	    }
2040 	    else
2041 #endif
2042 	    {
2043 		/* postpone this character until later */
2044 		if (t_col == 0)
2045 		    t_s = s;
2046 #ifdef FEAT_MBYTE
2047 		t_col += cw;
2048 		s += l - 1;
2049 #else
2050 		++t_col;
2051 #endif
2052 	    }
2053 	}
2054 	++s;
2055     }
2056 
2057     /* output any postponed text */
2058     if (t_col > 0)
2059 	t_puts(&t_col, t_s, s, attr);
2060     if (p_more && !recurse)
2061 	store_sb_text(&sb_str, s, attr, &sb_col, FALSE);
2062 
2063     msg_check();
2064 }
2065 
2066 /*
2067  * Scroll the screen up one line for displaying the next message line.
2068  */
2069     static void
2070 msg_scroll_up()
2071 {
2072 #ifdef FEAT_GUI
2073     /* Remove the cursor before scrolling, ScreenLines[] is going
2074      * to become invalid. */
2075     if (gui.in_use)
2076 	gui_undraw_cursor();
2077 #endif
2078     /* scrolling up always works */
2079     screen_del_lines(0, 0, 1, (int)Rows, TRUE, NULL);
2080 
2081     if (!can_clear((char_u *)" "))
2082     {
2083 	/* Scrolling up doesn't result in the right background.  Set the
2084 	 * background here.  It's not efficient, but avoids that we have to do
2085 	 * it all over the code. */
2086 	screen_fill((int)Rows - 1, (int)Rows, 0, (int)Columns, ' ', ' ', 0);
2087 
2088 	/* Also clear the last char of the last but one line if it was not
2089 	 * cleared before to avoid a scroll-up. */
2090 	if (ScreenAttrs[LineOffset[Rows - 2] + Columns - 1] == (sattr_T)-1)
2091 	    screen_fill((int)Rows - 2, (int)Rows - 1,
2092 				 (int)Columns - 1, (int)Columns, ' ', ' ', 0);
2093     }
2094 }
2095 
2096 /*
2097  * Increment "msg_scrolled".
2098  */
2099     static void
2100 inc_msg_scrolled()
2101 {
2102 #ifdef FEAT_EVAL
2103     if (*get_vim_var_str(VV_SCROLLSTART) == NUL)
2104     {
2105 	char_u	    *p = sourcing_name;
2106 	char_u	    *tofree = NULL;
2107 	int	    len;
2108 
2109 	/* v:scrollstart is empty, set it to the script/function name and line
2110 	 * number */
2111 	if (p == NULL)
2112 	    p = (char_u *)_("Unknown");
2113 	else
2114 	{
2115 	    len = (int)STRLEN(p) + 40;
2116 	    tofree = alloc(len);
2117 	    if (tofree != NULL)
2118 	    {
2119 		vim_snprintf((char *)tofree, len, _("%s line %ld"),
2120 						      p, (long)sourcing_lnum);
2121 		p = tofree;
2122 	    }
2123 	}
2124 	set_vim_var_string(VV_SCROLLSTART, p, -1);
2125 	vim_free(tofree);
2126     }
2127 #endif
2128     ++msg_scrolled;
2129 }
2130 
2131 /*
2132  * To be able to scroll back at the "more" and "hit-enter" prompts we need to
2133  * store the displayed text and remember where screen lines start.
2134  */
2135 typedef struct msgchunk_S msgchunk_T;
2136 struct msgchunk_S
2137 {
2138     msgchunk_T	*sb_next;
2139     msgchunk_T	*sb_prev;
2140     char	sb_eol;		/* TRUE when line ends after this text */
2141     int		sb_msg_col;	/* column in which text starts */
2142     int		sb_attr;	/* text attributes */
2143     char_u	sb_text[1];	/* text to be displayed, actually longer */
2144 };
2145 
2146 static msgchunk_T *last_msgchunk = NULL; /* last displayed text */
2147 
2148 static msgchunk_T *msg_sb_start __ARGS((msgchunk_T *mps));
2149 static msgchunk_T *disp_sb_line __ARGS((int row, msgchunk_T *smp));
2150 
2151 static int do_clear_sb_text = FALSE;	/* clear text on next msg */
2152 
2153 /*
2154  * Store part of a printed message for displaying when scrolling back.
2155  */
2156     static void
2157 store_sb_text(sb_str, s, attr, sb_col, finish)
2158     char_u	**sb_str;	/* start of string */
2159     char_u	*s;		/* just after string */
2160     int		attr;
2161     int		*sb_col;
2162     int		finish;		/* line ends */
2163 {
2164     msgchunk_T	*mp;
2165 
2166     if (do_clear_sb_text)
2167     {
2168 	clear_sb_text();
2169 	do_clear_sb_text = FALSE;
2170     }
2171 
2172     if (s > *sb_str)
2173     {
2174 	mp = (msgchunk_T *)alloc((int)(sizeof(msgchunk_T) + (s - *sb_str)));
2175 	if (mp != NULL)
2176 	{
2177 	    mp->sb_eol = finish;
2178 	    mp->sb_msg_col = *sb_col;
2179 	    mp->sb_attr = attr;
2180 	    vim_strncpy(mp->sb_text, *sb_str, s - *sb_str);
2181 
2182 	    if (last_msgchunk == NULL)
2183 	    {
2184 		last_msgchunk = mp;
2185 		mp->sb_prev = NULL;
2186 	    }
2187 	    else
2188 	    {
2189 		mp->sb_prev = last_msgchunk;
2190 		last_msgchunk->sb_next = mp;
2191 		last_msgchunk = mp;
2192 	    }
2193 	    mp->sb_next = NULL;
2194 	}
2195     }
2196     else if (finish && last_msgchunk != NULL)
2197 	last_msgchunk->sb_eol = TRUE;
2198 
2199     *sb_str = s;
2200     *sb_col = 0;
2201 }
2202 
2203 /*
2204  * Finished showing messages, clear the scroll-back text on the next message.
2205  */
2206     void
2207 may_clear_sb_text()
2208 {
2209     do_clear_sb_text = TRUE;
2210 }
2211 
2212 /*
2213  * Clear any text remembered for scrolling back.
2214  * Called when redrawing the screen.
2215  */
2216     void
2217 clear_sb_text()
2218 {
2219     msgchunk_T	*mp;
2220 
2221     while (last_msgchunk != NULL)
2222     {
2223 	mp = last_msgchunk->sb_prev;
2224 	vim_free(last_msgchunk);
2225 	last_msgchunk = mp;
2226     }
2227 }
2228 
2229 /*
2230  * "g<" command.
2231  */
2232     void
2233 show_sb_text()
2234 {
2235     msgchunk_T	*mp;
2236 
2237     /* Only show somethign if there is more than one line, otherwise it looks
2238      * weird, typing a command without output results in one line. */
2239     mp = msg_sb_start(last_msgchunk);
2240     if (mp == NULL || mp->sb_prev == NULL)
2241 	vim_beep();
2242     else
2243     {
2244 	do_more_prompt('G');
2245 	wait_return(FALSE);
2246     }
2247 }
2248 
2249 /*
2250  * Move to the start of screen line in already displayed text.
2251  */
2252     static msgchunk_T *
2253 msg_sb_start(mps)
2254     msgchunk_T *mps;
2255 {
2256     msgchunk_T *mp = mps;
2257 
2258     while (mp != NULL && mp->sb_prev != NULL && !mp->sb_prev->sb_eol)
2259 	mp = mp->sb_prev;
2260     return mp;
2261 }
2262 
2263 /*
2264  * Display a screen line from previously displayed text at row "row".
2265  * Returns a pointer to the text for the next line (can be NULL).
2266  */
2267     static msgchunk_T *
2268 disp_sb_line(row, smp)
2269     int		row;
2270     msgchunk_T	*smp;
2271 {
2272     msgchunk_T	*mp = smp;
2273     char_u	*p;
2274 
2275     for (;;)
2276     {
2277 	msg_row = row;
2278 	msg_col = mp->sb_msg_col;
2279 	p = mp->sb_text;
2280 	if (*p == '\n')	    /* don't display the line break */
2281 	    ++p;
2282 	msg_puts_display(p, -1, mp->sb_attr, TRUE);
2283 	if (mp->sb_eol || mp->sb_next == NULL)
2284 	    break;
2285 	mp = mp->sb_next;
2286     }
2287     return mp->sb_next;
2288 }
2289 
2290 /*
2291  * Output any postponed text for msg_puts_attr_len().
2292  */
2293     static void
2294 t_puts(t_col, t_s, s, attr)
2295     int		*t_col;
2296     char_u	*t_s;
2297     char_u	*s;
2298     int		attr;
2299 {
2300     /* output postponed text */
2301     msg_didout = TRUE;		/* remember that line is not empty */
2302     screen_puts_len(t_s, (int)(s - t_s), msg_row, msg_col, attr);
2303     msg_col += *t_col;
2304     *t_col = 0;
2305 #ifdef FEAT_MBYTE
2306     /* If the string starts with a composing character don't increment the
2307      * column position for it. */
2308     if (enc_utf8 && utf_iscomposing(utf_ptr2char(t_s)))
2309 	--msg_col;
2310 #endif
2311     if (msg_col >= Columns)
2312     {
2313 	msg_col = 0;
2314 	++msg_row;
2315     }
2316 }
2317 
2318 /*
2319  * Returns TRUE when messages should be printed with mch_errmsg().
2320  * This is used when there is no valid screen, so we can see error messages.
2321  * If termcap is not active, we may be writing in an alternate console
2322  * window, cursor positioning may not work correctly (window size may be
2323  * different, e.g. for Win32 console) or we just don't know where the
2324  * cursor is.
2325  */
2326     int
2327 msg_use_printf()
2328 {
2329     return (!msg_check_screen()
2330 #if defined(WIN3264) && !defined(FEAT_GUI_MSWIN)
2331 	    || !termcap_active
2332 #endif
2333 	    || (swapping_screen() && !termcap_active)
2334 	       );
2335 }
2336 
2337 /*
2338  * Print a message when there is no valid screen.
2339  */
2340     static void
2341 msg_puts_printf(str, maxlen)
2342     char_u	*str;
2343     int		maxlen;
2344 {
2345     char_u	*s = str;
2346     char_u	buf[4];
2347     char_u	*p;
2348 
2349 #ifdef WIN3264
2350     if (!(silent_mode && p_verbose == 0))
2351 	mch_settmode(TMODE_COOK);	/* handle '\r' and '\n' correctly */
2352 #endif
2353     while (*s != NUL && (maxlen < 0 || (int)(s - str) < maxlen))
2354     {
2355 	if (!(silent_mode && p_verbose == 0))
2356 	{
2357 	    /* NL --> CR NL translation (for Unix, not for "--version") */
2358 	    /* NL --> CR translation (for Mac) */
2359 	    p = &buf[0];
2360 	    if (*s == '\n' && !info_message)
2361 		*p++ = '\r';
2362 #if defined(USE_CR) && !defined(MACOS_X_UNIX)
2363 	    else
2364 #endif
2365 		*p++ = *s;
2366 	    *p = '\0';
2367 	    if (info_message)	/* informative message, not an error */
2368 		mch_msg((char *)buf);
2369 	    else
2370 		mch_errmsg((char *)buf);
2371 	}
2372 
2373 	/* primitive way to compute the current column */
2374 #ifdef FEAT_RIGHTLEFT
2375 	if (cmdmsg_rl)
2376 	{
2377 	    if (*s == '\r' || *s == '\n')
2378 		msg_col = Columns - 1;
2379 	    else
2380 		--msg_col;
2381 	}
2382 	else
2383 #endif
2384 	{
2385 	    if (*s == '\r' || *s == '\n')
2386 		msg_col = 0;
2387 	    else
2388 		++msg_col;
2389 	}
2390 	++s;
2391     }
2392     msg_didout = TRUE;	    /* assume that line is not empty */
2393 
2394 #ifdef WIN3264
2395     if (!(silent_mode && p_verbose == 0))
2396 	mch_settmode(TMODE_RAW);
2397 #endif
2398 }
2399 
2400 /*
2401  * Show the more-prompt and handle the user response.
2402  * This takes care of scrolling back and displaying previously displayed text.
2403  * When at hit-enter prompt "typed_char" is the already typed character,
2404  * otherwise it's NUL.
2405  * Returns TRUE when jumping ahead to "confirm_msg_tail".
2406  */
2407     static int
2408 do_more_prompt(typed_char)
2409     int		typed_char;
2410 {
2411     int		used_typed_char = typed_char;
2412     int		oldState = State;
2413     int		c;
2414 #ifdef FEAT_CON_DIALOG
2415     int		retval = FALSE;
2416 #endif
2417     int		scroll;
2418     msgchunk_T	*mp_last = NULL;
2419     msgchunk_T	*mp;
2420     int		i;
2421 
2422     if (typed_char == 'G')
2423     {
2424 	/* "g<": Find first line on the last page. */
2425 	mp_last = msg_sb_start(last_msgchunk);
2426 	for (i = 0; i < Rows - 2 && mp_last != NULL
2427 					     && mp_last->sb_prev != NULL; ++i)
2428 	    mp_last = msg_sb_start(mp_last->sb_prev);
2429     }
2430 
2431     State = ASKMORE;
2432 #ifdef FEAT_MOUSE
2433     setmouse();
2434 #endif
2435     if (typed_char == NUL)
2436 	msg_moremsg(FALSE);
2437     for (;;)
2438     {
2439 	/*
2440 	 * Get a typed character directly from the user.
2441 	 */
2442 	if (used_typed_char != NUL)
2443 	{
2444 	    c = used_typed_char;	/* was typed at hit-enter prompt */
2445 	    used_typed_char = NUL;
2446 	}
2447 	else
2448 	    c = get_keystroke();
2449 
2450 #if defined(FEAT_MENU) && defined(FEAT_GUI)
2451 	if (c == K_MENU)
2452 	{
2453 	    int idx = get_menu_index(current_menu, ASKMORE);
2454 
2455 	    /* Used a menu.  If it starts with CTRL-Y, it must
2456 	     * be a "Copy" for the clipboard.  Otherwise
2457 	     * assume that we end */
2458 	    if (idx == MENU_INDEX_INVALID)
2459 		continue;
2460 	    c = *current_menu->strings[idx];
2461 	    if (c != NUL && current_menu->strings[idx][1] != NUL)
2462 		ins_typebuf(current_menu->strings[idx] + 1,
2463 				current_menu->noremap[idx], 0, TRUE,
2464 						   current_menu->silent[idx]);
2465 	}
2466 #endif
2467 
2468 	scroll = 0;
2469 	switch (c)
2470 	{
2471 	case BS:		/* scroll one line back */
2472 	case K_BS:
2473 	case 'k':
2474 	case K_UP:
2475 	    scroll = -1;
2476 	    break;
2477 
2478 	case CAR:		/* one extra line */
2479 	case NL:
2480 	case 'j':
2481 	case K_DOWN:
2482 	    scroll = 1;
2483 	    break;
2484 
2485 	case 'u':		/* Up half a page */
2486 	case K_PAGEUP:
2487 	    scroll = -(Rows / 2);
2488 	    break;
2489 
2490 	case 'd':		/* Down half a page */
2491 	    scroll = Rows / 2;
2492 	    break;
2493 
2494 	case 'b':		/* one page back */
2495 	    scroll = -(Rows - 1);
2496 	    break;
2497 
2498 	case ' ':		/* one extra page */
2499 	case K_PAGEDOWN:
2500 	case K_LEFTMOUSE:
2501 	    scroll = Rows - 1;
2502 	    break;
2503 
2504 	case 'g':		/* all the way back to the start */
2505 	    scroll = -999999;
2506 	    break;
2507 
2508 	case 'G':		/* all the way to the end */
2509 	    scroll = 999999;
2510 	    lines_left = 999999;
2511 	    break;
2512 
2513 	case ':':		/* start new command line */
2514 #ifdef FEAT_CON_DIALOG
2515 	    if (!confirm_msg_used)
2516 #endif
2517 	    {
2518 		/* Since got_int is set all typeahead will be flushed, but we
2519 		 * want to keep this ':', remember that in a special way. */
2520 		typeahead_noflush(':');
2521 		cmdline_row = Rows - 1;		/* put ':' on this line */
2522 		skip_redraw = TRUE;		/* skip redraw once */
2523 		need_wait_return = FALSE;	/* don't wait in main() */
2524 	    }
2525 	    /*FALLTHROUGH*/
2526 	case 'q':		/* quit */
2527 	case Ctrl_C:
2528 	case ESC:
2529 #ifdef FEAT_CON_DIALOG
2530 	    if (confirm_msg_used)
2531 	    {
2532 		/* Jump to the choices of the dialog. */
2533 		retval = TRUE;
2534 		lines_left = Rows - 1;
2535 	    }
2536 	    else
2537 #endif
2538 	    {
2539 		got_int = TRUE;
2540 		quit_more = TRUE;
2541 	    }
2542 	    break;
2543 
2544 #ifdef FEAT_CLIPBOARD
2545 	case Ctrl_Y:
2546 	    /* Strange way to allow copying (yanking) a modeless
2547 	     * selection at the more prompt.  Use CTRL-Y,
2548 	     * because the same is used in Cmdline-mode and at the
2549 	     * hit-enter prompt.  However, scrolling one line up
2550 	     * might be expected... */
2551 	    if (clip_star.state == SELECT_DONE)
2552 		clip_copy_modeless_selection(TRUE);
2553 	    continue;
2554 #endif
2555 	default:		/* no valid response */
2556 	    msg_moremsg(TRUE);
2557 	    continue;
2558 	}
2559 
2560 	if (scroll != 0)
2561 	{
2562 	    if (scroll < 0)
2563 	    {
2564 		/* go to start of last line */
2565 		if (mp_last == NULL)
2566 		    mp = msg_sb_start(last_msgchunk);
2567 		else if (mp_last->sb_prev != NULL)
2568 		    mp = msg_sb_start(mp_last->sb_prev);
2569 		else
2570 		    mp = NULL;
2571 
2572 		/* go to start of line at top of the screen */
2573 		for (i = 0; i < Rows - 2 && mp != NULL && mp->sb_prev != NULL;
2574 									  ++i)
2575 		    mp = msg_sb_start(mp->sb_prev);
2576 
2577 		if (mp != NULL && mp->sb_prev != NULL)
2578 		{
2579 		    /* Find line to be displayed at top. */
2580 		    for (i = 0; i > scroll; --i)
2581 		    {
2582 			if (mp == NULL || mp->sb_prev == NULL)
2583 			    break;
2584 			mp = msg_sb_start(mp->sb_prev);
2585 			if (mp_last == NULL)
2586 			    mp_last = msg_sb_start(last_msgchunk);
2587 			else
2588 			    mp_last = msg_sb_start(mp_last->sb_prev);
2589 		    }
2590 
2591 		    if (scroll == -1 && screen_ins_lines(0, 0, 1,
2592 						       (int)Rows, NULL) == OK)
2593 		    {
2594 			/* display line at top */
2595 			(void)disp_sb_line(0, mp);
2596 		    }
2597 		    else
2598 		    {
2599 			/* redisplay all lines */
2600 			screenclear();
2601 			for (i = 0; mp != NULL && i < Rows - 1; ++i)
2602 			{
2603 			    mp = disp_sb_line(i, mp);
2604 			    ++msg_scrolled;
2605 			}
2606 		    }
2607 		    scroll = 0;
2608 		}
2609 	    }
2610 	    else
2611 	    {
2612 		/* First display any text that we scrolled back. */
2613 		while (scroll > 0 && mp_last != NULL)
2614 		{
2615 		    /* scroll up, display line at bottom */
2616 		    msg_scroll_up();
2617 		    inc_msg_scrolled();
2618 		    screen_fill((int)Rows - 2, (int)Rows - 1, 0,
2619 						   (int)Columns, ' ', ' ', 0);
2620 		    mp_last = disp_sb_line((int)Rows - 2, mp_last);
2621 		    --scroll;
2622 		}
2623 	    }
2624 
2625 	    if (scroll < 0 || (scroll == 0 && mp_last != NULL))
2626 	    {
2627 		/* displayed the requested text, more prompt again */
2628 		screen_fill((int)Rows - 1, (int)Rows, 0,
2629 						   (int)Columns, ' ', ' ', 0);
2630 		msg_moremsg(FALSE);
2631 		continue;
2632 	    }
2633 
2634 	    /* display more text, return to caller */
2635 	    lines_left = scroll;
2636 	}
2637 
2638 	break;
2639     }
2640 
2641     /* clear the --more-- message */
2642     screen_fill((int)Rows - 1, (int)Rows, 0, (int)Columns, ' ', ' ', 0);
2643     State = oldState;
2644 #ifdef FEAT_MOUSE
2645     setmouse();
2646 #endif
2647     if (quit_more)
2648     {
2649 	msg_row = Rows - 1;
2650 	msg_col = 0;
2651     }
2652 #ifdef FEAT_RIGHTLEFT
2653     else if (cmdmsg_rl)
2654 	msg_col = Columns - 1;
2655 #endif
2656 
2657 #ifdef FEAT_CON_DIALOG
2658     return retval;
2659 #else
2660     return FALSE;
2661 #endif
2662 }
2663 
2664 #if defined(USE_MCH_ERRMSG) || defined(PROTO)
2665 
2666 #ifdef mch_errmsg
2667 # undef mch_errmsg
2668 #endif
2669 #ifdef mch_msg
2670 # undef mch_msg
2671 #endif
2672 
2673 /*
2674  * Give an error message.  To be used when the screen hasn't been initialized
2675  * yet.  When stderr can't be used, collect error messages until the GUI has
2676  * started and they can be displayed in a message box.
2677  */
2678     void
2679 mch_errmsg(str)
2680     char	*str;
2681 {
2682     int		len;
2683 
2684 #if (defined(UNIX) || defined(FEAT_GUI)) && !defined(ALWAYS_USE_GUI)
2685     /* On Unix use stderr if it's a tty.
2686      * When not going to start the GUI also use stderr.
2687      * On Mac, when started from Finder, stderr is the console. */
2688     if (
2689 # ifdef UNIX
2690 #  ifdef MACOS_X_UNIX
2691 	    (isatty(2) && strcmp("/dev/console", ttyname(2)) != 0)
2692 #  else
2693 	    isatty(2)
2694 #  endif
2695 #  ifdef FEAT_GUI
2696 	    ||
2697 #  endif
2698 # endif
2699 # ifdef FEAT_GUI
2700 	    !(gui.in_use || gui.starting)
2701 # endif
2702 	    )
2703     {
2704 	fprintf(stderr, "%s", str);
2705 	return;
2706     }
2707 #endif
2708 
2709     /* avoid a delay for a message that isn't there */
2710     emsg_on_display = FALSE;
2711 
2712     len = (int)STRLEN(str) + 1;
2713     if (error_ga.ga_growsize == 0)
2714     {
2715 	error_ga.ga_growsize = 80;
2716 	error_ga.ga_itemsize = 1;
2717     }
2718     if (ga_grow(&error_ga, len) == OK)
2719     {
2720 	mch_memmove((char_u *)error_ga.ga_data + error_ga.ga_len,
2721 							  (char_u *)str, len);
2722 #ifdef UNIX
2723 	/* remove CR characters, they are displayed */
2724 	{
2725 	    char_u	*p;
2726 
2727 	    p = (char_u *)error_ga.ga_data + error_ga.ga_len;
2728 	    for (;;)
2729 	    {
2730 		p = vim_strchr(p, '\r');
2731 		if (p == NULL)
2732 		    break;
2733 		*p = ' ';
2734 	    }
2735 	}
2736 #endif
2737 	--len;		/* don't count the NUL at the end */
2738 	error_ga.ga_len += len;
2739     }
2740 }
2741 
2742 /*
2743  * Give a message.  To be used when the screen hasn't been initialized yet.
2744  * When there is no tty, collect messages until the GUI has started and they
2745  * can be displayed in a message box.
2746  */
2747     void
2748 mch_msg(str)
2749     char	*str;
2750 {
2751 #if (defined(UNIX) || defined(FEAT_GUI)) && !defined(ALWAYS_USE_GUI)
2752     /* On Unix use stdout if we have a tty.  This allows "vim -h | more" and
2753      * uses mch_errmsg() when started from the desktop.
2754      * When not going to start the GUI also use stdout.
2755      * On Mac, when started from Finder, stderr is the console. */
2756     if (
2757 #  ifdef UNIX
2758 #   ifdef MACOS_X_UNIX
2759 	    (isatty(2) && strcmp("/dev/console", ttyname(2)) != 0)
2760 #   else
2761 	    isatty(2)
2762 #    endif
2763 #   ifdef FEAT_GUI
2764 	    ||
2765 #   endif
2766 #  endif
2767 #  ifdef FEAT_GUI
2768 	    !(gui.in_use || gui.starting)
2769 #  endif
2770 	    )
2771     {
2772 	printf("%s", str);
2773 	return;
2774     }
2775 # endif
2776     mch_errmsg(str);
2777 }
2778 #endif /* USE_MCH_ERRMSG */
2779 
2780 /*
2781  * Put a character on the screen at the current message position and advance
2782  * to the next position.  Only for printable ASCII!
2783  */
2784     static void
2785 msg_screen_putchar(c, attr)
2786     int		c;
2787     int		attr;
2788 {
2789     msg_didout = TRUE;		/* remember that line is not empty */
2790     screen_putchar(c, msg_row, msg_col, attr);
2791 #ifdef FEAT_RIGHTLEFT
2792     if (cmdmsg_rl)
2793     {
2794 	if (--msg_col == 0)
2795 	{
2796 	    msg_col = Columns;
2797 	    ++msg_row;
2798 	}
2799     }
2800     else
2801 #endif
2802     {
2803 	if (++msg_col >= Columns)
2804 	{
2805 	    msg_col = 0;
2806 	    ++msg_row;
2807 	}
2808     }
2809 }
2810 
2811     void
2812 msg_moremsg(full)
2813     int	    full;
2814 {
2815     int		attr;
2816     char_u	*s = (char_u *)_("-- More --");
2817 
2818     attr = hl_attr(HLF_M);
2819     screen_puts(s, (int)Rows - 1, 0, attr);
2820     if (full)
2821 	screen_puts((char_u *)
2822 		_(" SPACE/d/j: screen/page/line down, b/u/k: up, q: quit "),
2823 		(int)Rows - 1, vim_strsize(s), attr);
2824 }
2825 
2826 /*
2827  * Repeat the message for the current mode: ASKMORE, EXTERNCMD, CONFIRM or
2828  * exmode_active.
2829  */
2830     void
2831 repeat_message()
2832 {
2833     if (State == ASKMORE)
2834     {
2835 	msg_moremsg(TRUE);	/* display --more-- message again */
2836 	msg_row = Rows - 1;
2837     }
2838 #ifdef FEAT_CON_DIALOG
2839     else if (State == CONFIRM)
2840     {
2841 	display_confirm_msg();	/* display ":confirm" message again */
2842 	msg_row = Rows - 1;
2843     }
2844 #endif
2845     else if (State == EXTERNCMD)
2846     {
2847 	windgoto(msg_row, msg_col); /* put cursor back */
2848     }
2849     else if (State == HITRETURN || State == SETWSIZE)
2850     {
2851 	hit_return_msg();
2852 	msg_row = Rows - 1;
2853     }
2854 }
2855 
2856 /*
2857  * msg_check_screen - check if the screen is initialized.
2858  * Also check msg_row and msg_col, if they are too big it may cause a crash.
2859  * While starting the GUI the terminal codes will be set for the GUI, but the
2860  * output goes to the terminal.  Don't use the terminal codes then.
2861  */
2862     static int
2863 msg_check_screen()
2864 {
2865     if (!full_screen || !screen_valid(FALSE))
2866 	return FALSE;
2867 
2868     if (msg_row >= Rows)
2869 	msg_row = Rows - 1;
2870     if (msg_col >= Columns)
2871 	msg_col = Columns - 1;
2872     return TRUE;
2873 }
2874 
2875 /*
2876  * Clear from current message position to end of screen.
2877  * Skip this when ":silent" was used, no need to clear for redirection.
2878  */
2879     void
2880 msg_clr_eos()
2881 {
2882     if (msg_silent == 0)
2883 	msg_clr_eos_force();
2884 }
2885 
2886 /*
2887  * Clear from current message position to end of screen.
2888  * Note: msg_col is not updated, so we remember the end of the message
2889  * for msg_check().
2890  */
2891     void
2892 msg_clr_eos_force()
2893 {
2894     if (msg_use_printf())
2895     {
2896 	if (full_screen)	/* only when termcap codes are valid */
2897 	{
2898 	    if (*T_CD)
2899 		out_str(T_CD);	/* clear to end of display */
2900 	    else if (*T_CE)
2901 		out_str(T_CE);	/* clear to end of line */
2902 	}
2903     }
2904     else
2905     {
2906 #ifdef FEAT_RIGHTLEFT
2907 	if (cmdmsg_rl)
2908 	{
2909 	    screen_fill(msg_row, msg_row + 1, 0, msg_col + 1, ' ', ' ', 0);
2910 	    screen_fill(msg_row + 1, (int)Rows, 0, (int)Columns, ' ', ' ', 0);
2911 	}
2912 	else
2913 #endif
2914 	{
2915 	    screen_fill(msg_row, msg_row + 1, msg_col, (int)Columns,
2916 								 ' ', ' ', 0);
2917 	    screen_fill(msg_row + 1, (int)Rows, 0, (int)Columns, ' ', ' ', 0);
2918 	}
2919     }
2920 }
2921 
2922 /*
2923  * Clear the command line.
2924  */
2925     void
2926 msg_clr_cmdline()
2927 {
2928     msg_row = cmdline_row;
2929     msg_col = 0;
2930     msg_clr_eos_force();
2931 }
2932 
2933 /*
2934  * end putting a message on the screen
2935  * call wait_return if the message does not fit in the available space
2936  * return TRUE if wait_return not called.
2937  */
2938     int
2939 msg_end()
2940 {
2941     /*
2942      * if the string is larger than the window,
2943      * or the ruler option is set and we run into it,
2944      * we have to redraw the window.
2945      * Do not do this if we are abandoning the file or editing the command line.
2946      */
2947     if (!exiting && need_wait_return && !(State & CMDLINE))
2948     {
2949 	wait_return(FALSE);
2950 	return FALSE;
2951     }
2952     out_flush();
2953     return TRUE;
2954 }
2955 
2956 /*
2957  * If the written message runs into the shown command or ruler, we have to
2958  * wait for hit-return and redraw the window later.
2959  */
2960     void
2961 msg_check()
2962 {
2963     if (msg_row == Rows - 1 && msg_col >= sc_col)
2964     {
2965 	need_wait_return = TRUE;
2966 	redraw_cmdline = TRUE;
2967     }
2968 }
2969 
2970 /*
2971  * May write a string to the redirection file.
2972  * When "maxlen" is -1 write the whole string, otherwise up to "maxlen" bytes.
2973  */
2974     static void
2975 redir_write(str, maxlen)
2976     char_u	*str;
2977     int		maxlen;
2978 {
2979     char_u	*s = str;
2980     static int	cur_col = 0;
2981 
2982     /* Don't do anything for displaying prompts and the like. */
2983     if (redir_off)
2984 	return;
2985 
2986     /*
2987      * If 'verbosefile' is set write message in that file.
2988      * Must come before the rest because of updating "msg_col".
2989      */
2990     if (*p_vfile != NUL)
2991 	verbose_write(s, maxlen);
2992 
2993     if (redir_fd != NULL
2994 #ifdef FEAT_EVAL
2995 			  || redir_reg || redir_vname
2996 #endif
2997 				       )
2998     {
2999 	/* If the string doesn't start with CR or NL, go to msg_col */
3000 	if (*s != '\n' && *s != '\r')
3001 	{
3002 	    while (cur_col < msg_col)
3003 	    {
3004 #ifdef FEAT_EVAL
3005 		if (redir_reg)
3006 		    write_reg_contents(redir_reg, (char_u *)" ", -1, TRUE);
3007 		else if (redir_vname)
3008 		    var_redir_str((char_u *)" ", -1);
3009 		else if (redir_fd)
3010 #endif
3011 		    fputs(" ", redir_fd);
3012 		++cur_col;
3013 	    }
3014 	}
3015 
3016 #ifdef FEAT_EVAL
3017 	if (redir_reg)
3018 	    write_reg_contents(redir_reg, s, maxlen, TRUE);
3019 	if (redir_vname)
3020 	    var_redir_str(s, maxlen);
3021 #endif
3022 
3023 	/* Adjust the current column */
3024 	while (*s != NUL && (maxlen < 0 || (int)(s - str) < maxlen))
3025 	{
3026 #ifdef FEAT_EVAL
3027 	    if (!redir_reg && !redir_vname && redir_fd != NULL)
3028 #endif
3029 		putc(*s, redir_fd);
3030 	    if (*s == '\r' || *s == '\n')
3031 		cur_col = 0;
3032 	    else if (*s == '\t')
3033 		cur_col += (8 - cur_col % 8);
3034 	    else
3035 		++cur_col;
3036 	    ++s;
3037 	}
3038 
3039 	if (msg_silent != 0)	/* should update msg_col */
3040 	    msg_col = cur_col;
3041     }
3042 }
3043 
3044 /*
3045  * Before giving verbose message.
3046  * Must always be called paired with verbose_leave()!
3047  */
3048     void
3049 verbose_enter()
3050 {
3051     if (*p_vfile != NUL)
3052 	++msg_silent;
3053 }
3054 
3055 /*
3056  * After giving verbose message.
3057  * Must always be called paired with verbose_enter()!
3058  */
3059     void
3060 verbose_leave()
3061 {
3062     if (*p_vfile != NUL)
3063 	if (--msg_silent < 0)
3064 	    msg_silent = 0;
3065 }
3066 
3067 /*
3068  * Like verbose_enter() and set msg_scroll when displaying the message.
3069  */
3070     void
3071 verbose_enter_scroll()
3072 {
3073     if (*p_vfile != NUL)
3074 	++msg_silent;
3075     else
3076 	/* always scroll up, don't overwrite */
3077 	msg_scroll = TRUE;
3078 }
3079 
3080 /*
3081  * Like verbose_leave() and set cmdline_row when displaying the message.
3082  */
3083     void
3084 verbose_leave_scroll()
3085 {
3086     if (*p_vfile != NUL)
3087     {
3088 	if (--msg_silent < 0)
3089 	    msg_silent = 0;
3090     }
3091     else
3092 	cmdline_row = msg_row;
3093 }
3094 
3095 static FILE *verbose_fd = NULL;
3096 static int  verbose_did_open = FALSE;
3097 
3098 /*
3099  * Called when 'verbosefile' is set: stop writing to the file.
3100  */
3101     void
3102 verbose_stop()
3103 {
3104     if (verbose_fd != NULL)
3105     {
3106 	fclose(verbose_fd);
3107 	verbose_fd = NULL;
3108     }
3109     verbose_did_open = FALSE;
3110 }
3111 
3112 /*
3113  * Open the file 'verbosefile'.
3114  * Return FAIL or OK.
3115  */
3116     int
3117 verbose_open()
3118 {
3119     if (verbose_fd == NULL && !verbose_did_open)
3120     {
3121 	/* Only give the error message once. */
3122 	verbose_did_open = TRUE;
3123 
3124 	verbose_fd = mch_fopen((char *)p_vfile, "a");
3125 	if (verbose_fd == NULL)
3126 	{
3127 	    EMSG2(_(e_notopen), p_vfile);
3128 	    return FAIL;
3129 	}
3130     }
3131     return OK;
3132 }
3133 
3134 /*
3135  * Write a string to 'verbosefile'.
3136  * When "maxlen" is -1 write the whole string, otherwise up to "maxlen" bytes.
3137  */
3138     static void
3139 verbose_write(str, maxlen)
3140     char_u	*str;
3141     int		maxlen;
3142 {
3143     char_u	*s = str;
3144     static int	cur_col = 0;
3145 
3146     /* Open the file when called the first time. */
3147     if (verbose_fd == NULL)
3148 	verbose_open();
3149 
3150     if (verbose_fd != NULL)
3151     {
3152 	/* If the string doesn't start with CR or NL, go to msg_col */
3153 	if (*s != '\n' && *s != '\r')
3154 	{
3155 	    while (cur_col < msg_col)
3156 	    {
3157 		fputs(" ", verbose_fd);
3158 		++cur_col;
3159 	    }
3160 	}
3161 
3162 	/* Adjust the current column */
3163 	while (*s != NUL && (maxlen < 0 || (int)(s - str) < maxlen))
3164 	{
3165 	    putc(*s, verbose_fd);
3166 	    if (*s == '\r' || *s == '\n')
3167 		cur_col = 0;
3168 	    else if (*s == '\t')
3169 		cur_col += (8 - cur_col % 8);
3170 	    else
3171 		++cur_col;
3172 	    ++s;
3173 	}
3174     }
3175 }
3176 
3177 /*
3178  * Give a warning message (for searching).
3179  * Use 'w' highlighting and may repeat the message after redrawing
3180  */
3181     void
3182 give_warning(message, hl)
3183     char_u  *message;
3184     int	    hl;
3185 {
3186     /* Don't do this for ":silent". */
3187     if (msg_silent != 0)
3188 	return;
3189 
3190     /* Don't want a hit-enter prompt here. */
3191     ++no_wait_return;
3192 
3193 #ifdef FEAT_EVAL
3194     set_vim_var_string(VV_WARNINGMSG, message, -1);
3195 #endif
3196     vim_free(keep_msg);
3197     keep_msg = NULL;
3198     if (hl)
3199 	keep_msg_attr = hl_attr(HLF_W);
3200     else
3201 	keep_msg_attr = 0;
3202     if (msg_attr(message, keep_msg_attr) && msg_scrolled == 0)
3203 	set_keep_msg(message, keep_msg_attr);
3204     msg_didout = FALSE;	    /* overwrite this message */
3205     msg_nowait = TRUE;	    /* don't wait for this message */
3206     msg_col = 0;
3207 
3208     --no_wait_return;
3209 }
3210 
3211 /*
3212  * Advance msg cursor to column "col".
3213  */
3214     void
3215 msg_advance(col)
3216     int	    col;
3217 {
3218     if (msg_silent != 0)	/* nothing to advance to */
3219     {
3220 	msg_col = col;		/* for redirection, may fill it up later */
3221 	return;
3222     }
3223     if (col >= Columns)		/* not enough room */
3224 	col = Columns - 1;
3225 #ifdef FEAT_RIGHTLEFT
3226     if (cmdmsg_rl)
3227 	while (msg_col > Columns - col)
3228 	    msg_putchar(' ');
3229     else
3230 #endif
3231 	while (msg_col < col)
3232 	    msg_putchar(' ');
3233 }
3234 
3235 #if defined(FEAT_CON_DIALOG) || defined(PROTO)
3236 /*
3237  * Used for "confirm()" function, and the :confirm command prefix.
3238  * Versions which haven't got flexible dialogs yet, and console
3239  * versions, get this generic handler which uses the command line.
3240  *
3241  * type  = one of:
3242  *	   VIM_QUESTION, VIM_INFO, VIM_WARNING, VIM_ERROR or VIM_GENERIC
3243  * title = title string (can be NULL for default)
3244  * (neither used in console dialogs at the moment)
3245  *
3246  * Format of the "buttons" string:
3247  * "Button1Name\nButton2Name\nButton3Name"
3248  * The first button should normally be the default/accept
3249  * The second button should be the 'Cancel' button
3250  * Other buttons- use your imagination!
3251  * A '&' in a button name becomes a shortcut, so each '&' should be before a
3252  * different letter.
3253  */
3254 /* ARGSUSED */
3255     int
3256 do_dialog(type, title, message, buttons, dfltbutton, textfield)
3257     int		type;
3258     char_u	*title;
3259     char_u	*message;
3260     char_u	*buttons;
3261     int		dfltbutton;
3262     char_u	*textfield;	/* IObuff for inputdialog(), NULL otherwise */
3263 {
3264     int		oldState;
3265     int		retval = 0;
3266     char_u	*hotkeys;
3267     int		c;
3268     int		i;
3269 
3270 #ifndef NO_CONSOLE
3271     /* Don't output anything in silent mode ("ex -s") */
3272     if (silent_mode)
3273 	return dfltbutton;   /* return default option */
3274 #endif
3275 
3276 #ifdef FEAT_GUI_DIALOG
3277     /* When GUI is running and 'c' not in 'guioptions', use the GUI dialog */
3278     if (gui.in_use && vim_strchr(p_go, GO_CONDIALOG) == NULL)
3279     {
3280 	c = gui_mch_dialog(type, title, message, buttons, dfltbutton,
3281 								   textfield);
3282 	msg_end_prompt();
3283 
3284 	/* Flush output to avoid that further messages and redrawing is done
3285 	 * in the wrong order. */
3286 	out_flush();
3287 	gui_mch_update();
3288 
3289 	return c;
3290     }
3291 #endif
3292 
3293     oldState = State;
3294     State = CONFIRM;
3295 #ifdef FEAT_MOUSE
3296     setmouse();
3297 #endif
3298 
3299     /*
3300      * Since we wait for a keypress, don't make the
3301      * user press RETURN as well afterwards.
3302      */
3303     ++no_wait_return;
3304     hotkeys = msg_show_console_dialog(message, buttons, dfltbutton);
3305 
3306     if (hotkeys != NULL)
3307     {
3308 	for (;;)
3309 	{
3310 	    /* Get a typed character directly from the user. */
3311 	    c = get_keystroke();
3312 	    switch (c)
3313 	    {
3314 	    case CAR:		/* User accepts default option */
3315 	    case NL:
3316 		retval = dfltbutton;
3317 		break;
3318 	    case Ctrl_C:	/* User aborts/cancels */
3319 	    case ESC:
3320 		retval = 0;
3321 		break;
3322 	    default:		/* Could be a hotkey? */
3323 		if (c < 0)	/* special keys are ignored here */
3324 		    continue;
3325 		/* Make the character lowercase, as chars in "hotkeys" are. */
3326 		c = MB_TOLOWER(c);
3327 		retval = 1;
3328 		for (i = 0; hotkeys[i]; ++i)
3329 		{
3330 #ifdef FEAT_MBYTE
3331 		    if (has_mbyte)
3332 		    {
3333 			if ((*mb_ptr2char)(hotkeys + i) == c)
3334 			    break;
3335 			i += (*mb_ptr2len)(hotkeys + i) - 1;
3336 		    }
3337 		    else
3338 #endif
3339 			if (hotkeys[i] == c)
3340 			    break;
3341 		    ++retval;
3342 		}
3343 		if (hotkeys[i])
3344 		    break;
3345 		/* No hotkey match, so keep waiting */
3346 		continue;
3347 	    }
3348 	    break;
3349 	}
3350 
3351 	vim_free(hotkeys);
3352     }
3353 
3354     State = oldState;
3355 #ifdef FEAT_MOUSE
3356     setmouse();
3357 #endif
3358     --no_wait_return;
3359     msg_end_prompt();
3360 
3361     return retval;
3362 }
3363 
3364 static int copy_char __ARGS((char_u *from, char_u *to, int lowercase));
3365 
3366 /*
3367  * Copy one character from "*from" to "*to", taking care of multi-byte
3368  * characters.  Return the length of the character in bytes.
3369  */
3370     static int
3371 copy_char(from, to, lowercase)
3372     char_u	*from;
3373     char_u	*to;
3374     int		lowercase;	/* make character lower case */
3375 {
3376 #ifdef FEAT_MBYTE
3377     int		len;
3378     int		c;
3379 
3380     if (has_mbyte)
3381     {
3382 	if (lowercase)
3383 	{
3384 	    c = MB_TOLOWER((*mb_ptr2char)(from));
3385 	    return (*mb_char2bytes)(c, to);
3386 	}
3387 	else
3388 	{
3389 	    len = (*mb_ptr2len)(from);
3390 	    mch_memmove(to, from, (size_t)len);
3391 	    return len;
3392 	}
3393     }
3394     else
3395 #endif
3396     {
3397 	if (lowercase)
3398 	    *to = (char_u)TOLOWER_LOC(*from);
3399 	else
3400 	    *to = *from;
3401 	return 1;
3402     }
3403 }
3404 
3405 /*
3406  * Format the dialog string, and display it at the bottom of
3407  * the screen. Return a string of hotkey chars (if defined) for
3408  * each 'button'. If a button has no hotkey defined, the first character of
3409  * the button is used.
3410  * The hotkeys can be multi-byte characters, but without combining chars.
3411  *
3412  * Returns an allocated string with hotkeys, or NULL for error.
3413  */
3414     static char_u *
3415 msg_show_console_dialog(message, buttons, dfltbutton)
3416     char_u	*message;
3417     char_u	*buttons;
3418     int		dfltbutton;
3419 {
3420     int		len = 0;
3421 #ifdef FEAT_MBYTE
3422 # define HOTK_LEN (has_mbyte ? MB_MAXBYTES : 1)
3423 #else
3424 # define HOTK_LEN 1
3425 #endif
3426     int		lenhotkey = HOTK_LEN;	/* count first button */
3427     char_u	*hotk = NULL;
3428     char_u	*msgp = NULL;
3429     char_u	*hotkp = NULL;
3430     char_u	*r;
3431     int		copy;
3432 #define HAS_HOTKEY_LEN 30
3433     char_u	has_hotkey[HAS_HOTKEY_LEN];
3434     int		first_hotkey = FALSE;	/* first char of button is hotkey */
3435     int		idx;
3436 
3437     has_hotkey[0] = FALSE;
3438 
3439     /*
3440      * First loop: compute the size of memory to allocate.
3441      * Second loop: copy to the allocated memory.
3442      */
3443     for (copy = 0; copy <= 1; ++copy)
3444     {
3445 	r = buttons;
3446 	idx = 0;
3447 	while (*r)
3448 	{
3449 	    if (*r == DLG_BUTTON_SEP)
3450 	    {
3451 		if (copy)
3452 		{
3453 		    *msgp++ = ',';
3454 		    *msgp++ = ' ';	    /* '\n' -> ', ' */
3455 
3456 		    /* advance to next hotkey and set default hotkey */
3457 #ifdef FEAT_MBYTE
3458 		    if (has_mbyte)
3459 			hotkp += (*mb_ptr2len)(hotkp);
3460 		    else
3461 #endif
3462 			++hotkp;
3463 		    (void)copy_char(r + 1, hotkp, TRUE);
3464 		    if (dfltbutton)
3465 			--dfltbutton;
3466 
3467 		    /* If no hotkey is specified first char is used. */
3468 		    if (idx < HAS_HOTKEY_LEN - 1 && !has_hotkey[++idx])
3469 			first_hotkey = TRUE;
3470 		}
3471 		else
3472 		{
3473 		    len += 3;		    /* '\n' -> ', '; 'x' -> '(x)' */
3474 		    lenhotkey += HOTK_LEN;  /* each button needs a hotkey */
3475 		    if (idx < HAS_HOTKEY_LEN - 1)
3476 			has_hotkey[++idx] = FALSE;
3477 		}
3478 	    }
3479 	    else if (*r == DLG_HOTKEY_CHAR || first_hotkey)
3480 	    {
3481 		if (*r == DLG_HOTKEY_CHAR)
3482 		    ++r;
3483 		first_hotkey = FALSE;
3484 		if (copy)
3485 		{
3486 		    if (*r == DLG_HOTKEY_CHAR)		/* '&&a' -> '&a' */
3487 			*msgp++ = *r;
3488 		    else
3489 		    {
3490 			/* '&a' -> '[a]' */
3491 			*msgp++ = (dfltbutton == 1) ? '[' : '(';
3492 			msgp += copy_char(r, msgp, FALSE);
3493 			*msgp++ = (dfltbutton == 1) ? ']' : ')';
3494 
3495 			/* redefine hotkey */
3496 			(void)copy_char(r, hotkp, TRUE);
3497 		    }
3498 		}
3499 		else
3500 		{
3501 		    ++len;	    /* '&a' -> '[a]' */
3502 		    if (idx < HAS_HOTKEY_LEN - 1)
3503 			has_hotkey[idx] = TRUE;
3504 		}
3505 	    }
3506 	    else
3507 	    {
3508 		/* everything else copy literally */
3509 		if (copy)
3510 		    msgp += copy_char(r, msgp, FALSE);
3511 	    }
3512 
3513 	    /* advance to the next character */
3514 	    mb_ptr_adv(r);
3515 	}
3516 
3517 	if (copy)
3518 	{
3519 	    *msgp++ = ':';
3520 	    *msgp++ = ' ';
3521 	    *msgp = NUL;
3522 	    mb_ptr_adv(hotkp);
3523 	    *hotkp = NUL;
3524 	}
3525 	else
3526 	{
3527 	    len += (int)(STRLEN(message)
3528 			+ 2			/* for the NL's */
3529 			+ STRLEN(buttons)
3530 			+ 3);			/* for the ": " and NUL */
3531 	    lenhotkey++;			/* for the NUL */
3532 
3533 	    /* If no hotkey is specified first char is used. */
3534 	    if (!has_hotkey[0])
3535 	    {
3536 		first_hotkey = TRUE;
3537 		len += 2;		/* "x" -> "[x]" */
3538 	    }
3539 
3540 	    /*
3541 	     * Now allocate and load the strings
3542 	     */
3543 	    vim_free(confirm_msg);
3544 	    confirm_msg = alloc(len);
3545 	    if (confirm_msg == NULL)
3546 		return NULL;
3547 	    *confirm_msg = NUL;
3548 	    hotk = alloc(lenhotkey);
3549 	    if (hotk == NULL)
3550 		return NULL;
3551 
3552 	    *confirm_msg = '\n';
3553 	    STRCPY(confirm_msg + 1, message);
3554 
3555 	    msgp = confirm_msg + 1 + STRLEN(message);
3556 	    hotkp = hotk;
3557 
3558 	    /* define first default hotkey */
3559 	    (void)copy_char(buttons, hotkp, TRUE);
3560 
3561 	    /* Remember where the choices start, displaying starts here when
3562 	     * "hotkp" typed at the more prompt. */
3563 	    confirm_msg_tail = msgp;
3564 	    *msgp++ = '\n';
3565 	}
3566     }
3567 
3568     display_confirm_msg();
3569     return hotk;
3570 }
3571 
3572 /*
3573  * Display the ":confirm" message.  Also called when screen resized.
3574  */
3575     void
3576 display_confirm_msg()
3577 {
3578     /* avoid that 'q' at the more prompt truncates the message here */
3579     ++confirm_msg_used;
3580     if (confirm_msg != NULL)
3581 	msg_puts_attr(confirm_msg, hl_attr(HLF_M));
3582     --confirm_msg_used;
3583 }
3584 
3585 #endif /* FEAT_CON_DIALOG */
3586 
3587 #if defined(FEAT_CON_DIALOG) || defined(FEAT_GUI_DIALOG)
3588 
3589     int
3590 vim_dialog_yesno(type, title, message, dflt)
3591     int		type;
3592     char_u	*title;
3593     char_u	*message;
3594     int		dflt;
3595 {
3596     if (do_dialog(type,
3597 		title == NULL ? (char_u *)_("Question") : title,
3598 		message,
3599 		(char_u *)_("&Yes\n&No"), dflt, NULL) == 1)
3600 	return VIM_YES;
3601     return VIM_NO;
3602 }
3603 
3604     int
3605 vim_dialog_yesnocancel(type, title, message, dflt)
3606     int		type;
3607     char_u	*title;
3608     char_u	*message;
3609     int		dflt;
3610 {
3611     switch (do_dialog(type,
3612 		title == NULL ? (char_u *)_("Question") : title,
3613 		message,
3614 		(char_u *)_("&Yes\n&No\n&Cancel"), dflt, NULL))
3615     {
3616 	case 1: return VIM_YES;
3617 	case 2: return VIM_NO;
3618     }
3619     return VIM_CANCEL;
3620 }
3621 
3622     int
3623 vim_dialog_yesnoallcancel(type, title, message, dflt)
3624     int		type;
3625     char_u	*title;
3626     char_u	*message;
3627     int		dflt;
3628 {
3629     switch (do_dialog(type,
3630 		title == NULL ? (char_u *)"Question" : title,
3631 		message,
3632 		(char_u *)_("&Yes\n&No\nSave &All\n&Discard All\n&Cancel"),
3633 								  dflt, NULL))
3634     {
3635 	case 1: return VIM_YES;
3636 	case 2: return VIM_NO;
3637 	case 3: return VIM_ALL;
3638 	case 4: return VIM_DISCARDALL;
3639     }
3640     return VIM_CANCEL;
3641 }
3642 
3643 #endif /* FEAT_GUI_DIALOG || FEAT_CON_DIALOG */
3644 
3645 #if defined(FEAT_BROWSE) || defined(PROTO)
3646 /*
3647  * Generic browse function.  Calls gui_mch_browse() when possible.
3648  * Later this may pop-up a non-GUI file selector (external command?).
3649  */
3650     char_u *
3651 do_browse(flags, title, dflt, ext, initdir, filter, buf)
3652     int		flags;		/* BROWSE_SAVE and BROWSE_DIR */
3653     char_u	*title;		/* title for the window */
3654     char_u	*dflt;		/* default file name (may include directory) */
3655     char_u	*ext;		/* extension added */
3656     char_u	*initdir;	/* initial directory, NULL for current dir or
3657 				   when using path from "dflt" */
3658     char_u	*filter;	/* file name filter */
3659     buf_T	*buf;		/* buffer to read/write for */
3660 {
3661     char_u		*fname;
3662     static char_u	*last_dir = NULL;    /* last used directory */
3663     char_u		*tofree = NULL;
3664     int			save_browse = cmdmod.browse;
3665 
3666     /* Must turn off browse to avoid that autocommands will get the
3667      * flag too!  */
3668     cmdmod.browse = FALSE;
3669 
3670     if (title == NULL || *title == NUL)
3671     {
3672 	if (flags & BROWSE_DIR)
3673 	    title = (char_u *)_("Select Directory dialog");
3674 	else if (flags & BROWSE_SAVE)
3675 	    title = (char_u *)_("Save File dialog");
3676 	else
3677 	    title = (char_u *)_("Open File dialog");
3678     }
3679 
3680     /* When no directory specified, use default file name, default dir, buffer
3681      * dir, last dir or current dir */
3682     if ((initdir == NULL || *initdir == NUL) && dflt != NULL && *dflt != NUL)
3683     {
3684 	if (mch_isdir(dflt))		/* default file name is a directory */
3685 	{
3686 	    initdir = dflt;
3687 	    dflt = NULL;
3688 	}
3689 	else if (gettail(dflt) != dflt)	/* default file name includes a path */
3690 	{
3691 	    tofree = vim_strsave(dflt);
3692 	    if (tofree != NULL)
3693 	    {
3694 		initdir = tofree;
3695 		*gettail(initdir) = NUL;
3696 		dflt = gettail(dflt);
3697 	    }
3698 	}
3699     }
3700 
3701     if (initdir == NULL || *initdir == NUL)
3702     {
3703 	/* When 'browsedir' is a directory, use it */
3704 	if (STRCMP(p_bsdir, "last") != 0
3705 		&& STRCMP(p_bsdir, "buffer") != 0
3706 		&& STRCMP(p_bsdir, "current") != 0
3707 		&& mch_isdir(p_bsdir))
3708 	    initdir = p_bsdir;
3709 	/* When saving or 'browsedir' is "buffer", use buffer fname */
3710 	else if (((flags & BROWSE_SAVE) || *p_bsdir == 'b')
3711 		&& buf != NULL && buf->b_ffname != NULL)
3712 	{
3713 	    if (dflt == NULL || *dflt == NUL)
3714 		dflt = gettail(curbuf->b_ffname);
3715 	    tofree = vim_strsave(curbuf->b_ffname);
3716 	    if (tofree != NULL)
3717 	    {
3718 		initdir = tofree;
3719 		*gettail(initdir) = NUL;
3720 	    }
3721 	}
3722 	/* When 'browsedir' is "last", use dir from last browse */
3723 	else if (*p_bsdir == 'l')
3724 	    initdir = last_dir;
3725 	/* When 'browsedir is "current", use current directory.  This is the
3726 	 * default already, leave initdir empty. */
3727     }
3728 
3729 # ifdef FEAT_GUI
3730     if (gui.in_use)		/* when this changes, also adjust f_has()! */
3731     {
3732 	if (filter == NULL
3733 #  ifdef FEAT_EVAL
3734 		&& (filter = get_var_value((char_u *)"b:browsefilter")) == NULL
3735 		&& (filter = get_var_value((char_u *)"g:browsefilter")) == NULL
3736 #  endif
3737 	)
3738 	    filter = BROWSE_FILTER_DEFAULT;
3739 	if (flags & BROWSE_DIR)
3740 	{
3741 #  if defined(HAVE_GTK2) || defined(WIN3264)
3742 	    /* For systems that have a directory dialog. */
3743 	    fname = gui_mch_browsedir(title, initdir);
3744 #  else
3745 	    /* Generic solution for selecting a directory: select a file and
3746 	     * remove the file name. */
3747 	    fname = gui_mch_browse(0, title, dflt, ext, initdir, (char_u *)"");
3748 #  endif
3749 #  if !defined(HAVE_GTK2)
3750 	    /* Win32 adds a dummy file name, others return an arbitrary file
3751 	     * name.  GTK+ 2 returns only the directory, */
3752 	    if (fname != NULL && *fname != NUL && !mch_isdir(fname))
3753 	    {
3754 		/* Remove the file name. */
3755 		char_u	    *tail = gettail_sep(fname);
3756 
3757 		if (tail == fname)
3758 		    *tail++ = '.';	/* use current dir */
3759 		*tail = NUL;
3760 	    }
3761 #  endif
3762 	}
3763 	else
3764 	    fname = gui_mch_browse(flags & BROWSE_SAVE,
3765 					   title, dflt, ext, initdir, filter);
3766 
3767 	/* We hang around in the dialog for a while, the user might do some
3768 	 * things to our files.  The Win32 dialog allows deleting or renaming
3769 	 * a file, check timestamps. */
3770 	need_check_timestamps = TRUE;
3771 	did_check_timestamps = FALSE;
3772     }
3773     else
3774 # endif
3775     {
3776 	/* TODO: non-GUI file selector here */
3777 	EMSG(_("E338: Sorry, no file browser in console mode"));
3778 	fname = NULL;
3779     }
3780 
3781     /* keep the directory for next time */
3782     if (fname != NULL)
3783     {
3784 	vim_free(last_dir);
3785 	last_dir = vim_strsave(fname);
3786 	if (last_dir != NULL && !(flags & BROWSE_DIR))
3787 	{
3788 	    *gettail(last_dir) = NUL;
3789 	    if (*last_dir == NUL)
3790 	    {
3791 		/* filename only returned, must be in current dir */
3792 		vim_free(last_dir);
3793 		last_dir = alloc(MAXPATHL);
3794 		if (last_dir != NULL)
3795 		    mch_dirname(last_dir, MAXPATHL);
3796 	    }
3797 	}
3798     }
3799 
3800     vim_free(tofree);
3801     cmdmod.browse = save_browse;
3802 
3803     return fname;
3804 }
3805 #endif
3806 
3807 #if defined(HAVE_STDARG_H) && defined(FEAT_EVAL)
3808 static char *e_printf = N_("E766: Insufficient arguments for printf()");
3809 
3810 static long tv_nr __ARGS((typval_T *tvs, int *idxp));
3811 static char *tv_str __ARGS((typval_T *tvs, int *idxp));
3812 
3813 /*
3814  * Get number argument from "idxp" entry in "tvs".  First entry is 1.
3815  */
3816     static long
3817 tv_nr(tvs, idxp)
3818     typval_T	*tvs;
3819     int		*idxp;
3820 {
3821     int		idx = *idxp - 1;
3822     long	n = 0;
3823     int		err = FALSE;
3824 
3825     if (tvs[idx].v_type == VAR_UNKNOWN)
3826 	EMSG(_(e_printf));
3827     else
3828     {
3829 	++*idxp;
3830 	n = get_tv_number_chk(&tvs[idx], &err);
3831 	if (err)
3832 	    n = 0;
3833     }
3834     return n;
3835 }
3836 
3837 /*
3838  * Get string argument from "idxp" entry in "tvs".  First entry is 1.
3839  * Returns NULL for an error.
3840  */
3841     static char *
3842 tv_str(tvs, idxp)
3843     typval_T	*tvs;
3844     int		*idxp;
3845 {
3846     int		idx = *idxp - 1;
3847     char	*s = NULL;
3848 
3849     if (tvs[idx].v_type == VAR_UNKNOWN)
3850 	EMSG(_(e_printf));
3851     else
3852     {
3853 	++*idxp;
3854 	s = (char *)get_tv_string_chk(&tvs[idx]);
3855     }
3856     return s;
3857 }
3858 #endif
3859 
3860 /*
3861  * This code was included to provide a portable vsnprintf() and snprintf().
3862  * Some systems may provide their own, but we always use this one for
3863  * consistency.
3864  *
3865  * This code is based on snprintf.c - a portable implementation of snprintf
3866  * by Mark Martinec <[email protected]>, Version 2.2, 2000-10-06.
3867  * Included with permission.  It was heavily modified to fit in Vim.
3868  * The original code, including useful comments, can be found here:
3869  *	http://www.ijs.si/software/snprintf/
3870  *
3871  * This snprintf() only supports the following conversion specifiers:
3872  * s, c, d, u, o, x, X, p  (and synonyms: i, D, U, O - see below)
3873  * with flags: '-', '+', ' ', '0' and '#'.
3874  * An asterisk is supported for field width as well as precision.
3875  *
3876  * Length modifiers 'h' (short int) and 'l' (long int) are supported.
3877  * 'll' (long long int) is not supported.
3878  *
3879  * The locale is not used, the string is used as a byte string.  This is only
3880  * relevant for double-byte encodings where the second byte may be '%'.
3881  *
3882  * It is permitted for "str_m" to be zero, and it is permitted to specify NULL
3883  * pointer for resulting string argument if "str_m" is zero (as per ISO C99).
3884  *
3885  * The return value is the number of characters which would be generated
3886  * for the given input, excluding the trailing null. If this value
3887  * is greater or equal to "str_m", not all characters from the result
3888  * have been stored in str, output bytes beyond the ("str_m"-1) -th character
3889  * are discarded. If "str_m" is greater than zero it is guaranteed
3890  * the resulting string will be null-terminated.
3891  */
3892 
3893 /*
3894  * When va_list is not supported we only define vim_snprintf().
3895  *
3896  * vim_vsnprintf() can be invoked with either "va_list" or a list of
3897  * "typval_T".  When the latter is not used it must be NULL.
3898  */
3899 
3900 /* When generating prototypes all of this is skipped, cproto doesn't
3901  * understand this. */
3902 #ifndef PROTO
3903 # ifdef HAVE_STDARG_H
3904     int
3905 vim_snprintf(char *str, size_t str_m, char *fmt, ...)
3906 {
3907     va_list	ap;
3908     int		str_l;
3909 
3910     va_start(ap, fmt);
3911     str_l = vim_vsnprintf(str, str_m, fmt, ap, NULL);
3912     va_end(ap);
3913     return str_l;
3914 }
3915 
3916     int
3917 vim_vsnprintf(str, str_m, fmt, ap, tvs)
3918 # else
3919     /* clumsy way to work around missing va_list */
3920 #  define get_a_arg(i) (++i, i == 2 ? a1 : i == 3 ? a2 : i == 4 ? a3 : i == 5 ? a4 : i == 6 ? a5 : i == 7 ? a6 : i == 8 ? a7 : i == 9 ? a8 : i == 10 ? a9 : a10)
3921 
3922 /* VARARGS */
3923     int
3924 #ifdef __BORLANDC__
3925 _RTLENTRYF
3926 #endif
3927 vim_snprintf(str, str_m, fmt, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10)
3928 # endif
3929     char	*str;
3930     size_t	str_m;
3931     char	*fmt;
3932 # ifdef HAVE_STDARG_H
3933     va_list	ap;
3934     typval_T	*tvs;
3935 # else
3936     long	a1, a2, a3, a4, a5, a6, a7, a8, a9, a10;
3937 # endif
3938 {
3939     size_t	str_l = 0;
3940     char	*p = fmt;
3941     int		arg_idx = 1;
3942 
3943     if (p == NULL)
3944 	p = "";
3945     while (*p != NUL)
3946     {
3947 	if (*p != '%')
3948 	{
3949 	    char    *q = strchr(p + 1, '%');
3950 	    size_t  n = (q == NULL) ? STRLEN(p) : (q - p);
3951 
3952 	    /* Copy up to the next '%' or NUL without any changes. */
3953 	    if (str_l < str_m)
3954 	    {
3955 		size_t avail = str_m - str_l;
3956 
3957 		mch_memmove(str + str_l, p, n > avail ? avail : n);
3958 	    }
3959 	    p += n;
3960 	    str_l += n;
3961 	}
3962 	else
3963 	{
3964 	    size_t  min_field_width = 0, precision = 0;
3965 	    int	    zero_padding = 0, precision_specified = 0, justify_left = 0;
3966 	    int	    alternate_form = 0, force_sign = 0;
3967 
3968 	    /* If both the ' ' and '+' flags appear, the ' ' flag should be
3969 	     * ignored. */
3970 	    int	    space_for_positive = 1;
3971 
3972 	    /* allowed values: \0, h, l, L */
3973 	    char    length_modifier = '\0';
3974 
3975 	    /* temporary buffer for simple numeric->string conversion */
3976 	    char    tmp[32];
3977 
3978 	    /* string address in case of string argument */
3979 	    char    *str_arg;
3980 
3981 	    /* natural field width of arg without padding and sign */
3982 	    size_t  str_arg_l;
3983 
3984 	    /* unsigned char argument value - only defined for c conversion.
3985 	     * N.B. standard explicitly states the char argument for the c
3986 	     * conversion is unsigned */
3987 	    unsigned char uchar_arg;
3988 
3989 	    /* number of zeros to be inserted for numeric conversions as
3990 	     * required by the precision or minimal field width */
3991 	    size_t  number_of_zeros_to_pad = 0;
3992 
3993 	    /* index into tmp where zero padding is to be inserted */
3994 	    size_t  zero_padding_insertion_ind = 0;
3995 
3996 	    /* current conversion specifier character */
3997 	    char    fmt_spec = '\0';
3998 
3999 	    str_arg = NULL;
4000 	    p++;  /* skip '%' */
4001 
4002 	    /* parse flags */
4003 	    while (*p == '0' || *p == '-' || *p == '+' || *p == ' '
4004 						   || *p == '#' || *p == '\'')
4005 	    {
4006 		switch (*p)
4007 		{
4008 		    case '0': zero_padding = 1; break;
4009 		    case '-': justify_left = 1; break;
4010 		    case '+': force_sign = 1; space_for_positive = 0; break;
4011 		    case ' ': force_sign = 1;
4012 			      /* If both the ' ' and '+' flags appear, the ' '
4013 			       * flag should be ignored */
4014 			      break;
4015 		    case '#': alternate_form = 1; break;
4016 		    case '\'': break;
4017 		}
4018 		p++;
4019 	    }
4020 	    /* If the '0' and '-' flags both appear, the '0' flag should be
4021 	     * ignored. */
4022 
4023 	    /* parse field width */
4024 	    if (*p == '*')
4025 	    {
4026 		int j;
4027 
4028 		p++;
4029 		j =
4030 #ifndef HAVE_STDARG_H
4031 		    get_a_arg(arg_idx);
4032 #else
4033 # if defined(FEAT_EVAL)
4034 		    tvs != NULL ? tv_nr(tvs, &arg_idx) :
4035 # endif
4036 			va_arg(ap, int);
4037 #endif
4038 		if (j >= 0)
4039 		    min_field_width = j;
4040 		else
4041 		{
4042 		    min_field_width = -j;
4043 		    justify_left = 1;
4044 		}
4045 	    }
4046 	    else if (VIM_ISDIGIT((int)(*p)))
4047 	    {
4048 		/* size_t could be wider than unsigned int; make sure we treat
4049 		 * argument like common implementations do */
4050 		unsigned int uj = *p++ - '0';
4051 
4052 		while (VIM_ISDIGIT((int)(*p)))
4053 		    uj = 10 * uj + (unsigned int)(*p++ - '0');
4054 		min_field_width = uj;
4055 	    }
4056 
4057 	    /* parse precision */
4058 	    if (*p == '.')
4059 	    {
4060 		p++;
4061 		precision_specified = 1;
4062 		if (*p == '*')
4063 		{
4064 		    int j;
4065 
4066 		    j =
4067 #ifndef HAVE_STDARG_H
4068 			get_a_arg(arg_idx);
4069 #else
4070 # if defined(FEAT_EVAL)
4071 			tvs != NULL ? tv_nr(tvs, &arg_idx) :
4072 # endif
4073 			    va_arg(ap, int);
4074 #endif
4075 		    p++;
4076 		    if (j >= 0)
4077 			precision = j;
4078 		    else
4079 		    {
4080 			precision_specified = 0;
4081 			precision = 0;
4082 		    }
4083 		}
4084 		else if (VIM_ISDIGIT((int)(*p)))
4085 		{
4086 		    /* size_t could be wider than unsigned int; make sure we
4087 		     * treat argument like common implementations do */
4088 		    unsigned int uj = *p++ - '0';
4089 
4090 		    while (VIM_ISDIGIT((int)(*p)))
4091 			uj = 10 * uj + (unsigned int)(*p++ - '0');
4092 		    precision = uj;
4093 		}
4094 	    }
4095 
4096 	    /* parse 'h', 'l' and 'll' length modifiers */
4097 	    if (*p == 'h' || *p == 'l')
4098 	    {
4099 		length_modifier = *p;
4100 		p++;
4101 		if (length_modifier == 'l' && *p == 'l')
4102 		{
4103 		    /* double l = long long */
4104 		    length_modifier = 'l';	/* treat it as a single 'l' */
4105 		    p++;
4106 		}
4107 	    }
4108 	    fmt_spec = *p;
4109 
4110 	    /* common synonyms: */
4111 	    switch (fmt_spec)
4112 	    {
4113 		case 'i': fmt_spec = 'd'; break;
4114 		case 'D': fmt_spec = 'd'; length_modifier = 'l'; break;
4115 		case 'U': fmt_spec = 'u'; length_modifier = 'l'; break;
4116 		case 'O': fmt_spec = 'o'; length_modifier = 'l'; break;
4117 		default: break;
4118 	    }
4119 
4120 	    /* get parameter value, do initial processing */
4121 	    switch (fmt_spec)
4122 	    {
4123 		/* '%' and 'c' behave similar to 's' regarding flags and field
4124 		 * widths */
4125 	    case '%':
4126 	    case 'c':
4127 	    case 's':
4128 		length_modifier = '\0';
4129 		str_arg_l = 1;
4130 		switch (fmt_spec)
4131 		{
4132 		case '%':
4133 		    str_arg = p;
4134 		    break;
4135 
4136 		case 'c':
4137 		    {
4138 			int j;
4139 
4140 			j =
4141 #ifndef HAVE_STDARG_H
4142 			    get_a_arg(arg_idx);
4143 #else
4144 # if defined(FEAT_EVAL)
4145 			    tvs != NULL ? tv_nr(tvs, &arg_idx) :
4146 # endif
4147 				va_arg(ap, int);
4148 #endif
4149 			/* standard demands unsigned char */
4150 			uchar_arg = (unsigned char)j;
4151 			str_arg = (char *)&uchar_arg;
4152 			break;
4153 		    }
4154 
4155 		case 's':
4156 		    str_arg =
4157 #ifndef HAVE_STDARG_H
4158 				(char *)get_a_arg(arg_idx);
4159 #else
4160 # if defined(FEAT_EVAL)
4161 				tvs != NULL ? tv_str(tvs, &arg_idx) :
4162 # endif
4163 				    va_arg(ap, char *);
4164 #endif
4165 		    if (str_arg == NULL)
4166 		    {
4167 			str_arg = "[NULL]";
4168 			str_arg_l = 6;
4169 		    }
4170 		    /* make sure not to address string beyond the specified
4171 		     * precision !!! */
4172 		    else if (!precision_specified)
4173 			str_arg_l = strlen(str_arg);
4174 		    /* truncate string if necessary as requested by precision */
4175 		    else if (precision == 0)
4176 			str_arg_l = 0;
4177 		    else
4178 		    {
4179 			/* Don't put the #if inside memchr(), it can be a
4180 			 * macro. */
4181 #if SIZEOF_INT <= 2
4182 			char *q = memchr(str_arg, '\0', precision);
4183 #else
4184 			/* memchr on HP does not like n > 2^31  !!! */
4185 			char *q = memchr(str_arg, '\0',
4186 				  precision <= (size_t)0x7fffffffL ? precision
4187 						       : (size_t)0x7fffffffL);
4188 #endif
4189 			str_arg_l = (q == NULL) ? precision : q - str_arg;
4190 		    }
4191 		    break;
4192 
4193 		default:
4194 		    break;
4195 		}
4196 		break;
4197 
4198 	    case 'd': case 'u': case 'o': case 'x': case 'X': case 'p':
4199 		{
4200 		    /* NOTE: the u, o, x, X and p conversion specifiers
4201 		     * imply the value is unsigned;  d implies a signed
4202 		     * value */
4203 
4204 		    /* 0 if numeric argument is zero (or if pointer is
4205 		     * NULL for 'p'), +1 if greater than zero (or nonzero
4206 		     * for unsigned arguments), -1 if negative (unsigned
4207 		     * argument is never negative) */
4208 		    int arg_sign = 0;
4209 
4210 		    /* only defined for length modifier h, or for no
4211 		     * length modifiers */
4212 		    int int_arg = 0;
4213 		    unsigned int uint_arg = 0;
4214 
4215 		    /* only defined for length modifier l */
4216 		    long int long_arg = 0;
4217 		    unsigned long int ulong_arg = 0;
4218 
4219 		    /* pointer argument value -only defined for p
4220 		     * conversion */
4221 		    void *ptr_arg = NULL;
4222 
4223 		    if (fmt_spec == 'p')
4224 		    {
4225 			length_modifier = '\0';
4226 			ptr_arg =
4227 #ifndef HAVE_STDARG_H
4228 				 (void *)get_a_arg(arg_idx);
4229 #else
4230 # if defined(FEAT_EVAL)
4231 				 tvs != NULL ? (void *)tv_str(tvs, &arg_idx) :
4232 # endif
4233 					va_arg(ap, void *);
4234 #endif
4235 			if (ptr_arg != NULL)
4236 			    arg_sign = 1;
4237 		    }
4238 		    else if (fmt_spec == 'd')
4239 		    {
4240 			/* signed */
4241 			switch (length_modifier)
4242 			{
4243 			case '\0':
4244 			case 'h':
4245 			    /* char and short arguments are passed as int. */
4246 			    int_arg =
4247 #ifndef HAVE_STDARG_H
4248 					get_a_arg(arg_idx);
4249 #else
4250 # if defined(FEAT_EVAL)
4251 					tvs != NULL ? tv_nr(tvs, &arg_idx) :
4252 # endif
4253 					    va_arg(ap, int);
4254 #endif
4255 			    if (int_arg > 0)
4256 				arg_sign =  1;
4257 			    else if (int_arg < 0)
4258 				arg_sign = -1;
4259 			    break;
4260 			case 'l':
4261 			    long_arg =
4262 #ifndef HAVE_STDARG_H
4263 					get_a_arg(arg_idx);
4264 #else
4265 # if defined(FEAT_EVAL)
4266 					tvs != NULL ? tv_nr(tvs, &arg_idx) :
4267 # endif
4268 					    va_arg(ap, long int);
4269 #endif
4270 			    if (long_arg > 0)
4271 				arg_sign =  1;
4272 			    else if (long_arg < 0)
4273 				arg_sign = -1;
4274 			    break;
4275 			}
4276 		    }
4277 		    else
4278 		    {
4279 			/* unsigned */
4280 			switch (length_modifier)
4281 			{
4282 			    case '\0':
4283 			    case 'h':
4284 				uint_arg =
4285 #ifndef HAVE_STDARG_H
4286 					    get_a_arg(arg_idx);
4287 #else
4288 # if defined(FEAT_EVAL)
4289 					    tvs != NULL ? tv_nr(tvs, &arg_idx) :
4290 # endif
4291 						va_arg(ap, unsigned int);
4292 #endif
4293 				if (uint_arg != 0)
4294 				    arg_sign = 1;
4295 				break;
4296 			    case 'l':
4297 				ulong_arg =
4298 #ifndef HAVE_STDARG_H
4299 					    get_a_arg(arg_idx);
4300 #else
4301 # if defined(FEAT_EVAL)
4302 					    tvs != NULL ? tv_nr(tvs, &arg_idx) :
4303 # endif
4304 						va_arg(ap, unsigned long int);
4305 #endif
4306 				if (ulong_arg != 0)
4307 				    arg_sign = 1;
4308 				break;
4309 			}
4310 		    }
4311 
4312 		    str_arg = tmp;
4313 		    str_arg_l = 0;
4314 
4315 		    /* NOTE:
4316 		     *   For d, i, u, o, x, and X conversions, if precision is
4317 		     *   specified, the '0' flag should be ignored. This is so
4318 		     *   with Solaris 2.6, Digital UNIX 4.0, HPUX 10, Linux,
4319 		     *   FreeBSD, NetBSD; but not with Perl.
4320 		     */
4321 		    if (precision_specified)
4322 			zero_padding = 0;
4323 		    if (fmt_spec == 'd')
4324 		    {
4325 			if (force_sign && arg_sign >= 0)
4326 			    tmp[str_arg_l++] = space_for_positive ? ' ' : '+';
4327 			/* leave negative numbers for sprintf to handle, to
4328 			 * avoid handling tricky cases like (short int)-32768 */
4329 		    }
4330 		    else if (alternate_form)
4331 		    {
4332 			if (arg_sign != 0
4333 				     && (fmt_spec == 'x' || fmt_spec == 'X') )
4334 			{
4335 			    tmp[str_arg_l++] = '0';
4336 			    tmp[str_arg_l++] = fmt_spec;
4337 			}
4338 			/* alternate form should have no effect for p
4339 			 * conversion, but ... */
4340 		    }
4341 
4342 		    zero_padding_insertion_ind = str_arg_l;
4343 		    if (!precision_specified)
4344 			precision = 1;   /* default precision is 1 */
4345 		    if (precision == 0 && arg_sign == 0)
4346 		    {
4347 			/* When zero value is formatted with an explicit
4348 			 * precision 0, the resulting formatted string is
4349 			 * empty (d, i, u, o, x, X, p).   */
4350 		    }
4351 		    else
4352 		    {
4353 			char	f[5];
4354 			int	f_l = 0;
4355 
4356 			/* construct a simple format string for sprintf */
4357 			f[f_l++] = '%';
4358 			if (!length_modifier)
4359 			    ;
4360 			else if (length_modifier == '2')
4361 			{
4362 			    f[f_l++] = 'l';
4363 			    f[f_l++] = 'l';
4364 			}
4365 			else
4366 			    f[f_l++] = length_modifier;
4367 			f[f_l++] = fmt_spec;
4368 			f[f_l++] = '\0';
4369 
4370 			if (fmt_spec == 'p')
4371 			    str_arg_l += sprintf(tmp + str_arg_l, f, ptr_arg);
4372 			else if (fmt_spec == 'd')
4373 			{
4374 			    /* signed */
4375 			    switch (length_modifier)
4376 			    {
4377 			    case '\0':
4378 			    case 'h': str_arg_l += sprintf(
4379 						 tmp + str_arg_l, f, int_arg);
4380 				      break;
4381 			    case 'l': str_arg_l += sprintf(
4382 						tmp + str_arg_l, f, long_arg);
4383 				      break;
4384 			    }
4385 			}
4386 			else
4387 			{
4388 			    /* unsigned */
4389 			    switch (length_modifier)
4390 			    {
4391 			    case '\0':
4392 			    case 'h': str_arg_l += sprintf(
4393 						tmp + str_arg_l, f, uint_arg);
4394 				      break;
4395 			    case 'l': str_arg_l += sprintf(
4396 					       tmp + str_arg_l, f, ulong_arg);
4397 				      break;
4398 			    }
4399 			}
4400 
4401 			/* include the optional minus sign and possible
4402 			 * "0x" in the region before the zero padding
4403 			 * insertion point */
4404 			if (zero_padding_insertion_ind < str_arg_l
4405 				&& tmp[zero_padding_insertion_ind] == '-')
4406 			    zero_padding_insertion_ind++;
4407 			if (zero_padding_insertion_ind + 1 < str_arg_l
4408 				&& tmp[zero_padding_insertion_ind]   == '0'
4409 				&& (tmp[zero_padding_insertion_ind + 1] == 'x'
4410 				 || tmp[zero_padding_insertion_ind + 1] == 'X'))
4411 			    zero_padding_insertion_ind += 2;
4412 		    }
4413 
4414 		    {
4415 			size_t num_of_digits = str_arg_l
4416 						 - zero_padding_insertion_ind;
4417 
4418 			if (alternate_form && fmt_spec == 'o'
4419 				/* unless zero is already the first
4420 				 * character */
4421 				&& !(zero_padding_insertion_ind < str_arg_l
4422 				    && tmp[zero_padding_insertion_ind] == '0'))
4423 			{
4424 			    /* assure leading zero for alternate-form
4425 			     * octal numbers */
4426 			    if (!precision_specified
4427 					     || precision < num_of_digits + 1)
4428 			    {
4429 				/* precision is increased to force the
4430 				 * first character to be zero, except if a
4431 				 * zero value is formatted with an
4432 				 * explicit precision of zero */
4433 				precision = num_of_digits + 1;
4434 				precision_specified = 1;
4435 			    }
4436 			}
4437 			/* zero padding to specified precision? */
4438 			if (num_of_digits < precision)
4439 			    number_of_zeros_to_pad = precision - num_of_digits;
4440 		    }
4441 		    /* zero padding to specified minimal field width? */
4442 		    if (!justify_left && zero_padding)
4443 		    {
4444 			int n = (int)(min_field_width - (str_arg_l
4445 						    + number_of_zeros_to_pad));
4446 			if (n > 0)
4447 			    number_of_zeros_to_pad += n;
4448 		    }
4449 		    break;
4450 		}
4451 
4452 	    default:
4453 		/* unrecognized conversion specifier, keep format string
4454 		 * as-is */
4455 		zero_padding = 0;  /* turn zero padding off for non-numeric
4456 				      conversion */
4457 		justify_left = 1;
4458 		min_field_width = 0;		    /* reset flags */
4459 
4460 		/* discard the unrecognized conversion, just keep *
4461 		 * the unrecognized conversion character	  */
4462 		str_arg = p;
4463 		str_arg_l = 0;
4464 		if (*p != NUL)
4465 		    str_arg_l++;  /* include invalid conversion specifier
4466 				     unchanged if not at end-of-string */
4467 		break;
4468 	    }
4469 
4470 	    if (*p != NUL)
4471 		p++;     /* step over the just processed conversion specifier */
4472 
4473 	    /* insert padding to the left as requested by min_field_width;
4474 	     * this does not include the zero padding in case of numerical
4475 	     * conversions*/
4476 	    if (!justify_left)
4477 	    {
4478 		/* left padding with blank or zero */
4479 		int pn = (int)(min_field_width - (str_arg_l + number_of_zeros_to_pad));
4480 
4481 		if (pn > 0)
4482 		{
4483 		    if (str_l < str_m)
4484 		    {
4485 			size_t avail = str_m - str_l;
4486 
4487 			vim_memset(str + str_l, zero_padding ? '0' : ' ',
4488 					     (size_t)pn > avail ? avail : pn);
4489 		    }
4490 		    str_l += pn;
4491 		}
4492 	    }
4493 
4494 	    /* zero padding as requested by the precision or by the minimal
4495 	     * field width for numeric conversions required? */
4496 	    if (number_of_zeros_to_pad == 0)
4497 	    {
4498 		/* will not copy first part of numeric right now, *
4499 		 * force it to be copied later in its entirety    */
4500 		zero_padding_insertion_ind = 0;
4501 	    }
4502 	    else
4503 	    {
4504 		/* insert first part of numerics (sign or '0x') before zero
4505 		 * padding */
4506 		int zn = (int)zero_padding_insertion_ind;
4507 
4508 		if (zn > 0)
4509 		{
4510 		    if (str_l < str_m)
4511 		    {
4512 			size_t avail = str_m - str_l;
4513 
4514 			mch_memmove(str + str_l, str_arg,
4515 					     (size_t)zn > avail ? avail : zn);
4516 		    }
4517 		    str_l += zn;
4518 		}
4519 
4520 		/* insert zero padding as requested by the precision or min
4521 		 * field width */
4522 		zn = (int)number_of_zeros_to_pad;
4523 		if (zn > 0)
4524 		{
4525 		    if (str_l < str_m)
4526 		    {
4527 			size_t avail = str_m-str_l;
4528 
4529 			vim_memset(str + str_l, '0',
4530 					     (size_t)zn > avail ? avail : zn);
4531 		    }
4532 		    str_l += zn;
4533 		}
4534 	    }
4535 
4536 	    /* insert formatted string
4537 	     * (or as-is conversion specifier for unknown conversions) */
4538 	    {
4539 		int sn = (int)(str_arg_l - zero_padding_insertion_ind);
4540 
4541 		if (sn > 0)
4542 		{
4543 		    if (str_l < str_m)
4544 		    {
4545 			size_t avail = str_m - str_l;
4546 
4547 			mch_memmove(str + str_l,
4548 				str_arg + zero_padding_insertion_ind,
4549 				(size_t)sn > avail ? avail : sn);
4550 		    }
4551 		    str_l += sn;
4552 		}
4553 	    }
4554 
4555 	    /* insert right padding */
4556 	    if (justify_left)
4557 	    {
4558 		/* right blank padding to the field width */
4559 		int pn = (int)(min_field_width - (str_arg_l + number_of_zeros_to_pad));
4560 
4561 		if (pn > 0)
4562 		{
4563 		    if (str_l < str_m)
4564 		    {
4565 			size_t avail = str_m - str_l;
4566 
4567 			vim_memset(str + str_l, ' ',
4568 					     (size_t)pn > avail ? avail : pn);
4569 		    }
4570 		    str_l += pn;
4571 		}
4572 	    }
4573 	}
4574     }
4575 
4576     if (str_m > 0)
4577     {
4578 	/* make sure the string is nul-terminated even at the expense of
4579 	 * overwriting the last character (shouldn't happen, but just in case)
4580 	 * */
4581 	str[str_l <= str_m - 1 ? str_l : str_m - 1] = '\0';
4582     }
4583 
4584 #ifdef HAVE_STDARG_H
4585     if (tvs != NULL && tvs[arg_idx - 1].v_type != VAR_UNKNOWN)
4586 	EMSG(_("E767: Too many arguments to printf()"));
4587 #endif
4588 
4589     /* Return the number of characters formatted (excluding trailing nul
4590      * character), that is, the number of characters that would have been
4591      * written to the buffer if it were large enough. */
4592     return (int)str_l;
4593 }
4594 
4595 #endif /* PROTO */
4596