Mercurial > vim
annotate runtime/doc/version4.txt @ 34074:1629cc65d78d v9.1.0006
patch 9.1.0006: is*() and to*() function may be unsafe
Commit: https://github.com/vim/vim/commit/184f71cc6868a240dc872ed2852542bbc1d43e28
Author: Keith Thompson <Keith.S.Thompson@gmail.com>
Date: Thu Jan 4 21:19:04 2024 +0100
patch 9.1.0006: is*() and to*() function may be unsafe
Problem: is*() and to*() function may be unsafe
Solution: Add SAFE_* macros and start using those instead
(Keith Thompson)
Use SAFE_() macros for is*() and to*() functions
The standard is*() and to*() functions declared in <ctype.h> have
undefined behavior for negative arguments other than EOF. If plain char
is signed, passing an unchecked value from argv for from user input
to one of these functions has undefined behavior.
Solution: Add SAFE_*() macros that cast the argument to unsigned char.
Most implementations behave sanely for negative arguments, and most
character values in practice are non-negative, but it's still best
to avoid undefined behavior.
The change from #13347 has been omitted, as this has already been
separately fixed in commit ac709e2fc0db6d31abb7da96f743c40956b60c3a
(v9.0.2054)
fixes: #13332
closes: #13347
Signed-off-by: Keith Thompson <Keith.S.Thompson@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
| author | Christian Brabandt <cb@256bit.org> |
|---|---|
| date | Thu, 04 Jan 2024 21:30:04 +0100 |
| parents | 4635e43f2c6f |
| children |
| rev | line source |
|---|---|
|
34057
4635e43f2c6f
patch 9.1.0000: Vim 9.1 release
Christian Brabandt <cb@256bit.org>
parents:
29314
diff
changeset
|
1 *version4.txt* For Vim version 9.1. Last change: 2006 Apr 24 |
| 7 | 2 |
| 3 | |
| 4 VIM REFERENCE MANUAL by Bram Moolenaar | |
| 5 | |
| 6 | |
| 7 This document lists the incompatible differences between Vim 3.0 and Vim 4.0. | |
| 8 Although 4.0 is mentioned here, this is also for version 4.1, 4.2, etc.. | |
| 9 | |
| 10 This file is important for everybody upgrading from Vim 3.0. Read it | |
| 11 carefully to avoid unexpected problems. | |
| 12 | |
| 13 'backup' option default changed |backup-changed| | |
| 14 Extension for backup file changed |backup-extension| | |
| 15 Structure of swap file changed |swapfile-changed| | |
| 16 "-w scriptout" argument changed |scriptout-changed| | |
| 17 Backspace and Delete keys |backspace-delete| | |
| 18 Escape for | changed |escape-bar| | |
| 19 Key codes changed |key-codes-changed| | |
| 20 Terminal options changed |termcap-changed| | |
| 21 'errorformat' option changed |errorformat-changed| | |
| 22 'graphic' option gone |graphic-option-gone| | |
| 23 'yankendofline' option gone |ye-option-gone| | |
| 24 'icon' and 'title' default value changed |icon-changed| | |
| 25 'highlight' option changed |highlight-changed| | |
| 26 'tildeop' and 'weirdinvert' short names changed |short-name-changed| | |
| 27 Use of "v", "V" and "CTRL-V" in Visual mode |use-visual-cmds| | |
| 28 CTRL-B in Insert mode removed |toggle-revins| | |
| 29 | |
| 30 | |
| 31 'backup' option default changed *backup-changed* | |
| 32 ------------------------------- | |
| 33 | |
| 34 The default value for 'backup' used to be on. This resulted in a backup file | |
| 35 being made when the original file was overwritten. | |
| 36 | |
| 37 Now the default for 'backup' is off. As soon as the writing of the file has | |
| 38 successfully finished, the backup file is deleted. If you want to keep the | |
| 39 backup file, set 'backup' on in your vimrc. The reason for this change is | |
| 40 that many people complained that leaving a backup file behind is not | |
| 41 Vi-compatible. |'backup'| | |
| 42 | |
| 43 | |
| 44 Extension for backup file changed *backup-extension* | |
| 45 --------------------------------- | |
| 46 | |
| 47 The extension for the backup file used to be ".bak". Since other programs | |
| 48 also use this extension and some users make copies with this extension, it was | |
| 49 changed to the less obvious "~". Another advantage is that this takes less | |
| 50 space, which is useful when working on a system with short file names. For | |
| 51 example, on MS-DOS the backup files for "longfile.c" and "longfile.h" would | |
| 52 both become "longfile.bak"; now they will be "longfile.c~" and "longfile.h~". | |
| 53 | |
| 54 If you prefer to use ".bak", you can set the 'backupext' option: > | |
| 55 :set bex=.bak | |
| 56 | |
| 57 | |
| 58 Structure of swap file changed *swapfile-changed* | |
| 59 ------------------------------ | |
| 60 | |
| 61 The contents of the swap file were extended with several parameters. Vim | |
| 62 stores the user name and other information about the edited file to make | |
| 63 recovery more easy and to be able to know where the swap file comes from. The | |
| 64 first part of the swap file can now be understood on a machine with a | |
| 65 different byte order or sizeof(int). When you try to recover a file on such a | |
| 66 machine, you will get an error message that this is not possible. | |
| 67 | |
| 68 Because of this change, swap files cannot be exchanged between 3.0 and 4.0. | |
| 69 If you have a swap file from a crashed session with 3.0, use Vim 3.0 to | |
| 70 recover the file---don't use 4.0. |swap-file| | |
| 71 | |
| 72 | |
| 73 "-w scriptout" argument changed *scriptout-changed* | |
| 74 ------------------------------- | |
| 75 | |
| 76 "vim -w scriptout" used to append to the scriptout file. Since this was | |
| 77 illogical, it now creates a new file. An existing file is not overwritten | |
| 78 (to avoid destroying an existing file for those who rely on the appending). | |
| 79 [This was removed again later] |-w| | |
| 80 | |
| 81 | |
| 82 Backspace and Delete keys *backspace-delete* | |
| 83 ------------------------- | |
| 84 | |
| 85 In 3.0 both the delete key and the backspace key worked as a backspace in | |
| 86 insert mode; they deleted the character to the left of the cursor. In 4.0 the | |
| 87 delete key has a new function: it deletes the character under the cursor, just | |
| 88 like it does on the command-line. If the cursor is after the end of the line | |
| 89 and 'bs' is set, two lines are joined. |<Del>| |i_<Del>| | |
| 90 | |
| 91 In 3.0 the backspace key was always defined as CTRL-H and delete as CTRL-?. | |
| 92 In 4.0 the code for the backspace and delete key is obtained from termcap or | |
| 93 termlib, and adjusted for the "stty erase" value on Unix. This helps people | |
| 94 who define the erase character according to the keyboard they are working on. | |
| 95 |<BS>| |i_<BS>| | |
| 96 | |
| 97 If you prefer backspace and delete in Insert mode to have the old behavior, | |
| 98 put this line in your vimrc: | |
| 99 | |
| 100 inoremap ^? ^H | |
| 101 | |
| 102 And you may also want to add these, to fix the values for <BS> and <Del>: | |
| 103 | |
| 104 set t_kb=^H | |
| 105 set t_kD=^? | |
| 106 | |
| 107 (Enter ^H with CTRL-V CTRL-H and ^? with CTRL-V CTRL-? or <Del>.) | |
| 108 | |
| 109 If the value for t_kb is correct, but the t_kD value is not, use the ":fixdel" | |
| 110 command. It will set t_kD according to the value of t_kb. This is useful if | |
| 111 you are using several different terminals. |:fixdel| | |
| 112 | |
| 113 When ^H is not recognized as <BS> or <Del>, it is used like a backspace. | |
| 114 | |
| 115 | |
| 116 Escape for | changed *escape-bar* | |
| 117 -------------------- | |
| 118 | |
| 119 When the 'b' flag is present in 'cpoptions', the backslash cannot be used to | |
| 120 escape '|' in mapping and abbreviate commands, only CTRL-V can. This is | |
| 121 Vi-compatible. If you work in Vi-compatible mode and had used "\|" to include | |
| 122 a bar in a mapping, this needs to be replaced by "^V|". See |:bar|. | |
| 123 | |
| 124 | |
| 125 Key codes changed *key-codes-changed* | |
| 126 ----------------- | |
| 127 | |
| 128 The internal representation of key codes has changed dramatically. In 3.0 a | |
| 129 one-byte code was used to represent a key. This caused problems with | |
| 130 different characters sets that also used these codes. In 4.0 a three-byte | |
| 131 code is used that cannot be confused with a character. |key-notation| | |
| 132 | |
| 133 If you have used the single-byte key codes in your vimrc for mappings, you | |
| 134 will have to replace them with the 4.0 codes. Instead of using the three-byte | |
| 135 code directly, you should use the symbolic representation for this in <>. See | |
| 136 the table below. The table also lists the old name, as it was used in the 3.0 | |
| 137 documentation. | |
| 138 | |
| 139 The key names in <> can be used in mappings directly. This makes it possible | |
| 140 to copy/paste examples or type them literally. The <> notation has been | |
| 141 introduced for this |<>|. The 'B' and '<' flags must not be present in | |
| 142 'cpoptions' to enable this to work |'cpoptions'|. | |
| 143 | |
| 144 old name new name old code old MS-DOS code ~ | |
| 145 hex dec hex dec ~ | |
| 146 <ESC> <Esc> | |
| 147 <TAB> <Tab> | |
| 148 <LF> <NL> <NewLine> <LineFeed> | |
| 149 <SPACE> <Space> | |
| 150 <NUL> <Nul> | |
| 151 <BELL> <Bell> | |
| 152 <BS> <BS> <BackSpace> | |
| 153 <INSERT> <Insert> | |
| 154 <DEL> <Del> <Delete> | |
| 155 <HOME> <Home> | |
| 156 <END> <End> | |
| 157 <PAGE_UP> <PageUp> | |
| 158 <PAGE_DOWN> <PageDown> | |
| 159 | |
| 160 <C_UP> <Up> 0x80 128 0xb0 176 | |
| 161 <C_DOWN> <Down> 0x81 129 0xb1 177 | |
| 162 <C_LEFT> <Left> 0x82 130 0xb2 178 | |
| 163 <C_RIGHT> <Right> 0x83 131 0xb3 179 | |
| 164 <SC_UP> <S-Up> 0x84 132 0xb4 180 | |
| 165 <SC_DOWN> <S-Down> 0x85 133 0xb5 181 | |
| 166 <SC_LEFT> <S-Left> 0x86 134 0xb6 182 | |
| 167 <SC_RIGHT> <S-Right> 0x87 135 0xb7 183 | |
| 168 | |
| 169 <F1> <F1> 0x88 136 0xb8 184 | |
| 170 <F2> <F2> 0x89 137 0xb9 185 | |
| 171 <F3> <F3> 0x8a 138 0xba 186 | |
| 172 <F4> <F4> 0x8b 139 0xbb 187 | |
| 173 <F5> <F5> 0x8c 140 0xbc 188 | |
| 174 <F6> <F6> 0x8d 141 0xbd 189 | |
| 175 <F7> <F7> 0x8e 142 0xbe 190 | |
| 176 <F8> <F8> 0x8f 143 0xbf 191 | |
| 177 <F9> <F9> 0x90 144 0xc0 192 | |
| 178 <F10> <F10> 0x91 145 0xc1 193 | |
| 179 | |
| 180 <SF1> <S-F1> 0x92 146 0xc2 194 | |
| 181 <SF2> <S-F2> 0x93 147 0xc3 195 | |
| 182 <SF3> <S-F3> 0x94 148 0xc4 196 | |
| 183 <SF4> <S-F4> 0x95 149 0xc5 197 | |
| 184 <SF5> <S-F5> 0x96 150 0xc6 198 | |
| 185 <SF6> <S-F6> 0x97 151 0xc7 199 | |
| 186 <SF7> <S-F7> 0x98 152 0xc8 200 | |
| 187 <SF8> <S-F8> 0x99 153 0xc9 201 | |
| 188 <SF9> <S-F9> 0x9a 154 0xca 202 | |
| 189 <SF10> <S-F10> 0x9b 155 0xcb 203 | |
| 190 | |
| 191 <HELP> <Help> 0x9c 156 0xcc 204 | |
| 192 <UNDO> <Undo> 0x9d 157 0xcd 205 | |
| 193 | |
| 194 (not used) 0x9e 158 0xce 206 | |
| 195 (not used) 0x9f 159 0xcf 207 | |
| 196 | |
| 197 | |
| 198 Terminal options changed *termcap-changed* | |
| 199 ------------------------ | |
| 200 | |
| 201 The names of the terminal options have been changed to match the termcap names | |
| 202 of these options. All terminal options now have the name t_xx, where xx is | |
| 203 the termcap name. Normally these options are not used, unless you have a | |
| 204 termcap entry that is wrong or incomplete, or you have set the highlight | |
| 205 options to a different value. |terminal-options| | |
| 206 | |
| 207 Note that for some keys there is no termcap name. Use the <> type of name | |
| 208 instead, which is a good idea anyway. | |
| 209 | |
| 210 Note that "t_ti" has become "t_mr" (invert/reverse output) and "t_ts" has | |
| 211 become "t_ti" (init terminal mode). Be careful when you use "t_ti"! | |
| 212 | |
| 213 old name new name meaning ~ | |
| 214 t_cdl t_DL delete number of lines *t_cdl* | |
| 215 t_ci t_vi cursor invisible *t_ci* | |
| 216 t_cil t_AL insert number of lines *t_cil* | |
| 217 t_cm t_cm move cursor | |
| 218 t_cri t_RI cursor number of chars right *t_cri* | |
| 219 t_cv t_ve cursor visible *t_cv* | |
| 220 t_cvv t_vs cursor very visible *t_cvv* | |
| 221 t_dl t_dl delete line | |
| 222 t_cs t_cs scroll region | |
| 223 t_ed t_cl clear display *t_ed* | |
| 224 t_el t_ce clear line *t_el* | |
| 225 t_il t_al insert line *t_il* | |
| 226 t_da display may be retained above the screen | |
| 227 t_db display may be retained below the screen | |
| 228 t_ke t_ke put terminal out of keypad transmit mode | |
| 229 t_ks t_ks put terminal in keypad transmit mode | |
| 230 t_ms t_ms save to move cursor in highlight mode | |
| 231 t_se t_se normal mode (undo t_so) | |
| 232 t_so t_so shift out (standout) mode | |
| 233 t_ti t_mr reverse highlight | |
| 234 t_tb t_md bold mode *t_tb* | |
| 235 t_tp t_me highlight end *t_tp* | |
| 236 t_sr t_sr scroll reverse | |
| 237 t_te t_te out of termcap mode | |
| 238 t_ts t_ti into termcap mode *t_ts_old* | |
| 239 t_vb t_vb visual bell | |
| 240 t_csc t_CS cursor is relative to scroll region *t_csc* | |
| 241 | |
| 242 t_ku t_ku <Up> arrow up | |
| 243 t_kd t_kd <Down> arrow down | |
| 244 t_kr t_kr <Right> arrow right | |
| 245 t_kl t_kl <Left> arrow left | |
| 246 t_sku <S-Up> shifted arrow up *t_sku* | |
| 247 t_skd <S-Down> shifted arrow down *t_skd* | |
| 248 t_skr t_%i <S-Right> shifted arrow right *t_skr* | |
| 249 t_skl t_#4 <S-Left> shifted arrow left *t_skl* | |
| 250 t_f1 t_k1 <F1> function key 1 *t_f1* | |
| 251 t_f2 t_k2 <F2> function key 2 *t_f2* | |
| 252 t_f3 t_k3 <F3> function key 3 *t_f3* | |
| 253 t_f4 t_k4 <F4> function key 4 *t_f4* | |
| 254 t_f5 t_k5 <F5> function key 5 *t_f5* | |
| 255 t_f6 t_k6 <F6> function key 6 *t_f6* | |
| 256 t_f7 t_k7 <F7> function key 7 *t_f7* | |
| 257 t_f8 t_k8 <F8> function key 8 *t_f8* | |
| 258 t_f9 t_k9 <F9> function key 9 *t_f9* | |
| 259 t_f10 t_k; <F10> function key 10 *t_f10* | |
| 260 t_sf1 <S-F1> shifted function key 1 *t_sf1* | |
| 261 t_sf2 <S-F2> shifted function key 2 *t_sf2* | |
| 262 t_sf3 <S-F3> shifted function key 3 *t_sf3* | |
| 263 t_sf4 <S-F4> shifted function key 4 *t_sf4* | |
| 264 t_sf5 <S-F5> shifted function key 5 *t_sf5* | |
| 265 t_sf6 <S-F6> shifted function key 6 *t_sf6* | |
| 266 t_sf7 <S-F7> shifted function key 7 *t_sf7* | |
| 267 t_sf8 <S-F8> shifted function key 8 *t_sf8* | |
| 268 t_sf9 <S-F9> shifted function key 9 *t_sf9* | |
| 269 t_sf10 <S-F10> shifted function key 10 *t_sf10* | |
| 270 t_help t_%1 <Help> help key *t_help* | |
| 271 t_undo t_&8 <Undo> undo key *t_undo* | |
| 272 | |
| 273 | |
| 274 'errorformat' option changed *errorformat-changed* | |
| 275 ---------------------------- | |
| 276 | |
| 277 'errorformat' can now contain several formats, separated by commas. The first | |
| 278 format that matches is used. The default values have been adjusted to catch | |
| 279 the most common formats. |errorformat| | |
| 280 | |
| 281 If you have a format that contains a comma, it needs to be preceded with a | |
| 282 backslash. Type two backslashes, because the ":set" command will eat one. | |
| 283 | |
| 284 | |
| 285 'graphic' option gone *graphic-option-gone* | |
| 286 --------------------- | |
| 287 | |
| 288 The 'graphic' option was used to make the characters between <~> and 0xa0 | |
| 289 display directly on the screen. Now the 'isprint' option takes care of this | |
| 290 with many more possibilities. The default setting is the same; you only need | |
| 291 to look into this if you previously set the 'graphic' option in your vimrc. | |
| 292 |'isprint'| | |
| 293 | |
| 294 | |
| 295 'yankendofline' option gone *ye-option-gone* | |
| 296 --------------------------- | |
| 297 | |
| 298 The 'yankendofline' option has been removed. Instead you can just use | |
| 299 :map Y y$ | |
| 300 | |
| 301 | |
| 302 'icon' and 'title' default value changed *icon-changed* | |
| 303 ---------------------------------------- | |
| 304 | |
| 305 The 'title' option is now only set by default if the original title can be | |
| 306 restored. Avoids "Thanks for flying Vim" titles. If you want them anyway, | |
| 307 put ":set title" in your vimrc. |'title'| | |
| 308 | |
| 309 The default for 'icon' now depends on the possibility of restoring the | |
| 310 original value, just like 'title'. If you don't like your icon titles to be | |
| 311 changed, add this line to your vimrc: |'icon'| | |
| 312 :set noicon | |
| 313 | |
| 314 | |
| 315 'highlight' option changed *highlight-changed* | |
| 316 -------------------------- | |
| 317 | |
| 318 The 'i' flag now means italic highlighting, instead of invert. The 'r' flag | |
| 319 is used for reverse highlighting, which is what 'i' used to be. Normally you | |
| 320 won't see the difference, because italic mode is not supported on most | |
| 321 terminals and reverse mode is used as a fallback. |'highlight'| | |
| 322 | |
| 323 When an occasion is not present in 'highlight', use the mode from the default | |
| 324 value for 'highlight', instead of reverse mode. | |
| 325 | |
| 326 | |
| 327 'tildeop' and 'weirdinvert' short names changed *short-name-changed* | |
| 328 ----------------------------------------------- | |
| 329 | |
| 330 Renamed 'to' (abbreviation for 'tildeop') to 'top'. |'tildeop'| | |
| 331 Renamed 'wi' (abbreviation for 'weirdinvert') to 'wiv'. |'weirdinvert'| | |
| 332 | |
| 333 This was done because Vi uses 'wi' as the short name for 'window' and 'to' as | |
| 334 the short name for 'timeout'. This means that if you try setting these | |
| 335 options, you won't get an error message, but the effect will be different. | |
| 336 | |
| 337 | |
| 338 Use of "v", "V" and "CTRL-V" in Visual mode *use-visual-cmds* | |
| 339 ------------------------------------------- | |
| 340 | |
| 341 In Visual mode, "v", "V", and "CTRL-V" used to end Visual mode. Now this | |
| 342 happens only if the Visual mode was in the corresponding type. Otherwise the | |
| 343 type of Visual mode is changed. Now only ESC can be used in all circumstances | |
| 344 to end Visual mode without doing anything. |v_V| | |
| 345 | |
| 346 | |
| 347 CTRL-B in Insert mode removed *toggle-revins* | |
| 348 ----------------------------- | |
| 349 | |
| 350 CTRL-B in Insert mode used to toggle the 'revins' option. If you don't know | |
| 351 this and accidentally hit CTRL-B, it is very difficult to find out how to undo | |
| 352 it. Since hardly anybody uses this feature, it is disabled by default. If | |
| 353 you want to use it, define RIGHTLEFT in feature.h before compiling. |'revins'| | |
| 354 | |
| 14519 | 355 vim:tw=78:ts=8:noet:ft=help:norl: |