home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / vim53os2.zip / vim-5.3 / doc / message.txt < prev    next >
Text File  |  1998-08-30  |  7KB  |  208 lines
  1. *message.txt*     For Vim version 5.3.  Last modification: 1998 Aug 27
  2.  
  3.  
  4.           VIM REFERENCE MANUAL    by Bram Moolenaar
  5.  
  6.  
  7. This file contains an alphabetical list of messages and error messages that
  8. Vim produces.  You can use this if you don't understand what the message
  9. means.  It is not complete though.
  10.  
  11. 1. Error messages    |error-messages|
  12. 2. Messages        |messages|
  13.  
  14. ==============================================================================
  15. 1. Error messages                    *error-messages*
  16.  
  17. When an error message is displayed, but it is removed before you could read
  18. it, you can see it again with:
  19. >  echo errmsg
  20.  
  21.  
  22. >  Ambiguous mapping
  23.  
  24. The first argument for a ":map" command starts with the same character(s) as
  25. an already existing mapping.  Note that keys like <F1> often start with "^[[".
  26. Check the output of ":set termcap" for that.  All variations of the ":map"
  27. command give the same message: ":cmap", ":imap", etc.
  28.  
  29.  
  30. >  Command not allowed from exrc/vimrc in current dir or tag search
  31.  
  32. Some commands are not allowed for security reasons.  These commands mostly
  33. come from a .exrc or .vimrc file in the current directory, or from a tags
  34. file.  Also see 'secure'.
  35.  
  36.  
  37. >  File exists (use ! to override)
  38.  
  39. You are protected from accidently overwriting a file.  When you want to write
  40. anyway, use the same command, but add a "!" just after the command.  Example:
  41. >    :w /tmp/test
  42. changes to:
  43. >    :w! /tmp/test
  44.  
  45.  
  46. >  GUI cannot be used: Not enabled at compile time
  47.  
  48. You are running a version of Vim that doesn't include the GUI code.  Therefore
  49. "gvim" and ":gui" don't work.
  50.  
  51.  
  52. >  Mark has invalid line number
  53.  
  54. You are using a mark that has a line number that doesn't exist.  This can
  55. happen when you have a mark in another file, and some other program has
  56. deleted lines from it.
  57.  
  58.  
  59. >  No alternate file
  60.  
  61. The alternate file is not defined yet.  See |alternate-file|.
  62.  
  63.  
  64. >  No file name
  65.  
  66. The current buffer has no name.  To write it, use ":w fname".  Or give the
  67. buffer a name with ":file fname".
  68.  
  69.  
  70. >  No previous substitute regular expression
  71.  
  72. When using the '~' character in a pattern, it is replaced with the previously
  73. used pattern in a ":substitute" command.  This fails when no such command has
  74. been used yet.  See |/~|.
  75.  
  76.  
  77. >  No previous regular expression
  78.  
  79. When using an empty search pattern, the previous search pattern is used.  But
  80. that is not possible if there was no previous search.
  81.  
  82.  
  83. >  No such mapping
  84.  
  85. You have used an ":unmap" or ":unabbreviate" command with an argument which is
  86. not an existing mapping.  All variations of these commands give the same
  87. message: ":cunmap", ":iunabbrev", etc.
  88.  
  89.  
  90. >  No write since last change (use ! to override)
  91.  
  92. You are trying to abandon a file that has changes.  Vim protects you from
  93. losing your work.  You can either write the changed file with ":w", or, if you
  94. are sure, abandon it anyway, and lose all the changes.  This can be done by
  95. adding a '!' character just after the command you used.  Example:
  96. >    :e other_file
  97. changes to:
  98. >    :e! other_file
  99.  
  100.  
  101. >  Only one file name allowed
  102.  
  103. The ":edit" command only accepts one file name.  When you want to specify
  104. several files for editing use ":next" |:next|.
  105.  
  106.  
  107. >  Out of memory!
  108.  
  109. Oh, oh.  You must have been doing something complicated, or some other program
  110. is consuming your memory.  Be careful!  Vim is not completely prepared for an
  111. out-of-memory situation.  First make sure that any changes are saved.  Then
  112. try to solve the memory shortage.  To stay on the safe side, exit Vim and
  113. start again.  Also see |msdos-limitations|.
  114.  
  115.  
  116. >  'readonly' option is set (use ! to override)
  117.  
  118. You are trying to write a file that was marked as read-only.  To write the
  119. file anyway, either reset the 'readonly' option, or add a '!' character just
  120. after the command you used.  Example
  121. >    :w
  122. changes to:
  123. >    :w!
  124.  
  125.  
  126. >  Recursive use of :normal too deep
  127.  
  128. You are using a ":normal" command, whose argument again uses a ":normal"
  129. command in a recursive way.  This is restricted to 'maxmapdepth' levels.  This
  130. example illustrates how to get this message:
  131. >    :map gq :normal gq<CR>
  132. If you type "gq", it will execute this mapping, which will call "gq" again.
  133.  
  134.  
  135. >  Scripts nested too deep
  136.  
  137. Scripts can be read with the "-s" command-line argument and with the ":source"
  138. command.  The script can then again read another script.  This can continue
  139. for about 14 levels.  When more nesting is done, Vim assumes that there is a
  140. recursive loop somewhere and stops with this error message.
  141.  
  142.  
  143. >  Tags file not sorted: <file name>
  144.  
  145. Vim (and Vi) expect tags files to be sorted in ASCII order.  Binary searching
  146. can then be used, which is a lot faster than a linear search.  If your tags
  147. files are not properly sorted, reset the |'tagbsearch'| option.
  148. This message is only given when Vim detects a problem when searching for a
  149. tag.  Sometimes this message is not given, even thought the tags file is not
  150. properly sorted.
  151.  
  152.  
  153. >  Too many file names
  154.  
  155. When expanding file names, more than one match was found.  Only one match is
  156. allowed.
  157.  
  158.  
  159. >  ml_get: invalid lnum:
  160.  
  161. This is an internal Vim error.  Please try to find out how it can be
  162. reproduced, and submit a bug report |bugreport.vim|.
  163.  
  164. ==============================================================================
  165. 2. Messages                        *messages*
  166.  
  167. This is an overview of various messages that Vim gives:
  168.  
  169.                             *hit-return*
  170. >  Press RETURN or enter command to continue
  171. This message is given when there is something on the screen for you to read,
  172. and the screen is about to be redrawn:
  173. - After executing an external command (e.g., ":!ls" and "=").
  174. - Something is displayed on the status line that is longer than the width of
  175.   the window, or runs into the 'showcmd' or 'ruler' output.
  176.  
  177. Hit <CR> or <Space> to redraw the screen and continue, without that key being
  178. used otherwise.  Or hit ":" or any other Normal mode command character to
  179. start that command.  {Vi: only ":" commands are interpreted}
  180.  
  181. To reduce the number of hit-return prompts:
  182. - Set 'cmdheight' to 2 or higher.
  183. - Add flags to 'shortmess'.
  184. - Reset 'showcmd' and/or 'ruler'.
  185.  
  186. Also see 'mouse'.  It is highlighted with the |hl-Question| group.
  187.  
  188.  
  189.                             *more-prompt*
  190. >  -- More --
  191. >  -- More -- (RET: line, SPACE: page, d: half page, q: quit)
  192. This message is given when the screen is filled with messages.  It is only
  193. give when the 'more' option is on.  It is highlighted with the |hl-MoreMsg|
  194. group.
  195.  
  196. Type:
  197.      <CR> or <NL>        for one more line
  198.      <Space>            for the next page
  199.      'd'            for down half a page
  200.      'q', <Esc> or CTRL-C    to stop the listing
  201.      ':'            to stop the listing and enter a command-line
  202. Any other key causes the meaning of the keys to be displayed.
  203.  
  204. Note: The typed key is directly obtained from the terminal, it is not mapped
  205. and typeahead is ignored.
  206.  
  207.  vim:ts=8:sw=8:tw=78:
  208.