annotate runtime/doc/os_dos.txt @ 20577:5f0f1f63c8df v8.2.0842

patch 8.2.0842: MS-Windows: channel tests fail Commit: https://github.com/vim/vim/commit/208534d9ae6e8dec5baff90440b58c63f0b37981 Author: Bram Moolenaar <Bram@vim.org> Date: Sat May 30 13:07:39 2020 +0200 patch 8.2.0842: MS-Windows: channel tests fail Problem: MS-Windows: channel tests fail. Solution: Adjust #ifdefs. (closes https://github.com/vim/vim/issues/6162)
author Bram Moolenaar <Bram@vim.org>
date Sat, 30 May 2020 13:15:03 +0200
parents 63beef1ca62c
children 0ce24f734615
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
18879
af69c9335223 Vim 8.2 release
Bram Moolenaar <Bram@vim.org>
parents: 14421
diff changeset
1 *os_dos.txt* For Vim version 8.2. Last change: 2006 Mar 30
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 VIM REFERENCE MANUAL by Bram Moolenaar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 *dos* *DOS*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8 This file documents the common particularities of the MS-DOS and Win32
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 versions of Vim. Also see |os_win32.txt| and |os_msdos.txt|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 1. File locations |dos-locations|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 2. Using backslashes |dos-backslash|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 3. Standard mappings |dos-standard-mappings|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 4. Screen output and colors |dos-colors|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 5. File formats |dos-file-formats|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 6. :cd command |dos-:cd|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17 7. Interrupting |dos-CTRL-Break|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 8. Temp files |dos-temp-files|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 9. Shell option default |dos-shell|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22 1. File locations *dos-locations*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 If you keep the Vim executable in the directory that contains the help and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 syntax subdirectories, there is no need to do anything special for Vim to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26 work. No registry entries or environment variables need to be set. Just make
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27 sure that the directory is in your search path, or use a shortcut on the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 desktop.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30 Your vimrc files ("_vimrc" and "_gvimrc") are normally located one directory
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 up from the runtime files. If you want to put them somewhere else, set the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32 environment variable $VIM to the directory where you keep them. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 set VIM=C:\user\piet
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 Will find "c:\user\piet\_vimrc".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 Note: This would only be needed when the computer is used by several people.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 Otherwise it's simpler to keep your _vimrc file in the default place.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38 If you move the executable to another location, you also need to set the $VIM
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39 environment variable. The runtime files will be found in "$VIM/vim{version}".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 set VIM=E:\vim
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
42 Will find the version 8.2 runtime files in "e:\vim\vim82".
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 Note: This is _not_ recommended. The preferred way is to keep the executable
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 in the runtime directory.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 If you move your executable AND want to put your "_vimrc" and "_gvimrc" files
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 somewhere else, you must set $VIM to where you vimrc files are, and set
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 $VIMRUNTIME to the runtime files. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49 set VIM=C:\usr\piet
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
50 set VIMRUNTIME=E:\vim\vim82
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
51 Will find "c:\user\piet\_vimrc" and the runtime files in "e:\vim\vim82".
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 See |$VIM| and |$VIMRUNTIME| for more information.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54
19163
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19116
diff changeset
55 You can set environment variables for each user separately through the
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19116
diff changeset
56 System Properties dialog box. The steps to do that:
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19116
diff changeset
57 1. Type Windows Key + R to open the "Run" dialog box.
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19116
diff changeset
58 2. Enter "sysdm.cpl" and press the "OK" button. The "System Properties"
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19116
diff changeset
59 dialog box will open.
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19116
diff changeset
60 3. Select the "Advanced" tab and press the "Environment Variables..." button.
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19116
diff changeset
61 The "Environment Variables" dialog box will open.
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19116
diff changeset
62 4. Select an existing variable in the "User variables" list and press the
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19116
diff changeset
63 "Edit..." button to edit it. Or press the "New..." button to add a new
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19116
diff changeset
64 variable.
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19116
diff changeset
65 5. After you finished editing variables, press the "OK" button to save the
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19116
diff changeset
66 changes.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
67
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
68 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69 2. Using backslashes *dos-backslash*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
70
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71 Using backslashes in file names can be a problem. Vi halves the number of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
72 backslashes for some commands. Vim is a bit more tolerant and does not remove
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
73 backslashes from a file name, so ":e c:\foo\bar" works as expected. But when
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
74 a backslash occurs before a special character (space, comma, backslash, etc.),
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75 Vim removes the backslash. Use slashes to avoid problems: ":e c:/foo/bar"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
76 works fine. Vim replaces the slashes with backslashes internally to avoid
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
77 problems with some MS-DOS programs and Win32 programs.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
78
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79 When you prefer to use forward slashes, set the 'shellslash' option. Vim will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80 then replace backslashes with forward slashes when expanding file names. This
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81 is especially useful when using a Unix-like 'shell'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
83 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
84 3. Standard mappings *dos-standard-mappings*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 810
diff changeset
86 The mappings for CTRL-PageUp and CTRL-PageDown have been removed, they now
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 810
diff changeset
87 jump to the next or previous tab page |<C-PageUp>| |<C-PageDown>|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88
819
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 810
diff changeset
89 If you want them to move to the first and last screen line you can use these
23f82b5d2814 updated for version 7.0c10
vimboss
parents: 810
diff changeset
90 mappings:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
91
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
92 key key code Normal/Visual mode Insert mode ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93 CTRL-PageUp <M-N><M-C-D> H <C-O>H
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
94 CTRL-PageDown <M-N>v L$ <C-O>L<C-O>$
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
96 Additionally, these keys are available for copy/cut/paste. In the Win32
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
97 and DJGPP versions, they also use the clipboard.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
98
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
99 Shift-Insert paste text (from clipboard) *<S-Insert>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100 CTRL-Insert copy Visual text (to clipboard) *<C-Insert>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
101 CTRL-Del cut Visual text (to clipboard) *<C-Del>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
102 Shift-Del cut Visual text (to clipboard) *<S-Del>*
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
103 CTRL-X cut Visual text (to clipboard)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
105 These mappings accomplish this (Win32 and DJGPP versions of Vim):
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
107 key key code Normal Visual Insert ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
108 Shift-Insert <M-N><M-T> "*P "-d"*P <C-R><C-O>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
109 CTRL-Insert <M-N><M-U> "*y
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
110 Shift-Del <M-N><M-W> "*d
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
111 CTRL-Del <M-N><M-X> "*d
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
112 CTRL-X <C-X> "*d
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114 Or these mappings (non-Win32 version of Vim):
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116 key key code Normal Visual Insert ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
117 Shift-Insert <M-N><M-T> P "-dP <C-R><C-O>"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
118 CTRL-Insert <M-N><M-U> y
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
119 Shift-Del <M-N><M-W> d
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
120 CTRL-Del <M-N><M-X> d
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
122 When the clipboard is supported, the "* register is used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
123
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
124 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
125 4. Screen output and colors *dos-colors*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
126
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
127 The default output method for the screen is to use bios calls. This works
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
128 right away on most systems. You do not need ansi.sys. You can use ":mode" to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
129 set the current screen mode. See |:mode|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
130
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
131 To change the screen colors that Vim uses, you can use the |:highlight|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
132 command. The Normal highlight group specifies the colors Vim uses for normal
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
133 text. For example, to get grey text on a blue background: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
134 :hi Normal ctermbg=Blue ctermfg=grey
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
135 See |highlight-groups| for other groups that are available.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
136
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
137 A DOS console does not support attributes like bold and underlining. You can
667
9090f866cd57 updated for version 7.0197
vimboss
parents: 7
diff changeset
138 set the color used in five modes with nine terminal options. Note that this
9090f866cd57 updated for version 7.0197
vimboss
parents: 7
diff changeset
139 is not necessary since you can set the color directly with the ":highlight"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
140 command; these options are for backward compatibility with older Vim versions.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
141 The |'highlight'| option specifies which of the five modes is used for which
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
142 action. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
143
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
144 :set t_mr=^V^[\|xxm start of invert mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
145 :set t_md=^V^[\|xxm start of bold mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
146 :set t_me=^V^[\|xxm back to normal text
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
147
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
148 :set t_so=^V^[\|xxm start of standout mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
149 :set t_se=^V^[\|xxm back to normal text
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
150
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
151 :set t_us=^V^[\|xxm start of underline mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
152 :set t_ue=^V^[\|xxm back to normal text
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
153
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
154 :set t_ZH=^V^[\|xxm start of italics mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
155 :set t_ZR=^V^[\|xxm back to normal text
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
156
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
157 ^V is CTRL-V
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
158 ^[ is <Esc>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
159 You must replace xx with a decimal code, which is the foreground color number
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
160 and background color number added together:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
161
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
162 COLOR FOREGROUND BACKGROUND ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
163 Black 0 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
164 DarkBlue 1 16
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
165 DarkGreen 2 32
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
166 DarkCyan 3 48
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
167 DarkRed 4 64
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
168 DarkMagenta 5 80
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
169 Brown, DarkYellow 6 96
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
170 LightGray 7 112
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
171 DarkGray 8 128 *
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
172 Blue, LightBlue 9 144 *
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
173 Green, LightGreen 10 160 *
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
174 Cyan, LightCyan 11 176 *
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
175 Red, LightRed 12 192 *
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
176 Magenta, LightMagenta 13 208 *
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
177 Yellow, LightYellow 14 224 *
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
178 White 15 240 *
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
179
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
180 * Depending on the display mode, the color codes above 128 may not be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
181 available, and code 128 will make the text blink.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
182
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
183 When you use 0, the color is reset to the one used when you started Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
184 (usually 7, lightgray on black, but you can override this. If you have
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
185 overridden the default colors in a command prompt, you may need to adjust
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
186 some of the highlight colors in your vimrc---see below).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
187 This is the default for t_me.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
188
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
189 The defaults for the various highlight modes are:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
190 t_mr 112 reverse mode: Black text (0) on LightGray (112)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
191 t_md 15 bold mode: White text (15) on Black (0)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
192 t_me 0 normal mode (revert to default)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
193
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
194 t_so 31 standout mode: White (15) text on DarkBlue (16)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
195 t_se 0 standout mode end (revert to default)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
196
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
197 t_czh 225 italic mode: DarkBlue text (1) on Yellow (224)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
198 t_czr 0 italic mode end (revert to default)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
199
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
200 t_us 67 underline mode: DarkCyan text (3) on DarkRed (64)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
201 t_ue 0 underline mode end (revert to default)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
202
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
203 These colors were chosen because they also look good when using an inverted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
204 display, but you can change them to your liking.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
205
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
206 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
207 :set t_mr=^V^[\|97m " start of invert mode: DarkBlue (1) on Brown (96)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
208 :set t_md=^V^[\|67m " start of bold mode: DarkCyan (3) on DarkRed (64)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
209 :set t_me=^V^[\|112m " back to normal mode: Black (0) on LightGray (112)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
210
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
211 :set t_so=^V^[\|37m " start of standout mode: DarkMagenta (5) on DarkGreen
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
212 (32)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
213 :set t_se=^V^[\|112m " back to normal mode: Black (0) on LightGray (112)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
214
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
215 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
216 5. File formats *dos-file-formats*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
217
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
218 If the 'fileformat' option is set to "dos" (which is the default), Vim accepts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
219 a single <NL> or a <CR><NL> pair for end-of-line (<EOL>). When writing a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
220 file, Vim uses <CR><NL>. Thus, if you edit a file and write it, Vim replaces
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
221 <NL> with <CR><NL>.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
222
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
223 If the 'fileformat' option is set to "unix", Vim uses a single <NL> for <EOL>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
224 and shows <CR> as ^M.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
225
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
226 You can use Vim to replace <NL> with <CR><NL> by reading in any mode and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
227 writing in Dos mode (":se ff=dos").
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
228 You can use Vim to replace <CR><NL> with <NL> by reading in Dos mode and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
229 writing in Unix mode (":se ff=unix").
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
230
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
231 Vim sets 'fileformat' automatically when 'fileformats' is not empty (which is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
232 the default), so you don't really have to worry about what you are doing.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
233 |'fileformat'| |'fileformats'|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
234
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
235 If you want to edit a script file or a binary file, you should set the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
236 'binary' option before loading the file. Script files and binary files may
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
237 contain single <NL> characters which Vim would replace with <CR><NL>. You can
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
238 set 'binary' automatically by starting Vim with the "-b" (binary) option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
239
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
240 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
241 6. :cd command *dos-:cd*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
242
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
243 The ":cd" command recognizes the drive specifier and changes the current
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
244 drive. Use ":cd c:" to make drive C the active drive. Use ":cd d:\foo" to go
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
245 to the directory "foo" in the root of drive D. Vim also recognizes UNC names
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
246 if the system supports them; e.g., ":cd \\server\share\dir". |:cd|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
247
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
248 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
249 7. Interrupting *dos-CTRL-Break*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
250
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
251 Use CTRL-Break instead of CTRL-C to interrupt searches. Vim does not detect
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
252 the CTRL-C until it tries to read a key.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
253
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
254 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
255 8. Temp files *dos-temp-files*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
256
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
257 Only for the 16 bit and 32 bit DOS version:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
258 Vim puts temporary files (for filtering) in the first of these directories
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
259 that exists and in which Vim can create a file:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
260 $TMP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
261 $TEMP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
262 C:\TMP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
263 C:\TEMP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
264 current directory
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
265
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
266 For the Win32 version (both console and GUI):
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
267 Vim uses standard Windows functions to obtain a temporary file name (for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
268 filtering). The first of these directories that exists and in which Vim can
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
269 create a file is used:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
270 $TMP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
271 $TEMP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
272 current directory
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
273
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
274 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
275 9. Shell option default *dos-shell*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
276
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
277 The default for the 'sh' ('shell') option is "command.com" on Windows 95 and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
278 "cmd.exe" on Windows NT. If SHELL is defined, Vim uses SHELL instead, and if
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
279 SHELL is not defined but COMSPEC is, Vim uses COMSPEC. Vim starts external
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
280 commands with "<shell> /c <command_name>". Typing CTRL-Z starts a new command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
281 subshell. Return to Vim with "exit". |'shell'| |CTRL-Z|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
282
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
283 If you are running a third-party shell, you may need to set the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
284 |'shellcmdflag'| ('shcf') and |'shellquote'| ('shq') or |'shellxquote'|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
285 ('sxq') options. Unfortunately, this also depends on the version of Vim used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
286 For example, with the MKS Korn shell or with bash, the values of the options
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
287 should be:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
288
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
289 DOS 16 bit DOS 32 bit Win32 ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
290 'shellcmdflag' -c -c -c
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
291 'shellquote' "
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
292 'shellxquote' "
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
293
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
294 For Dos 16 bit this starts the shell as:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
295 <shell> -c "command name" >file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
296 For Win32 as:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
297 <shell> -c "command name >file"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
298 For DOS 32 bit, DJGPP does this internally somehow.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
299
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
300 When starting up, Vim checks for the presence of "sh" anywhere in the 'shell'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
301 option. If it is present, Vim sets the 'shellcmdflag' and 'shellquote' or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
302 'shellxquote' options will be set as described above.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
303
14421
2f7e67dd088c Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13963
diff changeset
304 vim:tw=78:ts=8:noet:ft=help:norl: