summaryrefslogtreecommitdiffstats
path: root/runtime/doc/usr_41.txt
diff options
context:
space:
mode:
Diffstat (limited to 'runtime/doc/usr_41.txt')
-rw-r--r--runtime/doc/usr_41.txt20
1 files changed, 19 insertions, 1 deletions
diff --git a/runtime/doc/usr_41.txt b/runtime/doc/usr_41.txt
index 6137cfd..60d0d1e 100644
--- a/runtime/doc/usr_41.txt
+++ b/runtime/doc/usr_41.txt
@@ -1,4 +1,4 @@
-*usr_41.txt* For Vim version 9.1. Last change: 2024 Apr 26
+*usr_41.txt* For Vim version 9.1. Last change: 2024 Jun 09
VIM USER MANUAL - by Bram Moolenaar
@@ -29,6 +29,22 @@ Table of contents: |usr_toc.txt|
==============================================================================
*41.1* Introduction *vim-script-intro* *script*
+Let's start with some nomenclature. A Vim script is any file that Vim can
+interpret and execute. This includes files written in Vim's scripting language
+like for example .vim files or configuration files like .vimrc and .gvimrc.
+These scripts may define functions, commands and settings that Vim uses to
+customize and extend its behavior.
+
+With a slight abuse of nomenclature, we will use "Vim script" to refer to the
+Vim scripting language throughout this documentation. This shorthand helps to
+streamline explanations and discussions about scripting with Vim.
+
+A Vim plugin is a collection of one or more Vim scripts, along with additional
+files like help documentation, configuration files, and other resources,
+designed to add specific features or functionalities to Vim. A plugin can
+provide new commands, enhance existing capabilities, and integrate external
+tools or services into the Vim environment.
+
Your first experience with Vim scripts is the vimrc file. Vim reads it when
it starts up and executes the commands. You can set options to the values you
prefer, define mappings, select plugins and much more. You can use any colon
@@ -930,6 +946,7 @@ Cursor and mark position: *cursor-functions* *mark-functions*
Working with text in the current buffer: *text-functions*
getline() get a line or list of lines from the buffer
getregion() get a region of text from the buffer
+ getregionpos() get a list of positions for a region
setline() replace a line in the buffer
append() append line or list of lines in the buffer
indent() indent of a specific line
@@ -992,6 +1009,7 @@ System functions and manipulation of files:
readdir() get a List of file names in a directory
readdirex() get a List of file information in a directory
writefile() write a List of lines or Blob into a file
+ filecopy() copy a file {from} to {to}
Date and Time: *date-functions* *time-functions*
getftime() get last modification time of a file