xref: /vim-8.2.3635/src/structs.h (revision 044b68f4)
1 /* vi:set ts=8 sts=4 sw=4:
2  *
3  * VIM - Vi IMproved	by Bram Moolenaar
4  *
5  * Do ":help uganda"  in Vim to read copying and usage conditions.
6  * Do ":help credits" in Vim to see a list of people who contributed.
7  */
8 
9 /*
10  * This file contains various definitions of structures that are used by Vim
11  */
12 
13 /*
14  * There is something wrong in the SAS compiler that makes typedefs not
15  * valid in include files.  Has been fixed in version 6.58.
16  */
17 #if defined(SASC) && SASC < 658
18 typedef long		linenr_T;
19 typedef unsigned	colnr_T;
20 typedef unsigned short	short_u;
21 #endif
22 
23 /*
24  * position in file or buffer
25  */
26 typedef struct
27 {
28     linenr_T	lnum;	/* line number */
29     colnr_T	col;	/* column number */
30 #ifdef FEAT_VIRTUALEDIT
31     colnr_T	coladd;
32 #endif
33 } pos_T;
34 
35 #ifdef FEAT_VIRTUALEDIT
36 # define INIT_POS_T {0, 0, 0}
37 #else
38 # define INIT_POS_T {0, 0}
39 #endif
40 
41 /*
42  * Same, but without coladd.
43  */
44 typedef struct
45 {
46     linenr_T	lnum;	/* line number */
47     colnr_T	col;	/* column number */
48 } lpos_T;
49 
50 /*
51  * Structure used for growing arrays.
52  * This is used to store information that only grows, is deleted all at
53  * once, and needs to be accessed by index.  See ga_clear() and ga_grow().
54  */
55 typedef struct growarray
56 {
57     int	    ga_len;		    /* current number of items used */
58     int	    ga_maxlen;		    /* maximum number of items possible */
59     int	    ga_itemsize;	    /* sizeof(item) */
60     int	    ga_growsize;	    /* number of items to grow each time */
61     void    *ga_data;		    /* pointer to the first item */
62 } garray_T;
63 
64 #define GA_EMPTY    {0, 0, 0, 0, NULL}
65 
66 /*
67  * This is here because regexp.h needs pos_T and below regprog_T is used.
68  */
69 #include "regexp.h"
70 
71 typedef struct window_S		win_T;
72 typedef struct wininfo_S	wininfo_T;
73 typedef struct frame_S		frame_T;
74 typedef int			scid_T;		/* script ID */
75 
76 /*
77  * This is here because gui.h needs the pos_T and win_T, and win_T needs gui.h
78  * for scrollbar_T.
79  */
80 #ifdef FEAT_GUI
81 # include "gui.h"
82 #else
83 # ifdef FEAT_XCLIPBOARD
84 #  include <X11/Intrinsic.h>
85 # endif
86 # define guicolor_T int		/* avoid error in prototypes */
87 #endif
88 
89 /*
90  * marks: positions in a file
91  * (a normal mark is a lnum/col pair, the same as a file position)
92  */
93 
94 /* (Note: for EBCDIC there are more than 26, because there are gaps in the
95  * alphabet coding.  To minimize changes to the code, I decided to just
96  * increase the number of possible marks. */
97 #define NMARKS		('z' - 'a' + 1)	/* max. # of named marks */
98 #define JUMPLISTSIZE	100		/* max. # of marks in jump list */
99 #define TAGSTACKSIZE	20		/* max. # of tags in tag stack */
100 
101 typedef struct filemark
102 {
103     pos_T	mark;		/* cursor position */
104     int		fnum;		/* file number */
105 } fmark_T;
106 
107 /* Xtended file mark: also has a file name */
108 typedef struct xfilemark
109 {
110     fmark_T	fmark;
111     char_u	*fname;		/* file name, used when fnum == 0 */
112 } xfmark_T;
113 
114 /*
115  * The taggy struct is used to store the information about a :tag command.
116  */
117 typedef struct taggy
118 {
119     char_u	*tagname;	/* tag name */
120     fmark_T	fmark;		/* cursor position BEFORE ":tag" */
121     int		cur_match;	/* match number */
122     int		cur_fnum;	/* buffer number used for cur_match */
123 } taggy_T;
124 
125 /*
126  * Structure that contains all options that are local to a window.
127  * Used twice in a window: for the current buffer and for all buffers.
128  * Also used in wininfo_T.
129  */
130 typedef struct
131 {
132 #ifdef FEAT_ARABIC
133     int		wo_arab;
134 # define w_p_arab w_onebuf_opt.wo_arab	/* 'arabic' */
135 #endif
136 #ifdef FEAT_DIFF
137     int		wo_diff;
138 # define w_p_diff w_onebuf_opt.wo_diff	/* 'diff' */
139 #endif
140 #ifdef FEAT_FOLDING
141     long	wo_fdc;
142 # define w_p_fdc w_onebuf_opt.wo_fdc	/* 'foldcolumn' */
143     int		wo_fen;
144 # define w_p_fen w_onebuf_opt.wo_fen	/* 'foldenable' */
145     char_u	*wo_fdi;
146 # define w_p_fdi w_onebuf_opt.wo_fdi	/* 'foldignore' */
147     long	wo_fdl;
148 # define w_p_fdl w_onebuf_opt.wo_fdl	/* 'foldlevel' */
149     char_u	*wo_fdm;
150 # define w_p_fdm w_onebuf_opt.wo_fdm	/* 'foldmethod' */
151     long	wo_fml;
152 # define w_p_fml w_onebuf_opt.wo_fml	/* 'foldminlines' */
153     long	wo_fdn;
154 # define w_p_fdn w_onebuf_opt.wo_fdn	/* 'foldnestmax' */
155 # ifdef FEAT_EVAL
156     char_u	*wo_fde;
157 # define w_p_fde w_onebuf_opt.wo_fde	/* 'foldexpr' */
158     char_u	*wo_fdt;
159 #  define w_p_fdt w_onebuf_opt.wo_fdt	/* 'foldtext' */
160 # endif
161     char_u	*wo_fmr;
162 # define w_p_fmr w_onebuf_opt.wo_fmr	/* 'foldmarker' */
163 #endif
164 #ifdef FEAT_LINEBREAK
165     int		wo_lbr;
166 # define w_p_lbr w_onebuf_opt.wo_lbr	/* 'linebreak' */
167 #endif
168     int		wo_list;
169 #define w_p_list w_onebuf_opt.wo_list	/* 'list' */
170     int		wo_nu;
171 #define w_p_nu w_onebuf_opt.wo_nu	/* 'number' */
172 #ifdef FEAT_LINEBREAK
173     long	wo_nuw;
174 # define w_p_nuw w_onebuf_opt.wo_nuw	/* 'numberwidth' */
175 #endif
176 #if defined(FEAT_WINDOWS)
177     int		wo_wfh;
178 # define w_p_wfh w_onebuf_opt.wo_wfh	/* 'winfixheight' */
179     int		wo_wfw;
180 # define w_p_wfw w_onebuf_opt.wo_wfw	/* 'winfixwidth' */
181 #endif
182 #if defined(FEAT_WINDOWS) && defined(FEAT_QUICKFIX)
183     int		wo_pvw;
184 # define w_p_pvw w_onebuf_opt.wo_pvw	/* 'previewwindow' */
185 #endif
186 #ifdef FEAT_RIGHTLEFT
187     int		wo_rl;
188 # define w_p_rl w_onebuf_opt.wo_rl	/* 'rightleft' */
189     char_u	*wo_rlc;
190 # define w_p_rlc w_onebuf_opt.wo_rlc	/* 'rightleftcmd' */
191 #endif
192     long	wo_scr;
193 #define w_p_scr w_onebuf_opt.wo_scr	/* 'scroll' */
194 #ifdef FEAT_SPELL
195     int		wo_spell;
196 # define w_p_spell w_onebuf_opt.wo_spell /* 'spell' */
197 #endif
198 #ifdef FEAT_SYN_HL
199     int		wo_cuc;
200 # define w_p_cuc w_onebuf_opt.wo_cuc	/* 'cursorcolumn' */
201     int		wo_cul;
202 # define w_p_cul w_onebuf_opt.wo_cul	/* 'cursorline' */
203 #endif
204 #ifdef FEAT_STL_OPT
205     char_u	*wo_stl;
206 #define w_p_stl w_onebuf_opt.wo_stl	/* 'statusline' */
207 #endif
208 #ifdef FEAT_SCROLLBIND
209     int		wo_scb;
210 # define w_p_scb w_onebuf_opt.wo_scb	/* 'scrollbind' */
211 #endif
212     int		wo_wrap;
213 #define w_p_wrap w_onebuf_opt.wo_wrap	/* 'wrap' */
214 
215 #ifdef FEAT_EVAL
216     int		wo_scriptID[WV_COUNT];	/* SIDs for window-local options */
217 # define w_p_scriptID w_onebuf_opt.wo_scriptID
218 #endif
219 } winopt_T;
220 
221 /*
222  * Window info stored with a buffer.
223  *
224  * Two types of info are kept for a buffer which are associated with a
225  * specific window:
226  * 1. Each window can have a different line number associated with a buffer.
227  * 2. The window-local options for a buffer work in a similar way.
228  * The window-info is kept in a list at b_wininfo.  It is kept in
229  * most-recently-used order.
230  */
231 struct wininfo_S
232 {
233     wininfo_T	*wi_next;	/* next entry or NULL for last entry */
234     wininfo_T	*wi_prev;	/* previous entry or NULL for first entry */
235     win_T	*wi_win;	/* pointer to window that did set wi_lnum */
236     pos_T	wi_fpos;	/* last cursor position in the file */
237     int		wi_optset;	/* TRUE when wi_opt has useful values */
238     winopt_T	wi_opt;		/* local window options */
239 #ifdef FEAT_FOLDING
240     int		wi_fold_manual;	/* copy of w_fold_manual */
241     garray_T	wi_folds;	/* clone of w_folds */
242 #endif
243 };
244 
245 /*
246  * Info used to pass info about a fold from the fold-detection code to the
247  * code that displays the foldcolumn.
248  */
249 typedef struct foldinfo
250 {
251     int		fi_level;	/* level of the fold; when this is zero the
252 				   other fields are invalid */
253     int		fi_lnum;	/* line number where fold starts */
254     int		fi_low_level;	/* lowest fold level that starts in the same
255 				   line */
256 } foldinfo_T;
257 
258 /* Structure to store info about the Visual area. */
259 typedef struct
260 {
261     pos_T	vi_start;	/* start pos of last VIsual */
262     pos_T	vi_end;		/* end position of last VIsual */
263     int		vi_mode;	/* VIsual_mode of last VIsual */
264     colnr_T	vi_curswant;	/* MAXCOL from w_curswant */
265 } visualinfo_T;
266 
267 /*
268  * stuctures used for undo
269  */
270 
271 typedef struct u_entry u_entry_T;
272 typedef struct u_header u_header_T;
273 struct u_entry
274 {
275     u_entry_T	*ue_next;	/* pointer to next entry in list */
276     linenr_T	ue_top;		/* number of line above undo block */
277     linenr_T	ue_bot;		/* number of line below undo block */
278     linenr_T	ue_lcount;	/* linecount when u_save called */
279     char_u	**ue_array;	/* array of lines in undo block */
280     long	ue_size;	/* number of lines in ue_array */
281 };
282 
283 struct u_header
284 {
285     u_header_T	*uh_next;	/* pointer to next undo header in list */
286     u_header_T	*uh_prev;	/* pointer to previous header in list */
287     u_header_T	*uh_alt_next;	/* pointer to next header for alt. redo */
288     u_header_T	*uh_alt_prev;	/* pointer to previous header for alt. redo */
289     long	uh_seq;		/* sequence number, higher == newer undo */
290     int		uh_walk;	/* used by undo_time() */
291     u_entry_T	*uh_entry;	/* pointer to first entry */
292     u_entry_T	*uh_getbot_entry; /* pointer to where ue_bot must be set */
293     pos_T	uh_cursor;	/* cursor position before saving */
294 #ifdef FEAT_VIRTUALEDIT
295     long	uh_cursor_vcol;
296 #endif
297     int		uh_flags;	/* see below */
298     pos_T	uh_namedm[NMARKS];	/* marks before undo/after redo */
299 #ifdef FEAT_VISUAL
300     visualinfo_T uh_visual;	/* Visual areas before undo/after redo */
301 #endif
302     time_t	uh_time;	/* timestamp when the change was made */
303 };
304 
305 /* values for uh_flags */
306 #define UH_CHANGED  0x01	/* b_changed flag before undo/after redo */
307 #define UH_EMPTYBUF 0x02	/* buffer was empty */
308 
309 /*
310  * stuctures used in undo.c
311  */
312 #if SIZEOF_INT > 2
313 # define ALIGN_LONG	/* longword alignment and use filler byte */
314 # define ALIGN_SIZE (sizeof(long))
315 #else
316 # define ALIGN_SIZE (sizeof(short))
317 #endif
318 
319 #define ALIGN_MASK (ALIGN_SIZE - 1)
320 
321 typedef struct m_info minfo_T;
322 
323 /*
324  * stucture used to link chunks in one of the free chunk lists.
325  */
326 struct m_info
327 {
328 #ifdef ALIGN_LONG
329     long_u	m_size;		/* size of the chunk (including m_info) */
330 #else
331     short_u	m_size;		/* size of the chunk (including m_info) */
332 #endif
333     minfo_T	*m_next;	/* pointer to next free chunk in the list */
334 };
335 
336 /*
337  * structure used to link blocks in the list of allocated blocks.
338  */
339 typedef struct m_block mblock_T;
340 struct m_block
341 {
342     mblock_T	*mb_next;	/* pointer to next allocated block */
343     size_t	mb_size;	/* total size of all chunks in this block */
344     size_t	mb_maxsize;	/* size of largest fee chunk */
345     minfo_T	mb_info;	/* head of free chunk list for this block */
346 };
347 
348 /*
349  * things used in memfile.c
350  */
351 
352 typedef struct block_hdr    bhdr_T;
353 typedef struct memfile	    memfile_T;
354 typedef long		    blocknr_T;
355 
356 /*
357  * for each (previously) used block in the memfile there is one block header.
358  *
359  * The block may be linked in the used list OR in the free list.
360  * The used blocks are also kept in hash lists.
361  *
362  * The used list is a doubly linked list, most recently used block first.
363  *	The blocks in the used list have a block of memory allocated.
364  *	mf_used_count is the number of pages in the used list.
365  * The hash lists are used to quickly find a block in the used list.
366  * The free list is a single linked list, not sorted.
367  *	The blocks in the free list have no block of memory allocated and
368  *	the contents of the block in the file (if any) is irrelevant.
369  */
370 
371 struct block_hdr
372 {
373     bhdr_T	*bh_next;	    /* next block_hdr in free or used list */
374     bhdr_T	*bh_prev;	    /* previous block_hdr in used list */
375     bhdr_T	*bh_hash_next;	    /* next block_hdr in hash list */
376     bhdr_T	*bh_hash_prev;	    /* previous block_hdr in hash list */
377     blocknr_T	bh_bnum;		/* block number */
378     char_u	*bh_data;	    /* pointer to memory (for used block) */
379     int		bh_page_count;	    /* number of pages in this block */
380 
381 #define BH_DIRTY    1
382 #define BH_LOCKED   2
383     char	bh_flags;	    /* BH_DIRTY or BH_LOCKED */
384 };
385 
386 /*
387  * when a block with a negative number is flushed to the file, it gets
388  * a positive number. Because the reference to the block is still the negative
389  * number, we remember the translation to the new positive number in the
390  * double linked trans lists. The structure is the same as the hash lists.
391  */
392 typedef struct nr_trans NR_TRANS;
393 
394 struct nr_trans
395 {
396     NR_TRANS	*nt_next;		/* next nr_trans in hash list */
397     NR_TRANS	*nt_prev;		/* previous nr_trans in hash list */
398     blocknr_T	nt_old_bnum;		/* old, negative, number */
399     blocknr_T	nt_new_bnum;		/* new, positive, number */
400 };
401 
402 /*
403  * structure used to store one block of the stuff/redo/recording buffers
404  */
405 struct buffblock
406 {
407     struct buffblock	*b_next;	/* pointer to next buffblock */
408     char_u		b_str[1];	/* contents (actually longer) */
409 };
410 
411 /*
412  * header used for the stuff buffer and the redo buffer
413  */
414 struct buffheader
415 {
416     struct buffblock	bh_first;	/* first (dummy) block of list */
417     struct buffblock	*bh_curr;	/* buffblock for appending */
418     int			bh_index;	/* index for reading */
419     int			bh_space;	/* space in bh_curr for appending */
420 };
421 
422 /*
423  * used for completion on the command line
424  */
425 typedef struct expand
426 {
427     int		xp_context;		/* type of expansion */
428     char_u	*xp_pattern;		/* start of item to expand */
429 #if defined(FEAT_USR_CMDS) && defined(FEAT_EVAL) && defined(FEAT_CMDL_COMPL)
430     char_u	*xp_arg;		/* completion function */
431     int		xp_scriptID;		/* SID for completion function */
432 #endif
433     int		xp_backslash;		/* one of the XP_BS_ values */
434 #ifndef BACKSLASH_IN_FILENAME
435     int		xp_shell;		/* for a shell command more characters
436 					   need to be escaped */
437 #endif
438     int		xp_numfiles;		/* number of files found by
439 						    file name completion */
440     char_u	**xp_files;		/* list of files */
441 } expand_T;
442 
443 /* values for xp_backslash */
444 #define XP_BS_NONE	0	/* nothing special for backslashes */
445 #define XP_BS_ONE	1	/* uses one backslash before a space */
446 #define XP_BS_THREE	2	/* uses three backslashes before a space */
447 
448 /*
449  * Command modifiers ":vertical", ":browse", ":confirm" and ":hide" set a flag.
450  * This needs to be saved for recursive commands, put them in a structure for
451  * easy manipulation.
452  */
453 typedef struct
454 {
455     int		hide;			/* TRUE when ":hide" was used */
456 # ifdef FEAT_BROWSE
457     int		browse;			/* TRUE to invoke file dialog */
458 # endif
459 # ifdef FEAT_WINDOWS
460     int		split;			/* flags for win_split() */
461     int		tab;			/* > 0 when ":tab" was used */
462 # endif
463 # if defined(FEAT_GUI_DIALOG) || defined(FEAT_CON_DIALOG)
464     int		confirm;		/* TRUE to invoke yes/no dialog */
465 # endif
466     int		keepalt;		/* TRUE when ":keepalt" was used */
467     int		keepmarks;		/* TRUE when ":keepmarks" was used */
468     int		keepjumps;		/* TRUE when ":keepjumps" was used */
469     int		lockmarks;		/* TRUE when ":lockmarks" was used */
470 # ifdef FEAT_AUTOCMD
471     char_u	*save_ei;		/* saved value of 'eventignore' */
472 # endif
473 } cmdmod_T;
474 
475 /*
476  * Simplistic hashing scheme to quickly locate the blocks in the used list.
477  * 64 blocks are found directly (64 * 4K = 256K, most files are smaller).
478  */
479 #define MEMHASHSIZE	64
480 #define MEMHASH(nr)	((nr) & (MEMHASHSIZE - 1))
481 
482 struct memfile
483 {
484     char_u	*mf_fname;		/* name of the file */
485     char_u	*mf_ffname;		/* idem, full path */
486     int		mf_fd;			/* file descriptor */
487     bhdr_T	*mf_free_first;		/* first block_hdr in free list */
488     bhdr_T	*mf_used_first;		/* mru block_hdr in used list */
489     bhdr_T	*mf_used_last;		/* lru block_hdr in used list */
490     unsigned	mf_used_count;		/* number of pages in used list */
491     unsigned	mf_used_count_max;	/* maximum number of pages in memory */
492     bhdr_T	*mf_hash[MEMHASHSIZE];	/* array of hash lists */
493     NR_TRANS	*mf_trans[MEMHASHSIZE];	/* array of trans lists */
494     blocknr_T	mf_blocknr_max;		/* highest positive block number + 1*/
495     blocknr_T	mf_blocknr_min;		/* lowest negative block number - 1 */
496     blocknr_T	mf_neg_count;		/* number of negative blocks numbers */
497     blocknr_T	mf_infile_count;	/* number of pages in the file */
498     unsigned	mf_page_size;		/* number of bytes in a page */
499     int		mf_dirty;		/* TRUE if there are dirty blocks */
500 };
501 
502 /*
503  * things used in memline.c
504  */
505 /*
506  * When searching for a specific line, we remember what blocks in the tree
507  * are the branches leading to that block. This is stored in ml_stack.  Each
508  * entry is a pointer to info in a block (may be data block or pointer block)
509  */
510 typedef struct info_pointer
511 {
512     blocknr_T	ip_bnum;	/* block number */
513     linenr_T	ip_low;		/* lowest lnum in this block */
514     linenr_T	ip_high;	/* highest lnum in this block */
515     int		ip_index;	/* index for block with current lnum */
516 } infoptr_T;	/* block/index pair */
517 
518 #ifdef FEAT_BYTEOFF
519 typedef struct ml_chunksize
520 {
521     int		mlcs_numlines;
522     long	mlcs_totalsize;
523 } chunksize_T;
524 
525  /* Flags when calling ml_updatechunk() */
526 
527 #define ML_CHNK_ADDLINE 1
528 #define ML_CHNK_DELLINE 2
529 #define ML_CHNK_UPDLINE 3
530 #endif
531 
532 /*
533  * the memline structure holds all the information about a memline
534  */
535 typedef struct memline
536 {
537     linenr_T	ml_line_count;	/* number of lines in the buffer */
538 
539     memfile_T	*ml_mfp;	/* pointer to associated memfile */
540 
541 #define ML_EMPTY	1	/* empty buffer */
542 #define ML_LINE_DIRTY	2	/* cached line was changed and allocated */
543 #define ML_LOCKED_DIRTY	4	/* ml_locked was changed */
544 #define ML_LOCKED_POS	8	/* ml_locked needs positive block number */
545     int		ml_flags;
546 
547     infoptr_T	*ml_stack;	/* stack of pointer blocks (array of IPTRs) */
548     int		ml_stack_top;	/* current top if ml_stack */
549     int		ml_stack_size;	/* total number of entries in ml_stack */
550 
551     linenr_T	ml_line_lnum;	/* line number of cached line, 0 if not valid */
552     char_u	*ml_line_ptr;	/* pointer to cached line */
553 
554     bhdr_T	*ml_locked;	/* block used by last ml_get */
555     linenr_T	ml_locked_low;	/* first line in ml_locked */
556     linenr_T	ml_locked_high;	/* last line in ml_locked */
557     int		ml_locked_lineadd;  /* number of lines inserted in ml_locked */
558 #ifdef FEAT_BYTEOFF
559     chunksize_T *ml_chunksize;
560     int		ml_numchunks;
561     int		ml_usedchunks;
562 #endif
563 } memline_T;
564 
565 #if defined(FEAT_SIGNS) || defined(PROTO)
566 typedef struct signlist signlist_T;
567 
568 struct signlist
569 {
570     int		id;		/* unique identifier for each placed sign */
571     linenr_T	lnum;		/* line number which has this sign */
572     int		typenr;		/* typenr of sign */
573     signlist_T	*next;		/* next signlist entry */
574 # ifdef FEAT_NETBEANS_INTG
575     signlist_T  *prev;		/* previous entry -- for easy reordering */
576 # endif
577 };
578 
579 /* type argument for buf_getsigntype() */
580 #define SIGN_ANY	0
581 #define SIGN_LINEHL	1
582 #define SIGN_ICON	2
583 #define SIGN_TEXT	3
584 #endif
585 
586 /*
587  * Argument list: Array of file names.
588  * Used for the global argument list and the argument lists local to a window.
589  */
590 typedef struct arglist
591 {
592     garray_T	al_ga;		/* growarray with the array of file names */
593     int		al_refcount;	/* number of windows using this arglist */
594 } alist_T;
595 
596 /*
597  * For each argument remember the file name as it was given, and the buffer
598  * number that contains the expanded file name (required for when ":cd" is
599  * used.
600  */
601 typedef struct argentry
602 {
603     char_u	*ae_fname;	/* file name as specified */
604     int		ae_fnum;	/* buffer number with expanded file name */
605 } aentry_T;
606 
607 #ifdef FEAT_WINDOWS
608 # define ALIST(win) (win)->w_alist
609 #else
610 # define ALIST(win) (&global_alist)
611 #endif
612 #define GARGLIST	((aentry_T *)global_alist.al_ga.ga_data)
613 #define ARGLIST		((aentry_T *)ALIST(curwin)->al_ga.ga_data)
614 #define WARGLIST(wp)	((aentry_T *)ALIST(wp)->al_ga.ga_data)
615 #define AARGLIST(al)	((aentry_T *)((al)->al_ga.ga_data))
616 #define GARGCOUNT	(global_alist.al_ga.ga_len)
617 #define ARGCOUNT	(ALIST(curwin)->al_ga.ga_len)
618 #define WARGCOUNT(wp)	(ALIST(wp)->al_ga.ga_len)
619 
620 /*
621  * A list used for saving values of "emsg_silent".  Used by ex_try() to save the
622  * value of "emsg_silent" if it was non-zero.  When this is done, the CSF_SILENT
623  * flag below is set.
624  */
625 
626 typedef struct eslist_elem eslist_T;
627 struct eslist_elem
628 {
629     int		saved_emsg_silent;	/* saved value of "emsg_silent" */
630     eslist_T	*next;			/* next element on the list */
631 };
632 
633 /*
634  * For conditional commands a stack is kept of nested conditionals.
635  * When cs_idx < 0, there is no conditional command.
636  */
637 #define CSTACK_LEN	50
638 
639 struct condstack
640 {
641     short	cs_flags[CSTACK_LEN];	/* CSF_ flags */
642     char	cs_pending[CSTACK_LEN];	/* CSTP_: what's pending in ":finally"*/
643     union {
644 	void	*csp_rv[CSTACK_LEN];	/* return typeval for pending return */
645 	void	*csp_ex[CSTACK_LEN];	/* exception for pending throw */
646     }		cs_pend;
647     void	*cs_forinfo[CSTACK_LEN]; /* info used by ":for" */
648     int		cs_line[CSTACK_LEN];	/* line nr of ":while"/":for" line */
649     int		cs_idx;			/* current entry, or -1 if none */
650     int		cs_looplevel;		/* nr of nested ":while"s and ":for"s */
651     int		cs_trylevel;		/* nr of nested ":try"s */
652     eslist_T	*cs_emsg_silent_list;	/* saved values of "emsg_silent" */
653     char	cs_lflags;		/* loop flags: CSL_ flags */
654 };
655 # define cs_rettv	cs_pend.csp_rv
656 # define cs_exception	cs_pend.csp_ex
657 
658 /* There is no CSF_IF, the lack of CSF_WHILE, CSF_FOR and CSF_TRY means ":if"
659  * was used. */
660 # define CSF_TRUE	0x0001	/* condition was TRUE */
661 # define CSF_ACTIVE	0x0002	/* current state is active */
662 # define CSF_ELSE	0x0004	/* ":else" has been passed */
663 # define CSF_WHILE	0x0008	/* is a ":while" */
664 # define CSF_FOR	0x0010	/* is a ":for" */
665 
666 # define CSF_TRY	0x0100	/* is a ":try" */
667 # define CSF_FINALLY	0x0200	/* ":finally" has been passed */
668 # define CSF_THROWN	0x0400	/* exception thrown to this try conditional */
669 # define CSF_CAUGHT	0x0800  /* exception caught by this try conditional */
670 # define CSF_SILENT	0x1000	/* "emsg_silent" reset by ":try" */
671 /* Note that CSF_ELSE is only used when CSF_TRY and CSF_WHILE are unset
672  * (an ":if"), and CSF_SILENT is only used when CSF_TRY is set. */
673 
674 /*
675  * What's pending for being reactivated at the ":endtry" of this try
676  * conditional:
677  */
678 # define CSTP_NONE	0	/* nothing pending in ":finally" clause */
679 # define CSTP_ERROR	1	/* an error is pending */
680 # define CSTP_INTERRUPT	2	/* an interrupt is pending */
681 # define CSTP_THROW	4	/* a throw is pending */
682 # define CSTP_BREAK	8	/* ":break" is pending */
683 # define CSTP_CONTINUE	16	/* ":continue" is pending */
684 # define CSTP_RETURN	24	/* ":return" is pending */
685 # define CSTP_FINISH	32	/* ":finish" is pending */
686 
687 /*
688  * Flags for the cs_lflags item in struct condstack.
689  */
690 # define CSL_HAD_LOOP	 1	/* just found ":while" or ":for" */
691 # define CSL_HAD_ENDLOOP 2	/* just found ":endwhile" or ":endfor" */
692 # define CSL_HAD_CONT	 4	/* just found ":continue" */
693 # define CSL_HAD_FINA	 8	/* just found ":finally" */
694 
695 /*
696  * A list of error messages that can be converted to an exception.  "throw_msg"
697  * is only set in the first element of the list.  Usually, it points to the
698  * original message stored in that element, but sometimes it points to a later
699  * message in the list.  See cause_errthrow() below.
700  */
701 struct msglist
702 {
703     char_u		*msg;		/* original message */
704     char_u		*throw_msg;	/* msg to throw: usually original one */
705     struct msglist	*next;		/* next of several messages in a row */
706 };
707 
708 /*
709  * Structure describing an exception.
710  * (don't use "struct exception", it's used by the math library).
711  */
712 typedef struct vim_exception except_T;
713 struct vim_exception
714 {
715     int			type;		/* exception type */
716     char_u		*value;		/* exception value */
717     struct msglist	*messages;	/* message(s) causing error exception */
718     char_u		*throw_name;	/* name of the throw point */
719     linenr_T		throw_lnum;	/* line number of the throw point */
720     except_T		*caught;	/* next exception on the caught stack */
721 };
722 
723 /*
724  * The exception types.
725  */
726 #define ET_USER		0	/* exception caused by ":throw" command */
727 #define ET_ERROR	1	/* error exception */
728 #define ET_INTERRUPT	2	/* interrupt exception triggered by Ctrl-C */
729 
730 /*
731  * Structure to save the error/interrupt/exception state between calls to
732  * enter_cleanup() and leave_cleanup().  Must be allocated as an automatic
733  * variable by the (common) caller of these functions.
734  */
735 typedef struct cleanup_stuff cleanup_T;
736 struct cleanup_stuff
737 {
738     int pending;		/* error/interrupt/exception state */
739     except_T *exception;	/* exception value */
740 };
741 
742 #ifdef FEAT_SYN_HL
743 /* struct passed to in_id_list() */
744 struct sp_syn
745 {
746     int		inc_tag;	/* ":syn include" unique tag */
747     short	id;		/* highlight group ID of item */
748     short	*cont_in_list;	/* cont.in group IDs, if non-zero */
749 };
750 
751 /*
752  * Each keyword has one keyentry, which is linked in a hash list.
753  */
754 typedef struct keyentry keyentry_T;
755 
756 struct keyentry
757 {
758     keyentry_T	*ke_next;	/* next entry with identical "keyword[]" */
759     struct sp_syn k_syn;	/* struct passed to in_id_list() */
760     short	*next_list;	/* ID list for next match (if non-zero) */
761     short	flags;		/* see syntax.c */
762     char_u	keyword[1];	/* actually longer */
763 };
764 
765 /*
766  * Struct used to store one state of the state stack.
767  */
768 typedef struct buf_state
769 {
770     int		    bs_idx;	 /* index of pattern */
771     long	    bs_flags;	 /* flags for pattern */
772     reg_extmatch_T *bs_extmatch; /* external matches from start pattern */
773 } bufstate_T;
774 
775 /*
776  * syn_state contains the syntax state stack for the start of one line.
777  * Used by b_sst_array[].
778  */
779 typedef struct syn_state synstate_T;
780 
781 struct syn_state
782 {
783     synstate_T	*sst_next;	/* next entry in used or free list */
784     linenr_T	sst_lnum;	/* line number for this state */
785     union
786     {
787 	bufstate_T	sst_stack[SST_FIX_STATES]; /* short state stack */
788 	garray_T	sst_ga;	/* growarray for long state stack */
789     } sst_union;
790     int		sst_next_flags;	/* flags for sst_next_list */
791     short	*sst_next_list;	/* "nextgroup" list in this state
792 				 * (this is a copy, don't free it! */
793     short	sst_stacksize;	/* number of states on the stack */
794     disptick_T	sst_tick;	/* tick when last displayed */
795     linenr_T	sst_change_lnum;/* when non-zero, change in this line
796 				 * may have made the state invalid */
797 };
798 #endif /* FEAT_SYN_HL */
799 
800 /*
801  * Structure shared between syntax.c, screen.c and gui_x11.c.
802  */
803 typedef struct attr_entry
804 {
805     short	    ae_attr;		/* HL_BOLD, etc. */
806     union
807     {
808 	struct
809 	{
810 	    char_u	    *start;	/* start escape sequence */
811 	    char_u	    *stop;	/* stop escape sequence */
812 	} term;
813 	struct
814 	{
815 	    /* These colors need to be > 8 bits to hold 256. */
816 	    short_u	    fg_color;	/* foreground color number */
817 	    short_u	    bg_color;	/* background color number */
818 	} cterm;
819 # ifdef FEAT_GUI
820 	struct
821 	{
822 	    guicolor_T	    fg_color;	/* foreground color handle */
823 	    guicolor_T	    bg_color;	/* background color handle */
824 	    guicolor_T	    sp_color;	/* special color handle */
825 	    GuiFont	    font;	/* font handle */
826 #  ifdef FEAT_XFONTSET
827 	    GuiFontset	    fontset;	/* fontset handle */
828 #  endif
829 	} gui;
830 # endif
831     } ae_u;
832 } attrentry_T;
833 
834 #ifdef USE_ICONV
835 # ifdef HAVE_ICONV_H
836 #  include <iconv.h>
837 # else
838 #  if defined(MACOS_X)
839 #   include <sys/errno.h>
840 #   define EILSEQ ENOENT /* MacOS X does not have EILSEQ */
841 typedef struct _iconv_t *iconv_t;
842 #  else
843 #   if defined(MACOS_CLASSIC)
844 typedef struct _iconv_t *iconv_t;
845 #    define EINVAL	22
846 #    define E2BIG	7
847 #    define ENOENT	2
848 #    define EFAULT	14
849 #    define EILSEQ	123
850 #   else
851 #    include <errno.h>
852 #   endif
853 #  endif
854 typedef void *iconv_t;
855 # endif
856 #endif
857 
858 /*
859  * Used for the typeahead buffer: typebuf.
860  */
861 typedef struct
862 {
863     char_u	*tb_buf;	/* buffer for typed characters */
864     char_u	*tb_noremap;	/* mapping flags for characters in tb_buf[] */
865     int		tb_buflen;	/* size of tb_buf[] */
866     int		tb_off;		/* current position in tb_buf[] */
867     int		tb_len;		/* number of valid bytes in tb_buf[] */
868     int		tb_maplen;	/* nr of mapped bytes in tb_buf[] */
869     int		tb_silent;	/* nr of silently mapped bytes in tb_buf[] */
870     int		tb_no_abbr_cnt; /* nr of bytes without abbrev. in tb_buf[] */
871     int		tb_change_cnt;	/* nr of time tb_buf was changed; never zero */
872 } typebuf_T;
873 
874 /* Struct to hold the saved typeahead for save_typeahead(). */
875 typedef struct
876 {
877     typebuf_T		save_typebuf;
878     int			typebuf_valid;	    /* TRUE when save_typebuf valid */
879     struct buffheader	save_stuffbuff;
880 #ifdef USE_INPUT_BUF
881     char_u		*save_inputbuf;
882 #endif
883 } tasave_T;
884 
885 /*
886  * Used for conversion of terminal I/O and script files.
887  */
888 typedef struct
889 {
890     int		vc_type;	/* zero or one of the CONV_ values */
891     int		vc_factor;	/* max. expansion factor */
892 # ifdef WIN3264
893     int		vc_cpfrom;	/* codepage to convert from (CONV_CODEPAGE) */
894     int		vc_cpto;	/* codepage to convert to (CONV_CODEPAGE) */
895 # endif
896 # ifdef USE_ICONV
897     iconv_t	vc_fd;		/* for CONV_ICONV */
898 # endif
899     int		vc_fail;	/* fail for invalid char, don't use '?' */
900 } vimconv_T;
901 
902 /*
903  * Structure used for reading from the viminfo file.
904  */
905 typedef struct
906 {
907     char_u	*vir_line;	/* text of the current line */
908     FILE	*vir_fd;	/* file descriptor */
909 #ifdef FEAT_MBYTE
910     vimconv_T	vir_conv;	/* encoding conversion */
911 #endif
912 } vir_T;
913 
914 #define CONV_NONE		0
915 #define CONV_TO_UTF8		1
916 #define CONV_9_TO_UTF8		2
917 #define CONV_TO_LATIN1		3
918 #define CONV_TO_LATIN9		4
919 #define CONV_ICONV		5
920 #ifdef WIN3264
921 # define CONV_CODEPAGE		10	/* codepage -> codepage */
922 #endif
923 #ifdef MACOS_X
924 # define CONV_MAC_LATIN1	20
925 # define CONV_LATIN1_MAC	21
926 # define CONV_MAC_UTF8		22
927 # define CONV_UTF8_MAC		23
928 #endif
929 
930 /*
931  * Structure used for mappings and abbreviations.
932  */
933 typedef struct mapblock mapblock_T;
934 struct mapblock
935 {
936     mapblock_T	*m_next;	/* next mapblock in list */
937     char_u	*m_keys;	/* mapped from */
938     int		m_keylen;	/* strlen(m_keys) */
939     char_u	*m_str;		/* mapped to */
940     int		m_mode;		/* valid mode */
941     int		m_noremap;	/* if non-zero no re-mapping for m_str */
942     char	m_silent;	/* <silent> used, don't echo commands */
943 #ifdef FEAT_EVAL
944     char	m_expr;		/* <expr> used, m_str is an expression */
945     scid_T	m_script_ID;	/* ID of script where map was defined */
946 #endif
947 };
948 
949 /*
950  * Used for highlighting in the status line.
951  */
952 struct stl_hlrec
953 {
954     char_u	*start;
955     int		userhl;		/* 0: no HL, 1-9: User HL, < 0 for syn ID */
956 };
957 
958 /* Item for a hashtable.  "hi_key" can be one of three values:
959  * NULL:	   Never been used
960  * HI_KEY_REMOVED: Entry was removed
961  * Otherwise:	   Used item, pointer to the actual key; this usually is
962  *		   inside the item, subtract an offset to locate the item.
963  *		   This reduces the size of hashitem by 1/3.
964  */
965 typedef struct hashitem_S
966 {
967     long_u	hi_hash;	/* cached hash number of hi_key */
968     char_u	*hi_key;
969 } hashitem_T;
970 
971 /* The address of "hash_removed" is used as a magic number for hi_key to
972  * indicate a removed item. */
973 #define HI_KEY_REMOVED &hash_removed
974 #define HASHITEM_EMPTY(hi) ((hi)->hi_key == NULL || (hi)->hi_key == &hash_removed)
975 
976 /* Initial size for a hashtable.  Our items are relatively small and growing
977  * is expensive, thus use 16 as a start.  Must be a power of 2. */
978 #define HT_INIT_SIZE 16
979 
980 typedef struct hashtable_S
981 {
982     long_u	ht_mask;	/* mask used for hash value (nr of items in
983 				 * array is "ht_mask" + 1) */
984     long_u	ht_used;	/* number of items used */
985     long_u	ht_filled;	/* number of items used + removed */
986     int		ht_locked;	/* counter for hash_lock() */
987     int		ht_error;	/* when set growing failed, can't add more
988 				   items before growing works */
989     hashitem_T	*ht_array;	/* points to the array, allocated when it's
990 				   not "ht_smallarray" */
991     hashitem_T	ht_smallarray[HT_INIT_SIZE];   /* initial array */
992 } hashtab_T;
993 
994 typedef long_u hash_T;		/* Type for hi_hash */
995 
996 
997 #if SIZEOF_INT <= 3		/* use long if int is smaller than 32 bits */
998 typedef long	varnumber_T;
999 #else
1000 typedef int	varnumber_T;
1001 #endif
1002 
1003 typedef struct listvar_S list_T;
1004 typedef struct dictvar_S dict_T;
1005 
1006 /*
1007  * Structure to hold an internal variable without a name.
1008  */
1009 typedef struct
1010 {
1011     char	v_type;	    /* see below: VAR_NUMBER, VAR_STRING, etc. */
1012     char	v_lock;	    /* see below: VAR_LOCKED, VAR_FIXED */
1013     union
1014     {
1015 	varnumber_T	v_number;	/* number value */
1016 	char_u		*v_string;	/* string value (can be NULL!) */
1017 	list_T		*v_list;	/* list value (can be NULL!) */
1018 	dict_T		*v_dict;	/* dict value (can be NULL!) */
1019     }		vval;
1020 } typval_T;
1021 
1022 /* Values for "v_type". */
1023 #define VAR_UNKNOWN 0
1024 #define VAR_NUMBER  1	/* "v_number" is used */
1025 #define VAR_STRING  2	/* "v_string" is used */
1026 #define VAR_FUNC    3	/* "v_string" is function name */
1027 #define VAR_LIST    4	/* "v_list" is used */
1028 #define VAR_DICT    5	/* "v_dict" is used */
1029 
1030 /* Values for "v_lock". */
1031 #define VAR_LOCKED  1	/* locked with lock(), can use unlock() */
1032 #define VAR_FIXED   2	/* locked forever */
1033 
1034 /*
1035  * Structure to hold an item of a list: an internal variable without a name.
1036  */
1037 typedef struct listitem_S listitem_T;
1038 
1039 struct listitem_S
1040 {
1041     listitem_T	*li_next;	/* next item in list */
1042     listitem_T	*li_prev;	/* previous item in list */
1043     typval_T	li_tv;		/* type and value of the variable */
1044 };
1045 
1046 /*
1047  * Struct used by those that are using an item in a list.
1048  */
1049 typedef struct listwatch_S listwatch_T;
1050 
1051 struct listwatch_S
1052 {
1053     listitem_T		*lw_item;	/* item being watched */
1054     listwatch_T		*lw_next;	/* next watcher */
1055 };
1056 
1057 /*
1058  * Structure to hold info about a list.
1059  */
1060 struct listvar_S
1061 {
1062     listitem_T	*lv_first;	/* first item, NULL if none */
1063     listitem_T	*lv_last;	/* last item, NULL if none */
1064     int		lv_refcount;	/* reference count */
1065     int		lv_len;		/* number of items */
1066     listwatch_T	*lv_watch;	/* first watcher, NULL if none */
1067     int		lv_idx;		/* cached index of an item */
1068     listitem_T	*lv_idx_item;	/* when not NULL item at index "lv_idx" */
1069     int		lv_copyID;	/* ID used by deepcopy() */
1070     list_T	*lv_copylist;	/* copied list used by deepcopy() */
1071     char	lv_lock;	/* zero, VAR_LOCKED, VAR_FIXED */
1072     list_T	*lv_used_next;	/* next list in used lists list */
1073     list_T	*lv_used_prev;	/* previous list in used lists list */
1074 };
1075 
1076 /*
1077  * Structure to hold an item of a Dictionary.
1078  * Also used for a variable.
1079  * The key is copied into "di_key" to avoid an extra alloc/free for it.
1080  */
1081 struct dictitem_S
1082 {
1083     typval_T	di_tv;		/* type and value of the variable */
1084     char_u	di_flags;	/* flags (only used for variable) */
1085     char_u	di_key[1];	/* key (actually longer!) */
1086 };
1087 
1088 typedef struct dictitem_S dictitem_T;
1089 
1090 #define DI_FLAGS_RO	1 /* "di_flags" value: read-only variable */
1091 #define DI_FLAGS_RO_SBX 2 /* "di_flags" value: read-only in the sandbox */
1092 #define DI_FLAGS_FIX	4 /* "di_flags" value: fixed variable, not allocated */
1093 #define DI_FLAGS_LOCK	8 /* "di_flags" value: locked variable */
1094 
1095 /*
1096  * Structure to hold info about a Dictionary.
1097  */
1098 struct dictvar_S
1099 {
1100     int		dv_refcount;	/* reference count */
1101     hashtab_T	dv_hashtab;	/* hashtab that refers to the items */
1102     int		dv_copyID;	/* ID used by deepcopy() */
1103     dict_T	*dv_copydict;	/* copied dict used by deepcopy() */
1104     char	dv_lock;	/* zero, VAR_LOCKED, VAR_FIXED */
1105     dict_T	*dv_used_next;	/* next dict in used dicts list */
1106     dict_T	*dv_used_prev;	/* previous dict in used dicts list */
1107 };
1108 
1109 /* values for b_syn_spell: what to do with toplevel text */
1110 #define SYNSPL_DEFAULT	0	/* spell check if @Spell not defined */
1111 #define SYNSPL_TOP	1	/* spell check toplevel text */
1112 #define SYNSPL_NOTOP	2	/* don't spell check toplevel text */
1113 
1114 /* avoid #ifdefs for when b_spell is not available */
1115 #ifdef FEAT_SPELL
1116 # define B_SPELL(buf)  ((buf)->b_spell)
1117 #else
1118 # define B_SPELL(buf)  (0)
1119 #endif
1120 
1121 #ifdef FEAT_QUICKFIX
1122 typedef struct qf_info_S qf_info_T;
1123 #endif
1124 
1125 /*
1126  * buffer: structure that holds information about one file
1127  *
1128  * Several windows can share a single Buffer
1129  * A buffer is unallocated if there is no memfile for it.
1130  * A buffer is new if the associated file has never been loaded yet.
1131  */
1132 
1133 typedef struct file_buffer buf_T;
1134 
1135 struct file_buffer
1136 {
1137     memline_T	b_ml;		/* associated memline (also contains line
1138 				   count) */
1139 
1140     buf_T	*b_next;	/* links in list of buffers */
1141     buf_T	*b_prev;
1142 
1143     int		b_nwindows;	/* nr of windows open on this buffer */
1144 
1145     int		b_flags;	/* various BF_ flags */
1146 
1147     /*
1148      * b_ffname has the full path of the file (NULL for no name).
1149      * b_sfname is the name as the user typed it (or NULL).
1150      * b_fname is the same as b_sfname, unless ":cd" has been done,
1151      *		then it is the same as b_ffname (NULL for no name).
1152      */
1153     char_u	*b_ffname;	/* full path file name */
1154     char_u	*b_sfname;	/* short file name */
1155     char_u	*b_fname;	/* current file name */
1156 
1157 #ifdef UNIX
1158     int		b_dev;		/* device number (-1 if not set) */
1159     ino_t	b_ino;		/* inode number */
1160 #endif
1161 #ifdef FEAT_CW_EDITOR
1162     FSSpec	b_FSSpec;	/* MacOS File Identification */
1163 #endif
1164 #ifdef VMS
1165     char	 b_fab_rfm;	/* Record format    */
1166     char	 b_fab_rat;	/* Record attribute */
1167     unsigned int b_fab_mrs;	/* Max record size  */
1168 #endif
1169 #ifdef FEAT_SNIFF
1170     int		b_sniff;	/* file was loaded through Sniff */
1171 #endif
1172 
1173     int		b_fnum;		/* buffer number for this file. */
1174 
1175     int		b_changed;	/* 'modified': Set to TRUE if something in the
1176 				   file has been changed and not written out. */
1177     int		b_changedtick;	/* incremented for each change, also for undo */
1178 
1179     int		b_saving;	/* Set to TRUE if we are in the middle of
1180 				   saving the buffer. */
1181 
1182     /*
1183      * Changes to a buffer require updating of the display.  To minimize the
1184      * work, remember changes made and update everything at once.
1185      */
1186     int		b_mod_set;	/* TRUE when there are changes since the last
1187 				   time the display was updated */
1188     linenr_T	b_mod_top;	/* topmost lnum that was changed */
1189     linenr_T	b_mod_bot;	/* lnum below last changed line, AFTER the
1190 				   change */
1191     long	b_mod_xlines;	/* number of extra buffer lines inserted;
1192 				   negative when lines were deleted */
1193 
1194     wininfo_T	*b_wininfo;	/* list of last used info for each window */
1195 
1196     long	b_mtime;	/* last change time of original file */
1197     long	b_mtime_read;	/* last change time when reading */
1198     size_t	b_orig_size;	/* size of original file in bytes */
1199     int		b_orig_mode;	/* mode of original file */
1200 
1201     pos_T	b_namedm[NMARKS]; /* current named marks (mark.c) */
1202 
1203 #ifdef FEAT_VISUAL
1204     /* These variables are set when VIsual_active becomes FALSE */
1205     visualinfo_T b_visual;
1206 # ifdef FEAT_EVAL
1207     int		b_visual_mode_eval;  /* b_visual.vi_mode for visualmode() */
1208 # endif
1209 #endif
1210 
1211     pos_T	b_last_cursor;	/* cursor position when last unloading this
1212 				   buffer */
1213     pos_T	b_last_insert;	/* where Insert mode was left */
1214     pos_T	b_last_change;	/* position of last change: '. mark */
1215 
1216 #ifdef FEAT_JUMPLIST
1217     /*
1218      * the changelist contains old change positions
1219      */
1220     pos_T	b_changelist[JUMPLISTSIZE];
1221     int		b_changelistlen;	/* number of active entries */
1222     int		b_new_change;		/* set by u_savecommon() */
1223 #endif
1224 
1225     /*
1226      * Character table, only used in charset.c for 'iskeyword'
1227      * 32 bytes of 8 bits: 1 bit per character 0-255.
1228      */
1229     char_u	b_chartab[32];
1230 
1231 #ifdef FEAT_LOCALMAP
1232     /* Table used for mappings local to a buffer. */
1233     mapblock_T	*(b_maphash[256]);
1234 
1235     /* First abbreviation local to a buffer. */
1236     mapblock_T	*b_first_abbr;
1237 #endif
1238 #ifdef FEAT_USR_CMDS
1239     /* User commands local to the buffer. */
1240     garray_T	b_ucmds;
1241 #endif
1242     /*
1243      * start and end of an operator, also used for '[ and ']
1244      */
1245     pos_T	b_op_start;
1246     pos_T	b_op_end;
1247 
1248 #ifdef FEAT_VIMINFO
1249     int		b_marks_read;	/* Have we read viminfo marks yet? */
1250 #endif
1251 
1252     /*
1253      * The following only used in undo.c.
1254      */
1255     u_header_T	*b_u_oldhead;	/* pointer to oldest header */
1256     u_header_T	*b_u_newhead;	/* pointer to newest header; may not be valid
1257 				   if b_u_curhead is not NULL */
1258     u_header_T	*b_u_curhead;	/* pointer to current header */
1259     int		b_u_numhead;	/* current number of headers */
1260     int		b_u_synced;	/* entry lists are synced */
1261     long	b_u_seq_last;	/* last used undo sequence number */
1262     long	b_u_seq_cur;	/* hu_seq of header below which we are now */
1263     time_t	b_u_seq_time;	/* uh_time of header below which we are now */
1264 
1265     /*
1266      * variables for "U" command in undo.c
1267      */
1268     char_u	*b_u_line_ptr;	/* saved line for "U" command */
1269     linenr_T	b_u_line_lnum;	/* line number of line in u_line */
1270     colnr_T	b_u_line_colnr;	/* optional column number */
1271 
1272     /*
1273      * The following only used in undo.c
1274      */
1275     mblock_T	b_block_head;	/* head of allocated memory block list */
1276     minfo_T	*b_m_search;	/* pointer to chunk before previously
1277 				   allocated/freed chunk */
1278     mblock_T	*b_mb_current;	/* block where m_search points in */
1279 
1280 #ifdef FEAT_INS_EXPAND
1281     int		b_scanned;	/* ^N/^P have scanned this buffer */
1282 #endif
1283 
1284     /* flags for use of ":lmap" and IM control */
1285     long	b_p_iminsert;	/* input mode for insert */
1286     long	b_p_imsearch;	/* input mode for search */
1287 #define B_IMODE_USE_INSERT -1	/*	Use b_p_iminsert value for search */
1288 #define B_IMODE_NONE 0		/*	Input via none */
1289 #define B_IMODE_LMAP 1		/*	Input via langmap */
1290 #ifndef USE_IM_CONTROL
1291 # define B_IMODE_LAST 1
1292 #else
1293 # define B_IMODE_IM 2		/*	Input via input method */
1294 # define B_IMODE_LAST 2
1295 #endif
1296 
1297 #ifdef FEAT_KEYMAP
1298     short	b_kmap_state;	/* using "lmap" mappings */
1299 # define KEYMAP_INIT	1	/* 'keymap' was set, call keymap_init() */
1300 # define KEYMAP_LOADED	2	/* 'keymap' mappings have been loaded */
1301     garray_T	b_kmap_ga;	/* the keymap table */
1302 #endif
1303 
1304     /*
1305      * Options local to a buffer.
1306      * They are here because their value depends on the type of file
1307      * or contents of the file being edited.
1308      */
1309     int		b_p_initialized;	/* set when options initialized */
1310 
1311 #ifdef FEAT_EVAL
1312     int		b_p_scriptID[BV_COUNT];	/* SIDs for buffer-local options */
1313 #endif
1314 
1315     int		b_p_ai;		/* 'autoindent' */
1316     int		b_p_ai_nopaste;	/* b_p_ai saved for paste mode */
1317     int		b_p_ci;		/* 'copyindent' */
1318     int		b_p_bin;	/* 'binary' */
1319 #ifdef FEAT_MBYTE
1320     int		b_p_bomb;	/* 'bomb' */
1321 #endif
1322 #if defined(FEAT_QUICKFIX)
1323     char_u	*b_p_bh;	/* 'bufhidden' */
1324     char_u	*b_p_bt;	/* 'buftype' */
1325 #endif
1326     int		b_p_bl;		/* 'buflisted' */
1327 #ifdef FEAT_CINDENT
1328     int		b_p_cin;	/* 'cindent' */
1329     char_u	*b_p_cino;	/* 'cinoptions' */
1330     char_u	*b_p_cink;	/* 'cinkeys' */
1331 #endif
1332 #if defined(FEAT_CINDENT) || defined(FEAT_SMARTINDENT)
1333     char_u	*b_p_cinw;	/* 'cinwords' */
1334 #endif
1335 #ifdef FEAT_COMMENTS
1336     char_u	*b_p_com;	/* 'comments' */
1337 #endif
1338 #ifdef FEAT_FOLDING
1339     char_u	*b_p_cms;	/* 'commentstring' */
1340 #endif
1341 #ifdef FEAT_INS_EXPAND
1342     char_u	*b_p_cpt;	/* 'complete' */
1343 #endif
1344 #ifdef FEAT_COMPL_FUNC
1345     char_u	*b_p_cfu;	/* 'completefunc' */
1346     char_u	*b_p_ofu;	/* 'omnifunc' */
1347 #endif
1348     int		b_p_eol;	/* 'endofline' */
1349     int		b_p_et;		/* 'expandtab' */
1350     int		b_p_et_nobin;	/* b_p_et saved for binary mode */
1351 #ifdef FEAT_MBYTE
1352     char_u	*b_p_fenc;	/* 'fileencoding' */
1353 #endif
1354     char_u	*b_p_ff;	/* 'fileformat' */
1355 #ifdef FEAT_AUTOCMD
1356     char_u	*b_p_ft;	/* 'filetype' */
1357 #endif
1358     char_u	*b_p_fo;	/* 'formatoptions' */
1359     char_u	*b_p_flp;	/* 'formatlistpat' */
1360     int		b_p_inf;	/* 'infercase' */
1361     char_u	*b_p_isk;	/* 'iskeyword' */
1362 #ifdef FEAT_FIND_ID
1363     char_u	*b_p_def;	/* 'define' local value */
1364     char_u	*b_p_inc;	/* 'include' */
1365 # ifdef FEAT_EVAL
1366     char_u	*b_p_inex;	/* 'includeexpr' */
1367     long_u	b_p_inex_flags;	/* flags for 'includeexpr' */
1368 # endif
1369 #endif
1370 #if defined(FEAT_CINDENT) && defined(FEAT_EVAL)
1371     char_u	*b_p_inde;	/* 'indentexpr' */
1372     long_u	b_p_inde_flags;	/* flags for 'indentexpr' */
1373     char_u	*b_p_indk;	/* 'indentkeys' */
1374 #endif
1375 #if defined(FEAT_EVAL)
1376     char_u	*b_p_fex;	/* 'formatexpr' */
1377     long_u	b_p_fex_flags;	/* flags for 'formatexpr' */
1378 #endif
1379 #ifdef FEAT_CRYPT
1380     char_u	*b_p_key;	/* 'key' */
1381 #endif
1382     char_u	*b_p_kp;	/* 'keywordprg' */
1383 #ifdef FEAT_LISP
1384     int		b_p_lisp;	/* 'lisp' */
1385 #endif
1386     char_u	*b_p_mps;	/* 'matchpairs' */
1387     int		b_p_ml;		/* 'modeline' */
1388     int		b_p_ml_nobin;	/* b_p_ml saved for binary mode */
1389     int		b_p_ma;		/* 'modifiable' */
1390     char_u	*b_p_nf;	/* 'nrformats' */
1391 #ifdef FEAT_OSFILETYPE
1392     char_u	*b_p_oft;	/* 'osfiletype' */
1393 #endif
1394     int		b_p_pi;		/* 'preserveindent' */
1395 #ifdef FEAT_TEXTOBJ
1396     char_u	*b_p_qe;	/* 'quoteescape' */
1397 #endif
1398     int		b_p_ro;		/* 'readonly' */
1399     long	b_p_sw;		/* 'shiftwidth' */
1400 #ifndef SHORT_FNAME
1401     int		b_p_sn;		/* 'shortname' */
1402 #endif
1403 #ifdef FEAT_SMARTINDENT
1404     int		b_p_si;		/* 'smartindent' */
1405 #endif
1406     long	b_p_sts;	/* 'softtabstop' */
1407     long	b_p_sts_nopaste; /* b_p_sts saved for paste mode */
1408 #ifdef FEAT_SEARCHPATH
1409     char_u	*b_p_sua;	/* 'suffixesadd' */
1410 #endif
1411     int		b_p_swf;	/* 'swapfile' */
1412 #ifdef FEAT_SYN_HL
1413     long	b_p_smc;	/* 'synmaxcol' */
1414     char_u	*b_p_syn;	/* 'syntax' */
1415 #endif
1416 #ifdef FEAT_SPELL
1417     char_u	*b_p_spc;	/* 'spellcapcheck' */
1418     regprog_T	*b_cap_prog;	/* program for 'spellcapcheck' */
1419     char_u	*b_p_spf;	/* 'spellfile' */
1420     char_u	*b_p_spl;	/* 'spelllang' */
1421 #endif
1422     long	b_p_ts;		/* 'tabstop' */
1423     int		b_p_tx;		/* 'textmode' */
1424     long	b_p_tw;		/* 'textwidth' */
1425     long	b_p_tw_nobin;	/* b_p_tw saved for binary mode */
1426     long	b_p_tw_nopaste;	/* b_p_tw saved for paste mode */
1427     long	b_p_wm;		/* 'wrapmargin' */
1428     long	b_p_wm_nobin;	/* b_p_wm saved for binary mode */
1429     long	b_p_wm_nopaste;	/* b_p_wm saved for paste mode */
1430 #ifdef FEAT_KEYMAP
1431     char_u	*b_p_keymap;	/* 'keymap' */
1432 #endif
1433 
1434     /* local values for options which are normally global */
1435 #ifdef FEAT_QUICKFIX
1436     char_u	*b_p_gp;	/* 'grepprg' local value */
1437     char_u	*b_p_mp;	/* 'makeprg' local value */
1438     char_u	*b_p_efm;	/* 'errorformat' local value */
1439 #endif
1440     char_u	*b_p_ep;	/* 'equalprg' local value */
1441     char_u	*b_p_path;	/* 'path' local value */
1442     int		b_p_ar;		/* 'autoread' local value */
1443     char_u	*b_p_tags;	/* 'tags' local value */
1444 #ifdef FEAT_INS_EXPAND
1445     char_u	*b_p_dict;	/* 'dictionary' local value */
1446     char_u	*b_p_tsr;	/* 'thesaurus' local value */
1447 #endif
1448 
1449     /* end of buffer options */
1450 
1451     int		b_start_eol;	/* last line had eol when it was read */
1452     int		b_start_ffc;	/* first char of 'ff' when edit started */
1453 #ifdef FEAT_MBYTE
1454     char_u	*b_start_fenc;	/* 'fileencoding' when edit started or NULL */
1455     int		b_bad_char;	/* "++bad=" argument when edit started or 0 */
1456 #endif
1457 
1458 #ifdef FEAT_EVAL
1459     dictitem_T	b_bufvar;	/* variable for "b:" Dictionary */
1460     dict_T	b_vars;		/* internal variables, local to buffer */
1461 #endif
1462 
1463 #if defined(FEAT_BEVAL) && defined(FEAT_EVAL)
1464     char_u	*b_p_bexpr;	/* 'balloonexpr' local value */
1465     long_u	b_p_bexpr_flags;/* flags for 'balloonexpr' */
1466 #endif
1467 
1468     /* When a buffer is created, it starts without a swap file.  b_may_swap is
1469      * then set to indicate that a swap file may be opened later.  It is reset
1470      * if a swap file could not be opened.
1471      */
1472     int		b_may_swap;
1473     int		b_did_warn;	/* Set to 1 if user has been warned on first
1474 				   change of a read-only file */
1475 
1476     /* Two special kinds of buffers:
1477      * help buffer  - used for help files, won't use a swap file.
1478      * spell buffer - used for spell info, never displayed and doesn't have a
1479      *		      file name.
1480      */
1481     int		b_help;		/* TRUE for help file buffer (when set b_p_bt
1482 				   is "help") */
1483 #ifdef FEAT_SPELL
1484     int		b_spell;	/* TRUE for a spell file buffer, most fields
1485 				   are not used!  Use the B_SPELL macro to
1486 				   access b_spell without #ifdef. */
1487 #endif
1488 
1489 #ifndef SHORT_FNAME
1490     int		b_shortname;	/* this file has an 8.3 file name */
1491 #endif
1492 
1493 #ifdef FEAT_MZSCHEME
1494     void	*b_mzscheme_ref; /* The MzScheme reference to this buffer */
1495 #endif
1496 
1497 #ifdef FEAT_PERL
1498     void	*b_perl_private;
1499 #endif
1500 
1501 #ifdef FEAT_PYTHON
1502     void	*b_python_ref;	/* The Python reference to this buffer */
1503 #endif
1504 
1505 #ifdef FEAT_TCL
1506     void	*b_tcl_ref;
1507 #endif
1508 
1509 #ifdef FEAT_RUBY
1510     void	*b_ruby_ref;
1511 #endif
1512 
1513 #ifdef FEAT_SYN_HL
1514     hashtab_T	b_keywtab;		/* syntax keywords hash table */
1515     hashtab_T	b_keywtab_ic;		/* idem, ignore case */
1516     int		b_syn_error;		/* TRUE when error occured in HL */
1517     int		b_syn_ic;		/* ignore case for :syn cmds */
1518     int		b_syn_spell;		/* SYNSPL_ values */
1519     garray_T	b_syn_patterns;		/* table for syntax patterns */
1520     garray_T	b_syn_clusters;		/* table for syntax clusters */
1521     int		b_spell_cluster_id;	/* @Spell cluster ID or 0 */
1522     int		b_nospell_cluster_id;	/* @NoSpell cluster ID or 0 */
1523     int		b_syn_containedin;	/* TRUE when there is an item with a
1524 					   "containedin" argument */
1525     int		b_syn_sync_flags;	/* flags about how to sync */
1526     short	b_syn_sync_id;		/* group to sync on */
1527     long	b_syn_sync_minlines;	/* minimal sync lines offset */
1528     long	b_syn_sync_maxlines;	/* maximal sync lines offset */
1529     long	b_syn_sync_linebreaks;	/* offset for multi-line pattern */
1530     char_u	*b_syn_linecont_pat;	/* line continuation pattern */
1531     regprog_T	*b_syn_linecont_prog;	/* line continuation program */
1532     int		b_syn_linecont_ic;	/* ignore-case flag for above */
1533     int		b_syn_topgrp;		/* for ":syntax include" */
1534 # ifdef FEAT_FOLDING
1535     int		b_syn_folditems;	/* number of patterns with the HL_FOLD
1536 					   flag set */
1537 # endif
1538 /*
1539  * b_sst_array[] contains the state stack for a number of lines, for the start
1540  * of that line (col == 0).  This avoids having to recompute the syntax state
1541  * too often.
1542  * b_sst_array[] is allocated to hold the state for all displayed lines, and
1543  * states for 1 out of about 20 other lines.
1544  * b_sst_array		pointer to an array of synstate_T
1545  * b_sst_len		number of entries in b_sst_array[]
1546  * b_sst_first		pointer to first used entry in b_sst_array[] or NULL
1547  * b_sst_firstfree	pointer to first free entry in b_sst_array[] or NULL
1548  * b_sst_freecount	number of free entries in b_sst_array[]
1549  * b_sst_check_lnum	entries after this lnum need to be checked for
1550  *			validity (MAXLNUM means no check needed)
1551  */
1552     synstate_T	*b_sst_array;
1553     int		b_sst_len;
1554     synstate_T	*b_sst_first;
1555     synstate_T	*b_sst_firstfree;
1556     int		b_sst_freecount;
1557     linenr_T	b_sst_check_lnum;
1558     short_u	b_sst_lasttick;	/* last display tick */
1559 #endif /* FEAT_SYN_HL */
1560 
1561 #ifdef FEAT_SPELL
1562     /* for spell checking */
1563     garray_T	b_langp;	/* list of pointers to slang_T, see spell.c */
1564     char_u	b_spell_ismw[256];/* flags: is midword char */
1565 # ifdef FEAT_MBYTE
1566     char_u	*b_spell_ismw_mb; /* multi-byte midword chars */
1567 # endif
1568 #endif
1569 
1570 #ifdef FEAT_SIGNS
1571     signlist_T	*b_signlist;	/* list of signs to draw */
1572 #endif
1573 
1574 #ifdef FEAT_NETBEANS_INTG
1575     int		b_netbeans_file;    /* TRUE when buffer is owned by NetBeans */
1576     int		b_was_netbeans_file;/* TRUE if b_netbeans_file was once set */
1577 #endif
1578 
1579 };
1580 
1581 
1582 #ifdef FEAT_DIFF
1583 /*
1584  * Stuff for diff mode.
1585  */
1586 # define DB_COUNT 4	/* up to four buffers can be diff'ed */
1587 
1588 /*
1589  * Each diffblock defines where a block of lines starts in each of the buffers
1590  * and how many lines it occupies in that buffer.  When the lines are missing
1591  * in the buffer the df_count[] is zero.  This is all counted in
1592  * buffer lines.
1593  * There is always at least one unchanged line in between the diffs.
1594  * Otherwise it would have been included in the diff above or below it.
1595  * df_lnum[] + df_count[] is the lnum below the change.  When in one buffer
1596  * lines have been inserted, in the other buffer df_lnum[] is the line below
1597  * the insertion and df_count[] is zero.  When appending lines at the end of
1598  * the buffer, df_lnum[] is one beyond the end!
1599  * This is using a linked list, because the number of differences is expected
1600  * to be reasonable small.  The list is sorted on lnum.
1601  */
1602 typedef struct diffblock_S diff_T;
1603 struct diffblock_S
1604 {
1605     diff_T	*df_next;
1606     linenr_T	df_lnum[DB_COUNT];	/* line number in buffer */
1607     linenr_T	df_count[DB_COUNT];	/* nr of inserted/changed lines */
1608 };
1609 #endif
1610 
1611 /*
1612  * Tab pages point to the top frame of each tab page.
1613  * Note: Most values are NOT valid for the current tab page!  Use "curwin",
1614  * "firstwin", etc. for that.  "tp_topframe" is always valid and can be
1615  * compared against "topframe" to find the current tab page.
1616  */
1617 typedef struct tabpage_S tabpage_T;
1618 struct tabpage_S
1619 {
1620     tabpage_T	    *tp_next;	    /* next tabpage or NULL */
1621     frame_T	    *tp_topframe;   /* topframe for the windows */
1622     win_T	    *tp_curwin;	    /* current window in this Tab page */
1623     win_T	    *tp_prevwin;    /* previous window in this Tab page */
1624     win_T	    *tp_firstwin;   /* first window in this Tab page */
1625     win_T	    *tp_lastwin;    /* last window in this Tab page */
1626     long	    tp_old_Rows;    /* Rows when Tab page was left */
1627     long	    tp_old_Columns; /* Columns when Tab page was left */
1628     long	    tp_ch_used;	    /* value of 'cmdheight' when frame size
1629 				       was set */
1630 #ifdef FEAT_GUI
1631     int		    tp_prev_which_scrollbars[3];
1632 				    /* previous value of which_scrollbars */
1633 #endif
1634 #ifdef FEAT_DIFF
1635     diff_T	    *tp_first_diff;
1636     buf_T	    *(tp_diffbuf[DB_COUNT]);
1637     int		    tp_diff_invalid;	/* list of diffs is outdated */
1638 #endif
1639     frame_T	    *tp_snapshot;    /* window layout snapshot */
1640 #ifdef FEAT_EVAL
1641     dictitem_T	    tp_winvar;	    /* variable for "t:" Dictionary */
1642     dict_T	    tp_vars;	    /* internal variables, local to tab page */
1643 #endif
1644 };
1645 
1646 /*
1647  * Structure to cache info for displayed lines in w_lines[].
1648  * Each logical line has one entry.
1649  * The entry tells how the logical line is currently displayed in the window.
1650  * This is updated when displaying the window.
1651  * When the display is changed (e.g., when clearing the screen) w_lines_valid
1652  * is changed to exclude invalid entries.
1653  * When making changes to the buffer, wl_valid is reset to indicate wl_size
1654  * may not reflect what is actually in the buffer.  When wl_valid is FALSE,
1655  * the entries can only be used to count the number of displayed lines used.
1656  * wl_lnum and wl_lastlnum are invalid too.
1657  */
1658 typedef struct w_line
1659 {
1660     linenr_T	wl_lnum;	/* buffer line number for logical line */
1661     short_u	wl_size;	/* height in screen lines */
1662     char	wl_valid;	/* TRUE values are valid for text in buffer */
1663 #ifdef FEAT_FOLDING
1664     char	wl_folded;	/* TRUE when this is a range of folded lines */
1665     linenr_T	wl_lastlnum;	/* last buffer line number for logical line */
1666 #endif
1667 } wline_T;
1668 
1669 /*
1670  * Windows are kept in a tree of frames.  Each frame has a column (FR_COL)
1671  * or row (FR_ROW) layout or is a leaf, which has a window.
1672  */
1673 struct frame_S
1674 {
1675     char	fr_layout;	/* FR_LEAF, FR_COL or FR_ROW */
1676 #ifdef FEAT_VERTSPLIT
1677     int		fr_width;
1678     int		fr_newwidth;	/* new width used in win_equal_rec() */
1679 #endif
1680     int		fr_height;
1681     int		fr_newheight;	/* new height used in win_equal_rec() */
1682     frame_T	*fr_parent;	/* containing frame or NULL */
1683     frame_T	*fr_next;	/* frame right or below in same parent, NULL
1684 				   for first */
1685     frame_T	*fr_prev;	/* frame left or above in same parent, NULL
1686 				   for last */
1687     /* fr_child and fr_win are mutually exclusive */
1688     frame_T	*fr_child;	/* first contained frame */
1689     win_T	*fr_win;	/* window that fills this frame */
1690 };
1691 
1692 #define FR_LEAF	0	/* frame is a leaf */
1693 #define FR_ROW	1	/* frame with a row of windows */
1694 #define FR_COL	2	/* frame with a column of windows */
1695 
1696 /*
1697  * Structure which contains all information that belongs to a window
1698  *
1699  * All row numbers are relative to the start of the window, except w_winrow.
1700  */
1701 struct window_S
1702 {
1703     buf_T	*w_buffer;	    /* buffer we are a window into (used
1704 				       often, keep it the first item!) */
1705 
1706 #ifdef FEAT_WINDOWS
1707     win_T	*w_prev;	    /* link to previous window */
1708     win_T	*w_next;	    /* link to next window */
1709 #endif
1710 
1711     frame_T	*w_frame;	    /* frame containing this window */
1712 
1713     pos_T	w_cursor;	    /* cursor position in buffer */
1714 
1715     colnr_T	w_curswant;	    /* The column we'd like to be at.  This is
1716 				       used to try to stay in the same column
1717 				       for up/down cursor motions. */
1718 
1719     int		w_set_curswant;	    /* If set, then update w_curswant the next
1720 				       time through cursupdate() to the
1721 				       current virtual column */
1722 
1723 #ifdef FEAT_VISUAL
1724     /*
1725      * the next six are used to update the visual part
1726      */
1727     char	w_old_visual_mode;  /* last known VIsual_mode */
1728     linenr_T	w_old_cursor_lnum;  /* last known end of visual part */
1729     colnr_T	w_old_cursor_fcol;  /* first column for block visual part */
1730     colnr_T	w_old_cursor_lcol;  /* last column for block visual part */
1731     linenr_T	w_old_visual_lnum;  /* last known start of visual part */
1732     colnr_T	w_old_visual_col;   /* last known start of visual part */
1733     colnr_T	w_old_curswant;	    /* last known value of Curswant */
1734 #endif
1735 
1736     /*
1737      * The next three specify the offsets for displaying the buffer:
1738      */
1739     linenr_T	w_topline;	    /* buffer line number of the line at the
1740 				       top of the window */
1741 #ifdef FEAT_DIFF
1742     int		w_topfill;	    /* number of filler lines above w_topline */
1743     int		w_old_topfill;	    /* w_topfill at last redraw */
1744     int		w_botfill;	    /* TRUE when filler lines are actually
1745 				       below w_topline (at end of file) */
1746     int		w_old_botfill;	    /* w_botfill at last redraw */
1747 #endif
1748     colnr_T	w_leftcol;	    /* window column number of the left most
1749 				       character in the window; used when
1750 				       'wrap' is off */
1751     colnr_T	w_skipcol;	    /* starting column when a single line
1752 				       doesn't fit in the window */
1753 
1754     /*
1755      * Layout of the window in the screen.
1756      * May need to add "msg_scrolled" to "w_winrow" in rare situations.
1757      */
1758 #ifdef FEAT_WINDOWS
1759     int		w_winrow;	    /* first row of window in screen */
1760 #endif
1761     int		w_height;	    /* number of rows in window, excluding
1762 				       status/command line(s) */
1763 #ifdef FEAT_WINDOWS
1764     int		w_status_height;    /* number of status lines (0 or 1) */
1765 #endif
1766 #ifdef FEAT_VERTSPLIT
1767     int		w_wincol;	    /* Leftmost column of window in screen.
1768 				       use W_WINCOL() */
1769     int		w_width;	    /* Width of window, excluding separation.
1770 				       use W_WIDTH() */
1771     int		w_vsep_width;	    /* Number of separator columns (0 or 1).
1772 				       use W_VSEP_WIDTH() */
1773 #endif
1774 
1775     /*
1776      * === start of cached values ====
1777      */
1778     /*
1779      * Recomputing is minimized by storing the result of computations.
1780      * Use functions in screen.c to check if they are valid and to update.
1781      * w_valid is a bitfield of flags, which indicate if specific values are
1782      * valid or need to be recomputed.	See screen.c for values.
1783      */
1784     int		w_valid;
1785     pos_T	w_valid_cursor;	    /* last known position of w_cursor, used
1786 				       to adjust w_valid */
1787     colnr_T	w_valid_leftcol;    /* last known w_leftcol */
1788 
1789     /*
1790      * w_cline_height is the number of physical lines taken by the buffer line
1791      * that the cursor is on.  We use this to avoid extra calls to plines().
1792      */
1793     int		w_cline_height;	    /* current size of cursor line */
1794 #ifdef FEAT_FOLDING
1795     int		w_cline_folded;	    /* cursor line is folded */
1796 #endif
1797 
1798     int		w_cline_row;	    /* starting row of the cursor line */
1799 
1800     colnr_T	w_virtcol;	    /* column number of the cursor in the
1801 				       buffer line, as opposed to the column
1802 				       number we're at on the screen.  This
1803 				       makes a difference on lines which span
1804 				       more than one screen line or when
1805 				       w_leftcol is non-zero */
1806 
1807     /*
1808      * w_wrow and w_wcol specify the cursor position in the window.
1809      * This is related to positions in the window, not in the display or
1810      * buffer, thus w_wrow is relative to w_winrow.
1811      */
1812     int		w_wrow, w_wcol;	    /* cursor position in window */
1813 
1814     linenr_T	w_botline;	    /* number of the line below the bottom of
1815 				       the screen */
1816     int		w_empty_rows;	    /* number of ~ rows in window */
1817 #ifdef FEAT_DIFF
1818     int		w_filler_rows;	    /* number of filler rows at the end of the
1819 				       window */
1820 #endif
1821 
1822     /*
1823      * Info about the lines currently in the window is remembered to avoid
1824      * recomputing it every time.  The allocated size of w_lines[] is Rows.
1825      * Only the w_lines_valid entries are actually valid.
1826      * When the display is up-to-date w_lines[0].wl_lnum is equal to w_topline
1827      * and w_lines[w_lines_valid - 1].wl_lnum is equal to w_botline.
1828      * Between changing text and updating the display w_lines[] represents
1829      * what is currently displayed.  wl_valid is reset to indicated this.
1830      * This is used for efficient redrawing.
1831      */
1832     int		w_lines_valid;	    /* number of valid entries */
1833     wline_T	*w_lines;
1834 
1835 #ifdef FEAT_FOLDING
1836     garray_T	w_folds;	    /* array of nested folds */
1837     char	w_fold_manual;	    /* when TRUE: some folds are opened/closed
1838 				       manually */
1839     char	w_foldinvalid;	    /* when TRUE: folding needs to be
1840 				       recomputed */
1841 #endif
1842 #ifdef FEAT_LINEBREAK
1843     int		w_nrwidth;	    /* width of 'number' column being used */
1844 #endif
1845 
1846     /*
1847      * === end of cached values ===
1848      */
1849 
1850     int		w_redr_type;	    /* type of redraw to be performed on win */
1851     int		w_upd_rows;	    /* number of window lines to update when
1852 				       w_redr_type is REDRAW_TOP */
1853     linenr_T	w_redraw_top;	    /* when != 0: first line needing redraw */
1854     linenr_T	w_redraw_bot;	    /* when != 0: last line needing redraw */
1855 #ifdef FEAT_WINDOWS
1856     int		w_redr_status;	    /* if TRUE status line must be redrawn */
1857 #endif
1858 
1859 #ifdef FEAT_CMDL_INFO
1860     /* remember what is shown in the ruler for this window (if 'ruler' set) */
1861     pos_T	w_ru_cursor;	    /* cursor position shown in ruler */
1862     colnr_T	w_ru_virtcol;	    /* virtcol shown in ruler */
1863     linenr_T	w_ru_topline;	    /* topline shown in ruler */
1864     linenr_T	w_ru_line_count;    /* line count used for ruler */
1865 # ifdef FEAT_DIFF
1866     int		w_ru_topfill;	    /* topfill shown in ruler */
1867 # endif
1868     char	w_ru_empty;	    /* TRUE if ruler shows 0-1 (empty line) */
1869 #endif
1870 
1871     int		w_alt_fnum;	    /* alternate file (for # and CTRL-^) */
1872 
1873 #ifdef FEAT_WINDOWS
1874     alist_T	*w_alist;	    /* pointer to arglist for this window */
1875 #endif
1876     int		w_arg_idx;	    /* current index in argument list (can be
1877 				       out of range!) */
1878     int		w_arg_idx_invalid;  /* editing another file than w_arg_idx */
1879 
1880     char_u	*w_localdir;	    /* absolute path of local directory or
1881 				       NULL */
1882     /*
1883      * Options local to a window.
1884      * They are local because they influence the layout of the window or
1885      * depend on the window layout.
1886      * There are two values: w_onebuf_opt is local to the buffer currently in
1887      * this window, w_allbuf_opt is for all buffers in this window.
1888      */
1889     winopt_T	w_onebuf_opt;
1890     winopt_T	w_allbuf_opt;
1891 
1892     /* A few options have local flags for P_INSECURE. */
1893 #ifdef FEAT_STL_OPT
1894     long_u	w_p_stl_flags;	    /* flags for 'statusline' */
1895 #endif
1896 #ifdef FEAT_EVAL
1897     long_u	w_p_fde_flags;	    /* flags for 'foldexpr' */
1898     long_u	w_p_fdt_flags;	    /* flags for 'foldtext' */
1899 #endif
1900 
1901     /* transform a pointer to a "onebuf" option into a "allbuf" option */
1902 #define GLOBAL_WO(p)	((char *)p + sizeof(winopt_T))
1903 
1904 #ifdef FEAT_SCROLLBIND
1905     long	w_scbind_pos;
1906 #endif
1907 
1908 #ifdef FEAT_EVAL
1909     dictitem_T	w_winvar;	/* variable for "w:" Dictionary */
1910     dict_T	w_vars;		/* internal variables, local to window */
1911 #endif
1912 
1913 #if defined(FEAT_RIGHTLEFT) && defined(FEAT_FKMAP)
1914     int		w_farsi;	/* for the window dependent Farsi functions */
1915 #endif
1916 
1917     /*
1918      * The w_prev_pcmark field is used to check whether we really did jump to
1919      * a new line after setting the w_pcmark.  If not, then we revert to
1920      * using the previous w_pcmark.
1921      */
1922     pos_T	w_pcmark;	/* previous context mark */
1923     pos_T	w_prev_pcmark;	/* previous w_pcmark */
1924 
1925 #ifdef FEAT_JUMPLIST
1926     /*
1927      * the jumplist contains old cursor positions
1928      */
1929     xfmark_T	w_jumplist[JUMPLISTSIZE];
1930     int		w_jumplistlen;		/* number of active entries */
1931     int		w_jumplistidx;		/* current position */
1932 
1933     int		w_changelistidx;	/* current position in b_changelist */
1934 #endif
1935 
1936 #ifdef FEAT_SEARCH_EXTRA
1937     regmmatch_T	w_match[3];	    /* regexp programs for ":match" */
1938     char_u	*(w_match_pat[3]);  /* patterns for ":match" */
1939     int		w_match_id[3];	    /* highlight IDs for ":match" */
1940 #endif
1941 
1942     /*
1943      * the tagstack grows from 0 upwards:
1944      * entry 0: older
1945      * entry 1: newer
1946      * entry 2: newest
1947      */
1948     taggy_T	w_tagstack[TAGSTACKSIZE];	/* the tag stack */
1949     int		w_tagstackidx;		/* idx just below activ entry */
1950     int		w_tagstacklen;		/* number of tags on stack */
1951 
1952     /*
1953      * w_fraction is the fractional row of the cursor within the window, from
1954      * 0 at the top row to FRACTION_MULT at the last row.
1955      * w_prev_fraction_row was the actual cursor row when w_fraction was last
1956      * calculated.
1957      */
1958     int		w_fraction;
1959     int		w_prev_fraction_row;
1960 
1961 #ifdef FEAT_GUI
1962     scrollbar_T	w_scrollbars[2];	/* vert. Scrollbars for this window */
1963 #endif
1964 #ifdef FEAT_LINEBREAK
1965     linenr_T	w_nrwidth_line_count;	/* line count when ml_nrwidth_width
1966 					 * was computed. */
1967     int		w_nrwidth_width;	/* nr of chars to print line count. */
1968 #endif
1969 
1970 #ifdef FEAT_QUICKFIX
1971     qf_info_T	*w_llist;		/* Location list for this window */
1972     /*
1973      * Location list reference used in the location list window.
1974      * In a non-location list window, w_llist_ref is NULL.
1975      */
1976     qf_info_T	*w_llist_ref;
1977 #endif
1978 
1979 
1980 #ifdef FEAT_MZSCHEME
1981     void	*w_mzscheme_ref;	/* The MzScheme value for this window */
1982 #endif
1983 
1984 #ifdef FEAT_PERL
1985     void	*w_perl_private;
1986 #endif
1987 
1988 #ifdef FEAT_PYTHON
1989     void	*w_python_ref;		/* The Python value for this window */
1990 #endif
1991 
1992 #ifdef FEAT_TCL
1993     void	*w_tcl_ref;
1994 #endif
1995 
1996 #ifdef FEAT_RUBY
1997     void	*w_ruby_ref;
1998 #endif
1999 };
2000 
2001 /*
2002  * Arguments for operators.
2003  */
2004 typedef struct oparg_S
2005 {
2006     int		op_type;	/* current pending operator type */
2007     int		regname;	/* register to use for the operator */
2008     int		motion_type;	/* type of the current cursor motion */
2009     int		motion_force;	/* force motion type: 'v', 'V' or CTRL-V */
2010     int		use_reg_one;	/* TRUE if delete uses reg 1 even when not
2011 				   linewise */
2012     int		inclusive;	/* TRUE if char motion is inclusive (only
2013 				   valid when motion_type is MCHAR */
2014     int		end_adjusted;	/* backuped b_op_end one char (only used by
2015 				   do_format()) */
2016     pos_T	start;		/* start of the operator */
2017     pos_T	end;		/* end of the operator */
2018     pos_T	cursor_start;	/* cursor position before motion for "gw" */
2019 
2020     long	line_count;	/* number of lines from op_start to op_end
2021 				   (inclusive) */
2022     int		empty;		/* op_start and op_end the same (only used by
2023 				   do_change()) */
2024 #ifdef FEAT_VISUAL
2025     int		is_VIsual;	/* operator on Visual area */
2026     int		block_mode;	/* current operator is Visual block mode */
2027 #endif
2028     colnr_T	start_vcol;	/* start col for block mode operator */
2029     colnr_T	end_vcol;	/* end col for block mode operator */
2030 } oparg_T;
2031 
2032 /*
2033  * Arguments for Normal mode commands.
2034  */
2035 typedef struct cmdarg_S
2036 {
2037     oparg_T	*oap;		/* Operator arguments */
2038     int		prechar;	/* prefix character (optional, always 'g') */
2039     int		cmdchar;	/* command character */
2040     int		nchar;		/* next command character (optional) */
2041 #ifdef FEAT_MBYTE
2042     int		ncharC1;	/* first composing character (optional) */
2043     int		ncharC2;	/* second composing character (optional) */
2044 #endif
2045     int		extra_char;	/* yet another character (optional) */
2046     long	opcount;	/* count before an operator */
2047     long	count0;		/* count before command, default 0 */
2048     long	count1;		/* count before command, default 1 */
2049     int		arg;		/* extra argument from nv_cmds[] */
2050     int		retval;		/* return: CA_* values */
2051     char_u	*searchbuf;	/* return: pointer to search pattern or NULL */
2052 } cmdarg_T;
2053 
2054 /* values for retval: */
2055 #define CA_COMMAND_BUSY	    1	/* skip restarting edit() once */
2056 #define CA_NO_ADJ_OP_END    2	/* don't adjust operator end */
2057 
2058 #ifdef CURSOR_SHAPE
2059 /*
2060  * struct to store values from 'guicursor' and 'mouseshape'
2061  */
2062 /* Indexes in shape_table[] */
2063 #define SHAPE_IDX_N	0	/* Normal mode */
2064 #define SHAPE_IDX_V	1	/* Visual mode */
2065 #define SHAPE_IDX_I	2	/* Insert mode */
2066 #define SHAPE_IDX_R	3	/* Replace mode */
2067 #define SHAPE_IDX_C	4	/* Command line Normal mode */
2068 #define SHAPE_IDX_CI	5	/* Command line Insert mode */
2069 #define SHAPE_IDX_CR	6	/* Command line Replace mode */
2070 #define SHAPE_IDX_O	7	/* Operator-pending mode */
2071 #define SHAPE_IDX_VE	8	/* Visual mode with 'seleciton' exclusive */
2072 #define SHAPE_IDX_CLINE	9	/* On command line */
2073 #define SHAPE_IDX_STATUS 10	/* A status line */
2074 #define SHAPE_IDX_SDRAG 11	/* dragging a status line */
2075 #define SHAPE_IDX_VSEP	12	/* A vertical separator line */
2076 #define SHAPE_IDX_VDRAG 13	/* dragging a vertical separator line */
2077 #define SHAPE_IDX_MORE	14	/* Hit-return or More */
2078 #define SHAPE_IDX_MOREL	15	/* Hit-return or More in last line */
2079 #define SHAPE_IDX_SM	16	/* showing matching paren */
2080 #define SHAPE_IDX_COUNT	17
2081 
2082 #define SHAPE_BLOCK	0	/* block cursor */
2083 #define SHAPE_HOR	1	/* horizontal bar cursor */
2084 #define SHAPE_VER	2	/* vertical bar cursor */
2085 
2086 #define MSHAPE_NUMBERED	1000	/* offset for shapes identified by number */
2087 #define MSHAPE_HIDE	1	/* hide mouse pointer */
2088 
2089 #define SHAPE_MOUSE	1	/* used for mouse pointer shape */
2090 #define SHAPE_CURSOR	2	/* used for text cursor shape */
2091 
2092 typedef struct cursor_entry
2093 {
2094     int		shape;		/* one of the SHAPE_ defines */
2095     int		mshape;		/* one of the MSHAPE defines */
2096     int		percentage;	/* percentage of cell for bar */
2097     long	blinkwait;	/* blinking, wait time before blinking starts */
2098     long	blinkon;	/* blinking, on time */
2099     long	blinkoff;	/* blinking, off time */
2100     int		id;		/* highlight group ID */
2101     int		id_lm;		/* highlight group ID for :lmap mode */
2102     char	*name;		/* mode name (fixed) */
2103     char	used_for;	/* SHAPE_MOUSE and/or SHAPE_CURSOR */
2104 } cursorentry_T;
2105 #endif /* CURSOR_SHAPE */
2106 
2107 #ifdef FEAT_MENU
2108 
2109 /* Indices into vimmenu_T->strings[] and vimmenu_T->noremap[] for each mode */
2110 #define MENU_INDEX_INVALID	-1
2111 #define MENU_INDEX_NORMAL	0
2112 #define MENU_INDEX_VISUAL	1
2113 #define MENU_INDEX_SELECT	2
2114 #define MENU_INDEX_OP_PENDING	3
2115 #define MENU_INDEX_INSERT	4
2116 #define MENU_INDEX_CMDLINE	5
2117 #define MENU_INDEX_TIP		6
2118 #define MENU_MODES		7
2119 
2120 /* Menu modes */
2121 #define MENU_NORMAL_MODE	(1 << MENU_INDEX_NORMAL)
2122 #define MENU_VISUAL_MODE	(1 << MENU_INDEX_VISUAL)
2123 #define MENU_SELECT_MODE	(1 << MENU_INDEX_SELECT)
2124 #define MENU_OP_PENDING_MODE	(1 << MENU_INDEX_OP_PENDING)
2125 #define MENU_INSERT_MODE	(1 << MENU_INDEX_INSERT)
2126 #define MENU_CMDLINE_MODE	(1 << MENU_INDEX_CMDLINE)
2127 #define MENU_TIP_MODE		(1 << MENU_INDEX_TIP)
2128 #define MENU_ALL_MODES		((1 << MENU_INDEX_TIP) - 1)
2129 /*note MENU_INDEX_TIP is not a 'real' mode*/
2130 
2131 /* Start a menu name with this to not include it on the main menu bar */
2132 #define MNU_HIDDEN_CHAR		']'
2133 
2134 typedef struct VimMenu vimmenu_T;
2135 
2136 struct VimMenu
2137 {
2138     int		modes;		    /* Which modes is this menu visible for? */
2139     int		enabled;	    /* for which modes the menu is enabled */
2140     char_u	*name;		    /* Name of menu */
2141     char_u	*dname;		    /* Displayed Name (without '&') */
2142     int		mnemonic;	    /* mnemonic key (after '&') */
2143     char_u	*actext;	    /* accelerator text (after TAB) */
2144     int		priority;	    /* Menu order priority */
2145 #ifdef FEAT_GUI
2146     void	(*cb) __ARGS((vimmenu_T *));	    /* Call-back routine */
2147 #endif
2148 #ifdef FEAT_TOOLBAR
2149     char_u	*iconfile;	    /* name of file for icon or NULL */
2150     int		iconidx;	    /* icon index (-1 if not set) */
2151     int		icon_builtin;	    /* icon names is BuiltIn{nr} */
2152 #endif
2153     char_u	*strings[MENU_MODES]; /* Mapped string for each mode */
2154     int		noremap[MENU_MODES]; /* A REMAP_ flag for each mode */
2155     char	silent[MENU_MODES]; /* A silent flag for each mode */
2156     vimmenu_T	*children;	    /* Children of sub-menu */
2157     vimmenu_T	*parent;	    /* Parent of menu */
2158     vimmenu_T	*next;		    /* Next item in menu */
2159 #ifdef FEAT_GUI_X11
2160     Widget	id;		    /* Manage this to enable item */
2161     Widget	submenu_id;	    /* If this is submenu, add children here */
2162 #endif
2163 #ifdef FEAT_GUI_GTK
2164     GtkWidget	*id;		    /* Manage this to enable item */
2165     GtkWidget	*submenu_id;	    /* If this is submenu, add children here */
2166     GtkWidget	*tearoff_handle;
2167     GtkWidget   *label;		    /* Used by "set wak=" code. */
2168 #endif
2169 #ifdef FEAT_GUI_MOTIF
2170     int		sensitive;	    /* turn button on/off */
2171     char	**xpm;		    /* pixmap data */
2172     char	*xpm_fname;	    /* file with pixmap data */
2173 #endif
2174 #ifdef FEAT_GUI_ATHENA
2175     Pixmap	image;		    /* Toolbar image */
2176 #endif
2177 #ifdef FEAT_BEVAL_TIP
2178     BalloonEval *tip;		    /* tooltip for this menu item */
2179 #endif
2180 #ifdef FEAT_GUI_W16
2181     UINT	id;		    /* Id of menu item */
2182     HMENU	submenu_id;	    /* If this is submenu, add children here */
2183 #endif
2184 #ifdef FEAT_GUI_W32
2185     UINT	id;		    /* Id of menu item */
2186     HMENU	submenu_id;	    /* If this is submenu, add children here */
2187     HWND	tearoff_handle;	    /* hWnd of tearoff if created */
2188 #endif
2189 #ifdef FEAT_GUI_MAC
2190 /*  MenuHandle	id; */
2191 /*  short	index;	*/	    /* the item index within the father menu */
2192     short	menu_id;	    /* the menu id to which this item belong */
2193     short	submenu_id;	    /* the menu id of the children (could be
2194 				       get throught some tricks) */
2195     MenuHandle	menu_handle;
2196     MenuHandle	submenu_handle;
2197 #endif
2198 #ifdef RISCOS
2199     int		*id;		    /* Not used, but gui.c needs it */
2200     int		greyed_out;	    /* Flag */
2201     int		hidden;
2202 #endif
2203 #ifdef FEAT_GUI_PHOTON
2204     PtWidget_t	*id;
2205     PtWidget_t	*submenu_id;
2206 #endif
2207 };
2208 #else
2209 /* For generating prototypes when FEAT_MENU isn't defined. */
2210 typedef int vimmenu_T;
2211 
2212 #endif /* FEAT_MENU */
2213 
2214 /*
2215  * Struct to save values in before executing autocommands for a buffer that is
2216  * not the current buffer.  Without FEAT_AUTOCMD only "curbuf" is remembered.
2217  */
2218 typedef struct
2219 {
2220     buf_T	*save_buf;	/* saved curbuf */
2221 #ifdef FEAT_AUTOCMD
2222     buf_T	*new_curbuf;	/* buffer to be used */
2223     win_T	*save_curwin;	/* saved curwin, NULL if it didn't change */
2224     win_T	*new_curwin;	/* new curwin if save_curwin != NULL */
2225     pos_T	save_cursor;	/* saved cursor pos of save_curwin */
2226     linenr_T	save_topline;	/* saved topline of save_curwin */
2227 # ifdef FEAT_DIFF
2228     int		save_topfill;	/* saved topfill of save_curwin */
2229 # endif
2230 #endif
2231 } aco_save_T;
2232 
2233 /*
2234  * Generic option table item, only used for printer at the moment.
2235  */
2236 typedef struct
2237 {
2238     const char	*name;
2239     int		hasnum;
2240     long	number;
2241     char_u	*string;	/* points into option string */
2242     int		strlen;
2243     int		present;
2244 } option_table_T;
2245 
2246 /*
2247  * Structure to hold printing color and font attributes.
2248  */
2249 typedef struct
2250 {
2251     long_u	fg_color;
2252     long_u	bg_color;
2253     int		bold;
2254     int		italic;
2255     int		underline;
2256     int		undercurl;
2257 } prt_text_attr_T;
2258 
2259 /*
2260  * Structure passed back to the generic printer code.
2261  */
2262 typedef struct
2263 {
2264     int		n_collated_copies;
2265     int		n_uncollated_copies;
2266     int		duplex;
2267     int		chars_per_line;
2268     int		lines_per_page;
2269     int		has_color;
2270     prt_text_attr_T number;
2271 #ifdef FEAT_SYN_HL
2272     int		modec;
2273     int		do_syntax;
2274 #endif
2275     int		user_abort;
2276     char_u	*jobname;
2277 #ifdef FEAT_POSTSCRIPT
2278     char_u	*outfile;
2279     char_u	*arguments;
2280 #endif
2281 } prt_settings_T;
2282 
2283 #define PRINT_NUMBER_WIDTH 8
2284 
2285 /*
2286  * Used for popup menu items.
2287  */
2288 typedef struct
2289 {
2290     char_u	*pum_text;	/* main menu text */
2291     char_u	*pum_kind;	/* extra kind text (may be truncated) */
2292     char_u	*pum_extra;	/* extra menu text (may be truncated) */
2293     char_u	*pum_info;	/* extra info */
2294 } pumitem_T;
2295 
2296 /*
2297  * Structure used for get_tagfname().
2298  */
2299 typedef struct
2300 {
2301     char_u	*tn_tags;	/* value of 'tags' when starting */
2302     char_u	*tn_np;		/* current position in tn_tags */
2303     int		tn_did_filefind_init;
2304     int		tn_hf_idx;
2305     void	*tn_search_ctx;
2306 } tagname_T;
2307 
2308 /*
2309  * Array indexes used for cptext argument of ins_compl_add().
2310  */
2311 #define CPT_ABBR    0	/* "abbr" */
2312 #define CPT_MENU    1	/* "menu" */
2313 #define CPT_KIND    2	/* "kind" */
2314 #define CPT_INFO    3	/* "info" */
2315 #define CPT_COUNT   4	/* Number of entries */
2316