Mercurial > vim

comparison runtime/doc/quickfix.txt @ 28010:c968191a8557

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update runtime files Commit: https://github.com/vim/vim/commit/1588bc8ebee22f2855f27273fc2234fff370f86c Author: Bram Moolenaar <Bram@vim.org> Date: Tue Mar 8 21:35:07 2022 +0000 Update runtime files
author Bram Moolenaar <Bram@vim.org>
date Tue, 08 Mar 2022 22:45:09 +0100
parents d19b7aee1925
children f8116058ca76
comparison
equal deleted inserted replaced
28009:3bffa026c6d9 28010:c968191a8557
653 quickfix window. If there already is a window for that file, it is used 653 quickfix window. If there already is a window for that file, it is used
654 instead. If the buffer in the used window has changed, and the error is in 654 instead. If the buffer in the used window has changed, and the error is in
655 another file, jumping to the error will fail. You will first have to make 655 another file, jumping to the error will fail. You will first have to make
656 sure the window contains a buffer which can be abandoned. 656 sure the window contains a buffer which can be abandoned.
657 657
658 The following steps are used to find a window to open the file selected from 658 When you select a file from the quickfix window, the following steps are used
659 the quickfix window: 659 to find a window to edit the file:
660 1. If 'switchbuf' contains "usetab", then find a window in any tabpage 660
661 (starting with the first tabpage) that has the selected file and jump to 661 1. If a window displaying the selected file is present in the current tabpage
662 it. 662 (starting with the window before the quickfix window), then that window is
663 2. Otherwise find a window displaying the selected file in the current tab 663 used.
664 page (starting with the window before the quickfix window) and use it. 664 2. If the above step fails and if 'switchbuf' contains "usetab" and a window
665 3. Otherwise find a window displaying a normal buffer ('buftype' is empty) 665 displaying the selected file is present in any one of the tabpages
666 starting with the window before the quickfix window. If a window is found, 666 (starting with the first tabpage) then that window is used.
667 open the file in that window. 667 3. If the above step fails then a window in the current tabpage displaying a
668 4. If a usable window is not found and 'switchbuf' contains "uselast", then 668 buffer with 'buftype' not set (starting with the window before the quickfix
669 open the file in the last used window. 669 window) is used.
670 5. Otherwise open the file in the window before the quickfix window. If there 670 4. If the above step fails and if 'switchbuf' contains "uselast", then the
671 is no previous window, then open the file in the next window. 671 previously accessed window is used.
672 6. If a usable window is not found in the above steps, then create a new 672 5. If the above step fails then the window before the quickfix window is used.
673 horizontally split window above the quickfix window and open the file. 673 If there is no previous window, then the window after the quickfix window
674 is used.
675 6. If the above step fails, then a new horizontally split window above the
676 quickfix window is used.
674 677
675 *CTRL-W_<Enter>* *CTRL-W_<CR>* 678 *CTRL-W_<Enter>* *CTRL-W_<CR>*
676 You can use CTRL-W <Enter> to open a new window and jump to the error there. 679 You can use CTRL-W <Enter> to open a new window and jump to the error there.
677 680
678 When the quickfix window has been filled, two autocommand events are 681 When the quickfix window has been filled, two autocommand events are
708 this window, the displayed location list is used. 711 this window, the displayed location list is used.
709 712
710 When you select a file from the location list window, the following steps are 713 When you select a file from the location list window, the following steps are
711 used to find a window to edit the file: 714 used to find a window to edit the file:
712 715
713 1. If a window with the location list displayed in the location list window is 716 1. If a non-quickfix window associated with the location list is present in
714 present, then the file is opened in that window. 717 the current tabpage, then that window is used.
715 2. If the above step fails and if the file is already opened in another 718 2. If the above step fails and if the file is already opened in another window
716 window, then that window is used. 719 in the current tabpage, then that window is used.
717 3. If the above step fails then an existing window showing a buffer with 720 3. If the above step fails and 'switchbuf' contains "usetab" and if the file
718 'buftype' not set is used. 721 is opened in a window in any one of the tabpages, then that window is used.
719 4. If the above step fails, then the file is edited in a new window. 722 4. If the above step fails then a window in the current tabpage showing a
723 buffer with 'buftype' not set is used.
724 5. If the above step fails, then the file is edited in a new window.
720 725
721 In all of the above cases, if the location list for the selected window is not 726 In all of the above cases, if the location list for the selected window is not
722 yet set, then it is set to the location list displayed in the location list 727 yet set, then it is set to the location list displayed in the location list
723 window. 728 window.
724 729
1053 1058
1054 'f' When the 'f' flag is specified, fuzzy string 1059 'f' When the 'f' flag is specified, fuzzy string
1055 matching is used to find matching lines. In this 1060 matching is used to find matching lines. In this
1056 case, {pattern} is treated as a literal string 1061 case, {pattern} is treated as a literal string
1057 instead of a regular expression. See 1062 instead of a regular expression. See
1058 |fuzzy-match| for more information about fuzzy 1063 |fuzzy-matching| for more information about fuzzy
1059 matching strings. 1064 matching strings.
1060 1065
1061 |QuickFixCmdPre| and |QuickFixCmdPost| are triggered. 1066 |QuickFixCmdPre| and |QuickFixCmdPost| are triggered.
1062 A file that is opened for matching may use a buffer 1067 A file that is opened for matching may use a buffer
1063 number, but it is reused if possible to avoid 1068 number, but it is reused if possible to avoid