annotate runtime/doc/vimtutor.1 @ 34548:db67c09ccd53 v9.1.0175

patch 9.1.0175: wrong window positions with 'winfix{width,height}' Commit: https://github.com/vim/vim/commit/5866bc3a0f54115d5982fdc09bdbe4c45069265a Author: Sean Dewar <6256228+seandewar@users.noreply.github.com> Date: Wed Mar 13 20:17:24 2024 +0100 patch 9.1.0175: wrong window positions with 'winfix{width,height}' Problem: winframe functions incorrectly recompute window positions if the altframe wasn't adjacent to the closed frame, which is possible if adjacent windows had 'winfix{width,height}' set. Solution: recompute for windows within the parent of the altframe and closed frame. Skip this (as before) if the altframe was top/left, but only if adjacent to the closed frame, as positions won't change in that case. Also correct the return value documentation for win_screenpos. (Sean Dewar) The issue revealed itself after removing the win_comp_pos call below winframe_restore in win_splitmove. Similarly, wrong positions could result from windows closed in other tabpages, as win_free_mem uses winframe_remove (at least until it is entered later, where enter_tabpage calls win_comp_pos). NOTE: As win_comp_pos handles only curtab, it's possible via other means for positions in non-current tabpages to be wrong (e.g: after changing 'laststatus', 'showtabline', etc.). Given enter_tabpage recomputes it, maybe it's intentional as an optimization? Should probably be documented in win_screenpos then, but I won't address that here. closes: #14191 Signed-off-by: Sean Dewar <6256228+seandewar@users.noreply.github.com> Signed-off-by: Christian Brabandt <cb@256bit.org>
author Christian Brabandt <cb@256bit.org>
date Wed, 13 Mar 2024 20:30:03 +0100
parents b2e8663e6dcc
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1 .TH VIMTUTOR 1 "2001 April 2"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2 .SH NAME
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3 vimtutor \- the Vim tutor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 .SH SYNOPSIS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5 .br
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1582
diff changeset
6 .B vimtutor [\-g] [language]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 .SH DESCRIPTION
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8 .B Vimtutor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 starts the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 tutor.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 It copies the tutor file first, so that it can be modified without changing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 the original file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 .B Vimtutor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17 is useful for people that want to learn their first
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 commands.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20 .PP
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1582
diff changeset
21 The optional argument \-g starts vimtutor with gvim rather than vim, if the
1582
73c5752b957d updated for version 7.1-295
vimboss
parents: 7
diff changeset
22 GUI version of vim is available, or falls back to Vim if gvim is not found.
73c5752b957d updated for version 7.1-295
vimboss
parents: 7
diff changeset
23 .PP
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 The optional [language] argument is the two-letter name of a language, like
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 "it" or "es".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26 If the [language] argument is missing, the language of the current locale will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27 be used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 If a tutor in this language is available, it will be used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29 Otherwise the English version will be used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30 .PP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32 is always started in Vi compatible mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 .SH FILES
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 .TP 15
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 /usr/local/lib/vim/tutor/tutor[.language]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37 .B Vimtutor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38 text file(s).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39 .TP 15
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40 /usr/local/lib/vim/tutor/tutor.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 The Vim script used to copy the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 .B Vimtutor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 text file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 .SH AUTHOR
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45 The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 .B Vimtutor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 was originally written for Vi by Michael C. Pierce and Robert K. Ware,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 Colorado School of Mines using ideas supplied by Charles Smith,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49 Colorado State University.
32294
b2e8663e6dcc Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 2033
diff changeset
50 E-mail: bware@mines.colorado.edu (now invalid).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 .br
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 It was modified for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 .B Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54 by Bram Moolenaar.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 For the names of the translators see the tutor files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56 .SH SEE ALSO
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
57 vim(1)