changeset 35359:082986a7377d

runtime(doc): Added definitions of Vim scripts and plugins Commit: https://github.com/vim/vim/commit/c593b9ead9b4346724187ab604fa593ead1fa4b2 Author: Ubaldo Tiberi <ubaldo.tiberi@gmail.com> Date: Sun Jun 9 18:47:53 2024 +0200 runtime(doc): Added definitions of Vim scripts and plugins closes: https://github.com/vim/vim/issues/14935 Signed-off-by: Ubaldo Tiberi <ubaldo.tiberi@gmail.com> Signed-off-by: Christian Brabandt <cb@256bit.org>
author Christian Brabandt <cb@256bit.org>
date Sun, 09 Jun 2024 19:00:03 +0200
parents ee61a5b3b761
children 7264594fc147
files runtime/doc/usr_41.txt
diffstat 1 files changed, 17 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- 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 Jun 03
+*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