[vim/vim] Improve Chapter 2 of the Tutor (PR #18105)
Christian Brabandt
Add a section on Text Objects and special registers like clipboard and blackhole.
fixes: #17808
You can view, comment on, or merge this pull request online at:
https://github.com/vim/vim/pull/18105
Commit Summary
- 8854463 runtime(tutor): Add a section on text objects
- b0809c9 runtime(tutor): add clipboard and blackhole register usage to tutorial 2
File Changes
(2 files)
- M runtime/tutor/tutor1 (2)
- M runtime/tutor/tutor2 (82)
Patch Links:
—
Reply to this email directly, view it on GitHub.
You are receiving this because you are subscribed to this thread.
Damien Lejay
@dlejay commented on this pull request.
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - Lesson 2.1.4: THE BEAUTY OF MARKS + Lesson 2.1.4: SPECIAL REGISTERS + + ** Use system clipboard and blackhole registers for advanced editing ** + + Note: The use of the clipboard depends on your exact Vim version and + system environment and may not be available (especially on Linux) + + 1. Clipboard registers + and * : + - "+y - Yank to system clipboard (e.g. "+yy for current line) + - "+p - Paste from system clipboard + - "* is primary clipboard on X11 (middle-click), "+ is clipboard (Ctrl-C/V) + +---> Try: "+yy then paste into another application with Ctrl-V
Better avoid talking about Ctrl-C/V since they will not work on macOS.
—
Reply to this email directly, view it on GitHub, or unsubscribe.
You are receiving this because you are subscribed to this thread.
Damien Lejay
> +---> Practice: "_diw on this word to delete it without affecting yank history
Which word is “this word” ?
Also, there needs to be more practice → the person following the tutorial needs to be give more instructions to see that indeed _diw did not affect the yank history.
—
Reply to this email directly, view it on GitHub, or unsubscribe.
You are receiving this because you are subscribed to this thread.
Damien Lejay
dlejay left a comment (vim/vim#18105)Thanks ! For the TextObject section, I’d suggest trying to invert the proportions of theory vs practice if possible ; the Vimtutor is practice first.
—
Reply to this email directly, view it on GitHub, or unsubscribe.
You are receiving this because you are subscribed to this thread.
Phạm Bình An
@brianhuster commented on this pull request.
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - Lesson 2.1.4: THE BEAUTY OF MARKS + Lesson 2.1.4: SPECIAL REGISTERS + + ** Use system clipboard and blackhole registers for advanced editing ** + + Note: The use of the clipboard depends on your exact Vim version and + system environment and may not be available (especially on Linux)
What about telling users a way to check this? E.g :echo has("clipboard")
—
Reply to this email directly, view it on GitHub, or unsubscribe.
You are receiving this because you are subscribed to this thread.
Gary Johnson
> @brianhuster commented on this pull request.
>
> In runtime/tutor/tutor2:
>
> > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> - Lesson 2.1.4: THE BEAUTY OF MARKS
> + Lesson 2.1.4: SPECIAL REGISTERS
> +
> + ** Use system clipboard and blackhole registers for advanced editing **
> +
> + Note: The use of the clipboard depends on your exact Vim version and
> + system environment and may not be available (especially on Linux)
clipboard implementation or with Linux. Also, "may not be
available" suggests that the problem is not fixable. I have been
using Vim in a terminal and gvim on Linux for many years and the
clipboard works quite well. The problems I have seen others have
with it have been due to their inexperience or due to various Linux
distributions' packaging of Vim without the clipboard or X enabled.
That's on the distributions, not Vim, and that statement should say
that.
Maybe something like this instead:
Be aware that some Linux distributions include the tiny version
of Vim as their default vim and gvim programs, which does not
have the clipboard enabled. Even the "full-featured" vim
package of some Linux distributions often does not have X or the
clipboard feature enabled. Those problems can be avoided by
installing the GUI Vim package, which usually has X and the
clipboard enabled for vim as well as gvim.
Regards,
Gary
vim-dev ML
vim-ml left a comment (vim/vim#18105)—
Reply to this email directly, view it on GitHub, or unsubscribe.
You are receiving this because you are subscribed to this thread.
Christian Brabandt
chrisbra left a comment (vim/vim#18105)I was trying to avoid a complex description, that may not even always be correct. E.g. it does not explain why the clipboard odes not work when using Vim on a non-X11/Wayland UI. Or when ssh into a server.
—
Reply to this email directly, view it on GitHub.
You are receiving this because you commented.
Christian Brabandt
@chrisbra commented on this pull request.
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - Lesson 2.1.4: THE BEAUTY OF MARKS + Lesson 2.1.4: SPECIAL REGISTERS + + ** Use system clipboard and blackhole registers for advanced editing ** + + Note: The use of the clipboard depends on your exact Vim version and + system environment and may not be available (especially on Linux) + + 1. Clipboard registers + and * : + - "+y - Yank to system clipboard (e.g. "+yy for current line) + - "+p - Paste from system clipboard + - "* is primary clipboard on X11 (middle-click), "+ is clipboard (Ctrl-C/V) + +---> Try: "+yy then paste into another application with Ctrl-V
they don't? And what do you use there, I suppose Cmd-C/V ?
—
Reply to this email directly, view it on GitHub.
You are receiving this because you commented.
Christian Brabandt
@chrisbra commented on this pull request.
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - Lesson 2.1.4: THE BEAUTY OF MARKS + Lesson 2.1.4: SPECIAL REGISTERS + + ** Use system clipboard and blackhole registers for advanced editing ** + + Note: The use of the clipboard depends on your exact Vim version and + system environment and may not be available (especially on Linux)
probably we should rather use echo has('clipboard_working') instead then?
—
Reply to this email directly, view it on GitHub.
You are receiving this because you commented.
Phạm Bình An
@brianhuster commented on this pull request.
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - Lesson 2.1.4: THE BEAUTY OF MARKS + Lesson 2.1.4: SPECIAL REGISTERS + + ** Use system clipboard and blackhole registers for advanced editing ** + + Note: The use of the clipboard depends on your exact Vim version and + system environment and may not be available (especially on Linux)
Yes
—
Reply to this email directly, view it on GitHub.
You are receiving this because you commented.
Phạm Bình An
brianhuster left a comment (vim/vim#18105)The problems I have seen others have
with it have been due to their inexperience or due to various Linux
distributions' packaging of Vim without the clipboard or X enabled.
That's on the distributions, not Vim, and that statement should say
that.
Note that not just Linux distributions, even the official Vim appimage release also has a version without X11 clipboard support. So saying "that's on the distributions" is not very true
—
Reply to this email directly, view it on GitHub.
You are receiving this because you commented.
zeertzjq
zeertzjq left a comment (vim/vim#18105)Simply enabling X11 or Wayland in Vim isn't enough either, as using clipboard also requires X11 or Wayland to be actually running. One may run Vim on a server (via SSH) with no X11 or Wayland available.
—
Reply to this email directly, view it on GitHub.
You are receiving this because you commented.
Gary Johnson
> ●chrisbra left a comment (vim/vim#18105)
> I was trying to avoid a complex description, that may not even always be
> correct. E.g. it does not explain why the clipboard odes not work when using
> Vim on a non-X11/Wayland UI. Or when ssh into a server.
telling the user that the clipboard availability depends on vague
terms such as "Vim version" and "system environment" and "may not be
available" without explaining exactly what those mean leaves the
user with little understanding of the problem and with no idea how
to determine which problem they have and how to fix it.
Experienced users can figure this out, but this is in the tutorial,
so the explanation should be aimed at users who are new to Vim and
probably new to Linux.
If this is the wrong place for a detailed explanation, perhaps one
could be elsewhere and referenced here.
Regards,
Gary
vim-dev ML
vim-ml left a comment (vim/vim#18105)—
Reply to this email directly, view it on GitHub, or unsubscribe.
You are receiving this because you are subscribed to this thread.
Damien Lejay
@dlejay commented on this pull request.
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - Lesson 2.1.4: THE BEAUTY OF MARKS + Lesson 2.1.4: SPECIAL REGISTERS + + ** Use system clipboard and blackhole registers for advanced editing ** + + Note: The use of the clipboard depends on your exact Vim version and + system environment and may not be available (especially on Linux) + + 1. Clipboard registers + and * : + - "+y - Yank to system clipboard (e.g. "+yy for current line) + - "+p - Paste from system clipboard + - "* is primary clipboard on X11 (middle-click), "+ is clipboard (Ctrl-C/V) + +---> Try: "+yy then paste into another application with Ctrl-V
macOS has a UX consistent with UNIX : Ctrl-c sends an interrupt, exactly like in Vim itself.
Copy is ⌘-c.
—
Reply to this email directly, view it on GitHub, or unsubscribe.
You are receiving this because you commented.
Christian Brabandt
@chrisbra commented on this pull request.
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - Lesson 2.1.4: THE BEAUTY OF MARKS + Lesson 2.1.4: SPECIAL REGISTERS + + ** Use system clipboard and blackhole registers for advanced editing ** + + Note: The use of the clipboard depends on your exact Vim version and + system environment and may not be available (especially on Linux)
that just doesn't work on tiny Vims :)
—
Reply to this email directly, view it on GitHub.
You are receiving this because you commented.
Christian Brabandt
chrisbra left a comment (vim/vim#18105)Note that not just Linux distributions, even the official Vim appimage release also has a version without X11 clipboard support.
That is not a very convincing argument, considering that I wrote it :)
So saying "that's on the distributions, not Vim" is not very true
It is, you just need to be able to always install Wayland/X11 libraries/dependencies, which of course nobody wants.
—
Reply to this email directly, view it on GitHub.
You are receiving this because you commented.
Christian Brabandt
@chrisbra pushed 1 commit.
- 7495e7f runtime(tutor): feedback, move textobjects to the top
—
View it on GitHub or unsubscribe.
You are receiving this because you are subscribed to this thread.
Christian Brabandt
chrisbra left a comment (vim/vim#18105)okay I reordered the content slightly (I noticed the clipboard register used text objects, so those need to be introduced earlier) and updated the docs on when clipboard feature is available.
—
Reply to this email directly, view it on GitHub.
You are receiving this because you commented.
Christian Brabandt
—
Reply to this email directly, view it on GitHub.
You are receiving this because you commented.