[7.2.256] When 'guifont' was not set GTK font dialog doesn't have a default.
[vim_extended.git] / src / ex_cmds.c
blob68627a578b7f269417e09d341ec02f79129f2873
1 /* vi:set ts=8 sts=4 sw=4:
3 * VIM - Vi IMproved by Bram Moolenaar
5 * Do ":help uganda" in Vim to read copying and usage conditions.
6 * Do ":help credits" in Vim to see a list of people who contributed.
7 * See README.txt for an overview of the Vim source code.
8 */
11 * ex_cmds.c: some functions for command line commands
14 #if defined(MSDOS) || defined(WIN16) || defined(WIN32) || defined(_WIN64)
15 # include "vimio.h" /* for mch_open(), must be before vim.h */
16 #endif
18 #include "vim.h"
19 #include "version.h"
21 #ifdef FEAT_EX_EXTRA
22 static int linelen __ARGS((int *has_tab));
23 #endif
24 static void do_filter __ARGS((linenr_T line1, linenr_T line2, exarg_T *eap, char_u *cmd, int do_in, int do_out));
25 #ifdef FEAT_VIMINFO
26 static char_u *viminfo_filename __ARGS((char_u *));
27 static void do_viminfo __ARGS((FILE *fp_in, FILE *fp_out, int flags));
28 static int viminfo_encoding __ARGS((vir_T *virp));
29 static int read_viminfo_up_to_marks __ARGS((vir_T *virp, int forceit, int writing));
30 #endif
32 static int check_overwrite __ARGS((exarg_T *eap, buf_T *buf, char_u *fname, char_u *ffname, int other));
33 static int check_readonly __ARGS((int *forceit, buf_T *buf));
34 #ifdef FEAT_AUTOCMD
35 static void delbuf_msg __ARGS((char_u *name));
36 #endif
37 static int
38 #ifdef __BORLANDC__
39 _RTLENTRYF
40 #endif
41 help_compare __ARGS((const void *s1, const void *s2));
44 * ":ascii" and "ga".
46 void
47 do_ascii(eap)
48 exarg_T *eap UNUSED;
50 int c;
51 int cval;
52 char buf1[20];
53 char buf2[20];
54 char_u buf3[7];
55 #ifdef FEAT_MBYTE
56 int cc[MAX_MCO];
57 int ci = 0;
58 int len;
60 if (enc_utf8)
61 c = utfc_ptr2char(ml_get_cursor(), cc);
62 else
63 #endif
64 c = gchar_cursor();
65 if (c == NUL)
67 MSG("NUL");
68 return;
71 #ifdef FEAT_MBYTE
72 IObuff[0] = NUL;
73 if (!has_mbyte || (enc_dbcs != 0 && c < 0x100) || c < 0x80)
74 #endif
76 if (c == NL) /* NUL is stored as NL */
77 c = NUL;
78 if (c == CAR && get_fileformat(curbuf) == EOL_MAC)
79 cval = NL; /* NL is stored as CR */
80 else
81 cval = c;
82 if (vim_isprintc_strict(c) && (c < ' '
83 #ifndef EBCDIC
84 || c > '~'
85 #endif
88 transchar_nonprint(buf3, c);
89 vim_snprintf(buf1, sizeof(buf1), " <%s>", (char *)buf3);
91 else
92 buf1[0] = NUL;
93 #ifndef EBCDIC
94 if (c >= 0x80)
95 vim_snprintf(buf2, sizeof(buf2), " <M-%s>",
96 (char *)transchar(c & 0x7f));
97 else
98 #endif
99 buf2[0] = NUL;
100 vim_snprintf((char *)IObuff, IOSIZE,
101 _("<%s>%s%s %d, Hex %02x, Octal %03o"),
102 transchar(c), buf1, buf2, cval, cval, cval);
103 #ifdef FEAT_MBYTE
104 if (enc_utf8)
105 c = cc[ci++];
106 else
107 c = 0;
108 #endif
111 #ifdef FEAT_MBYTE
112 /* Repeat for combining characters. */
113 while (has_mbyte && (c >= 0x100 || (enc_utf8 && c >= 0x80)))
115 len = (int)STRLEN(IObuff);
116 /* This assumes every multi-byte char is printable... */
117 if (len > 0)
118 IObuff[len++] = ' ';
119 IObuff[len++] = '<';
120 if (enc_utf8 && utf_iscomposing(c)
121 # ifdef USE_GUI
122 && !gui.in_use
123 # endif
125 IObuff[len++] = ' '; /* draw composing char on top of a space */
126 len += (*mb_char2bytes)(c, IObuff + len);
127 vim_snprintf((char *)IObuff + len, IOSIZE - len,
128 c < 0x10000 ? _("> %d, Hex %04x, Octal %o")
129 : _("> %d, Hex %08x, Octal %o"), c, c, c);
130 if (ci == MAX_MCO)
131 break;
132 if (enc_utf8)
133 c = cc[ci++];
134 else
135 c = 0;
137 #endif
139 msg(IObuff);
142 #if defined(FEAT_EX_EXTRA) || defined(PROTO)
144 * ":left", ":center" and ":right": align text.
146 void
147 ex_align(eap)
148 exarg_T *eap;
150 pos_T save_curpos;
151 int len;
152 int indent = 0;
153 int new_indent;
154 int has_tab;
155 int width;
157 #ifdef FEAT_RIGHTLEFT
158 if (curwin->w_p_rl)
160 /* switch left and right aligning */
161 if (eap->cmdidx == CMD_right)
162 eap->cmdidx = CMD_left;
163 else if (eap->cmdidx == CMD_left)
164 eap->cmdidx = CMD_right;
166 #endif
168 width = atoi((char *)eap->arg);
169 save_curpos = curwin->w_cursor;
170 if (eap->cmdidx == CMD_left) /* width is used for new indent */
172 if (width >= 0)
173 indent = width;
175 else
178 * if 'textwidth' set, use it
179 * else if 'wrapmargin' set, use it
180 * if invalid value, use 80
182 if (width <= 0)
183 width = curbuf->b_p_tw;
184 if (width == 0 && curbuf->b_p_wm > 0)
185 width = W_WIDTH(curwin) - curbuf->b_p_wm;
186 if (width <= 0)
187 width = 80;
190 if (u_save((linenr_T)(eap->line1 - 1), (linenr_T)(eap->line2 + 1)) == FAIL)
191 return;
193 for (curwin->w_cursor.lnum = eap->line1;
194 curwin->w_cursor.lnum <= eap->line2; ++curwin->w_cursor.lnum)
196 if (eap->cmdidx == CMD_left) /* left align */
197 new_indent = indent;
198 else
200 has_tab = FALSE; /* avoid uninit warnings */
201 len = linelen(eap->cmdidx == CMD_right ? &has_tab
202 : NULL) - get_indent();
204 if (len <= 0) /* skip blank lines */
205 continue;
207 if (eap->cmdidx == CMD_center)
208 new_indent = (width - len) / 2;
209 else
211 new_indent = width - len; /* right align */
214 * Make sure that embedded TABs don't make the text go too far
215 * to the right.
217 if (has_tab)
218 while (new_indent > 0)
220 (void)set_indent(new_indent, 0);
221 if (linelen(NULL) <= width)
224 * Now try to move the line as much as possible to
225 * the right. Stop when it moves too far.
228 (void)set_indent(++new_indent, 0);
229 while (linelen(NULL) <= width);
230 --new_indent;
231 break;
233 --new_indent;
237 if (new_indent < 0)
238 new_indent = 0;
239 (void)set_indent(new_indent, 0); /* set indent */
241 changed_lines(eap->line1, 0, eap->line2 + 1, 0L);
242 curwin->w_cursor = save_curpos;
243 beginline(BL_WHITE | BL_FIX);
247 * Get the length of the current line, excluding trailing white space.
249 static int
250 linelen(has_tab)
251 int *has_tab;
253 char_u *line;
254 char_u *first;
255 char_u *last;
256 int save;
257 int len;
259 /* find the first non-blank character */
260 line = ml_get_curline();
261 first = skipwhite(line);
263 /* find the character after the last non-blank character */
264 for (last = first + STRLEN(first);
265 last > first && vim_iswhite(last[-1]); --last)
267 save = *last;
268 *last = NUL;
269 len = linetabsize(line); /* get line length */
270 if (has_tab != NULL) /* check for embedded TAB */
271 *has_tab = (vim_strrchr(first, TAB) != NULL);
272 *last = save;
274 return len;
277 /* Buffer for two lines used during sorting. They are allocated to
278 * contain the longest line being sorted. */
279 static char_u *sortbuf1;
280 static char_u *sortbuf2;
282 static int sort_ic; /* ignore case */
283 static int sort_nr; /* sort on number */
284 static int sort_rx; /* sort on regex instead of skipping it */
286 static int sort_abort; /* flag to indicate if sorting has been interrupted */
288 /* Struct to store info to be sorted. */
289 typedef struct
291 linenr_T lnum; /* line number */
292 long start_col_nr; /* starting column number or number */
293 long end_col_nr; /* ending column number */
294 } sorti_T;
296 static int
297 #ifdef __BORLANDC__
298 _RTLENTRYF
299 #endif
300 sort_compare __ARGS((const void *s1, const void *s2));
302 static int
303 #ifdef __BORLANDC__
304 _RTLENTRYF
305 #endif
306 sort_compare(s1, s2)
307 const void *s1;
308 const void *s2;
310 sorti_T l1 = *(sorti_T *)s1;
311 sorti_T l2 = *(sorti_T *)s2;
312 int result = 0;
314 /* If the user interrupts, there's no way to stop qsort() immediately, but
315 * if we return 0 every time, qsort will assume it's done sorting and
316 * exit. */
317 if (sort_abort)
318 return 0;
319 fast_breakcheck();
320 if (got_int)
321 sort_abort = TRUE;
323 /* When sorting numbers "start_col_nr" is the number, not the column
324 * number. */
325 if (sort_nr)
326 result = l1.start_col_nr - l2.start_col_nr;
327 else
329 /* We need to copy one line into "sortbuf1", because there is no
330 * guarantee that the first pointer becomes invalid when obtaining the
331 * second one. */
332 STRNCPY(sortbuf1, ml_get(l1.lnum) + l1.start_col_nr,
333 l1.end_col_nr - l1.start_col_nr + 1);
334 sortbuf1[l1.end_col_nr - l1.start_col_nr] = 0;
335 STRNCPY(sortbuf2, ml_get(l2.lnum) + l2.start_col_nr,
336 l2.end_col_nr - l2.start_col_nr + 1);
337 sortbuf2[l2.end_col_nr - l2.start_col_nr] = 0;
339 result = sort_ic ? STRICMP(sortbuf1, sortbuf2)
340 : STRCMP(sortbuf1, sortbuf2);
343 /* If two lines have the same value, preserve the original line order. */
344 if (result == 0)
345 return (int)(l1.lnum - l2.lnum);
346 return result;
350 * ":sort".
352 void
353 ex_sort(eap)
354 exarg_T *eap;
356 regmatch_T regmatch;
357 int len;
358 linenr_T lnum;
359 long maxlen = 0;
360 sorti_T *nrs;
361 size_t count = (size_t)(eap->line2 - eap->line1 + 1);
362 size_t i;
363 char_u *p;
364 char_u *s;
365 char_u *s2;
366 char_u c; /* temporary character storage */
367 int unique = FALSE;
368 long deleted;
369 colnr_T start_col;
370 colnr_T end_col;
371 int sort_oct; /* sort on octal number */
372 int sort_hex; /* sort on hex number */
374 /* Sorting one line is really quick! */
375 if (count <= 1)
376 return;
378 if (u_save((linenr_T)(eap->line1 - 1), (linenr_T)(eap->line2 + 1)) == FAIL)
379 return;
380 sortbuf1 = NULL;
381 sortbuf2 = NULL;
382 regmatch.regprog = NULL;
383 nrs = (sorti_T *)lalloc((long_u)(count * sizeof(sorti_T)), TRUE);
384 if (nrs == NULL)
385 goto sortend;
387 sort_abort = sort_ic = sort_rx = sort_nr = sort_oct = sort_hex = 0;
389 for (p = eap->arg; *p != NUL; ++p)
391 if (vim_iswhite(*p))
393 else if (*p == 'i')
394 sort_ic = TRUE;
395 else if (*p == 'r')
396 sort_rx = TRUE;
397 else if (*p == 'n')
398 sort_nr = 2;
399 else if (*p == 'o')
400 sort_oct = 2;
401 else if (*p == 'x')
402 sort_hex = 2;
403 else if (*p == 'u')
404 unique = TRUE;
405 else if (*p == '"') /* comment start */
406 break;
407 else if (check_nextcmd(p) != NULL)
409 eap->nextcmd = check_nextcmd(p);
410 break;
412 else if (!ASCII_ISALPHA(*p) && regmatch.regprog == NULL)
414 s = skip_regexp(p + 1, *p, TRUE, NULL);
415 if (*s != *p)
417 EMSG(_(e_invalpat));
418 goto sortend;
420 *s = NUL;
421 /* Use last search pattern if sort pattern is empty. */
422 if (s == p + 1 && last_search_pat() != NULL)
423 regmatch.regprog = vim_regcomp(last_search_pat(), RE_MAGIC);
424 else
425 regmatch.regprog = vim_regcomp(p + 1, RE_MAGIC);
426 if (regmatch.regprog == NULL)
427 goto sortend;
428 p = s; /* continue after the regexp */
429 regmatch.rm_ic = p_ic;
431 else
433 EMSG2(_(e_invarg2), p);
434 goto sortend;
438 /* Can only have one of 'n', 'o' and 'x'. */
439 if (sort_nr + sort_oct + sort_hex > 2)
441 EMSG(_(e_invarg));
442 goto sortend;
445 /* From here on "sort_nr" is used as a flag for any number sorting. */
446 sort_nr += sort_oct + sort_hex;
449 * Make an array with all line numbers. This avoids having to copy all
450 * the lines into allocated memory.
451 * When sorting on strings "start_col_nr" is the offset in the line, for
452 * numbers sorting it's the number to sort on. This means the pattern
453 * matching and number conversion only has to be done once per line.
454 * Also get the longest line length for allocating "sortbuf".
456 for (lnum = eap->line1; lnum <= eap->line2; ++lnum)
458 s = ml_get(lnum);
459 len = (int)STRLEN(s);
460 if (maxlen < len)
461 maxlen = len;
463 start_col = 0;
464 end_col = len;
465 if (regmatch.regprog != NULL && vim_regexec(&regmatch, s, 0))
467 if (sort_rx)
469 start_col = (colnr_T)(regmatch.startp[0] - s);
470 end_col = (colnr_T)(regmatch.endp[0] - s);
472 else
473 start_col = (colnr_T)(regmatch.endp[0] - s);
475 else
476 if (regmatch.regprog != NULL)
477 end_col = 0;
479 if (sort_nr)
481 /* Make sure vim_str2nr doesn't read any digits past the end
482 * of the match, by temporarily terminating the string there */
483 s2 = s + end_col;
484 c = *s2;
485 (*s2) = 0;
486 /* Sorting on number: Store the number itself. */
487 p = s + start_col;
488 if (sort_hex)
489 s = skiptohex(p);
490 else
491 s = skiptodigit(p);
492 if (s > p && s[-1] == '-')
493 --s; /* include preceding negative sign */
494 vim_str2nr(s, NULL, NULL, sort_oct, sort_hex,
495 &nrs[lnum - eap->line1].start_col_nr, NULL);
496 (*s2) = c;
498 else
500 /* Store the column to sort at. */
501 nrs[lnum - eap->line1].start_col_nr = start_col;
502 nrs[lnum - eap->line1].end_col_nr = end_col;
505 nrs[lnum - eap->line1].lnum = lnum;
507 if (regmatch.regprog != NULL)
508 fast_breakcheck();
509 if (got_int)
510 goto sortend;
513 /* Allocate a buffer that can hold the longest line. */
514 sortbuf1 = alloc((unsigned)maxlen + 1);
515 if (sortbuf1 == NULL)
516 goto sortend;
517 sortbuf2 = alloc((unsigned)maxlen + 1);
518 if (sortbuf2 == NULL)
519 goto sortend;
521 /* Sort the array of line numbers. Note: can't be interrupted! */
522 qsort((void *)nrs, count, sizeof(sorti_T), sort_compare);
524 if (sort_abort)
525 goto sortend;
527 /* Insert the lines in the sorted order below the last one. */
528 lnum = eap->line2;
529 for (i = 0; i < count; ++i)
531 s = ml_get(nrs[eap->forceit ? count - i - 1 : i].lnum);
532 if (!unique || i == 0
533 || (sort_ic ? STRICMP(s, sortbuf1) : STRCMP(s, sortbuf1)) != 0)
535 if (ml_append(lnum++, s, (colnr_T)0, FALSE) == FAIL)
536 break;
537 if (unique)
538 STRCPY(sortbuf1, s);
540 fast_breakcheck();
541 if (got_int)
542 goto sortend;
545 /* delete the original lines if appending worked */
546 if (i == count)
547 for (i = 0; i < count; ++i)
548 ml_delete(eap->line1, FALSE);
549 else
550 count = 0;
552 /* Adjust marks for deleted (or added) lines and prepare for displaying. */
553 deleted = (long)(count - (lnum - eap->line2));
554 if (deleted > 0)
555 mark_adjust(eap->line2 - deleted, eap->line2, (long)MAXLNUM, -deleted);
556 else if (deleted < 0)
557 mark_adjust(eap->line2, MAXLNUM, -deleted, 0L);
558 changed_lines(eap->line1, 0, eap->line2 + 1, -deleted);
560 curwin->w_cursor.lnum = eap->line1;
561 beginline(BL_WHITE | BL_FIX);
563 sortend:
564 vim_free(nrs);
565 vim_free(sortbuf1);
566 vim_free(sortbuf2);
567 vim_free(regmatch.regprog);
568 if (got_int)
569 EMSG(_(e_interr));
573 * ":retab".
575 void
576 ex_retab(eap)
577 exarg_T *eap;
579 linenr_T lnum;
580 int got_tab = FALSE;
581 long num_spaces = 0;
582 long num_tabs;
583 long len;
584 long col;
585 long vcol;
586 long start_col = 0; /* For start of white-space string */
587 long start_vcol = 0; /* For start of white-space string */
588 int temp;
589 long old_len;
590 char_u *ptr;
591 char_u *new_line = (char_u *)1; /* init to non-NULL */
592 int did_undo; /* called u_save for current line */
593 int new_ts;
594 int save_list;
595 linenr_T first_line = 0; /* first changed line */
596 linenr_T last_line = 0; /* last changed line */
598 save_list = curwin->w_p_list;
599 curwin->w_p_list = 0; /* don't want list mode here */
601 new_ts = getdigits(&(eap->arg));
602 if (new_ts < 0)
604 EMSG(_(e_positive));
605 return;
607 if (new_ts == 0)
608 new_ts = curbuf->b_p_ts;
609 for (lnum = eap->line1; !got_int && lnum <= eap->line2; ++lnum)
611 ptr = ml_get(lnum);
612 col = 0;
613 vcol = 0;
614 did_undo = FALSE;
615 for (;;)
617 if (vim_iswhite(ptr[col]))
619 if (!got_tab && num_spaces == 0)
621 /* First consecutive white-space */
622 start_vcol = vcol;
623 start_col = col;
625 if (ptr[col] == ' ')
626 num_spaces++;
627 else
628 got_tab = TRUE;
630 else
632 if (got_tab || (eap->forceit && num_spaces > 1))
634 /* Retabulate this string of white-space */
636 /* len is virtual length of white string */
637 len = num_spaces = vcol - start_vcol;
638 num_tabs = 0;
639 if (!curbuf->b_p_et)
641 temp = new_ts - (start_vcol % new_ts);
642 if (num_spaces >= temp)
644 num_spaces -= temp;
645 num_tabs++;
647 num_tabs += num_spaces / new_ts;
648 num_spaces -= (num_spaces / new_ts) * new_ts;
650 if (curbuf->b_p_et || got_tab ||
651 (num_spaces + num_tabs < len))
653 if (did_undo == FALSE)
655 did_undo = TRUE;
656 if (u_save((linenr_T)(lnum - 1),
657 (linenr_T)(lnum + 1)) == FAIL)
659 new_line = NULL; /* flag out-of-memory */
660 break;
664 /* len is actual number of white characters used */
665 len = num_spaces + num_tabs;
666 old_len = (long)STRLEN(ptr);
667 new_line = lalloc(old_len - col + start_col + len + 1,
668 TRUE);
669 if (new_line == NULL)
670 break;
671 if (start_col > 0)
672 mch_memmove(new_line, ptr, (size_t)start_col);
673 mch_memmove(new_line + start_col + len,
674 ptr + col, (size_t)(old_len - col + 1));
675 ptr = new_line + start_col;
676 for (col = 0; col < len; col++)
677 ptr[col] = (col < num_tabs) ? '\t' : ' ';
678 ml_replace(lnum, new_line, FALSE);
679 if (first_line == 0)
680 first_line = lnum;
681 last_line = lnum;
682 ptr = new_line;
683 col = start_col + len;
686 got_tab = FALSE;
687 num_spaces = 0;
689 if (ptr[col] == NUL)
690 break;
691 vcol += chartabsize(ptr + col, (colnr_T)vcol);
692 #ifdef FEAT_MBYTE
693 if (has_mbyte)
694 col += (*mb_ptr2len)(ptr + col);
695 else
696 #endif
697 ++col;
699 if (new_line == NULL) /* out of memory */
700 break;
701 line_breakcheck();
703 if (got_int)
704 EMSG(_(e_interr));
706 if (curbuf->b_p_ts != new_ts)
707 redraw_curbuf_later(NOT_VALID);
708 if (first_line != 0)
709 changed_lines(first_line, 0, last_line + 1, 0L);
711 curwin->w_p_list = save_list; /* restore 'list' */
713 curbuf->b_p_ts = new_ts;
714 coladvance(curwin->w_curswant);
716 u_clearline();
718 #endif
721 * :move command - move lines line1-line2 to line dest
723 * return FAIL for failure, OK otherwise
726 do_move(line1, line2, dest)
727 linenr_T line1;
728 linenr_T line2;
729 linenr_T dest;
731 char_u *str;
732 linenr_T l;
733 linenr_T extra; /* Num lines added before line1 */
734 linenr_T num_lines; /* Num lines moved */
735 linenr_T last_line; /* Last line in file after adding new text */
737 if (dest >= line1 && dest < line2)
739 EMSG(_("E134: Move lines into themselves"));
740 return FAIL;
743 num_lines = line2 - line1 + 1;
746 * First we copy the old text to its new location -- webb
747 * Also copy the flag that ":global" command uses.
749 if (u_save(dest, dest + 1) == FAIL)
750 return FAIL;
751 for (extra = 0, l = line1; l <= line2; l++)
753 str = vim_strsave(ml_get(l + extra));
754 if (str != NULL)
756 ml_append(dest + l - line1, str, (colnr_T)0, FALSE);
757 vim_free(str);
758 if (dest < line1)
759 extra++;
764 * Now we must be careful adjusting our marks so that we don't overlap our
765 * mark_adjust() calls.
767 * We adjust the marks within the old text so that they refer to the
768 * last lines of the file (temporarily), because we know no other marks
769 * will be set there since these line numbers did not exist until we added
770 * our new lines.
772 * Then we adjust the marks on lines between the old and new text positions
773 * (either forwards or backwards).
775 * And Finally we adjust the marks we put at the end of the file back to
776 * their final destination at the new text position -- webb
778 last_line = curbuf->b_ml.ml_line_count;
779 mark_adjust(line1, line2, last_line - line2, 0L);
780 if (dest >= line2)
782 mark_adjust(line2 + 1, dest, -num_lines, 0L);
783 curbuf->b_op_start.lnum = dest - num_lines + 1;
784 curbuf->b_op_end.lnum = dest;
786 else
788 mark_adjust(dest + 1, line1 - 1, num_lines, 0L);
789 curbuf->b_op_start.lnum = dest + 1;
790 curbuf->b_op_end.lnum = dest + num_lines;
792 curbuf->b_op_start.col = curbuf->b_op_end.col = 0;
793 mark_adjust(last_line - num_lines + 1, last_line,
794 -(last_line - dest - extra), 0L);
797 * Now we delete the original text -- webb
799 if (u_save(line1 + extra - 1, line2 + extra + 1) == FAIL)
800 return FAIL;
802 for (l = line1; l <= line2; l++)
803 ml_delete(line1 + extra, TRUE);
805 if (!global_busy && num_lines > p_report)
807 if (num_lines == 1)
808 MSG(_("1 line moved"));
809 else
810 smsg((char_u *)_("%ld lines moved"), num_lines);
814 * Leave the cursor on the last of the moved lines.
816 if (dest >= line1)
817 curwin->w_cursor.lnum = dest;
818 else
819 curwin->w_cursor.lnum = dest + (line2 - line1) + 1;
821 if (line1 < dest)
822 changed_lines(line1, 0, dest + num_lines + 1, 0L);
823 else
824 changed_lines(dest + 1, 0, line1 + num_lines, 0L);
826 return OK;
830 * ":copy"
832 void
833 ex_copy(line1, line2, n)
834 linenr_T line1;
835 linenr_T line2;
836 linenr_T n;
838 linenr_T count;
839 char_u *p;
841 count = line2 - line1 + 1;
842 curbuf->b_op_start.lnum = n + 1;
843 curbuf->b_op_end.lnum = n + count;
844 curbuf->b_op_start.col = curbuf->b_op_end.col = 0;
847 * there are three situations:
848 * 1. destination is above line1
849 * 2. destination is between line1 and line2
850 * 3. destination is below line2
852 * n = destination (when starting)
853 * curwin->w_cursor.lnum = destination (while copying)
854 * line1 = start of source (while copying)
855 * line2 = end of source (while copying)
857 if (u_save(n, n + 1) == FAIL)
858 return;
860 curwin->w_cursor.lnum = n;
861 while (line1 <= line2)
863 /* need to use vim_strsave() because the line will be unlocked within
864 * ml_append() */
865 p = vim_strsave(ml_get(line1));
866 if (p != NULL)
868 ml_append(curwin->w_cursor.lnum, p, (colnr_T)0, FALSE);
869 vim_free(p);
871 /* situation 2: skip already copied lines */
872 if (line1 == n)
873 line1 = curwin->w_cursor.lnum;
874 ++line1;
875 if (curwin->w_cursor.lnum < line1)
876 ++line1;
877 if (curwin->w_cursor.lnum < line2)
878 ++line2;
879 ++curwin->w_cursor.lnum;
882 appended_lines_mark(n, count);
884 msgmore((long)count);
887 static char_u *prevcmd = NULL; /* the previous command */
889 #if defined(EXITFREE) || defined(PROTO)
890 void
891 free_prev_shellcmd()
893 vim_free(prevcmd);
895 #endif
898 * Handle the ":!cmd" command. Also for ":r !cmd" and ":w !cmd"
899 * Bangs in the argument are replaced with the previously entered command.
900 * Remember the argument.
902 * RISCOS: Bangs only replaced when followed by a space, since many
903 * pathnames contain one.
905 void
906 do_bang(addr_count, eap, forceit, do_in, do_out)
907 int addr_count;
908 exarg_T *eap;
909 int forceit;
910 int do_in, do_out;
912 char_u *arg = eap->arg; /* command */
913 linenr_T line1 = eap->line1; /* start of range */
914 linenr_T line2 = eap->line2; /* end of range */
915 char_u *newcmd = NULL; /* the new command */
916 int free_newcmd = FALSE; /* need to free() newcmd */
917 int ins_prevcmd;
918 char_u *t;
919 char_u *p;
920 char_u *trailarg;
921 int len;
922 int scroll_save = msg_scroll;
925 * Disallow shell commands for "rvim".
926 * Disallow shell commands from .exrc and .vimrc in current directory for
927 * security reasons.
929 if (check_restricted() || check_secure())
930 return;
932 if (addr_count == 0) /* :! */
934 msg_scroll = FALSE; /* don't scroll here */
935 autowrite_all();
936 msg_scroll = scroll_save;
940 * Try to find an embedded bang, like in :!<cmd> ! [args]
941 * (:!! is indicated by the 'forceit' variable)
943 ins_prevcmd = forceit;
944 trailarg = arg;
947 len = (int)STRLEN(trailarg) + 1;
948 if (newcmd != NULL)
949 len += (int)STRLEN(newcmd);
950 if (ins_prevcmd)
952 if (prevcmd == NULL)
954 EMSG(_(e_noprev));
955 vim_free(newcmd);
956 return;
958 len += (int)STRLEN(prevcmd);
960 if ((t = alloc((unsigned)len)) == NULL)
962 vim_free(newcmd);
963 return;
965 *t = NUL;
966 if (newcmd != NULL)
967 STRCAT(t, newcmd);
968 if (ins_prevcmd)
969 STRCAT(t, prevcmd);
970 p = t + STRLEN(t);
971 STRCAT(t, trailarg);
972 vim_free(newcmd);
973 newcmd = t;
976 * Scan the rest of the argument for '!', which is replaced by the
977 * previous command. "\!" is replaced by "!" (this is vi compatible).
979 trailarg = NULL;
980 while (*p)
982 if (*p == '!'
983 #ifdef RISCOS
984 && (p[1] == ' ' || p[1] == NUL)
985 #endif
988 if (p > newcmd && p[-1] == '\\')
989 STRMOVE(p - 1, p);
990 else
992 trailarg = p;
993 *trailarg++ = NUL;
994 ins_prevcmd = TRUE;
995 break;
998 ++p;
1000 } while (trailarg != NULL);
1002 vim_free(prevcmd);
1003 prevcmd = newcmd;
1005 if (bangredo) /* put cmd in redo buffer for ! command */
1007 AppendToRedobuffLit(prevcmd, -1);
1008 AppendToRedobuff((char_u *)"\n");
1009 bangredo = FALSE;
1012 * Add quotes around the command, for shells that need them.
1014 if (*p_shq != NUL)
1016 newcmd = alloc((unsigned)(STRLEN(prevcmd) + 2 * STRLEN(p_shq) + 1));
1017 if (newcmd == NULL)
1018 return;
1019 STRCPY(newcmd, p_shq);
1020 STRCAT(newcmd, prevcmd);
1021 STRCAT(newcmd, p_shq);
1022 free_newcmd = TRUE;
1024 if (addr_count == 0) /* :! */
1026 /* echo the command */
1027 msg_start();
1028 msg_putchar(':');
1029 msg_putchar('!');
1030 msg_outtrans(newcmd);
1031 msg_clr_eos();
1032 windgoto(msg_row, msg_col);
1034 do_shell(newcmd, 0);
1036 else /* :range! */
1038 /* Careful: This may recursively call do_bang() again! (because of
1039 * autocommands) */
1040 do_filter(line1, line2, eap, newcmd, do_in, do_out);
1041 #ifdef FEAT_AUTOCMD
1042 apply_autocmds(EVENT_SHELLFILTERPOST, NULL, NULL, FALSE, curbuf);
1043 #endif
1045 if (free_newcmd)
1046 vim_free(newcmd);
1050 * do_filter: filter lines through a command given by the user
1052 * We mostly use temp files and the call_shell() routine here. This would
1053 * normally be done using pipes on a UNIX machine, but this is more portable
1054 * to non-unix machines. The call_shell() routine needs to be able
1055 * to deal with redirection somehow, and should handle things like looking
1056 * at the PATH env. variable, and adding reasonable extensions to the
1057 * command name given by the user. All reasonable versions of call_shell()
1058 * do this.
1059 * Alternatively, if on Unix and redirecting input or output, but not both,
1060 * and the 'shelltemp' option isn't set, use pipes.
1061 * We use input redirection if do_in is TRUE.
1062 * We use output redirection if do_out is TRUE.
1064 static void
1065 do_filter(line1, line2, eap, cmd, do_in, do_out)
1066 linenr_T line1, line2;
1067 exarg_T *eap; /* for forced 'ff' and 'fenc' */
1068 char_u *cmd;
1069 int do_in, do_out;
1071 char_u *itmp = NULL;
1072 char_u *otmp = NULL;
1073 linenr_T linecount;
1074 linenr_T read_linecount;
1075 pos_T cursor_save;
1076 char_u *cmd_buf;
1077 #ifdef FEAT_AUTOCMD
1078 buf_T *old_curbuf = curbuf;
1079 #endif
1080 int shell_flags = 0;
1082 if (*cmd == NUL) /* no filter command */
1083 return;
1085 #ifdef WIN3264
1087 * Check if external commands are allowed now.
1089 if (can_end_termcap_mode(TRUE) == FALSE)
1090 return;
1091 #endif
1093 cursor_save = curwin->w_cursor;
1094 linecount = line2 - line1 + 1;
1095 curwin->w_cursor.lnum = line1;
1096 curwin->w_cursor.col = 0;
1097 changed_line_abv_curs();
1098 invalidate_botline();
1101 * When using temp files:
1102 * 1. * Form temp file names
1103 * 2. * Write the lines to a temp file
1104 * 3. Run the filter command on the temp file
1105 * 4. * Read the output of the command into the buffer
1106 * 5. * Delete the original lines to be filtered
1107 * 6. * Remove the temp files
1109 * When writing the input with a pipe or when catching the output with a
1110 * pipe only need to do 3.
1113 if (do_out)
1114 shell_flags |= SHELL_DOOUT;
1116 #if !defined(USE_SYSTEM) && defined(UNIX)
1117 if (!do_in && do_out && !p_stmp)
1119 /* Use a pipe to fetch stdout of the command, do not use a temp file. */
1120 shell_flags |= SHELL_READ;
1121 curwin->w_cursor.lnum = line2;
1123 else if (do_in && !do_out && !p_stmp)
1125 /* Use a pipe to write stdin of the command, do not use a temp file. */
1126 shell_flags |= SHELL_WRITE;
1127 curbuf->b_op_start.lnum = line1;
1128 curbuf->b_op_end.lnum = line2;
1130 else if (do_in && do_out && !p_stmp)
1132 /* Use a pipe to write stdin and fetch stdout of the command, do not
1133 * use a temp file. */
1134 shell_flags |= SHELL_READ|SHELL_WRITE;
1135 curbuf->b_op_start.lnum = line1;
1136 curbuf->b_op_end.lnum = line2;
1137 curwin->w_cursor.lnum = line2;
1139 else
1140 #endif
1141 if ((do_in && (itmp = vim_tempname('i')) == NULL)
1142 || (do_out && (otmp = vim_tempname('o')) == NULL))
1144 EMSG(_(e_notmp));
1145 goto filterend;
1149 * The writing and reading of temp files will not be shown.
1150 * Vi also doesn't do this and the messages are not very informative.
1152 ++no_wait_return; /* don't call wait_return() while busy */
1153 if (itmp != NULL && buf_write(curbuf, itmp, NULL, line1, line2, eap,
1154 FALSE, FALSE, FALSE, TRUE) == FAIL)
1156 msg_putchar('\n'); /* keep message from buf_write() */
1157 --no_wait_return;
1158 #if defined(FEAT_AUTOCMD) && defined(FEAT_EVAL)
1159 if (!aborting())
1160 #endif
1161 (void)EMSG2(_(e_notcreate), itmp); /* will call wait_return */
1162 goto filterend;
1164 #ifdef FEAT_AUTOCMD
1165 if (curbuf != old_curbuf)
1166 goto filterend;
1167 #endif
1169 if (!do_out)
1170 msg_putchar('\n');
1172 /* Create the shell command in allocated memory. */
1173 cmd_buf = make_filter_cmd(cmd, itmp, otmp);
1174 if (cmd_buf == NULL)
1175 goto filterend;
1177 windgoto((int)Rows - 1, 0);
1178 cursor_on();
1181 * When not redirecting the output the command can write anything to the
1182 * screen. If 'shellredir' is equal to ">", screen may be messed up by
1183 * stderr output of external command. Clear the screen later.
1184 * If do_in is FALSE, this could be something like ":r !cat", which may
1185 * also mess up the screen, clear it later.
1187 if (!do_out || STRCMP(p_srr, ">") == 0 || !do_in)
1188 redraw_later_clear();
1190 if (do_out)
1192 if (u_save((linenr_T)(line2), (linenr_T)(line2 + 1)) == FAIL)
1194 vim_free(cmd_buf);
1195 goto error;
1197 redraw_curbuf_later(VALID);
1199 read_linecount = curbuf->b_ml.ml_line_count;
1202 * When call_shell() fails wait_return() is called to give the user a
1203 * chance to read the error messages. Otherwise errors are ignored, so you
1204 * can see the error messages from the command that appear on stdout; use
1205 * 'u' to fix the text
1206 * Switch to cooked mode when not redirecting stdin, avoids that something
1207 * like ":r !cat" hangs.
1208 * Pass on the SHELL_DOOUT flag when the output is being redirected.
1210 if (call_shell(cmd_buf, SHELL_FILTER | SHELL_COOKED | shell_flags))
1212 redraw_later_clear();
1213 wait_return(FALSE);
1215 vim_free(cmd_buf);
1217 did_check_timestamps = FALSE;
1218 need_check_timestamps = TRUE;
1220 /* When interrupting the shell command, it may still have produced some
1221 * useful output. Reset got_int here, so that readfile() won't cancel
1222 * reading. */
1223 ui_breakcheck();
1224 got_int = FALSE;
1226 if (do_out)
1228 if (otmp != NULL)
1230 if (readfile(otmp, NULL, line2, (linenr_T)0, (linenr_T)MAXLNUM,
1231 eap, READ_FILTER) == FAIL)
1233 #if defined(FEAT_AUTOCMD) && defined(FEAT_EVAL)
1234 if (!aborting())
1235 #endif
1237 msg_putchar('\n');
1238 EMSG2(_(e_notread), otmp);
1240 goto error;
1242 #ifdef FEAT_AUTOCMD
1243 if (curbuf != old_curbuf)
1244 goto filterend;
1245 #endif
1248 read_linecount = curbuf->b_ml.ml_line_count - read_linecount;
1250 if (shell_flags & SHELL_READ)
1252 curbuf->b_op_start.lnum = line2 + 1;
1253 curbuf->b_op_end.lnum = curwin->w_cursor.lnum;
1254 appended_lines_mark(line2, read_linecount);
1257 if (do_in)
1259 if (cmdmod.keepmarks || vim_strchr(p_cpo, CPO_REMMARK) == NULL)
1261 if (read_linecount >= linecount)
1262 /* move all marks from old lines to new lines */
1263 mark_adjust(line1, line2, linecount, 0L);
1264 else
1266 /* move marks from old lines to new lines, delete marks
1267 * that are in deleted lines */
1268 mark_adjust(line1, line1 + read_linecount - 1,
1269 linecount, 0L);
1270 mark_adjust(line1 + read_linecount, line2, MAXLNUM, 0L);
1275 * Put cursor on first filtered line for ":range!cmd".
1276 * Adjust '[ and '] (set by buf_write()).
1278 curwin->w_cursor.lnum = line1;
1279 del_lines(linecount, TRUE);
1280 curbuf->b_op_start.lnum -= linecount; /* adjust '[ */
1281 curbuf->b_op_end.lnum -= linecount; /* adjust '] */
1282 write_lnum_adjust(-linecount); /* adjust last line
1283 for next write */
1284 #ifdef FEAT_FOLDING
1285 foldUpdate(curwin, curbuf->b_op_start.lnum, curbuf->b_op_end.lnum);
1286 #endif
1288 else
1291 * Put cursor on last new line for ":r !cmd".
1293 linecount = curbuf->b_op_end.lnum - curbuf->b_op_start.lnum + 1;
1294 curwin->w_cursor.lnum = curbuf->b_op_end.lnum;
1297 beginline(BL_WHITE | BL_FIX); /* cursor on first non-blank */
1298 --no_wait_return;
1300 if (linecount > p_report)
1302 if (do_in)
1304 vim_snprintf((char *)msg_buf, sizeof(msg_buf),
1305 _("%ld lines filtered"), (long)linecount);
1306 if (msg(msg_buf) && !msg_scroll)
1307 /* save message to display it after redraw */
1308 set_keep_msg(msg_buf, 0);
1310 else
1311 msgmore((long)linecount);
1314 else
1316 error:
1317 /* put cursor back in same position for ":w !cmd" */
1318 curwin->w_cursor = cursor_save;
1319 --no_wait_return;
1320 wait_return(FALSE);
1323 filterend:
1325 #ifdef FEAT_AUTOCMD
1326 if (curbuf != old_curbuf)
1328 --no_wait_return;
1329 EMSG(_("E135: *Filter* Autocommands must not change current buffer"));
1331 #endif
1332 if (itmp != NULL)
1333 mch_remove(itmp);
1334 if (otmp != NULL)
1335 mch_remove(otmp);
1336 vim_free(itmp);
1337 vim_free(otmp);
1341 * Call a shell to execute a command.
1342 * When "cmd" is NULL start an interactive shell.
1344 void
1345 do_shell(cmd, flags)
1346 char_u *cmd;
1347 int flags; /* may be SHELL_DOOUT when output is redirected */
1349 buf_T *buf;
1350 #ifndef FEAT_GUI_MSWIN
1351 int save_nwr;
1352 #endif
1353 #ifdef MSWIN
1354 int winstart = FALSE;
1355 #endif
1358 * Disallow shell commands for "rvim".
1359 * Disallow shell commands from .exrc and .vimrc in current directory for
1360 * security reasons.
1362 if (check_restricted() || check_secure())
1364 msg_end();
1365 return;
1368 #ifdef MSWIN
1370 * Check if external commands are allowed now.
1372 if (can_end_termcap_mode(TRUE) == FALSE)
1373 return;
1376 * Check if ":!start" is used.
1378 if (cmd != NULL)
1379 winstart = (STRNICMP(cmd, "start ", 6) == 0);
1380 #endif
1383 * For autocommands we want to get the output on the current screen, to
1384 * avoid having to type return below.
1386 msg_putchar('\r'); /* put cursor at start of line */
1387 #ifdef FEAT_AUTOCMD
1388 if (!autocmd_busy)
1389 #endif
1391 #ifdef MSWIN
1392 if (!winstart)
1393 #endif
1394 stoptermcap();
1396 #ifdef MSWIN
1397 if (!winstart)
1398 #endif
1399 msg_putchar('\n'); /* may shift screen one line up */
1401 /* warning message before calling the shell */
1402 if (p_warn
1403 #ifdef FEAT_AUTOCMD
1404 && !autocmd_busy
1405 #endif
1406 && msg_silent == 0)
1407 for (buf = firstbuf; buf; buf = buf->b_next)
1408 if (bufIsChanged(buf))
1410 #ifdef FEAT_GUI_MSWIN
1411 if (!winstart)
1412 starttermcap(); /* don't want a message box here */
1413 #endif
1414 MSG_PUTS(_("[No write since last change]\n"));
1415 #ifdef FEAT_GUI_MSWIN
1416 if (!winstart)
1417 stoptermcap();
1418 #endif
1419 break;
1422 /* This windgoto is required for when the '\n' resulted in a "delete line
1423 * 1" command to the terminal. */
1424 if (!swapping_screen())
1425 windgoto(msg_row, msg_col);
1426 cursor_on();
1427 (void)call_shell(cmd, SHELL_COOKED | flags);
1428 did_check_timestamps = FALSE;
1429 need_check_timestamps = TRUE;
1432 * put the message cursor at the end of the screen, avoids wait_return()
1433 * to overwrite the text that the external command showed
1435 if (!swapping_screen())
1437 msg_row = Rows - 1;
1438 msg_col = 0;
1441 #ifdef FEAT_AUTOCMD
1442 if (autocmd_busy)
1444 if (msg_silent == 0)
1445 redraw_later_clear();
1447 else
1448 #endif
1451 * For ":sh" there is no need to call wait_return(), just redraw.
1452 * Also for the Win32 GUI (the output is in a console window).
1453 * Otherwise there is probably text on the screen that the user wants
1454 * to read before redrawing, so call wait_return().
1456 #ifndef FEAT_GUI_MSWIN
1457 if (cmd == NULL
1458 # ifdef WIN3264
1459 || (winstart && !need_wait_return)
1460 # endif
1463 if (msg_silent == 0)
1464 redraw_later_clear();
1465 need_wait_return = FALSE;
1467 else
1470 * If we switch screens when starttermcap() is called, we really
1471 * want to wait for "hit return to continue".
1473 save_nwr = no_wait_return;
1474 if (swapping_screen())
1475 no_wait_return = FALSE;
1476 # ifdef AMIGA
1477 wait_return(term_console ? -1 : msg_silent == 0); /* see below */
1478 # else
1479 wait_return(msg_silent == 0);
1480 # endif
1481 no_wait_return = save_nwr;
1483 #endif /* FEAT_GUI_W32 */
1485 #ifdef MSWIN
1486 if (!winstart) /* if winstart==TRUE, never stopped termcap! */
1487 #endif
1488 starttermcap(); /* start termcap if not done by wait_return() */
1491 * In an Amiga window redrawing is caused by asking the window size.
1492 * If we got an interrupt this will not work. The chance that the
1493 * window size is wrong is very small, but we need to redraw the
1494 * screen. Don't do this if ':' hit in wait_return(). THIS IS UGLY
1495 * but it saves an extra redraw.
1497 #ifdef AMIGA
1498 if (skip_redraw) /* ':' hit in wait_return() */
1500 if (msg_silent == 0)
1501 redraw_later_clear();
1503 else if (term_console)
1505 OUT_STR(IF_EB("\033[0 q", ESC_STR "[0 q")); /* get window size */
1506 if (got_int && msg_silent == 0)
1507 redraw_later_clear(); /* if got_int is TRUE, redraw needed */
1508 else
1509 must_redraw = 0; /* no extra redraw needed */
1511 #endif
1514 /* display any error messages now */
1515 display_errors();
1517 #ifdef FEAT_AUTOCMD
1518 apply_autocmds(EVENT_SHELLCMDPOST, NULL, NULL, FALSE, curbuf);
1519 #endif
1523 * Create a shell command from a command string, input redirection file and
1524 * output redirection file.
1525 * Returns an allocated string with the shell command, or NULL for failure.
1527 char_u *
1528 make_filter_cmd(cmd, itmp, otmp)
1529 char_u *cmd; /* command */
1530 char_u *itmp; /* NULL or name of input file */
1531 char_u *otmp; /* NULL or name of output file */
1533 char_u *buf;
1534 long_u len;
1536 len = (long_u)STRLEN(cmd) + 3; /* "()" + NUL */
1537 if (itmp != NULL)
1538 len += (long_u)STRLEN(itmp) + 9; /* " { < " + " } " */
1539 if (otmp != NULL)
1540 len += (long_u)STRLEN(otmp) + (long_u)STRLEN(p_srr) + 2; /* " " */
1541 buf = lalloc(len, TRUE);
1542 if (buf == NULL)
1543 return NULL;
1545 #if (defined(UNIX) && !defined(ARCHIE)) || defined(OS2)
1547 * Put braces around the command (for concatenated commands) when
1548 * redirecting input and/or output.
1550 if (itmp != NULL || otmp != NULL)
1551 vim_snprintf((char *)buf, len, "(%s)", (char *)cmd);
1552 else
1553 STRCPY(buf, cmd);
1554 if (itmp != NULL)
1556 STRCAT(buf, " < ");
1557 STRCAT(buf, itmp);
1559 #else
1561 * for shells that don't understand braces around commands, at least allow
1562 * the use of commands in a pipe.
1564 STRCPY(buf, cmd);
1565 if (itmp != NULL)
1567 char_u *p;
1570 * If there is a pipe, we have to put the '<' in front of it.
1571 * Don't do this when 'shellquote' is not empty, otherwise the
1572 * redirection would be inside the quotes.
1574 if (*p_shq == NUL)
1576 p = vim_strchr(buf, '|');
1577 if (p != NULL)
1578 *p = NUL;
1580 # ifdef RISCOS
1581 STRCAT(buf, " { < "); /* Use RISC OS notation for input. */
1582 STRCAT(buf, itmp);
1583 STRCAT(buf, " } ");
1584 # else
1585 STRCAT(buf, " <"); /* " < " causes problems on Amiga */
1586 STRCAT(buf, itmp);
1587 # endif
1588 if (*p_shq == NUL)
1590 p = vim_strchr(cmd, '|');
1591 if (p != NULL)
1593 STRCAT(buf, " "); /* insert a space before the '|' for DOS */
1594 STRCAT(buf, p);
1598 #endif
1599 if (otmp != NULL)
1600 append_redir(buf, (int)len, p_srr, otmp);
1602 return buf;
1606 * Append output redirection for file "fname" to the end of string buffer
1607 * "buf[buflen]"
1608 * Works with the 'shellredir' and 'shellpipe' options.
1609 * The caller should make sure that there is enough room:
1610 * STRLEN(opt) + STRLEN(fname) + 3
1612 void
1613 append_redir(buf, buflen, opt, fname)
1614 char_u *buf;
1615 int buflen;
1616 char_u *opt;
1617 char_u *fname;
1619 char_u *p;
1620 char_u *end;
1622 end = buf + STRLEN(buf);
1623 /* find "%s", skipping "%%" */
1624 for (p = opt; (p = vim_strchr(p, '%')) != NULL; ++p)
1625 if (p[1] == 's')
1626 break;
1627 if (p != NULL)
1629 *end = ' '; /* not really needed? Not with sh, ksh or bash */
1630 vim_snprintf((char *)end + 1, (size_t)(buflen - (end + 1 - buf)),
1631 (char *)opt, (char *)fname);
1633 else
1634 vim_snprintf((char *)end, (size_t)(buflen - (end - buf)),
1635 #ifdef FEAT_QUICKFIX
1636 # ifndef RISCOS
1637 opt != p_sp ? " %s%s" :
1638 # endif
1639 " %s %s",
1640 #else
1641 # ifndef RISCOS
1642 " %s%s", /* " > %s" causes problems on Amiga */
1643 # else
1644 " %s %s", /* But is needed for 'shellpipe' and RISC OS */
1645 # endif
1646 #endif
1647 (char *)opt, (char *)fname);
1650 #ifdef FEAT_VIMINFO
1652 static int no_viminfo __ARGS((void));
1653 static int viminfo_errcnt;
1655 static int
1656 no_viminfo()
1658 /* "vim -i NONE" does not read or write a viminfo file */
1659 return (use_viminfo != NULL && STRCMP(use_viminfo, "NONE") == 0);
1663 * Report an error for reading a viminfo file.
1664 * Count the number of errors. When there are more than 10, return TRUE.
1667 viminfo_error(errnum, message, line)
1668 char *errnum;
1669 char *message;
1670 char_u *line;
1672 vim_snprintf((char *)IObuff, IOSIZE, _("%sviminfo: %s in line: "),
1673 errnum, message);
1674 STRNCAT(IObuff, line, IOSIZE - STRLEN(IObuff) - 1);
1675 if (IObuff[STRLEN(IObuff) - 1] == '\n')
1676 IObuff[STRLEN(IObuff) - 1] = NUL;
1677 emsg(IObuff);
1678 if (++viminfo_errcnt >= 10)
1680 EMSG(_("E136: viminfo: Too many errors, skipping rest of file"));
1681 return TRUE;
1683 return FALSE;
1687 * read_viminfo() -- Read the viminfo file. Registers etc. which are already
1688 * set are not over-written unless "flags" includes VIF_FORCEIT. -- webb
1691 read_viminfo(file, flags)
1692 char_u *file; /* file name or NULL to use default name */
1693 int flags; /* VIF_WANT_INFO et al. */
1695 FILE *fp;
1696 char_u *fname;
1698 if (no_viminfo())
1699 return FAIL;
1701 fname = viminfo_filename(file); /* get file name in allocated buffer */
1702 if (fname == NULL)
1703 return FAIL;
1704 fp = mch_fopen((char *)fname, READBIN);
1706 if (p_verbose > 0)
1708 verbose_enter();
1709 smsg((char_u *)_("Reading viminfo file \"%s\"%s%s%s"),
1710 fname,
1711 (flags & VIF_WANT_INFO) ? _(" info") : "",
1712 (flags & VIF_WANT_MARKS) ? _(" marks") : "",
1713 (flags & VIF_GET_OLDFILES) ? _(" oldfiles") : "",
1714 fp == NULL ? _(" FAILED") : "");
1715 verbose_leave();
1718 vim_free(fname);
1719 if (fp == NULL)
1720 return FAIL;
1722 viminfo_errcnt = 0;
1723 do_viminfo(fp, NULL, flags);
1725 fclose(fp);
1726 return OK;
1730 * write_viminfo() -- Write the viminfo file. The old one is read in first so
1731 * that effectively a merge of current info and old info is done. This allows
1732 * multiple vims to run simultaneously, without losing any marks etc. If
1733 * forceit is TRUE, then the old file is not read in, and only internal info is
1734 * written to the file. -- webb
1736 void
1737 write_viminfo(file, forceit)
1738 char_u *file;
1739 int forceit;
1741 char_u *fname;
1742 FILE *fp_in = NULL; /* input viminfo file, if any */
1743 FILE *fp_out = NULL; /* output viminfo file */
1744 char_u *tempname = NULL; /* name of temp viminfo file */
1745 struct stat st_new; /* mch_stat() of potential new file */
1746 char_u *wp;
1747 #if defined(UNIX) || defined(VMS)
1748 mode_t umask_save;
1749 #endif
1750 #ifdef UNIX
1751 int shortname = FALSE; /* use 8.3 file name */
1752 struct stat st_old; /* mch_stat() of existing viminfo file */
1753 #endif
1754 #ifdef WIN3264
1755 long perm = -1;
1756 #endif
1758 if (no_viminfo())
1759 return;
1761 fname = viminfo_filename(file); /* may set to default if NULL */
1762 if (fname == NULL)
1763 return;
1765 fp_in = mch_fopen((char *)fname, READBIN);
1766 if (fp_in == NULL)
1768 /* if it does exist, but we can't read it, don't try writing */
1769 if (mch_stat((char *)fname, &st_new) == 0)
1770 goto end;
1771 #if defined(UNIX) || defined(VMS)
1773 * For Unix we create the .viminfo non-accessible for others,
1774 * because it may contain text from non-accessible documents.
1776 umask_save = umask(077);
1777 #endif
1778 fp_out = mch_fopen((char *)fname, WRITEBIN);
1779 #if defined(UNIX) || defined(VMS)
1780 (void)umask(umask_save);
1781 #endif
1783 else
1786 * There is an existing viminfo file. Create a temporary file to
1787 * write the new viminfo into, in the same directory as the
1788 * existing viminfo file, which will be renamed later.
1790 #ifdef UNIX
1792 * For Unix we check the owner of the file. It's not very nice to
1793 * overwrite a user's viminfo file after a "su root", with a
1794 * viminfo file that the user can't read.
1796 st_old.st_dev = (dev_t)0;
1797 st_old.st_ino = 0;
1798 st_old.st_mode = 0600;
1799 if (mch_stat((char *)fname, &st_old) == 0
1800 && getuid() != ROOT_UID
1801 && !(st_old.st_uid == getuid()
1802 ? (st_old.st_mode & 0200)
1803 : (st_old.st_gid == getgid()
1804 ? (st_old.st_mode & 0020)
1805 : (st_old.st_mode & 0002))))
1807 int tt = msg_didany;
1809 /* avoid a wait_return for this message, it's annoying */
1810 EMSG2(_("E137: Viminfo file is not writable: %s"), fname);
1811 msg_didany = tt;
1812 fclose(fp_in);
1813 goto end;
1815 #endif
1816 #ifdef WIN3264
1817 /* Get the file attributes of the existing viminfo file. */
1818 perm = mch_getperm(fname);
1819 #endif
1822 * Make tempname.
1823 * May try twice: Once normal and once with shortname set, just in
1824 * case somebody puts his viminfo file in an 8.3 filesystem.
1826 for (;;)
1828 tempname = buf_modname(
1829 #ifdef UNIX
1830 shortname,
1831 #else
1832 # ifdef SHORT_FNAME
1833 TRUE,
1834 # else
1835 # ifdef FEAT_GUI_W32
1836 gui_is_win32s(),
1837 # else
1838 FALSE,
1839 # endif
1840 # endif
1841 #endif
1842 fname,
1843 #ifdef VMS
1844 (char_u *)"-tmp",
1845 #else
1846 # ifdef RISCOS
1847 (char_u *)"/tmp",
1848 # else
1849 (char_u *)".tmp",
1850 # endif
1851 #endif
1852 FALSE);
1853 if (tempname == NULL) /* out of memory */
1854 break;
1857 * Check if tempfile already exists. Never overwrite an
1858 * existing file!
1860 if (mch_stat((char *)tempname, &st_new) == 0)
1862 #ifdef UNIX
1864 * Check if tempfile is same as original file. May happen
1865 * when modname() gave the same file back. E.g. silly
1866 * link, or file name-length reached. Try again with
1867 * shortname set.
1869 if (!shortname && st_new.st_dev == st_old.st_dev
1870 && st_new.st_ino == st_old.st_ino)
1872 vim_free(tempname);
1873 tempname = NULL;
1874 shortname = TRUE;
1875 continue;
1877 #endif
1879 * Try another name. Change one character, just before
1880 * the extension. This should also work for an 8.3
1881 * file name, when after adding the extension it still is
1882 * the same file as the original.
1884 wp = tempname + STRLEN(tempname) - 5;
1885 if (wp < gettail(tempname)) /* empty file name? */
1886 wp = gettail(tempname);
1887 for (*wp = 'z'; mch_stat((char *)tempname, &st_new) == 0;
1888 --*wp)
1891 * They all exist? Must be something wrong! Don't
1892 * write the viminfo file then.
1894 if (*wp == 'a')
1896 vim_free(tempname);
1897 tempname = NULL;
1898 break;
1902 break;
1905 if (tempname != NULL)
1907 #ifdef VMS
1908 /* fdopen() fails for some reason */
1909 umask_save = umask(077);
1910 fp_out = mch_fopen((char *)tempname, WRITEBIN);
1911 (void)umask(umask_save);
1912 #else
1913 int fd;
1915 /* Use mch_open() to be able to use O_NOFOLLOW and set file
1916 * protection:
1917 * Unix: same as original file, but strip s-bit. Reset umask to
1918 * avoid it getting in the way.
1919 * Others: r&w for user only. */
1920 # ifdef UNIX
1921 umask_save = umask(0);
1922 fd = mch_open((char *)tempname,
1923 O_CREAT|O_EXTRA|O_EXCL|O_WRONLY|O_NOFOLLOW,
1924 (int)((st_old.st_mode & 0777) | 0600));
1925 (void)umask(umask_save);
1926 # else
1927 fd = mch_open((char *)tempname,
1928 O_CREAT|O_EXTRA|O_EXCL|O_WRONLY|O_NOFOLLOW, 0600);
1929 # endif
1930 if (fd < 0)
1931 fp_out = NULL;
1932 else
1933 fp_out = fdopen(fd, WRITEBIN);
1934 #endif /* VMS */
1937 * If we can't create in the same directory, try creating a
1938 * "normal" temp file.
1940 if (fp_out == NULL)
1942 vim_free(tempname);
1943 if ((tempname = vim_tempname('o')) != NULL)
1944 fp_out = mch_fopen((char *)tempname, WRITEBIN);
1947 #if defined(UNIX) && defined(HAVE_FCHOWN)
1949 * Make sure the owner can read/write it. This only works for
1950 * root.
1952 if (fp_out != NULL)
1953 ignored = fchown(fileno(fp_out), st_old.st_uid, st_old.st_gid);
1954 #endif
1959 * Check if the new viminfo file can be written to.
1961 if (fp_out == NULL)
1963 EMSG2(_("E138: Can't write viminfo file %s!"),
1964 (fp_in == NULL || tempname == NULL) ? fname : tempname);
1965 if (fp_in != NULL)
1966 fclose(fp_in);
1967 goto end;
1970 if (p_verbose > 0)
1972 verbose_enter();
1973 smsg((char_u *)_("Writing viminfo file \"%s\""), fname);
1974 verbose_leave();
1977 viminfo_errcnt = 0;
1978 do_viminfo(fp_in, fp_out, forceit ? 0 : (VIF_WANT_INFO | VIF_WANT_MARKS));
1980 fclose(fp_out); /* errors are ignored !? */
1981 if (fp_in != NULL)
1983 fclose(fp_in);
1986 * In case of an error keep the original viminfo file.
1987 * Otherwise rename the newly written file.
1989 if (viminfo_errcnt || vim_rename(tempname, fname) == -1)
1990 mch_remove(tempname);
1992 #ifdef WIN3264
1993 /* If the viminfo file was hidden then also hide the new file. */
1994 if (perm > 0 && (perm & FILE_ATTRIBUTE_HIDDEN))
1995 mch_hide(fname);
1996 #endif
1999 end:
2000 vim_free(fname);
2001 vim_free(tempname);
2005 * Get the viminfo file name to use.
2006 * If "file" is given and not empty, use it (has already been expanded by
2007 * cmdline functions).
2008 * Otherwise use "-i file_name", value from 'viminfo' or the default, and
2009 * expand environment variables.
2010 * Returns an allocated string. NULL when out of memory.
2012 static char_u *
2013 viminfo_filename(file)
2014 char_u *file;
2016 if (file == NULL || *file == NUL)
2018 if (use_viminfo != NULL)
2019 file = use_viminfo;
2020 else if ((file = find_viminfo_parameter('n')) == NULL || *file == NUL)
2022 #ifdef VIMINFO_FILE2
2023 /* don't use $HOME when not defined (turned into "c:/"!). */
2024 # ifdef VMS
2025 if (mch_getenv((char_u *)"SYS$LOGIN") == NULL)
2026 # else
2027 if (mch_getenv((char_u *)"HOME") == NULL)
2028 # endif
2030 /* don't use $VIM when not available. */
2031 expand_env((char_u *)"$VIM", NameBuff, MAXPATHL);
2032 if (STRCMP("$VIM", NameBuff) != 0) /* $VIM was expanded */
2033 file = (char_u *)VIMINFO_FILE2;
2034 else
2035 file = (char_u *)VIMINFO_FILE;
2037 else
2038 #endif
2039 file = (char_u *)VIMINFO_FILE;
2041 expand_env(file, NameBuff, MAXPATHL);
2042 file = NameBuff;
2044 return vim_strsave(file);
2048 * do_viminfo() -- Should only be called from read_viminfo() & write_viminfo().
2050 static void
2051 do_viminfo(fp_in, fp_out, flags)
2052 FILE *fp_in;
2053 FILE *fp_out;
2054 int flags;
2056 int count = 0;
2057 int eof = FALSE;
2058 vir_T vir;
2060 if ((vir.vir_line = alloc(LSIZE)) == NULL)
2061 return;
2062 vir.vir_fd = fp_in;
2063 #ifdef FEAT_MBYTE
2064 vir.vir_conv.vc_type = CONV_NONE;
2065 #endif
2067 if (fp_in != NULL)
2069 if (flags & VIF_WANT_INFO)
2070 eof = read_viminfo_up_to_marks(&vir,
2071 flags & VIF_FORCEIT, fp_out != NULL);
2072 else
2073 /* Skip info, find start of marks */
2074 while (!(eof = viminfo_readline(&vir))
2075 && vir.vir_line[0] != '>')
2078 if (fp_out != NULL)
2080 /* Write the info: */
2081 fprintf(fp_out, _("# This viminfo file was generated by Vim %s.\n"),
2082 VIM_VERSION_MEDIUM);
2083 fprintf(fp_out, _("# You may edit it if you're careful!\n\n"));
2084 #ifdef FEAT_MBYTE
2085 fprintf(fp_out, _("# Value of 'encoding' when this file was written\n"));
2086 fprintf(fp_out, "*encoding=%s\n\n", p_enc);
2087 #endif
2088 write_viminfo_search_pattern(fp_out);
2089 write_viminfo_sub_string(fp_out);
2090 #ifdef FEAT_CMDHIST
2091 write_viminfo_history(fp_out);
2092 #endif
2093 write_viminfo_registers(fp_out);
2094 #ifdef FEAT_EVAL
2095 write_viminfo_varlist(fp_out);
2096 #endif
2097 write_viminfo_filemarks(fp_out);
2098 write_viminfo_bufferlist(fp_out);
2099 count = write_viminfo_marks(fp_out);
2101 if (fp_in != NULL
2102 && (flags & (VIF_WANT_MARKS | VIF_GET_OLDFILES | VIF_FORCEIT)))
2103 copy_viminfo_marks(&vir, fp_out, count, eof, flags);
2105 vim_free(vir.vir_line);
2106 #ifdef FEAT_MBYTE
2107 if (vir.vir_conv.vc_type != CONV_NONE)
2108 convert_setup(&vir.vir_conv, NULL, NULL);
2109 #endif
2113 * read_viminfo_up_to_marks() -- Only called from do_viminfo(). Reads in the
2114 * first part of the viminfo file which contains everything but the marks that
2115 * are local to a file. Returns TRUE when end-of-file is reached. -- webb
2117 static int
2118 read_viminfo_up_to_marks(virp, forceit, writing)
2119 vir_T *virp;
2120 int forceit;
2121 int writing;
2123 int eof;
2124 buf_T *buf;
2126 #ifdef FEAT_CMDHIST
2127 prepare_viminfo_history(forceit ? 9999 : 0);
2128 #endif
2129 eof = viminfo_readline(virp);
2130 while (!eof && virp->vir_line[0] != '>')
2132 switch (virp->vir_line[0])
2134 /* Characters reserved for future expansion, ignored now */
2135 case '+': /* "+40 /path/dir file", for running vim without args */
2136 case '|': /* to be defined */
2137 case '^': /* to be defined */
2138 case '<': /* long line - ignored */
2139 /* A comment or empty line. */
2140 case NUL:
2141 case '\r':
2142 case '\n':
2143 case '#':
2144 eof = viminfo_readline(virp);
2145 break;
2146 case '*': /* "*encoding=value" */
2147 eof = viminfo_encoding(virp);
2148 break;
2149 case '!': /* global variable */
2150 #ifdef FEAT_EVAL
2151 eof = read_viminfo_varlist(virp, writing);
2152 #else
2153 eof = viminfo_readline(virp);
2154 #endif
2155 break;
2156 case '%': /* entry for buffer list */
2157 eof = read_viminfo_bufferlist(virp, writing);
2158 break;
2159 case '"':
2160 eof = read_viminfo_register(virp, forceit);
2161 break;
2162 case '/': /* Search string */
2163 case '&': /* Substitute search string */
2164 case '~': /* Last search string, followed by '/' or '&' */
2165 eof = read_viminfo_search_pattern(virp, forceit);
2166 break;
2167 case '$':
2168 eof = read_viminfo_sub_string(virp, forceit);
2169 break;
2170 case ':':
2171 case '?':
2172 case '=':
2173 case '@':
2174 #ifdef FEAT_CMDHIST
2175 eof = read_viminfo_history(virp);
2176 #else
2177 eof = viminfo_readline(virp);
2178 #endif
2179 break;
2180 case '-':
2181 case '\'':
2182 eof = read_viminfo_filemark(virp, forceit);
2183 break;
2184 default:
2185 if (viminfo_error("E575: ", _("Illegal starting char"),
2186 virp->vir_line))
2187 eof = TRUE;
2188 else
2189 eof = viminfo_readline(virp);
2190 break;
2194 #ifdef FEAT_CMDHIST
2195 /* Finish reading history items. */
2196 finish_viminfo_history();
2197 #endif
2199 /* Change file names to buffer numbers for fmarks. */
2200 for (buf = firstbuf; buf != NULL; buf = buf->b_next)
2201 fmarks_check_names(buf);
2203 return eof;
2207 * Compare the 'encoding' value in the viminfo file with the current value of
2208 * 'encoding'. If different and the 'c' flag is in 'viminfo', setup for
2209 * conversion of text with iconv() in viminfo_readstring().
2211 static int
2212 viminfo_encoding(virp)
2213 vir_T *virp;
2215 #ifdef FEAT_MBYTE
2216 char_u *p;
2217 int i;
2219 if (get_viminfo_parameter('c') != 0)
2221 p = vim_strchr(virp->vir_line, '=');
2222 if (p != NULL)
2224 /* remove trailing newline */
2225 ++p;
2226 for (i = 0; vim_isprintc(p[i]); ++i)
2228 p[i] = NUL;
2230 convert_setup(&virp->vir_conv, p, p_enc);
2233 #endif
2234 return viminfo_readline(virp);
2238 * Read a line from the viminfo file.
2239 * Returns TRUE for end-of-file;
2242 viminfo_readline(virp)
2243 vir_T *virp;
2245 return vim_fgets(virp->vir_line, LSIZE, virp->vir_fd);
2249 * check string read from viminfo file
2250 * remove '\n' at the end of the line
2251 * - replace CTRL-V CTRL-V with CTRL-V
2252 * - replace CTRL-V 'n' with '\n'
2254 * Check for a long line as written by viminfo_writestring().
2256 * Return the string in allocated memory (NULL when out of memory).
2258 char_u *
2259 viminfo_readstring(virp, off, convert)
2260 vir_T *virp;
2261 int off; /* offset for virp->vir_line */
2262 int convert UNUSED; /* convert the string */
2264 char_u *retval;
2265 char_u *s, *d;
2266 long len;
2268 if (virp->vir_line[off] == Ctrl_V && vim_isdigit(virp->vir_line[off + 1]))
2270 len = atol((char *)virp->vir_line + off + 1);
2271 retval = lalloc(len, TRUE);
2272 if (retval == NULL)
2274 /* Line too long? File messed up? Skip next line. */
2275 (void)vim_fgets(virp->vir_line, 10, virp->vir_fd);
2276 return NULL;
2278 (void)vim_fgets(retval, (int)len, virp->vir_fd);
2279 s = retval + 1; /* Skip the leading '<' */
2281 else
2283 retval = vim_strsave(virp->vir_line + off);
2284 if (retval == NULL)
2285 return NULL;
2286 s = retval;
2289 /* Change CTRL-V CTRL-V to CTRL-V and CTRL-V n to \n in-place. */
2290 d = retval;
2291 while (*s != NUL && *s != '\n')
2293 if (s[0] == Ctrl_V && s[1] != NUL)
2295 if (s[1] == 'n')
2296 *d++ = '\n';
2297 else
2298 *d++ = Ctrl_V;
2299 s += 2;
2301 else
2302 *d++ = *s++;
2304 *d = NUL;
2306 #ifdef FEAT_MBYTE
2307 if (convert && virp->vir_conv.vc_type != CONV_NONE && *retval != NUL)
2309 d = string_convert(&virp->vir_conv, retval, NULL);
2310 if (d != NULL)
2312 vim_free(retval);
2313 retval = d;
2316 #endif
2318 return retval;
2322 * write string to viminfo file
2323 * - replace CTRL-V with CTRL-V CTRL-V
2324 * - replace '\n' with CTRL-V 'n'
2325 * - add a '\n' at the end
2327 * For a long line:
2328 * - write " CTRL-V <length> \n " in first line
2329 * - write " < <string> \n " in second line
2331 void
2332 viminfo_writestring(fd, p)
2333 FILE *fd;
2334 char_u *p;
2336 int c;
2337 char_u *s;
2338 int len = 0;
2340 for (s = p; *s != NUL; ++s)
2342 if (*s == Ctrl_V || *s == '\n')
2343 ++len;
2344 ++len;
2347 /* If the string will be too long, write its length and put it in the next
2348 * line. Take into account that some room is needed for what comes before
2349 * the string (e.g., variable name). Add something to the length for the
2350 * '<', NL and trailing NUL. */
2351 if (len > LSIZE / 2)
2352 fprintf(fd, IF_EB("\026%d\n<", CTRL_V_STR "%d\n<"), len + 3);
2354 while ((c = *p++) != NUL)
2356 if (c == Ctrl_V || c == '\n')
2358 putc(Ctrl_V, fd);
2359 if (c == '\n')
2360 c = 'n';
2362 putc(c, fd);
2364 putc('\n', fd);
2366 #endif /* FEAT_VIMINFO */
2369 * Implementation of ":fixdel", also used by get_stty().
2370 * <BS> resulting <Del>
2371 * ^? ^H
2372 * not ^? ^?
2374 void
2375 do_fixdel(eap)
2376 exarg_T *eap UNUSED;
2378 char_u *p;
2380 p = find_termcode((char_u *)"kb");
2381 add_termcode((char_u *)"kD", p != NULL
2382 && *p == DEL ? (char_u *)CTRL_H_STR : DEL_STR, FALSE);
2385 void
2386 print_line_no_prefix(lnum, use_number, list)
2387 linenr_T lnum;
2388 int use_number;
2389 int list;
2391 char_u numbuf[30];
2393 if (curwin->w_p_nu || use_number)
2395 vim_snprintf((char *)numbuf, sizeof(numbuf),
2396 "%*ld ", number_width(curwin), (long)lnum);
2397 msg_puts_attr(numbuf, hl_attr(HLF_N)); /* Highlight line nrs */
2399 msg_prt_line(ml_get(lnum), list);
2403 * Print a text line. Also in silent mode ("ex -s").
2405 void
2406 print_line(lnum, use_number, list)
2407 linenr_T lnum;
2408 int use_number;
2409 int list;
2411 int save_silent = silent_mode;
2413 msg_start();
2414 silent_mode = FALSE;
2415 info_message = TRUE; /* use mch_msg(), not mch_errmsg() */
2416 print_line_no_prefix(lnum, use_number, list);
2417 if (save_silent)
2419 msg_putchar('\n');
2420 cursor_on(); /* msg_start() switches it off */
2421 out_flush();
2422 silent_mode = save_silent;
2424 info_message = FALSE;
2428 * ":file[!] [fname]".
2430 void
2431 ex_file(eap)
2432 exarg_T *eap;
2434 char_u *fname, *sfname, *xfname;
2435 buf_T *buf;
2437 /* ":0file" removes the file name. Check for illegal uses ":3file",
2438 * "0file name", etc. */
2439 if (eap->addr_count > 0
2440 && (*eap->arg != NUL
2441 || eap->line2 > 0
2442 || eap->addr_count > 1))
2444 EMSG(_(e_invarg));
2445 return;
2448 if (*eap->arg != NUL || eap->addr_count == 1)
2450 #ifdef FEAT_AUTOCMD
2451 buf = curbuf;
2452 apply_autocmds(EVENT_BUFFILEPRE, NULL, NULL, FALSE, curbuf);
2453 /* buffer changed, don't change name now */
2454 if (buf != curbuf)
2455 return;
2456 # ifdef FEAT_EVAL
2457 if (aborting()) /* autocmds may abort script processing */
2458 return;
2459 # endif
2460 #endif
2462 * The name of the current buffer will be changed.
2463 * A new (unlisted) buffer entry needs to be made to hold the old file
2464 * name, which will become the alternate file name.
2465 * But don't set the alternate file name if the buffer didn't have a
2466 * name.
2468 fname = curbuf->b_ffname;
2469 sfname = curbuf->b_sfname;
2470 xfname = curbuf->b_fname;
2471 curbuf->b_ffname = NULL;
2472 curbuf->b_sfname = NULL;
2473 if (setfname(curbuf, eap->arg, NULL, TRUE) == FAIL)
2475 curbuf->b_ffname = fname;
2476 curbuf->b_sfname = sfname;
2477 return;
2479 curbuf->b_flags |= BF_NOTEDITED;
2480 if (xfname != NULL && *xfname != NUL)
2482 buf = buflist_new(fname, xfname, curwin->w_cursor.lnum, 0);
2483 if (buf != NULL && !cmdmod.keepalt)
2484 curwin->w_alt_fnum = buf->b_fnum;
2486 vim_free(fname);
2487 vim_free(sfname);
2488 #ifdef FEAT_AUTOCMD
2489 apply_autocmds(EVENT_BUFFILEPOST, NULL, NULL, FALSE, curbuf);
2490 #endif
2491 /* Change directories when the 'acd' option is set. */
2492 DO_AUTOCHDIR
2494 /* print full file name if :cd used */
2495 fileinfo(FALSE, FALSE, eap->forceit);
2499 * ":update".
2501 void
2502 ex_update(eap)
2503 exarg_T *eap;
2505 if (curbufIsChanged())
2506 (void)do_write(eap);
2510 * ":write" and ":saveas".
2512 void
2513 ex_write(eap)
2514 exarg_T *eap;
2516 if (eap->usefilter) /* input lines to shell command */
2517 do_bang(1, eap, FALSE, TRUE, FALSE);
2518 else
2519 (void)do_write(eap);
2523 * write current buffer to file 'eap->arg'
2524 * if 'eap->append' is TRUE, append to the file
2526 * if *eap->arg == NUL write to current file
2528 * return FAIL for failure, OK otherwise
2531 do_write(eap)
2532 exarg_T *eap;
2534 int other;
2535 char_u *fname = NULL; /* init to shut up gcc */
2536 char_u *ffname;
2537 int retval = FAIL;
2538 char_u *free_fname = NULL;
2539 #ifdef FEAT_BROWSE
2540 char_u *browse_file = NULL;
2541 #endif
2542 buf_T *alt_buf = NULL;
2544 if (not_writing()) /* check 'write' option */
2545 return FAIL;
2547 ffname = eap->arg;
2548 #ifdef FEAT_BROWSE
2549 if (cmdmod.browse)
2551 browse_file = do_browse(BROWSE_SAVE, (char_u *)_("Save As"), ffname,
2552 NULL, NULL, NULL, curbuf);
2553 if (browse_file == NULL)
2554 goto theend;
2555 ffname = browse_file;
2557 #endif
2558 if (*ffname == NUL)
2560 if (eap->cmdidx == CMD_saveas)
2562 EMSG(_(e_argreq));
2563 goto theend;
2565 other = FALSE;
2567 else
2569 fname = ffname;
2570 free_fname = fix_fname(ffname);
2572 * When out-of-memory, keep unexpanded file name, because we MUST be
2573 * able to write the file in this situation.
2575 if (free_fname != NULL)
2576 ffname = free_fname;
2577 other = otherfile(ffname);
2581 * If we have a new file, put its name in the list of alternate file names.
2583 if (other)
2585 if (vim_strchr(p_cpo, CPO_ALTWRITE) != NULL
2586 || eap->cmdidx == CMD_saveas)
2587 alt_buf = setaltfname(ffname, fname, (linenr_T)1);
2588 else
2589 alt_buf = buflist_findname(ffname);
2590 if (alt_buf != NULL && alt_buf->b_ml.ml_mfp != NULL)
2592 /* Overwriting a file that is loaded in another buffer is not a
2593 * good idea. */
2594 EMSG(_(e_bufloaded));
2595 goto theend;
2600 * Writing to the current file is not allowed in readonly mode
2601 * and a file name is required.
2602 * "nofile" and "nowrite" buffers cannot be written implicitly either.
2604 if (!other && (
2605 #ifdef FEAT_QUICKFIX
2606 bt_dontwrite_msg(curbuf) ||
2607 #endif
2608 check_fname() == FAIL || check_readonly(&eap->forceit, curbuf)))
2609 goto theend;
2611 if (!other)
2613 ffname = curbuf->b_ffname;
2614 fname = curbuf->b_fname;
2616 * Not writing the whole file is only allowed with '!'.
2618 if ( (eap->line1 != 1
2619 || eap->line2 != curbuf->b_ml.ml_line_count)
2620 && !eap->forceit
2621 && !eap->append
2622 && !p_wa)
2624 #if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
2625 if (p_confirm || cmdmod.confirm)
2627 if (vim_dialog_yesno(VIM_QUESTION, NULL,
2628 (char_u *)_("Write partial file?"), 2) != VIM_YES)
2629 goto theend;
2630 eap->forceit = TRUE;
2632 else
2633 #endif
2635 EMSG(_("E140: Use ! to write partial buffer"));
2636 goto theend;
2641 if (check_overwrite(eap, curbuf, fname, ffname, other) == OK)
2643 if (eap->cmdidx == CMD_saveas && alt_buf != NULL)
2645 #ifdef FEAT_AUTOCMD
2646 buf_T *was_curbuf = curbuf;
2648 apply_autocmds(EVENT_BUFFILEPRE, NULL, NULL, FALSE, curbuf);
2649 apply_autocmds(EVENT_BUFFILEPRE, NULL, NULL, FALSE, alt_buf);
2650 # ifdef FEAT_EVAL
2651 if (curbuf != was_curbuf || aborting())
2652 # else
2653 if (curbuf != was_curbuf)
2654 # endif
2656 /* buffer changed, don't change name now */
2657 retval = FAIL;
2658 goto theend;
2660 #endif
2661 /* Exchange the file names for the current and the alternate
2662 * buffer. This makes it look like we are now editing the buffer
2663 * under the new name. Must be done before buf_write(), because
2664 * if there is no file name and 'cpo' contains 'F', it will set
2665 * the file name. */
2666 fname = alt_buf->b_fname;
2667 alt_buf->b_fname = curbuf->b_fname;
2668 curbuf->b_fname = fname;
2669 fname = alt_buf->b_ffname;
2670 alt_buf->b_ffname = curbuf->b_ffname;
2671 curbuf->b_ffname = fname;
2672 fname = alt_buf->b_sfname;
2673 alt_buf->b_sfname = curbuf->b_sfname;
2674 curbuf->b_sfname = fname;
2675 buf_name_changed(curbuf);
2676 #ifdef FEAT_AUTOCMD
2677 apply_autocmds(EVENT_BUFFILEPOST, NULL, NULL, FALSE, curbuf);
2678 apply_autocmds(EVENT_BUFFILEPOST, NULL, NULL, FALSE, alt_buf);
2679 if (!alt_buf->b_p_bl)
2681 alt_buf->b_p_bl = TRUE;
2682 apply_autocmds(EVENT_BUFADD, NULL, NULL, FALSE, alt_buf);
2684 # ifdef FEAT_EVAL
2685 if (curbuf != was_curbuf || aborting())
2686 # else
2687 if (curbuf != was_curbuf)
2688 # endif
2690 /* buffer changed, don't write the file */
2691 retval = FAIL;
2692 goto theend;
2695 /* If 'filetype' was empty try detecting it now. */
2696 if (*curbuf->b_p_ft == NUL)
2698 if (au_has_group((char_u *)"filetypedetect"))
2699 (void)do_doautocmd((char_u *)"filetypedetect BufRead",
2700 TRUE);
2701 do_modelines(0);
2703 #endif
2706 retval = buf_write(curbuf, ffname, fname, eap->line1, eap->line2,
2707 eap, eap->append, eap->forceit, TRUE, FALSE);
2709 /* After ":saveas fname" reset 'readonly'. */
2710 if (eap->cmdidx == CMD_saveas)
2712 if (retval == OK)
2714 curbuf->b_p_ro = FALSE;
2715 #ifdef FEAT_WINDOWS
2716 redraw_tabline = TRUE;
2717 #endif
2719 /* Change directories when the 'acd' option is set. */
2720 DO_AUTOCHDIR
2724 theend:
2725 #ifdef FEAT_BROWSE
2726 vim_free(browse_file);
2727 #endif
2728 vim_free(free_fname);
2729 return retval;
2733 * Check if it is allowed to overwrite a file. If b_flags has BF_NOTEDITED,
2734 * BF_NEW or BF_READERR, check for overwriting current file.
2735 * May set eap->forceit if a dialog says it's OK to overwrite.
2736 * Return OK if it's OK, FAIL if it is not.
2738 static int
2739 check_overwrite(eap, buf, fname, ffname, other)
2740 exarg_T *eap;
2741 buf_T *buf;
2742 char_u *fname; /* file name to be used (can differ from
2743 buf->ffname) */
2744 char_u *ffname; /* full path version of fname */
2745 int other; /* writing under other name */
2748 * write to other file or b_flags set or not writing the whole file:
2749 * overwriting only allowed with '!'
2751 if ( (other
2752 || (buf->b_flags & BF_NOTEDITED)
2753 || ((buf->b_flags & BF_NEW)
2754 && vim_strchr(p_cpo, CPO_OVERNEW) == NULL)
2755 || (buf->b_flags & BF_READERR))
2756 && !p_wa
2757 #ifdef FEAT_QUICKFIX
2758 && !bt_nofile(buf)
2759 #endif
2760 && vim_fexists(ffname))
2762 if (!eap->forceit && !eap->append)
2764 #ifdef UNIX
2765 /* with UNIX it is possible to open a directory */
2766 if (mch_isdir(ffname))
2768 EMSG2(_(e_isadir2), ffname);
2769 return FAIL;
2771 #endif
2772 #if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
2773 if (p_confirm || cmdmod.confirm)
2775 char_u buff[IOSIZE];
2777 dialog_msg(buff, _("Overwrite existing file \"%s\"?"), fname);
2778 if (vim_dialog_yesno(VIM_QUESTION, NULL, buff, 2) != VIM_YES)
2779 return FAIL;
2780 eap->forceit = TRUE;
2782 else
2783 #endif
2785 EMSG(_(e_exists));
2786 return FAIL;
2790 /* For ":w! filename" check that no swap file exists for "filename". */
2791 if (other && !emsg_silent)
2793 char_u dir[MAXPATHL];
2794 char_u *p;
2795 int r;
2796 char_u *swapname;
2798 /* We only try the first entry in 'directory', without checking if
2799 * it's writable. If the "." directory is not writable the write
2800 * will probably fail anyway.
2801 * Use 'shortname' of the current buffer, since there is no buffer
2802 * for the written file. */
2803 if (*p_dir == NUL)
2804 STRCPY(dir, ".");
2805 else
2807 p = p_dir;
2808 copy_option_part(&p, dir, MAXPATHL, ",");
2810 swapname = makeswapname(fname, ffname, curbuf, dir);
2811 r = vim_fexists(swapname);
2812 if (r)
2814 #if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
2815 if (p_confirm || cmdmod.confirm)
2817 char_u buff[IOSIZE];
2819 dialog_msg(buff,
2820 _("Swap file \"%s\" exists, overwrite anyway?"),
2821 swapname);
2822 if (vim_dialog_yesno(VIM_QUESTION, NULL, buff, 2)
2823 != VIM_YES)
2825 vim_free(swapname);
2826 return FAIL;
2828 eap->forceit = TRUE;
2830 else
2831 #endif
2833 EMSG2(_("E768: Swap file exists: %s (:silent! overrides)"),
2834 swapname);
2835 vim_free(swapname);
2836 return FAIL;
2839 vim_free(swapname);
2842 return OK;
2846 * Handle ":wnext", ":wNext" and ":wprevious" commands.
2848 void
2849 ex_wnext(eap)
2850 exarg_T *eap;
2852 int i;
2854 if (eap->cmd[1] == 'n')
2855 i = curwin->w_arg_idx + (int)eap->line2;
2856 else
2857 i = curwin->w_arg_idx - (int)eap->line2;
2858 eap->line1 = 1;
2859 eap->line2 = curbuf->b_ml.ml_line_count;
2860 if (do_write(eap) != FAIL)
2861 do_argfile(eap, i);
2865 * ":wall", ":wqall" and ":xall": Write all changed files (and exit).
2867 void
2868 do_wqall(eap)
2869 exarg_T *eap;
2871 buf_T *buf;
2872 int error = 0;
2873 int save_forceit = eap->forceit;
2875 if (eap->cmdidx == CMD_xall || eap->cmdidx == CMD_wqall)
2876 exiting = TRUE;
2878 for (buf = firstbuf; buf != NULL; buf = buf->b_next)
2880 if (bufIsChanged(buf))
2883 * Check if there is a reason the buffer cannot be written:
2884 * 1. if the 'write' option is set
2885 * 2. if there is no file name (even after browsing)
2886 * 3. if the 'readonly' is set (even after a dialog)
2887 * 4. if overwriting is allowed (even after a dialog)
2889 if (not_writing())
2891 ++error;
2892 break;
2894 #ifdef FEAT_BROWSE
2895 /* ":browse wall": ask for file name if there isn't one */
2896 if (buf->b_ffname == NULL && cmdmod.browse)
2897 browse_save_fname(buf);
2898 #endif
2899 if (buf->b_ffname == NULL)
2901 EMSGN(_("E141: No file name for buffer %ld"), (long)buf->b_fnum);
2902 ++error;
2904 else if (check_readonly(&eap->forceit, buf)
2905 || check_overwrite(eap, buf, buf->b_fname, buf->b_ffname,
2906 FALSE) == FAIL)
2908 ++error;
2910 else
2912 if (buf_write_all(buf, eap->forceit) == FAIL)
2913 ++error;
2914 #ifdef FEAT_AUTOCMD
2915 /* an autocommand may have deleted the buffer */
2916 if (!buf_valid(buf))
2917 buf = firstbuf;
2918 #endif
2920 eap->forceit = save_forceit; /* check_overwrite() may set it */
2923 if (exiting)
2925 if (!error)
2926 getout(0); /* exit Vim */
2927 not_exiting();
2932 * Check the 'write' option.
2933 * Return TRUE and give a message when it's not st.
2936 not_writing()
2938 if (p_write)
2939 return FALSE;
2940 EMSG(_("E142: File not written: Writing is disabled by 'write' option"));
2941 return TRUE;
2945 * Check if a buffer is read-only (either 'readonly' option is set or file is
2946 * read-only). Ask for overruling in a dialog. Return TRUE and give an error
2947 * message when the buffer is readonly.
2949 static int
2950 check_readonly(forceit, buf)
2951 int *forceit;
2952 buf_T *buf;
2954 struct stat st;
2956 /* Handle a file being readonly when the 'readonly' option is set or when
2957 * the file exists and permissions are read-only.
2958 * We will send 0777 to check_file_readonly(), as the "perm" variable is
2959 * important for device checks but not here. */
2960 if (!*forceit && (buf->b_p_ro
2961 || (mch_stat((char *)buf->b_ffname, &st) >= 0
2962 && check_file_readonly(buf->b_ffname, 0777))))
2964 #if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
2965 if ((p_confirm || cmdmod.confirm) && buf->b_fname != NULL)
2967 char_u buff[IOSIZE];
2969 if (buf->b_p_ro)
2970 dialog_msg(buff, _("'readonly' option is set for \"%s\".\nDo you wish to write anyway?"),
2971 buf->b_fname);
2972 else
2973 dialog_msg(buff, _("File permissions of \"%s\" are read-only.\nIt may still be possible to write it.\nDo you wish to try?"),
2974 buf->b_fname);
2976 if (vim_dialog_yesno(VIM_QUESTION, NULL, buff, 2) == VIM_YES)
2978 /* Set forceit, to force the writing of a readonly file */
2979 *forceit = TRUE;
2980 return FALSE;
2982 else
2983 return TRUE;
2985 else
2986 #endif
2987 if (buf->b_p_ro)
2988 EMSG(_(e_readonly));
2989 else
2990 EMSG2(_("E505: \"%s\" is read-only (add ! to override)"),
2991 buf->b_fname);
2992 return TRUE;
2995 return FALSE;
2999 * Try to abandon current file and edit a new or existing file.
3000 * 'fnum' is the number of the file, if zero use ffname/sfname.
3002 * Return 1 for "normal" error, 2 for "not written" error, 0 for success
3003 * -1 for successfully opening another file.
3004 * 'lnum' is the line number for the cursor in the new file (if non-zero).
3007 getfile(fnum, ffname, sfname, setpm, lnum, forceit)
3008 int fnum;
3009 char_u *ffname;
3010 char_u *sfname;
3011 int setpm;
3012 linenr_T lnum;
3013 int forceit;
3015 int other;
3016 int retval;
3017 char_u *free_me = NULL;
3019 if (text_locked())
3020 return 1;
3021 #ifdef FEAT_AUTOCMD
3022 if (curbuf_locked())
3023 return 1;
3024 #endif
3026 if (fnum == 0)
3028 /* make ffname full path, set sfname */
3029 fname_expand(curbuf, &ffname, &sfname);
3030 other = otherfile(ffname);
3031 free_me = ffname; /* has been allocated, free() later */
3033 else
3034 other = (fnum != curbuf->b_fnum);
3036 if (other)
3037 ++no_wait_return; /* don't wait for autowrite message */
3038 if (other && !forceit && curbuf->b_nwindows == 1 && !P_HID(curbuf)
3039 && curbufIsChanged() && autowrite(curbuf, forceit) == FAIL)
3041 #if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
3042 if (p_confirm && p_write)
3043 dialog_changed(curbuf, FALSE);
3044 if (curbufIsChanged())
3045 #endif
3047 if (other)
3048 --no_wait_return;
3049 EMSG(_(e_nowrtmsg));
3050 retval = 2; /* file has been changed */
3051 goto theend;
3054 if (other)
3055 --no_wait_return;
3056 if (setpm)
3057 setpcmark();
3058 if (!other)
3060 if (lnum != 0)
3061 curwin->w_cursor.lnum = lnum;
3062 check_cursor_lnum();
3063 beginline(BL_SOL | BL_FIX);
3064 retval = 0; /* it's in the same file */
3066 else if (do_ecmd(fnum, ffname, sfname, NULL, lnum,
3067 (P_HID(curbuf) ? ECMD_HIDE : 0) + (forceit ? ECMD_FORCEIT : 0),
3068 curwin) == OK)
3069 retval = -1; /* opened another file */
3070 else
3071 retval = 1; /* error encountered */
3073 theend:
3074 vim_free(free_me);
3075 return retval;
3079 * start editing a new file
3081 * fnum: file number; if zero use ffname/sfname
3082 * ffname: the file name
3083 * - full path if sfname used,
3084 * - any file name if sfname is NULL
3085 * - empty string to re-edit with the same file name (but may be
3086 * in a different directory)
3087 * - NULL to start an empty buffer
3088 * sfname: the short file name (or NULL)
3089 * eap: contains the command to be executed after loading the file and
3090 * forced 'ff' and 'fenc'
3091 * newlnum: if > 0: put cursor on this line number (if possible)
3092 * if ECMD_LASTL: use last position in loaded file
3093 * if ECMD_LAST: use last position in all files
3094 * if ECMD_ONE: use first line
3095 * flags:
3096 * ECMD_HIDE: if TRUE don't free the current buffer
3097 * ECMD_SET_HELP: set b_help flag of (new) buffer before opening file
3098 * ECMD_OLDBUF: use existing buffer if it exists
3099 * ECMD_FORCEIT: ! used for Ex command
3100 * ECMD_ADDBUF: don't edit, just add to buffer list
3101 * oldwin: Should be "curwin" when editing a new buffer in the current
3102 * window, NULL when splitting the window first. When not NULL info
3103 * of the previous buffer for "oldwin" is stored.
3105 * return FAIL for failure, OK otherwise
3108 do_ecmd(fnum, ffname, sfname, eap, newlnum, flags, oldwin)
3109 int fnum;
3110 char_u *ffname;
3111 char_u *sfname;
3112 exarg_T *eap; /* can be NULL! */
3113 linenr_T newlnum;
3114 int flags;
3115 win_T *oldwin;
3117 int other_file; /* TRUE if editing another file */
3118 int oldbuf; /* TRUE if using existing buffer */
3119 #ifdef FEAT_AUTOCMD
3120 int auto_buf = FALSE; /* TRUE if autocommands brought us
3121 into the buffer unexpectedly */
3122 char_u *new_name = NULL;
3123 int did_set_swapcommand = FALSE;
3124 #endif
3125 buf_T *buf;
3126 #if defined(FEAT_AUTOCMD) || defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
3127 buf_T *old_curbuf = curbuf;
3128 #endif
3129 char_u *free_fname = NULL;
3130 #ifdef FEAT_BROWSE
3131 char_u *browse_file = NULL;
3132 #endif
3133 int retval = FAIL;
3134 long n;
3135 linenr_T lnum;
3136 linenr_T topline = 0;
3137 int newcol = -1;
3138 int solcol = -1;
3139 pos_T *pos;
3140 #ifdef FEAT_SUN_WORKSHOP
3141 char_u *cp;
3142 #endif
3143 char_u *command = NULL;
3144 #ifdef FEAT_SPELL
3145 int did_get_winopts = FALSE;
3146 #endif
3148 if (eap != NULL)
3149 command = eap->do_ecmd_cmd;
3151 if (fnum != 0)
3153 if (fnum == curbuf->b_fnum) /* file is already being edited */
3154 return OK; /* nothing to do */
3155 other_file = TRUE;
3157 else
3159 #ifdef FEAT_BROWSE
3160 if (cmdmod.browse)
3162 # ifdef FEAT_AUTOCMD
3163 if (
3164 # ifdef FEAT_GUI
3165 !gui.in_use &&
3166 # endif
3167 au_has_group((char_u *)"FileExplorer"))
3169 /* No browsing supported but we do have the file explorer:
3170 * Edit the directory. */
3171 if (ffname == NULL || !mch_isdir(ffname))
3172 ffname = (char_u *)".";
3174 else
3175 # endif
3177 browse_file = do_browse(0, (char_u *)_("Edit File"), ffname,
3178 NULL, NULL, NULL, curbuf);
3179 if (browse_file == NULL)
3180 goto theend;
3181 ffname = browse_file;
3184 #endif
3185 /* if no short name given, use ffname for short name */
3186 if (sfname == NULL)
3187 sfname = ffname;
3188 #ifdef USE_FNAME_CASE
3189 # ifdef USE_LONG_FNAME
3190 if (USE_LONG_FNAME)
3191 # endif
3192 if (sfname != NULL)
3193 fname_case(sfname, 0); /* set correct case for sfname */
3194 #endif
3196 #ifdef FEAT_LISTCMDS
3197 if ((flags & ECMD_ADDBUF) && (ffname == NULL || *ffname == NUL))
3198 goto theend;
3199 #endif
3201 if (ffname == NULL)
3202 other_file = TRUE;
3203 /* there is no file name */
3204 else if (*ffname == NUL && curbuf->b_ffname == NULL)
3205 other_file = FALSE;
3206 else
3208 if (*ffname == NUL) /* re-edit with same file name */
3210 ffname = curbuf->b_ffname;
3211 sfname = curbuf->b_fname;
3213 free_fname = fix_fname(ffname); /* may expand to full path name */
3214 if (free_fname != NULL)
3215 ffname = free_fname;
3216 other_file = otherfile(ffname);
3217 #ifdef FEAT_SUN_WORKSHOP
3218 if (usingSunWorkShop && p_acd
3219 && (cp = vim_strrchr(sfname, '/')) != NULL)
3220 sfname = ++cp;
3221 #endif
3226 * if the file was changed we may not be allowed to abandon it
3227 * - if we are going to re-edit the same file
3228 * - or if we are the only window on this file and if ECMD_HIDE is FALSE
3230 if ( ((!other_file && !(flags & ECMD_OLDBUF))
3231 || (curbuf->b_nwindows == 1
3232 && !(flags & (ECMD_HIDE | ECMD_ADDBUF))))
3233 && check_changed(curbuf, p_awa, !other_file,
3234 (flags & ECMD_FORCEIT), FALSE))
3236 if (fnum == 0 && other_file && ffname != NULL)
3237 (void)setaltfname(ffname, sfname, newlnum < 0 ? 0 : newlnum);
3238 goto theend;
3241 #ifdef FEAT_VISUAL
3243 * End Visual mode before switching to another buffer, so the text can be
3244 * copied into the GUI selection buffer.
3246 reset_VIsual();
3247 #endif
3249 #ifdef FEAT_AUTOCMD
3250 if ((command != NULL || newlnum > (linenr_T)0)
3251 && *get_vim_var_str(VV_SWAPCOMMAND) == NUL)
3253 int len;
3254 char_u *p;
3256 /* Set v:swapcommand for the SwapExists autocommands. */
3257 if (command != NULL)
3258 len = (int)STRLEN(command) + 3;
3259 else
3260 len = 30;
3261 p = alloc((unsigned)len);
3262 if (p != NULL)
3264 if (command != NULL)
3265 vim_snprintf((char *)p, len, ":%s\r", command);
3266 else
3267 vim_snprintf((char *)p, len, "%ldG", (long)newlnum);
3268 set_vim_var_string(VV_SWAPCOMMAND, p, -1);
3269 did_set_swapcommand = TRUE;
3270 vim_free(p);
3273 #endif
3276 * If we are starting to edit another file, open a (new) buffer.
3277 * Otherwise we re-use the current buffer.
3279 if (other_file)
3281 #ifdef FEAT_LISTCMDS
3282 if (!(flags & ECMD_ADDBUF))
3283 #endif
3285 if (!cmdmod.keepalt)
3286 curwin->w_alt_fnum = curbuf->b_fnum;
3287 if (oldwin != NULL)
3288 buflist_altfpos(oldwin);
3291 if (fnum)
3292 buf = buflist_findnr(fnum);
3293 else
3295 #ifdef FEAT_LISTCMDS
3296 if (flags & ECMD_ADDBUF)
3298 linenr_T tlnum = 1L;
3300 if (command != NULL)
3302 tlnum = atol((char *)command);
3303 if (tlnum <= 0)
3304 tlnum = 1L;
3306 (void)buflist_new(ffname, sfname, tlnum, BLN_LISTED);
3307 goto theend;
3309 #endif
3310 buf = buflist_new(ffname, sfname, 0L,
3311 BLN_CURBUF | ((flags & ECMD_SET_HELP) ? 0 : BLN_LISTED));
3313 if (buf == NULL)
3314 goto theend;
3315 if (buf->b_ml.ml_mfp == NULL) /* no memfile yet */
3317 oldbuf = FALSE;
3318 buf->b_nwindows = 0;
3320 else /* existing memfile */
3322 oldbuf = TRUE;
3323 (void)buf_check_timestamp(buf, FALSE);
3324 /* Check if autocommands made buffer invalid or changed the current
3325 * buffer. */
3326 if (!buf_valid(buf)
3327 #ifdef FEAT_AUTOCMD
3328 || curbuf != old_curbuf
3329 #endif
3331 goto theend;
3332 #ifdef FEAT_EVAL
3333 if (aborting()) /* autocmds may abort script processing */
3334 goto theend;
3335 #endif
3338 /* May jump to last used line number for a loaded buffer or when asked
3339 * for explicitly */
3340 if ((oldbuf && newlnum == ECMD_LASTL) || newlnum == ECMD_LAST)
3342 pos = buflist_findfpos(buf);
3343 newlnum = pos->lnum;
3344 solcol = pos->col;
3348 * Make the (new) buffer the one used by the current window.
3349 * If the old buffer becomes unused, free it if ECMD_HIDE is FALSE.
3350 * If the current buffer was empty and has no file name, curbuf
3351 * is returned by buflist_new().
3353 if (buf != curbuf)
3355 #ifdef FEAT_AUTOCMD
3357 * Be careful: The autocommands may delete any buffer and change
3358 * the current buffer.
3359 * - If the buffer we are going to edit is deleted, give up.
3360 * - If the current buffer is deleted, prefer to load the new
3361 * buffer when loading a buffer is required. This avoids
3362 * loading another buffer which then must be closed again.
3363 * - If we ended up in the new buffer already, need to skip a few
3364 * things, set auto_buf.
3366 if (buf->b_fname != NULL)
3367 new_name = vim_strsave(buf->b_fname);
3368 au_new_curbuf = buf;
3369 apply_autocmds(EVENT_BUFLEAVE, NULL, NULL, FALSE, curbuf);
3370 if (!buf_valid(buf)) /* new buffer has been deleted */
3372 delbuf_msg(new_name); /* frees new_name */
3373 goto theend;
3375 # ifdef FEAT_EVAL
3376 if (aborting()) /* autocmds may abort script processing */
3378 vim_free(new_name);
3379 goto theend;
3381 # endif
3382 if (buf == curbuf) /* already in new buffer */
3383 auto_buf = TRUE;
3384 else
3386 if (curbuf == old_curbuf)
3387 #endif
3388 buf_copy_options(buf, BCO_ENTER);
3390 /* close the link to the current buffer */
3391 u_sync(FALSE);
3392 close_buffer(oldwin, curbuf,
3393 (flags & ECMD_HIDE) ? 0 : DOBUF_UNLOAD);
3395 #ifdef FEAT_AUTOCMD
3396 # ifdef FEAT_EVAL
3397 if (aborting()) /* autocmds may abort script processing */
3399 vim_free(new_name);
3400 goto theend;
3402 # endif
3403 /* Be careful again, like above. */
3404 if (!buf_valid(buf)) /* new buffer has been deleted */
3406 delbuf_msg(new_name); /* frees new_name */
3407 goto theend;
3409 if (buf == curbuf) /* already in new buffer */
3410 auto_buf = TRUE;
3411 else
3412 #endif
3414 curwin->w_buffer = buf;
3415 curbuf = buf;
3416 ++curbuf->b_nwindows;
3417 /* set 'fileformat' */
3418 if (*p_ffs && !oldbuf)
3419 set_fileformat(default_fileformat(), OPT_LOCAL);
3422 /* May get the window options from the last time this buffer
3423 * was in this window (or another window). If not used
3424 * before, reset the local window options to the global
3425 * values. Also restores old folding stuff. */
3426 get_winopts(curbuf);
3427 #ifdef FEAT_SPELL
3428 did_get_winopts = TRUE;
3429 #endif
3431 #ifdef FEAT_AUTOCMD
3433 vim_free(new_name);
3434 au_new_curbuf = NULL;
3435 #endif
3437 else
3438 ++curbuf->b_nwindows;
3440 curwin->w_pcmark.lnum = 1;
3441 curwin->w_pcmark.col = 0;
3443 else /* !other_file */
3445 if (
3446 #ifdef FEAT_LISTCMDS
3447 (flags & ECMD_ADDBUF) ||
3448 #endif
3449 check_fname() == FAIL)
3450 goto theend;
3451 oldbuf = (flags & ECMD_OLDBUF);
3454 if ((flags & ECMD_SET_HELP) || keep_help_flag)
3456 char_u *p;
3458 curbuf->b_help = TRUE;
3459 #ifdef FEAT_QUICKFIX
3460 set_string_option_direct((char_u *)"buftype", -1,
3461 (char_u *)"help", OPT_FREE|OPT_LOCAL, 0);
3462 #endif
3465 * Always set these options after jumping to a help tag, because the
3466 * user may have an autocommand that gets in the way.
3467 * Accept all ASCII chars for keywords, except ' ', '*', '"', '|', and
3468 * latin1 word characters (for translated help files).
3469 * Only set it when needed, buf_init_chartab() is some work.
3472 #ifdef EBCDIC
3473 (char_u *)"65-255,^*,^|,^\"";
3474 #else
3475 (char_u *)"!-~,^*,^|,^\",192-255";
3476 #endif
3477 if (STRCMP(curbuf->b_p_isk, p) != 0)
3479 set_string_option_direct((char_u *)"isk", -1, p,
3480 OPT_FREE|OPT_LOCAL, 0);
3481 check_buf_options(curbuf);
3482 (void)buf_init_chartab(curbuf, FALSE);
3485 curbuf->b_p_ts = 8; /* 'tabstop' is 8 */
3486 curwin->w_p_list = FALSE; /* no list mode */
3488 curbuf->b_p_ma = FALSE; /* not modifiable */
3489 curbuf->b_p_bin = FALSE; /* reset 'bin' before reading file */
3490 curwin->w_p_nu = 0; /* no line numbers */
3491 #ifdef FEAT_SCROLLBIND
3492 curwin->w_p_scb = FALSE; /* no scroll binding */
3493 #endif
3494 #ifdef FEAT_ARABIC
3495 curwin->w_p_arab = FALSE; /* no arabic mode */
3496 #endif
3497 #ifdef FEAT_RIGHTLEFT
3498 curwin->w_p_rl = FALSE; /* help window is left-to-right */
3499 #endif
3500 #ifdef FEAT_FOLDING
3501 curwin->w_p_fen = FALSE; /* No folding in the help window */
3502 #endif
3503 #ifdef FEAT_DIFF
3504 curwin->w_p_diff = FALSE; /* No 'diff' */
3505 #endif
3506 #ifdef FEAT_SPELL
3507 curwin->w_p_spell = FALSE; /* No spell checking */
3508 #endif
3510 #ifdef FEAT_AUTOCMD
3511 buf = curbuf;
3512 #endif
3513 set_buflisted(FALSE);
3515 else
3517 #ifdef FEAT_AUTOCMD
3518 buf = curbuf;
3519 #endif
3520 /* Don't make a buffer listed if it's a help buffer. Useful when
3521 * using CTRL-O to go back to a help file. */
3522 if (!curbuf->b_help)
3523 set_buflisted(TRUE);
3526 #ifdef FEAT_AUTOCMD
3527 /* If autocommands change buffers under our fingers, forget about
3528 * editing the file. */
3529 if (buf != curbuf)
3530 goto theend;
3531 # ifdef FEAT_EVAL
3532 if (aborting()) /* autocmds may abort script processing */
3533 goto theend;
3534 # endif
3536 /* Since we are starting to edit a file, consider the filetype to be
3537 * unset. Helps for when an autocommand changes files and expects syntax
3538 * highlighting to work in the other file. */
3539 did_filetype = FALSE;
3540 #endif
3543 * other_file oldbuf
3544 * FALSE FALSE re-edit same file, buffer is re-used
3545 * FALSE TRUE re-edit same file, nothing changes
3546 * TRUE FALSE start editing new file, new buffer
3547 * TRUE TRUE start editing in existing buffer (nothing to do)
3549 if (!other_file && !oldbuf) /* re-use the buffer */
3551 set_last_cursor(curwin); /* may set b_last_cursor */
3552 if (newlnum == ECMD_LAST || newlnum == ECMD_LASTL)
3554 newlnum = curwin->w_cursor.lnum;
3555 solcol = curwin->w_cursor.col;
3557 #ifdef FEAT_AUTOCMD
3558 buf = curbuf;
3559 if (buf->b_fname != NULL)
3560 new_name = vim_strsave(buf->b_fname);
3561 else
3562 new_name = NULL;
3563 #endif
3564 buf_freeall(curbuf, FALSE, FALSE); /* free all things for buffer */
3565 #ifdef FEAT_AUTOCMD
3566 /* If autocommands deleted the buffer we were going to re-edit, give
3567 * up and jump to the end. */
3568 if (!buf_valid(buf))
3570 delbuf_msg(new_name); /* frees new_name */
3571 goto theend;
3573 vim_free(new_name);
3575 /* If autocommands change buffers under our fingers, forget about
3576 * re-editing the file. Should do the buf_clear_file(), but perhaps
3577 * the autocommands changed the buffer... */
3578 if (buf != curbuf)
3579 goto theend;
3580 # ifdef FEAT_EVAL
3581 if (aborting()) /* autocmds may abort script processing */
3582 goto theend;
3583 # endif
3584 #endif
3585 buf_clear_file(curbuf);
3586 curbuf->b_op_start.lnum = 0; /* clear '[ and '] marks */
3587 curbuf->b_op_end.lnum = 0;
3591 * If we get here we are sure to start editing
3593 /* don't redraw until the cursor is in the right line */
3594 ++RedrawingDisabled;
3596 /* Assume success now */
3597 retval = OK;
3600 * Reset cursor position, could be used by autocommands.
3602 check_cursor();
3605 * Check if we are editing the w_arg_idx file in the argument list.
3607 check_arg_idx(curwin);
3609 #ifdef FEAT_AUTOCMD
3610 if (!auto_buf)
3611 #endif
3614 * Set cursor and init window before reading the file and executing
3615 * autocommands. This allows for the autocommands to position the
3616 * cursor.
3618 curwin_init();
3620 #ifdef FEAT_FOLDING
3621 /* It's possible that all lines in the buffer changed. Need to update
3622 * automatic folding for all windows where it's used. */
3623 # ifdef FEAT_WINDOWS
3625 win_T *win;
3626 tabpage_T *tp;
3628 FOR_ALL_TAB_WINDOWS(tp, win)
3629 if (win->w_buffer == curbuf)
3630 foldUpdateAll(win);
3632 # else
3633 foldUpdateAll(curwin);
3634 # endif
3635 #endif
3637 /* Change directories when the 'acd' option is set. */
3638 DO_AUTOCHDIR
3641 * Careful: open_buffer() and apply_autocmds() may change the current
3642 * buffer and window.
3644 lnum = curwin->w_cursor.lnum;
3645 topline = curwin->w_topline;
3646 if (!oldbuf) /* need to read the file */
3648 #if defined(HAS_SWAP_EXISTS_ACTION)
3649 swap_exists_action = SEA_DIALOG;
3650 #endif
3651 curbuf->b_flags |= BF_CHECK_RO; /* set/reset 'ro' flag */
3654 * Open the buffer and read the file.
3656 #if defined(FEAT_AUTOCMD) && defined(FEAT_EVAL)
3657 if (should_abort(open_buffer(FALSE, eap)))
3658 retval = FAIL;
3659 #else
3660 (void)open_buffer(FALSE, eap);
3661 #endif
3663 #if defined(HAS_SWAP_EXISTS_ACTION)
3664 if (swap_exists_action == SEA_QUIT)
3665 retval = FAIL;
3666 handle_swap_exists(old_curbuf);
3667 #endif
3669 #ifdef FEAT_AUTOCMD
3670 else
3672 /* Read the modelines, but only to set window-local options. Any
3673 * buffer-local options have already been set and may have been
3674 * changed by the user. */
3675 do_modelines(OPT_WINONLY);
3677 apply_autocmds_retval(EVENT_BUFENTER, NULL, NULL, FALSE, curbuf,
3678 &retval);
3679 apply_autocmds_retval(EVENT_BUFWINENTER, NULL, NULL, FALSE, curbuf,
3680 &retval);
3682 check_arg_idx(curwin);
3683 #endif
3686 * If autocommands change the cursor position or topline, we should
3687 * keep it.
3689 if (curwin->w_cursor.lnum != lnum)
3691 newlnum = curwin->w_cursor.lnum;
3692 newcol = curwin->w_cursor.col;
3694 if (curwin->w_topline == topline)
3695 topline = 0;
3697 /* Even when cursor didn't move we need to recompute topline. */
3698 changed_line_abv_curs();
3700 #ifdef FEAT_TITLE
3701 maketitle();
3702 #endif
3705 #ifdef FEAT_DIFF
3706 /* Tell the diff stuff that this buffer is new and/or needs updating.
3707 * Also needed when re-editing the same buffer, because unloading will
3708 * have removed it as a diff buffer. */
3709 if (curwin->w_p_diff)
3711 diff_buf_add(curbuf);
3712 diff_invalidate(curbuf);
3714 #endif
3716 #ifdef FEAT_SPELL
3717 /* If the window options were changed may need to set the spell language.
3718 * Can only do this after the buffer has been properly setup. */
3719 if (did_get_winopts && curwin->w_p_spell && *curbuf->b_p_spl != NUL)
3720 (void)did_set_spelllang(curbuf);
3721 #endif
3723 if (command == NULL)
3725 if (newcol >= 0) /* position set by autocommands */
3727 curwin->w_cursor.lnum = newlnum;
3728 curwin->w_cursor.col = newcol;
3729 check_cursor();
3731 else if (newlnum > 0) /* line number from caller or old position */
3733 curwin->w_cursor.lnum = newlnum;
3734 check_cursor_lnum();
3735 if (solcol >= 0 && !p_sol)
3737 /* 'sol' is off: Use last known column. */
3738 curwin->w_cursor.col = solcol;
3739 check_cursor_col();
3740 #ifdef FEAT_VIRTUALEDIT
3741 curwin->w_cursor.coladd = 0;
3742 #endif
3743 curwin->w_set_curswant = TRUE;
3745 else
3746 beginline(BL_SOL | BL_FIX);
3748 else /* no line number, go to last line in Ex mode */
3750 if (exmode_active)
3751 curwin->w_cursor.lnum = curbuf->b_ml.ml_line_count;
3752 beginline(BL_WHITE | BL_FIX);
3756 #ifdef FEAT_WINDOWS
3757 /* Check if cursors in other windows on the same buffer are still valid */
3758 check_lnums(FALSE);
3759 #endif
3762 * Did not read the file, need to show some info about the file.
3763 * Do this after setting the cursor.
3765 if (oldbuf
3766 #ifdef FEAT_AUTOCMD
3767 && !auto_buf
3768 #endif
3771 int msg_scroll_save = msg_scroll;
3773 /* Obey the 'O' flag in 'cpoptions': overwrite any previous file
3774 * message. */
3775 if (shortmess(SHM_OVERALL) && !exiting && p_verbose == 0)
3776 msg_scroll = FALSE;
3777 if (!msg_scroll) /* wait a bit when overwriting an error msg */
3778 check_for_delay(FALSE);
3779 msg_start();
3780 msg_scroll = msg_scroll_save;
3781 msg_scrolled_ign = TRUE;
3783 fileinfo(FALSE, TRUE, FALSE);
3785 msg_scrolled_ign = FALSE;
3788 if (command != NULL)
3789 do_cmdline(command, NULL, NULL, DOCMD_VERBOSE);
3791 #ifdef FEAT_KEYMAP
3792 if (curbuf->b_kmap_state & KEYMAP_INIT)
3793 (void)keymap_init();
3794 #endif
3796 --RedrawingDisabled;
3797 if (!skip_redraw)
3799 n = p_so;
3800 if (topline == 0 && command == NULL)
3801 p_so = 999; /* force cursor halfway the window */
3802 update_topline();
3803 #ifdef FEAT_SCROLLBIND
3804 curwin->w_scbind_pos = curwin->w_topline;
3805 #endif
3806 p_so = n;
3807 redraw_curbuf_later(NOT_VALID); /* redraw this buffer later */
3810 if (p_im)
3811 need_start_insertmode = TRUE;
3813 /* Change directories when the 'acd' option is set. */
3814 DO_AUTOCHDIR
3816 #if defined(FEAT_SUN_WORKSHOP) || defined(FEAT_NETBEANS_INTG)
3817 if (gui.in_use && curbuf->b_ffname != NULL)
3819 # ifdef FEAT_SUN_WORKSHOP
3820 if (usingSunWorkShop)
3821 workshop_file_opened((char *)curbuf->b_ffname, curbuf->b_p_ro);
3822 # endif
3823 # ifdef FEAT_NETBEANS_INTG
3824 if (usingNetbeans && ((flags & ECMD_SET_HELP) != ECMD_SET_HELP))
3825 netbeans_file_opened(curbuf);
3826 # endif
3828 #endif
3830 theend:
3831 #ifdef FEAT_AUTOCMD
3832 if (did_set_swapcommand)
3833 set_vim_var_string(VV_SWAPCOMMAND, NULL, -1);
3834 #endif
3835 #ifdef FEAT_BROWSE
3836 vim_free(browse_file);
3837 #endif
3838 vim_free(free_fname);
3839 return retval;
3842 #ifdef FEAT_AUTOCMD
3843 static void
3844 delbuf_msg(name)
3845 char_u *name;
3847 EMSG2(_("E143: Autocommands unexpectedly deleted new buffer %s"),
3848 name == NULL ? (char_u *)"" : name);
3849 vim_free(name);
3850 au_new_curbuf = NULL;
3852 #endif
3854 static int append_indent = 0; /* autoindent for first line */
3857 * ":insert" and ":append", also used by ":change"
3859 void
3860 ex_append(eap)
3861 exarg_T *eap;
3863 char_u *theline;
3864 int did_undo = FALSE;
3865 linenr_T lnum = eap->line2;
3866 int indent = 0;
3867 char_u *p;
3868 int vcol;
3869 int empty = (curbuf->b_ml.ml_flags & ML_EMPTY);
3871 /* the ! flag toggles autoindent */
3872 if (eap->forceit)
3873 curbuf->b_p_ai = !curbuf->b_p_ai;
3875 /* First autoindent comes from the line we start on */
3876 if (eap->cmdidx != CMD_change && curbuf->b_p_ai && lnum > 0)
3877 append_indent = get_indent_lnum(lnum);
3879 if (eap->cmdidx != CMD_append)
3880 --lnum;
3882 /* when the buffer is empty append to line 0 and delete the dummy line */
3883 if (empty && lnum == 1)
3884 lnum = 0;
3886 State = INSERT; /* behave like in Insert mode */
3887 if (curbuf->b_p_iminsert == B_IMODE_LMAP)
3888 State |= LANGMAP;
3890 for (;;)
3892 msg_scroll = TRUE;
3893 need_wait_return = FALSE;
3894 if (curbuf->b_p_ai)
3896 if (append_indent >= 0)
3898 indent = append_indent;
3899 append_indent = -1;
3901 else if (lnum > 0)
3902 indent = get_indent_lnum(lnum);
3904 ex_keep_indent = FALSE;
3905 if (eap->getline == NULL)
3907 /* No getline() function, use the lines that follow. This ends
3908 * when there is no more. */
3909 if (eap->nextcmd == NULL || *eap->nextcmd == NUL)
3910 break;
3911 p = vim_strchr(eap->nextcmd, NL);
3912 if (p == NULL)
3913 p = eap->nextcmd + STRLEN(eap->nextcmd);
3914 theline = vim_strnsave(eap->nextcmd, (int)(p - eap->nextcmd));
3915 if (*p != NUL)
3916 ++p;
3917 eap->nextcmd = p;
3919 else
3920 theline = eap->getline(
3921 #ifdef FEAT_EVAL
3922 eap->cstack->cs_looplevel > 0 ? -1 :
3923 #endif
3924 NUL, eap->cookie, indent);
3925 lines_left = Rows - 1;
3926 if (theline == NULL)
3927 break;
3929 /* Using ^ CTRL-D in getexmodeline() makes us repeat the indent. */
3930 if (ex_keep_indent)
3931 append_indent = indent;
3933 /* Look for the "." after automatic indent. */
3934 vcol = 0;
3935 for (p = theline; indent > vcol; ++p)
3937 if (*p == ' ')
3938 ++vcol;
3939 else if (*p == TAB)
3940 vcol += 8 - vcol % 8;
3941 else
3942 break;
3944 if ((p[0] == '.' && p[1] == NUL)
3945 || (!did_undo && u_save(lnum, lnum + 1 + (empty ? 1 : 0))
3946 == FAIL))
3948 vim_free(theline);
3949 break;
3952 /* don't use autoindent if nothing was typed. */
3953 if (p[0] == NUL)
3954 theline[0] = NUL;
3956 did_undo = TRUE;
3957 ml_append(lnum, theline, (colnr_T)0, FALSE);
3958 appended_lines_mark(lnum, 1L);
3960 vim_free(theline);
3961 ++lnum;
3963 if (empty)
3965 ml_delete(2L, FALSE);
3966 empty = FALSE;
3969 State = NORMAL;
3971 if (eap->forceit)
3972 curbuf->b_p_ai = !curbuf->b_p_ai;
3974 /* "start" is set to eap->line2+1 unless that position is invalid (when
3975 * eap->line2 pointed to the end of the buffer and nothing was appended)
3976 * "end" is set to lnum when something has been appended, otherwise
3977 * it is the same than "start" -- Acevedo */
3978 curbuf->b_op_start.lnum = (eap->line2 < curbuf->b_ml.ml_line_count) ?
3979 eap->line2 + 1 : curbuf->b_ml.ml_line_count;
3980 if (eap->cmdidx != CMD_append)
3981 --curbuf->b_op_start.lnum;
3982 curbuf->b_op_end.lnum = (eap->line2 < lnum)
3983 ? lnum : curbuf->b_op_start.lnum;
3984 curbuf->b_op_start.col = curbuf->b_op_end.col = 0;
3985 curwin->w_cursor.lnum = lnum;
3986 check_cursor_lnum();
3987 beginline(BL_SOL | BL_FIX);
3989 need_wait_return = FALSE; /* don't use wait_return() now */
3990 ex_no_reprint = TRUE;
3994 * ":change"
3996 void
3997 ex_change(eap)
3998 exarg_T *eap;
4000 linenr_T lnum;
4002 if (eap->line2 >= eap->line1
4003 && u_save(eap->line1 - 1, eap->line2 + 1) == FAIL)
4004 return;
4006 /* the ! flag toggles autoindent */
4007 if (eap->forceit ? !curbuf->b_p_ai : curbuf->b_p_ai)
4008 append_indent = get_indent_lnum(eap->line1);
4010 for (lnum = eap->line2; lnum >= eap->line1; --lnum)
4012 if (curbuf->b_ml.ml_flags & ML_EMPTY) /* nothing to delete */
4013 break;
4014 ml_delete(eap->line1, FALSE);
4017 /* make sure the cursor is not beyond the end of the file now */
4018 check_cursor_lnum();
4019 deleted_lines_mark(eap->line1, (long)(eap->line2 - lnum));
4021 /* ":append" on the line above the deleted lines. */
4022 eap->line2 = eap->line1;
4023 ex_append(eap);
4026 void
4027 ex_z(eap)
4028 exarg_T *eap;
4030 char_u *x;
4031 int bigness;
4032 char_u *kind;
4033 int minus = 0;
4034 linenr_T start, end, curs, i;
4035 int j;
4036 linenr_T lnum = eap->line2;
4038 /* Vi compatible: ":z!" uses display height, without a count uses
4039 * 'scroll' */
4040 if (eap->forceit)
4041 bigness = curwin->w_height;
4042 else if (firstwin == lastwin)
4043 bigness = curwin->w_p_scr * 2;
4044 #ifdef FEAT_WINDOWS
4045 else
4046 bigness = curwin->w_height - 3;
4047 #endif
4048 if (bigness < 1)
4049 bigness = 1;
4051 x = eap->arg;
4052 kind = x;
4053 if (*kind == '-' || *kind == '+' || *kind == '='
4054 || *kind == '^' || *kind == '.')
4055 ++x;
4056 while (*x == '-' || *x == '+')
4057 ++x;
4059 if (*x != 0)
4061 if (!VIM_ISDIGIT(*x))
4063 EMSG(_("E144: non-numeric argument to :z"));
4064 return;
4066 else
4068 bigness = atoi((char *)x);
4069 p_window = bigness;
4070 if (*kind == '=')
4071 bigness += 2;
4075 /* the number of '-' and '+' multiplies the distance */
4076 if (*kind == '-' || *kind == '+')
4077 for (x = kind + 1; *x == *kind; ++x)
4080 switch (*kind)
4082 case '-':
4083 start = lnum - bigness * (linenr_T)(x - kind);
4084 end = start + bigness;
4085 curs = end;
4086 break;
4088 case '=':
4089 start = lnum - (bigness + 1) / 2 + 1;
4090 end = lnum + (bigness + 1) / 2 - 1;
4091 curs = lnum;
4092 minus = 1;
4093 break;
4095 case '^':
4096 start = lnum - bigness * 2;
4097 end = lnum - bigness;
4098 curs = lnum - bigness;
4099 break;
4101 case '.':
4102 start = lnum - (bigness + 1) / 2 + 1;
4103 end = lnum + (bigness + 1) / 2 - 1;
4104 curs = end;
4105 break;
4107 default: /* '+' */
4108 start = lnum;
4109 if (*kind == '+')
4110 start += bigness * (linenr_T)(x - kind - 1) + 1;
4111 else if (eap->addr_count == 0)
4112 ++start;
4113 end = start + bigness - 1;
4114 curs = end;
4115 break;
4118 if (start < 1)
4119 start = 1;
4121 if (end > curbuf->b_ml.ml_line_count)
4122 end = curbuf->b_ml.ml_line_count;
4124 if (curs > curbuf->b_ml.ml_line_count)
4125 curs = curbuf->b_ml.ml_line_count;
4127 for (i = start; i <= end; i++)
4129 if (minus && i == lnum)
4131 msg_putchar('\n');
4133 for (j = 1; j < Columns; j++)
4134 msg_putchar('-');
4137 print_line(i, eap->flags & EXFLAG_NR, eap->flags & EXFLAG_LIST);
4139 if (minus && i == lnum)
4141 msg_putchar('\n');
4143 for (j = 1; j < Columns; j++)
4144 msg_putchar('-');
4148 curwin->w_cursor.lnum = curs;
4149 ex_no_reprint = TRUE;
4153 * Check if the restricted flag is set.
4154 * If so, give an error message and return TRUE.
4155 * Otherwise, return FALSE.
4158 check_restricted()
4160 if (restricted)
4162 EMSG(_("E145: Shell commands not allowed in rvim"));
4163 return TRUE;
4165 return FALSE;
4169 * Check if the secure flag is set (.exrc or .vimrc in current directory).
4170 * If so, give an error message and return TRUE.
4171 * Otherwise, return FALSE.
4174 check_secure()
4176 if (secure)
4178 secure = 2;
4179 EMSG(_(e_curdir));
4180 return TRUE;
4182 #ifdef HAVE_SANDBOX
4184 * In the sandbox more things are not allowed, including the things
4185 * disallowed in secure mode.
4187 if (sandbox != 0)
4189 EMSG(_(e_sandbox));
4190 return TRUE;
4192 #endif
4193 return FALSE;
4196 static char_u *old_sub = NULL; /* previous substitute pattern */
4197 static int global_need_beginline; /* call beginline() after ":g" */
4199 /* do_sub()
4201 * Perform a substitution from line eap->line1 to line eap->line2 using the
4202 * command pointed to by eap->arg which should be of the form:
4204 * /pattern/substitution/{flags}
4206 * The usual escapes are supported as described in the regexp docs.
4208 void
4209 do_sub(eap)
4210 exarg_T *eap;
4212 linenr_T lnum;
4213 long i = 0;
4214 regmmatch_T regmatch;
4215 static int do_all = FALSE; /* do multiple substitutions per line */
4216 static int do_ask = FALSE; /* ask for confirmation */
4217 static int do_count = FALSE; /* count only */
4218 static int do_error = TRUE; /* if false, ignore errors */
4219 static int do_print = FALSE; /* print last line with subs. */
4220 static int do_list = FALSE; /* list last line with subs. */
4221 static int do_number = FALSE; /* list last line with line nr*/
4222 static int do_ic = 0; /* ignore case flag */
4223 char_u *pat = NULL, *sub = NULL; /* init for GCC */
4224 int delimiter;
4225 int sublen;
4226 int got_quit = FALSE;
4227 int got_match = FALSE;
4228 int temp;
4229 int which_pat;
4230 char_u *cmd;
4231 int save_State;
4232 linenr_T first_line = 0; /* first changed line */
4233 linenr_T last_line= 0; /* below last changed line AFTER the
4234 * change */
4235 linenr_T old_line_count = curbuf->b_ml.ml_line_count;
4236 linenr_T line2;
4237 long nmatch; /* number of lines in match */
4238 char_u *sub_firstline; /* allocated copy of first sub line */
4239 int endcolumn = FALSE; /* cursor in last column when done */
4240 pos_T old_cursor = curwin->w_cursor;
4242 cmd = eap->arg;
4243 if (!global_busy)
4245 sub_nsubs = 0;
4246 sub_nlines = 0;
4249 if (eap->cmdidx == CMD_tilde)
4250 which_pat = RE_LAST; /* use last used regexp */
4251 else
4252 which_pat = RE_SUBST; /* use last substitute regexp */
4254 /* new pattern and substitution */
4255 if (eap->cmd[0] == 's' && *cmd != NUL && !vim_iswhite(*cmd)
4256 && vim_strchr((char_u *)"0123456789cegriIp|\"", *cmd) == NULL)
4258 /* don't accept alphanumeric for separator */
4259 if (isalpha(*cmd))
4261 EMSG(_("E146: Regular expressions can't be delimited by letters"));
4262 return;
4265 * undocumented vi feature:
4266 * "\/sub/" and "\?sub?" use last used search pattern (almost like
4267 * //sub/r). "\&sub&" use last substitute pattern (like //sub/).
4269 if (*cmd == '\\')
4271 ++cmd;
4272 if (vim_strchr((char_u *)"/?&", *cmd) == NULL)
4274 EMSG(_(e_backslash));
4275 return;
4277 if (*cmd != '&')
4278 which_pat = RE_SEARCH; /* use last '/' pattern */
4279 pat = (char_u *)""; /* empty search pattern */
4280 delimiter = *cmd++; /* remember delimiter character */
4282 else /* find the end of the regexp */
4284 #ifdef FEAT_FKMAP /* reverse the flow of the Farsi characters */
4285 if (p_altkeymap && curwin->w_p_rl)
4286 lrF_sub(cmd);
4287 #endif
4288 which_pat = RE_LAST; /* use last used regexp */
4289 delimiter = *cmd++; /* remember delimiter character */
4290 pat = cmd; /* remember start of search pat */
4291 cmd = skip_regexp(cmd, delimiter, p_magic, &eap->arg);
4292 if (cmd[0] == delimiter) /* end delimiter found */
4293 *cmd++ = NUL; /* replace it with a NUL */
4297 * Small incompatibility: vi sees '\n' as end of the command, but in
4298 * Vim we want to use '\n' to find/substitute a NUL.
4300 sub = cmd; /* remember the start of the substitution */
4302 while (cmd[0])
4304 if (cmd[0] == delimiter) /* end delimiter found */
4306 *cmd++ = NUL; /* replace it with a NUL */
4307 break;
4309 if (cmd[0] == '\\' && cmd[1] != 0) /* skip escaped characters */
4310 ++cmd;
4311 mb_ptr_adv(cmd);
4314 if (!eap->skip)
4316 /* In POSIX vi ":s/pat/%/" uses the previous subst. string. */
4317 if (STRCMP(sub, "%") == 0
4318 && vim_strchr(p_cpo, CPO_SUBPERCENT) != NULL)
4320 if (old_sub == NULL) /* there is no previous command */
4322 EMSG(_(e_nopresub));
4323 return;
4325 sub = old_sub;
4327 else
4329 vim_free(old_sub);
4330 old_sub = vim_strsave(sub);
4334 else if (!eap->skip) /* use previous pattern and substitution */
4336 if (old_sub == NULL) /* there is no previous command */
4338 EMSG(_(e_nopresub));
4339 return;
4341 pat = NULL; /* search_regcomp() will use previous pattern */
4342 sub = old_sub;
4344 /* Vi compatibility quirk: repeating with ":s" keeps the cursor in the
4345 * last column after using "$". */
4346 endcolumn = (curwin->w_curswant == MAXCOL);
4350 * Find trailing options. When '&' is used, keep old options.
4352 if (*cmd == '&')
4353 ++cmd;
4354 else
4356 if (!p_ed)
4358 if (p_gd) /* default is global on */
4359 do_all = TRUE;
4360 else
4361 do_all = FALSE;
4362 do_ask = FALSE;
4364 do_error = TRUE;
4365 do_print = FALSE;
4366 do_count = FALSE;
4367 do_number = FALSE;
4368 do_ic = 0;
4370 while (*cmd)
4373 * Note that 'g' and 'c' are always inverted, also when p_ed is off.
4374 * 'r' is never inverted.
4376 if (*cmd == 'g')
4377 do_all = !do_all;
4378 else if (*cmd == 'c')
4379 do_ask = !do_ask;
4380 else if (*cmd == 'n')
4381 do_count = TRUE;
4382 else if (*cmd == 'e')
4383 do_error = !do_error;
4384 else if (*cmd == 'r') /* use last used regexp */
4385 which_pat = RE_LAST;
4386 else if (*cmd == 'p')
4387 do_print = TRUE;
4388 else if (*cmd == '#')
4390 do_print = TRUE;
4391 do_number = TRUE;
4393 else if (*cmd == 'l')
4395 do_print = TRUE;
4396 do_list = TRUE;
4398 else if (*cmd == 'i') /* ignore case */
4399 do_ic = 'i';
4400 else if (*cmd == 'I') /* don't ignore case */
4401 do_ic = 'I';
4402 else
4403 break;
4404 ++cmd;
4406 if (do_count)
4407 do_ask = FALSE;
4410 * check for a trailing count
4412 cmd = skipwhite(cmd);
4413 if (VIM_ISDIGIT(*cmd))
4415 i = getdigits(&cmd);
4416 if (i <= 0 && !eap->skip && do_error)
4418 EMSG(_(e_zerocount));
4419 return;
4421 eap->line1 = eap->line2;
4422 eap->line2 += i - 1;
4423 if (eap->line2 > curbuf->b_ml.ml_line_count)
4424 eap->line2 = curbuf->b_ml.ml_line_count;
4428 * check for trailing command or garbage
4430 cmd = skipwhite(cmd);
4431 if (*cmd && *cmd != '"') /* if not end-of-line or comment */
4433 eap->nextcmd = check_nextcmd(cmd);
4434 if (eap->nextcmd == NULL)
4436 EMSG(_(e_trailing));
4437 return;
4441 if (eap->skip) /* not executing commands, only parsing */
4442 return;
4444 if (!do_count && !curbuf->b_p_ma)
4446 /* Substitution is not allowed in non-'modifiable' buffer */
4447 EMSG(_(e_modifiable));
4448 return;
4451 if (search_regcomp(pat, RE_SUBST, which_pat, SEARCH_HIS, &regmatch) == FAIL)
4453 if (do_error)
4454 EMSG(_(e_invcmd));
4455 return;
4458 /* the 'i' or 'I' flag overrules 'ignorecase' and 'smartcase' */
4459 if (do_ic == 'i')
4460 regmatch.rmm_ic = TRUE;
4461 else if (do_ic == 'I')
4462 regmatch.rmm_ic = FALSE;
4464 sub_firstline = NULL;
4467 * ~ in the substitute pattern is replaced with the old pattern.
4468 * We do it here once to avoid it to be replaced over and over again.
4469 * But don't do it when it starts with "\=", then it's an expression.
4471 if (!(sub[0] == '\\' && sub[1] == '='))
4472 sub = regtilde(sub, p_magic);
4475 * Check for a match on each line.
4477 line2 = eap->line2;
4478 for (lnum = eap->line1; lnum <= line2 && !(got_quit
4479 #if defined(FEAT_EVAL) && defined(FEAT_AUTOCMD)
4480 || aborting()
4481 #endif
4482 ); ++lnum)
4484 nmatch = vim_regexec_multi(&regmatch, curwin, curbuf, lnum,
4485 (colnr_T)0, NULL);
4486 if (nmatch)
4488 colnr_T copycol;
4489 colnr_T matchcol;
4490 colnr_T prev_matchcol = MAXCOL;
4491 char_u *new_end, *new_start = NULL;
4492 unsigned new_start_len = 0;
4493 char_u *p1;
4494 int did_sub = FALSE;
4495 int lastone;
4496 int len, copy_len, needed_len;
4497 long nmatch_tl = 0; /* nr of lines matched below lnum */
4498 int do_again; /* do it again after joining lines */
4499 int skip_match = FALSE;
4500 linenr_T sub_firstlnum; /* nr of first sub line */
4503 * The new text is build up step by step, to avoid too much
4504 * copying. There are these pieces:
4505 * sub_firstline The old text, unmodified.
4506 * copycol Column in the old text where we started
4507 * looking for a match; from here old text still
4508 * needs to be copied to the new text.
4509 * matchcol Column number of the old text where to look
4510 * for the next match. It's just after the
4511 * previous match or one further.
4512 * prev_matchcol Column just after the previous match (if any).
4513 * Mostly equal to matchcol, except for the first
4514 * match and after skipping an empty match.
4515 * regmatch.*pos Where the pattern matched in the old text.
4516 * new_start The new text, all that has been produced so
4517 * far.
4518 * new_end The new text, where to append new text.
4520 * lnum The line number where we found the start of
4521 * the match. Can be below the line we searched
4522 * when there is a \n before a \zs in the
4523 * pattern.
4524 * sub_firstlnum The line number in the buffer where to look
4525 * for a match. Can be different from "lnum"
4526 * when the pattern or substitute string contains
4527 * line breaks.
4529 * Special situations:
4530 * - When the substitute string contains a line break, the part up
4531 * to the line break is inserted in the text, but the copy of
4532 * the original line is kept. "sub_firstlnum" is adjusted for
4533 * the inserted lines.
4534 * - When the matched pattern contains a line break, the old line
4535 * is taken from the line at the end of the pattern. The lines
4536 * in the match are deleted later, "sub_firstlnum" is adjusted
4537 * accordingly.
4539 * The new text is built up in new_start[]. It has some extra
4540 * room to avoid using alloc()/free() too often. new_start_len is
4541 * the length of the allocated memory at new_start.
4543 * Make a copy of the old line, so it won't be taken away when
4544 * updating the screen or handling a multi-line match. The "old_"
4545 * pointers point into this copy.
4547 sub_firstlnum = lnum;
4548 copycol = 0;
4549 matchcol = 0;
4551 /* At first match, remember current cursor position. */
4552 if (!got_match)
4554 setpcmark();
4555 got_match = TRUE;
4559 * Loop until nothing more to replace in this line.
4560 * 1. Handle match with empty string.
4561 * 2. If do_ask is set, ask for confirmation.
4562 * 3. substitute the string.
4563 * 4. if do_all is set, find next match
4564 * 5. break if there isn't another match in this line
4566 for (;;)
4568 /* Advance "lnum" to the line where the match starts. The
4569 * match does not start in the first line when there is a line
4570 * break before \zs. */
4571 if (regmatch.startpos[0].lnum > 0)
4573 lnum += regmatch.startpos[0].lnum;
4574 sub_firstlnum += regmatch.startpos[0].lnum;
4575 nmatch -= regmatch.startpos[0].lnum;
4576 vim_free(sub_firstline);
4577 sub_firstline = NULL;
4580 if (sub_firstline == NULL)
4582 sub_firstline = vim_strsave(ml_get(sub_firstlnum));
4583 if (sub_firstline == NULL)
4585 vim_free(new_start);
4586 goto outofmem;
4590 /* Save the line number of the last change for the final
4591 * cursor position (just like Vi). */
4592 curwin->w_cursor.lnum = lnum;
4593 do_again = FALSE;
4596 * 1. Match empty string does not count, except for first
4597 * match. This reproduces the strange vi behaviour.
4598 * This also catches endless loops.
4600 if (matchcol == prev_matchcol
4601 && regmatch.endpos[0].lnum == 0
4602 && matchcol == regmatch.endpos[0].col)
4604 if (sub_firstline[matchcol] == NUL)
4605 /* We already were at the end of the line. Don't look
4606 * for a match in this line again. */
4607 skip_match = TRUE;
4608 else
4609 ++matchcol; /* search for a match at next column */
4610 goto skip;
4613 /* Normally we continue searching for a match just after the
4614 * previous match. */
4615 matchcol = regmatch.endpos[0].col;
4616 prev_matchcol = matchcol;
4619 * 2. If do_count is set only increase the counter.
4620 * If do_ask is set, ask for confirmation.
4622 if (do_count)
4624 /* For a multi-line match, put matchcol at the NUL at
4625 * the end of the line and set nmatch to one, so that
4626 * we continue looking for a match on the next line.
4627 * Avoids that ":s/\nB\@=//gc" get stuck. */
4628 if (nmatch > 1)
4630 matchcol = (colnr_T)STRLEN(sub_firstline);
4631 nmatch = 1;
4632 skip_match = TRUE;
4634 sub_nsubs++;
4635 did_sub = TRUE;
4636 goto skip;
4639 if (do_ask)
4641 int typed = 0;
4643 /* change State to CONFIRM, so that the mouse works
4644 * properly */
4645 save_State = State;
4646 State = CONFIRM;
4647 #ifdef FEAT_MOUSE
4648 setmouse(); /* disable mouse in xterm */
4649 #endif
4650 curwin->w_cursor.col = regmatch.startpos[0].col;
4652 /* When 'cpoptions' contains "u" don't sync undo when
4653 * asking for confirmation. */
4654 if (vim_strchr(p_cpo, CPO_UNDO) != NULL)
4655 ++no_u_sync;
4658 * Loop until 'y', 'n', 'q', CTRL-E or CTRL-Y typed.
4660 while (do_ask)
4662 if (exmode_active)
4664 char_u *resp;
4665 colnr_T sc, ec;
4667 print_line_no_prefix(lnum, FALSE, FALSE);
4669 getvcol(curwin, &curwin->w_cursor, &sc, NULL, NULL);
4670 curwin->w_cursor.col = regmatch.endpos[0].col - 1;
4671 getvcol(curwin, &curwin->w_cursor, NULL, NULL, &ec);
4672 msg_start();
4673 for (i = 0; i < (long)sc; ++i)
4674 msg_putchar(' ');
4675 for ( ; i <= (long)ec; ++i)
4676 msg_putchar('^');
4678 resp = getexmodeline('?', NULL, 0);
4679 if (resp != NULL)
4681 typed = *resp;
4682 vim_free(resp);
4685 else
4687 #ifdef FEAT_FOLDING
4688 int save_p_fen = curwin->w_p_fen;
4690 curwin->w_p_fen = FALSE;
4691 #endif
4692 /* Invert the matched string.
4693 * Remove the inversion afterwards. */
4694 temp = RedrawingDisabled;
4695 RedrawingDisabled = 0;
4697 search_match_lines = regmatch.endpos[0].lnum
4698 - regmatch.startpos[0].lnum;
4699 search_match_endcol = regmatch.endpos[0].col;
4700 highlight_match = TRUE;
4702 update_topline();
4703 validate_cursor();
4704 update_screen(SOME_VALID);
4705 highlight_match = FALSE;
4706 redraw_later(SOME_VALID);
4708 #ifdef FEAT_FOLDING
4709 curwin->w_p_fen = save_p_fen;
4710 #endif
4711 if (msg_row == Rows - 1)
4712 msg_didout = FALSE; /* avoid a scroll-up */
4713 msg_starthere();
4714 i = msg_scroll;
4715 msg_scroll = 0; /* truncate msg when
4716 needed */
4717 msg_no_more = TRUE;
4718 /* write message same highlighting as for
4719 * wait_return */
4720 smsg_attr(hl_attr(HLF_R),
4721 (char_u *)_("replace with %s (y/n/a/q/l/^E/^Y)?"), sub);
4722 msg_no_more = FALSE;
4723 msg_scroll = i;
4724 showruler(TRUE);
4725 windgoto(msg_row, msg_col);
4726 RedrawingDisabled = temp;
4728 #ifdef USE_ON_FLY_SCROLL
4729 dont_scroll = FALSE; /* allow scrolling here */
4730 #endif
4731 ++no_mapping; /* don't map this key */
4732 ++allow_keys; /* allow special keys */
4733 typed = plain_vgetc();
4734 --allow_keys;
4735 --no_mapping;
4737 /* clear the question */
4738 msg_didout = FALSE; /* don't scroll up */
4739 msg_col = 0;
4740 gotocmdline(TRUE);
4743 need_wait_return = FALSE; /* no hit-return prompt */
4744 if (typed == 'q' || typed == ESC || typed == Ctrl_C
4745 #ifdef UNIX
4746 || typed == intr_char
4747 #endif
4750 got_quit = TRUE;
4751 break;
4753 if (typed == 'n')
4754 break;
4755 if (typed == 'y')
4756 break;
4757 if (typed == 'l')
4759 /* last: replace and then stop */
4760 do_all = FALSE;
4761 line2 = lnum;
4762 break;
4764 if (typed == 'a')
4766 do_ask = FALSE;
4767 break;
4769 #ifdef FEAT_INS_EXPAND
4770 if (typed == Ctrl_E)
4771 scrollup_clamp();
4772 else if (typed == Ctrl_Y)
4773 scrolldown_clamp();
4774 #endif
4776 State = save_State;
4777 #ifdef FEAT_MOUSE
4778 setmouse();
4779 #endif
4780 if (vim_strchr(p_cpo, CPO_UNDO) != NULL)
4781 --no_u_sync;
4783 if (typed == 'n')
4785 /* For a multi-line match, put matchcol at the NUL at
4786 * the end of the line and set nmatch to one, so that
4787 * we continue looking for a match on the next line.
4788 * Avoids that ":%s/\nB\@=//gc" and ":%s/\n/,\r/gc"
4789 * get stuck when pressing 'n'. */
4790 if (nmatch > 1)
4792 matchcol = (colnr_T)STRLEN(sub_firstline);
4793 skip_match = TRUE;
4795 goto skip;
4797 if (got_quit)
4798 break;
4801 /* Move the cursor to the start of the match, so that we can
4802 * use "\=col("."). */
4803 curwin->w_cursor.col = regmatch.startpos[0].col;
4806 * 3. substitute the string.
4808 /* get length of substitution part */
4809 sublen = vim_regsub_multi(&regmatch,
4810 sub_firstlnum - regmatch.startpos[0].lnum,
4811 sub, sub_firstline, FALSE, p_magic, TRUE);
4813 /* When the match included the "$" of the last line it may
4814 * go beyond the last line of the buffer. */
4815 if (nmatch > curbuf->b_ml.ml_line_count - sub_firstlnum + 1)
4817 nmatch = curbuf->b_ml.ml_line_count - sub_firstlnum + 1;
4818 skip_match = TRUE;
4821 /* Need room for:
4822 * - result so far in new_start (not for first sub in line)
4823 * - original text up to match
4824 * - length of substituted part
4825 * - original text after match
4827 if (nmatch == 1)
4828 p1 = sub_firstline;
4829 else
4831 p1 = ml_get(sub_firstlnum + nmatch - 1);
4832 nmatch_tl += nmatch - 1;
4834 copy_len = regmatch.startpos[0].col - copycol;
4835 needed_len = copy_len + ((unsigned)STRLEN(p1)
4836 - regmatch.endpos[0].col) + sublen + 1;
4837 if (new_start == NULL)
4840 * Get some space for a temporary buffer to do the
4841 * substitution into (and some extra space to avoid
4842 * too many calls to alloc()/free()).
4844 new_start_len = needed_len + 50;
4845 if ((new_start = alloc_check(new_start_len)) == NULL)
4846 goto outofmem;
4847 *new_start = NUL;
4848 new_end = new_start;
4850 else
4853 * Check if the temporary buffer is long enough to do the
4854 * substitution into. If not, make it larger (with a bit
4855 * extra to avoid too many calls to alloc()/free()).
4857 len = (unsigned)STRLEN(new_start);
4858 needed_len += len;
4859 if (needed_len > (int)new_start_len)
4861 new_start_len = needed_len + 50;
4862 if ((p1 = alloc_check(new_start_len)) == NULL)
4864 vim_free(new_start);
4865 goto outofmem;
4867 mch_memmove(p1, new_start, (size_t)(len + 1));
4868 vim_free(new_start);
4869 new_start = p1;
4871 new_end = new_start + len;
4875 * copy the text up to the part that matched
4877 mch_memmove(new_end, sub_firstline + copycol, (size_t)copy_len);
4878 new_end += copy_len;
4880 (void)vim_regsub_multi(&regmatch,
4881 sub_firstlnum - regmatch.startpos[0].lnum,
4882 sub, new_end, TRUE, p_magic, TRUE);
4883 sub_nsubs++;
4884 did_sub = TRUE;
4886 /* Move the cursor to the start of the line, to avoid that it
4887 * is beyond the end of the line after the substitution. */
4888 curwin->w_cursor.col = 0;
4890 /* For a multi-line match, make a copy of the last matched
4891 * line and continue in that one. */
4892 if (nmatch > 1)
4894 sub_firstlnum += nmatch - 1;
4895 vim_free(sub_firstline);
4896 sub_firstline = vim_strsave(ml_get(sub_firstlnum));
4897 /* When going beyond the last line, stop substituting. */
4898 if (sub_firstlnum <= line2)
4899 do_again = TRUE;
4900 else
4901 do_all = FALSE;
4904 /* Remember next character to be copied. */
4905 copycol = regmatch.endpos[0].col;
4907 if (skip_match)
4909 /* Already hit end of the buffer, sub_firstlnum is one
4910 * less than what it ought to be. */
4911 vim_free(sub_firstline);
4912 sub_firstline = vim_strsave((char_u *)"");
4913 copycol = 0;
4917 * Now the trick is to replace CTRL-M chars with a real line
4918 * break. This would make it impossible to insert a CTRL-M in
4919 * the text. The line break can be avoided by preceding the
4920 * CTRL-M with a backslash. To be able to insert a backslash,
4921 * they must be doubled in the string and are halved here.
4922 * That is Vi compatible.
4924 for (p1 = new_end; *p1; ++p1)
4926 if (p1[0] == '\\' && p1[1] != NUL) /* remove backslash */
4927 STRMOVE(p1, p1 + 1);
4928 else if (*p1 == CAR)
4930 if (u_inssub(lnum) == OK) /* prepare for undo */
4932 *p1 = NUL; /* truncate up to the CR */
4933 ml_append(lnum - 1, new_start,
4934 (colnr_T)(p1 - new_start + 1), FALSE);
4935 mark_adjust(lnum + 1, (linenr_T)MAXLNUM, 1L, 0L);
4936 if (do_ask)
4937 appended_lines(lnum - 1, 1L);
4938 else
4940 if (first_line == 0)
4941 first_line = lnum;
4942 last_line = lnum + 1;
4944 /* All line numbers increase. */
4945 ++sub_firstlnum;
4946 ++lnum;
4947 ++line2;
4948 /* move the cursor to the new line, like Vi */
4949 ++curwin->w_cursor.lnum;
4950 /* copy the rest */
4951 STRMOVE(new_start, p1 + 1);
4952 p1 = new_start - 1;
4955 #ifdef FEAT_MBYTE
4956 else if (has_mbyte)
4957 p1 += (*mb_ptr2len)(p1) - 1;
4958 #endif
4962 * 4. If do_all is set, find next match.
4963 * Prevent endless loop with patterns that match empty
4964 * strings, e.g. :s/$/pat/g or :s/[a-z]* /(&)/g.
4965 * But ":s/\n/#/" is OK.
4967 skip:
4968 /* We already know that we did the last subst when we are at
4969 * the end of the line, except that a pattern like
4970 * "bar\|\nfoo" may match at the NUL. "lnum" can be below
4971 * "line2" when there is a \zs in the pattern after a line
4972 * break. */
4973 lastone = (skip_match
4974 || got_int
4975 || got_quit
4976 || lnum > line2
4977 || !(do_all || do_again)
4978 || (sub_firstline[matchcol] == NUL && nmatch <= 1
4979 && !re_multiline(regmatch.regprog)));
4980 nmatch = -1;
4983 * Replace the line in the buffer when needed. This is
4984 * skipped when there are more matches.
4985 * The check for nmatch_tl is needed for when multi-line
4986 * matching must replace the lines before trying to do another
4987 * match, otherwise "\@<=" won't work.
4988 * When asking the user we like to show the already replaced
4989 * text, but don't do it when "\<@=" or "\<@!" is used, it
4990 * changes what matches.
4991 * When the match starts below where we start searching also
4992 * need to replace the line first (using \zs after \n).
4994 if (lastone
4995 || (do_ask && !re_lookbehind(regmatch.regprog))
4996 || nmatch_tl > 0
4997 || (nmatch = vim_regexec_multi(&regmatch, curwin,
4998 curbuf, sub_firstlnum,
4999 matchcol, NULL)) == 0
5000 || regmatch.startpos[0].lnum > 0)
5002 if (new_start != NULL)
5005 * Copy the rest of the line, that didn't match.
5006 * "matchcol" has to be adjusted, we use the end of
5007 * the line as reference, because the substitute may
5008 * have changed the number of characters. Same for
5009 * "prev_matchcol".
5011 STRCAT(new_start, sub_firstline + copycol);
5012 matchcol = (colnr_T)STRLEN(sub_firstline) - matchcol;
5013 prev_matchcol = (colnr_T)STRLEN(sub_firstline)
5014 - prev_matchcol;
5016 if (u_savesub(lnum) != OK)
5017 break;
5018 ml_replace(lnum, new_start, TRUE);
5020 if (nmatch_tl > 0)
5023 * Matched lines have now been substituted and are
5024 * useless, delete them. The part after the match
5025 * has been appended to new_start, we don't need
5026 * it in the buffer.
5028 ++lnum;
5029 if (u_savedel(lnum, nmatch_tl) != OK)
5030 break;
5031 for (i = 0; i < nmatch_tl; ++i)
5032 ml_delete(lnum, (int)FALSE);
5033 mark_adjust(lnum, lnum + nmatch_tl - 1,
5034 (long)MAXLNUM, -nmatch_tl);
5035 if (do_ask)
5036 deleted_lines(lnum, nmatch_tl);
5037 --lnum;
5038 line2 -= nmatch_tl; /* nr of lines decreases */
5039 nmatch_tl = 0;
5042 /* When asking, undo is saved each time, must also set
5043 * changed flag each time. */
5044 if (do_ask)
5045 changed_bytes(lnum, 0);
5046 else
5048 if (first_line == 0)
5049 first_line = lnum;
5050 last_line = lnum + 1;
5053 sub_firstlnum = lnum;
5054 vim_free(sub_firstline); /* free the temp buffer */
5055 sub_firstline = new_start;
5056 new_start = NULL;
5057 matchcol = (colnr_T)STRLEN(sub_firstline) - matchcol;
5058 prev_matchcol = (colnr_T)STRLEN(sub_firstline)
5059 - prev_matchcol;
5060 copycol = 0;
5062 if (nmatch == -1 && !lastone)
5063 nmatch = vim_regexec_multi(&regmatch, curwin, curbuf,
5064 sub_firstlnum, matchcol, NULL);
5067 * 5. break if there isn't another match in this line
5069 if (nmatch <= 0)
5071 /* If the match found didn't start where we were
5072 * searching, do the next search in the line where we
5073 * found the match. */
5074 if (nmatch == -1)
5075 lnum -= regmatch.startpos[0].lnum;
5076 break;
5080 line_breakcheck();
5083 if (did_sub)
5084 ++sub_nlines;
5085 vim_free(new_start); /* for when substitute was cancelled */
5086 vim_free(sub_firstline); /* free the copy of the original line */
5087 sub_firstline = NULL;
5090 line_breakcheck();
5093 if (first_line != 0)
5095 /* Need to subtract the number of added lines from "last_line" to get
5096 * the line number before the change (same as adding the number of
5097 * deleted lines). */
5098 i = curbuf->b_ml.ml_line_count - old_line_count;
5099 changed_lines(first_line, 0, last_line - i, i);
5102 outofmem:
5103 vim_free(sub_firstline); /* may have to free allocated copy of the line */
5105 /* ":s/pat//n" doesn't move the cursor */
5106 if (do_count)
5107 curwin->w_cursor = old_cursor;
5109 if (sub_nsubs)
5111 /* Set the '[ and '] marks. */
5112 curbuf->b_op_start.lnum = eap->line1;
5113 curbuf->b_op_end.lnum = line2;
5114 curbuf->b_op_start.col = curbuf->b_op_end.col = 0;
5116 if (!global_busy)
5118 if (endcolumn)
5119 coladvance((colnr_T)MAXCOL);
5120 else
5121 beginline(BL_WHITE | BL_FIX);
5122 if (!do_sub_msg(do_count) && do_ask)
5123 MSG("");
5125 else
5126 global_need_beginline = TRUE;
5127 if (do_print)
5128 print_line(curwin->w_cursor.lnum, do_number, do_list);
5130 else if (!global_busy)
5132 if (got_int) /* interrupted */
5133 EMSG(_(e_interr));
5134 else if (got_match) /* did find something but nothing substituted */
5135 MSG("");
5136 else if (do_error) /* nothing found */
5137 EMSG2(_(e_patnotf2), get_search_pat());
5140 vim_free(regmatch.regprog);
5144 * Give message for number of substitutions.
5145 * Can also be used after a ":global" command.
5146 * Return TRUE if a message was given.
5149 do_sub_msg(count_only)
5150 int count_only; /* used 'n' flag for ":s" */
5152 int len = 0;
5155 * Only report substitutions when:
5156 * - more than 'report' substitutions
5157 * - command was typed by user, or number of changed lines > 'report'
5158 * - giving messages is not disabled by 'lazyredraw'
5160 if (((sub_nsubs > p_report && (KeyTyped || sub_nlines > 1 || p_report < 1))
5161 || count_only)
5162 && messaging())
5164 if (got_int)
5166 STRCPY(msg_buf, _("(Interrupted) "));
5167 len = (int)STRLEN(msg_buf);
5169 if (sub_nsubs == 1)
5170 vim_snprintf((char *)msg_buf + len, sizeof(msg_buf) - len,
5171 "%s", count_only ? _("1 match") : _("1 substitution"));
5172 else
5173 vim_snprintf((char *)msg_buf + len, sizeof(msg_buf) - len,
5174 count_only ? _("%ld matches") : _("%ld substitutions"),
5175 sub_nsubs);
5176 len = (int)STRLEN(msg_buf);
5177 if (sub_nlines == 1)
5178 vim_snprintf((char *)msg_buf + len, sizeof(msg_buf) - len,
5179 "%s", _(" on 1 line"));
5180 else
5181 vim_snprintf((char *)msg_buf + len, sizeof(msg_buf) - len,
5182 _(" on %ld lines"), (long)sub_nlines);
5183 if (msg(msg_buf))
5184 /* save message to display it after redraw */
5185 set_keep_msg(msg_buf, 0);
5186 return TRUE;
5188 if (got_int)
5190 EMSG(_(e_interr));
5191 return TRUE;
5193 return FALSE;
5197 * Execute a global command of the form:
5199 * g/pattern/X : execute X on all lines where pattern matches
5200 * v/pattern/X : execute X on all lines where pattern does not match
5202 * where 'X' is an EX command
5204 * The command character (as well as the trailing slash) is optional, and
5205 * is assumed to be 'p' if missing.
5207 * This is implemented in two passes: first we scan the file for the pattern and
5208 * set a mark for each line that (not) matches. secondly we execute the command
5209 * for each line that has a mark. This is required because after deleting
5210 * lines we do not know where to search for the next match.
5212 void
5213 ex_global(eap)
5214 exarg_T *eap;
5216 linenr_T lnum; /* line number according to old situation */
5217 int ndone = 0;
5218 int type; /* first char of cmd: 'v' or 'g' */
5219 char_u *cmd; /* command argument */
5221 char_u delim; /* delimiter, normally '/' */
5222 char_u *pat;
5223 regmmatch_T regmatch;
5224 int match;
5225 int which_pat;
5227 if (global_busy)
5229 EMSG(_("E147: Cannot do :global recursive")); /* will increment global_busy */
5230 return;
5233 if (eap->forceit) /* ":global!" is like ":vglobal" */
5234 type = 'v';
5235 else
5236 type = *eap->cmd;
5237 cmd = eap->arg;
5238 which_pat = RE_LAST; /* default: use last used regexp */
5239 sub_nsubs = 0;
5240 sub_nlines = 0;
5243 * undocumented vi feature:
5244 * "\/" and "\?": use previous search pattern.
5245 * "\&": use previous substitute pattern.
5247 if (*cmd == '\\')
5249 ++cmd;
5250 if (vim_strchr((char_u *)"/?&", *cmd) == NULL)
5252 EMSG(_(e_backslash));
5253 return;
5255 if (*cmd == '&')
5256 which_pat = RE_SUBST; /* use previous substitute pattern */
5257 else
5258 which_pat = RE_SEARCH; /* use previous search pattern */
5259 ++cmd;
5260 pat = (char_u *)"";
5262 else if (*cmd == NUL)
5264 EMSG(_("E148: Regular expression missing from global"));
5265 return;
5267 else
5269 delim = *cmd; /* get the delimiter */
5270 if (delim)
5271 ++cmd; /* skip delimiter if there is one */
5272 pat = cmd; /* remember start of pattern */
5273 cmd = skip_regexp(cmd, delim, p_magic, &eap->arg);
5274 if (cmd[0] == delim) /* end delimiter found */
5275 *cmd++ = NUL; /* replace it with a NUL */
5278 #ifdef FEAT_FKMAP /* when in Farsi mode, reverse the character flow */
5279 if (p_altkeymap && curwin->w_p_rl)
5280 lrFswap(pat,0);
5281 #endif
5283 if (search_regcomp(pat, RE_BOTH, which_pat, SEARCH_HIS, &regmatch) == FAIL)
5285 EMSG(_(e_invcmd));
5286 return;
5290 * pass 1: set marks for each (not) matching line
5292 for (lnum = eap->line1; lnum <= eap->line2 && !got_int; ++lnum)
5294 /* a match on this line? */
5295 match = vim_regexec_multi(&regmatch, curwin, curbuf, lnum,
5296 (colnr_T)0, NULL);
5297 if ((type == 'g' && match) || (type == 'v' && !match))
5299 ml_setmarked(lnum);
5300 ndone++;
5302 line_breakcheck();
5306 * pass 2: execute the command for each line that has been marked
5308 if (got_int)
5309 MSG(_(e_interr));
5310 else if (ndone == 0)
5312 if (type == 'v')
5313 smsg((char_u *)_("Pattern found in every line: %s"), pat);
5314 else
5315 smsg((char_u *)_(e_patnotf2), pat);
5317 else
5318 global_exe(cmd);
5320 ml_clearmarked(); /* clear rest of the marks */
5321 vim_free(regmatch.regprog);
5325 * Execute "cmd" on lines marked with ml_setmarked().
5327 void
5328 global_exe(cmd)
5329 char_u *cmd;
5331 linenr_T old_lcount; /* b_ml.ml_line_count before the command */
5332 linenr_T lnum; /* line number according to old situation */
5335 * Set current position only once for a global command.
5336 * If global_busy is set, setpcmark() will not do anything.
5337 * If there is an error, global_busy will be incremented.
5339 setpcmark();
5341 /* When the command writes a message, don't overwrite the command. */
5342 msg_didout = TRUE;
5344 global_need_beginline = FALSE;
5345 global_busy = 1;
5346 old_lcount = curbuf->b_ml.ml_line_count;
5347 while (!got_int && (lnum = ml_firstmarked()) != 0 && global_busy == 1)
5349 curwin->w_cursor.lnum = lnum;
5350 curwin->w_cursor.col = 0;
5351 if (*cmd == NUL || *cmd == '\n')
5352 do_cmdline((char_u *)"p", NULL, NULL, DOCMD_NOWAIT);
5353 else
5354 do_cmdline(cmd, NULL, NULL, DOCMD_NOWAIT);
5355 ui_breakcheck();
5358 global_busy = 0;
5359 if (global_need_beginline)
5360 beginline(BL_WHITE | BL_FIX);
5361 else
5362 check_cursor(); /* cursor may be beyond the end of the line */
5364 /* the cursor may not have moved in the text but a change in a previous
5365 * line may move it on the screen */
5366 changed_line_abv_curs();
5368 /* If it looks like no message was written, allow overwriting the
5369 * command with the report for number of changes. */
5370 if (msg_col == 0 && msg_scrolled == 0)
5371 msg_didout = FALSE;
5373 /* If substitutes done, report number of substitutes, otherwise report
5374 * number of extra or deleted lines. */
5375 if (!do_sub_msg(FALSE))
5376 msgmore(curbuf->b_ml.ml_line_count - old_lcount);
5379 #ifdef FEAT_VIMINFO
5381 read_viminfo_sub_string(virp, force)
5382 vir_T *virp;
5383 int force;
5385 if (old_sub != NULL && force)
5386 vim_free(old_sub);
5387 if (force || old_sub == NULL)
5388 old_sub = viminfo_readstring(virp, 1, TRUE);
5389 return viminfo_readline(virp);
5392 void
5393 write_viminfo_sub_string(fp)
5394 FILE *fp;
5396 if (get_viminfo_parameter('/') != 0 && old_sub != NULL)
5398 fprintf(fp, _("\n# Last Substitute String:\n$"));
5399 viminfo_writestring(fp, old_sub);
5402 #endif /* FEAT_VIMINFO */
5404 #if defined(EXITFREE) || defined(PROTO)
5405 void
5406 free_old_sub()
5408 vim_free(old_sub);
5410 #endif
5412 #if (defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)) || defined(PROTO)
5414 * Set up for a tagpreview.
5415 * Return TRUE when it was created.
5418 prepare_tagpreview(undo_sync)
5419 int undo_sync; /* sync undo when leaving the window */
5421 win_T *wp;
5423 # ifdef FEAT_GUI
5424 need_mouse_correct = TRUE;
5425 # endif
5428 * If there is already a preview window open, use that one.
5430 if (!curwin->w_p_pvw)
5432 for (wp = firstwin; wp != NULL; wp = wp->w_next)
5433 if (wp->w_p_pvw)
5434 break;
5435 if (wp != NULL)
5436 win_enter(wp, undo_sync);
5437 else
5440 * There is no preview window open yet. Create one.
5442 if (win_split(g_do_tagpreview > 0 ? g_do_tagpreview : 0, 0)
5443 == FAIL)
5444 return FALSE;
5445 curwin->w_p_pvw = TRUE;
5446 curwin->w_p_wfh = TRUE;
5447 # ifdef FEAT_SCROLLBIND
5448 curwin->w_p_scb = FALSE; /* don't take over 'scrollbind' */
5449 # endif
5450 # ifdef FEAT_DIFF
5451 curwin->w_p_diff = FALSE; /* no 'diff' */
5452 # endif
5453 # ifdef FEAT_FOLDING
5454 curwin->w_p_fdc = 0; /* no 'foldcolumn' */
5455 # endif
5456 return TRUE;
5459 return FALSE;
5462 #endif
5466 * ":help": open a read-only window on a help file
5468 void
5469 ex_help(eap)
5470 exarg_T *eap;
5472 char_u *arg;
5473 char_u *tag;
5474 FILE *helpfd; /* file descriptor of help file */
5475 int n;
5476 int i;
5477 #ifdef FEAT_WINDOWS
5478 win_T *wp;
5479 #endif
5480 int num_matches;
5481 char_u **matches;
5482 char_u *p;
5483 int empty_fnum = 0;
5484 int alt_fnum = 0;
5485 buf_T *buf;
5486 #ifdef FEAT_MULTI_LANG
5487 int len;
5488 char_u *lang;
5489 #endif
5491 if (eap != NULL)
5494 * A ":help" command ends at the first LF, or at a '|' that is
5495 * followed by some text. Set nextcmd to the following command.
5497 for (arg = eap->arg; *arg; ++arg)
5499 if (*arg == '\n' || *arg == '\r'
5500 || (*arg == '|' && arg[1] != NUL && arg[1] != '|'))
5502 *arg++ = NUL;
5503 eap->nextcmd = arg;
5504 break;
5507 arg = eap->arg;
5509 if (eap->forceit && *arg == NUL)
5511 EMSG(_("E478: Don't panic!"));
5512 return;
5515 if (eap->skip) /* not executing commands */
5516 return;
5518 else
5519 arg = (char_u *)"";
5521 /* remove trailing blanks */
5522 p = arg + STRLEN(arg) - 1;
5523 while (p > arg && vim_iswhite(*p) && p[-1] != '\\')
5524 *p-- = NUL;
5526 #ifdef FEAT_MULTI_LANG
5527 /* Check for a specified language */
5528 lang = check_help_lang(arg);
5529 #endif
5531 /* When no argument given go to the index. */
5532 if (*arg == NUL)
5533 arg = (char_u *)"help.txt";
5536 * Check if there is a match for the argument.
5538 n = find_help_tags(arg, &num_matches, &matches,
5539 eap != NULL && eap->forceit);
5541 i = 0;
5542 #ifdef FEAT_MULTI_LANG
5543 if (n != FAIL && lang != NULL)
5544 /* Find first item with the requested language. */
5545 for (i = 0; i < num_matches; ++i)
5547 len = (int)STRLEN(matches[i]);
5548 if (len > 3 && matches[i][len - 3] == '@'
5549 && STRICMP(matches[i] + len - 2, lang) == 0)
5550 break;
5552 #endif
5553 if (i >= num_matches || n == FAIL)
5555 #ifdef FEAT_MULTI_LANG
5556 if (lang != NULL)
5557 EMSG3(_("E661: Sorry, no '%s' help for %s"), lang, arg);
5558 else
5559 #endif
5560 EMSG2(_("E149: Sorry, no help for %s"), arg);
5561 if (n != FAIL)
5562 FreeWild(num_matches, matches);
5563 return;
5566 /* The first match (in the requested language) is the best match. */
5567 tag = vim_strsave(matches[i]);
5568 FreeWild(num_matches, matches);
5570 #ifdef FEAT_GUI
5571 need_mouse_correct = TRUE;
5572 #endif
5575 * Re-use an existing help window or open a new one.
5576 * Always open a new one for ":tab help".
5578 if (!curwin->w_buffer->b_help
5579 #ifdef FEAT_WINDOWS
5580 || cmdmod.tab != 0
5581 #endif
5584 #ifdef FEAT_WINDOWS
5585 if (cmdmod.tab != 0)
5586 wp = NULL;
5587 else
5588 for (wp = firstwin; wp != NULL; wp = wp->w_next)
5589 if (wp->w_buffer != NULL && wp->w_buffer->b_help)
5590 break;
5591 if (wp != NULL && wp->w_buffer->b_nwindows > 0)
5592 win_enter(wp, TRUE);
5593 else
5594 #endif
5597 * There is no help window yet.
5598 * Try to open the file specified by the "helpfile" option.
5600 if ((helpfd = mch_fopen((char *)p_hf, READBIN)) == NULL)
5602 smsg((char_u *)_("Sorry, help file \"%s\" not found"), p_hf);
5603 goto erret;
5605 fclose(helpfd);
5607 #ifdef FEAT_WINDOWS
5608 /* Split off help window; put it at far top if no position
5609 * specified, the current window is vertically split and
5610 * narrow. */
5611 n = WSP_HELP;
5612 # ifdef FEAT_VERTSPLIT
5613 if (cmdmod.split == 0 && curwin->w_width != Columns
5614 && curwin->w_width < 80)
5615 n |= WSP_TOP;
5616 # endif
5617 if (win_split(0, n) == FAIL)
5618 goto erret;
5619 #else
5620 /* use current window */
5621 if (!can_abandon(curbuf, FALSE))
5622 goto erret;
5623 #endif
5625 #ifdef FEAT_WINDOWS
5626 if (curwin->w_height < p_hh)
5627 win_setheight((int)p_hh);
5628 #endif
5631 * Open help file (do_ecmd() will set b_help flag, readfile() will
5632 * set b_p_ro flag).
5633 * Set the alternate file to the previously edited file.
5635 alt_fnum = curbuf->b_fnum;
5636 (void)do_ecmd(0, NULL, NULL, NULL, ECMD_LASTL,
5637 ECMD_HIDE + ECMD_SET_HELP,
5638 #ifdef FEAT_WINDOWS
5639 NULL /* buffer is still open, don't store info */
5640 #else
5641 curwin
5642 #endif
5644 if (!cmdmod.keepalt)
5645 curwin->w_alt_fnum = alt_fnum;
5646 empty_fnum = curbuf->b_fnum;
5650 if (!p_im)
5651 restart_edit = 0; /* don't want insert mode in help file */
5653 if (tag != NULL)
5654 do_tag(tag, DT_HELP, 1, FALSE, TRUE);
5656 /* Delete the empty buffer if we're not using it. Careful: autocommands
5657 * may have jumped to another window, check that the buffer is not in a
5658 * window. */
5659 if (empty_fnum != 0 && curbuf->b_fnum != empty_fnum)
5661 buf = buflist_findnr(empty_fnum);
5662 if (buf != NULL && buf->b_nwindows == 0)
5663 wipe_buffer(buf, TRUE);
5666 /* keep the previous alternate file */
5667 if (alt_fnum != 0 && curwin->w_alt_fnum == empty_fnum && !cmdmod.keepalt)
5668 curwin->w_alt_fnum = alt_fnum;
5670 erret:
5671 vim_free(tag);
5675 #if defined(FEAT_MULTI_LANG) || defined(PROTO)
5677 * In an argument search for a language specifiers in the form "@xx".
5678 * Changes the "@" to NUL if found, and returns a pointer to "xx".
5679 * Returns NULL if not found.
5681 char_u *
5682 check_help_lang(arg)
5683 char_u *arg;
5685 int len = (int)STRLEN(arg);
5687 if (len >= 3 && arg[len - 3] == '@' && ASCII_ISALPHA(arg[len - 2])
5688 && ASCII_ISALPHA(arg[len - 1]))
5690 arg[len - 3] = NUL; /* remove the '@' */
5691 return arg + len - 2;
5693 return NULL;
5695 #endif
5698 * Return a heuristic indicating how well the given string matches. The
5699 * smaller the number, the better the match. This is the order of priorities,
5700 * from best match to worst match:
5701 * - Match with least alpha-numeric characters is better.
5702 * - Match with least total characters is better.
5703 * - Match towards the start is better.
5704 * - Match starting with "+" is worse (feature instead of command)
5705 * Assumption is made that the matched_string passed has already been found to
5706 * match some string for which help is requested. webb.
5709 help_heuristic(matched_string, offset, wrong_case)
5710 char_u *matched_string;
5711 int offset; /* offset for match */
5712 int wrong_case; /* no matching case */
5714 int num_letters;
5715 char_u *p;
5717 num_letters = 0;
5718 for (p = matched_string; *p; p++)
5719 if (ASCII_ISALNUM(*p))
5720 num_letters++;
5723 * Multiply the number of letters by 100 to give it a much bigger
5724 * weighting than the number of characters.
5725 * If there only is a match while ignoring case, add 5000.
5726 * If the match starts in the middle of a word, add 10000 to put it
5727 * somewhere in the last half.
5728 * If the match is more than 2 chars from the start, multiply by 200 to
5729 * put it after matches at the start.
5731 if (ASCII_ISALNUM(matched_string[offset]) && offset > 0
5732 && ASCII_ISALNUM(matched_string[offset - 1]))
5733 offset += 10000;
5734 else if (offset > 2)
5735 offset *= 200;
5736 if (wrong_case)
5737 offset += 5000;
5738 /* Features are less interesting than the subjects themselves, but "+"
5739 * alone is not a feature. */
5740 if (matched_string[0] == '+' && matched_string[1] != NUL)
5741 offset += 100;
5742 return (int)(100 * num_letters + STRLEN(matched_string) + offset);
5746 * Compare functions for qsort() below, that checks the help heuristics number
5747 * that has been put after the tagname by find_tags().
5749 static int
5750 #ifdef __BORLANDC__
5751 _RTLENTRYF
5752 #endif
5753 help_compare(s1, s2)
5754 const void *s1;
5755 const void *s2;
5757 char *p1;
5758 char *p2;
5760 p1 = *(char **)s1 + strlen(*(char **)s1) + 1;
5761 p2 = *(char **)s2 + strlen(*(char **)s2) + 1;
5762 return strcmp(p1, p2);
5766 * Find all help tags matching "arg", sort them and return in matches[], with
5767 * the number of matches in num_matches.
5768 * The matches will be sorted with a "best" match algorithm.
5769 * When "keep_lang" is TRUE try keeping the language of the current buffer.
5772 find_help_tags(arg, num_matches, matches, keep_lang)
5773 char_u *arg;
5774 int *num_matches;
5775 char_u ***matches;
5776 int keep_lang;
5778 char_u *s, *d;
5779 int i;
5780 static char *(mtable[]) = {"*", "g*", "[*", "]*", ":*",
5781 "/*", "/\\*", "\"*", "**",
5782 "/\\(\\)",
5783 "?", ":?", "?<CR>", "g?", "g?g?", "g??", "z?",
5784 "/\\?", "/\\z(\\)", "\\=", ":s\\=",
5785 "[count]", "[quotex]", "[range]",
5786 "[pattern]", "\\|", "\\%$"};
5787 static char *(rtable[]) = {"star", "gstar", "[star", "]star", ":star",
5788 "/star", "/\\\\star", "quotestar", "starstar",
5789 "/\\\\(\\\\)",
5790 "?", ":?", "?<CR>", "g?", "g?g?", "g??", "z?",
5791 "/\\\\?", "/\\\\z(\\\\)", "\\\\=", ":s\\\\=",
5792 "\\[count]", "\\[quotex]", "\\[range]",
5793 "\\[pattern]", "\\\\bar", "/\\\\%\\$"};
5794 int flags;
5796 d = IObuff; /* assume IObuff is long enough! */
5799 * Recognize a few exceptions to the rule. Some strings that contain '*'
5800 * with "star". Otherwise '*' is recognized as a wildcard.
5802 for (i = (int)(sizeof(mtable) / sizeof(char *)); --i >= 0; )
5803 if (STRCMP(arg, mtable[i]) == 0)
5805 STRCPY(d, rtable[i]);
5806 break;
5809 if (i < 0) /* no match in table */
5811 /* Replace "\S" with "/\\S", etc. Otherwise every tag is matched.
5812 * Also replace "\%^" and "\%(", they match every tag too.
5813 * Also "\zs", "\z1", etc.
5814 * Also "\@<", "\@=", "\@<=", etc.
5815 * And also "\_$" and "\_^". */
5816 if (arg[0] == '\\'
5817 && ((arg[1] != NUL && arg[2] == NUL)
5818 || (vim_strchr((char_u *)"%_z@", arg[1]) != NULL
5819 && arg[2] != NUL)))
5821 STRCPY(d, "/\\\\");
5822 STRCPY(d + 3, arg + 1);
5823 /* Check for "/\\_$", should be "/\\_\$" */
5824 if (d[3] == '_' && d[4] == '$')
5825 STRCPY(d + 4, "\\$");
5827 else
5829 /* replace "[:...:]" with "\[:...:]"; "[+...]" with "\[++...]" */
5830 if (arg[0] == '[' && (arg[1] == ':'
5831 || (arg[1] == '+' && arg[2] == '+')))
5832 *d++ = '\\';
5834 for (s = arg; *s; ++s)
5837 * Replace "|" with "bar" and '"' with "quote" to match the name of
5838 * the tags for these commands.
5839 * Replace "*" with ".*" and "?" with "." to match command line
5840 * completion.
5841 * Insert a backslash before '~', '$' and '.' to avoid their
5842 * special meaning.
5844 if (d - IObuff > IOSIZE - 10) /* getting too long!? */
5845 break;
5846 switch (*s)
5848 case '|': STRCPY(d, "bar");
5849 d += 3;
5850 continue;
5851 case '"': STRCPY(d, "quote");
5852 d += 5;
5853 continue;
5854 case '*': *d++ = '.';
5855 break;
5856 case '?': *d++ = '.';
5857 continue;
5858 case '$':
5859 case '.':
5860 case '~': *d++ = '\\';
5861 break;
5865 * Replace "^x" by "CTRL-X". Don't do this for "^_" to make
5866 * ":help i_^_CTRL-D" work.
5867 * Insert '-' before and after "CTRL-X" when applicable.
5869 if (*s < ' ' || (*s == '^' && s[1] && (ASCII_ISALPHA(s[1])
5870 || vim_strchr((char_u *)"?@[\\]^", s[1]) != NULL)))
5872 if (d > IObuff && d[-1] != '_')
5873 *d++ = '_'; /* prepend a '_' */
5874 STRCPY(d, "CTRL-");
5875 d += 5;
5876 if (*s < ' ')
5878 #ifdef EBCDIC
5879 *d++ = CtrlChar(*s);
5880 #else
5881 *d++ = *s + '@';
5882 #endif
5883 if (d[-1] == '\\')
5884 *d++ = '\\'; /* double a backslash */
5886 else
5887 *d++ = *++s;
5888 if (s[1] != NUL && s[1] != '_')
5889 *d++ = '_'; /* append a '_' */
5890 continue;
5892 else if (*s == '^') /* "^" or "CTRL-^" or "^_" */
5893 *d++ = '\\';
5896 * Insert a backslash before a backslash after a slash, for search
5897 * pattern tags: "/\|" --> "/\\|".
5899 else if (s[0] == '\\' && s[1] != '\\'
5900 && *arg == '/' && s == arg + 1)
5901 *d++ = '\\';
5903 /* "CTRL-\_" -> "CTRL-\\_" to avoid the special meaning of "\_" in
5904 * "CTRL-\_CTRL-N" */
5905 if (STRNICMP(s, "CTRL-\\_", 7) == 0)
5907 STRCPY(d, "CTRL-\\\\");
5908 d += 7;
5909 s += 6;
5912 *d++ = *s;
5915 * If tag starts with ', toss everything after a second '. Fixes
5916 * CTRL-] on 'option'. (would include the trailing '.').
5918 if (*s == '\'' && s > arg && *arg == '\'')
5919 break;
5921 *d = NUL;
5925 *matches = (char_u **)"";
5926 *num_matches = 0;
5927 flags = TAG_HELP | TAG_REGEXP | TAG_NAMES | TAG_VERBOSE;
5928 if (keep_lang)
5929 flags |= TAG_KEEP_LANG;
5930 if (find_tags(IObuff, num_matches, matches, flags, (int)MAXCOL, NULL) == OK
5931 && *num_matches > 0)
5933 /* Sort the matches found on the heuristic number that is after the
5934 * tag name. */
5935 qsort((void *)*matches, (size_t)*num_matches,
5936 sizeof(char_u *), help_compare);
5937 /* Delete more than TAG_MANY to reduce the size of the listing. */
5938 while (*num_matches > TAG_MANY)
5939 vim_free((*matches)[--*num_matches]);
5941 return OK;
5945 * After reading a help file: May cleanup a help buffer when syntax
5946 * highlighting is not used.
5948 void
5949 fix_help_buffer()
5951 linenr_T lnum;
5952 char_u *line;
5953 int in_example = FALSE;
5954 int len;
5955 char_u *p;
5956 char_u *rt;
5957 int mustfree;
5959 /* set filetype to "help". */
5960 set_option_value((char_u *)"ft", 0L, (char_u *)"help", OPT_LOCAL);
5962 #ifdef FEAT_SYN_HL
5963 if (!syntax_present(curbuf))
5964 #endif
5966 for (lnum = 1; lnum <= curbuf->b_ml.ml_line_count; ++lnum)
5968 line = ml_get_buf(curbuf, lnum, FALSE);
5969 len = (int)STRLEN(line);
5970 if (in_example && len > 0 && !vim_iswhite(line[0]))
5972 /* End of example: non-white or '<' in first column. */
5973 if (line[0] == '<')
5975 /* blank-out a '<' in the first column */
5976 line = ml_get_buf(curbuf, lnum, TRUE);
5977 line[0] = ' ';
5979 in_example = FALSE;
5981 if (!in_example && len > 0)
5983 if (line[len - 1] == '>' && (len == 1 || line[len - 2] == ' '))
5985 /* blank-out a '>' in the last column (start of example) */
5986 line = ml_get_buf(curbuf, lnum, TRUE);
5987 line[len - 1] = ' ';
5988 in_example = TRUE;
5990 else if (line[len - 1] == '~')
5992 /* blank-out a '~' at the end of line (header marker) */
5993 line = ml_get_buf(curbuf, lnum, TRUE);
5994 line[len - 1] = ' ';
6001 * In the "help.txt" file, add the locally added help files.
6002 * This uses the very first line in the help file.
6004 if (fnamecmp(gettail(curbuf->b_fname), "help.txt") == 0)
6006 for (lnum = 1; lnum < curbuf->b_ml.ml_line_count; ++lnum)
6008 line = ml_get_buf(curbuf, lnum, FALSE);
6009 if (strstr((char *)line, "*local-additions*") != NULL)
6011 /* Go through all directories in 'runtimepath', skipping
6012 * $VIMRUNTIME. */
6013 p = p_rtp;
6014 while (*p != NUL)
6016 copy_option_part(&p, NameBuff, MAXPATHL, ",");
6017 mustfree = FALSE;
6018 rt = vim_getenv((char_u *)"VIMRUNTIME", &mustfree);
6019 if (fullpathcmp(rt, NameBuff, FALSE) != FPC_SAME)
6021 int fcount;
6022 char_u **fnames;
6023 FILE *fd;
6024 char_u *s;
6025 int fi;
6026 #ifdef FEAT_MBYTE
6027 vimconv_T vc;
6028 char_u *cp;
6029 #endif
6031 /* Find all "doc/ *.txt" files in this directory. */
6032 add_pathsep(NameBuff);
6033 STRCAT(NameBuff, "doc/*.txt");
6034 if (gen_expand_wildcards(1, &NameBuff, &fcount,
6035 &fnames, EW_FILE|EW_SILENT) == OK
6036 && fcount > 0)
6038 for (fi = 0; fi < fcount; ++fi)
6040 fd = mch_fopen((char *)fnames[fi], "r");
6041 if (fd != NULL)
6043 vim_fgets(IObuff, IOSIZE, fd);
6044 if (IObuff[0] == '*'
6045 && (s = vim_strchr(IObuff + 1, '*'))
6046 != NULL)
6048 #ifdef FEAT_MBYTE
6049 int this_utf = MAYBE;
6050 #endif
6051 /* Change tag definition to a
6052 * reference and remove <CR>/<NL>. */
6053 IObuff[0] = '|';
6054 *s = '|';
6055 while (*s != NUL)
6057 if (*s == '\r' || *s == '\n')
6058 *s = NUL;
6059 #ifdef FEAT_MBYTE
6060 /* The text is utf-8 when a byte
6061 * above 127 is found and no
6062 * illegal byte sequence is found.
6064 if (*s >= 0x80 && this_utf != FALSE)
6066 int l;
6068 this_utf = TRUE;
6069 l = utf_ptr2len(s);
6070 if (l == 1)
6071 this_utf = FALSE;
6072 s += l - 1;
6074 #endif
6075 ++s;
6077 #ifdef FEAT_MBYTE
6078 /* The help file is latin1 or utf-8;
6079 * conversion to the current
6080 * 'encoding' may be required. */
6081 vc.vc_type = CONV_NONE;
6082 convert_setup(&vc, (char_u *)(
6083 this_utf == TRUE ? "utf-8"
6084 : "latin1"), p_enc);
6085 if (vc.vc_type == CONV_NONE)
6086 /* No conversion needed. */
6087 cp = IObuff;
6088 else
6090 /* Do the conversion. If it fails
6091 * use the unconverted text. */
6092 cp = string_convert(&vc, IObuff,
6093 NULL);
6094 if (cp == NULL)
6095 cp = IObuff;
6097 convert_setup(&vc, NULL, NULL);
6099 ml_append(lnum, cp, (colnr_T)0, FALSE);
6100 if (cp != IObuff)
6101 vim_free(cp);
6102 #else
6103 ml_append(lnum, IObuff, (colnr_T)0,
6104 FALSE);
6105 #endif
6106 ++lnum;
6108 fclose(fd);
6111 FreeWild(fcount, fnames);
6114 if (mustfree)
6115 vim_free(rt);
6117 break;
6124 * ":exusage"
6126 void
6127 ex_exusage(eap)
6128 exarg_T *eap UNUSED;
6130 do_cmdline_cmd((char_u *)"help ex-cmd-index");
6134 * ":viusage"
6136 void
6137 ex_viusage(eap)
6138 exarg_T *eap UNUSED;
6140 do_cmdline_cmd((char_u *)"help normal-index");
6143 #if defined(FEAT_EX_EXTRA) || defined(PROTO)
6144 static void helptags_one __ARGS((char_u *dir, char_u *ext, char_u *lang, int add_help_tags));
6147 * ":helptags"
6149 void
6150 ex_helptags(eap)
6151 exarg_T *eap;
6153 garray_T ga;
6154 int i, j;
6155 int len;
6156 #ifdef FEAT_MULTI_LANG
6157 char_u lang[2];
6158 #endif
6159 expand_T xpc;
6160 char_u *dirname;
6161 char_u ext[5];
6162 char_u fname[8];
6163 int filecount;
6164 char_u **files;
6165 int add_help_tags = FALSE;
6167 /* Check for ":helptags ++t {dir}". */
6168 if (STRNCMP(eap->arg, "++t", 3) == 0 && vim_iswhite(eap->arg[3]))
6170 add_help_tags = TRUE;
6171 eap->arg = skipwhite(eap->arg + 3);
6174 ExpandInit(&xpc);
6175 xpc.xp_context = EXPAND_DIRECTORIES;
6176 dirname = ExpandOne(&xpc, eap->arg, NULL,
6177 WILD_LIST_NOTFOUND|WILD_SILENT, WILD_EXPAND_FREE);
6178 if (dirname == NULL || !mch_isdir(dirname))
6180 EMSG2(_("E150: Not a directory: %s"), eap->arg);
6181 return;
6184 #ifdef FEAT_MULTI_LANG
6185 /* Get a list of all files in the directory. */
6186 STRCPY(NameBuff, dirname);
6187 add_pathsep(NameBuff);
6188 STRCAT(NameBuff, "*");
6189 if (gen_expand_wildcards(1, &NameBuff, &filecount, &files,
6190 EW_FILE|EW_SILENT) == FAIL
6191 || filecount == 0)
6193 EMSG2("E151: No match: %s", NameBuff);
6194 vim_free(dirname);
6195 return;
6198 /* Go over all files in the directory to find out what languages are
6199 * present. */
6200 ga_init2(&ga, 1, 10);
6201 for (i = 0; i < filecount; ++i)
6203 len = (int)STRLEN(files[i]);
6204 if (len > 4)
6206 if (STRICMP(files[i] + len - 4, ".txt") == 0)
6208 /* ".txt" -> language "en" */
6209 lang[0] = 'e';
6210 lang[1] = 'n';
6212 else if (files[i][len - 4] == '.'
6213 && ASCII_ISALPHA(files[i][len - 3])
6214 && ASCII_ISALPHA(files[i][len - 2])
6215 && TOLOWER_ASC(files[i][len - 1]) == 'x')
6217 /* ".abx" -> language "ab" */
6218 lang[0] = TOLOWER_ASC(files[i][len - 3]);
6219 lang[1] = TOLOWER_ASC(files[i][len - 2]);
6221 else
6222 continue;
6224 /* Did we find this language already? */
6225 for (j = 0; j < ga.ga_len; j += 2)
6226 if (STRNCMP(lang, ((char_u *)ga.ga_data) + j, 2) == 0)
6227 break;
6228 if (j == ga.ga_len)
6230 /* New language, add it. */
6231 if (ga_grow(&ga, 2) == FAIL)
6232 break;
6233 ((char_u *)ga.ga_data)[ga.ga_len++] = lang[0];
6234 ((char_u *)ga.ga_data)[ga.ga_len++] = lang[1];
6240 * Loop over the found languages to generate a tags file for each one.
6242 for (j = 0; j < ga.ga_len; j += 2)
6244 STRCPY(fname, "tags-xx");
6245 fname[5] = ((char_u *)ga.ga_data)[j];
6246 fname[6] = ((char_u *)ga.ga_data)[j + 1];
6247 if (fname[5] == 'e' && fname[6] == 'n')
6249 /* English is an exception: use ".txt" and "tags". */
6250 fname[4] = NUL;
6251 STRCPY(ext, ".txt");
6253 else
6255 /* Language "ab" uses ".abx" and "tags-ab". */
6256 STRCPY(ext, ".xxx");
6257 ext[1] = fname[5];
6258 ext[2] = fname[6];
6260 helptags_one(dirname, ext, fname, add_help_tags);
6263 ga_clear(&ga);
6264 FreeWild(filecount, files);
6266 #else
6267 /* No language support, just use "*.txt" and "tags". */
6268 helptags_one(dirname, (char_u *)".txt", (char_u *)"tags", add_help_tags);
6269 #endif
6270 vim_free(dirname);
6273 static void
6274 helptags_one(dir, ext, tagfname, add_help_tags)
6275 char_u *dir; /* doc directory */
6276 char_u *ext; /* suffix, ".txt", ".itx", ".frx", etc. */
6277 char_u *tagfname; /* "tags" for English, "tags-fr" for French. */
6278 int add_help_tags; /* add "help-tags" tag */
6280 FILE *fd_tags;
6281 FILE *fd;
6282 garray_T ga;
6283 int filecount;
6284 char_u **files;
6285 char_u *p1, *p2;
6286 int fi;
6287 char_u *s;
6288 int i;
6289 char_u *fname;
6290 # ifdef FEAT_MBYTE
6291 int utf8 = MAYBE;
6292 int this_utf8;
6293 int firstline;
6294 int mix = FALSE; /* detected mixed encodings */
6295 # endif
6298 * Find all *.txt files.
6300 STRCPY(NameBuff, dir);
6301 add_pathsep(NameBuff);
6302 STRCAT(NameBuff, "*");
6303 STRCAT(NameBuff, ext);
6304 if (gen_expand_wildcards(1, &NameBuff, &filecount, &files,
6305 EW_FILE|EW_SILENT) == FAIL
6306 || filecount == 0)
6308 if (!got_int)
6309 EMSG2("E151: No match: %s", NameBuff);
6310 return;
6314 * Open the tags file for writing.
6315 * Do this before scanning through all the files.
6317 STRCPY(NameBuff, dir);
6318 add_pathsep(NameBuff);
6319 STRCAT(NameBuff, tagfname);
6320 fd_tags = mch_fopen((char *)NameBuff, "w");
6321 if (fd_tags == NULL)
6323 EMSG2(_("E152: Cannot open %s for writing"), NameBuff);
6324 FreeWild(filecount, files);
6325 return;
6329 * If using the "++t" argument or generating tags for "$VIMRUNTIME/doc"
6330 * add the "help-tags" tag.
6332 ga_init2(&ga, (int)sizeof(char_u *), 100);
6333 if (add_help_tags || fullpathcmp((char_u *)"$VIMRUNTIME/doc",
6334 dir, FALSE) == FPC_SAME)
6336 if (ga_grow(&ga, 1) == FAIL)
6337 got_int = TRUE;
6338 else
6340 s = alloc(18 + (unsigned)STRLEN(tagfname));
6341 if (s == NULL)
6342 got_int = TRUE;
6343 else
6345 sprintf((char *)s, "help-tags\t%s\t1\n", tagfname);
6346 ((char_u **)ga.ga_data)[ga.ga_len] = s;
6347 ++ga.ga_len;
6353 * Go over all the files and extract the tags.
6355 for (fi = 0; fi < filecount && !got_int; ++fi)
6357 fd = mch_fopen((char *)files[fi], "r");
6358 if (fd == NULL)
6360 EMSG2(_("E153: Unable to open %s for reading"), files[fi]);
6361 continue;
6363 fname = gettail(files[fi]);
6365 # ifdef FEAT_MBYTE
6366 firstline = TRUE;
6367 # endif
6368 while (!vim_fgets(IObuff, IOSIZE, fd) && !got_int)
6370 # ifdef FEAT_MBYTE
6371 if (firstline)
6373 /* Detect utf-8 file by a non-ASCII char in the first line. */
6374 this_utf8 = MAYBE;
6375 for (s = IObuff; *s != NUL; ++s)
6376 if (*s >= 0x80)
6378 int l;
6380 this_utf8 = TRUE;
6381 l = utf_ptr2len(s);
6382 if (l == 1)
6384 /* Illegal UTF-8 byte sequence. */
6385 this_utf8 = FALSE;
6386 break;
6388 s += l - 1;
6390 if (this_utf8 == MAYBE) /* only ASCII characters found */
6391 this_utf8 = FALSE;
6392 if (utf8 == MAYBE) /* first file */
6393 utf8 = this_utf8;
6394 else if (utf8 != this_utf8)
6396 EMSG2(_("E670: Mix of help file encodings within a language: %s"), files[fi]);
6397 mix = !got_int;
6398 got_int = TRUE;
6400 firstline = FALSE;
6402 # endif
6403 p1 = vim_strchr(IObuff, '*'); /* find first '*' */
6404 while (p1 != NULL)
6406 p2 = vim_strchr(p1 + 1, '*'); /* find second '*' */
6407 if (p2 != NULL && p2 > p1 + 1) /* skip "*" and "**" */
6409 for (s = p1 + 1; s < p2; ++s)
6410 if (*s == ' ' || *s == '\t' || *s == '|')
6411 break;
6414 * Only accept a *tag* when it consists of valid
6415 * characters, there is white space before it and is
6416 * followed by a white character or end-of-line.
6418 if (s == p2
6419 && (p1 == IObuff || p1[-1] == ' ' || p1[-1] == '\t')
6420 && (vim_strchr((char_u *)" \t\n\r", s[1]) != NULL
6421 || s[1] == '\0'))
6423 *p2 = '\0';
6424 ++p1;
6425 if (ga_grow(&ga, 1) == FAIL)
6427 got_int = TRUE;
6428 break;
6430 s = alloc((unsigned)(p2 - p1 + STRLEN(fname) + 2));
6431 if (s == NULL)
6433 got_int = TRUE;
6434 break;
6436 ((char_u **)ga.ga_data)[ga.ga_len] = s;
6437 ++ga.ga_len;
6438 sprintf((char *)s, "%s\t%s", p1, fname);
6440 /* find next '*' */
6441 p2 = vim_strchr(p2 + 1, '*');
6444 p1 = p2;
6446 line_breakcheck();
6449 fclose(fd);
6452 FreeWild(filecount, files);
6454 if (!got_int)
6457 * Sort the tags.
6459 sort_strings((char_u **)ga.ga_data, ga.ga_len);
6462 * Check for duplicates.
6464 for (i = 1; i < ga.ga_len; ++i)
6466 p1 = ((char_u **)ga.ga_data)[i - 1];
6467 p2 = ((char_u **)ga.ga_data)[i];
6468 while (*p1 == *p2)
6470 if (*p2 == '\t')
6472 *p2 = NUL;
6473 vim_snprintf((char *)NameBuff, MAXPATHL,
6474 _("E154: Duplicate tag \"%s\" in file %s/%s"),
6475 ((char_u **)ga.ga_data)[i], dir, p2 + 1);
6476 EMSG(NameBuff);
6477 *p2 = '\t';
6478 break;
6480 ++p1;
6481 ++p2;
6485 # ifdef FEAT_MBYTE
6486 if (utf8 == TRUE)
6487 fprintf(fd_tags, "!_TAG_FILE_ENCODING\tutf-8\t//\n");
6488 # endif
6491 * Write the tags into the file.
6493 for (i = 0; i < ga.ga_len; ++i)
6495 s = ((char_u **)ga.ga_data)[i];
6496 if (STRNCMP(s, "help-tags\t", 10) == 0)
6497 /* help-tags entry was added in formatted form */
6498 fputs((char *)s, fd_tags);
6499 else
6501 fprintf(fd_tags, "%s\t/*", s);
6502 for (p1 = s; *p1 != '\t'; ++p1)
6504 /* insert backslash before '\\' and '/' */
6505 if (*p1 == '\\' || *p1 == '/')
6506 putc('\\', fd_tags);
6507 putc(*p1, fd_tags);
6509 fprintf(fd_tags, "*\n");
6513 #ifdef FEAT_MBYTE
6514 if (mix)
6515 got_int = FALSE; /* continue with other languages */
6516 #endif
6518 for (i = 0; i < ga.ga_len; ++i)
6519 vim_free(((char_u **)ga.ga_data)[i]);
6520 ga_clear(&ga);
6521 fclose(fd_tags); /* there is no check for an error... */
6523 #endif
6525 #if defined(FEAT_SIGNS) || defined(PROTO)
6528 * Struct to hold the sign properties.
6530 typedef struct sign sign_T;
6532 struct sign
6534 sign_T *sn_next; /* next sign in list */
6535 int sn_typenr; /* type number of sign (negative if not equal
6536 to name) */
6537 char_u *sn_name; /* name of sign */
6538 char_u *sn_icon; /* name of pixmap */
6539 #ifdef FEAT_SIGN_ICONS
6540 void *sn_image; /* icon image */
6541 #endif
6542 char_u *sn_text; /* text used instead of pixmap */
6543 int sn_line_hl; /* highlight ID for line */
6544 int sn_text_hl; /* highlight ID for text */
6547 static sign_T *first_sign = NULL;
6548 static int last_sign_typenr = MAX_TYPENR; /* is decremented */
6550 static int sign_cmd_idx __ARGS((char_u *begin_cmd, char_u *end_cmd));
6551 static void sign_list_defined __ARGS((sign_T *sp));
6552 static void sign_undefine __ARGS((sign_T *sp, sign_T *sp_prev));
6554 static char *cmds[] = {
6555 "define",
6556 #define SIGNCMD_DEFINE 0
6557 "undefine",
6558 #define SIGNCMD_UNDEFINE 1
6559 "list",
6560 #define SIGNCMD_LIST 2
6561 "place",
6562 #define SIGNCMD_PLACE 3
6563 "unplace",
6564 #define SIGNCMD_UNPLACE 4
6565 "jump",
6566 #define SIGNCMD_JUMP 5
6567 NULL
6568 #define SIGNCMD_LAST 6
6572 * Find index of a ":sign" subcmd from its name.
6573 * "*end_cmd" must be writable.
6575 static int
6576 sign_cmd_idx(begin_cmd, end_cmd)
6577 char_u *begin_cmd; /* begin of sign subcmd */
6578 char_u *end_cmd; /* just after sign subcmd */
6580 int idx;
6581 char save = *end_cmd;
6583 *end_cmd = NUL;
6584 for (idx = 0; ; ++idx)
6585 if (cmds[idx] == NULL || STRCMP(begin_cmd, cmds[idx]) == 0)
6586 break;
6587 *end_cmd = save;
6588 return idx;
6592 * ":sign" command
6594 void
6595 ex_sign(eap)
6596 exarg_T *eap;
6598 char_u *arg = eap->arg;
6599 char_u *p;
6600 int idx;
6601 sign_T *sp;
6602 sign_T *sp_prev;
6603 buf_T *buf;
6605 /* Parse the subcommand. */
6606 p = skiptowhite(arg);
6607 idx = sign_cmd_idx(arg, p);
6608 if (idx == SIGNCMD_LAST)
6610 EMSG2(_("E160: Unknown sign command: %s"), arg);
6611 return;
6613 arg = skipwhite(p);
6615 if (idx <= SIGNCMD_LIST)
6618 * Define, undefine or list signs.
6620 if (idx == SIGNCMD_LIST && *arg == NUL)
6622 /* ":sign list": list all defined signs */
6623 for (sp = first_sign; sp != NULL; sp = sp->sn_next)
6624 sign_list_defined(sp);
6626 else if (*arg == NUL)
6627 EMSG(_("E156: Missing sign name"));
6628 else
6630 p = skiptowhite(arg);
6631 if (*p != NUL)
6632 *p++ = NUL;
6633 sp_prev = NULL;
6634 for (sp = first_sign; sp != NULL; sp = sp->sn_next)
6636 if (STRCMP(sp->sn_name, arg) == 0)
6637 break;
6638 sp_prev = sp;
6640 if (idx == SIGNCMD_DEFINE)
6642 /* ":sign define {name} ...": define a sign */
6643 if (sp == NULL)
6645 /* Allocate a new sign. */
6646 sp = (sign_T *)alloc_clear((unsigned)sizeof(sign_T));
6647 if (sp == NULL)
6648 return;
6649 if (sp_prev == NULL)
6650 first_sign = sp;
6651 else
6652 sp_prev->sn_next = sp;
6653 sp->sn_name = vim_strnsave(arg, (int)(p - arg));
6655 /* If the name is a number use that for the typenr,
6656 * otherwise use a negative number. */
6657 if (VIM_ISDIGIT(*arg))
6658 sp->sn_typenr = atoi((char *)arg);
6659 else
6661 sign_T *lp;
6662 int start = last_sign_typenr;
6664 for (lp = first_sign; lp != NULL; lp = lp->sn_next)
6666 if (lp->sn_typenr == last_sign_typenr)
6668 --last_sign_typenr;
6669 if (last_sign_typenr == 0)
6670 last_sign_typenr = MAX_TYPENR;
6671 if (last_sign_typenr == start)
6673 EMSG(_("E612: Too many signs defined"));
6674 return;
6676 lp = first_sign;
6677 continue;
6681 sp->sn_typenr = last_sign_typenr--;
6682 if (last_sign_typenr == 0)
6683 last_sign_typenr = MAX_TYPENR; /* wrap around */
6687 /* set values for a defined sign. */
6688 for (;;)
6690 arg = skipwhite(p);
6691 if (*arg == NUL)
6692 break;
6693 p = skiptowhite_esc(arg);
6694 if (STRNCMP(arg, "icon=", 5) == 0)
6696 arg += 5;
6697 vim_free(sp->sn_icon);
6698 sp->sn_icon = vim_strnsave(arg, (int)(p - arg));
6699 backslash_halve(sp->sn_icon);
6700 #ifdef FEAT_SIGN_ICONS
6701 if (gui.in_use)
6703 out_flush();
6704 if (sp->sn_image != NULL)
6705 gui_mch_destroy_sign(sp->sn_image);
6706 sp->sn_image = gui_mch_register_sign(sp->sn_icon);
6708 #endif
6710 else if (STRNCMP(arg, "text=", 5) == 0)
6712 char_u *s;
6713 int cells;
6714 int len;
6716 arg += 5;
6717 #ifdef FEAT_MBYTE
6718 /* Count cells and check for non-printable chars */
6719 if (has_mbyte)
6721 cells = 0;
6722 for (s = arg; s < p; s += (*mb_ptr2len)(s))
6724 if (!vim_isprintc((*mb_ptr2char)(s)))
6725 break;
6726 cells += (*mb_ptr2cells)(s);
6729 else
6730 #endif
6732 for (s = arg; s < p; ++s)
6733 if (!vim_isprintc(*s))
6734 break;
6735 cells = (int)(s - arg);
6737 /* Currently must be one or two display cells */
6738 if (s != p || cells < 1 || cells > 2)
6740 *p = NUL;
6741 EMSG2(_("E239: Invalid sign text: %s"), arg);
6742 return;
6745 vim_free(sp->sn_text);
6746 /* Allocate one byte more if we need to pad up
6747 * with a space. */
6748 len = (int)(p - arg + ((cells == 1) ? 1 : 0));
6749 sp->sn_text = vim_strnsave(arg, len);
6751 if (sp->sn_text != NULL && cells == 1)
6752 STRCPY(sp->sn_text + len - 1, " ");
6754 else if (STRNCMP(arg, "linehl=", 7) == 0)
6756 arg += 7;
6757 sp->sn_line_hl = syn_check_group(arg, (int)(p - arg));
6759 else if (STRNCMP(arg, "texthl=", 7) == 0)
6761 arg += 7;
6762 sp->sn_text_hl = syn_check_group(arg, (int)(p - arg));
6764 else
6766 EMSG2(_(e_invarg2), arg);
6767 return;
6771 else if (sp == NULL)
6772 EMSG2(_("E155: Unknown sign: %s"), arg);
6773 else if (idx == SIGNCMD_LIST)
6774 /* ":sign list {name}" */
6775 sign_list_defined(sp);
6776 else
6777 /* ":sign undefine {name}" */
6778 sign_undefine(sp, sp_prev);
6781 else
6783 int id = -1;
6784 linenr_T lnum = -1;
6785 char_u *sign_name = NULL;
6786 char_u *arg1;
6788 if (*arg == NUL)
6790 if (idx == SIGNCMD_PLACE)
6792 /* ":sign place": list placed signs in all buffers */
6793 sign_list_placed(NULL);
6795 else if (idx == SIGNCMD_UNPLACE)
6797 /* ":sign unplace": remove placed sign at cursor */
6798 id = buf_findsign_id(curwin->w_buffer, curwin->w_cursor.lnum);
6799 if (id > 0)
6801 buf_delsign(curwin->w_buffer, id);
6802 update_debug_sign(curwin->w_buffer, curwin->w_cursor.lnum);
6804 else
6805 EMSG(_("E159: Missing sign number"));
6807 else
6808 EMSG(_(e_argreq));
6809 return;
6812 if (idx == SIGNCMD_UNPLACE && arg[0] == '*' && arg[1] == NUL)
6814 /* ":sign unplace *": remove all placed signs */
6815 buf_delete_all_signs();
6816 return;
6819 /* first arg could be placed sign id */
6820 arg1 = arg;
6821 if (VIM_ISDIGIT(*arg))
6823 id = getdigits(&arg);
6824 if (!vim_iswhite(*arg) && *arg != NUL)
6826 id = -1;
6827 arg = arg1;
6829 else
6831 arg = skipwhite(arg);
6832 if (idx == SIGNCMD_UNPLACE && *arg == NUL)
6834 /* ":sign unplace {id}": remove placed sign by number */
6835 for (buf = firstbuf; buf != NULL; buf = buf->b_next)
6836 if ((lnum = buf_delsign(buf, id)) != 0)
6837 update_debug_sign(buf, lnum);
6838 return;
6844 * Check for line={lnum} name={name} and file={fname} or buffer={nr}.
6845 * Leave "arg" pointing to {fname}.
6847 for (;;)
6849 if (STRNCMP(arg, "line=", 5) == 0)
6851 arg += 5;
6852 lnum = atoi((char *)arg);
6853 arg = skiptowhite(arg);
6855 else if (STRNCMP(arg, "name=", 5) == 0)
6857 arg += 5;
6858 sign_name = arg;
6859 arg = skiptowhite(arg);
6860 if (*arg != NUL)
6861 *arg++ = NUL;
6863 else if (STRNCMP(arg, "file=", 5) == 0)
6865 arg += 5;
6866 buf = buflist_findname(arg);
6867 break;
6869 else if (STRNCMP(arg, "buffer=", 7) == 0)
6871 arg += 7;
6872 buf = buflist_findnr((int)getdigits(&arg));
6873 if (*skipwhite(arg) != NUL)
6874 EMSG(_(e_trailing));
6875 break;
6877 else
6879 EMSG(_(e_invarg));
6880 return;
6882 arg = skipwhite(arg);
6885 if (buf == NULL)
6887 EMSG2(_("E158: Invalid buffer name: %s"), arg);
6889 else if (id <= 0)
6891 if (lnum >= 0 || sign_name != NULL)
6892 EMSG(_(e_invarg));
6893 else
6894 /* ":sign place file={fname}": list placed signs in one file */
6895 sign_list_placed(buf);
6897 else if (idx == SIGNCMD_JUMP)
6899 /* ":sign jump {id} file={fname}" */
6900 if (lnum >= 0 || sign_name != NULL)
6901 EMSG(_(e_invarg));
6902 else if ((lnum = buf_findsign(buf, id)) > 0)
6903 { /* goto a sign ... */
6904 if (buf_jump_open_win(buf) != NULL)
6905 { /* ... in a current window */
6906 curwin->w_cursor.lnum = lnum;
6907 check_cursor_lnum();
6908 beginline(BL_WHITE);
6910 else
6911 { /* ... not currently in a window */
6912 char_u *cmd;
6914 cmd = alloc((unsigned)STRLEN(buf->b_fname) + 25);
6915 if (cmd == NULL)
6916 return;
6917 sprintf((char *)cmd, "e +%ld %s", (long)lnum, buf->b_fname);
6918 do_cmdline_cmd(cmd);
6919 vim_free(cmd);
6921 #ifdef FEAT_FOLDING
6922 foldOpenCursor();
6923 #endif
6925 else
6926 EMSGN(_("E157: Invalid sign ID: %ld"), id);
6928 else if (idx == SIGNCMD_UNPLACE)
6930 /* ":sign unplace {id} file={fname}" */
6931 if (lnum >= 0 || sign_name != NULL)
6932 EMSG(_(e_invarg));
6933 else
6935 lnum = buf_delsign(buf, id);
6936 update_debug_sign(buf, lnum);
6939 /* idx == SIGNCMD_PLACE */
6940 else if (sign_name != NULL)
6942 for (sp = first_sign; sp != NULL; sp = sp->sn_next)
6943 if (STRCMP(sp->sn_name, sign_name) == 0)
6944 break;
6945 if (sp == NULL)
6947 EMSG2(_("E155: Unknown sign: %s"), sign_name);
6948 return;
6950 if (lnum > 0)
6951 /* ":sign place {id} line={lnum} name={name} file={fname}":
6952 * place a sign */
6953 buf_addsign(buf, id, lnum, sp->sn_typenr);
6954 else
6955 /* ":sign place {id} file={fname}": change sign type */
6956 lnum = buf_change_sign_type(buf, id, sp->sn_typenr);
6957 update_debug_sign(buf, lnum);
6959 else
6960 EMSG(_(e_invarg));
6964 #if defined(FEAT_SIGN_ICONS) || defined(PROTO)
6966 * Allocate the icons. Called when the GUI has started. Allows defining
6967 * signs before it starts.
6969 void
6970 sign_gui_started()
6972 sign_T *sp;
6974 for (sp = first_sign; sp != NULL; sp = sp->sn_next)
6975 if (sp->sn_icon != NULL)
6976 sp->sn_image = gui_mch_register_sign(sp->sn_icon);
6978 #endif
6981 * List one sign.
6983 static void
6984 sign_list_defined(sp)
6985 sign_T *sp;
6987 char_u *p;
6989 smsg((char_u *)"sign %s", sp->sn_name);
6990 if (sp->sn_icon != NULL)
6992 MSG_PUTS(" icon=");
6993 msg_outtrans(sp->sn_icon);
6994 #ifdef FEAT_SIGN_ICONS
6995 if (sp->sn_image == NULL)
6996 MSG_PUTS(_(" (NOT FOUND)"));
6997 #else
6998 MSG_PUTS(_(" (not supported)"));
6999 #endif
7001 if (sp->sn_text != NULL)
7003 MSG_PUTS(" text=");
7004 msg_outtrans(sp->sn_text);
7006 if (sp->sn_line_hl > 0)
7008 MSG_PUTS(" linehl=");
7009 p = get_highlight_name(NULL, sp->sn_line_hl - 1);
7010 if (p == NULL)
7011 MSG_PUTS("NONE");
7012 else
7013 msg_puts(p);
7015 if (sp->sn_text_hl > 0)
7017 MSG_PUTS(" texthl=");
7018 p = get_highlight_name(NULL, sp->sn_text_hl - 1);
7019 if (p == NULL)
7020 MSG_PUTS("NONE");
7021 else
7022 msg_puts(p);
7027 * Undefine a sign and free its memory.
7029 static void
7030 sign_undefine(sp, sp_prev)
7031 sign_T *sp;
7032 sign_T *sp_prev;
7034 vim_free(sp->sn_name);
7035 vim_free(sp->sn_icon);
7036 #ifdef FEAT_SIGN_ICONS
7037 if (sp->sn_image != NULL)
7039 out_flush();
7040 gui_mch_destroy_sign(sp->sn_image);
7042 #endif
7043 vim_free(sp->sn_text);
7044 if (sp_prev == NULL)
7045 first_sign = sp->sn_next;
7046 else
7047 sp_prev->sn_next = sp->sn_next;
7048 vim_free(sp);
7052 * Get highlighting attribute for sign "typenr".
7053 * If "line" is TRUE: line highl, if FALSE: text highl.
7056 sign_get_attr(typenr, line)
7057 int typenr;
7058 int line;
7060 sign_T *sp;
7062 for (sp = first_sign; sp != NULL; sp = sp->sn_next)
7063 if (sp->sn_typenr == typenr)
7065 if (line)
7067 if (sp->sn_line_hl > 0)
7068 return syn_id2attr(sp->sn_line_hl);
7070 else
7072 if (sp->sn_text_hl > 0)
7073 return syn_id2attr(sp->sn_text_hl);
7075 break;
7077 return 0;
7081 * Get text mark for sign "typenr".
7082 * Returns NULL if there isn't one.
7084 char_u *
7085 sign_get_text(typenr)
7086 int typenr;
7088 sign_T *sp;
7090 for (sp = first_sign; sp != NULL; sp = sp->sn_next)
7091 if (sp->sn_typenr == typenr)
7092 return sp->sn_text;
7093 return NULL;
7096 #if defined(FEAT_SIGN_ICONS) || defined(PROTO)
7097 void *
7098 sign_get_image(typenr)
7099 int typenr; /* the attribute which may have a sign */
7101 sign_T *sp;
7103 for (sp = first_sign; sp != NULL; sp = sp->sn_next)
7104 if (sp->sn_typenr == typenr)
7105 return sp->sn_image;
7106 return NULL;
7108 #endif
7111 * Get the name of a sign by its typenr.
7113 char_u *
7114 sign_typenr2name(typenr)
7115 int typenr;
7117 sign_T *sp;
7119 for (sp = first_sign; sp != NULL; sp = sp->sn_next)
7120 if (sp->sn_typenr == typenr)
7121 return sp->sn_name;
7122 return (char_u *)_("[Deleted]");
7125 #if defined(EXITFREE) || defined(PROTO)
7127 * Undefine/free all signs.
7129 void
7130 free_signs()
7132 while (first_sign != NULL)
7133 sign_undefine(first_sign, NULL);
7135 #endif
7137 #if defined(FEAT_CMDL_COMPL) || defined(PROTO)
7138 static enum
7140 EXP_SUBCMD, /* expand :sign sub-commands */
7141 EXP_DEFINE, /* expand :sign define {name} args */
7142 EXP_PLACE, /* expand :sign place {id} args */
7143 EXP_UNPLACE, /* expand :sign unplace" */
7144 EXP_SIGN_NAMES /* expand with name of placed signs */
7145 } expand_what;
7148 * Function given to ExpandGeneric() to obtain the sign command
7149 * expansion.
7151 char_u *
7152 get_sign_name(xp, idx)
7153 expand_T *xp UNUSED;
7154 int idx;
7156 sign_T *sp;
7157 int current_idx;
7159 switch (expand_what)
7161 case EXP_SUBCMD:
7162 return (char_u *)cmds[idx];
7163 case EXP_DEFINE:
7165 char *define_arg[] =
7167 "icon=", "linehl=", "text=", "texthl=", NULL
7169 return (char_u *)define_arg[idx];
7171 case EXP_PLACE:
7173 char *place_arg[] =
7175 "line=", "name=", "file=", "buffer=", NULL
7177 return (char_u *)place_arg[idx];
7179 case EXP_UNPLACE:
7181 char *unplace_arg[] = { "file=", "buffer=", NULL };
7182 return (char_u *)unplace_arg[idx];
7184 case EXP_SIGN_NAMES:
7185 /* Complete with name of signs already defined */
7186 current_idx = 0;
7187 for (sp = first_sign; sp != NULL; sp = sp->sn_next)
7188 if (current_idx++ == idx)
7189 return sp->sn_name;
7190 return NULL;
7191 default:
7192 return NULL;
7197 * Handle command line completion for :sign command.
7199 void
7200 set_context_in_sign_cmd(xp, arg)
7201 expand_T *xp;
7202 char_u *arg;
7204 char_u *p;
7205 char_u *end_subcmd;
7206 char_u *last;
7207 int cmd_idx;
7208 char_u *begin_subcmd_args;
7210 /* Default: expand subcommands. */
7211 xp->xp_context = EXPAND_SIGN;
7212 expand_what = EXP_SUBCMD;
7213 xp->xp_pattern = arg;
7215 end_subcmd = skiptowhite(arg);
7216 if (*end_subcmd == NUL)
7217 /* expand subcmd name
7218 * :sign {subcmd}<CTRL-D>*/
7219 return;
7221 cmd_idx = sign_cmd_idx(arg, end_subcmd);
7223 /* :sign {subcmd} {subcmd_args}
7225 * begin_subcmd_args */
7226 begin_subcmd_args = skipwhite(end_subcmd);
7227 p = skiptowhite(begin_subcmd_args);
7228 if (*p == NUL)
7231 * Expand first argument of subcmd when possible.
7232 * For ":jump {id}" and ":unplace {id}", we could
7233 * possibly expand the ids of all signs already placed.
7235 xp->xp_pattern = begin_subcmd_args;
7236 switch (cmd_idx)
7238 case SIGNCMD_LIST:
7239 case SIGNCMD_UNDEFINE:
7240 /* :sign list <CTRL-D>
7241 * :sign undefine <CTRL-D> */
7242 expand_what = EXP_SIGN_NAMES;
7243 break;
7244 default:
7245 xp->xp_context = EXPAND_NOTHING;
7247 return;
7250 /* expand last argument of subcmd */
7252 /* :sign define {name} {args}...
7254 * p */
7256 /* Loop until reaching last argument. */
7259 p = skipwhite(p);
7260 last = p;
7261 p = skiptowhite(p);
7262 } while (*p != NUL);
7264 p = vim_strchr(last, '=');
7266 /* :sign define {name} {args}... {last}=
7267 * | |
7268 * last p */
7269 if (p == NUL)
7271 /* Expand last argument name (before equal sign). */
7272 xp->xp_pattern = last;
7273 switch (cmd_idx)
7275 case SIGNCMD_DEFINE:
7276 expand_what = EXP_DEFINE;
7277 break;
7278 case SIGNCMD_PLACE:
7279 expand_what = EXP_PLACE;
7280 break;
7281 case SIGNCMD_JUMP:
7282 case SIGNCMD_UNPLACE:
7283 expand_what = EXP_UNPLACE;
7284 break;
7285 default:
7286 xp->xp_context = EXPAND_NOTHING;
7289 else
7291 /* Expand last argument value (after equal sign). */
7292 xp->xp_pattern = p + 1;
7293 switch (cmd_idx)
7295 case SIGNCMD_DEFINE:
7296 if (STRNCMP(last, "texthl", p - last) == 0 ||
7297 STRNCMP(last, "linehl", p - last) == 0)
7298 xp->xp_context = EXPAND_HIGHLIGHT;
7299 else if (STRNCMP(last, "icon", p - last) == 0)
7300 xp->xp_context = EXPAND_FILES;
7301 else
7302 xp->xp_context = EXPAND_NOTHING;
7303 break;
7304 case SIGNCMD_PLACE:
7305 if (STRNCMP(last, "name", p - last) == 0)
7306 expand_what = EXP_SIGN_NAMES;
7307 else
7308 xp->xp_context = EXPAND_NOTHING;
7309 break;
7310 default:
7311 xp->xp_context = EXPAND_NOTHING;
7315 #endif
7316 #endif
7318 #if defined(FEAT_GUI) || defined(FEAT_CLIENTSERVER) || defined(PROTO)
7320 * ":drop"
7321 * Opens the first argument in a window. When there are two or more arguments
7322 * the argument list is redefined.
7324 void
7325 ex_drop(eap)
7326 exarg_T *eap;
7328 int split = FALSE;
7329 win_T *wp;
7330 buf_T *buf;
7331 # ifdef FEAT_WINDOWS
7332 tabpage_T *tp;
7333 # endif
7336 * Check if the first argument is already being edited in a window. If
7337 * so, jump to that window.
7338 * We would actually need to check all arguments, but that's complicated
7339 * and mostly only one file is dropped.
7340 * This also ignores wildcards, since it is very unlikely the user is
7341 * editing a file name with a wildcard character.
7343 set_arglist(eap->arg);
7346 * Expanding wildcards may result in an empty argument list. E.g. when
7347 * editing "foo.pyc" and ".pyc" is in 'wildignore'. Assume that we
7348 * already did an error message for this.
7350 if (ARGCOUNT == 0)
7351 return;
7353 # ifdef FEAT_WINDOWS
7354 if (cmdmod.tab)
7356 /* ":tab drop file ...": open a tab for each argument that isn't
7357 * edited in a window yet. It's like ":tab all" but without closing
7358 * windows or tabs. */
7359 ex_all(eap);
7361 else
7362 # endif
7364 /* ":drop file ...": Edit the first argument. Jump to an existing
7365 * window if possible, edit in current window if the current buffer
7366 * can be abandoned, otherwise open a new window. */
7367 buf = buflist_findnr(ARGLIST[0].ae_fnum);
7369 FOR_ALL_TAB_WINDOWS(tp, wp)
7371 if (wp->w_buffer == buf)
7373 # ifdef FEAT_WINDOWS
7374 goto_tabpage_win(tp, wp);
7375 # endif
7376 curwin->w_arg_idx = 0;
7377 return;
7382 * Check whether the current buffer is changed. If so, we will need
7383 * to split the current window or data could be lost.
7384 * Skip the check if the 'hidden' option is set, as in this case the
7385 * buffer won't be lost.
7387 if (!P_HID(curbuf))
7389 # ifdef FEAT_WINDOWS
7390 ++emsg_off;
7391 # endif
7392 split = check_changed(curbuf, TRUE, FALSE, FALSE, FALSE);
7393 # ifdef FEAT_WINDOWS
7394 --emsg_off;
7395 # else
7396 if (split)
7397 return;
7398 # endif
7401 /* Fake a ":sfirst" or ":first" command edit the first argument. */
7402 if (split)
7404 eap->cmdidx = CMD_sfirst;
7405 eap->cmd[0] = 's';
7407 else
7408 eap->cmdidx = CMD_first;
7409 ex_rewind(eap);
7412 #endif