diff options
Diffstat (limited to 'runtime/doc')
74 files changed, 3618 insertions, 2090 deletions
diff --git a/runtime/doc/Make_mvc.mak b/runtime/doc/Make_mvc.mak index f2fbc52..c387ef8 100644 --- a/runtime/doc/Make_mvc.mak +++ b/runtime/doc/Make_mvc.mak @@ -12,7 +12,7 @@ # Correct the following line for the where executeable file vim is installed. # Please do not put the path in quotes. -VIMEXE = D:\Programs\Vim\vim90\vim.exe +VIMPROG = D:\Programs\Vim\vim90\vim.exe # Correct the following line for the directory where iconv installed. # Please do not put the path in quotes. @@ -63,7 +63,7 @@ doctags : doctags.c # Use Vim to generate the tags file. Can only be used when Vim has been # compiled and installed. Supports multiple languages. vimtags : $(DOCS) - @"$(VIMEXE)" --clean -esX -V1 -u doctags.vim + @"$(VIMPROG)" --clean -esX -V1 -u doctags.vim uganda.nsis.txt : uganda.??? @@ -105,7 +105,7 @@ perlhtml : tags $(DOCS) # Check URLs in the help with "curl" or "powershell". test_urls : - "$(VIMEXE)" --clean -S test_urls.vim + "$(VIMPROG)" --clean -S test_urls.vim clean : $(RM) doctags.exe doctags.obj diff --git a/runtime/doc/Makefile b/runtime/doc/Makefile index 30a4f08..785128e 100644 --- a/runtime/doc/Makefile +++ b/runtime/doc/Makefile @@ -6,8 +6,7 @@ AWK = awk -# Set to $(VIMTARGET) when executed from src/Makefile. -VIMEXE = vim +VIMPROG = ../../src/vim # include the config.mk from the source directory. It's only needed to set # AWK, used for "make html". Comment this out if the include gives problems. @@ -23,9 +22,9 @@ include Make_all.mak all: tags vim.man evim.man vimdiff.man vimtutor.man xxd.man $(CONVERTED) # Use Vim to generate the tags file. Can only be used when Vim has been -# compiled and installed. Supports multiple languages. +# compiled. Supports multiple languages. vimtags: $(DOCS) - @$(VIMEXE) --clean -esX -V1 -u doctags.vim + @$(VIMPROG) --clean -esX -V1 -u doctags.vim # Use "doctags" to generate the tags file. Only works for English! tags: doctags $(DOCS) @@ -36,19 +35,19 @@ doctags: doctags.c $(CC) doctags.c -o doctags vim.man: vim.1 - nroff -man $< | sed -e s/.//g > $@ + nroff -man $? | sed -e s/.//g > $@ evim.man: evim.1 - nroff -man $< | sed -e s/.//g > $@ + nroff -man $? | sed -e s/.//g > $@ vimdiff.man: vimdiff.1 - nroff -man $< | sed -e s/.//g > $@ + nroff -man $? | sed -e s/.//g > $@ vimtutor.man: vimtutor.1 - nroff -man $< | sed -e s/.//g > $@ + nroff -man $? | sed -e s/.//g > $@ xxd.man: xxd.1 - nroff -man $< | sed -e s/.//g > $@ + nroff -man $? | sed -e s/.//g > $@ uganda.nsis.txt : uganda.??? for dpn in $?; do \ @@ -57,7 +56,7 @@ uganda.nsis.txt : uganda.??? $${dpn} | uniq > $${trg%txt}$${dpn##*.}; \ done # This files needs to be in dos fileformat for NSIS. - $(VIMEXE) -e -X -u NONE --cmd "set notitle noicon nocp noml viminfo=" \ + $(VIMPROG) -e -X -u NONE --cmd "set notitle noicon nocp noml viminfo=" \ -c "argdo write ++ff=dos" -c "qa" uganda.nsis.??? # Awk version of .txt to .html conversion. @@ -75,10 +74,10 @@ $(HTMLS): tags.ref # index.html is the starting point for HTML, but for the help files it is # help.txt. Therefore use vimindex.html for index.txt. index.html: help.txt - $(AWK) -f makehtml.awk $< >$@ + $(AWK) -f makehtml.awk $? >$@ vimindex.html: index.txt - $(AWK) -f makehtml.awk $< >$@ + $(AWK) -f makehtml.awk $? >$@ tags.ref tags.html: tags $(AWK) -f maketags.awk tags >tags.html @@ -91,7 +90,7 @@ perlhtml: tags $(DOCS) # Check URLs in the help with "curl". test_urls: - $(VIMEXE) --clean -S test_urls.vim + $(VIMPROG) --clean -S test_urls.vim clean: -rm -f doctags *.html tags.ref @@ -152,88 +151,91 @@ os_risc.txt: os_win32.txt: touch $@ -# Note that $< works with GNU make while $> works for BSD make. -# Is there a solution that works for both?? +# In *BSD, the variable '$<' is used in suffix-transformation rules (in GNU this +# is called "implicit rules", and in MS Windows it is called "inference rules"). +# For code portability, it is better to use the '$?' variable for explicit rules. +# Especially since there is only one dependency and it should presumably always +# be newer than the target file. vim-da.UTF-8.1: vim-da.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ vimdiff-da.UTF-8.1: vimdiff-da.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ vimtutor-da.UTF-8.1: vimtutor-da.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ vim-de.UTF-8.1: vim-de.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ vim-fr.UTF-8.1: vim-fr.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ evim-fr.UTF-8.1: evim-fr.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ vimdiff-fr.UTF-8.1: vimdiff-fr.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ vimtutor-fr.UTF-8.1: vimtutor-fr.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ xxd-fr.UTF-8.1: xxd-fr.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ vim-it.UTF-8.1: vim-it.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ evim-it.UTF-8.1: evim-it.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ vimdiff-it.UTF-8.1: vimdiff-it.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ vimtutor-it.UTF-8.1: vimtutor-it.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ xxd-it.UTF-8.1: xxd-it.1 - iconv -f latin1 -t utf-8 $< >$@ + iconv -f latin1 -t UTF-8 $? >$@ vim-pl.UTF-8.1: vim-pl.1 - iconv -f latin2 -t utf-8 $< >$@ + iconv -f latin2 -t UTF-8 $? >$@ evim-pl.UTF-8.1: evim-pl.1 - iconv -f latin2 -t utf-8 $< >$@ + iconv -f latin2 -t UTF-8 $? >$@ vimdiff-pl.UTF-8.1: vimdiff-pl.1 - iconv -f latin2 -t utf-8 $< >$@ + iconv -f latin2 -t UTF-8 $? >$@ vimtutor-pl.UTF-8.1: vimtutor-pl.1 - iconv -f latin2 -t utf-8 $< >$@ + iconv -f latin2 -t UTF-8 $? >$@ xxd-pl.UTF-8.1: xxd-pl.1 - iconv -f latin2 -t utf-8 $< >$@ + iconv -f latin2 -t UTF-8 $? >$@ vim-ru.UTF-8.1: vim-ru.1 - iconv -f KOI8-R -t utf-8 $< >$@ + iconv -f KOI8-R -t UTF-8 $? >$@ evim-ru.UTF-8.1: evim-ru.1 - iconv -f KOI8-R -t utf-8 $< >$@ + iconv -f KOI8-R -t UTF-8 $? >$@ vimdiff-ru.UTF-8.1: vimdiff-ru.1 - iconv -f KOI8-R -t utf-8 $< >$@ + iconv -f KOI8-R -t UTF-8 $? >$@ vimtutor-ru.UTF-8.1: vimtutor-ru.1 - iconv -f KOI8-R -t utf-8 $< >$@ + iconv -f KOI8-R -t UTF-8 $? >$@ xxd-ru.UTF-8.1: xxd-ru.1 - iconv -f KOI8-R -t utf-8 $< >$@ + iconv -f KOI8-R -t UTF-8 $? >$@ vim-tr.UTF-8.1: vim-tr.1 - iconv -f latin5 -t utf-8 $< >$@ + iconv -f latin5 -t UTF-8 $? >$@ evim-tr.UTF-8.1: evim-tr.1 - iconv -f latin5 -t utf-8 $< >$@ + iconv -f latin5 -t UTF-8 $? >$@ vimdiff-tr.UTF-8.1: vimdiff-tr.1 - iconv -f latin5 -t utf-8 $< >$@ + iconv -f latin5 -t UTF-8 $? >$@ vimtutor-tr.UTF-8.1: vimtutor-tr.1 - iconv -f latin5 -t utf-8 $< >$@ + iconv -f latin5 -t UTF-8 $? >$@ diff --git a/runtime/doc/autocmd.txt b/runtime/doc/autocmd.txt index 037f89c..f200a30 100644 --- a/runtime/doc/autocmd.txt +++ b/runtime/doc/autocmd.txt @@ -1,4 +1,4 @@ -*autocmd.txt* For Vim version 9.1. Last change: 2024 May 05 +*autocmd.txt* For Vim version 9.1. Last change: 2024 Aug 18 VIM REFERENCE MANUAL by Bram Moolenaar @@ -54,20 +54,20 @@ Recommended use: without the autocommand being repeated. Example in Vim9 script: > - autocmd_add({replace: true, + autocmd_add([{replace: true, group: 'DemoGroup', event: 'BufEnter', pattern: '*.txt', cmd: 'call DemoBufEnter()' - }) + }]) In legacy script: > - call autocmd_add(#{replace: v:true, + call autocmd_add([#{replace: v:true, \ group: 'DemoGroup', \ event: 'BufEnter', \ pattern: '*.txt', \ cmd: 'call DemoBufEnter()' - \ }) + \ }]) ============================================================================== 2. Defining autocommands *autocmd-define* @@ -379,6 +379,7 @@ Name triggered by ~ |CursorHold| the user doesn't press a key for a while |CursorHoldI| the user doesn't press a key for a while in Insert mode |CursorMoved| the cursor was moved in Normal mode +|CursorMovedC| the cursor was moved in the |Command-line| |CursorMovedI| the cursor was moved in Insert mode |WinNewPre| before creating a new window @@ -438,6 +439,8 @@ Name triggered by ~ |CompleteDone| after Insert mode completion is done, after clearing info +|KeyInputPre| just before a key is processed + |User| to be used in combination with ":doautocmd" |SigUSR1| after the SIGUSR1 signal has been detected @@ -748,6 +751,13 @@ CursorMoved After the cursor was moved in Normal or Visual Careful: This is triggered very often, don't do anything that the user does not expect or that is slow. + *CursorMovedC* +CursorMovedC After the cursor was moved in the command + line. Be careful not to mess up the command + line, it may cause Vim to lock up. + <afile> is set to a single character, + indicating the type of command-line. + |cmdwin-char| *CursorMovedI* CursorMovedI After the cursor was moved in Insert mode. Not triggered when the popup menu is visible. @@ -906,12 +916,12 @@ FilterWritePre Before writing a file for a filter command or *FocusGained* FocusGained When Vim got input focus. Only for the GUI version and a few console versions where this - can be detected. + can be detected. |xterm-focus-event| *FocusLost* FocusLost When Vim lost input focus. Only for the GUI version and a few console versions where this - can be detected. May also happen when a - dialog pops up. + can be detected. |xterm-focus-event| + May also happen when a dialog pops up. *FuncUndefined* FuncUndefined When a user function is used but it isn't defined. Useful for defining a function only @@ -969,6 +979,26 @@ InsertLeavePre Just before leaving Insert mode. Also when *InsertLeave* InsertLeave Just after leaving Insert mode. Also when using CTRL-O |i_CTRL-O|. But not for |i_CTRL-C|. + *KeyInputPre* +KeyInputPre Just before a key is processed after mappings + have been applied. The pattern is matched + against a string that indicates the current + mode, which is the same as what is returned by + `mode(1)`. + The |v:char| variable indicates the key typed + and can be changed during the event to process + a different key. When |v:char| is not a + single character or a special key, the first + character is used. + The following values of |v:event| are set: + typed The key is typed or not. + typedchar The (actual) typed key since + the last |KeyInputPre| call. + Note: "typedchar" may be empty if successive + |KeyInputPre| autocmds are processed. + It is not allowed to change the text + |textlock| or the current mode. + {only with the +eval feature} *MenuPopup* MenuPopup Just before showing the popup menu (under the right mouse button). Useful for adjusting the @@ -1400,8 +1430,10 @@ WinLeave Before leaving a window. If the window to be *WinNewPre* WinNewPre Before creating a new window. Triggered before commands that modify window layout by - creating a split or new tab page. Not done for - the first window, when Vim has just started. + creating a split. + Not done when creating tab pages and for the + first window, as the window structure is not + initialized yet and so is generally not safe. It is not allowed to modify window layout while executing commands for the WinNewPre event. diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt index a824531..4192b81 100644 --- a/runtime/doc/builtin.txt +++ b/runtime/doc/builtin.txt @@ -1,4 +1,4 @@ -*builtin.txt* For Vim version 9.1. Last change: 2024 Jun 17 +*builtin.txt* For Vim version 9.1. Last change: 2024 Aug 08 VIM REFERENCE MANUAL by Bram Moolenaar @@ -28,9 +28,9 @@ acos({expr}) Float arc cosine of {expr} add({object}, {item}) List/Blob append {item} to {object} and({expr}, {expr}) Number bitwise AND append({lnum}, {text}) Number append {text} below line {lnum} -appendbufline({expr}, {lnum}, {text}) +appendbufline({buf}, {lnum}, {text}) Number append {text} below line {lnum} - in buffer {expr} + in buffer {buf} argc([{winid}]) Number number of files in the argument list argidx() Number current index in the argument list arglistid([{winnr} [, {tabnr}]]) Number argument list id @@ -67,6 +67,8 @@ autocmd_get([{opts}]) List return a list of autocmds balloon_gettext() String current text in the balloon balloon_show({expr}) none show {expr} inside the balloon balloon_split({msg}) List split {msg} as used for a balloon +bindtextdomain({package}, {path}) + Bool bind text domain to specified path blob2list({blob}) List convert {blob} into a list of numbers browse({save}, {title}, {initdir}, {default}) String put up a file requester @@ -153,8 +155,8 @@ diff_filler({lnum}) Number diff filler lines about {lnum} diff_hlID({lnum}, {col}) Number diff highlighting at {lnum}/{col} digraph_get({chars}) String get the |digraph| of {chars} digraph_getlist([{listall}]) List get all |digraph|s -digraph_set({chars}, {digraph}) Boolean register |digraph| -digraph_setlist({digraphlist}) Boolean register multiple |digraph|s +digraph_set({chars}, {digraph}) Bool register |digraph| +digraph_setlist({digraphlist}) Bool register multiple |digraph|s echoraw({expr}) none output {expr} as-is empty({expr}) Number |TRUE| if {expr} is empty environ() Dict return environment variables @@ -277,7 +279,7 @@ gettabvar({nr}, {varname} [, {def}]) gettabwinvar({tabnr}, {winnr}, {name} [, {def}]) any {name} in {winnr} in tab page {tabnr} gettagstack([{nr}]) Dict get the tag stack of window {nr} -gettext({text}) String lookup translation of {text} +gettext({text} [, {package}]) String lookup translation of {text} getwininfo([{winid}]) List list of info about each window getwinpos([{timeout}]) List X and Y coord in pixels of Vim window getwinposx() Number X coord in pixels of the Vim window @@ -306,6 +308,7 @@ hlget([{name} [, {resolve}]]) List get highlight group attributes hlset({list}) Number set highlight group attributes hostname() String name of the machine Vim is running on iconv({expr}, {from}, {to}) String convert encoding of {expr} +id({item}) String get unique identity string of item indent({lnum}) Number indent of line {lnum} index({object}, {expr} [, {start} [, {ic}]]) Number index in {object} where {expr} appears @@ -429,6 +432,7 @@ popup_menu({what}, {options}) Number create a popup window used as a menu popup_move({id}, {options}) none set position of popup window {id} popup_notification({what}, {options}) Number create a notification popup window +popup_setbuf({id}, {buf}) Bool set the buffer for the popup window {id} popup_setoptions({id}, {options}) none set options for popup window {id} popup_settext({id}, {text}) none set the text of popup window {id} @@ -525,9 +529,9 @@ searchpos({pattern} [, {flags} [, {stopline} [, {timeout} [, {skip}]]]]) server2client({clientid}, {string}) Number send reply string serverlist() String get a list of available servers -setbufline({expr}, {lnum}, {text}) +setbufline({buf}, {lnum}, {text}) Number set line {lnum} to {text} in buffer - {expr} + {buf} setbufvar({buf}, {varname}, {val}) none set {varname} in buffer {buf} to {val} setcellwidths({list}) none set character cell width overrides @@ -1217,6 +1221,16 @@ balloon_split({msg}) *balloon_split()* Return type: list<any> or list<string> +bindtextdomain({package}, {path}) *bindtextdomain()* + Bind a specific {package} to a {path} so that the + |gettext()| function can be used to get language-specific + translations for a package. {path} is the directory name + for the translations. See |package-translation|. + + Returns v:true on success and v:false on failure (out of + memory). + + Return type: |vim9-boolean| blob2list({blob}) *blob2list()* Return a List containing the number value of each byte in Blob @@ -2518,8 +2532,10 @@ executable({expr}) *executable()* This function checks if an executable with the name {expr} exists. {expr} must be the name of the program without any arguments. + executable() uses the value of $PATH and/or the normal - searchpath for programs. *PATHEXT* + searchpath for programs. + *PATHEXT* On MS-Windows the ".exe", ".bat", etc. can optionally be included. Then the extensions in $PATHEXT are tried. Thus if "foo.exe" does not exist, "foo.exe.bat" can be found. If @@ -2529,11 +2545,14 @@ executable({expr}) *executable()* then the name is also tried without adding an extension. On MS-Windows it only checks if the file exists and is not a directory, not if it's really executable. - On MS-Windows an executable in the same directory as Vim is - normally found. Since this directory is added to $PATH it - should also work to execute it |win32-PATH|. This can be - disabled by setting the $NoDefaultCurrentDirectoryInExePath - environment variable. *NoDefaultCurrentDirectoryInExePath* + On MS-Windows an executable in the same directory as the Vim + executable is always found. Since this directory is added to + $PATH it should also work to execute it |win32-PATH|. + *NoDefaultCurrentDirectoryInExePath* + On MS-Windows an executable in Vim's current working directory + is also normally found, but this can be disabled by setting + the $NoDefaultCurrentDirectoryInExePath environment variable. + The result is a Number: 1 exists 0 does not exist @@ -2579,7 +2598,7 @@ execute({command} [, {silent}]) *execute()* Can also be used as a |method|: > GetCommand()->execute() < - Return type: |Number| + Return type: |String| exepath({expr}) *exepath()* @@ -3563,7 +3582,7 @@ garbagecollect([{atexit}]) *garbagecollect()* Return type: |String| -get({list}, {idx} [, {default}]) *get()* +get({list}, {idx} [, {default}]) *get()* *get()-list* Get item {idx} from |List| {list}. When this item is not available return {default}. Return zero when {default} is omitted. @@ -3572,7 +3591,7 @@ get({list}, {idx} [, {default}]) *get()* < Return type: any, depending on {list} -get({blob}, {idx} [, {default}]) +get({blob}, {idx} [, {default}]) *get()-blob* Get byte {idx} from |Blob| {blob}. When this byte is not available return {default}. Return -1 when {default} is omitted. @@ -3581,7 +3600,7 @@ get({blob}, {idx} [, {default}]) < Return type: |Number| -get({dict}, {key} [, {default}]) +get({dict}, {key} [, {default}]) *get()-dict* Get item with key {key} from |Dictionary| {dict}. When this item is not available return {default}. Return zero when {default} is omitted. Useful example: > @@ -3593,18 +3612,32 @@ get({dict}, {key} [, {default}]) < Return type: any, depending on {dict} -get({func}, {what}) - Get item {what} from Funcref {func}. Possible values for +get({func}, {what}) *get()-func* + Get item {what} from |Funcref| {func}. Possible values for {what} are: - "name" The function name - "func" The function - "dict" The dictionary - "args" The list with arguments + "name" The function name + "func" The function + "dict" The dictionary + "args" The list with arguments + "arity" A dictionary with information about the number of + arguments accepted by the function (minus the + {arglist}) with the following fields: + required the number of positional arguments + optional the number of optional arguments, + in addition to the required ones + varargs |TRUE| if the function accepts a + variable number of arguments |...| + + Note: There is no error, if the {arglist} of + the Funcref contains more arguments than the + Funcref expects, it's not validated. + Returns zero on error. + Preferably used as a |method|: > myfunc->get(what) < - Return type: any, depending on {func} + Return type: any, depending on {func} and {what} *getbufinfo()* getbufinfo([{buf}]) @@ -4036,6 +4069,7 @@ getcompletion({pat}, {type} [, {filtered}]) *getcompletion()* customlist,{func} custom completion, defined via {func} diff_buffer |:diffget| and |:diffput| completion dir directory names + dir_in_path directory names in |'cdpath'| environment environment variable names event autocommand events expression Vim expression @@ -4774,6 +4808,8 @@ getregion({pos1}, {pos2} [, {opts}]) *getregion()* < Can also be used as a |method|: > getpos('.')->getregion(getpos("'a")) +< + Return type: list<string> < getregionpos({pos1}, {pos2} [, {opts}]) *getregionpos()* @@ -4811,7 +4847,7 @@ getregionpos({pos1}, {pos2} [, {opts}]) *getregionpos()* Can also be used as a |method|: > getpos('.')->getregionpos(getpos("'a")) < - Return type: list<string> + Return type: list<list<list<number>>> getregtype([{regname}]) *getregtype()* @@ -4977,16 +5013,20 @@ gettagstack([{winnr}]) *gettagstack()* Return type: dict<any> -gettext({text}) *gettext()* +gettext({text} [, {package}]) *gettext()* Translate String {text} if possible. - This is mainly for use in the distributed Vim scripts. When - generating message translations the {text} is extracted by - xgettext, the translator can add the translated message in the - .po file and Vim will lookup the translation when gettext() is - called. + This is intended for use in Vim scripts. When generating + message translations the {text} is extracted by `xgettext`, + the translator can add translated messages into the .po file + and Vim will lookup the translation when gettext() is called. For {text} double quoted strings are preferred, because - xgettext does not understand escaping in single quoted - strings. + `xgettext` does not support single quoted escaped text. + + When the {package} is specified, the translation is looked up + for that specific package. This is mainly required for + third-party Vim scripts. You need to specify a path to the + translations with the |bindtextdomain()| function before + using the gettext() function. Return type: |String| @@ -5590,6 +5630,34 @@ iconv({string}, {from}, {to}) *iconv()* Return type: |String| +id({item}) *id()* + The result is a unique String associated with the {item} and + not with the {item}'s contents. It is only valid while the + {item} exists and is referenced. It is valid only in the + instance of vim that produces the result. The whole idea is + that `id({item})` does not change if the contents of {item} + changes. This is useful as a `key` for creating an identity + dictionary, rather than one based on equals. + + This operation does not reference {item} and there is no + function to convert the `id` to the {item}. It may be useful to + have a map of `id` to {item}. The following > + var referenceMap: dict<any> + var id = item->id() + referenceMap[id] = item +< prevents {item} from being garbage collected and provides a + way to get the {item} from the `id`. + + {item} may be a List, Dictionary, Object, Job, Channel or + Blob. If the item is not a permitted type, or it is a null + value, then an empty String is returned. + + Can also be used as a |method|: > + GetItem()->id() +< + Return type: |String| + + indent({lnum}) *indent()* The result is a Number, which is indent of line {lnum} in the current buffer. The indent is counted in spaces, the value @@ -6883,10 +6951,10 @@ matchadd({group}, {pattern} [, {priority} [, {id} [, {dict}]]]) matchaddpos({group}, {pos} [, {priority} [, {id} [, {dict}]]]) Same as |matchadd()|, but requires a list of positions {pos} instead of a pattern. This command is faster than |matchadd()| - because it does not require to handle regular expressions and - sets buffer line boundaries to redraw screen. It is supposed - to be used when fast match additions and deletions are - required, for example to highlight matching parentheses. + because it does not handle regular expressions and it sets + buffer line boundaries to redraw screen. It is supposed to be + used when fast match additions and deletions are required, for + example to highlight matching parentheses. {pos} is a list of positions. Each position can be one of these: @@ -8078,7 +8146,7 @@ pyxeval({expr}) *pyxeval()* See also: |pyeval()|, |py3eval()| Can also be used as a |method|: > - < GetExpr()->pyxeval() + GetExpr()->pyxeval() < Return type: any, depending on {expr} @@ -9486,7 +9554,8 @@ setline({lnum}, {text}) *setline()* Set line {lnum} of the current buffer to {text}. To insert lines use |append()|. To set lines in another buffer use |setbufline()|. - Any text properties in {lnum} are cleared |text-prop-cleared|. + Any text properties in {lnum} are cleared. See + |text-prop-cleared| {lnum} is used like with |getline()|. When {lnum} is just below the last line the {text} will be @@ -10270,8 +10339,8 @@ spellsuggest({word} [, {max} [, {capital}]]) *spellsuggest()* split({string} [, {pattern} [, {keepempty}]]) *split()* Make a |List| out of {string}. When {pattern} is omitted or - empty each white-separated sequence of characters becomes an - item. + empty each white space separated sequence of characters + becomes an item. Otherwise the string is split where {pattern} matches, removing the matched characters. 'ignorecase' is not used here, add \c to ignore case. |/\c| @@ -11039,7 +11108,7 @@ synconcealed({lnum}, {col}) *synconcealed()* Note: Doesn't consider |matchadd()| highlighting items, since syntax and matching highlighting are two different mechanisms |syntax-vs-match|. -< + Return type: list<any> diff --git a/runtime/doc/change.txt b/runtime/doc/change.txt index 50ff4ec..2304712 100644 --- a/runtime/doc/change.txt +++ b/runtime/doc/change.txt @@ -1,4 +1,4 @@ -*change.txt* For Vim version 9.1. Last change: 2024 May 18 +*change.txt* For Vim version 9.1. Last change: 2024 Jul 28 VIM REFERENCE MANUAL by Bram Moolenaar @@ -95,13 +95,14 @@ For inserting text see |insert.txt|. These commands delete text. You can repeat them with the `.` command (except `:d`) and undo them. Use Visual mode to delete blocks of text. See |registers| for an explanation of registers. - + *d-special* An exception for the d{motion} command: If the motion is not linewise, the start and end of the motion are not in the same line, and there are only blanks before the start and there are no non-blanks after the end of the motion, the delete becomes linewise. This means that the delete also removes the line of blanks that you might expect to remain. Use the |o_v| operator to -force the motion to be characterwise. +force the motion to be characterwise or remove the "z" flag from 'cpoptions' +(see |cpo-z|) to disable this peculiarity. Trying to delete an empty region of text (e.g., "d0" in the first column) is an error when 'cpoptions' includes the 'E' flag. @@ -251,7 +252,7 @@ blank; this is probably a bug, because "dw" deletes all the blanks; use the If you prefer "cw" to include the space after a word, use this mapping: > :map cw dwi -Or use "caw" (see |aw|). +Alternatively use "caw" (see also |aw| and |cpo-z|). *:c* *:ch* *:change* :{range}c[hange][!] Replace lines of text with some different text. @@ -1272,13 +1273,13 @@ Vim fills these registers with text from yank and delete commands. Numbered register 0 contains the text from the most recent yank command, unless the command specified another register with ["x]. Numbered register 1 contains the text deleted by the most recent delete or -change command, unless the command specified another register or the text is -less than one line (the small delete register is used then). An exception is -made for the delete operator with these movement commands: |%|, |(|, |)|, |`|, -|/|, |?|, |n|, |N|, |{| and |}|. Register "1 is always used then (this is Vi -compatible). The "- register is used as well if the delete is within a line. -Note that these characters may be mapped. E.g. |%| is mapped by the matchit -plugin. +change command (even when the command specified another register), unless the +text is less than one line (the small delete register is used then). An +exception is made for the delete operator with these movement commands: |%|, +|(|, |)|, |`|, |/|, |?|, |n|, |N|, |{| and |}|. +Register "1 is always used then (this is Vi compatible). The "- register is +used as well if the delete is within a line. Note that these characters may be +mapped. E.g. |%| is mapped by the matchit plugin. With each successive deletion or change, Vim shifts the previous contents of register 1 into register 2, 2 into 3, and so forth, losing the previous contents of register 9. @@ -1413,7 +1414,7 @@ The next three commands always work on whole lines. :[range]m[ove] {address} *:m* *:mo* *:move* *E134* Move the lines given by [range] to below the line given by {address}. - Any text properties in [range] are cleared + Any text properties in [range] are cleared. See |text-prop-cleared|. ============================================================================== diff --git a/runtime/doc/channel.txt b/runtime/doc/channel.txt index f294679..c1fae51 100644 --- a/runtime/doc/channel.txt +++ b/runtime/doc/channel.txt @@ -1,4 +1,4 @@ -*channel.txt* For Vim version 9.1. Last change: 2024 Jun 13 +*channel.txt* For Vim version 9.1. Last change: 2024 Jul 17 VIM REFERENCE MANUAL by Bram Moolenaar @@ -981,8 +981,9 @@ job_start({command} [, {options}]) *job_start()* invoked. {command} can be a String. This works best on MS-Windows. On - Unix it is split up in white-separated parts to be passed to - execvp(). Arguments in double quotes can contain white space. + Unix it is split up in white space separated parts to be + passed to execvp(). Arguments in double quotes can contain + white space. {command} can be a List, where the first item is the executable and further items are the arguments. All items are converted diff --git a/runtime/doc/cmdline.txt b/runtime/doc/cmdline.txt index 214571f..d1ef7ba 100644 --- a/runtime/doc/cmdline.txt +++ b/runtime/doc/cmdline.txt @@ -1,4 +1,4 @@ -*cmdline.txt* For Vim version 9.1. Last change: 2024 Apr 27 +*cmdline.txt* For Vim version 9.1. Last change: 2024 Aug 20 VIM REFERENCE MANUAL by Bram Moolenaar @@ -379,7 +379,8 @@ terminals) :keepp[atterns] {command} *:keepp* *:keeppatterns* Execute {command}, without adding anything to the search - history + history and, in case of |:s| or |:&|, without modifying the + last substitute pattern or substitute string. ============================================================================== 2. Command-line completion *cmdline-completion* diff --git a/runtime/doc/editing.txt b/runtime/doc/editing.txt index ca8f0ae..4d477cf 100644 --- a/runtime/doc/editing.txt +++ b/runtime/doc/editing.txt @@ -1,4 +1,4 @@ -*editing.txt* For Vim version 9.1. Last change: 2024 Apr 12 +*editing.txt* For Vim version 9.1. Last change: 2024 Jul 10 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1804,7 +1804,7 @@ There are three different types of searching: stop-directories are appended to the path (for the 'path' option) or to the filename (for the 'tags' option) with a ';'. If you want several stop-directories separate them with ';'. If you want no stop-directory - ("search upward till the root directory) just use ';'. > + ("search upward till the root directory") just use ';'. > /usr/include/sys;/usr < will search in: > /usr/include/sys @@ -1817,7 +1817,7 @@ There are three different types of searching: If Vim's current path is /u/user_x/work/release and you do > :set path=include;/u/user_x -< and then search for a file with |gf| the file is searched in: > +< and then search for a file with |gf| the file is searched in: > /u/user_x/work/release/include /u/user_x/work/include /u/user_x/include @@ -1829,7 +1829,7 @@ There are three different types of searching: 3) Combined up/downward search: If Vim's current path is /u/user_x/work/release and you do > set path=**;/u/user_x -< and then search for a file with |gf| the file is searched in: > +< and then search for a file with |gf| the file is searched in: > /u/user_x/work/release/** /u/user_x/work/** /u/user_x/** @@ -1841,10 +1841,10 @@ There are three different types of searching: In the above example you might want to set path to: > :set path=**,/u/user_x/** -< This searches: - /u/user_x/work/release/** ~ - /u/user_x/** ~ - This searches the same directories, but in a different order. +< This searches: > + /u/user_x/work/release/** + /u/user_x/** +< This searches the same directories, but in a different order. Note that completion for ":find", ":sfind", and ":tabfind" commands do not currently work with 'path' items that contain a URL or use the double star diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt index 18cd2c1..e2c6967 100644 --- a/runtime/doc/eval.txt +++ b/runtime/doc/eval.txt @@ -1,4 +1,4 @@ -*eval.txt* For Vim version 9.1. Last change: 2024 Jun 01 +*eval.txt* For Vim version 9.1. Last change: 2024 Jul 28 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1995,7 +1995,8 @@ v:beval_winid The |window-ID| of the window, over which the mouse pointer *v:char* *char-variable* v:char Argument for evaluating 'formatexpr' and used for the typed character when using <expr> in an abbreviation |:map-<expr>|. - It is also used by the |InsertCharPre| and |InsertEnter| events. + It is also used by the |InsertCharPre|, |InsertEnter| and + |KeyInputPre| events. *v:charconvert_from* *charconvert_from-variable* v:charconvert_from @@ -3123,9 +3124,10 @@ text... let lconst[0] = 2 " Error! let lconst[1][0] = 'b' " OK < *E995* - |:const| does not allow to for changing a variable: > + It is an error to specify an existing variable with + |:const|. > :let x = 1 - :const x = 2 " Error! + :const x = 1 " Error! < *E996* Note that environment variables, option values and register values cannot be used here, since they cannot diff --git a/runtime/doc/evim-it.1 b/runtime/doc/evim-it.1 index 75be4e8..778b54d 100644 --- a/runtime/doc/evim-it.1 +++ b/runtime/doc/evim-it.1 @@ -1,4 +1,4 @@ -.TH EVIM 1 "16 febbraio 2002 " +.TH EVIM 1 "12 agosto 2024" .SH NOME evim \- Vim "facile", impostato in modo da poter essere usato come editore non-modale .SH SINTASSI @@ -34,8 +34,12 @@ Occorre usare CTRL-Q per ottenere il comportamenti di CTRL-V in Vim nativo. Vedere vim(1). .SH FILE .TP 15 -/usr/local/lib/vim/evim.vim +/usr/local/share/vim??/evim.vim Lo script caricato per inizializzare eVim. +.br +.I vim?? + il numero breve di versione, p.es. vim91 per +.B Vim 9.1 .SH AKA [Also Known As] noto anche come "Vim per semplici". Quando is usa evim si suppone che si prenda un fazzoletto, diff --git a/runtime/doc/evim-it.UTF-8.1 b/runtime/doc/evim-it.UTF-8.1 index 04bec41..914bec5 100644 --- a/runtime/doc/evim-it.UTF-8.1 +++ b/runtime/doc/evim-it.UTF-8.1 @@ -1,4 +1,4 @@ -.TH EVIM 1 "16 febbraio 2002 " +.TH EVIM 1 "12 agosto 2024" .SH NOME evim \- Vim "facile", impostato in modo da poter essere usato come editore non-modale .SH SINTASSI @@ -34,8 +34,12 @@ Occorre usare CTRL-Q per ottenere il comportamenti di CTRL-V in Vim nativo. Vedere vim(1). .SH FILE .TP 15 -/usr/local/lib/vim/evim.vim +/usr/local/share/vim??/evim.vim Lo script caricato per inizializzare eVim. +.br +.I vim?? +è il numero breve di versione, p.es. vim91 per +.B Vim 9.1 .SH AKA [Also Known As] noto anche come "Vim per semplici". Quando is usa evim si suppone che si prenda un fazzoletto, diff --git a/runtime/doc/evim-ru.1 b/runtime/doc/evim-ru.1 index 6d6f5de..dab75ce 100644 --- a/runtime/doc/evim-ru.1 +++ b/runtime/doc/evim-ru.1 @@ -1,59 +1,69 @@ -.TH EVIM 1 "2002 February 16" -.SH -evim \- Vim, Vim -.SH +.TH EVIM 1 "12 2024" +.SH + evim \[em] ݣ Vim, Vim + . +.SH .br .B evim -[] [ ..] +[] [ ...] .br .B eview .SH - + .B evim - + .B Vim - , - . Vim -Notepad MS-Windows. + , + . Vim + Notepad MS Windows. + .B eVim - , - . + , + . .PP - , - - Vim . - , Vim. + , - + Vim. + , . .PP - + .B eview - , " - ". -evim \-R. + , " ". + evim \-R. .PP - Vim, .. + Vim, . . vim(1). .PP - + .B evim - 'insertmode', . + 'insertmode', +. .br - , , MS-Windows - . CTRL-X -, CTRL-C CTRL-V . - CTRL-V, CTRL-Q. -.SH -. vim(1). + , , + , , + MS Windows. + CTRL+X , CTRL+C + CTRL+V . + , CTRL+V, + CTRL+Q. +.SH +. vim(1). .SH .TP 15 -/usr/local/lib/vim/evim.vim +/usr/local/share/vim/vim??/evim.vim , eVim. -.SH AKA -eVim "Vim ". +.br + +.I "vim??" + ݣ , , vim91 +.B Vim 9.1 +.SH + eVim "Vim ". , . -.SH +.SH vim(1) .SH - + .B Vim - (Bram Moolenaar), - . . /. + (Bram Moolenaar), + . . . diff --git a/runtime/doc/evim-ru.UTF-8.1 b/runtime/doc/evim-ru.UTF-8.1 index 581c364..8ac2669 100644 --- a/runtime/doc/evim-ru.UTF-8.1 +++ b/runtime/doc/evim-ru.UTF-8.1 @@ -1,59 +1,69 @@ -.TH EVIM 1 "2002 February 16" -.SH ИМЯ -evim \- простой Vim, позволяет редактировать файл с помощью Vim в безрежимном режиме -.SH КОМАНДНАЯ СТРОКА +.TH EVIM 1 "12 августа 2024" +.SH НАЗНАЧЕНИЕ +Программа evim \[em] это упрощённый Vim, которая производит запуск редактора Vim +в безрежимном варианте редактирования файлов. +.SH КРАТКИЙ ОБЗОР .br .B evim -[ключи] [файл ..] +[аргументы] [файл ...] .br .B eview .SH ОПИСАНИЕ -Команда +По команде .B evim -запускает +запускается редактор .B Vim -и настраивает ряд опций таким образом, что он начинает вести себя -как обычный безрежимный редактор. В этом режиме Vim напоминает -Notepad из MS-Windows. +и выполняется настройка ряда параметров таким образом, чтобы его работа была как +у простых безрежимных редакторов. В этом режиме редактор Vim напоминает +редактор Notepad из MS Windows. +Вариант редактора .B eVim -всегда запускается с поддержкой графического интерфейса, чтобы обеспечить -использование меню и инструментальной панели. +всегда запускается с поддержкой графического интерфейса, чтобы была возможность +взаимодействия с программой через меню и панель инструментов. .PP -Эта команда создана для тех, кто по каким-то причинам не в состоянии -работать с Vim в обычном режиме. Редактирование файлов при этом происходит -гораздо менее эффективно, чем при использовании обычного Vim. +Этот вариант редактора сделан для тех, кто по каким-то причинам не в состоянии +работать с обычным редактором Vim. Редактирование файлов при этом происходит +гораздо менее эффективно, чем при использовании стандартного варианта редактора. .PP -Команда +По команде .B eview -выполняет почти ту же самую задачу, но файл открывается в режиме "только -для чтения". Использование этой команды полностью идентично использованию -evim \-R. +выполняются почти те же самые действия, но файл будет открыт "только для чтения". +Использование этой команды полностью идентично команде evim \-R. .PP -Подробнее о Vim, ключах запуска и т.п. смотрите на странице справочника +Подробнее о редакторе Vim, аргументах запуска и т. п. смотрите в справочнике vim(1). .PP -При использовании +По команде .B evim -включается опция 'insertmode', что позволяет вводить текст напрямую. +будет установлен параметр 'insertmode', что обеспечивает ввод текста напрямую в +буфер. .br -Кроме того, настраиваются привязки, позволяющие использовать кнопки MS-Windows -для выполнения команд копирования и вклейки. CTRL-X используется для вырезания -текста, CTRL-C для копирования и CTRL-V для вклейки. Чтобы воспользоваться -изначальным значением кнопки CTRL-V, используйте CTRL-Q. -.SH ПАРАМЕТРЫ ЗАПУСКА -См. vim(1). +Кроме того, настраиваются клавиатурные команды, позволяющие выполнять +копирование и вставку текста, используя такие же комбинации клавиш, +как в MS Windows. +Клавиши CTRL+X используются для вырезания текста, CTRL+C для копирования +и CTRL+V для вставки. +Чтобы выполнить ту же команду, которая раньше была назначена на клавиши CTRL+V, +используйте клавиши CTRL+Q. +.SH АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ +См. справочник vim(1). .SH ФАЙЛЫ .TP 15 -/usr/local/lib/vim/evim.vim +/usr/local/share/vim/vim??/evim.vim Сценарий, который загружается для инициализации eVim. -.SH AKA -eVim также известен как "Vim для чайников". +.br +Здесь +.I "vim??" +означает сокращённую запись номера версии, например, vim91 для версии редактора +.B Vim 9.1 +.SH ДРУГИМИ СЛОВАМИ +Вариант eVim также известен как "Vim для чайников". Для наилучшего эффекта рекомендуется во время использования повязать на голове платок, предварительно завязав на каждом конце по узелку. -.SH СМОТРИ ТАКЖЕ +.SH СМОТРИТЕ ТАКЖЕ vim(1) .SH АВТОРЫ -Большая часть +Большая часть редактора .B Vim -создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное -количество людей. См. меню Справка/Благодарности. +была создана Брамом Моленаром (Bram Moolenaar), которому помогало огромное +количество людей. См. меню Справка пункт Соавторы. diff --git a/runtime/doc/evim.1 b/runtime/doc/evim.1 index bb859ce..a67bda3 100644 --- a/runtime/doc/evim.1 +++ b/runtime/doc/evim.1 @@ -1,4 +1,4 @@ -.TH EVIM 1 "2002 February 16" +.TH EVIM 1 "2024 August 12" .SH NAME evim \- easy Vim, edit a file with Vim and setup for modeless editing .SH SYNOPSIS @@ -34,8 +34,12 @@ Use CTRL-Q to obtain the original meaning of CTRL-V. See vim(1). .SH FILES .TP 15 -/usr/local/lib/vim/evim.vim +/usr/local/share/vim/vim??/evim.vim The script loaded to initialize eVim. +.br +.I vim?? +is short version number, like vim91 for +.B Vim 9.1 .SH AKA Also Known As "Vim for gumbies". When using evim you are expected to take a handkerchief, diff --git a/runtime/doc/evim.man b/runtime/doc/evim.man index 8b8db81..f966f82 100644 --- a/runtime/doc/evim.man +++ b/runtime/doc/evim.man @@ -1,4 +1,4 @@ -EVIM(1) EVIM(1) +EVIM(1) General Commands Manual EVIM(1) @@ -10,7 +10,7 @@ SYNOPSIS eview DESCRIPTION - eVim starts Vim and sets options to make it behave like a modeless edi- + eVim starts Vim and sets options to make it behave like a modeless edi‐ tor. This is still Vim but used as a point-and-click editor. This feels a lot like using Notepad on MS-Windows. eVim will always run in the GUI, to enable the use of menus and toolbar. @@ -32,8 +32,9 @@ OPTIONS See vim(1). FILES - /usr/local/lib/vim/evim.vim + /usr/local/share/vim/vim??/evim.vim The script loaded to initialize eVim. + vim?? is short version number, like vim91 for Vim 9.1 AKA Also Known As "Vim for gumbies". When using evim you are expected to @@ -49,4 +50,4 @@ AUTHOR - 2002 February 16 EVIM(1) + 2024 August 12 EVIM(1) diff --git a/runtime/doc/filetype.txt b/runtime/doc/filetype.txt index 927b75c..a7ed928 100644 --- a/runtime/doc/filetype.txt +++ b/runtime/doc/filetype.txt @@ -1,4 +1,4 @@ -*filetype.txt* For Vim version 9.1. Last change: 2024 May 23 +*filetype.txt* For Vim version 9.1. Last change: 2024 Aug 21 VIM REFERENCE MANUAL by Bram Moolenaar @@ -149,6 +149,7 @@ variables can be used to overrule the filetype used for certain extensions: *.csh g:filetype_csh |ft-csh-syntax| *.dat g:filetype_dat *.def g:filetype_def + *.dsp g:filetype_dsp *.f g:filetype_f |ft-forth-syntax| *.frm g:filetype_frm |ft-form-syntax| *.fs g:filetype_fs |ft-forth-syntax| @@ -622,6 +623,17 @@ any #lang directive overrides, use the following command: > let g:freebasic_lang = "fblite" +GDSCRIPT *ft-gdscript-plugin* + +By default the following options are set, based on Godot official docs: > + + setlocal noexpandtab softtabstop=0 shiftwidth=0 + +To disable this behavior, set the following variable in your vimrc: > + + let g:gdscript_recommended_style = 0 + + GIT COMMIT *ft-gitcommit-plugin* One command, :DiffGitCached, is provided to show a diff of the current commit @@ -629,6 +641,17 @@ in the preview window. It is equivalent to calling "git diff --cached" plus any arguments given to the command. +GO *ft-go-plugin* + +By default the following options are set, based on Golang official docs: > + + setlocal noexpandtab softtabstop=0 shiftwidth=0 + +To disable this behavior, set the following variable in your vimrc: > + + let g:go_recommended_style = 0 + + GPROF *ft-gprof-plugin* The gprof filetype plugin defines a mapping <C-]> to jump from a function @@ -730,9 +753,13 @@ Global mapping: nmap <F1> <Plug>ManPreGetPage Local mappings: +<Plug>ManBS +<LocalLeader>h Clear backspace <BS> characters from the buffer CTRL-] Jump to the manual page for the word under the cursor. CTRL-T Jump back to the previous manual page. -q Same as the |:quit| command. + +The mappings can be disabled with: > + let g:no_man_maps = 1 To use a vertical split instead of horizontal: > let g:ft_man_open_mode = 'vert' @@ -741,8 +768,8 @@ To use a new tab: > To enable |folding|, use this: > let g:ft_man_folding_enable = 1 -If you do not like the default folding, use an |autocommand| to add your desired -folding style instead. For example: > +If you do not like the default folding, use an |autocommand| to add your +desired folding style instead. For example: > autocmd FileType man setlocal foldmethod=indent foldenable If you would like :Man {number} {name} to behave like man {number} {name} by @@ -885,6 +912,10 @@ You can change the default by defining the variable g:tex_flavor to the format let g:tex_flavor = "latex" Currently no other formats are recognized. +TYPST *ft-typst-plugin* + + *g:typst_conceal* +When |TRUE| the Typst filetype plugin will set the 'conceallevel' option to 2. VIM *ft-vim-plugin* diff --git a/runtime/doc/gui.txt b/runtime/doc/gui.txt index 3b55919..071de9c 100644 --- a/runtime/doc/gui.txt +++ b/runtime/doc/gui.txt @@ -1,4 +1,4 @@ -*gui.txt* For Vim version 9.1. Last change: 2024 May 11 +*gui.txt* For Vim version 9.1. Last change: 2024 Jul 17 VIM REFERENCE MANUAL by Bram Moolenaar @@ -970,7 +970,7 @@ name and all existing submenus below it are affected. 5.7 Examples for Menus *menu-examples* -Here is an example on how to add menu items with menu's! You can add a menu +Here is an example on how to add menu items with menus. You can add a menu item for the keyword under the cursor. The register "z" is used. > :nmenu Words.Add\ Var wb"zye:menu! Words.<C-R>z <C-R>z<CR> diff --git a/runtime/doc/index.txt b/runtime/doc/index.txt index d26592a..c595d9d 100644 --- a/runtime/doc/index.txt +++ b/runtime/doc/index.txt @@ -1,4 +1,4 @@ -*index.txt* For Vim version 9.1. Last change: 2023 Jan 09 +*index.txt* For Vim version 9.1. Last change: 2023 Jul 14 VIM REFERENCE MANUAL by Bram Moolenaar @@ -213,10 +213,12 @@ tag char note action in Normal mode ~ |<Tab>| <Tab> 1 go to N newer entry in jump list |CTRL-I| CTRL-I 1 same as <Tab> |<NL>| <NL> 1 same as "j" +|<S-NL>| <S-NL> 1 same as CTRL-F |CTRL-J| CTRL-J 1 same as "j" CTRL-K not used |CTRL-L| CTRL-L redraw screen |<CR>| <CR> 1 cursor to the first CHAR N lines lower +|<S-CR>| <S-CR> 1 same as CTRL-F |CTRL-M| CTRL-M 1 same as <CR> |CTRL-N| CTRL-N 1 same as "j" |CTRL-O| CTRL-O 1 go to N older entry in jump list @@ -287,9 +289,11 @@ tag char note action in Normal mode ~ |star| * 1 search forward for the Nth occurrence of the ident under the cursor |+| + 1 same as <CR> +|<S-Plus>| <S-+> 1 same as CTRL-F |,| , 1 repeat latest f, t, F or T in opposite direction N times |-| - 1 cursor to the first CHAR N lines higher +|<S-Minus>| <S--> 1 same as CTRL-B |.| . 2 repeat last change with count replaced with N |/| /{pattern}<CR> 1 search forward for the Nth occurrence of @@ -753,7 +757,7 @@ tag char note action in Normal mode ~ search pattern and Visually select it |gP| ["x]gP 2 put the text [from register x] before the cursor N times, leave the cursor after it -|gQ| gQ switch to "Ex" mode with Vim editing +|gQ| gQ switch to "Ex" mode with Vim editing |gR| gR 2 enter Virtual Replace mode |gT| gT go to the previous tab page |gU| gU{motion} 2 make Nmove text uppercase diff --git a/runtime/doc/insert.txt b/runtime/doc/insert.txt index 6ebd83e..3894e5c 100644 --- a/runtime/doc/insert.txt +++ b/runtime/doc/insert.txt @@ -1,4 +1,4 @@ -*insert.txt* For Vim version 9.1. Last change: 2024 Jan 04 +*insert.txt* For Vim version 9.1. Last change: 2024 Aug 25 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1183,6 +1183,18 @@ items: user_data custom data which is associated with the item and available in |v:completed_item|; it can be any type; defaults to an empty string + hl_group an additional highlight group whose attributes are + combined with |hl-PmenuSel| and |hl-Pmenu| or + |hl-PmenuMatchSel| and |hl-PmenuMatch| highlight + attributes in the popup menu to apply cterm and gui + properties (with higher priority) like strikethrough + to the completion items + kind_hlgroup an additional highlight group specifically for setting + the highlight attributes of the completion kind. When + this field is present, it will override the + |hl-PmenuKind| highlight group, allowing for the + customization of ctermfg and guifg properties for the + completion kind All of these except "icase", "equal", "dup" and "empty" must be a string. If an item does not meet these requirements then an error message is given and @@ -1995,13 +2007,25 @@ These two commands will keep on asking for lines, until you type a line containing only a ".". Watch out for lines starting with a backslash, see |line-continuation|. -When in Ex mode (see |-e|) a backslash at the end of the line can be used to -insert a NUL character. To be able to have a line ending in a backslash use -two backslashes. This means that the number of backslashes is halved, but -only at the end of the line. - -NOTE: These commands cannot be used with |:global| or |:vglobal|. -":append" and ":insert" don't work properly in between ":if" and +Text typed after a "|" command separator is used first. So the following +command in ex mode: > + :a|one + two + . + :visual +appends the following text, after the cursor line: > + one + two +< +In |Ex-mode|, when these commands are used with |:global| or |:vglobal| then +the lines are obtained from the text following the command. Separate lines +with a NL escaped with a backslash: > + :global/abc/insert\ + one line\ + another line +The final "." is not needed then. + +NOTE: ":append" and ":insert" don't work properly in between ":if" and ":endif", ":for" and ":endfor", ":while" and ":endwhile". *:start* *:startinsert* diff --git a/runtime/doc/map.txt b/runtime/doc/map.txt index 365f49a..432a986 100644 --- a/runtime/doc/map.txt +++ b/runtime/doc/map.txt @@ -1,4 +1,4 @@ -*map.txt* For Vim version 9.1. Last change: 2024 May 05 +*map.txt* For Vim version 9.1. Last change: 2024 Jul 11 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1631,6 +1631,7 @@ completion can be enabled: -complete=compiler compilers -complete=cscope |:cscope| suboptions -complete=dir directory names + -complete=dir_in_path directory names in |'cdpath'| -complete=environment environment variable names -complete=event autocommand events -complete=expression Vim expression diff --git a/runtime/doc/mbyte.txt b/runtime/doc/mbyte.txt index 3bb2bfb..f02092b 100644 --- a/runtime/doc/mbyte.txt +++ b/runtime/doc/mbyte.txt @@ -1,4 +1,4 @@ -*mbyte.txt* For Vim version 9.1. Last change: 2024 Jun 09 +*mbyte.txt* For Vim version 9.1. Last change: 2024 Jul 17 VIM REFERENCE MANUAL by Bram Moolenaar et al. @@ -493,7 +493,7 @@ The GUI fully supports multibyte characters. It is also possible in a terminal, if the terminal supports the same encoding that Vim uses. Thus this is less flexible. -For example, you can run Vim in a xterm with added multibyte support and/or +For example, you can run Vim in an xterm with added multibyte support and/or |XIM|. Examples are kterm (Kanji term) and hanterm (for Korean), Eterm (Enlightened terminal) and rxvt. @@ -1379,7 +1379,7 @@ Motif. Use the ":hi Menu font={fontname}" command for this. |:highlight| TYPING UTF-8 *utf-8-typing* If you are using X-Windows, you should find an input method that supports -UTF-8. +the UTF-8 encoding. If your system does not provide support for typing UTF-8, you can use the 'keymap' feature. This allows writing a keymap file, which defines a UTF-8 diff --git a/runtime/doc/mlang.txt b/runtime/doc/mlang.txt index 82c9772..9a15bdf 100644 --- a/runtime/doc/mlang.txt +++ b/runtime/doc/mlang.txt @@ -1,4 +1,4 @@ -*mlang.txt* For Vim version 9.1. Last change: 2022 Sep 17 +*mlang.txt* For Vim version 9.1. Last change: 2024 Jul 11 VIM REFERENCE MANUAL by Bram Moolenaar @@ -59,7 +59,9 @@ use of "-" and "_". :lan[guage] tim[e] {name} :lan[guage] col[late] {name} Set the current language (aka locale) to {name}. - The locale {name} must be a valid locale on your + The POSIX format of {name} is: > + language[_territory][.encoding] +< The locale {name} must be a valid locale on your system. Some systems accept aliases like "en" or "en_US", but some only accept the full specification like "en_US.ISO_8859-1". On Unix systems you can use diff --git a/runtime/doc/motion.txt b/runtime/doc/motion.txt index 8c07fbf..3e45884 100644 --- a/runtime/doc/motion.txt +++ b/runtime/doc/motion.txt @@ -1,4 +1,4 @@ -*motion.txt* For Vim version 9.1. Last change: 2023 Dec 27 +*motion.txt* For Vim version 9.1. Last change: 2024 Jul 14 VIM REFERENCE MANUAL by Bram Moolenaar @@ -351,6 +351,7 @@ gg Goto line [count], default first line, on the first *:[range]* :[range] Set the cursor on the last line number in [range]. + In Ex mode, print the lines in [range]. [range] can also be just one line number, e.g., ":1" or ":'m". In contrast with |G| this command does not modify the @@ -433,7 +434,7 @@ WORD before the fold. Special case: "cw" and "cW" are treated like "ce" and "cE" if the cursor is on a non-blank. This is because "cw" is interpreted as change-word, and a -word does not include the following white space. +word does not include the following white space (see also |cw|). Another special case: When using the "w" motion in combination with an operator and the last word moved over is at the end of a line, the end of diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index 6ec4031..3ec8a3a 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -1,4 +1,4 @@ -*options.txt* For Vim version 9.1. Last change: 2024 Jun 17 +*options.txt* For Vim version 9.1. Last change: 2024 Aug 12 VIM REFERENCE MANUAL by Bram Moolenaar @@ -76,7 +76,8 @@ achieve special effects. These options come in three forms: :se[t] {option}:{value} Set string or number option to {value}. For numeric options the value can be given in decimal, - hex (preceded with 0x) or octal (preceded with '0'). + hex (preceded with 0x) or octal (preceded with '0' or + '0o'). The old value can be inserted by typing 'wildchar' (by default this is a <Tab> or CTRL-E if 'compatible' is set). Many string options with fixed syntax and names @@ -1476,7 +1477,7 @@ A jump table for the options with a short description can be found at |Q_op|. applying 'breakindent', even if the resulting text should normally be narrower. This prevents text indented almost to the right window border - occupying lot of vertical space when broken. + occupying lots of vertical space when broken. (default: 20) shift:{n} After applying 'breakindent', the wrapped line's beginning will be shifted by the given number of @@ -2257,8 +2258,9 @@ A jump table for the options with a short description can be found at |Q_op|. Also see 'preserveindent'. *'cpoptions'* *'cpo'* *cpo* -'cpoptions' 'cpo' string (Vim default: "aABceFs", - Vi default: all flags) +'cpoptions' 'cpo' string (Vim default: "aABceFsz", + Vi default: all flags, except "#{|&/\." + |$VIM_POSIX|: all flags) global A sequence of single character flags. When a character is present this indicates Vi-compatible behavior. This is used for things where @@ -2486,6 +2488,9 @@ A jump table for the options with a short description can be found at |Q_op|. *cpo-Z* Z When using "w!" while the 'readonly' option is set, don't reset 'readonly'. + *cpo-z* + z Special casing the "cw" and "d" command (see |cw| and + |d-special|). *cpo-!* ! When redoing a filter command, use the last used external command, whatever it was. Otherwise the last @@ -4727,7 +4732,7 @@ A jump table for the options with a short description can be found at |Q_op|. in Insert mode as specified with the 'indentkeys' option. When this option is not empty, it overrules the 'cindent' and 'smartindent' indenting. When 'lisp' is set, this option is - is only used when 'lispoptions' contains "expr:1". + only used when 'lispoptions' contains "expr:1". When 'paste' is set this option is not used for indenting. The expression is evaluated with |v:lnum| set to the line number for which the indent is to be computed. The cursor is also in this line @@ -5090,7 +5095,7 @@ A jump table for the options with a short description can be found at |Q_op|. part can be in one of two forms: 1. A list of pairs. Each pair is a "from" character immediately followed by the "to" character. Examples: "aA", "aAbBcC". - 2. A list of "from" characters, a semi-colon and a list of "to" + 2. A list of "from" characters, a semicolon and a list of "to" characters. Example: "abc;ABC" Example: "aA,fgh;FGH,cCdDeE" Special characters need to be preceded with a backslash. These are @@ -5172,7 +5177,7 @@ A jump table for the options with a short description can be found at |Q_op|. update use |:redraw|. This may occasionally cause display errors. It is only meant to be set temporarily when performing an operation where redrawing may cause - flickering or cause a slow down. + flickering or cause a slowdown. *'linebreak'* *'lbr'* *'nolinebreak'* *'nolbr'* 'linebreak' 'lbr' boolean (default off) @@ -5913,6 +5918,20 @@ A jump table for the options with a short description can be found at |Q_op|. (without "unsigned" it would become "9-2019"). Using CTRL-X on "0" or CTRL-A on "18446744073709551615" (2^64 - 1) has no effect, overflow is prevented. + blank If included, treat numbers as signed or unsigned based on + preceding whitespace. If a number with a leading dash has its + dash immediately preceded by a non-whitespace character (i.e., + not a tab or a " "), the negative sign won't be considered as + part of the number. For example: + Using CTRL-A on "14" in "Carbon-14" results in "Carbon-15" + (without "blank" it would become "Carbon-13"). + Using CTRL-X on "8" in "Carbon -8" results in "Carbon -9" + (because -8 is preceded by whitespace. If "unsigned" was + set, it would result in "Carbon -7"). + If this format is included, overflow is prevented as if + "unsigned" were set. If both this format and "unsigned" are + included, "unsigned" will take precedence. + Numbers which simply begin with a digit in the range 1-9 are always considered decimal. This also happens for numbers that are not recognized as octal or hex. @@ -6160,7 +6179,7 @@ A jump table for the options with a short description can be found at |Q_op|. :set path+= < To use an environment variable, you probably need to replace the separator. Here is an example to append $INCL, in which directory - names are separated with a semi-colon: > + names are separated with a semicolon: > :let &path = &path .. "," .. substitute($INCL, ';', ',', 'g') < Replace the ';' with a ':' or whatever separator is used. Note that this doesn't work when $INCL contains a comma or white space. @@ -6739,7 +6758,7 @@ A jump table for the options with a short description can be found at |Q_op|. import/ files that are found by `:import` indent/ indent scripts |indent-expression| keymap/ key mapping files |mbyte-keymap| - lang/ menu translations |:menutrans| + lang/ message translations |:menutrans| and |multi-lang| menu.vim GUI menus |menu.vim| pack/ packages |:packadd| plugin/ plugin scripts |write-plugin| @@ -7227,7 +7246,7 @@ A jump table for the options with a short description can be found at |Q_op|. POSIX default: "AS") global *E1336* This option helps to avoid all the |hit-enter| prompts caused by file - messages, for example with CTRL-G, and to avoid some other messages. + messages, for example with CTRL-G, and to avoid some other messages. It is a list of flags: flag meaning when present ~ f use "(3 of 5)" instead of "(file 3 of 5)" *shm-f* @@ -7684,7 +7703,7 @@ A jump table for the options with a short description can be found at |Q_op|. minus two. timeout:{millisec} Limit the time searching for suggestions to - {millisec} milli seconds. Applies to the following + {millisec} milliseconds. Applies to the following methods. When omitted the limit is 5000. When negative there is no limit. {only works when built with the |+reltime| feature} @@ -8086,6 +8105,19 @@ A jump table for the options with a short description can be found at |Q_op|. 'S' flag in 'cpoptions'. Only normal file name characters can be used, "/\*?[|<>" are illegal. + *'tabclose'* *'tcl'* +'tabclose' 'tcl' string (default "") + global + This option controls the behavior when closing tab pages (e.g., using + |:tabclose|). When empty Vim goes to the next (right) tab page. + + Possible values (comma-separated list): + left If included, go to the previous tab page instead of + the next one. + uselast If included, go to the previously used tab page if + possible. This option takes precedence over the + others. + *'tabline'* *'tal'* 'tabline' 'tal' string (default empty) global diff --git a/runtime/doc/pattern.txt b/runtime/doc/pattern.txt index 183806a..4351944 100644 --- a/runtime/doc/pattern.txt +++ b/runtime/doc/pattern.txt @@ -1,4 +1,4 @@ -*pattern.txt* For Vim version 9.1. Last change: 2024 Jun 03 +*pattern.txt* For Vim version 9.1. Last change: 2024 Jun 18 VIM REFERENCE MANUAL by Bram Moolenaar @@ -151,13 +151,17 @@ CTRL-C Interrupt current (search) command. Use CTRL-Break on executing autocommands |autocmd-searchpat|. Same thing for when invoking a user function. + While typing the search pattern the current match will be shown if the 'incsearch' option is on. Remember that you still have to finish the search command with <CR> to actually position the cursor at the displayed match. Or use <Esc> to abandon the search. + *nohlsearch-auto* All matches for the last used search pattern will be highlighted if you set -the 'hlsearch' option. This can be suspended with the |:nohlsearch| command. +the 'hlsearch' option. This can be suspended with the |:nohlsearch| command +or auto suspended with nohlsearch plugin. See |nohlsearch-install|. + When 'shortmess' does not include the "S" flag, Vim will automatically show an index, on which the cursor is. This can look like this: > diff --git a/runtime/doc/pi_netrw.txt b/runtime/doc/pi_netrw.txt index aeaca0b..a4dee26 100644 --- a/runtime/doc/pi_netrw.txt +++ b/runtime/doc/pi_netrw.txt @@ -1,4 +1,4 @@ -*pi_netrw.txt* For Vim version 9.1. Last change: 2024 May 11 +*pi_netrw.txt* For Vim version 9.1. Last change: 2024 Jul 13 ------------------------------------------------ NETRW REFERENCE MANUAL by Charles E. Campbell @@ -15,7 +15,7 @@ Copyright: Copyright (C) 2017 Charles E Campbell *netrw-copyright* merchantability. No guarantees of suitability for any purpose. By using this plugin, you agree that in no event will the copyright holder be liable for any damages resulting from the use of this - software. Use at your own risk! + software. Use at your own risk! For bug reports, see |bugs|. *netrw* *dav* *ftp* *netrw-file* *rcp* *scp* @@ -3859,12 +3859,7 @@ netrw: thereby making it easier to associate which part of the debugging trace is due to which command. - Please send that information to <netrw.vim>'s maintainer along - with the o/s you're using and the vim version that you're using - (see |:version|) (remove the embedded NOSPAM first) > - - NcampObell@SdrPchip.AorgM-NOSPAM -< + For bug reports, please see |bugs|. ============================================================================== 12. History *netrw-history* {{{1 diff --git a/runtime/doc/popup.txt b/runtime/doc/popup.txt index 1ad4fb9..b9e992b 100644 --- a/runtime/doc/popup.txt +++ b/runtime/doc/popup.txt @@ -1,4 +1,4 @@ -*popup.txt* For Vim version 9.1. Last change: 2024 Jun 08 +*popup.txt* For Vim version 9.1. Last change: 2024 Jun 16 VIM REFERENCE MANUAL by Bram Moolenaar @@ -186,6 +186,7 @@ Manipulating a popup window: |popup_move()| change the position and size of a popup |popup_setoptions()| override options of a popup |popup_settext()| replace the popup buffer contents + |popup_setbuf()| set the buffer for the popup window Closing popup windows: |popup_close()| close one popup @@ -574,6 +575,18 @@ popup_notification({what}, {options}) *popup_notification()* Return type: |Number| +popup_setbuf({id}, {buf}) *popup_setbuf()* + Set buffer {buf} to be displayed in popup win {id}. For the + use of {buf}, see |bufname()| function. + May change window size or position to adjust for the size + of the buffer text. + + Can also be used as a |method|: > + GetPopup()->popup_setbuf(bufnr('foobar')) +< + Return type: |vim9-boolean| + + popup_setoptions({id}, {options}) *popup_setoptions()* Override options in popup {id} with entries in {options}. These options can be set: @@ -613,9 +626,8 @@ popup_setoptions({id}, {options}) *popup_setoptions()* popup_settext({id}, {text}) *popup_settext()* - Set the text of the buffer in popup win {id}. {text} is the - same as supplied to |popup_create()|, except that a buffer - number is not allowed. + Set the text of the buffer in popup win {id}. {text} is + a string or a list of strings to be displayed in the popup. Does not change the window size or position, other than caused by the different text. diff --git a/runtime/doc/quickfix.txt b/runtime/doc/quickfix.txt index e2aef24..e44c5d5 100644 --- a/runtime/doc/quickfix.txt +++ b/runtime/doc/quickfix.txt @@ -1,4 +1,4 @@ -*quickfix.txt* For Vim version 9.1. Last change: 2024 Jun 16 +*quickfix.txt* For Vim version 9.1. Last change: 2024 Aug 20 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1006,7 +1006,7 @@ Another option is using 'makeencoding'. ============================================================================== 5. Using :vimgrep and :grep *grep* *lid* -Vim has two ways to find matches for a pattern: Internal and external. The +Vim has two ways to find matches for a pattern: internal and external. The advantage of the internal grep is that it works on all systems and uses the powerful Vim search patterns. An external grep program can be used when the Vim grep does not do what you want. @@ -1035,7 +1035,7 @@ commands can be combined to create a NewGrep command: > command! -nargs=+ NewGrep execute 'silent grep! <args>' | copen 42 -5.1 using Vim's internal grep +5.1 Using Vim's internal grep *:vim* *:vimgrep* *E682* *E683* :vim[grep][!] /{pattern}/[g][j][f] {file} ... @@ -1092,8 +1092,8 @@ commands can be combined to create a NewGrep command: > :vim[grep][!] {pattern} {file} ... Like above, but instead of enclosing the pattern in a - non-ID character use a white-separated pattern. The - pattern must start with an ID character. + non-ID character use a white space separated pattern. + The pattern must start with an ID character. Example: > :vimgrep Error *.c < @@ -1345,6 +1345,13 @@ Additional arguments can be passed to pandoc: - either by appending them to make, say `:make html --self-contained` . - or setting them in `b:pandoc_compiler_args` or `g:pandoc_compiler_args`. +The `--from` argument is an educated guess using the buffer file type; +it can be overridden by setting `b:pandoc_compiler_from`. +Likewise the `--metadata lang` argument is set using `&spelllang`; +it can be overridden by setting `b:pandoc_compiler_lang`. +If `--from=markdown` is assumed and no title set in a title header or +YAML block, then the filename (without extension) is used as the title. + PERL *quickfix-perl* *compiler-perl* The Perl compiler plugin doesn't actually compile, but invokes Perl's internal @@ -1414,6 +1421,17 @@ shells and OSes and also does not allow to use other available TeX options, if any. If your TeX doesn't support "-interaction=nonstopmode", please report it with different means to express \nonstopmode from the command line. +TYPST COMPILER *compiler-typst* + +Vim includes a compiler plugin for Typst files. This compiler is enabled +automatically in Typst buffers by the Typst filetype plugin |ft-typst-plugin|. +Run |:make| to compile the current Typst file. + + *g:typst_cmd* +By default Vim will use "typst" as the command to run the Typst compiler. This +can be changed by setting the |g:typst_cmd| variable: > + let g:typst_cmd = "/path/to/other/command" + ============================================================================= 7. The error format *error-file-format* diff --git a/runtime/doc/quickref.txt b/runtime/doc/quickref.txt index 517fa30..42b5228 100644 --- a/runtime/doc/quickref.txt +++ b/runtime/doc/quickref.txt @@ -935,6 +935,7 @@ Short explanation of each option: *option-list* 'switchbuf' 'swb' sets behavior when switching to another buffer 'synmaxcol' 'smc' maximum column to find syntax items 'syntax' 'syn' syntax to be loaded for current buffer +'tabclose' 'tcl' which tab page to focus when closing a tab 'tabline' 'tal' custom format for the console tab pages line 'tabpagemax' 'tpm' maximum number of tab pages for |-p| and "tab all" 'tabstop' 'ts' number of spaces that <Tab> in file uses diff --git a/runtime/doc/repeat.txt b/runtime/doc/repeat.txt index e95b6a1..726aec3 100644 --- a/runtime/doc/repeat.txt +++ b/runtime/doc/repeat.txt @@ -1,4 +1,4 @@ -*repeat.txt* For Vim version 9.1. Last change: 2023 May 26 +*repeat.txt* For Vim version 9.1. Last change: 2024 Aug 12 VIM REFERENCE MANUAL by Bram Moolenaar @@ -735,6 +735,10 @@ Your directory layout would be like this: start/foobar/autoload/foo.vim " loaded when foo command used start/foobar/doc/foo.txt " help for foo.vim start/foobar/doc/tags " help tags + start/foobar/lang/<lang_id>/LC_MESSAGES/foobar.mo + " messages for the plugin in the + " <lang_id> language. These files are + " optional. opt/fooextra/plugin/extra.vim " optional plugin, defines commands opt/fooextra/autoload/extra.vim " loaded when extra command used opt/fooextra/doc/extra.txt " help for extra.vim @@ -744,24 +748,346 @@ This allows for the user to do: > mkdir ~/.vim/pack cd ~/.vim/pack git clone https://github.com/you/foobar.git myfoobar - +< Here "myfoobar" is a name that the user can choose, the only condition is that it differs from other packages. In your documentation you explain what the plugins do, and tell the user how to load the optional plugin: > :packadd! fooextra - +< You could add this packadd command in one of your plugins, to be executed when the optional plugin is needed. + *package-doc* *package-documentation* Run the `:helptags` command to generate the doc/tags file. Including this generated file in the package means that the user can drop the package in the pack directory and the help command works right away. Don't forget to re-run the command after changing the plugin help: > :helptags path/start/foobar/doc :helptags path/opt/fooextra/doc - +< + *package-translation* +In order for a plugin to display translated messages, a few steps are +required. +The author of the plugin who likes to translate messages must define the name +of the package and the location of the directory where the translations can be +found using the |bindtextdomain()| function: > + :call bindtextdomain("foobar", + \ fnamemodify(expand("<script>"), ':p:h') .. '/../lang/') +< +Where: + "foobar" is the unique package identifier by which the |gettext()| + function will later search for translation strings for this + plugin. + "lang/" is the relative or absolute path to the directory structure + where the translation file is located. + +The directory structure where the message translation files should be placed +is (from the top-level directory of the package): +"lang/<lang_id>/LC_MESSAGES". For the format of <lang_id> see |multi-lang|. +This function needs to be called only once during the initialization of the +plugin. +Once this is done, the |gettext()| function can be used to retrieve translated +messages: > + :echo gettext("Hello", "foobar") +< +Where: + "Hello" the message "Hello" to be translated into the user's language + |:lang| + "foobar" the package identifier, which was previously defined using the + |bindtextdomain()| function. + +After that you need to create a template file for translation - POT-file. +To do this, execute the following commands (using the Vim repository): > + cd ~/forkvim/src/po + make -f Makefile "PLUGPACKAGE={package}" \ + "PO_PLUG_INPUTLIST={path/to/scripts-that-need-translations.vim}" \ + ["POT_PLUGPACKAGE_PATH={path/where/to/write/{package}.pot}" \] + ["VIMPROG={path/to/vim} \] + {package}.pot +< +Where: +PLUGPACKAGE A variable containing the name of the package that we + specified in the |bindtextdomain()| and + |gettext()| functions, for example, "foobar". +PO_PLUG_INPUTLIST A variable containing scripts that have strings + to translate, i.e. where we specified the |gettext()| + function. Scripts are specified with an absolute + or relative path. Example: start/foobar/plugin/bar.vim + use blanks to separate scripts. +POT_PLUGPACKAGE_PATH A variable containing the directory where the prepared + POT file will be saved. This is not a required variable, + if no directory is specified, then the POT file will + be placed in the "src/po" directory. +VIMPROG A variable containing a directory with a working Vim. + If the Vim editor is already built and installed, and + is contained in the $PATH environment variable, + then you can specify just the name of the vim + executable. +{package}.pot This is the Target. It is specified as the name of + the package, for example, "foobar" with the addition + of the .pot extension. +Once a POT file is created, its contents are copied into separate PO files for +each language for which the translation will be prepared. + +When the translation is finished, it is necessary to convert the PO files into +binary MO-files format and place these MO-files into the "lang/" directory, the +structure of which we created earlier. +To do this, run the following commands: +> + cd ~/forkvim/src/po + make -f Makefile "PLUGPACKAGE={package}" \ + "PO_PLUGPACKAGE={path/to/{lang}.po}" \ + ["MO_PLUGPACKAGE_PATH={path/to/lang/<lang_id>/LC_MESSAGES}" \] + {package}.mo +< +Where: +PLUGPACKAGE A variable containing the name of the package that we + specified in the |bindtextdomain()| and |gettext()| + functions, for example, "foobar". +PO_PLUGPACKAGE A variable containing a PO file. The file is specified + with an absolute or relative path. For example, + "~/myproject/translate/en.po" +MO_PLUGPACKAGE_PATH A variable containing the structure of the "lang/" + directory, where the file with translations will be + placed, for example, "foobar.mo". This is not + a required variable, if the directory is not specified, + the MO file will be saved in the "src/po" directory. +{package}.mo This is the Target. It is specified as the name of + the package, for example, "foobar" with the addition + of the .mo extension. + + *package-translate_example* +Let's show it all on some concrete example and translate the +"ftplugin/aap.vim" file into Russian and German. + +First, let's prepare the "aap.vim" file, specifying |bindtextdomain()| and +|gettext()| function calls in it. +> + " Only do this when not done yet for this buffer + if exists("b:did_ftplugin") + finish + endif + + " Don't load another plugin for this buffer + let b:did_ftplugin = 1 + call bindtextdomain("aap", fnamemodify(expand("<script>"), ':p:h') .. '/../lang/') + + " Reset 'formatoptions', 'comments', 'commentstring' and 'expandtab' to undo + " this plugin. + let b:undo_ftplugin = "setl fo< com< cms< et<" + + " Set 'formatoptions' to break comment lines but not other lines, + " and insert the comment leader when hitting <CR> or using "o". + setlocal fo-=t fo+=croql + + " Set 'comments' to format dashed lists in comments. + setlocal comments=s:#\ -,m:#\ \ ,e:#,n:#,fb:- + setlocal commentstring=#\ %s + + " Expand tabs to spaces to avoid trouble. + setlocal expandtab + + if (has("gui_win32") || has("gui_gtk")) && !exists("b:browsefilter") + let b:browsefilter = gettext("Aap Recipe Files (*.aap)\t*.aap\n", "aap") + if has("win32") + let b:browsefilter ..= gettext("All Files (*.*)\t*\n", "aap") + else + let b:browsefilter ..= gettext("All Files (*)\t*\n", "aap") + endif + let b:undo_ftplugin ..= " | unlet! b:browsefilter" + endif +< +Now let's create a POT file for it (example uses Windows paths): +> + cd /d f:\forkvim\src\po + (the following command must be entered in one line, here it is separated for example) + nmake.exe -f Make_mvc.mak "PLUGPACKAGE=aap" + "PO_PLUG_INPUTLIST=d:\Programs\vim\vim91\ftplugin\aap.vim" + "POT_PLUGPACKAGE_PATH=e:\project\translate\plugins" + "VIMPROG=d:\Programs\vim\vim91\vim.exe" + aap.pot +< +After the POT file of our package is created, go to the directory where we +saved it and perform the translation. +> + cd /d e:\project\translate\plugins + copy aap.pot ru.po + copy aap.pot de.po +< +We have prepared a PO file with a translation into Russian: + # Test plugins translate ~ + # ~ + msgid "" ~ + msgstr "" ~ + "Project-Id-Version: aap\n" ~ + "Report-Msgid-Bugs-To: \n" ~ + "POT-Creation-Date: 2024-06-23 14:58+0300\n" ~ + "PO-Revision-Date: 2024-06-23 14:58+0300\n" ~ + "Last-Translator: Restorer\n" ~ + "Language-Team: RuVim\n" ~ + "Language: ru\n" ~ + "MIME-Version: 1.0\n" ~ + "Content-Type: text/plain; charset=UTF-8\n" ~ + "Content-Transfer-Encoding: 8bit\n" ~ + + #: ../../runtime/ftplugin/aap.vim:32 ~ + msgid "Aap Recipe Files (*.aap)\t*.aap\n" ~ + msgstr "Файлы инструкций Aap (*.aap)\t*.aap\n" ~ + + #: ../../runtime/ftplugin/aap.vim:34 ~ + msgid "All Files (*.*)\t*\n" ~ + msgstr "Все файлы (*.*)\t*\n" ~ + + #: ../../runtime/ftplugin/aap.vim:36 ~ + msgid "All Files (*)\t*\n" ~ + msgstr "Все файлы (*)\t*\n" ~ + +And the PO file in German: + # Test plugins translate~ + #~ + msgid ""~ + msgstr ""~ + "Project-Id-Version: aap\n"~ + "Report-Msgid-Bugs-To: \n"~ + "POT-Creation-Date: 2024-06-23 14:58+0300\n"~ + "PO-Revision-Date: 2024-06-24 13:11+0300\n"~ + "Last-Translator: Restorer\n"~ + "Language-Team: German\n"~ + "Language: de\n"~ + "MIME-Version: 1.0\n"~ + "Content-Type: text/plain; charset=UTF-8\n"~ + "Content-Transfer-Encoding: 8bit\n"~ + + #: ../../runtime/ftplugin/aap.vim:32~ + msgid "Aap Recipe Files (*.aap)\t*.aap\n"~ + msgstr "Aap-Rezeptdateien (*.aap)\t*.aap\n"~ + + #: ../../runtime/ftplugin/aap.vim:34~ + msgid "All Files (*.*)\t*\n"~ + msgstr "Alle Dateien (*.*)\t*.*\n"~ + + #: ../../runtime/ftplugin/aap.vim:36~ + msgid "All Files (*)\t*\n"~ + msgstr "Alle Dateien (*)\t*\n"~ + +Now convert these files into MO files so that |gettext()| can display message +translations. Note that since this is not a specialized plugin package, we +will put the MO files in the "lang/" directory of the Vim editor. +Type the following commands: +> + cd /d f:\forkvim\src\po + (the following command must be entered in one line, here it is separated for example) + For Russian: + nmake.exe -f Make_mvc.mak "PLUGPACKAGE=aap" + "PO_PLUGPACKAGE=e:\project\translate\plugins\ru.po" + "MO_PLUGPACKAGE_PATH=d:\Programs\vim\vim91\lang\ru\LC_MESSAGES" + aap.mo + For German: + nmake.exe -f Make_mvc.mak "PLUGPACKAGE=aap" + "PO_PLUGPACKAGE=e:\project\translate\plugins\de.po" + "MO_PLUGPACKAGE_PATH=d:\Programs\vim\vim91\lang\de\LC_MESSAGES" + aap.mo +< +That's it, the translations are ready and you can see the plugin's messages +in your native language. + +Let's also try to translate a plugin package. For example, when a package +contains several scripts containing strings that need to be translated. +For example, let's translate the "netrw" package into Japanese. +For this example, we will translate only a few lines from this package. +Let's prepare the scripts where we need to translate the message strings. + +The file "autoload\netrw.vim": +> + " Load Once: + if &cp || exists("g:loaded_netrw") + finish + endif + call bindtextdomain("netrw", fnamemodify(expand("<script>"), ':p:h') .. '/../lang/') + + " Check that vim has patches that netrw requires. + " Patches needed for v7.4: 1557, and 213. + " (netrw will benefit from vim's having patch#656, too) + let s:needspatches=[1557,213] + if exists("s:needspatches") + for ptch in s:needspatches + if v:version < 704 || (v:version == 704 && !has("patch".ptch)) + if !exists("s:needpatch{ptch}") + unsilent echomsg gettext("***sorry*** this version of netrw requires vim v7.4 with patch#", "netrw") .. ptch + endif + let s:needpatch{ptch}= 1 + finish + endif + endfor + endif +< +The file "autoload\netrwSettings.vim": +> + " Load Once: + if exists("g:loaded_netrwSettings") || &cp + finish + endif + call bindtextdomain("netrw", fnamemodify(expand("<script>"), ':p:h') .. '/../lang/') + let g:loaded_netrwSettings = "v18" + if v:version < 700 + echohl WarningMsg + echo gettext("***warning*** this version of netrwSettings needs vim 7.0", "netrw") + echohl Normal + finish + endif +< +Now we will prepare a POT file for further translation of messages. +Execute the following commands: +> + cd ~/forkvim/src/po + make -f Makefile "VIMPROG=/usr/local/bin/vim" "PLUGPACKAGE=netrw" \ + "POT_PLUGPACKAGE_PATH=~/project/translate/plugins" \ + "PO_PLUG_INPUTLIST=../../runtime/autoload/netrw.vim + ../../runtime/autoload/netrwSettings.vim" \ + netrw.pot +< +Go to the directory with the POT file and make the translation: +> + cd ~/project/translate/plugins + cp ./netrw.pot ja.po +< +When we have the translation ready in the "ja.po" file: + # Test plugins translate ~ + # ~ + msgid "" ~ + msgstr "" ~ + "Project-Id-Version: netrw\n" ~ + "Report-Msgid-Bugs-To: \n" ~ + "POT-Creation-Date: 2024-06-23 17:14+0300\n" ~ + "PO-Revision-Date: 2024-06-23 17:14+0300\n" ~ + "Last-Translator: Restorer\n" ~ + "Language-Team: Japanese\n" ~ + "Language: ja\n" ~ + "MIME-Version: 1.0\n" ~ + "Content-Type: text/plain; charset=UTF-8\n" ~ + "Content-Transfer-Encoding: 8bit\n" ~ + + #: ../../runtime/autoload/netrw.vim:51 ~ + msgid "***sorry*** this version of netrw requires vim v7.4 with patch#" ~ + msgstr "" ~ + "***申し訳ありません***このバージョンのnetrwには、パッチ付きのvim v7.4が必要です#" ~ + + #: ../../runtime/autoload/netrwSettings.vim:28 ~ + msgid "***warning*** this version of netrwSettings needs vim 7.0" ~ + msgstr "***警告***このバージョンのnetrwSettingsにはvim7.0が必要です" ~ + +Convert ja.po to a MO file: +> + cd ~/forkvim/src/po + make -f Makefile "PLUGPACKAGE=netrw" \ + "PO_PLUGPACKAGE=~/project/translate/plugins/ja.po" \ + "MO_PLUGPACKAGE_PATH=/usr/local/share/vim/vim91/lang/ja/LC_MESSAGES" \ + netrw.mo +< +Executing those steps will allow you to get translation of any third-party +plug-in packages. Dependencies between plugins ~ *packload-two-steps* diff --git a/runtime/doc/scroll.txt b/runtime/doc/scroll.txt index cf79353..f0ec16b 100644 --- a/runtime/doc/scroll.txt +++ b/runtime/doc/scroll.txt @@ -1,4 +1,4 @@ -*scroll.txt* For Vim version 9.1. Last change: 2022 Oct 17 +*scroll.txt* For Vim version 9.1. Last change: 2024 Jul 06 VIM REFERENCE MANUAL by Bram Moolenaar @@ -48,6 +48,8 @@ CTRL-D Scroll window Downwards in the buffer. The number of <S-Down> or *<S-Down>* *<kPageDown>* <PageDown> or *<PageDown>* *CTRL-F* +<S-CR> or *<S-CR>* *<S-NL>* +<S-+> or *SHIFT-+* *<S-Plus>* CTRL-F Scroll window [count] pages Forwards (downwards) in the buffer. See also 'startofline' option. When there is only one window the 'window' option @@ -85,6 +87,7 @@ CTRL-U Scroll window Upwards in the buffer. The number of <S-Up> or *<S-Up>* *<kPageUp>* <PageUp> or *<PageUp>* *CTRL-B* +<S--> or *<S-Minus>* *SHIFT-MINUS* CTRL-B Scroll window [count] pages Backwards (upwards) in the buffer. See also 'startofline' option. When there is only one window the 'window' option diff --git a/runtime/doc/sign.txt b/runtime/doc/sign.txt index dac3a57..679099c 100644 --- a/runtime/doc/sign.txt +++ b/runtime/doc/sign.txt @@ -1,4 +1,4 @@ -*sign.txt* For Vim version 9.1. Last change: 2024 Jun 08 +*sign.txt* For Vim version 9.1. Last change: 2024 Jul 07 VIM REFERENCE MANUAL by Gordon Prieur @@ -80,8 +80,9 @@ used by popup windows where 'cursorline' is set. *sign-priority* Each placed sign is assigned a priority value. When multiple signs are placed on the same line, the attributes of the sign with the highest priority is used -independently of the sign group. The default priority for a sign is 10. The -priority is assigned at the time of placing a sign. +independently of the sign group. The default priority for a sign is 10, this +value can be changed for different signs by specifying a different value at +definition time. The priority is assigned at the time of placing a sign. When two signs with the same priority are present, and one has an icon or text in the signcolumn while the other has line highlighting, then both are @@ -135,6 +136,8 @@ See |sign_define()| for the equivalent Vim script function. Motif pixmap (.xpm) Win32 .bmp, .ico, .cur pixmap (.xpm) |+xpm_w32| + priority={prio} + Default priority for the sign, see |sign-priority|. linehl={group} Highlighting group used for the whole line the sign is placed @@ -209,11 +212,11 @@ See |sign_place()| for the equivalent Vim script function. By default, the sign is placed in the global sign group. - By default, the sign is assigned a default priority of 10. To - assign a different priority value, use "priority={prio}" to - specify a value. The priority is used to determine the sign - that is displayed when multiple signs are placed on the same - line. + By default, the sign is assigned a default priority of 10, + unless specified otherwise by the sign definition. To assign a + different priority value, use "priority={prio}" to specify a + value. The priority is used to determine the sign that is + displayed when multiple signs are placed on the same line. Examples: > :sign place 5 line=3 name=sign1 file=a.py @@ -401,6 +404,7 @@ sign_define({list}) icon full path to the bitmap file for the sign. linehl highlight group used for the whole line the sign is placed in. + priority default priority value of the sign numhl highlight group used for the line number where the sign is placed. text text that is displayed when there is no icon @@ -453,6 +457,7 @@ sign_getdefined([{name}]) *sign_getdefined()* linehl highlight group used for the whole line the sign is placed in; not present if not set name name of the sign + priority default priority value of the sign numhl highlight group used for the line number where the sign is placed; not present if not set text text that is displayed when there is no icon @@ -646,7 +651,8 @@ sign_placelist({list}) *sign_placelist()* priority Priority of the sign. When multiple signs are placed on a line, the sign with the highest priority is used. If not specified, the - default value of 10 is used. See + default value of 10 is used, unless specified + otherwise by the sign definition. See |sign-priority| for more information. If {id} refers to an existing sign, then the existing sign is diff --git a/runtime/doc/sponsor.txt b/runtime/doc/sponsor.txt index 1698168..6df14eb 100644 --- a/runtime/doc/sponsor.txt +++ b/runtime/doc/sponsor.txt @@ -1,4 +1,4 @@ -*sponsor.txt* For Vim version 9.1. Last change: 2024 Apr 22 +*sponsor.txt* For Vim version 9.1. Last change: 2024 Aug 14 VIM REFERENCE MANUAL by Bram Moolenaar @@ -76,16 +76,14 @@ How much money should I send? That is up to you. The more you give, the more children will be helped. An indication for individuals that use Vim at home: 10 Euro per year. For -professional use: 30 Euro per year per person. Send at least 10 euro to be -able to vote for features. +professional use: 30 Euro per year per person. How do I become a Vim sponsor or registered Vim user? Send money, as explained above |send-money| and include your e-mail address. When the money has been received you will receive a unique registration key. -This key can be used on the Vim website to activate voting on your Vim -account. You will then get an extra page where you can vote for features and +This key can be used on the Vim website to get an extra page where you can choose whether others will be able to see that you donated. There is a link to this page on your "My Account" page. @@ -127,8 +125,7 @@ the developer |maillist|, for reporting bugs see |bugs|. How about Charityware? Currently the Vim donations go to |uganda| anyway. Thus it doesn't matter if -you sponsor Vim or ICCF. Except that Vim sponsoring will allow you to vote -for features. +you sponsor Vim or ICCF. I donated $$$, now please add feature XYZ! diff --git a/runtime/doc/starting.txt b/runtime/doc/starting.txt index 30e85ed..cdc0f16 100644 --- a/runtime/doc/starting.txt +++ b/runtime/doc/starting.txt @@ -1,4 +1,4 @@ -*starting.txt* For Vim version 9.1. Last change: 2024 Jun 04 +*starting.txt* For Vim version 9.1. Last change: 2024 Aug 03 VIM REFERENCE MANUAL by Bram Moolenaar @@ -540,6 +540,7 @@ a slash. Thus "-R" means recovery and "-/R" readonly. not needed when reading a file, because there is a check if the file that is being read has been encrypted, and Vim asks for a key automatically. |encryption| + {only available when compiled with the |+cryptv| feature} *-X* -X Do not try connecting to the X server to get the current @@ -854,16 +855,16 @@ accordingly. Vim proceeds in this order: I The environment variable VIMINIT (see also |compatible-default|) (*) The value of $VIMINIT is used as an Ex command line. II The user vimrc file(s): - "$HOME/.vimrc" (for Unix) (*) - "$HOME/.vim/vimrc" (for Unix) (*) - "$HOME/.config/vim/vimrc" (for Unix) (*) - "s:.vimrc" (for Amiga) (*) - "home:.vimrc" (for Amiga) (*) - "home:vimfiles:vimrc" (for Amiga) (*) - "$VIM/.vimrc" (for Amiga) (*) - "$HOME/_vimrc" (for Win32) (*) - "$HOME/vimfiles/vimrc" (for Win32) (*) - "$VIM/_vimrc" (for Win32) (*) + "$HOME/.vimrc" (for Unix) (*) + "$HOME/.vim/vimrc" (for Unix) (*) + "$XDG_CONFIG_HOME/vim/vimrc" (for Unix) (*) + "s:.vimrc" (for Amiga) (*) + "home:.vimrc" (for Amiga) (*) + "home:vimfiles:vimrc" (for Amiga) (*) + "$VIM/.vimrc" (for Amiga) (*) + "$HOME/_vimrc" (for Win32) (*) + "$HOME/vimfiles/vimrc" (for Win32) (*) + "$VIM/_vimrc" (for Win32) (*) "$HOME/config/settings/vim/vimrc" (for Haiku) (*) Note: For Unix and Amiga, when ".vimrc" does not exist, @@ -1257,7 +1258,7 @@ To change it later, use a ":let" command like this: > In case you need the value of $VIMRUNTIME in a shell (e.g., for a script that greps in the help files) you might be able to use this: > - VIMRUNTIME=`vim -e -T dumb --cmd 'exe "set t_cm=\<C-M>"|echo $VIMRUNTIME|quit' | tr -d '\015' ` + VIMRUNTIME=$(vim -es '+put=$VIMRUNTIME|print|quit!') Don't set $VIMRUNTIME to an empty value, some things may stop working. diff --git a/runtime/doc/syntax.txt b/runtime/doc/syntax.txt index c07c3a4..736e664 100644 --- a/runtime/doc/syntax.txt +++ b/runtime/doc/syntax.txt @@ -1,4 +1,4 @@ -*syntax.txt* For Vim version 9.1. Last change: 2024 Jun 17 +*syntax.txt* For Vim version 9.1. Last change: 2024 Aug 22 VIM REFERENCE MANUAL by Bram Moolenaar @@ -958,6 +958,25 @@ For Visual Basic use: > :let g:filetype_asa = "aspvbs" :let g:filetype_asp = "aspvbs" +ASYMPTOTE *asy.vim* *ft-asy-syntax* + +By default, only basic Asymptote keywords are highlighted. To highlight +extended geometry keywords: > + + :let g:asy_syn_plain = 1 + +and for highlighting keywords related to 3D constructions: > + + :let g:asy_syn_three = 1 + +By default, Asymptote-defined colors (e.g: lightblue) are highlighted. To +highlight TeX-defined colors (e.g: BlueViolet) use: > + + :let g:asy_syn_texcolors = 1 + +or for Xorg colors (e.g: AliceBlue): > + + :let g:asy_syn_x11colors = 1 BAAN *baan.vim* *baan-syntax* @@ -1221,6 +1240,21 @@ will be classified as tcsh, UNLESS the "filetype_csh" variable exists. If the "filetype_csh" variable exists, the filetype will be set to the value of the variable. +CSV *ft-csv-syntax* + +If you change the delimiter of a CSV file, its syntax highlighting will no +longer match the changed file content. You will need to unlet the following +variable: > + + :unlet b:csv_delimiter + +And afterwards save and reload the file: > + + :w + :e + +Now the syntax engine should determine the newly changed CSV delimiter. + CYNLIB *cynlib.vim* *ft-cynlib-syntax* @@ -1874,6 +1908,10 @@ You can also disable this rendering by adding the following line to your vimrc file: > :let html_no_rendering=1 +By default Vim synchronises the syntax to 250 lines before the first displayed +line. This can be configured using: > + :let html_minlines = 500 +< HTML comments are rather special (see an HTML reference document for the details), and the syntax coloring scheme will highlight all errors. However, if you prefer to use the wrong style (starts with <!-- and @@ -1993,102 +2031,142 @@ idlsyntax_showerror_soft Use softer colours by default for errors JAVA *java.vim* *ft-java-syntax* -The java.vim syntax highlighting file offers several options: +The java.vim syntax highlighting file offers several options. -In Java 1.0.2 it was never possible to have braces inside parens, so this was -flagged as an error. Since Java 1.1 this is possible (with anonymous -classes), and therefore is no longer marked as an error. If you prefer the -old way, put the following line into your vim startup file: > - :let java_mark_braces_in_parens_as_errors=1 +In Java 1.0.2, it was never possible to have braces inside parens, so this was +flagged as an error. Since Java 1.1, this is possible (with anonymous +classes); and, therefore, is no longer marked as an error. If you prefer the +old way, put the following line into your Vim startup file: > + :let g:java_mark_braces_in_parens_as_errors = 1 -All identifiers in java.lang.* are always visible in all classes. To -highlight them use: > - :let java_highlight_java_lang_ids=1 +All (exported) public types declared in `java.lang` are always automatically +imported and available as simple names. To highlight them, use: > + :let g:java_highlight_java_lang_ids = 1 -You can also highlight identifiers of most standard Java packages if you -download the javaid.vim script at http://www.fleiner.com/vim/download.html. -If you prefer to only highlight identifiers of a certain package, say java.io -use the following: > - :let java_highlight_java_io=1 +You can also highlight types of most standard Java packages if you download +the javaid.vim script at http://www.fleiner.com/vim/download.html. If you +prefer to only highlight types of a certain package, say `java.io`, use the +following: > + :let g:java_highlight_java_io = 1 Check the javaid.vim file for a list of all the packages that are supported. -Function names are not highlighted, as the way to find functions depends on -how you write Java code. The syntax file knows two possible ways to highlight -functions: - -If you write function declarations that are consistently indented by either -a tab, or a space . . . or eight space character(s), you may want to set > - :let java_highlight_functions="indent" - :let java_highlight_functions="indent1" - :let java_highlight_functions="indent2" - :let java_highlight_functions="indent3" - :let java_highlight_functions="indent4" - :let java_highlight_functions="indent5" - :let java_highlight_functions="indent6" - :let java_highlight_functions="indent7" - :let java_highlight_functions="indent8" +Headers of indented function declarations can be highlighted (along with parts +of lambda expressions and method reference expressions), but it depends on how +you write Java code. Two formats are recognized: + +1) If you write function declarations that are consistently indented by either +a tab, or a space . . . or eight space character(s), you may want to set one +of > + :let g:java_highlight_functions = "indent" + :let g:java_highlight_functions = "indent1" + :let g:java_highlight_functions = "indent2" + :let g:java_highlight_functions = "indent3" + :let g:java_highlight_functions = "indent4" + :let g:java_highlight_functions = "indent5" + :let g:java_highlight_functions = "indent6" + :let g:java_highlight_functions = "indent7" + :let g:java_highlight_functions = "indent8" Note that in terms of 'shiftwidth', this is the leftmost step of indentation. -However, if you follow the Java guidelines about how functions and classes are -supposed to be named (with respect to upper- and lowercase) and there is any -amount of indentation, you may want to set > - :let java_highlight_functions="style" -If neither setting does work for you, but you would still want function -declarations to be highlighted, create your own definitions by changing the -definitions in java.vim or by creating your own java.vim that includes the -original one and then adds the code to highlight functions. - -In Java 1.1 the functions System.out.println() and System.err.println() should -only be used for debugging. Therefore it is possible to highlight debugging -statements differently. To do this you must add the following definition in -your startup file: > - :let java_highlight_debug=1 -The result will be that those statements are highlighted as 'Special' -characters. If you prefer to have them highlighted differently you must define -new highlightings for the following groups.: - Debug, DebugSpecial, DebugString, DebugBoolean, DebugType -which are used for the statement itself, special characters used in debug -strings, strings, boolean constants and types (this, super) respectively. I -have opted to choose another background for those statements. + +2) However, if you follow the Java guidelines about how functions and types +are supposed to be named (with respect to upper- and lowercase) and there is +any amount of indentation, you may want to set > + :let g:java_highlight_functions = "style" + +In addition, you can combine any value of "g:java_highlight_functions" with > + :let g:java_highlight_signature = 1 +to have the name of a function with its parameter list parens distinctly +highlighted from its type parameters, return type, and formal parameters; and +to have the parameter list parens of a lambda expression with its arrow +distinctly highlighted from its formal parameters or identifiers. + +If neither setting does work for you, but you would still want headers of +function declarations to be highlighted, modify the current syntax definitions +or compose new ones. + +Higher-order function types can be hard to parse by eye, so uniformly toning +down some of their components may be of value. Provided that such type names +conform to the Java naming guidelines, you may arrange it with > + :let g:java_highlight_generics = 1 + +In Java 1.1, the functions `System.out.println()` and `System.err.println()` +should only be used for debugging. Consider adding the following definition +in your startup file: > + :let g:java_highlight_debug = 1 +to have the bulk of those statements colored as + *Debug debugging statements, +and to make some of their own items further grouped and linked: + *Special as DebugSpecial, + *String as DebugString, + *Boolean as DebugBoolean, + *Type as DebugType, +which are used for special characters appearing in strings, strings proper, +boolean literals, and special instance references (`super`, `this`, `null`), +respectively. Javadoc is a program that takes special comments out of Java program files and creates HTML pages. The standard configuration will highlight this HTML code -similarly to HTML files (see |html.vim|). You can even add Javascript -and CSS inside this code (see below). There are four differences however: - 1. The title (all characters up to the first '.' which is followed by - some white space or up to the first '@') is colored differently (to change - the color change the group CommentTitle). - 2. The text is colored as 'Comment'. - 3. HTML comments are colored as 'Special' - 4. The special Javadoc tags (@see, @param, ...) are highlighted as specials - and the argument (for @see, @param, @exception) as Function. -To turn this feature off add the following line to your startup file: > - :let java_ignore_javadoc=1 - -If you use the special Javadoc comment highlighting described above you -can also turn on special highlighting for Javascript, visual basic -scripts and embedded CSS (stylesheets). This makes only sense if you -actually have Javadoc comments that include either Javascript or embedded -CSS. The options to use are > - :let java_javascript=1 - :let java_css=1 - :let java_vb=1 - -In order to highlight nested parens with different colors define colors -for javaParen, javaParen1 and javaParen2, for example with > +similarly to HTML files (see |html.vim|). You can even add JavaScript and CSS +inside this code (see below). The HTML rendering diverges as follows: + 1. The first sentence (all characters up to the first period `.`, which is + followed by a whitespace character or a line terminator, or up to the + first block tag, e.g. `@param`, `@return`) is colored as + *SpecialComment special comments. + 2. The text is colored as + *Comment comments. + 3. HTML comments are colored as + *Special special symbols. + 4. The standard Javadoc tags (`@code`, `@see`, etc.) are colored as + *Special special symbols + and some of their arguments are colored as + *Function function names. +To turn this feature off, add the following line to your startup file: > + :let g:java_ignore_javadoc = 1 + +If you use the special Javadoc comment highlighting described above, you can +also turn on special highlighting for JavaScript, Visual Basic scripts, and +embedded CSS (stylesheets). This only makes sense if any of these languages +actually appear in Javadoc comments. The variables to use are > + :let g:java_javascript = 1 + :let g:java_css = 1 + :let g:java_vb = 1 +Note that these three variables are maintained in the HTML syntax file. + +Numbers and strings can be recognized in non-Javadoc comments with > + :let g:java_comment_strings = 1 + +When 'foldmethod' is set to "syntax", blocks of code and multi-line comments +will be folded. No text is usually written in the first line of a multi-line +comment, making folded contents of Javadoc comments less informative with the +default 'foldtext' value; you may opt for showing the contents of a second +line for any comments written in this way, and showing the contents of a first +line otherwise, with > + :let g:java_foldtext_show_first_or_second_line = 1 + +Trailing whitespace characters or a run of space characters before a tab +character can be marked as an error with > + :let g:java_space_errors = 1 +but either kind of an error can be suppressed by also defining one of > + :let g:java_no_trail_space_error = 1 + :let g:java_no_tab_space_error = 1 + +In order to highlight nested parens with different colors, define colors for +`javaParen`, `javaParen1`, and `javaParen2`. For example, > :hi link javaParen Comment or > :hi javaParen ctermfg=blue guifg=#0000ff If you notice highlighting errors while scrolling backwards, which are fixed -when redrawing with CTRL-L, try setting the "java_minlines" internal variable -to a larger number: > - :let java_minlines = 50 +when redrawing with CTRL-L, try setting the "g:java_minlines" variable to +a larger number: > + :let g:java_minlines = 50 This will make the syntax synchronization start 50 lines before the first displayed line. The default value is 10. The disadvantage of using a larger number is that redrawing can become slow. -JSON *json.vim* *ft-json-syntax* +JSON *json.vim* *ft-json-syntax* *g:vim_json_conceal* + *g:vim_json_warnings* The json syntax file provides syntax highlighting with conceal support by default. To disable concealment: > @@ -2231,7 +2309,7 @@ By default mail.vim synchronises syntax to 100 lines before the first displayed line. If you have a slow machine, and generally deal with emails with short headers, you can change this to a smaller value: > - :let mail_minlines = 30 + :let mail_minlines = 30 MAKE *make.vim* *ft-make-syntax* @@ -2242,6 +2320,16 @@ feature off by using: > :let make_no_commands = 1 +Comments are also highlighted by default. You can turn this off by using: > + + :let make_no_comments = 1 + +Microsoft Makefile handles variable expansion and comments differently +(backslashes are not used for escape). If you see any wrong highlights +because of this, you can try this: > + + :let make_microsoft = 1 + MAPLE *maple.vim* *ft-maple-syntax* @@ -2268,7 +2356,8 @@ $VIMRUNTIME/syntax/syntax.vim). mv_finance mv_logic mv_powseries -MARKDOWN *ft-markdown-syntax* +MARKDOWN *ft-markdown-syntax* *g:markdown_minlines* + *g:markdown_fenced_languages* *g:markdown_syntax_conceal* If you have long regions there might be wrong highlighting. At the cost of slowing down displaying, you can have the engine look further back to sync on @@ -2293,6 +2382,17 @@ have the following in your .vimrc: > let filetype_m = "mma" +MEDIAWIKI *ft-mediawiki-syntax* + +By default, syntax highlighting includes basic HTML tags like style and +headers |html.vim|. For strict Mediawiki syntax highlighting: > + + let g:html_no_rendering = 1 + +If HTML highlighting is desired, terminal-based text formatting such as bold +and italic is possible by: > + + let g:html_style_rendering = 1 MODULA2 *modula2.vim* *ft-modula2-syntax* @@ -2507,9 +2607,9 @@ PANDOC *ft-pandoc-syntax* By default, markdown files will be detected as filetype "markdown". Alternatively, you may want them to be detected as filetype "pandoc" instead. -To do so, set the following: > +To do so, set the *g:filetype_md* var: > - :let g:markdown_md = 'pandoc' + :let g:filetype_md = 'pandoc' The pandoc syntax plugin uses |conceal| for pretty highlighting. Default is 1 > @@ -3784,6 +3884,15 @@ are highlighted. To disable set it to zero in your .vimrc: > < The default value is 1. +TYPST *ft-typst-syntax* + + *g:typst_embedded_languages* +Typst files can embed syntax highlighting for other languages by setting the +|g:typst_embedded_languages| variable. This variable is a list of language +names whose syntax definitions will be included in Typst files. Example: > + + let g:typst_embedded_languages = ['python', 'r'] + VIM *vim.vim* *ft-vim-syntax* *g:vimsyn_minlines* *g:vimsyn_maxlines* There is a trade-off between more accurate syntax highlighting versus screen @@ -5044,7 +5153,7 @@ matches, nextgroup, etc. But there are a few differences: line (or group of continued lines). - When a match with a sync pattern is found, the rest of the line (or group of continued lines) is searched for another match. The last match is used. - This is used when a line can contain both the start end the end of a region + This is used when a line can contain both the start and the end of a region (e.g., in a C-comment like /* this */, the last "*/" is used). There are two ways how a match with a sync pattern can be used: diff --git a/runtime/doc/tabpage.txt b/runtime/doc/tabpage.txt index abbc778..afc2512 100644 --- a/runtime/doc/tabpage.txt +++ b/runtime/doc/tabpage.txt @@ -1,4 +1,4 @@ -*tabpage.txt* For Vim version 9.1. Last change: 2024 May 15 +*tabpage.txt* For Vim version 9.1. Last change: 2024 Jul 12 VIM REFERENCE MANUAL by Bram Moolenaar @@ -142,7 +142,8 @@ something else. :tabclose $ " close the last tab page :tabclose # " close the last accessed tab page -When a tab is closed the next tab page will become the current one. +When a tab is closed the next tab page will become the current one. This +behaviour can be customized using the 'tabclose' option. *:tabo* *:tabonly* :tabo[nly][!] Close all other tab pages. diff --git a/runtime/doc/tags b/runtime/doc/tags index 794fa0c..9cd6702 100644 --- a/runtime/doc/tags +++ b/runtime/doc/tags @@ -1161,6 +1161,7 @@ $quote eval.txt /*$quote* 't_xo' term.txt /*'t_xo'* 't_xs' term.txt /*'t_xs'* 'ta' options.txt /*'ta'* +'tabclose' options.txt /*'tabclose'* 'tabline' options.txt /*'tabline'* 'tabpagemax' options.txt /*'tabpagemax'* 'tabstop' options.txt /*'tabstop'* @@ -1179,6 +1180,7 @@ $quote eval.txt /*$quote* 'tbis' options.txt /*'tbis'* 'tbs' options.txt /*'tbs'* 'tc' options.txt /*'tc'* +'tcl' options.txt /*'tcl'* 'tcldll' options.txt /*'tcldll'* 'tenc' options.txt /*'tenc'* 'term' options.txt /*'term'* @@ -3742,6 +3744,7 @@ $quote eval.txt /*$quote* <RightMouse> visual.txt /*<RightMouse>* <RightRelease> term.txt /*<RightRelease>* <S- intro.txt /*<S-* +<S-CR> scroll.txt /*<S-CR>* <S-Del> os_dos.txt /*<S-Del>* <S-Down> scroll.txt /*<S-Down>* <S-End> term.txt /*<S-End>* @@ -3761,6 +3764,9 @@ $quote eval.txt /*$quote* <S-Insert> os_dos.txt /*<S-Insert>* <S-Left> motion.txt /*<S-Left>* <S-LeftMouse> term.txt /*<S-LeftMouse>* +<S-Minus> scroll.txt /*<S-Minus>* +<S-NL> scroll.txt /*<S-NL>* +<S-Plus> scroll.txt /*<S-Plus>* <S-Right> motion.txt /*<S-Right>* <S-RightMouse> term.txt /*<S-RightMouse>* <S-ScrollWheelDown> scroll.txt /*<S-ScrollWheelDown>* @@ -4063,6 +4069,7 @@ CursorHold-example windows.txt /*CursorHold-example* CursorHoldI autocmd.txt /*CursorHoldI* CursorIM mbyte.txt /*CursorIM* CursorMoved autocmd.txt /*CursorMoved* +CursorMovedC autocmd.txt /*CursorMovedC* CursorMovedI autocmd.txt /*CursorMovedI* D change.txt /*D* DOS os_dos.txt /*DOS* @@ -5549,6 +5556,7 @@ Jobs eval.txt /*Jobs* K various.txt /*K* KDE gui_x11.txt /*KDE* KVim gui_x11.txt /*KVim* +KeyInputPre autocmd.txt /*KeyInputPre* Kibaale uganda.txt /*Kibaale* Korean mbyte.txt /*Korean* L motion.txt /*L* @@ -5689,6 +5697,8 @@ Ruby if_ruby.txt /*Ruby* Russian russian.txt /*Russian* S change.txt /*S* SHELL starting.txt /*SHELL* +SHIFT-+ scroll.txt /*SHIFT-+* +SHIFT-MINUS scroll.txt /*SHIFT-MINUS* SQLGetType ft_sql.txt /*SQLGetType* SQLSetType ft_sql.txt /*SQLSetType* SafeState autocmd.txt /*SafeState* @@ -6055,6 +6065,7 @@ assert_notmatch() testing.txt /*assert_notmatch()* assert_report() testing.txt /*assert_report()* assert_true() testing.txt /*assert_true()* astro.vim syntax.txt /*astro.vim* +asy.vim syntax.txt /*asy.vim* at motion.txt /*at* atan() builtin.txt /*atan()* atan2() builtin.txt /*atan2()* @@ -6147,6 +6158,7 @@ beval_text-variable eval.txt /*beval_text-variable* beval_winid-variable eval.txt /*beval_winid-variable* beval_winnr-variable eval.txt /*beval_winnr-variable* binary-number eval.txt /*binary-number* +bindtextdomain() builtin.txt /*bindtextdomain()* bitwise-function usr_41.txt /*bitwise-function* bitwise-shift eval.txt /*bitwise-shift* blob eval.txt /*blob* @@ -6539,6 +6551,7 @@ compiler-perl quickfix.txt /*compiler-perl* compiler-pyunit quickfix.txt /*compiler-pyunit* compiler-select quickfix.txt /*compiler-select* compiler-tex quickfix.txt /*compiler-tex* +compiler-typst quickfix.txt /*compiler-typst* compiler-vaxada ft_ada.txt /*compiler-vaxada* compl-current insert.txt /*compl-current* compl-define insert.txt /*compl-define* @@ -6660,6 +6673,7 @@ cpo-v options.txt /*cpo-v* cpo-w options.txt /*cpo-w* cpo-x options.txt /*cpo-x* cpo-y options.txt /*cpo-y* +cpo-z options.txt /*cpo-z* cpo-{ options.txt /*cpo-{* cpp.vim syntax.txt /*cpp.vim* crash-recovery recover.txt /*crash-recovery* @@ -6722,6 +6736,7 @@ cw change.txt /*cw* cweb.vim syntax.txt /*cweb.vim* cynlib.vim syntax.txt /*cynlib.vim* d change.txt /*d* +d-special change.txt /*d-special* daB motion.txt /*daB* daW motion.txt /*daW* dab motion.txt /*dab* @@ -7239,6 +7254,7 @@ ft-asmh8300-syntax syntax.txt /*ft-asmh8300-syntax* ft-aspperl-syntax syntax.txt /*ft-aspperl-syntax* ft-aspvbs-syntax syntax.txt /*ft-aspvbs-syntax* ft-astro-syntax syntax.txt /*ft-astro-syntax* +ft-asy-syntax syntax.txt /*ft-asy-syntax* ft-awk-plugin filetype.txt /*ft-awk-plugin* ft-bash-syntax syntax.txt /*ft-bash-syntax* ft-basic-syntax syntax.txt /*ft-basic-syntax* @@ -7260,6 +7276,7 @@ ft-context-settings ft_context.txt /*ft-context-settings* ft-cpp-syntax syntax.txt /*ft-cpp-syntax* ft-csh-syntax syntax.txt /*ft-csh-syntax* ft-css-omni insert.txt /*ft-css-omni* +ft-csv-syntax syntax.txt /*ft-csv-syntax* ft-cweb-syntax syntax.txt /*ft-cweb-syntax* ft-cynlib-syntax syntax.txt /*ft-cynlib-syntax* ft-dart-syntax syntax.txt /*ft-dart-syntax* @@ -7284,7 +7301,9 @@ ft-fortran-syntax syntax.txt /*ft-fortran-syntax* ft-freebasic-plugin filetype.txt /*ft-freebasic-plugin* ft-freebasic-syntax syntax.txt /*ft-freebasic-syntax* ft-fvwm-syntax syntax.txt /*ft-fvwm-syntax* +ft-gdscript-plugin filetype.txt /*ft-gdscript-plugin* ft-gitcommit-plugin filetype.txt /*ft-gitcommit-plugin* +ft-go-plugin filetype.txt /*ft-go-plugin* ft-gprof-plugin filetype.txt /*ft-gprof-plugin* ft-groff-syntax syntax.txt /*ft-groff-syntax* ft-gsp-syntax syntax.txt /*ft-gsp-syntax* @@ -7320,6 +7339,7 @@ ft-markdown-syntax syntax.txt /*ft-markdown-syntax* ft-masm-syntax syntax.txt /*ft-masm-syntax* ft-mathematica-syntax syntax.txt /*ft-mathematica-syntax* ft-matlab-indent indent.txt /*ft-matlab-indent* +ft-mediawiki-syntax syntax.txt /*ft-mediawiki-syntax* ft-metafont ft_mp.txt /*ft-metafont* ft-metafont-intro ft_mp.txt /*ft-metafont-intro* ft-metafont-mappings ft_mp.txt /*ft-metafont-mappings* @@ -7398,6 +7418,8 @@ ft-tex-syntax syntax.txt /*ft-tex-syntax* ft-tf-syntax syntax.txt /*ft-tf-syntax* ft-typescript-syntax syntax.txt /*ft-typescript-syntax* ft-typescriptreact-syntax syntax.txt /*ft-typescriptreact-syntax* +ft-typst-plugin filetype.txt /*ft-typst-plugin* +ft-typst-syntax syntax.txt /*ft-typst-syntax* ft-vb-syntax syntax.txt /*ft-vb-syntax* ft-verilog-indent indent.txt /*ft-verilog-indent* ft-vhdl-indent indent.txt /*ft-vhdl-indent* @@ -7505,6 +7527,7 @@ g:decada.Unit_Name() ft_ada.txt /*g:decada.Unit_Name()* g:do_no_lazyload_menus gui.txt /*g:do_no_lazyload_menus* g:filetype_csh syntax.txt /*g:filetype_csh* g:filetype_haredoc ft_hare.txt /*g:filetype_haredoc* +g:filetype_md syntax.txt /*g:filetype_md* g:filetype_r syntax.txt /*g:filetype_r* g:ftplugin_rust_source_path ft_rust.txt /*g:ftplugin_rust_source_path* g:gnat ft_ada.txt /*g:gnat* @@ -7551,6 +7574,9 @@ g:html_use_encoding syntax.txt /*g:html_use_encoding* g:html_use_input_for_pc syntax.txt /*g:html_use_input_for_pc* g:html_use_xhtml syntax.txt /*g:html_use_xhtml* g:html_whole_filler syntax.txt /*g:html_whole_filler* +g:markdown_fenced_languages syntax.txt /*g:markdown_fenced_languages* +g:markdown_minlines syntax.txt /*g:markdown_minlines* +g:markdown_syntax_conceal syntax.txt /*g:markdown_syntax_conceal* g:netrw_altfile pi_netrw.txt /*g:netrw_altfile* g:netrw_alto pi_netrw.txt /*g:netrw_alto* g:netrw_altv pi_netrw.txt /*g:netrw_altv* @@ -7705,9 +7731,14 @@ g:tex_subscripts syntax.txt /*g:tex_subscripts* g:tex_superscripts syntax.txt /*g:tex_superscripts* g:tex_verbspell syntax.txt /*g:tex_verbspell* g:typescript_host_keyword syntax.txt /*g:typescript_host_keyword* +g:typst_cmd quickfix.txt /*g:typst_cmd* +g:typst_conceal filetype.txt /*g:typst_conceal* +g:typst_embedded_languages syntax.txt /*g:typst_embedded_languages* g:var eval.txt /*g:var* g:vim_indent indent.txt /*g:vim_indent* g:vim_indent_cont indent.txt /*g:vim_indent_cont* +g:vim_json_conceal syntax.txt /*g:vim_json_conceal* +g:vim_json_warnings syntax.txt /*g:vim_json_warnings* g:vimball_home pi_vimball.txt /*g:vimball_home* g:vimball_mkdir pi_vimball.txt /*g:vimball_mkdir* g:vimsyn_comment_strings syntax.txt /*g:vimsyn_comment_strings* @@ -7773,6 +7804,10 @@ gdb-version terminal.txt /*gdb-version* ge motion.txt /*ge* gender-neutral helphelp.txt /*gender-neutral* get() builtin.txt /*get()* +get()-blob builtin.txt /*get()-blob* +get()-dict builtin.txt /*get()-dict* +get()-func builtin.txt /*get()-func* +get()-list builtin.txt /*get()-list* get-ms-debuggers debug.txt /*get-ms-debuggers* getbufinfo() builtin.txt /*getbufinfo()* getbufline() builtin.txt /*getbufline()* @@ -8288,6 +8323,7 @@ iconise starting.txt /*iconise* iconize starting.txt /*iconize* iconv() builtin.txt /*iconv()* iconv-dynamic mbyte.txt /*iconv-dynamic* +id() builtin.txt /*id()* ident-search tips.txt /*ident-search* idl-syntax syntax.txt /*idl-syntax* idl.vim syntax.txt /*idl.vim* @@ -9178,6 +9214,8 @@ no_buffers_menu gui.txt /*no_buffers_menu* no_mail_maps filetype.txt /*no_mail_maps* no_plugin_maps filetype.txt /*no_plugin_maps* nocombine syntax.txt /*nocombine* +nohlsearch-auto pattern.txt /*nohlsearch-auto* +nohlsearch-install usr_05.txt /*nohlsearch-install* non-greedy pattern.txt /*non-greedy* non-zero-arg eval.txt /*non-zero-arg* none-function_argument userfunc.txt /*none-function_argument* @@ -9291,6 +9329,10 @@ out_timeout channel.txt /*out_timeout* p change.txt /*p* pack-add repeat.txt /*pack-add* package-create repeat.txt /*package-create* +package-doc repeat.txt /*package-doc* +package-documentation repeat.txt /*package-documentation* +package-translate_example repeat.txt /*package-translate_example* +package-translation repeat.txt /*package-translation* packages repeat.txt /*packages* packload-two-steps repeat.txt /*packload-two-steps* page-down intro.txt /*page-down* @@ -9431,6 +9473,7 @@ popup_menu() popup.txt /*popup_menu()* popup_menu-shortcut-example popup.txt /*popup_menu-shortcut-example* popup_move() popup.txt /*popup_move()* popup_notification() popup.txt /*popup_notification()* +popup_setbuf() popup.txt /*popup_setbuf()* popup_setoptions() popup.txt /*popup_setoptions()* popup_settext() popup.txt /*popup_settext()* popup_show() popup.txt /*popup_show()* @@ -10594,6 +10637,7 @@ termdebug-mappings terminal.txt /*termdebug-mappings* termdebug-prompt terminal.txt /*termdebug-prompt* termdebug-starting terminal.txt /*termdebug-starting* termdebug-stepping terminal.txt /*termdebug-stepping* +termdebug-timeout terminal.txt /*termdebug-timeout* termdebug-variables terminal.txt /*termdebug-variables* termdebug_disasm_window terminal.txt /*termdebug_disasm_window* termdebug_map_K terminal.txt /*termdebug_map_K* diff --git a/runtime/doc/tagsrch.txt b/runtime/doc/tagsrch.txt index 7091f83..858309a 100644 --- a/runtime/doc/tagsrch.txt +++ b/runtime/doc/tagsrch.txt @@ -1,4 +1,4 @@ -*tagsrch.txt* For Vim version 9.1. Last change: 2024 Mar 16 +*tagsrch.txt* For Vim version 9.1. Last change: 2024 Aug 01 VIM REFERENCE MANUAL by Bram Moolenaar @@ -588,12 +588,12 @@ ctags). {term} ;" The two characters semicolon and double quote. This is interpreted by Vi as the start of a comment, which makes the following be ignored. This is for backwards compatibility - with Vi, it ignores the following fields. Example: + with Vi, it ignores the following fields. Example: > APP file /^static int APP;$/;" v - When {tagaddress} is not a line number or search pattern, then +< When {tagaddress} is not a line number or search pattern, then {term} must be |;". Here the bar ends the command (excluding the bar) and ;" is used to have Vi ignore the rest of the - line. Example: + line. Example: > APP file.c call cursor(3, 4)|;" v {field} .. A list of optional fields. Each field has the form: @@ -611,7 +611,9 @@ ctags). There is one field that doesn't have a ':'. This is the kind of the tag. It is handled like it was preceded with "kind:". - See the documentation of ctags for the kinds it produces. + In the above example, this was "kind:v" (typically variable). + See the documentation of ctags for the kinds it produces, with + ctags you can use `ctags --list-kinds` . The only other field currently recognized by Vim is "file:" (with an empty value). It is used for a static tag. @@ -656,14 +658,14 @@ If the command is a normal search command (it starts and ends with "/" or The direction of the search is forward for "/", backward for "?". Note that 'wrapscan' does not matter, the whole file is always searched. - If the search fails, another try is done ignoring case. If that fails too, - a search is done for: + a search is done for: > "^tagname[ \t]*(" - (the tag with '^' prepended and "[ \t]*(" appended). When using function +< (the tag with '^' prepended and "[ \t]*(" appended). When using function names, this will find the function name when it is in column 0. This will help when the arguments to the function have changed since the tags file was - made. If this search also fails another search is done with: + made. If this search also fails another search is done with: > "^[#a-zA-Z_].*\<tagname[ \t]*(" - This means: A line starting with '#' or an identifier and containing the tag +< This means: A line starting with '#' or an identifier and containing the tag followed by white space and a '('. This will find macro names and function names with a type prepended. diff --git a/runtime/doc/terminal.txt b/runtime/doc/terminal.txt index e918394..5020ed5 100644 --- a/runtime/doc/terminal.txt +++ b/runtime/doc/terminal.txt @@ -1,4 +1,4 @@ -*terminal.txt* For Vim version 9.1. Last change: 2024 Jun 17 +*terminal.txt* For Vim version 9.1. Last change: 2024 Jul 28 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1253,6 +1253,8 @@ Starting ~ *termdebug-starting* Load the plugin with this command: > packadd termdebug +When loading the plugin from the |.vimrc| file, add the "!" attribute: > + packadd! termdebug < *:Termdebug* To start debugging use `:Termdebug` or `:TermdebugCommand` followed by the command name, for example: > @@ -1283,6 +1285,15 @@ When the debugger ends, typically by typing "quit" in the gdb window, the two opened windows are closed. Only one debugger can be active at a time. + + *termdebug-timeout* +Depending on how gdb is launched, termdebug startup time may vary. +To avoid termdebug to get stuck if the startup process of gdb takes too long, +a configurable timeout is included. Such time out is configurable in terms of +multiple of 10ms: > + let g:termdebug_config['timeout'] = 500 # 500 * 10ms = 5 seconds. + +The default timeout is 3000 ms. *:TermdebugCommand* If you want to give specific commands to the command being debugged, you can use the `:TermdebugCommand` command followed by the command name and @@ -1519,35 +1530,46 @@ in a buffer with 'buftype' set to "prompt". This works slightly differently: *termdebug_use_prompt* Prompt mode can be used even when the |+terminal| feature is present with: > - let g:termdebug_config['use_prompt'] = 1 + let g:termdebug_config['use_prompt'] = v:true If there is no g:termdebug_config you can use: > - let g:termdebug_use_prompt = 1 + let g:termdebug_use_prompt = v:true + < +However, the latter form will be deprecated in future releases. + Mappings ~ +The termdebug plugin enables a few default mappings. All those mappings +are reset to their original values once the termdebug session concludes. + *termdebug_map_K* *termdebug-mappings* The K key is normally mapped to |:Evaluate| unless a buffer local (|:map-local|) mapping to K already exists. If you do not want this use: > - let g:termdebug_config['map_K'] = 0 + let g:termdebug_config['map_K'] = v:false If there is no g:termdebug_config you can use: > - let g:termdebug_map_K = 0 + let g:termdebug_map_K = v:false < +However, the latter form will be deprecated in future releases. + *termdebug_map_minus* The - key is normally mapped to |:Down| unless a buffer local mapping to the - key already exists. If you do not want this use: > - let g:termdebug_config['map_minus'] = 0 + let g:termdebug_config['map_minus'] = v:false < *termdebug_map_plus* The + key is normally mapped to |:Up| unless a buffer local mapping to the + key already exists. If you do not want this use: > - let g:termdebug_config['map_plus'] = 0 + let g:termdebug_config['map_plus'] = v:false < *termdebug_disasm_window* If you want the Asm window shown by default, set the "disasm_window" flag to 1. The "disasm_window_height" entry can be used to set the window height: > - let g:termdebug_config['disasm_window'] = 1 + let g:termdebug_config['disasm_window'] = v:true let g:termdebug_config['disasm_window_height'] = 15 If there is no g:termdebug_config you can use: > let g:termdebug_disasm_window = 15 + +However, the latter form will be deprecated in future releases. + Any value greater than 1 will set the Asm window height to that value. If the current window has enough horizontal space, it will be vertically split and the Asm window will be shown side by side with the source code window (and @@ -1557,10 +1579,13 @@ the height option won't be used). If you want the Var window shown by default, set the "variables_window" flag to 1. The "variables_window_height" entry can be used to set the window height: > - let g:termdebug_config['variables_window'] = 1 + let g:termdebug_config['variables_window'] = v:true let g:termdebug_config['variables_window_height'] = 15 If there is no g:termdebug_config you can use: > let g:termdebug_variables_window = 15 + +However, the latter form will be deprecated in future releases. + Any value greater than 1 will set the Var window height to that value. If the current window has enough horizontal space, it will be vertically split and the Var window will be shown side by side with the source code window (and @@ -1589,6 +1614,8 @@ g:termdebug_config or the "g:termdebugger" variable before invoking If there is no g:termdebug_config you can use: > let g:termdebugger = "mygdb" +However, the latter form will be deprecated in future releases. + If the command needs an argument use a List: > let g:termdebug_config['command'] = ['rr', 'replay', '--'] If there is no g:termdebug_config you can use: > @@ -1646,6 +1673,7 @@ If you don't want this then disable it with: > If there is no g:termdebug_config you can use: > let g:termdebug_popup = 0 +However, the latter form will be deprecated in future releases. Change default signs ~ *termdebug_signs* @@ -1676,6 +1704,8 @@ split: > If there is no g:termdebug_config you can use: > let g:termdebug_wide = 163 +However, the latter form will be deprecated in future releases. + This will set 'columns' to 163 when `:Termdebug` is used. The value is restored when quitting the debugger. diff --git a/runtime/doc/testing.txt b/runtime/doc/testing.txt index ebf562b..7d0402c 100644 --- a/runtime/doc/testing.txt +++ b/runtime/doc/testing.txt @@ -1,4 +1,4 @@ -*testing.txt* For Vim version 9.1. Last change: 2024 Jun 17 +*testing.txt* For Vim version 9.1. Last change: 2024 Jul 18 VIM REFERENCE MANUAL by Bram Moolenaar @@ -506,16 +506,17 @@ assert_equal({expected}, {actual} [, {msg}]) added to |v:errors| and 1 is returned. Otherwise zero is returned. |assert-return| The error is in the form "Expected {expected} but got - {actual}". When {msg} is present it is prefixed to that. + {actual}". When {msg} is present it is prefixed to that, + along with the location of the assert when run from a script. There is no automatic conversion, the String "4" is different from the Number 4. And the number 4 is different from the Float 4.0. The value of 'ignorecase' is not used here, case always matters. Example: > - assert_equal('foo', 'bar') -< Will result in a string to be added to |v:errors|: - test.vim line 12: Expected 'foo' but got 'bar' ~ + call assert_equal('foo', 'bar', 'baz') +< Will add the following to |v:errors|: + test.vim line 12: baz: Expected 'foo' but got 'bar' ~ Can also be used as a |method|, the base is passed as the second argument: > @@ -561,19 +562,19 @@ assert_fails({cmd} [, {error} [, {msg} [, {lnum} [, {context}]]]]) When {error} is a string it must be found literally in the first reported error. Most often this will be the error code, including the colon, e.g. "E123:". > - assert_fails('bad cmd', 'E987:') + call assert_fails('bad cmd', 'E987:') < When {error} is a |List| with one or two strings, these are used as patterns. The first pattern is matched against the first reported error: > - assert_fails('cmd', ['E987:.*expected bool']) + call assert_fails('cmd', ['E987:.*expected bool']) < The second pattern, if present, is matched against the last reported error. If there is only one error then both patterns must match. This can be used to check that there is only one error. To only match the last error use an empty string for the first error: > - assert_fails('cmd', ['', 'E987:']) + call assert_fails('cmd', ['', 'E987:']) < If {msg} is empty then it is not used. Do this to get the default message when passing the {lnum} argument. @@ -599,7 +600,8 @@ assert_false({actual} [, {msg}]) *assert_false()* When {actual} is not false an error message is added to |v:errors|, like with |assert_equal()|. The error is in the form "Expected False but got {actual}". - When {msg} is present it is prepended to that. + When {msg} is present it is prefixed to that, along with the + location of the assert when run from a script. Also see |assert-return|. A value is false when it is zero. When {actual} is not a @@ -625,7 +627,8 @@ assert_match({pattern}, {actual} [, {msg}]) When {pattern} does not match {actual} an error message is added to |v:errors|. Also see |assert-return|. The error is in the form "Pattern {pattern} does not match - {actual}". When {msg} is present it is prefixed to that. + {actual}". When {msg} is present it is prefixed to that, + along with the location of the assert when run from a script. {pattern} is used as with |=~|: The matching is always done like 'magic' was set and 'cpoptions' is empty, no matter what @@ -636,9 +639,9 @@ assert_match({pattern}, {actual} [, {msg}]) Use both to match the whole text. Example: > - assert_match('^f.*o$', 'foobar') + call assert_match('^f.*o$', 'foobar') < Will result in a string to be added to |v:errors|: - test.vim line 12: Pattern '^f.*o$' does not match 'foobar' ~ + test.vim line 12: Pattern '^f.*o$' does not match 'foobar' ~ Can also be used as a |method|: > getFile()->assert_match('foo.*') @@ -693,7 +696,8 @@ assert_true({actual} [, {msg}]) *assert_true()* Also see |assert-return|. A value is TRUE when it is a non-zero number. When {actual} is not a number the assert fails. - When {msg} is given it precedes the default message. + When {msg} is given it is prefixed to the default message, + along with the location of the assert when run from a script. Can also be used as a |method|: > GetResult()->assert_true() diff --git a/runtime/doc/todo.txt b/runtime/doc/todo.txt index c37a1d4..e0ebe7e 100644 --- a/runtime/doc/todo.txt +++ b/runtime/doc/todo.txt @@ -1,4 +1,4 @@ -*todo.txt* For Vim version 9.1. Last change: 2024 Jun 03 +*todo.txt* For Vim version 9.1. Last change: 2024 Jul 11 VIM REFERENCE MANUAL by Bram Moolenaar @@ -512,10 +512,6 @@ Information for a specific terminal (e.g. gnome, tmux, konsole, alacritty) is spread out. Make a section with copy/paste examples of script and pointers to more information. -Problem that a previous silent ":throw" causes a following try/catch not to -work. (ZyX, 2013 Sep 28) With examples: (Malcolm Rowe, 2015 Dec 24) -Also see #8487 for an example. - Request to use "." for the cursor column in search pattern \%<.c and \%<.v. (#8179) @@ -543,7 +539,6 @@ SpellCap doesn't show below a closed fold. #12420 - Adding "~" to 'cdpath' doesn't work for completion? (Davido, 2013 Aug 19) - Problem with 'cdpath' on MS-Windows when a directory is equal to $HOME. (2006 Jul 26, Gary Johnson) -- Completion of ":cd" doesn't use 'cdpath'. #374. Make "g>" and "g<" in Visual mode move the text right or left. Also for a block selection. #8558 diff --git a/runtime/doc/uganda.rux b/runtime/doc/uganda.rux index 783c6d5..6f0f205 100644 --- a/runtime/doc/uganda.rux +++ b/runtime/doc/uganda.rux @@ -1,4 +1,4 @@ -*uganda.txt* для Vim version 9.1 редакция от 02 марта 2022 г. +*uganda.txt* для Vim version 9.1 редакция от 14 авг 2024 г. СПРАВОЧНИК ПО РЕДАКТОРУ VIM @@ -18,10 +18,8 @@ https://www.vim.org/iccf/ https://www.iccf.nl/ -Также возможно оказание финансовой помощи для разработки программы Vim. -Люди, пожертвовавшие на развитие программы, получают право голосовать за -внедрение в редактор функциональных возможностей. См. раздел |sponsor|. -В любом случае деньги направляются в Уганду. +Также возможно оказание финансовой помощи для разработки программы Vim, +см. раздел |sponsor|. В любом случае деньги направляются в Уганду. Документация, поставляемая в составе программы Vim, распространяется на условиях лицензии на Открытые публикации, см. раздел |manual-copyright|. @@ -58,7 +56,7 @@ II) Изменённую (или дополненную) версию прогр согласованы. Если согласование не проводилось, сделанные изменения будут распространяться на условиях настоящей лицензии или более поздней её версии. Лица, в данное время являющиеся ответственными - за рабзработку, указаны в перечне по следующему адресу: + за разработку, указаны в перечне, размещённом по следующему адресу: https://github.com/orgs/vim/people. В случае изменения этой информации, актуальные данные будут опубликованы на соответствующих ресурсах (вероятнее всего по интернет‐адресам @@ -288,9 +286,7 @@ KCC предоставляет школам помощь по улучшению помощи детям в гор. Кибаале. Команда Kuwasha переводит 100% средств, поступивших в пользу проекта в Уганде. Единовременное пожертвование может быть отправлено им - напрямую. При этом прошу отправлять мне сообщение, для учёта - информации о количестве средств, пожертвованных благодаря - программе Vim. + напрямую. На их веб-сайте также можно ознакомиться с информацией по оказанию финансовой поддержки https://www.kuwasha.net/ При отправке пожертвований через Kuwasha вы получите @@ -309,7 +305,7 @@ KCC предоставляет школам помощь по улучшению https://iccf-holland.org/germany.html Европа - Банковский перевод. См. далее рубрику «Другие варианты», + Банковский перевод. См. далее «Другие варианты», где указан код Swift и номер IBAN. Любые другие платёжные методы также должны работать. Проконсультируйтесь по вопросу отправки средств на @@ -334,7 +330,8 @@ KCC предоставляет школам помощь по улучшению Чеки не принимаются. ============================================================================= + © Казорин Сергей, перевод на русский язык, 2022, <kazorin@basealt.ru> -© Restorer, редакторская правка, 2022, <restorer@mail2k.ru> +© Restorer, редакторская правка, 2024, <restorer@mail2k.ru> vim:tw=78:ts=8:noet:ft=help:norl: diff --git a/runtime/doc/uganda.txt b/runtime/doc/uganda.txt index 513759f..17590e5 100644 --- a/runtime/doc/uganda.txt +++ b/runtime/doc/uganda.txt @@ -1,4 +1,4 @@ -*uganda.txt* For Vim version 9.1. Last change: 2024 Apr 22 +*uganda.txt* For Vim version 9.1. Last change: 2024 Aug 14 VIM REFERENCE MANUAL by Bram Moolenaar @@ -15,8 +15,8 @@ below or visit the ICCF web site, available at these URLs: https://www.vim.org/iccf/ https://www.iccf.nl/ -You can also sponsor the development of Vim. Vim sponsors can vote for -features. See |sponsor|. The money goes to Uganda anyway. +You can also sponsor the development of Vim, see |sponsor|. The money goes to +Uganda anyway. The Open Publication License applies to the Vim documentation, see |manual-copyright|. diff --git a/runtime/doc/usr_05.txt b/runtime/doc/usr_05.txt index a9e8fb9..21629e3 100644 --- a/runtime/doc/usr_05.txt +++ b/runtime/doc/usr_05.txt @@ -1,4 +1,4 @@ -*usr_05.txt* For Vim version 9.1. Last change: 2024 May 17 +*usr_05.txt* For Vim version 9.1. Last change: 2024 Jun 28 VIM USER MANUAL - by Bram Moolenaar @@ -440,7 +440,7 @@ After restarting your Vim, the plugin is active and you can read about it at: > Adding comment package *comment-install* Load the plugin with this command: > - packadd comment + packadd comment < This way you can use the plugin with the default key bindings `gc` and similar for commenting (which is a well-established mapping in the Vim community). @@ -449,6 +449,22 @@ If you add this line to your vimrc file, then you need to restart Vim to have the package loaded. Once the package is loaded, read about it at: > :h comment.txt + +Adding nohlsearch package *nohlsearch-install* + +Load the plugin with this command: > + packadd nohlsearch +< +Automatically execute |:nohlsearch| after 'updatetime' or getting into +|Insert| mode. +Thus assuming default updatetime, hlsearch would be suspended/turned off after +4 seconds of idle time. + +To disable the effect of the plugin after it has been loaded: > + au! nohlsearch +< + + More information about packages can be found here: |packages|. ============================================================================== diff --git a/runtime/doc/usr_41.txt b/runtime/doc/usr_41.txt index 60d0d1e..765eab5 100644 --- a/runtime/doc/usr_41.txt +++ b/runtime/doc/usr_41.txt @@ -798,6 +798,7 @@ String manipulation: *string-functions* execute() execute an Ex command and get the output win_execute() like execute() but in a specified window trim() trim characters from a string + bindtextdomain() set message lookup translation base path gettext() lookup message translation List manipulation: *list-functions* @@ -1319,6 +1320,7 @@ Popup window: *popup-window-functions* popup_move() change the position and size of a popup popup_setoptions() override options of a popup popup_settext() replace the popup buffer contents + popup_setbuf() set the popup buffer popup_close() close one popup popup_clear() close all popups popup_filter_menu() select from a list of items @@ -1406,6 +1408,8 @@ Various: *various-functions* wordcount() get byte/word/char count of buffer + id() get unique string for item to use as a key + luaeval() evaluate |Lua| expression mzeval() evaluate |MzScheme| expression perleval() evaluate Perl expression (|+perl|) diff --git a/runtime/doc/various.txt b/runtime/doc/various.txt index 1ce8927..acd7991 100644 --- a/runtime/doc/various.txt +++ b/runtime/doc/various.txt @@ -1,4 +1,4 @@ -*various.txt* For Vim version 9.1. Last change: 2024 Jun 17 +*various.txt* For Vim version 9.1. Last change: 2024 Jul 17 VIM REFERENCE MANUAL by Bram Moolenaar @@ -19,9 +19,8 @@ CTRL-L Clear and redraw the screen. The redraw may happen *:redr* *:redraw* :redr[aw][!] Redraw the screen right now. When ! is included it is cleared first. - Useful to update the screen halfway executing a script - or function. Also when halfway a mapping and - 'lazyredraw' is set. + It can be used to redraw the screen in a script + or function (or a mapping if |'lazyredraw'| is set). *:redraws* *:redrawstatus* :redraws[tatus][!] Redraw the status line of the current window. When ! diff --git a/runtime/doc/version9.txt b/runtime/doc/version9.txt index 5b5bded..fc07dc4 100644 --- a/runtime/doc/version9.txt +++ b/runtime/doc/version9.txt @@ -1,4 +1,4 @@ -*version9.txt* For Vim version 9.1. Last change: 2024 Jun 17 +*version9.txt* For Vim version 9.1. Last change: 2024 Aug 23 VIM REFERENCE MANUAL by Bram Moolenaar @@ -41554,7 +41554,7 @@ Enum support for Vim9 script |:enum| *new-other-9.2* Other new features ~ ------------------ -The comment plugin |comment-install| is included. +The new plugins |comment-install| and |nohlsearch-install| are included. Support for Wayland UI. @@ -41563,6 +41563,12 @@ Support for the XDG Desktop Specification |xdg-base-dir| Support highlighting the matched text for insert-mode completion and command-line completion in |ins-completion-menu|. +Support highlighting the completion kind in |ins-completion-menu|, see +|complete-items|. + +Support for translating messages in Vim script plugins using the |gettext()| +and |bindtextdomain()| functions. + *changed-9.2* Changed~ ------- @@ -41571,6 +41577,25 @@ Changed~ - the default for 'commentstring' contains whitespace padding to have automatic comments look nicer |comment-install| - 'completeopt' is now a |global-local| option. +- 'nrformat' accepts the new "blank" suboption, to determine a signed or + unsigned number based on whitespace in front of a minus sign. +- allow to specify a priority when defining a new sign |:sign-define| +- provide information about function arguments using the get(func, "arity") + function |get()-func| +- |:bwipe| also wipes jumplist and tagstack data +- moving in the buffer list using |:bnext| and similar commands, behaves as + documented and skips help buffers (if not run from a help buffer, else + moves to the next/previous help buffer). +- allow to complete directories from 'cdpath' for |:cd| and similar commands, + add the "cd_in_path" completion type for e.g. |:command-complete| and + |getcompletion()| +- add 'cpoptions' flag "z" |cpo-z|, to disable some (traditional) vi + behaviour/inconsistency (see |d-special| and |cw|). +- allow to specify additional attributes in the completion menu (allows to + mark deprecated attributes from LSP server) |complete-items| +- the regex engines match correctly case-insensitive multi-byte characters + (and apply proper case folding) +- |:keeppatterns| preserves the last substitute pattern when used with |:s| *added-9.2* Added ~ @@ -41579,17 +41604,23 @@ Various syntax, indent and other plugins were added. Functions: ~ +|bindtextdomain()| set message lookup translation base path |diff()| diff two Lists of strings |filecopy()| copy a file {from} to {to} |foreach()| apply function to List items |getregion()| get a region of text from a buffer |getregionpos()| get a list of positions for a region +|id()| get unique identifier for a Dict, List, Object, + Channel or Blob variable |matchbufline()| all the matches of a pattern in a buffer |matchstrlist()| all the matches of a pattern in a List of strings +|popup_setbuf()| switch to a different buffer in a popup Autocommands: ~ +|CursorMovedC| after the cursor was moved in the comamnd-line +|KeyInputPre| before processing any key event in any mode |SessionWritePost| after writing the session file |:mksession| |TermResponseAll| after the terminal response to |t_RV| and others is received @@ -41611,6 +41642,7 @@ Commands: ~ Options: ~ 'winfixbuf' Keep buffer focused in a window +'tabclose' Which tab page to focus after closing a tab page 't_xo' Terminal uses XON/XOFF handshaking (e.g. vt420) 't_CF' Support for alternate font highlighting terminal code @@ -41633,7 +41665,8 @@ Improved visual highlighting. Python3 support in OpenVMS. -Support |fuzzy-matching| during |ins-completion| with "fuzzy" item for 'completeopt' +Support for |fuzzy-matching| during |ins-completion| with the "fuzzy" +values of the 'completeopt' setting ============================================================================== COMPILE TIME CHANGES *compile-changes-9.2* @@ -41642,6 +41675,8 @@ Support for building with Ruby 3.3. Support for building Vim 9 in z/OS (MVS). +Clean-up old MS-Windows code. + ============================================================================== PATCHES *patches-9.2* *bug-fixes-9.2* *patches-after-9.1* diff --git a/runtime/doc/vim-it.1 b/runtime/doc/vim-it.1 index 7ecd9f4..66e17dc 100644 --- a/runtime/doc/vim-it.1 +++ b/runtime/doc/vim-it.1 @@ -1,4 +1,4 @@ -.TH VIM 1 "4 giugno 2024" +.TH VIM 1 "12 agosto 2024" .SH NOME vim \- VI Migliorato, un editor di testi per programmatori .SH SINTASSI @@ -31,7 +31,7 @@ vim \- VI Migliorato, un editor di testi per programmatori .B rgview .SH DESCRIZIONE .B Vim -Un editore di testi, compatibile con, e migliore di, Vi. + un editore di testi, compatibile con, e migliore di, Vi. Pu essere usato per editare qualsiasi file di testo. Particolarmente utile per editare programmi. .PP @@ -150,18 +150,6 @@ Esempio: vim "+set si" main.c .br Note: Si possono avere fino a 10 comandi "+" o "\-c". .TP -\-S {file} -I comandi contenuti in {file} sono eseguiti dopo la lettura del primo file. -Equivalente a \-c "source {file}". -{file} non pu avere un nome che inizia per '\-'. -Se {file} omesso si usa "Session.vim" (funziona solo se \-S l'ultimo -argomento specificato). -.TP -\-\-cmd {comando} -Come "\-c", ma il comando eseguito PRIMA -di eseguire qualsiasi file vimrc. -Si possono usare fino a 10 di questi comandi, indipendentemente dai comandi "\-c". -.TP \-A Se .B Vim @@ -224,11 +212,6 @@ Opzione da usare quando sessione di edit (p.es., mail). Sull'Amiga i comandi ":sh" e ":!" non sono disponibili. .TP -\-\-nofork -Direttamente [Foreground]. Per la versione GUI, -.B Vim -non crea [fork] una nuova finestra, indipendente dalla shell di invocazione. -.TP \-F Se .B Vim @@ -239,6 +222,8 @@ in Modo Farsi, cio impostando 'fkmap' e 'rightleft'. Altrimenti viene dato un messaggio di errore e .B Vim termina in modo anormale. +.br +Nota: Il supporto Farsi stato rimosso a partire dalla patch 8.1.0932. .TP \-g Se @@ -248,19 +233,6 @@ Se Vim stato compilato senza supporto GUI viene dato un messaggio di errore e .B Vim termina in modo anormale. .TP -\-\-gui-dialog-file {nome} -Quando si usa la GUI, invece di visualizzare un dialogo, il titolo e il -messaggio del dialogo sono scritti sul file {nome}. Il file viene creato o, -se gi esistente, viene esteso. Quest'opzione serve solo in fase di test, -per evitare di restare bloccati da un dialogo che non si riesce a visualizzare. -Se si sta lavorando senza la GUI l'argomento viene ignorato. -.TP -\-\-help, \-h, \-? -Un po' di aiuto su opzioni e argomenti che si possono dare invocando Vim. -Subito dopo -.B Vim -esce. -.TP \-H Se .B Vim @@ -278,13 +250,13 @@ del file da usare invece di quello predefinito "~/.viminfo". Si pu anche evitare l'uso di un file .viminfo, dando come nome "NONE". .TP -\-L -Equivalente a \-r. -.TP \-l Modo Lisp. Imposta le opzioni 'lisp' e 'showmatch'. .TP +\-L +Equivalente a \-r. +.TP \-m Inibisce modifica file. Inibisce l'opzione 'write'. @@ -295,6 +267,13 @@ Modifiche non permesse. Le opzioni 'modifiable' e 'write' sono annullate, in modo da impedire sia modifiche che riscritture. Da notare che queste opzioni possono essere abilitate in seguito, permettendo cos modifiche. .TP +\-n +Inibisce l'uso di un file di swap. +Il recupero dopo una caduta di macchina sar impossibile. +Utile per editare un file su un supporto molto lento (p.es., floppy). +Il comando ":set uc=0" ha lo stesso effetto. +Per abilitare il recupero usare ":set uc=200". +.TP \-N Modo "Non-compatibile". Annulla l'opzione 'compatible'. Cos @@ -302,13 +281,6 @@ Cos si comporta un po' meglio, ma meno compatibile con Vi, anche in assenza di un file .vimrc. .TP -\-n -Inibisce l'uso di un file di swap. -Il recupero dopo una caduta di macchina diventa impossibile. -Utile per editare un file su un supporto molto lento (p.es., floppy). -Il comando ":set uc=0" ha lo stesso effetto. -Per abilitare il recupero usare ":set uc=200". -.TP \-nb Diviene un Editor server per NetBeans. Vedere la documentazione per dettagli. .TP @@ -331,6 +303,16 @@ Vim viene eseguito in una finestra MDI (Multiple-Document Interface). che sia sufficientemente esplicativo. Notare che l'implementazione ancora rudimentale. Non funziona per tutte le applicazioni, e il men non funziona. .TP +\-r +Lista file di swap, e informazioni su come usarli per ripristinare file. +.TP +\-r {file} +Modo Recovery (ripristino). +Il file di swap usato per recuperare una sessione di edit finita male. +Il file di swap un file con lo stesso nome file del file di testo +editato, col suffisso ".swp". +Vedere ":help recovery". +.TP \-R Modo Read-only (Sola Lettura). Imposta l'opzione 'readonly'. @@ -342,16 +324,6 @@ L'opzione \-R implica anche l'opzione \-n (vedere sopra). L'opzione 'readonly' pu essere annullata con ":set noro". Vedere ":help 'readonly'". .TP -\-r -Lista file di swap, e informazioni su come usarli per ripristinare file. -.TP -\-r {file} -Modo Recovery (ripristino). -Il file di swap usato per recuperare una sessione di edit finita male. -Il file di swap un file con lo stesso nome file del file di testo -editato, col suffisso ".swp". -Vedere ":help recovery". -.TP \-s Modo silenzioso. Solo quando invocato come "Ex" o quando l'opzione "\-e" stata data prima dell'opzione "\-s". @@ -363,6 +335,13 @@ Lo stesso risultato si pu ottenere col comando ":source! {script_in_input}". Se la fine del file di input viene raggiunta prima che Vim termini, l'ulteriore input verr preso dalla tastiera. .TP +\-S {file} +I comandi contenuti in {file} sono eseguiti dopo la lettura del primo file. +Equivalente a \-c "source {file}". +{file} non pu avere un nome che inizia per '\-'. +Se {file} omesso si usa "Session.vim" (funziona solo se \-S l'ultimo +argomento specificato). +.TP \-T {terminale} Dice a .B Vim @@ -372,16 +351,6 @@ Dovrebbe essere un terminale noto a .B Vim (predefinito) o definito nei file termcap o terminfo. .TP -\-\-not-a-term -Da usare per specifica a -.B Vim -che l'utente consapevole che l'input e l'output non avvengono con un terminale -vero e proprio. Ci serve per evitare il messaggio di avvertimento e il ritardo -di due secondi che avverrebbero in assenza di questo argomento. -.TP -\-\-ttyfail -Quando stdin o stdout non sono un terminale (tty) esci subito da Vim. -.TP \-u {vimrc} Usa i comandi nel file {vimrc} per inizializzazioni. Tutte le altre inizializzazioni non sono eseguite. @@ -393,7 +362,13 @@ Vedere ":help initialization" da vim per ulteriori dettagli. Usa i comandi nel file {gvimrc} per inizializzazioni GUI. Tutte le altre inizializzazioni GUI non sono eseguite. Si possono anche omettere tutte le inizializzazioni GUI dando come nome "NONE". -Vedere ":help gui-init" da vim per ulteriori dettagli. +Vedere ":help gui\-init" da vim per ulteriori dettagli. +.TP +\-v +Inizia +.B Vim +in Modo Vi, come se il programma eseguibile fosse "vi". Questo ha +effetto solo quando Vim viene invocato con il nome "ex". .TP \-V[N] Verboso. Vim manda messaggi relativi ai file di script che esegue @@ -401,24 +376,10 @@ e quando legge o scrive un file viminfo. Il numero opzionale N il valore dell'opzione 'verbose'. Il valore predefinito 10. .TP \-V[N]{nome_file} -Comw \-V imposta 'verbosefile' a {nome_file}. Il risultato che i messaggi +Come \-V imposta 'verbosefile' a {nome_file}. Il risultato che i messaggi non sono visualizzati, ma scritti sul file {nome_file}. Il {nome_file} non deve iniziare con un numero. .TP -\-\-log {nome_file} -Se -.B Vim - stato compilato con le funzionalit eval e channel, inizia a registrare -e scrive le registrazioni a {nome_file}. Ci equivale a chiamare -.I ch_logfile({nome_file}, 'ao') -in una fase molto iniziale dell'avvio del programma. -.TP -\-v -Inizia -.B Vim -in Modo Vi, come se il programma eseguibile fosse "vi". Questo ha -effetto solo quando Vim viene invocato con il nome "ex". -.TP \-w{numero} Imposta l'opzione 'window' a {numero}. .TP @@ -434,7 +395,10 @@ Se il file {script_file} esiste, il testo immesso viene aggiunto in fondo. Come \-w, ma uno script file esistente viene sovrascritto. .TP \-x -Uso di cifratura nella scrittura dei file. Verr chiesta una chiave di cifratura. +Se +.B Vim + stato compilato con il supporto per la cifratura, usare cifratura +nella scrittura dei file. Verr chiesta una chiave di cifratura. .TP \-X Non connettersi al server X. Vim parte pi rapidamente, @@ -460,16 +424,54 @@ Si pu usare per editare un file il cui nome inizi per '-'. Richiede di non usare alcun file di personalizzazione (vimrc, plugin, etc.). Utile per verificare se un problema persiste invocando Vim "originale". .TP +\-\-cmd {comando} +Come "\-c", ma il comando eseguito subito PRIMA +di eseguire qualsiasi file vimrc. +Si possono usare fino a 10 di questi comandi, indipendentemente dai comandi "\-c". +.TP \-\-echo\-wid Solo per GUI GTK: Visualizza ID di Window su stdout. .TP +\-\-gui-dialog-file {nome} +Quando si usa la GUI, invece di visualizzare un dialogo, il titolo e il +messaggio del dialogo sono scritti sul file {nome}. Il file viene creato o, +se gi esistente, viene esteso. Quest'opzione serve solo in fase di test, +per evitare di restare bloccati da un dialogo che non si riesce a visualizzare. +Se si sta lavorando senza la GUI l'argomento viene ignorato. +.TP +\-\-help, \-h, \-? +Un po' di aiuto su opzioni e argomenti che si possono dare invocando Vim. +Subito dopo +.B Vim +esce. +.TP \-\-literal Considera i nomi passati come argomenti letterali, senza espandere metacaratteri. Non ha effetto in Unix, dove la shell espande comunque i metacaratteri. .TP +\-\-log {nome_file} +Se +.B Vim + stato compilato con le funzionalit eval e channel, inizia a registrare +e scrive le registrazioni a {nome_file}. Ci equivale a chiamare +.I ch_logfile({nome_file}, 'ao') +in una fase molto iniziale dell'avvio del programma. +.TP +\-\-nofork +Direttamente [Foreground]. Per la versione GUI, +.B Vim +non crea [fork] una nuova finestra, indipendente dalla shell di invocazione. +.TP \-\-noplugin Non caricare plugin. Implicito se si specifica \-u NONE. .TP +\-\-not\-a\-term +Da usare per specificare a +.B Vim +che l'utente consapevole che l'input e l'output non avvengono con un terminale +vero e proprio. Ci serve per evitare il messaggio di avvertimento e il ritardo +di due secondi che avverrebbero in assenza di questo argomento. +.TP \-\-remote Connettersi a un server Vim e chiedere di editare i file elencati come altri argomenti. Se non si trova un server viene dato un messaggio e i file sono @@ -498,16 +500,19 @@ Usa {nome} come nome server. Usato per il Vim corrente, a meno che sia usato con l'argomento \-\-remote, nel qual caso indica il server a cui connettersi. .TP \-\-socketid {id} -Solo per GUI GTK: Usa meccanismo GtkPlug per eseguire gvim in un'altra finestra. +Solo per GUI GTK: Usa meccanismo GtkPlug per eseguire gVim in un'altra finestra. .TP \-\-startuptime {nome_file} Durante la fase iniziale, scrive messaggi di log al file {nome_file}. .TP +\-\-ttyfail +Quando stdin o stdout non sono un terminale (tty) esce subito da Vim. +.TP \-\-version Stampa la versione di Vim ed esce. .TP \-\-windowid {id} -Solo per GUI Win32: Chiede a gvim di provare a user l'ID di window {id} +Solo per GUI Win32: Chiede a gVim di provare a user l'ID di window {id} come padre, in modo da venir eseguito all'interno della finestra specificata. .SH AIUTO ONLINE Battere ":help" in @@ -555,13 +560,17 @@ Inizializzazioni personali di Inizializzazioni gvim a livello di sistema. .TP ~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc -Inizializzazioni personali di gvim (viene utilizzata la prima trovata). +Inizializzazioni personali di +.B gVim +(viene utilizzata la prima trovata). .TP /usr/local/share/vim/optwin.vim Script Vim usato dal comando ":options", maniera elegante per visualizzare e impostare opzioni. .TP /usr/local/share/vim/vim??/menu.vim -Inizializzazioni del men gvim a livello di sistema. +Inizializzazioni del men +.B gVim +a livello di sistema. .TP /usr/local/share/vim/vim??/bugreport.vim Script Vim per generare una segnalazione di errore. Vedere ":help bugs". diff --git a/runtime/doc/vim-it.UTF-8.1 b/runtime/doc/vim-it.UTF-8.1 index c9b5835..76e3db2 100644 --- a/runtime/doc/vim-it.UTF-8.1 +++ b/runtime/doc/vim-it.UTF-8.1 @@ -1,4 +1,4 @@ -.TH VIM 1 "4 giugno 2024" +.TH VIM 1 "12 agosto 2024" .SH NOME vim \- VI Migliorato, un editor di testi per programmatori .SH SINTASSI @@ -31,7 +31,7 @@ vim \- VI Migliorato, un editor di testi per programmatori .B rgview .SH DESCRIZIONE .B Vim -Un editore di testi, compatibile con, e migliore di, Vi. +è un editore di testi, compatibile con, e migliore di, Vi. Può essere usato per editare qualsiasi file di testo. Particolarmente utile per editare programmi. .PP @@ -150,18 +150,6 @@ Esempio: vim "+set si" main.c .br Note: Si possono avere fino a 10 comandi "+" o "\-c". .TP -\-S {file} -I comandi contenuti in {file} sono eseguiti dopo la lettura del primo file. -Equivalente a \-c "source {file}". -{file} non può avere un nome che inizia per '\-'. -Se {file} è omesso si usa "Session.vim" (funziona solo se \-S è l'ultimo -argomento specificato). -.TP -\-\-cmd {comando} -Come "\-c", ma il comando è eseguito PRIMA -di eseguire qualsiasi file vimrc. -Si possono usare fino a 10 di questi comandi, indipendentemente dai comandi "\-c". -.TP \-A Se .B Vim @@ -224,11 +212,6 @@ Opzione da usare quando sessione di edit (p.es., mail). Sull'Amiga i comandi ":sh" e ":!" non sono disponibili. .TP -\-\-nofork -Direttamente [Foreground]. Per la versione GUI, -.B Vim -non crea [fork] una nuova finestra, indipendente dalla shell di invocazione. -.TP \-F Se .B Vim @@ -239,6 +222,8 @@ in Modo Farsi, cioè impostando 'fkmap' e 'rightleft'. Altrimenti viene dato un messaggio di errore e .B Vim termina in modo anormale. +.br +Nota: Il supporto Farsi è stato rimosso a partire dalla patch 8.1.0932. .TP \-g Se @@ -248,19 +233,6 @@ Se Vim è stato compilato senza supporto GUI viene dato un messaggio di errore e .B Vim termina in modo anormale. .TP -\-\-gui-dialog-file {nome} -Quando si usa la GUI, invece di visualizzare un dialogo, il titolo e il -messaggio del dialogo sono scritti sul file {nome}. Il file viene creato o, -se già esistente, viene esteso. Quest'opzione serve solo in fase di test, -per evitare di restare bloccati da un dialogo che non si riesce a visualizzare. -Se si sta lavorando senza la GUI l'argomento viene ignorato. -.TP -\-\-help, \-h, \-? -Un po' di aiuto su opzioni e argomenti che si possono dare invocando Vim. -Subito dopo -.B Vim -esce. -.TP \-H Se .B Vim @@ -278,13 +250,13 @@ del file da usare invece di quello predefinito "~/.viminfo". Si può anche evitare l'uso di un file .viminfo, dando come nome "NONE". .TP -\-L -Equivalente a \-r. -.TP \-l Modo Lisp. Imposta le opzioni 'lisp' e 'showmatch'. .TP +\-L +Equivalente a \-r. +.TP \-m Inibisce modifica file. Inibisce l'opzione 'write'. @@ -295,6 +267,13 @@ Modifiche non permesse. Le opzioni 'modifiable' e 'write' sono annullate, in modo da impedire sia modifiche che riscritture. Da notare che queste opzioni possono essere abilitate in seguito, permettendo così modifiche. .TP +\-n +Inibisce l'uso di un file di swap. +Il recupero dopo una caduta di macchina sarà impossibile. +Utile per editare un file su un supporto molto lento (p.es., floppy). +Il comando ":set uc=0" ha lo stesso effetto. +Per abilitare il recupero usare ":set uc=200". +.TP \-N Modo "Non-compatibile". Annulla l'opzione 'compatible'. Così @@ -302,13 +281,6 @@ Così si comporta un po' meglio, ma è meno compatibile con Vi, anche in assenza di un file .vimrc. .TP -\-n -Inibisce l'uso di un file di swap. -Il recupero dopo una caduta di macchina diventa impossibile. -Utile per editare un file su un supporto molto lento (p.es., floppy). -Il comando ":set uc=0" ha lo stesso effetto. -Per abilitare il recupero usare ":set uc=200". -.TP \-nb Diviene un Editor server per NetBeans. Vedere la documentazione per dettagli. .TP @@ -331,6 +303,16 @@ Vim viene eseguito in una finestra MDI (Multiple-Document Interface). che sia sufficientemente esplicativo. Notare che l'implementazione è ancora rudimentale. Non funziona per tutte le applicazioni, e il menù non funziona. .TP +\-r +Lista file di swap, e informazioni su come usarli per ripristinare file. +.TP +\-r {file} +Modo Recovery (ripristino). +Il file di swap è usato per recuperare una sessione di edit finita male. +Il file di swap è un file con lo stesso nome file del file di testo +editato, col suffisso ".swp". +Vedere ":help recovery". +.TP \-R Modo Read-only (Sola Lettura). Imposta l'opzione 'readonly'. @@ -342,16 +324,6 @@ L'opzione \-R implica anche l'opzione \-n (vedere sopra). L'opzione 'readonly' può essere annullata con ":set noro". Vedere ":help 'readonly'". .TP -\-r -Lista file di swap, e informazioni su come usarli per ripristinare file. -.TP -\-r {file} -Modo Recovery (ripristino). -Il file di swap è usato per recuperare una sessione di edit finita male. -Il file di swap è un file con lo stesso nome file del file di testo -editato, col suffisso ".swp". -Vedere ":help recovery". -.TP \-s Modo silenzioso. Solo quando invocato come "Ex" o quando l'opzione "\-e" è stata data prima dell'opzione "\-s". @@ -363,6 +335,13 @@ Lo stesso risultato si può ottenere col comando ":source! {script_in_input}". Se la fine del file di input viene raggiunta prima che Vim termini, l'ulteriore input verrà preso dalla tastiera. .TP +\-S {file} +I comandi contenuti in {file} sono eseguiti dopo la lettura del primo file. +Equivalente a \-c "source {file}". +{file} non può avere un nome che inizia per '\-'. +Se {file} è omesso si usa "Session.vim" (funziona solo se \-S è l'ultimo +argomento specificato). +.TP \-T {terminale} Dice a .B Vim @@ -372,16 +351,6 @@ Dovrebbe essere un terminale noto a .B Vim (predefinito) o definito nei file termcap o terminfo. .TP -\-\-not-a-term -Da usare per specifica a -.B Vim -che l'utente è consapevole che l'input e l'output non avvengono con un terminale -vero e proprio. Ciò serve per evitare il messaggio di avvertimento e il ritardo -di due secondi che avverrebbero in assenza di questo argomento. -.TP -\-\-ttyfail -Quando stdin o stdout non sono un terminale (tty) esci subito da Vim. -.TP \-u {vimrc} Usa i comandi nel file {vimrc} per inizializzazioni. Tutte le altre inizializzazioni non sono eseguite. @@ -393,7 +362,13 @@ Vedere ":help initialization" da vim per ulteriori dettagli. Usa i comandi nel file {gvimrc} per inizializzazioni GUI. Tutte le altre inizializzazioni GUI non sono eseguite. Si possono anche omettere tutte le inizializzazioni GUI dando come nome "NONE". -Vedere ":help gui-init" da vim per ulteriori dettagli. +Vedere ":help gui\-init" da vim per ulteriori dettagli. +.TP +\-v +Inizia +.B Vim +in Modo Vi, come se il programma eseguibile fosse "vi". Questo ha +effetto solo quando Vim viene invocato con il nome "ex". .TP \-V[N] Verboso. Vim manda messaggi relativi ai file di script che esegue @@ -401,24 +376,10 @@ e quando legge o scrive un file viminfo. Il numero opzionale N è il valore dell'opzione 'verbose'. Il valore predefinito è 10. .TP \-V[N]{nome_file} -Comw \-V imposta 'verbosefile' a {nome_file}. Il risultato è che i messaggi +Come \-V imposta 'verbosefile' a {nome_file}. Il risultato è che i messaggi non sono visualizzati, ma scritti sul file {nome_file}. Il {nome_file} non deve iniziare con un numero. .TP -\-\-log {nome_file} -Se -.B Vim -è stato compilato con le funzionalità eval e channel, inizia a registrare -e scrive le registrazioni a {nome_file}. Ciò equivale a chiamare -.I ch_logfile({nome_file}, 'ao') -in una fase molto iniziale dell'avvio del programma. -.TP -\-v -Inizia -.B Vim -in Modo Vi, come se il programma eseguibile fosse "vi". Questo ha -effetto solo quando Vim viene invocato con il nome "ex". -.TP \-w{numero} Imposta l'opzione 'window' a {numero}. .TP @@ -434,7 +395,10 @@ Se il file {script_file} esiste, il testo immesso viene aggiunto in fondo. Come \-w, ma uno script file esistente viene sovrascritto. .TP \-x -Uso di cifratura nella scrittura dei file. Verrà chiesta una chiave di cifratura. +Se +.B Vim +è stato compilato con il supporto per la cifratura, usare cifratura +nella scrittura dei file. Verrà chiesta una chiave di cifratura. .TP \-X Non connettersi al server X. Vim parte più rapidamente, @@ -460,16 +424,54 @@ Si può usare per editare un file il cui nome inizi per '-'. Richiede di non usare alcun file di personalizzazione (vimrc, plugin, etc.). Utile per verificare se un problema persiste invocando Vim "originale". .TP +\-\-cmd {comando} +Come "\-c", ma il comando è eseguito subito PRIMA +di eseguire qualsiasi file vimrc. +Si possono usare fino a 10 di questi comandi, indipendentemente dai comandi "\-c". +.TP \-\-echo\-wid Solo per GUI GTK: Visualizza ID di Window su stdout. .TP +\-\-gui-dialog-file {nome} +Quando si usa la GUI, invece di visualizzare un dialogo, il titolo e il +messaggio del dialogo sono scritti sul file {nome}. Il file viene creato o, +se già esistente, viene esteso. Quest'opzione serve solo in fase di test, +per evitare di restare bloccati da un dialogo che non si riesce a visualizzare. +Se si sta lavorando senza la GUI l'argomento viene ignorato. +.TP +\-\-help, \-h, \-? +Un po' di aiuto su opzioni e argomenti che si possono dare invocando Vim. +Subito dopo +.B Vim +esce. +.TP \-\-literal Considera i nomi passati come argomenti letterali, senza espandere metacaratteri. Non ha effetto in Unix, dove la shell espande comunque i metacaratteri. .TP +\-\-log {nome_file} +Se +.B Vim +è stato compilato con le funzionalità eval e channel, inizia a registrare +e scrive le registrazioni a {nome_file}. Ciò equivale a chiamare +.I ch_logfile({nome_file}, 'ao') +in una fase molto iniziale dell'avvio del programma. +.TP +\-\-nofork +Direttamente [Foreground]. Per la versione GUI, +.B Vim +non crea [fork] una nuova finestra, indipendente dalla shell di invocazione. +.TP \-\-noplugin Non caricare plugin. Implicito se si specifica \-u NONE. .TP +\-\-not\-a\-term +Da usare per specificare a +.B Vim +che l'utente è consapevole che l'input e l'output non avvengono con un terminale +vero e proprio. Ciò serve per evitare il messaggio di avvertimento e il ritardo +di due secondi che avverrebbero in assenza di questo argomento. +.TP \-\-remote Connettersi a un server Vim e chiedere di editare i file elencati come altri argomenti. Se non si trova un server viene dato un messaggio e i file sono @@ -498,16 +500,19 @@ Usa {nome} come nome server. Usato per il Vim corrente, a meno che sia usato con l'argomento \-\-remote, nel qual caso indica il server a cui connettersi. .TP \-\-socketid {id} -Solo per GUI GTK: Usa meccanismo GtkPlug per eseguire gvim in un'altra finestra. +Solo per GUI GTK: Usa meccanismo GtkPlug per eseguire gVim in un'altra finestra. .TP \-\-startuptime {nome_file} Durante la fase iniziale, scrive messaggi di log al file {nome_file}. .TP +\-\-ttyfail +Quando stdin o stdout non sono un terminale (tty) esce subito da Vim. +.TP \-\-version Stampa la versione di Vim ed esce. .TP \-\-windowid {id} -Solo per GUI Win32: Chiede a gvim di provare a user l'ID di window {id} +Solo per GUI Win32: Chiede a gVim di provare a user l'ID di window {id} come padre, in modo da venir eseguito all'interno della finestra specificata. .SH AIUTO ONLINE Battere ":help" in @@ -555,13 +560,17 @@ Inizializzazioni personali di Inizializzazioni gvim a livello di sistema. .TP ~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc -Inizializzazioni personali di gvim (viene utilizzata la prima trovata). +Inizializzazioni personali di +.B gVim +(viene utilizzata la prima trovata). .TP /usr/local/share/vim/optwin.vim Script Vim usato dal comando ":options", maniera elegante per visualizzare e impostare opzioni. .TP /usr/local/share/vim/vim??/menu.vim -Inizializzazioni del menù gvim a livello di sistema. +Inizializzazioni del menù +.B gVim +a livello di sistema. .TP /usr/local/share/vim/vim??/bugreport.vim Script Vim per generare una segnalazione di errore. Vedere ":help bugs". diff --git a/runtime/doc/vim-ja.UTF-8.1 b/runtime/doc/vim-ja.UTF-8.1 index e18211e..2a6db2f 100644 --- a/runtime/doc/vim-ja.UTF-8.1 +++ b/runtime/doc/vim-ja.UTF-8.1 @@ -1,4 +1,4 @@ -.TH VIM 1 "2021 Jun 13" +.TH VIM 1 "2024 Aug 03" .SH 名前 vim \- Vi IMproved, プログラマのテキストエディタ .SH 書式 @@ -170,7 +170,7 @@ Note: "+" と "\-c" は合わせて 10 個まで指定できます。 指定されたファイルが開かれ、それらのファイルの差分が表示されます。 vimdiff(1) と同様の動作です。 .TP -\-d {device} +\-d {device}, \-dev {device} {device} を端末として開きます。 Amiga でのみ使います。 例: @@ -208,7 +208,13 @@ Amiga では、":sh" と "!" コマンドは機能しなくなります。 GUI がサポートされている場合は、GUI で起動します。 サポートされていない場合はエラーメッセージを表示して終了します。 .TP -\-h +\-\-gui-dialog-file {name} +GUI の使用時、ダイアログを表示する代わりとして、ファイル {name} へダイアログのタイトルとメッセージを書き込みます。 +ファイルは作成されるか追記されます。 +テストにみ有用で、見ることができないダイアログによってテストが中断されるのを防ぎます。 +GUI 以外ではこの引数は無視されます。 +.TP +\-\-help, \-h, \-? コマンドライン引数やオプションのヘルプを表示して終了します。 .TP \-H @@ -266,6 +272,12 @@ N を省略した場合は、引数のファイルを個別のウィンドウで N 個のタブページを開きます。 N を省略した場合は、引数のファイルを個別のタブページで開きます。 .TP +\-P {parent-title} +Win32 のみ。親になるアプリケーションのタイトルを指定します。 +可能であれば Vim はその MDI アプリケーションのウィンドウ内で起動します。 +{parent-title} が親アプリケーションのウィンドウのタイトルに使われていて、明確に区別できる必要があります。 +Note: まだ簡単に実装されているだけです。全てのアプリケーションで動くわけではありません。メニューは機能しません。 +.TP \-R 読み込み専用モード。 オプション 'readonly' がオンになります。 @@ -301,6 +313,15 @@ N を省略した場合は、引数のファイルを個別のタブページで が組み込みでサポートしている名前か、 termcap または terminfo ファイルで定義されている名前を指定してください。 .TP +\-\-not-a-term +入力と出力(もしくはどちらか一方)が端末に接続されていないことを、ユーザーが把握しているということを +.B Vim +に伝えます。 +これにより警告が表示され 2 秒間の遅延が発生するのを避けられます。 +.TP +\-\-ttyfail +標準入力か標準出力が端末 (tty) でない場合、すぐに終了します。 +.TP \-u {vimrc} {vimrc} ファイルを使って初期化します。 他の初期化処理はスキップされます。 @@ -320,11 +341,27 @@ termcap または terminfo ファイルで定義されている名前を指定 N に指定した数値が 'verbose' に設定されます。 省略した場合は 10 になります。 .TP +\-V[N]{filename} +-V と同様で、さらに 'verbosefile' を {filename} に設定します。 +その結果、メッセージは表示されずにファイル {filename} に書き出されます。 +{filename} は数字で始まってはいけません。 +.TP +\-\-log {filename} +もし +.B Vim +がチャネル機能付きでコンパイルされている場合、ログの出力を開始し、ファイル {filename} に書き込みます。 +これは、起動時の非常に早い段階で +.I ch_logfile({filename}, 'ao') +を呼び出すのと同様な動作です。 +.TP \-v Vi モードで起動します。 実行ファイルの名前が "vi" の場合と同じです。 実行ファイルの名前が "ex" の場合だけ効果があります。 .TP +\-w{number} +オプション 'window' を {number} に設定します。 +.TP \-w {scriptout} 入力した文字を {scriptout} に記録します。 "vim \-s" や "source!" で実行するためのスクリプトファイルを作成するのに便利です。 @@ -334,7 +371,9 @@ Vi モードで起動します。 \-w と同じですが、ファイルがすでに存在した場合は上書きされます。 .TP \-x -ファイルを暗号化して書き込みます。暗号化キーの入力プロンプトが表示されます。 +.B Vim +が暗号化機能付きでコンパイルされている場合、ファイルを暗号化して書き込みます。 +暗号化キーの入力プロンプトが表示されます。 .TP \-X X サーバーと通信しません。端末での起動時間を短くできます。 @@ -362,9 +401,6 @@ X サーバーと通信しません。端末での起動時間を短くできま \-\-echo\-wid GTK GUI のみ: Window ID を標準出力に出力します。 .TP -\-\-help -ヘルプを表示して終了します。"\-h" と同じです。 -.TP \-\-literal 引数のファイル名をリテラル文字列として扱います。ワイルドカードを展開しません。 Unix のように、シェルがワイルドカードを展開する場合は機能しません。 @@ -406,6 +442,10 @@ GTK GUI のみ: GtkPlug メカニズムを使って gvim を別のウィンド .TP \-\-version バージョン情報を表示して終了します。 +.TP +\-\-windowid {id} +Win32 GUI の Vim のみ。ウィンドウ {id} を親ウィンドウにしようと試みます。 +成功するとそのウィンドウの内側で起動します。 .SH オンラインヘルプ ヘルプを開くには、 .B Vim @@ -420,53 +460,58 @@ GTK GUI のみ: GtkPlug メカニズムを使って gvim を別のウィンド 例: ":help syntax.txt"。 .SH ファイル .TP 15 -/usr/local/lib/vim/doc/*.txt +/usr/local/share/vim/vim??/doc/*.txt .B Vim のヘルプファイル。 ファイルの一覧は ":help doc\-file\-list" に記載されています。 +.br +.I vim?? +は短いバージョン番号で +.B Vim 9.1 +では vim91 です。 .TP -/usr/local/lib/vim/doc/tags +/usr/local/share/vim/vim??/doc/tags ヘルプを検索するための tags ファイル。 .TP -/usr/local/lib/vim/syntax/syntax.vim +/usr/local/share/vim/vim??/syntax/syntax.vim システムの構文定義初期化ファイル。 .TP -/usr/local/lib/vim/syntax/*.vim +/usr/local/share/vim/vim??/syntax/*.vim いろいろな言語用の構文定義ファイル。 .TP -/usr/local/lib/vim/vimrc +/usr/local/share/vim/vimrc システムの .B Vim 初期化ファイル。 .TP -~/.vimrc +~/.vimrc, ~/.vim/vimrc, $XDG_CONFIG_HOME/vim/vimrc ユーザーの .B Vim -初期化ファイル。 +初期化ファイル。(最初のものが使われます。) .TP -/usr/local/lib/vim/gvimrc +/usr/local/share/vim/gvimrc システムの gvim 初期化ファイル。 .TP -~/.gvimrc -ユーザーの gvim 初期化ファイル。 +~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc +ユーザーの gvim 初期化ファイル。(最初のものが使われます。) .TP -/usr/local/lib/vim/optwin.vim +/usr/local/share/vim/vim??/optwin.vim ":options" コマンドで使われるファイル。 オプションを表示したり設定したりできます。 .TP -/usr/local/lib/vim/menu.vim +/usr/local/share/vim/vim??/menu.vim システムのメニュー初期化ファイル。gvim で使います。 .TP -/usr/local/lib/vim/bugreport.vim +/usr/local/share/vim/vim??/bugreport.vim バグレポートを生成するスクリプト。":help bugs" 参照。 .TP -/usr/local/lib/vim/filetype.vim +/usr/local/share/vim/vim??/filetype.vim ファイル名からファイルタイプを判定するスクリプト。":help 'filetype'" 参照。 .TP -/usr/local/lib/vim/scripts.vim +/usr/local/share/vim/vim??/scripts.vim ファイルの内容からファイルタイプを判定するスクリプト。":help 'filetype'" 参照。 .TP -/usr/local/lib/vim/print/*.ps +/usr/local/share/vim/vim??/print/*.ps PostScript 印刷に使われるファイル。 .PP 最新の情報は VIM のホームページを参照してください: diff --git a/runtime/doc/vim-ru.1 b/runtime/doc/vim-ru.1 index dfcb3ec..4aa4887 100644 --- a/runtime/doc/vim-ru.1 +++ b/runtime/doc/vim-ru.1 @@ -1,19 +1,20 @@ -.TH VIM 1 "2002 Feb 22" -.SH -vim \- Vi IMproved ( Vi), -.SH +.TH VIM 1 "12 2024" +.SH + Vim \[em] Vi IMproved ( Vi), +. +.SH .br .B vim -[] [ ..] +[] [ ...] .br .B vim -[] \- +[] \- .br .B vim -[] \-t +[] \-t .br .B vim -[] \-q [ ] +[] \-q [ ] .PP .br .B ex @@ -22,468 +23,669 @@ vim \- Vi IMproved ( Vi), .br .B gvim .B gview +.B evim +.B eview .br .B rvim .B rview .B rgvim .B rgview .SH + .B Vim --- , - Vi. - . - . +\[em] , Vi. + . + . .PP - Vi, + Vi, .B Vim - : , + : , , , , - ͣ , , .. -. ":help vi_diff.txt" + , , + . +. ":help vi_diff.txt" + .B Vim - Vi. + Vi. .PP - -.B Vim - ( ":help"). -. " " . + +.B Vim, + , + ":help". +. " " . .PP - + .B Vim .PP vim .PP - + .B Vim : .PP - vim [] [ ] + vim [] [] .PP - , Σ . - ң : + , + . + ң : .TP 12 - .. - ͣ . - . ݣ - . ̣ - ":next". , -"" (-), "--". + ... + . + , + . + ̣ ":next". , + "" (\-), + "\-\-". .TP \- - . - (stderr), -. -.TP -\-t {} - "", goto. -{} , , - . - , {} -. -, , , . -. ":help tag-commands". -.TP -\-q [ ] - . - [ ] . - [ ] , ң 'errorfile' -( : "AztecC.Err" Amiga, "errors.err" ). - ":cn". + . + (stderr), + . +.TP +\-t {} + "", + goto. {} +, + {} . + , {} + . +, , , + . +. ":help tag\-commands". +.TP +\-q [ ] + . + [ ] . + [ ] , ң + 'errorfile' ( Amiga "AztecC.Err", + \[em] "errors.err"). + ":cn". . ":help quickfix". .PP + .B Vim -ģ - ( - ). +ģ - + ( ). .TP 10 vim -"" , ӣ . + "" , ӣ . .TP ex - Ex. - ":vi". Ex - "\-e". + Ex-. , + ":vi". +Ex- "\-e". .TP view - " ". -. "\-R". + " ". + . + "\-R". .TP gvim gview - . . - "\-g". + . . + "\-g". +.TP +evim eview +ݣ . . + "\-y". .TP rvim rview rgvim rgview - , . - + , . + .B Vim. - "r" "\-Z". -.SH - , ͣ -. -. + "r" "\-Z". +.SH + , . +, , + . .TP 12 +[] - ݣ . - "" , ݣ . + [] . + . + "" , . .TP +/{} - ݣ - . . ":help search-pattern" - . + . + + . . ":help search\-pattern" +. .TP +{} .TP \-c {} -{} Ex. - {} , - ( ). -: vim "+set si" main.c + {}. + {} Ex-. + {} , + ( ). +: +vim "+set si" main.c .br -: "+" "\-c". -.TP -\-\-cmd {} - "\-c", - (vimrc). - , - "\-c". +. "+" "\-c". .TP \-A - + . + .B Vim - , - , , - + + , + .B Vim - , 'arabic'. - + , . . 'arabic'. + .B Vim - . + . .TP \-b - . - , + . + , . .TP \-C - . 'compatible'. + Vi. + 'compatible', .B Vim - Vi, .vimrc. + Vi, ".vimrc". .TP \-d - . - . + . + . .B Vim - -( vimdiff(1)). + ( vimdiff(1)). .TP -\-d {} - {} ( Amiga). +\-d {}, \-dev {} + {} -. + {} ( Amiga). : "\-d con:20/30/600/150". .TP +\-D + . + . +.TP \-e - + Ex-. + +.B Vim + Ex-, , + "ex". +.TP +\-E + Ex-. + .B Vim - Ex, "ex". + Ex-, + "exim". .TP \-f - . + . + .B Vim - - ţ . Amiga + +, . + Amiga .B Vim - . , - + . + , .B Vim , (, ). - Amiga ":sh" ":!" . -.TP -\-\-nofork - . -.B Vim - - ţ . + Amiga ":sh" ":!" . .TP \-F - + . + .B Vim - FKMAP - , + + , + .B Vim - , , ޣ -\&'fkmap' 'rightleft'. - + , . . 'fkmap' + 'rightleft'. + .B Vim - . + . +.br +. 8.1.0932. .TP \-g - + . + .B Vim - , - . + , + . + .B Vim - . -.TP -\-h - . - -.B Vim - . + . .TP \-H - + . + .B Vim - - , + + , + .B Vim - , , ޣ 'hkmap' 'rightleft'. - + , . . 'hkmap' + 'rightleft'. + .B Vim - . + . .TP -\-i {viminfo} - viminfo, ( -"~/.viminfo" ). viminfo -ԣ "NONE". -.TP -\-L - , \-r. +\-i {} + {}. + viminfo- ( + ".viminfo"). viminfo- + "NONE" ( ). .TP \-l - Lisp. 'lisp' 'showmatch'. + Lisp. + 'lisp' 'showmatch'. +.TP +\-L + , \-r. .TP \-m - . 'write', - . + . + 'write', + , ӣ . .TP -\-N - . 'compatible'. -.B Vim - , Vi, - (.vimrc). +\-M + . + 'modifiable' 'write' , +, . + , , +, . .TP \-n - -. . + . + . (, ). - ":set uc=0". -- ":set uc=200". + ":set uc=0". \[em] +":set uc=200". +.TP +\-N + Vi. + 'compatible'. + +.B Vim + , Vi, + (".vimrc"). +.TP +\-nb + Vim NetBeans. + . .TP \-o[N] - N , ̣ . N , - . + N , . + N , . .TP \-O[N] - N , ̣ . N , - . -.TP -\-R - " ". 'readonly'. - , - . - Ex (, ":w!"). - "\-R" , "\-n" (. ). - 'readonly' ":set noro". -. ":help 'readonly'". + N , . + N , . +.TP +\-p[N] + N . + N , . +.TP +\-P { } + . + MS Windows. . + , Vim +. { }. +, { } . , + ӣ ݣ . + . .TP \-r - - . + . + + . .TP \-r {} - . - -. -- , , ".swp". + ۣ . + . + , , + ".swp". . ":help recovery". .TP +\-R + . + 'readonly'. + , + . + Ex- (, ":w!"). + "\-R" , +"\-n" (. ). + 'readonly' ":set noro". +. ":help 'readonly'". +.TP \-s - . "Ex" "\-s" "\-e". + . + "ex" + "\-s" "\-e". +.TP +\-s { } + { }. + , + . + ":source! { }". + { } +, . +.TP +\-S {} + {}. + , {}. + \-c "source {}". + {} '\-'. + {}, "Session.vim" ( + \-S ). +.TP +\-T {} + {}. + +.B Vim + . + , + . +.B Vim +( ) termcap terminfo. +.TP +\-u {} + {}. + . + . + +, "NONE" ( ). +. ":help initialization". +.TP +\-U {} + + {}. + . + + , "NONE" ( ). +. ":help gui\-init". .TP -\-s {scriptin} - {scriptin}. , - , . - ":source! {scriptin}". - , - . +\-v + Vi. + +.B Vim + Vi, "vi". + "ex". +.TP +\-V[N] + . + , , + viminfo-. N + . + 10. +.TP +\-V[N]{} + \-V, 'verbosefile' + {}. , {}, + . {} - +. +.TP +\-w{} + 'window' , {}. +.TP +\-w {} + ģ {}. + , ģ +, {}. + , + "vim \-s" ":source!". + {} , . +.TP +\-W {} + ģ {}. + "\-w", {} . .TP -\-T {terminal} - -.B Vim - . , - . - +\-x + . + .B Vim -( ) termcap terminfo. -.TP -\-u {vimrc} - {vimrc} . - . - . - , - "NONE". . ":help initialization". + , . + . .TP -\-U {gvimrc} - {gvimrc} -. - . - , - "NONE". . ":help gui-init". -.TP -\-V -"" . , , -- viminfo. +\-X + X-. + , + . .TP -\-v - +\-y + ݣ . + +.B Vim + ݣ , +"evim" "eview". + .B Vim - Vi, "vi". - "ex". + , . .TP -\-w {scriptout} - , ģ , - {scriptout}. - , - "vim \-s" ":source!". {scriptout} , - . +\-Z + . + , , + "r". .TP -\-W {scriptout} - "\-w", . +\-\- + . + , . + , +. .TP -\-x - . . +\-\-clean + ( vimrc, + . .). , + Vim. .TP -\-X - X-. , - . +\-\-cmd {} + "\-c", + (vimrc). + , "\-c". .TP -\-Z - . , , "r". +\-\-echo\-wid + GTK. +(Window ID) (stdout). +.TP +\-\-gui\-dialog\-file {} + , + {} . + {} , , + {}. + , , + . + , . +.TP +\-\-help, \-h, \-? + . + +.B Vim + . +.TP +\-\-literal + , +, . + Unix- , + . +.TP +\-\-log {} + . + +.B Vim + "eval" "channel", + , {}. + +.I ch_logfile({filename}, 'ao') .TP -\-\- - . . - , . +\-\-nofork + . + +.B Vim + + , . .TP -\-\-help - . , "\-h". +\-\-noplugin + . + \-u NONE. .TP -\-\-version - . +\-\-not\-a\-term + -. + , - + . +, . .TP \-\-remote - Vim , - . , , - Vim. + Vim- , + . , +, Vim. .TP \-\-remote\-expr {} - Vim Σ {}. + Vim- {} +. (stdout). .TP -\-\-remote\-send {} - Vim {}. +\-\-remote\-send { } + Vim- { }. .TP \-\-remote\-silent "\-\-remote", , . .TP \-\-remote\-wait - "\-\-remote", Vim , - . + "\-\-remote", Vim , + . .TP \-\-remote\-wait\-silent "\-\-remote\-wait", , . .TP \-\-serverlist - Vim. + Vim-. .TP -\-\-servername {} - {} . -"\-\-remote" , {} Vim, - , -. +\-\-servername {} + {} . +"\-\-remote" , {} Vim, + , . .TP \-\-socketid {id} - GTK: GtkPlug - gvim . + GTK. GtkPlug + gVim . .TP -\-\-echo\-wid - GTK: (Window ID) - (stdout). -.SH - , ":help". - ":help ", . -, ":help ZZ" "ZZ". - <Tab> CTRL-D - (":help cmdline-completion"). - (- +\-\-startuptime {} + {}. +.TP +\-\-ttyfail + , - (tty). +.TP +\-\-version + . +.TP +\-\-windowid {} + MS Windows. gVim + {} , + . +.SH + , +.B Vim + ":help". + ":help ", . +, ":help ZZ" "ZZ". + <TAB> CTRL+D +(. ":help cmdline\-completion"). + (- , . ":help"). - , ":help syntax.txt". + , , ":help syntax.txt". .SH .TP 15 -/usr/local/lib/vim/doc/*.txt - +/usr/local/share/vim/vim??/doc/*.txt + .B Vim. -. ":help doc-file-list" . +. ":help doc\-file\-list" . +.br + +.I "vim??" + ݣ , , vim91 +.B Vim 9.1 .TP -/usr/local/lib/vim/doc/tags - , . +/usr/local/share/vim/vim??/doc/tags + , . .TP -/usr/local/lib/vim/syntax/syntax.vim - . +/usr/local/share/vim/vim??/syntax/syntax.vim + . .TP -/usr/local/lib/vim/syntax/*.vim - . +/usr/local/share/vim/vim??/syntax/*.vim + . .TP -/usr/local/lib/vim/vimrc - +/usr/local/share/vim/vimrc + .B Vim. .TP -/usr/local/lib/vim/gvimrc - . +~/.vimrc, ~/.vim/vimrc, $XDG_CONFIG_HOME/vim/vimrc + +.B Vim +( ). +.TP +/usr/local/share/vim/gvimrc + +.B gVim. +.TP +~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc + + +.B gVim +( ). .TP -/usr/local/lib/vim/optwin.vim -, ":options". - . +/usr/local/share/vim/vim??/optwin.vim + , ":options". + . .TP -/usr/local/lib/vim/menu.vim - gvim. +/usr/local/share/vim/vim??/menu.vim + +.B gVim. .TP -/usr/local/lib/vim/bugreport.vim - ޣ . . ":help bugs". +/usr/local/share/vim/vim??/bugreport.vim + ޣ . . ":help bugs". .TP -/usr/local/lib/vim/filetype.vim - . . ":help 'filetype'". +/usr/local/share/vim/vim??/filetype.vim + . +. ":help 'filetype'". .TP -/usr/local/lib/vim/scripts.vim - . . ":help 'filetype'". +/usr/local/share/vim/vim??/scripts.vim + . +. ":help 'filetype'". .TP -/usr/local/lib/vim/print/*.ps - PostScript. +/usr/local/share/vim/vim??/print/*.ps +, PostScript. .PP - -- VIM: + - VIM: .br <URL:http://www.vim.org/> -.SH +.SH vimtutor(1) .SH - + .B Vim - (Bram Moolenaar), - . . ":help credits" + (Bram Moolenaar), + . . ":help credits" .B Vim. .br + .B Vim Stevie, (Tim Thompson), (Tony Andrews) . . () (G.R. (Fred) Walter). -, Vim - . +, Vim + . .br - + .B Vim "", -. <URL:http://sourceforge.net/projects/ruvim/>. -.SH +. <URL:https://github.com/restorerz/ruvim/>. +.SH . -. ":help todo" -- . +. ":help todo" \[em] . .PP -, , , - Vi. +, , , + Vi. , - , "Vi -", vi_diff.txt -( ":help vi_diff.txt" Vim) 'compatible' - 'cpoptions'. +( ":help vi_diff.txt" Vim) + 'compatible' 'cpoptions'. diff --git a/runtime/doc/vim-ru.UTF-8.1 b/runtime/doc/vim-ru.UTF-8.1 index ef52721..e2308e3 100644 --- a/runtime/doc/vim-ru.UTF-8.1 +++ b/runtime/doc/vim-ru.UTF-8.1 @@ -1,19 +1,20 @@ -.TH VIM 1 "2002 Feb 22" -.SH ИМЯ -vim \- Vi IMproved (Улучшенный Vi), текстовый редактор для программистов -.SH КОМАНДНАЯ СТРОКА +.TH VIM 1 "12 августа 2024" +.SH НАЗНАЧЕНИЕ +Программа Vim \[em] это Vi IMproved (Улучшенный Vi), текстовый редактор для +программистов. +.SH КРАТКИЙ ОБЗОР .br .B vim -[ключи] [файл ..] +[аргументы] [файл ...] .br .B vim -[ключи] \- +[аргументы] \- .br .B vim -[ключи] \-t метка +[аргументы] \-t индекс .br .B vim -[ключи] \-q [файл ошибок] +[аргументы] \-q [файл результатов] .PP .br .B ex @@ -22,468 +23,669 @@ vim \- Vi IMproved (Улучшенный Vi), текстовый редакто .br .B gvim .B gview +.B evim +.B eview .br .B rvim .B rview .B rgvim .B rgview .SH ОПИСАНИЕ +Программа .B Vim --- текстовый редактор, обратно-совместимый с Vi. -Он может быть использован для правки всех видов простого текста. -Особенно он хорош для правки исходных текстов программ. +\[em] это текстовый редактор, совместимый с редактором Vi. +Она может быть использована для правки всех видов обычных текстовых документов. +Особенно полезна она будет для редактирования исходных текстов программ. .PP -По сравнению с Vi, +По сравнению с редактором Vi, в редакторе .B Vim -имеет много усовершенствований: многократная отмена операций, +представлено много усовершенствований: многократная отмена операций, множественность окон и буферов, подсветка синтаксиса, правка командной строки, -автодополнение имён файлов, встроенная справка, визуальное выделение и т.п. -См. ":help vi_diff.txt" для получения полного списка различий между +подстановка наименований файлов, встроенная документация, визуальное выделение +и прочее. +См. ":help vi_diff.txt" чтобы ознакомиться с полным перечнем различий между +редактором .B Vim -и Vi. +и редактором Vi. .PP -Во время работы в -.B Vim -можно получить справку с помощью системы встроенной справки (команда ":help"). -См. раздел "ВСТРОЕННАЯ СПРАВКА" ниже по тексту. +Чтобы получить полезную информацию о работе с редактором +.B Vim, +можно воспользоваться встроенной в программу документацией, набрав в редакторе +команду ":help". +См. раздел "ВСТРОЕННАЯ ДОКУМЕНТАЦИЯ" далее в тексте. .PP -Чаще всего +Чаще всего редактор .B Vim запускают для правки одного файла при помощи команды .PP vim файл .PP -В общем виде команда запуска +В общем виде команда запуска редактора .B Vim выглядит так: .PP - vim [ключи] [список файлов] + vim [аргументы] [файлы] .PP -Если список файлов отсутствует, редактор начнёт работу с пустым буфером. -В противном случае имя файла должно быть указано одним из следующих четырёх способов: +Если файлы не указаны, редактор будет запущен с доступным для редактирования +пустым буфером. +Наименования файлов могут быть указаны одним из следующих четырёх способов: .TP 12 -файл .. -Список имён файлов. -Первый файл будет объявлен активным и загружен в буфер. Курсор будет помещён -в первой строке буфера. Доступ к другим файлам может быть осуществлён при -помощи команды ":next". Чтобы править файл, имя которого начинается с символа -"дефис" (-), перед списком файлов необходимо поставить "--". +файл ... +Перечень наименований файлов. +Первый файл из перечня будет объявлен активным и загружен в буфер, а каретка +установлена на первой строке этого буфера. Доступ к другим файлам из этого +перечня может быть осуществлён при помощи команды ":next". Чтобы править файл, +наименование которого начинается с символа "дефис" (\-), перед перечнем файлов +необходимо указать символы "\-\-". .TP \- -Файл будет прочитан из потока стандартного ввода. Команды будут считываться -из стандартного потока диагностики (stderr), который должен быть -терминалом. -.TP -\-t {метка} -Имя файла и начальная позиция курсора зависят от "метки", похожей на метку goto. -{метка} ищется в файле меток, соответствующий файл становится активным, а -соответствующая команда исполняется. -Чаще всего используется в программах на языке Си, где {метка} может быть именем -функции. -Файл, содержащий функцию, становится активным, а курсор помещается в начало функции. -См. ":help tag-commands". -.TP -\-q [файл ошибок] -Начать работу в режиме быстрого исправления. -При этом считывается [файл ошибок] и первая ошибка выводится на экран. -Если [файл ошибок] не указан, имя файла берётся из значения опции 'errorfile' -(по умолчанию: "AztecC.Err" для Amiga, "errors.err" для других систем). -К следующим ошибкам можно перейти по команде ":cn". +Текст для правки будет считан из потока стандартного ввода. Команды будут +считываться из стандартного потока диагностики (stderr), который должен +предоставляться терминалом. +.TP +\-t {индекс} +Файла для правки и начальная позиция каретки зависят от значения "индекса", +являющийся своего рода меткой goto. Поиск самого {индекса} выполняется в файле +индексов, а сопоставленный с ним файл будет открыт в редакторе и выполнена +связанная с этим {индексом} команда. +Чаще всего этот способ используется для программ на языке Си, где {индекс} может +быть наименованием функции. +Файл, содержащий такую функцию, становится активным, а каретка помещается +в начало этой функции. +См. ":help tag\-commands". +.TP +\-q [файл результатов] +Начать работу редактора в цикле быстрого исправления текста программ. +Будет считан [файл результатов] и отображена первая запись из этого файла. +Если [файл результатов] не указан, то его наименование берётся из значения +параметра 'errorfile' (по умолчанию для ОС Amiga это "AztecC.Err", а для других +систем \[em] "errors.err"). +К следующей записи в файле результатов можно перейти по команде ":cn". См. ":help quickfix". .PP +Программа .B Vim -ведёт себя по-разному в зависимости от имени команды (исполняемый файл может -быть одним и тем же). +ведёт себя по-разному в зависимости от указанной в командной строке команды +вызова редактора (исполняемый файл при этом может быть одним и тем же). .TP 10 vim -"Нормальный" запуск, всё по умолчанию. +Это "нормальный" запуск редактора, всё по умолчанию. .TP ex -Запуск в режиме Ex. Для перехода в нормальный режим -необходимо выполнить команду ":vi". Режим Ex включает -также ключ "\-e". +Запуск редактора в Ex-режиме. Для переключения в обычный режим, необходимо +набрать команду ":vi". +Ex-режим также может быть активирован через аргумент "\-e". .TP view -Запуск в режиме "только для чтения". Вы будете защищены от случайной записи -файла. То же самое можно сделать ключом "\-R". +Запуск редактора в режиме "только для чтения". В этом режиме есть некоторая +защита от случайной перезаписи файлов. +То же самое можно сделать через указание аргумента "\-R". .TP gvim gview -Версия с графическим интерфейсом. Запускается в новом окне. -То же самое можно сделать при запуске с ключом "\-g". +Запуск редактора с графическим интерфейсом. Для этого будет открыто новое окно. +То же самое можно сделать при запуске с аргументом "\-g". +.TP +evim eview +Упрощённый вариант редактора с графическим интерфейсом. Запускается в новом окне. +То же самое можно сделать через аргумент "\-y". .TP rvim rview rgvim rgview -Как и предыдущие команды, но с ограничениями. Нельзя запускать команды оболочки -или приостанавливать работу +Как и предыдущие команды, но с некоторыми ограничениями в функциональности. +Нельзя запускать команды оболочки или приостанавливать работу редактора .B Vim. -Вместо приставки "r" можно использовать ключ "\-Z". -.SH КЛЮЧИ -Ключи могут быть указаны в любом порядке, до или после имён -файлов. Ключи без аргументов могут быть объединены под одним -дефисом. +Вместо приставки "r" можно использовать аргумент командной строки "\-Z". +.SH АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ +Аргументы могут быть указаны в любом порядке, до или после наименований файлов. +Аргументы, не требующие значений, могут быть объединены с указанием только +одного дефиса. .TP 12 +[номер] -В первом файле курсор будет помещён на строку с указанным номером. -Если "номер" не указан, курсор будет помещён на последнюю строку. +Установка каретки на [номер] строки. +В первом открытом файле каретка будет установлена на строку с указанным номером. +Если "номер" не задан, каретка устанавливается на последней строке файла. .TP +/{шаблон} -В первом файле курсор будет помещён на место первого совпадения -с указанным шаблоном. См. ":help search-pattern" для получения -списка допустимых шаблонов. +Установка каретки на найденной строке. +В открытом файле каретка будет установлена в строке первого совпадения +с указанным шаблоном. См. ":help search\-pattern" для ознакомления с допустимыми +шаблонами. .TP +{команда} .TP \-c {команда} -{команда} исполняется после загрузки первого файла как команда Ex. -Если {команда} содержит пробелы, то она должна быть заключена в -двойные кавычки (в зависимости от используемой оболочки). -Пример: vim "+set si" main.c +Исполнение указанной {команды}. +После загрузки первого файла будет исполнена указанная {команда} как Ex-команда. +Если в тексте {команда} есть пробелы, то она должна быть заключена в +двойные кавычки (в зависимости от используемой командной оболочки). +Пример: +vim "+set si" main.c .br -Примечание: Можно указывать до десяти команд "+" или "\-c". -.TP -\-\-cmd {команда} -Как "\-c", но команда исполняется перед обработкой любого файла -настроек (vimrc). -Можно указывать до десяти таких команд, независимо от количества -команд "\-c". +Примечание. Можно указывать до десяти команд "+" или "\-c". .TP \-A -Если +Запуск программы с поддержкой арабской письменности. +Если программа .B Vim -был собран с поддержкой арабского языка для правки файлов, -набранных справа налево, и с поддержкой арабской клавиатуры, -этот ключ запускает +была собрана с поддержкой правки текста с написанием справа налево +и с поддержкой клавиатуры для арабского языка, то будет выполнен запуск +редактора .B Vim -в арабском режиме, с включенной опцией 'arabic'. В противном -случае +в режиме работы с арабской письменностью, т. е. установлен параметр 'arabic'. +В противном случае редактор .B Vim -завершает работу с ошибкой. +завершит работу с сообщением об ошибке. .TP \-b -Двоичный режим. -Производится настройка некоторых опций, делающих возможной правку +Запуск программы в режиме работы с двоичными данными. +Производится настройка некоторых параметров, делающих возможной правку двоичного или исполняемого файла. .TP \-C -Режим совместимости. Включает опцию 'compatible'. +Работа в варианте совместимости с редактором Vi. +Будет установлен параметр 'compatible', и редактор .B Vim -будет работать почти как Vi, даже если существует файл .vimrc. +будет работать почти как редактор Vi, даже если существует файл ".vimrc". .TP \-d -Режим поиска различий. -Должно быть указано два или три имени файла. +Режим сравнения различий. +Может быть указано от двух до восьми наименований файлов. В редакторе .B Vim -откроет все файлы и покажет различия между ними -(как vimdiff(1)). +будут открыты все файлы и показаны различия между ними (как vimdiff(1)). .TP -\-d {устройство} -Открыть {устройство} для использования в качестве терминала (только на Amiga). +\-d {устройство}, \-dev {устройство} +Использовать {устройство} для операций ввода-вывода. +Открыть {устройство} для использования в качестве терминала (только в ОС Amiga). Пример: "\-d con:20/30/600/150". .TP +\-D +Запуск программы в режиме диагностики. +Переключение в режим отладки при исполнении первой команды из командного файла. +.TP \-e -Запустить +Запуск программы в Ex-режиме. +Редактор +.B Vim +будет работоать в Ex-режиме, тоже, что в командной строке оболочки набрать +команду "ex". +.TP +\-E +Запуск программы в улучшенном Ex-режиме. +Редактор .B Vim -в режиме Ex, как будто исполняемый файл имеет имя "ex". +будет работать в улучшенном Ex-режиме, это аналогично набору в командной +оболочке команды "exim". .TP \-f -Режим активного приложения. Версия +Режим активного приложения. +Редактор .B Vim -с графическим интерфейсом не будет ветвиться и отключаться -от запустившей её оболочки. На платформе Amiga +с графическим интерфейсом не будет наследоваться и отключаться от командной +оболочки, в которой выполнена команда его запуска. +На платформе Amiga редактор .B Vim -не будет создавать новое окно. Этот ключ нужно использовать, -когда +не будет перезапускаться для создания нового окна. Этот аргумент командной +строки нужно использовать, когда редактор .B Vim запускается программой, которая должна ждать завершения сеанса правки (например, программа для работы с электронной почтой). -На платформе Amiga команды ":sh" и ":!" не будут работать. -.TP -\-\-nofork -Режим активного приложения. Версия -.B Vim -с графическим интерфейсом не будет ветвиться и отключаться -от запустившей её оболочки. +На платформе Amiga в этом случае команды ":sh" и ":!" не будут работать. .TP \-F -Если +Запуск программы с поддержкой персидской письменности. +Если программа .B Vim -был собран с поддержкой FKMAP для правки текста справа налево -и настроек клавиатуры для языка фарси, этот ключ запускает +была собрана с поддержкой правки текста с написанием справа налево +и с поддержкой клавиатуры для персидского языка, то будет выполнен запуск +редактора .B Vim -в режиме фарси, иначе говоря, с включёнными опциями -\&'fkmap' и 'rightleft'. -В противном случае +в режиме работы с персидской письменностью, т. е. установлены параметры 'fkmap' +и 'rightleft'. +В противном случае редактор .B Vim -завершает работу с сообщением об ошибке. +завершит работу с сообщением об ошибке. +.br +Примечание. Поддержка персидской письменности была удалена в версии 8.1.0932. .TP \-g -Если +Запуск программы с графическим интерфейсом. +Если программа .B Vim -был собран с поддержкой графического интерфейса, этот ключ -включает графический интерфейс. В противном случае +была собрана с поддержкой графического интерфейса, то будет выполнен запуск +графического интерфейса пользователя. +В противном случае редактор .B Vim -завершает работу с сообщением об ошибке. -.TP -\-h -Выводит краткую информацию об аргументах и ключах командной строки. -После этого -.B Vim -завершает работу. +завершит работу с сообщением об ошибке. .TP \-H -Если +Запуск программы с поддержкой еврейской письменности. +Если программа .B Vim -был собран с поддержкой правки текста справа налево -и настроек клавиатуры для иврита, этот ключ запускает +была собрана с поддержкой правки текста с написанием справа налево +и с поддержкой клавиатуры для еврейского языка, то будет выполнен запуск +редактора .B Vim -в режиме иврита, иначе говоря, с включёнными опциями 'hkmap' и 'rightleft'. -В противном случае +в режиме работы с еврейской письменностью, т. е. установлены параметры 'hkmap' +и 'rightleft'. +В противном случае редактор .B Vim -завершает работу с сообщением об ошибке. +завершит работу с сообщением об ошибке. .TP -\-i {viminfo} -Если используется файл viminfo, то этот ключ задаёт имя такого файла (вместо -"~/.viminfo" по умолчанию). Можно также избежать использования файла viminfo -путём указания имени "NONE". -.TP -\-L -То же, что и \-r. +\-i {файл} +Использовать в качестве файла подкачки указанный {файл}. +Через этот аргумент задаётся наименование viminfo-файла (вместо принятого +по умолчанию ".viminfo"). Здесь же можно отключить использование viminfo-файла +через указание слова "NONE" (прописными буквами). .TP \-l -Режим Lisp. Включаются опции 'lisp' и 'showmatch'. +Запуск программы в режиме Lisp. +Выполняется установка параметров 'lisp' и 'showmatch'. +.TP +\-L +То же, что и аргумент командной строки \-r. .TP \-m -Изменение файлов запрещено. При этом отключается опция 'write', поэтому -запись файлов становится невозможной. +Работа без возможности сохранения изменений. +Выполняется сброс параметра 'write', поэтому становится невозможным записать +в файл изменения, внесённые в буфер. .TP -\-N -Режим неполной совместимости. Отключается 'compatible'. -.B Vim -будет работать лучше, но не будет полностью совместим с Vi, даже если -отсутствует файл сценария настроек (.vimrc). +\-M +Работа без возможности внесения изменений в текст. +Параметры 'modifiable' и 'write' будут отключены, так что изменения будут +запрещены, и файлы не смогут быть записаны. +Обратите внимание, что после начала работы редактора, эти параметры можно +включить, чтобы разрешить внесение изменений. .TP \-n -Не использовать своп-файл. Восстановление при сбое в работе будет невозможно. +Работа без создания файла подкачки. +В этом случае восстановление при сбое в работе редактора будет невозможно. Удобно для правки файла на очень медленном носителе (например, гибком диске). -То же самое можно сделать командой ":set uc=0". Отмена -- ":set uc=200". +То же самое можно сделать командой ":set uc=0". Включение файла подкачки \[em] +":set uc=200". +.TP +\-N +Работа в варианте неполной совместимости с редактором Vi. +Будет сброшен параметр 'compatible'. +Редактор +.B Vim +будет работать лучше, но не будет полностью совместим с редактором Vi, даже если +отсутствует файл начальных настроек (".vimrc"). +.TP +\-nb +Назначить программу Vim сервером редактора для ИСР NetBeans. Подробности +смотрите в документации. .TP \-o[N] -Открыть N окон, разделённых по горизонтали. Если N не указано, то открывается -по одному окну на каждый файл. +Создать для N файлов отдельные окна, расположенные по горизонтали. +Если N не указано, то создаётся по одному окну на каждый файл. .TP \-O[N] -Открыть N окон, разделённых по вертикали. Если N не указано, то открывается -по одному окну на каждый файл. -.TP -\-R -Режим "только для чтения". Включается опция 'readonly'. -Файл в буфере доступен для редактирования, но его копию на диске нельзя -случайно перезаписать. Для сохранения файла необходимо добавить восклицательный -знак к соответствующей команде Ex (например, ":w!"). -Ключ "\-R" подразумевает также, что используется и ключ "\-n" (см. выше). -Опция 'readonly' может быть выключена по команде ":set noro". -См. ":help 'readonly'". +Создать для N файлов отдельные окна, расположенные по вертикали. +Если N не указано, то создаётся по одному окну на каждый файл. +.TP +\-p[N] +Создать для N файлов отдельные вкладки. +Если N не указано, то создаётся по одной вкладке на каждый файл. +.TP +\-P {заголовок окна} +Открыть программу в многодокументном приложении. +Только для ГИП в MS Windows. Задаёт заголовок окна родительского приложения. +Если возможно, то программа Vim будет запущена внутри окна многодокументного +приложения. Многодокументное приложение должно иметь указанный {заголовок окна}. +Убедитесь, что этот {заголовок окна} уникален для приложения. Обращаем внимание, +что реализация данного функционала всё ещё не до конца отработана. Внедрение +программы возможно не во все приложения и не поддерживается меню окна. .TP \-r -Вывести список своп-файлов и информацию об их использовании для восстановления после сбоя. +Вывод перечня файлов подкачки и завершение работы. +Будут показаны доступные файлы подкачки и информация об их использовании +для восстановления в случае сбоя. .TP \-r {файл} -Режим восстановления. -Для восстановления после сбоя будет использован своп-файл. -Своп-файл имеет то же имя, что и текстовый файл, но с добавлением расширения ".swp". +Восстановление аварийно завершённого сеанса. +Для восстановления после сбоя в работе будет использован указанный файл подкачки. +Файл подкачки имеет то же наименование, что и редактируемый текстовый файл, +но с добавлением расширения ".swp". См. ":help recovery". .TP +\-R +Работа в варианте только для чтения. +Будет установлен параметр 'readonly'. +Файл в буфере доступен для редактирования, но его копию на диске нельзя +случайно перезаписать. Для сохранения файла необходимо добавить восклицательный +знак к соответствующей Ex-команде (например, ":w!"). +При задании аргумента "\-R" также подразумевается, что используется и аргумент +"\-n" (см. выше). +Параметр 'readonly' может быть сброшен по команде ":set noro". +См. ":help 'readonly'". +.TP \-s -Тихий режим. Только при запуске как "Ex" или если перед "\-s" указан ключ "\-e". +Тихий режим. +Только при запуске в командной оболочке как программы "ex" или если перед +аргументом "\-s" указан аргумент "\-e". +.TP +\-s {командный файл} +Считывание команд режима команд из {командного файла}. +Содержимое файла воспринимается в виде команд, как если бы они были набраны +непосредственно в редакторе. +То же самое достигается командой ":source! {командный файл}". +Если после исполнения всех команд из {командного файла} работа редактора +продолжается, то дальнейший ввод команд и текста ожидается с клавиатуры. +.TP +\-S {файл} +Исполнение указанного {файла}. +После загрузки в буфер первого файла, будет исполнен указанный командный {файл}. +Это аналогично команде в командной строке \-c "source {файл}". +Наименование {файла} не может начинаться с символа '\-'. +Если не указан {файл}, то будет исполнен файл "Session.vim" (это будет работать +только если аргумент \-S является последним в командной строке). +.TP +\-T {терминал} +Назначить указанный тип {терминала}. +Редактору +.B Vim +будет передан тип используемого терминала. +Необходимо только в тех ситуациях, когда автоматическое определение терминала +не работает. Наименование терминала должно быть известно редактору +.B Vim +(предопределено в редакторе) либо указано в базе termcap или terminfo. +.TP +\-u {файл} +Использовать для начальной настройки указанный командный {файл}. +Все остальные файлы настроек игнорируются. +Удобно для редактирования специальных типов файлов. +Через этот аргумент можно также отключить обработку всех файлов начальной +настройки, используйте для этого слово "NONE" (прописными буквами). +См. ":help initialization". +.TP +\-U {файл} +Использовать для начальной настройки графического интерфейса указанный +командный {файл}. +Все остальные файлы настроек для графического интерфейса игнорируются. +Через этот аргумент можно также отключить обработку всех файлов настройки +графического интерфейса, используйте для этого слово "NONE" (прописными буквами). +См. ":help gui\-init". .TP -\-s {scriptin} -Считывается файл сценария {scriptin}. При этом, содержимое файла воспринимается -в виде команд, как если бы они были набраны на консоли. -То же самое достигается командой ":source! {scriptin}". -Если конец файла считывается до завершения работы редактора, то в дальнейшем -ввод осуществляется с клавиатуры. +\-v +Запуск программы в режиме Vi. +Редактор +.B Vim +будет работать в режиме редактора Vi, как будто исполняемый файл называется "vi". +Имеет смысл только если исполняемый файл называется "ex". +.TP +\-V[N] +Режим подробного вывода. +Будут выводиться сообщения о том, какие командные файлы исполняются, и какая +информация считывается и записывается в viminfo-файле. Необязательное число N +задаёт уровень детализации информации. По умолчанию это значение установлено +равным 10. +.TP +\-V[N]{файл} +Аналогично аргументу \-V, а также выполняется установка параметру 'verbosefile' +значение {файл}. Как результат, сообщения будут записываться в {файл}, а не +отображаться на экране. Наименование {файла} не может начинаться с какой-либо +цифры. +.TP +\-w{число} +Для параметра 'window' будет установлено значение, равное указанному {числу}. +.TP +\-w {файл} +Добавление всех введённых команд в {файл}. +Все символы, введённые с клавиатуры вплоть до момента завершения работы +редактора, записываются в {файл}. +Удобно в том случае, когда вы хотите создать командный файл для последующего +его использования в командной строке "vim \-s" или в команде ":source!". +Если {файл} уже существует, то набранный текст будет добавляются в конец файла. +.TP +\-W {файл} +Запись всех введённых команд в {файл}. +Как аргумент "\-w", но существующий {файл} будет перезаписан. .TP -\-T {terminal} -Сообщает -.B Vim -тип используемого терминала. Необходимо только в тех ситуациях, когда -автоматическое определение терминала не работает. Имя терминала должно быть -известно +\-x +Редактирование шифрованных файлов. +Если редактор .B Vim -(встроено в него) или определено в файлах termcap или terminfo. -.TP -\-u {vimrc} -Использовать команды из файла сценария {vimrc} для настройки. -Все остальные файлы настроек пропускаются. -Удобно для редактирования специальных типов файлов. -Чтобы избежать использования сценариев настроек вообще, можно использовать -имя "NONE". См. ":help initialization". +был собран с поддержкой шифрования, то выполнять шифрование при записи файлов. +Будет выдано приглашение ввести пароль. .TP -\-U {gvimrc} -Использовать команды из файла сценария {gvimrc} для настройки графического -интерфейса. -Все остальные файлы настроек для графического интерфейса пропускаются. -Чтобы избежать использования сценариев настроек графического интерфейса вообще, -можно использовать имя "NONE". См. ":help gui-init". -.TP -\-V -"Болтливый" режим. Выводить сообщения о том, какие файлы читаются, и о -чтении-записи файла viminfo. +\-X +Запуск программы без подключения к X-серверу. +Ускоряет загрузку в консоли, но делает невозможным использование заголовка окна +и буфера обмена. .TP -\-v -Запустить +\-y +Работа в упрощённом варианте. +Редактор +.B Vim +будет работать в упрощённом варианте, как будто исполняемый файл имеет название +"evim" или "eview". +Поведение редактора .B Vim -в режиме Vi, как будто исполняемый файл имеет имя "vi". Имеет смысл только если -исполняемый файл имеет имя "ex". +будет походить на редакторы, созданные по безрежимному принципу работы. .TP -\-w {scriptout} -Все символы, введённые с клавиатуры вплоть до момента завершения работы, -записываются в файл {scriptout}. -Удобно в том случае, когда вы хотите создать файл сценария для последующего -использования с "vim \-s" или ":source!". Если файл {scriptout} уже существует, -то новые символы будут добавляются в конец файла. +\-Z +Работа с ограничением функциональности. +Работает так же, как и запуск исполняемого файла, наименование которого +начинается с буквы "r". .TP -\-W {scriptout} -Как "\-w", но уже существующий файл будет перезаписан. +\-\- +Означает окончание ввода аргументов. +Все что указано после этого в командной строке, считается наименованиями файлов. +Может быть использовано для правки файлов, наименования которых начинаются с +дефиса. .TP -\-x -Шифровать записываемые файлы. Будет выдано приглашение ввести пароль. +\-\-clean +При работе редактора не использовать пользовательскую конфигурацию (файлы vimrc, +подключаемые модули и т. п.). Полезно для проверки, что проблема в работе +редактора не возникнет с предустановленными настройками программы Vim. .TP -\-X -Не подключаться к X-серверу. Ускоряет загрузку на консоли, но делает невозможным -использование заголовка окна и буфера обмена. +\-\-cmd {команда} +Как аргумент "\-c", но команда исполняется перед обработкой любого файла +настроек (vimrc). +Можно указывать до десяти таких команд, независимо от количества команд "\-c". .TP -\-Z -Ограниченный режим. Работает так же, как и программы, начинающиеся с "r". +\-\-echo\-wid +Только для графического интерфейса GTK. Отобразить идентификатор окна +(Window ID) в поток стандартного вывода (stdout). +.TP +\-\-gui\-dialog\-file {файл} +При работе редактора в графическом интерфейсе пользователя, заголовок +и сообщение диалогового окна будут записаны в {файл} без отображения на экране. +Если указанный {файл} не существует, то он будет создан, а при его наличии +сообщения будут дописываться в этот {файл}. Данный аргумент полезен только для +тестирования работы редактора, чтобы избежать остановки программы, так как +отображаемое диалоговое окно может быть скрыто. Если не поддерживается +графический интерфейс пользователя, то этот аргумент игнорируется программой. +.TP +\-\-help, \-h, \-? +Будет показана краткая информация об аргументах и параметрах командной строки. +После этого редактор +.B Vim +завершит работу. +.TP +\-\-literal +Данный аргумент указывает, что требуется воспринимать наименования файлов +буквально, и не выполнять разбор подстановочных символов. +Этот аргумент командной строки неприменим в Unix-подобных системах, где разбор +подстановочных символов выполняется командной оболочкой. +.TP +\-\-log {файл} +Будет выполнена запись протокола работы с этапа инициализации программы. +Если при сборке программы +.B Vim +были включены компоненты "eval" и "channel", будет выполняться протоколирование +работы с самой ранней стадии запуска программы, а журнал записываться в {файл}. +Это работает аналогично вызову функции +.I ch_logfile({filename}, 'ao') .TP -\-\- -Конец ключей. Все остальные аргументы рассматриваются как имена файлов. -Может быть использовано для правки файлов, имена которых начинаются с дефиса. +\-\-nofork +Режим активного приложения. +Редактор +.B Vim +с графическим интерфейсом не будет наследоваться и отключаться +от командной оболочки, в которой выполнена команда его запуска. .TP -\-\-help -Вывести краткую справку и завершить работу. То же, что и "\-h". +\-\-noplugin +Будет выполнен запуск программы без загрузки внешних подключаемых модулей. +Это же подразумевается при указании аргумента \-u NONE. .TP -\-\-version -Вывести информацию о версии программы и завершить работу. +\-\-not\-a\-term +Не сообщать об отсутствии терминала для ввода-вывода. +Через этот аргумент указывается, что операции ввода-вывода осуществляются не +на терминал. Это позволяет избежать предупреждающего сообщения и двухсекундной +задержки, которые могли бы возникнуть. .TP \-\-remote -Подключиться к серверу Vim и заставить его править файлы, указанные в -последующих аргументах. Если сервер не найден, выводится предупреждение, -а файлы правятся в местной копии Vim. +Будет выполнено подключение к Vim-серверу и передача для правки файлов, +указанных в последующих аргументах. Если сервер не найден, выводится +предупреждение, а правка файлов выполняется в текущей копии редактора Vim. .TP \-\-remote\-expr {выражение} -Подключиться к серверу Vim и вычислить на нём указанное {выражение}. +Будет выполнено подключение к Vim-серверу и передача указанного {выражение} для +вычисления. Результат вычисления будет выведен в поток стандартного вывода (stdout). .TP -\-\-remote\-send {ключи} -Подключиться к серверу Vim и передать ему указанные {ключи}. +\-\-remote\-send {код клавиши} +Будет выполнено подключение к Vim-серверу и передача указанных {кодов клавиш}. .TP \-\-remote\-silent Как "\-\-remote", но без вывода предупреждения, если сервер не найден. .TP \-\-remote\-wait -Как "\-\-remote", но Vim не будет завершать работу до тех пор, пока не будет -выполнена правка всех файлов. +Как "\-\-remote", но редактор Vim не будет завершать работу до тех пор, +пока не будет выполнена правка всех файлов. .TP \-\-remote\-wait\-silent Как "\-\-remote\-wait", но без вывода предупреждения, если сервер не найден. .TP \-\-serverlist -Вывести список всех доступных серверов Vim. +Будет выведен перечень всех доступных Vim-серверов. .TP -\-\-servername {имя} -Использовать указанное {имя} в качестве имени сервера. Если ключ -"\-\-remote" не указан, то {имя} присваивается данной копии Vim, -в противном случае указывает на имя сервера, к которому следует -подключиться. +\-\-servername {название} +Использовать указанное {название} в качестве наименования сервера. Если аргумент +"\-\-remote" не указан, то {название} присваивается данной копии редактора Vim, +в противном случае указывает на сервер, к которому следует подключиться. .TP \-\-socketid {id} -Только для графического интерфейса GTK: использовать механизм GtkPlug для -запуска gvim в отдельном окне. +Только для графического интерфейса GTK. Будет использован механизм GtkPlug для +запуска редактора gVim в отдельном окне. .TP -\-\-echo\-wid -Только для графического интерфейса GTK: вывести идентификатор окна (Window ID) -в поток стандартного вывода (stdout). -.SH ВСТРОЕННАЯ СПРАВКА -Для начала, наберите команду ":help". -Введите ":help тема", чтобы получить справку по конкретной теме. -Например, команда ":help ZZ" выведет информацию о команде "ZZ". -Используйте <Tab> и CTRL-D для автоматического дополнения -названий тем (":help cmdline-completion"). -Для быстрого перемещения по справочнику используются метки (что-то +\-\-startuptime {файл} +Будет выполнена запись хронометража запуска программы в {файл}. +.TP +\-\-ttyfail +Будт сразу же завершена работа, если ввод-вывод получен не с терминала (tty). +.TP +\-\-version +Будет выведена информация о версии программы и завершена работа. +.TP +\-\-windowid {ИД} +Только для графического интерфейса в MS Windows. Редактор gVim будет +использовать окно с указанным {ИД} в качестве родительского, чтобы попытаться +выполнить запуск внутри этого окна. +.SH ВСТРОЕННАЯ ДОКУМЕНТАЦИЯ +Для начала работы с документацией, наберите в редакторе +.B Vim +команду ":help". +Введите ":help тема", чтобы получить справку по интересующей теме. +Например, по команде ":help ZZ" будет выведена информация о команде "ZZ". +Используйте клавиши <TAB> и CTRL+D для подстановки нужного названия темы +(см. ":help cmdline\-completion"). +Для быстрого перемещения по документации используются индексы (что-то вроде гипертекстовых ссылок, см. ":help"). Таким образом можно -просматривать все файлы справки, например ":help syntax.txt". +переходить от одного файла документации к другому, например, ":help syntax.txt". .SH ФАЙЛЫ .TP 15 -/usr/local/lib/vim/doc/*.txt -Файлы справочника +/usr/local/share/vim/vim??/doc/*.txt +Файлы документации редактора .B Vim. -См. ":help doc-file-list" для получения полного списка. +См. ":help doc\-file\-list" для получения полного перечня файлов. +.br +Здесь и далее +.I "vim??" +означает сокращённую запись номера версии, например, vim91 для версии редактора +.B Vim 9.1 .TP -/usr/local/lib/vim/doc/tags -Файл меток, используемый для поиска информации в файлах справки. +/usr/local/share/vim/vim??/doc/tags +Файл индексов, используемый для поиска информации в файлах документации. .TP -/usr/local/lib/vim/syntax/syntax.vim -Системные настройки синтаксиса. +/usr/local/share/vim/vim??/syntax/syntax.vim +Общесистемные настройки распознавания и подсветки синтаксиса. .TP -/usr/local/lib/vim/syntax/*.vim -Файлы синтаксиса для разных языков. +/usr/local/share/vim/vim??/syntax/*.vim +Файлы распознавания и подсветки синтаксиса для различных языков программирования. .TP -/usr/local/lib/vim/vimrc -Системные настройки +/usr/local/share/vim/vimrc +Общесистемный файл начальной настройки для консольного редактора .B Vim. .TP -/usr/local/lib/vim/gvimrc -Системный настройки графического интерфейса. +~/.vimrc, ~/.vim/vimrc, $XDG_CONFIG_HOME/vim/vimrc +Пользовательские файлы начальной настройки для консольного редактора +.B Vim +(будет использован первый найденный файл из указанных). +.TP +/usr/local/share/vim/gvimrc +Общесистемный файл начальной настройки для редактора с графическим интерфейсом +.B gVim. +.TP +~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc +Пользовательские файлы начальной настройки для редактора с графическим +интерфейсом +.B gVim +(будет использован первый найденный файл из указанных). .TP -/usr/local/lib/vim/optwin.vim -Сценарий, используемый при выполнении команды ":options". -Хороший способ просматривать и изменять настройки. +/usr/local/share/vim/vim??/optwin.vim +Командный файл, используемый при выполнении команды ":options". +По этой команде предоставляется удобный способ просмотра и изменения настроек. .TP -/usr/local/lib/vim/menu.vim -Системные настройки меню для gvim. +/usr/local/share/vim/vim??/menu.vim +Системные настройки меню для графического интерфейса редактора +.B gVim. .TP -/usr/local/lib/vim/bugreport.vim -Сценарий для создания отчёта об обнаруженных глюках. См. ":help bugs". +/usr/local/share/vim/vim??/bugreport.vim +Командный файл для создания отчёта об обнаруженных ошибках. См. ":help bugs". .TP -/usr/local/lib/vim/filetype.vim -Сценарий для определения типа файла по имени. См. ":help 'filetype'". +/usr/local/share/vim/vim??/filetype.vim +Командный файл для распознавания типов файлов по наименованию. +См. ":help 'filetype'". .TP -/usr/local/lib/vim/scripts.vim -Сценарий для определения типа файла по содержимому. См. ":help 'filetype'". +/usr/local/share/vim/vim??/scripts.vim +Командный файл для распознавания типов файлов по содержимому. +См. ":help 'filetype'". .TP -/usr/local/lib/vim/print/*.ps -Файлы для печати PostScript. +/usr/local/share/vim/vim??/print/*.ps +Файлы, используемые для печати через интерфейс PostScript. .PP -Более свежая информация -- на сайте VIM: +Всю последнюю информацию о редакторе можно получить на веб-странице VIM: .br <URL:http://www.vim.org/> -.SH СМОТРИ ТАКЖЕ +.SH СМОТРИТЕ ТАКЖЕ vimtutor(1) .SH АВТОРЫ -Большая часть +Большая часть редактора .B Vim -создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное -количество людей. См. ":help credits" в +была создана Брамом Моленаром (Bram Moolenaar), которому помогало огромное +количество людей. См. ":help credits" в редакторе .B Vim. .br +Редактор .B Vim базируется на коде редактора Stevie, написанного Тимом Томпсоном (Tim Thompson), Тони Эндрюсом (Tony Andrews) и Г. Р. (Фредом) Уолтером (G.R. (Fred) Walter). -Однако, в настоящее время в Vim почти не осталось ничего от исторического кода -его предшественника. +Однако, в настоящее время в программе Vim почти ничего не осталось +от исторического кода его предшественника. .br -Русская локализация +Русская локализация редактора .B Vim выполняется в рамках проекта "РуВим", -см. <URL:http://sourceforge.net/projects/ruvim/>. -.SH ГЛЮКИ +см. <URL:https://github.com/restorerz/ruvim/>. +.SH ОШИБКИ Скорее всего есть. -См. ":help todo" -- список известных проблем. +См. ":help todo" \[em] перечень известных ошибок в работе. .PP -Заметим, что многие вещи, которые считаются глюками, на самом деле -являются результатом слишком полного воспроизведения поведения Vi. +Заметим, что многие вещи, которые считаются ошибками, на самом деле +являются результатом слишком полного воспроизведения поведения редактора Vi. Если вы думаете, что что-то является ошибкой только потому, что "Vi делает это по-другому", внимательно прочитайте файл vi_diff.txt -(или наберите ":help vi_diff.txt" в Vim) и используйте опции 'compatible' -и 'cpoptions'. +(или наберите ":help vi_diff.txt" в редакторе Vim) и посмотрите параметры + 'compatible' и 'cpoptions'. diff --git a/runtime/doc/vim.1 b/runtime/doc/vim.1 index a180a62..efef7bb 100644 --- a/runtime/doc/vim.1 +++ b/runtime/doc/vim.1 @@ -1,4 +1,4 @@ -.TH VIM 1 "2024 Jun 04" +.TH VIM 1 "2024 Aug 12" .SH NAME vim \- Vi IMproved, a programmer's text editor .SH SYNOPSIS @@ -150,18 +150,6 @@ Example: vim "+set si" main.c .br Note: You can use up to 10 "+" or "\-c" commands. .TP -\-S {file} -{file} will be sourced after the first file has been read. -This is equivalent to \-c "source {file}". -{file} cannot start with '\-'. -If {file} is omitted "Session.vim" is used (only works when \-S is the last -argument). -.TP -\-\-cmd {command} -Like using "\-c", but the command is executed just before -processing any vimrc file. -You can use up to 10 of these commands, independently from "\-c" commands. -.TP \-A If .B Vim @@ -224,11 +212,6 @@ is executed by a program that will wait for the edit session to finish (e.g. mail). On the Amiga the ":sh" and ":!" commands will not work. .TP -\-\-nofork -Foreground. For the GUI version, -.B Vim -will not fork and detach from the shell it was started in. -.TP \-F If .B Vim @@ -239,6 +222,8 @@ in Farsi mode, i.e. 'fkmap' and 'rightleft' are set. Otherwise an error message is given and .B Vim aborts. +.br +Note: Farsi support has been removed in patch 8.1.0932. .TP \-g If @@ -248,18 +233,6 @@ If no GUI support was compiled in, an error message is given and .B Vim aborts. .TP -\-\-gui-dialog-file {name} -When using the GUI, instead of showing a dialog, write the title and message of -the dialog to file {name}. The file is created or appended to. Only useful -for testing, to avoid that the test gets stuck on a dialog that can't be seen. -Without the GUI the argument is ignored. -.TP -\-\-help, \-h, \-? -Give a bit of help about the command line arguments and options. -After this -.B Vim -exits. -.TP \-H If .B Vim @@ -277,13 +250,13 @@ instead of the default "~/.viminfo". This can also be used to skip the use of the .viminfo file, by giving the name "NONE". .TP -\-L -Same as \-r. -.TP \-l Lisp mode. Sets the 'lisp' and 'showmatch' options on. .TP +\-L +Same as \-r. +.TP \-m Modifying files is disabled. Resets the 'write' option. @@ -294,13 +267,6 @@ Modifications not allowed. The 'modifiable' and 'write' options will be unset, so that changes are not allowed and files can not be written. Note that these options can be set to enable making modifications. .TP -\-N -No-compatible mode. Resets the 'compatible' option. -This will make -.B Vim -behave a bit better, but less Vi compatible, even though a .vimrc file does -not exist. -.TP \-n No swap file will be used. Recovery after a crash will be impossible. @@ -308,6 +274,13 @@ Handy if you want to edit a file on a very slow medium (e.g. floppy). Can also be done with ":set uc=0". Can be undone with ":set uc=200". .TP +\-N +No-compatible mode. Resets the 'compatible' option. +This will make +.B Vim +behave a bit better, but less Vi compatible, even though a .vimrc file does +not exist. +.TP \-nb Become an editor server for NetBeans. See the docs for details. .TP @@ -330,6 +303,16 @@ the window title of the parent application. Make sure that it is specific enough. Note that the implementation is still primitive. It won't work with all applications and the menu doesn't work. .TP +\-r +List swap files, with information about using them for recovery. +.TP +\-r {file} +Recovery mode. +The swap file is used to recover a crashed editing session. +The swap file is a file with the same filename as the text file with ".swp" +appended. +See ":help recovery". +.TP \-R Read-only mode. The 'readonly' option will be set. @@ -341,16 +324,6 @@ The \-R option also implies the \-n option (see above). The 'readonly' option can be reset with ":set noro". See ":help 'readonly'". .TP -\-r -List swap files, with information about using them for recovery. -.TP -\-r {file} -Recovery mode. -The swap file is used to recover a crashed editing session. -The swap file is a file with the same filename as the text file with ".swp" -appended. -See ":help recovery". -.TP \-s Silent mode. Only when started as "Ex" or when the "\-e" option was given before the "\-s" option. @@ -362,6 +335,13 @@ The same can be done with the command ":source! {scriptin}". If the end of the file is reached before the editor exits, further characters are read from the keyboard. .TP +\-S {file} +{file} will be sourced after the first file has been read. +This is equivalent to \-c "source {file}". +{file} cannot start with '\-'. +If {file} is omitted "Session.vim" is used (only works when \-S is the last +argument). +.TP \-T {terminal} Tells .B Vim @@ -371,16 +351,6 @@ Should be a terminal known to .B Vim (builtin) or defined in the termcap or terminfo file. .TP -\-\-not-a-term -Tells -.B Vim -that the user knows that the input and/or output is not connected to a -terminal. This will avoid the warning and the two second delay that would -happen. -.TP -\-\-ttyfail -When stdin or stdout is not a a terminal (tty) then exit right away. -.TP \-u {vimrc} Use the commands in the file {vimrc} for initializations. All the other initializations are skipped. @@ -394,6 +364,12 @@ All the other GUI initializations are skipped. It can also be used to skip all GUI initializations by giving the name "NONE". See ":help gui\-init" within vim for more details. .TP +\-v +Start +.B Vim +in Vi mode, just like the executable was called "vi". This only has effect +when the executable is called "ex". +.TP \-V[N] Verbose. Give messages about which files are sourced and for reading and writing a viminfo file. The optional number N is the value for 'verbose'. @@ -404,20 +380,6 @@ Like \-V and set 'verbosefile' to {filename}. The result is that messages are not displayed but written to the file {filename}. {filename} must not start with a digit. .TP -\-\-log {filename} -If -.B Vim -has been compiled with eval and channel feature, start logging and write -entries to {filename}. This works like calling -.I ch_logfile({filename}, 'ao') -very early during startup. -.TP -\-v -Start -.B Vim -in Vi mode, just like the executable was called "vi". This only has effect -when the executable is called "ex". -.TP \-w{number} Set the 'window' option to {number}. .TP @@ -433,7 +395,10 @@ If the {scriptout} file exists, characters are appended. Like \-w, but an existing file is overwritten. .TP \-x -Use encryption when writing files. Will prompt for a crypt key. +If +.B Vim +has been compiled with encryption support, use encryption when writing files. +Will prompt for a crypt key. .TP \-X Don't connect to the X server. Shortens startup time in a terminal, but the @@ -459,16 +424,53 @@ This can be used to edit a filename that starts with a '\-'. Do not use any personal configuration (vimrc, plugins, etc.). Useful to see if a problem reproduces with a clean Vim setup. .TP +\-\-cmd {command} +Like using "\-c", but the command is executed just before +processing any vimrc file. +You can use up to 10 of these commands, independently from "\-c" commands. +.TP \-\-echo\-wid GTK GUI only: Echo the Window ID on stdout. .TP +\-\-gui\-dialog\-file {name} +When using the GUI, instead of showing a dialog, write the title and message of +the dialog to file {name}. The file is created or appended to. Only useful +for testing, to avoid that the test gets stuck on a dialog that can't be seen. +Without the GUI the argument is ignored. +.TP +\-\-help, \-h, \-? +Give a bit of help about the command line arguments and options. +After this +.B Vim +exits. +.TP \-\-literal Take file name arguments literally, do not expand wildcards. This has no effect on Unix where the shell expands wildcards. .TP +\-\-log {filename} +If +.B Vim +has been compiled with eval and channel feature, start logging and write +entries to {filename}. This works like calling +.I ch_logfile({filename}, 'ao') +very early during startup. +.TP +\-\-nofork +Foreground. For the GUI version, +.B Vim +will not fork and detach from the shell it was started in. +.TP \-\-noplugin Skip loading plugins. Implied by \-u NONE. .TP +\-\-not\-a\-term +Tells +.B Vim +that the user knows that the input and/or output is not connected to a +terminal. This will avoid the warning and the two second delay that would +happen. +.TP \-\-remote Connect to a Vim server and make it edit the files given in the rest of the arguments. If no server is found a warning is given and the files are edited @@ -497,16 +499,19 @@ Use {name} as the server name. Used for the current Vim, unless used with a \-\-remote argument, then it's the name of the server to connect to. .TP \-\-socketid {id} -GTK GUI only: Use the GtkPlug mechanism to run gvim in another window. +GTK GUI only: Use the GtkPlug mechanism to run gVim in another window. .TP \-\-startuptime {file} During startup write timing messages to the file {fname}. .TP +\-\-ttyfail +When stdin or stdout is not a a terminal (tty) then exit right away. +.TP \-\-version Print version information and exit. .TP \-\-windowid {id} -Win32 GUI only: Make gvim try to use the window {id} as a parent, so that it +Win32 GUI only: Make gVim try to use the window {id} as a parent, so that it runs inside that window. .SH ON-LINE HELP Type ":help" in @@ -554,13 +559,16 @@ initializations (first one found is used). System wide gvim initializations. .TP ~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc -Your personal gvim initializations (first one found is used). +Your personal +.B gVim +initializations (first one found is used). .TP /usr/local/share/vim/vim??/optwin.vim Script used for the ":options" command, a nice way to view and set options. .TP /usr/local/share/vim/vim??/menu.vim -System wide menu initializations for gvim. +System wide menu initializations for +.B gVim. .TP /usr/local/share/vim/vim??/bugreport.vim Script to generate a bug report. See ":help bugs". diff --git a/runtime/doc/vim.man b/runtime/doc/vim.man index 4ce444e..ce1cc63 100644 --- a/runtime/doc/vim.man +++ b/runtime/doc/vim.man @@ -1,7 +1,5 @@ VIM(1) General Commands Manual VIM(1) - - NAME vim - Vi IMproved, a programmer's text editor @@ -113,202 +111,170 @@ OPTIONS vim "+set si" main.c Note: You can use up to 10 "+" or "-c" commands. - -S {file} {file} will be sourced after the first file has been read. - This is equivalent to -c "source {file}". {file} cannot - start with '-'. If {file} is omitted "Session.vim" is used - (only works when -S is the last argument). - - --cmd {command} - Like using "-c", but the command is executed just before - processing any vimrc file. You can use up to 10 of these - commands, independently from "-c" commands. - - -A If Vim has been compiled with ARABIC support for editing - right-to-left oriented files and Arabic keyboard mapping, - this option starts Vim in Arabic mode, i.e. 'arabic' is + -A If Vim has been compiled with ARABIC support for editing + right-to-left oriented files and Arabic keyboard mapping, + this option starts Vim in Arabic mode, i.e. 'arabic' is set. Otherwise an error message is given and Vim aborts. - -b Binary mode. A few options will be set that makes it pos‐ + -b Binary mode. A few options will be set that makes it pos‐ sible to edit a binary or executable file. - -C Compatible. Set the 'compatible' option. This will make - Vim behave mostly like Vi, even though a .vimrc file ex‐ + -C Compatible. Set the 'compatible' option. This will make + Vim behave mostly like Vi, even though a .vimrc file ex‐ ists. -d Start in diff mode. There should between two to eight file - name arguments. Vim will open all the files and show dif‐ + name arguments. Vim will open all the files and show dif‐ ferences between them. Works like vimdiff(1). -d {device}, -dev {device} - Open {device} for use as a terminal. Only on the Amiga. + Open {device} for use as a terminal. Only on the Amiga. Example: "-d con:20/30/600/150". - -D Debugging. Go to debugging mode when executing the first + -D Debugging. Go to debugging mode when executing the first command from a script. - -e Start Vim in Ex mode, just like the executable was called + -e Start Vim in Ex mode, just like the executable was called "ex". -E Start Vim in improved Ex mode, just like the executable was called "exim". -f Foreground. For the GUI version, Vim will not fork and de‐ - tach from the shell it was started in. On the Amiga, Vim - is not restarted to open a new window. This option should - be used when Vim is executed by a program that will wait - for the edit session to finish (e.g. mail). On the Amiga + tach from the shell it was started in. On the Amiga, Vim + is not restarted to open a new window. This option should + be used when Vim is executed by a program that will wait + for the edit session to finish (e.g. mail). On the Amiga the ":sh" and ":!" commands will not work. - --nofork Foreground. For the GUI version, Vim will not fork and de‐ - tach from the shell it was started in. - -F If Vim has been compiled with FKMAP support for editing right-to-left oriented files and Farsi keyboard mapping, this option starts Vim in Farsi mode, i.e. 'fkmap' and 'rightleft' are set. Otherwise an error message is given and Vim aborts. + Note: Farsi support has been removed in patch 8.1.0932. -g If Vim has been compiled with GUI support, this option en‐ ables the GUI. If no GUI support was compiled in, an error message is given and Vim aborts. - --gui-dialog-file {name} - When using the GUI, instead of showing a dialog, write the - title and message of the dialog to file {name}. The file - is created or appended to. Only useful for testing, to - avoid that the test gets stuck on a dialog that can't be - seen. Without the GUI the argument is ignored. - - --help, -h, -? - Give a bit of help about the command line arguments and op‐ - tions. After this Vim exits. - -H If Vim has been compiled with RIGHTLEFT support for editing - right-to-left oriented files and Hebrew keyboard mapping, - this option starts Vim in Hebrew mode, i.e. 'hkmap' and - 'rightleft' are set. Otherwise an error message is given + right-to-left oriented files and Hebrew keyboard mapping, + this option starts Vim in Hebrew mode, i.e. 'hkmap' and + 'rightleft' are set. Otherwise an error message is given and Vim aborts. -i {viminfo} - Specifies the filename to use when reading or writing the - viminfo file, instead of the default "~/.viminfo". This - can also be used to skip the use of the .viminfo file, by + Specifies the filename to use when reading or writing the + viminfo file, instead of the default "~/.viminfo". This + can also be used to skip the use of the .viminfo file, by giving the name "NONE". - -L Same as -r. - -l Lisp mode. Sets the 'lisp' and 'showmatch' options on. - -m Modifying files is disabled. Resets the 'write' option. - You can still modify the buffer, but writing a file is not + -L Same as -r. + + -m Modifying files is disabled. Resets the 'write' option. + You can still modify the buffer, but writing a file is not possible. - -M Modifications not allowed. The 'modifiable' and 'write' - options will be unset, so that changes are not allowed and - files can not be written. Note that these options can be + -M Modifications not allowed. The 'modifiable' and 'write' + options will be unset, so that changes are not allowed and + files can not be written. Note that these options can be set to enable making modifications. + -n No swap file will be used. Recovery after a crash will be + impossible. Handy if you want to edit a file on a very + slow medium (e.g. floppy). Can also be done with ":set + uc=0". Can be undone with ":set uc=200". + -N No-compatible mode. Resets the 'compatible' option. This will make Vim behave a bit better, but less Vi compatible, even though a .vimrc file does not exist. - -n No swap file will be used. Recovery after a crash will be - impossible. Handy if you want to edit a file on a very - slow medium (e.g. floppy). Can also be done with ":set - uc=0". Can be undone with ":set uc=200". - -nb Become an editor server for NetBeans. See the docs for de‐ tails. -o[N] Open N windows stacked. When N is omitted, open one window for each file. - -O[N] Open N windows side by side. When N is omitted, open one + -O[N] Open N windows side by side. When N is omitted, open one window for each file. -p[N] Open N tab pages. When N is omitted, open one tab page for each file. -P {parent-title} - Win32 GUI only: Specify the title of the parent applica‐ - tion. When possible, Vim will run in an MDI window inside - the application. {parent-title} must appear in the window + Win32 GUI only: Specify the title of the parent applica‐ + tion. When possible, Vim will run in an MDI window inside + the application. {parent-title} must appear in the window title of the parent application. Make sure that it is spe‐ - cific enough. Note that the implementation is still primi‐ - tive. It won't work with all applications and the menu + cific enough. Note that the implementation is still primi‐ + tive. It won't work with all applications and the menu doesn't work. - -R Read-only mode. The 'readonly' option will be set. You - can still edit the buffer, but will be prevented from acci‐ - dentally overwriting a file. If you do want to overwrite a - file, add an exclamation mark to the Ex command, as in - ":w!". The -R option also implies the -n option (see - above). The 'readonly' option can be reset with ":set - noro". See ":help 'readonly'". - - -r List swap files, with information about using them for re‐ + -r List swap files, with information about using them for re‐ covery. - -r {file} Recovery mode. The swap file is used to recover a crashed - editing session. The swap file is a file with the same + -r {file} Recovery mode. The swap file is used to recover a crashed + editing session. The swap file is a file with the same filename as the text file with ".swp" appended. See ":help recovery". - -s Silent mode. Only when started as "Ex" or when the "-e" + -R Read-only mode. The 'readonly' option will be set. You + can still edit the buffer, but will be prevented from acci‐ + dentally overwriting a file. If you do want to overwrite a + file, add an exclamation mark to the Ex command, as in + ":w!". The -R option also implies the -n option (see + above). The 'readonly' option can be reset with ":set + noro". See ":help 'readonly'". + + -s Silent mode. Only when started as "Ex" or when the "-e" option was given before the "-s" option. -s {scriptin} - The script file {scriptin} is read. The characters in the - file are interpreted as if you had typed them. The same + The script file {scriptin} is read. The characters in the + file are interpreted as if you had typed them. The same can be done with the command ":source! {scriptin}". If the end of the file is reached before the editor exits, further characters are read from the keyboard. + -S {file} {file} will be sourced after the first file has been read. + This is equivalent to -c "source {file}". {file} cannot + start with '-'. If {file} is omitted "Session.vim" is used + (only works when -S is the last argument). + -T {terminal} Tells Vim the name of the terminal you are using. Only re‐ quired when the automatic way doesn't work. Should be a terminal known to Vim (builtin) or defined in the termcap or terminfo file. - --not-a-term - Tells Vim that the user knows that the input and/or output - is not connected to a terminal. This will avoid the warn‐ - ing and the two second delay that would happen. - - --ttyfail When stdin or stdout is not a a terminal (tty) then exit - right away. - - -u {vimrc} Use the commands in the file {vimrc} for initializations. - All the other initializations are skipped. Use this to - edit a special kind of files. It can also be used to skip - all initializations by giving the name "NONE". See ":help + -u {vimrc} Use the commands in the file {vimrc} for initializations. + All the other initializations are skipped. Use this to + edit a special kind of files. It can also be used to skip + all initializations by giving the name "NONE". See ":help initialization" within vim for more details. - -U {gvimrc} Use the commands in the file {gvimrc} for GUI initializa‐ - tions. All the other GUI initializations are skipped. It - can also be used to skip all GUI initializations by giving - the name "NONE". See ":help gui-init" within vim for more + -U {gvimrc} Use the commands in the file {gvimrc} for GUI initializa‐ + tions. All the other GUI initializations are skipped. It + can also be used to skip all GUI initializations by giving + the name "NONE". See ":help gui-init" within vim for more details. - -V[N] Verbose. Give messages about which files are sourced and - for reading and writing a viminfo file. The optional num‐ + -v Start Vim in Vi mode, just like the executable was called + "vi". This only has effect when the executable is called + "ex". + + -V[N] Verbose. Give messages about which files are sourced and + for reading and writing a viminfo file. The optional num‐ ber N is the value for 'verbose'. Default is 10. -V[N]{filename} Like -V and set 'verbosefile' to {filename}. The result is - that messages are not displayed but written to the file + that messages are not displayed but written to the file {filename}. {filename} must not start with a digit. - --log {filename} - If Vim has been compiled with eval and channel feature, - start logging and write entries to {filename}. This works - like calling ch_logfile({filename}, 'ao') very early during - startup. - - -v Start Vim in Vi mode, just like the executable was called - "vi". This only has effect when the executable is called - "ex". - -w{number} Set the 'window' option to {number}. -w {scriptout} @@ -321,8 +287,8 @@ OPTIONS -W {scriptout} Like -w, but an existing file is overwritten. - -x Use encryption when writing files. Will prompt for a crypt - key. + -x If Vim has been compiled with encryption support, use en‐ + cryption when writing files. Will prompt for a crypt key. -X Don't connect to the X server. Shortens startup time in a terminal, but the window title and clipboard will not be @@ -343,31 +309,61 @@ OPTIONS etc.). Useful to see if a problem reproduces with a clean Vim setup. + --cmd {command} + Like using "-c", but the command is executed just before + processing any vimrc file. You can use up to 10 of these + commands, independently from "-c" commands. + --echo-wid GTK GUI only: Echo the Window ID on stdout. - --literal Take file name arguments literally, do not expand wild‐ - cards. This has no effect on Unix where the shell expands + --gui-dialog-file {name} + When using the GUI, instead of showing a dialog, write the + title and message of the dialog to file {name}. The file + is created or appended to. Only useful for testing, to + avoid that the test gets stuck on a dialog that can't be + seen. Without the GUI the argument is ignored. + + --help, -h, -? + Give a bit of help about the command line arguments and op‐ + tions. After this Vim exits. + + --literal Take file name arguments literally, do not expand wild‐ + cards. This has no effect on Unix where the shell expands wildcards. + --log {filename} + If Vim has been compiled with eval and channel feature, + start logging and write entries to {filename}. This works + like calling ch_logfile({filename}, 'ao') very early during + startup. + + --nofork Foreground. For the GUI version, Vim will not fork and de‐ + tach from the shell it was started in. + --noplugin Skip loading plugins. Implied by -u NONE. + --not-a-term + Tells Vim that the user knows that the input and/or output + is not connected to a terminal. This will avoid the warn‐ + ing and the two second delay that would happen. + --remote Connect to a Vim server and make it edit the files given in the rest of the arguments. If no server is found a warning is given and the files are edited in the current Vim. --remote-expr {expr} - Connect to a Vim server, evaluate {expr} in it and print + Connect to a Vim server, evaluate {expr} in it and print the result on stdout. --remote-send {keys} Connect to a Vim server and send {keys} to it. --remote-silent - As --remote, but without the warning when no server is + As --remote, but without the warning when no server is found. --remote-wait - As --remote, but Vim does not exit until the files have + As --remote, but Vim does not exit until the files have been edited. --remote-wait-silent @@ -378,21 +374,24 @@ OPTIONS List the names of all Vim servers that can be found. --servername {name} - Use {name} as the server name. Used for the current Vim, + Use {name} as the server name. Used for the current Vim, unless used with a --remote argument, then it's the name of the server to connect to. --socketid {id} - GTK GUI only: Use the GtkPlug mechanism to run gvim in an‐ + GTK GUI only: Use the GtkPlug mechanism to run gVim in an‐ other window. --startuptime {file} During startup write timing messages to the file {fname}. + --ttyfail When stdin or stdout is not a a terminal (tty) then exit + right away. + --version Print version information and exit. --windowid {id} - Win32 GUI only: Make gvim try to use the window {id} as a + Win32 GUI only: Make gVim try to use the window {id} as a parent, so that it runs inside that window. ON-LINE HELP @@ -430,7 +429,7 @@ FILES System wide gvim initializations. ~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc - Your personal gvim initializations (first one found is + Your personal gVim initializations (first one found is used). /usr/local/share/vim/vim??/optwin.vim @@ -438,7 +437,7 @@ FILES view and set options. /usr/local/share/vim/vim??/menu.vim - System wide menu initializations for gvim. + System wide menu initializations for gVim. /usr/local/share/vim/vim??/bugreport.vim Script to generate a bug report. See ":help bugs". @@ -476,6 +475,4 @@ BUGS vi_diff.txt when in Vim). Also have a look at the 'compatible' and 'cpoptions' options. - - - 2024 Jun 04 VIM(1) + 2024 Aug 12 VIM(1) diff --git a/runtime/doc/vimdiff-it.1 b/runtime/doc/vimdiff-it.1 index 836ccbe..335a799 100644 --- a/runtime/doc/vimdiff-it.1 +++ b/runtime/doc/vimdiff-it.1 @@ -1,4 +1,4 @@ -.TH VIMDIFF 1 "30 marzo 2001" +.TH VIMDIFF 1 "13 giugno 2021" .SH NOME vimdiff \- modifica da due, fino a otto versioni di un file con Vim, visualizzando le differenze .SH SINTASSI diff --git a/runtime/doc/vimdiff-it.UTF-8.1 b/runtime/doc/vimdiff-it.UTF-8.1 index ebcf8ac..91e21fe 100644 --- a/runtime/doc/vimdiff-it.UTF-8.1 +++ b/runtime/doc/vimdiff-it.UTF-8.1 @@ -1,4 +1,4 @@ -.TH VIMDIFF 1 "30 marzo 2001" +.TH VIMDIFF 1 "13 giugno 2021" .SH NOME vimdiff \- modifica da due, fino a otto versioni di un file con Vim, visualizzando le differenze .SH SINTASSI diff --git a/runtime/doc/vimdiff-ru.1 b/runtime/doc/vimdiff-ru.1 index 3855367..e5121a4 100644 --- a/runtime/doc/vimdiff-ru.1 +++ b/runtime/doc/vimdiff-ru.1 @@ -1,50 +1,51 @@ -.TH VIMDIFF 1 "2001 March 30" -.SH -vimdiff \- Vim - . -.SH +.TH VIMDIFF 1 "13 2021" +.SH + vimdiff \[em] Vim + . +.SH .br .B vimdiff -[] 1 2 [3] +[] file1 file2 [file3 [file4 [file5 [file6 [file7 [file8]]]]]] .PP .B gvimdiff .SH - + .B vimdiff - + .B Vim - ( ) . . - . - ӣ - . + , . + . + ӣ + . .PP - Vim . vim(1). + Vim . vim(1). .PP - + .B gvimdiff - , . + , +. .PP - 'diff', - . + 'diff', + . .br - - 'wrap' 'scrollbind'. + + 'wrap' 'scrollbind'. .br - 'foldmethod' "diff", - , . - 'foldcolumn' 2, -, . -.SH - , - "\-O". , - , "\-o". + 'foldmethod' "diff", + , . + 'foldcolumn' 2, +, ף . +.SH + , , + "\-O". , , + "\-o". .PP - vim(1). -.SH + vim(1). +.SH vim(1) .SH - + .B Vim - (Bram Moolenaar), - . . ":help credits" + (Bram Moolenaar), + . . ":help credits" .B Vim. diff --git a/runtime/doc/vimdiff-ru.UTF-8.1 b/runtime/doc/vimdiff-ru.UTF-8.1 index 2f17e9c..b43c98d 100644 --- a/runtime/doc/vimdiff-ru.UTF-8.1 +++ b/runtime/doc/vimdiff-ru.UTF-8.1 @@ -1,50 +1,51 @@ -.TH VIMDIFF 1 "2001 March 30" -.SH ИМЯ -vimdiff \- позволяет редактировать две или три версии файла с помощью Vim -с отображением различий. -.SH КОМАНДНАЯ СТРОКА +.TH VIMDIFF 1 "13 июня 2021" +.SH НАЗНАЧЕНИЕ +Программа vimdiff \[em] запускает редактор Vim для сравнения и правки от двух до +восьми версий текстового файла. +.SH КАТКИЙ ОБЗОР .br .B vimdiff -[ключи] файл1 файл2 [файл3] +[аргументы] file1 file2 [file3 [file4 [file5 [file6 [file7 [file8]]]]]] .PP .B gvimdiff .SH ОПИСАНИЕ -Команда +По команде .B vimdiff -загружает в +выполняется загрузка в редактор .B Vim -два (или три) файла. Каждый файл открывается в собственном окне. -Различия между файлами отображаются с помощью подсветки синтаксиса. -Эта команда позволяет наглядно отображать внесённые изменения и переносить -различающиеся фрагменты из одной версии файла в другую. +от двух до восьми файлов, и для каждого файла создаётся отдельное окно. +Различия между файлами выделяются с помощью подсветки. +Этот способ очень удобен для наглядного отображения внесённых изменений +и переноса различающихся фрагментов текста из одной версии файла в другую. .PP -Подробнее о Vim см. на странице справочника vim(1). +Подробнее о редакторе Vim см. в справочнике vim(1). .PP -При запуске с помощью команды +При запуске редактора с помощью команды .B gvimdiff -редактор запускается в режиме графического интерфейса, если это возможно. +будте выполнено переключение на графический интерфес пользователя, если это +возможно. .PP -В каждом окне включается опция 'diff', что позволяет использовать подсветку -синтаксиса для отображения различий между файлами. +Для каждого созданного окна будет установлен параметр 'diff', что позволяет +использовать подсветку для отображения различий между файлами. .br -Для улучшения работы с файлами в режиме отображения отличий также включаются -опции 'wrap' и 'scrollbind'. +Для улучшения работы с файлами в режиме сравнения различий также будут +установлены параметры 'wrap' и 'scrollbind'. .br -Значение опции 'foldmethod' устанавливается равным "diff", что позволяет -прятать в складку области текста, которые не отличаются в различных версиях файла. -Значение опции 'foldcolumn' устанавливается равным 2, чтобы было проще -находить, открывать и закрывать такие складки. -.SH КЛЮЧИ ЗАПУСКА -Для выравнивания строк между окнами используется вертикальное разделение окон, -как если бы использовался ключ "\-O". Для того, чтобы использовать разделение -окон по горизонтали, следует указать в командной строке ключ "\-o". +Для параметра 'foldmethod' устанавливается значение "diff", что позволяет +сворачивать области текста, которые идентичны в различных версиях файла. +Значение параметра 'foldcolumn' устанавливается равным 2, чтобы было проще +находить, открывать и закрывать такие области свёрнутого текста. +.SH АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ +При сопоставлении файлов, используется вертикальное расположение окон, как если +бы был указан аргумент "\-O". Для того, чтобы окна располагались по горизонтали, +следует указать в командной строке аргумент "\-o". .PP -Остальные ключи командной строки рассматриваются на странице справочника vim(1). -.SH СМОТРИ ТАКЖЕ +Остальные аргументы командной строки описаны в справочнике vim(1). +.SH СМОТРИТЕ ТАКЖЕ vim(1) .SH АВТОРЫ -Большая часть +Большая часть редактора .B Vim -создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное -количество людей. См. ":help credits" в +была создана Брамом Моленаром (Bram Moolenaar), которому помогало огромное +количество людей. См. ":help credits" в редакторе .B Vim. diff --git a/runtime/doc/vimdiff.1 b/runtime/doc/vimdiff.1 index ddcb30f..efbb84a 100644 --- a/runtime/doc/vimdiff.1 +++ b/runtime/doc/vimdiff.1 @@ -1,4 +1,4 @@ -.TH VIMDIFF 1 "2001 March 30" +.TH VIMDIFF 1 "2021 June 13" .SH NAME vimdiff \- edit between two and eight versions of a file with Vim and show differences .SH SYNOPSIS diff --git a/runtime/doc/vimdiff.man b/runtime/doc/vimdiff.man index a053e6a..a1f05bd 100644 --- a/runtime/doc/vimdiff.man +++ b/runtime/doc/vimdiff.man @@ -44,4 +44,4 @@ AUTHOR - 2001 March 30 VIMDIFF(1) + 2021 June 13 VIMDIFF(1) diff --git a/runtime/doc/vimtutor-it.1 b/runtime/doc/vimtutor-it.1 index f521134..36103df 100644 --- a/runtime/doc/vimtutor-it.1 +++ b/runtime/doc/vimtutor-it.1 @@ -1,4 +1,4 @@ -.TH VIMTUTOR 1 "2 aprile 2001" +.TH VIMTUTOR 1 "12 agosto 2024" .SH NOME vimtutor \- Un breve corso introduttivo a Vim .SH SINTASSI @@ -19,7 +19,7 @@ Il comando . .PP L'argomento opzionale \-g inizia vimtutor usando gvim invece che vim, se la -versione GUI di vim disponibile; altrimenti viene utilizzato Vim. +versione GUI di vim disponibile; altrimenti viene utilizzato vim. .PP L'argomento opzionale [lingua] l'abbreviazione di due lettere del nome di una lingua, per esempio "it" oppure "es". @@ -32,12 +32,16 @@ verr usata la versione inglese. sempre iniziato in Modo compatibile con Vi. .SH FILE .TP 15 -/usr/local/lib/vim/tutor/tutor[.language] +/usr/local/lib/vim/vim??/tutor/tutor[.lingua] I file di testo per .B Vimtutor . +.br +.I vim?? + il numero di versione corto, p.es., vim91 per indicare +.B Vim 9.1. .TP 15 -/usr/local/lib/vim/tutor/tutor.vim +/usr/local/share/vim/vim??/tutor/tutor.vim Lo script di Vim usato per copiare il file di testo .B Vimtutor . diff --git a/runtime/doc/vimtutor-it.UTF-8.1 b/runtime/doc/vimtutor-it.UTF-8.1 index 49747d4..ae42b10 100644 --- a/runtime/doc/vimtutor-it.UTF-8.1 +++ b/runtime/doc/vimtutor-it.UTF-8.1 @@ -1,4 +1,4 @@ -.TH VIMTUTOR 1 "2 aprile 2001" +.TH VIMTUTOR 1 "12 agosto 2024" .SH NOME vimtutor \- Un breve corso introduttivo a Vim .SH SINTASSI @@ -19,7 +19,7 @@ Il comando . .PP L'argomento opzionale \-g inizia vimtutor usando gvim invece che vim, se la -versione GUI di vim è disponibile; altrimenti viene utilizzato Vim. +versione GUI di vim è disponibile; altrimenti viene utilizzato vim. .PP L'argomento opzionale [lingua] è l'abbreviazione di due lettere del nome di una lingua, per esempio "it" oppure "es". @@ -32,12 +32,16 @@ verrà usata la versione inglese. è sempre iniziato in Modo compatibile con Vi. .SH FILE .TP 15 -/usr/local/lib/vim/tutor/tutor[.language] +/usr/local/lib/vim/vim??/tutor/tutor[.lingua] I file di testo per .B Vimtutor . +.br +.I vim?? +è il numero di versione corto, p.es., vim91 per indicare +.B Vim 9.1. .TP 15 -/usr/local/lib/vim/tutor/tutor.vim +/usr/local/share/vim/vim??/tutor/tutor.vim Lo script di Vim usato per copiare il file di testo .B Vimtutor . diff --git a/runtime/doc/vimtutor-ru.1 b/runtime/doc/vimtutor-ru.1 index fa3c5d9..ab865f2 100644 --- a/runtime/doc/vimtutor-ru.1 +++ b/runtime/doc/vimtutor-ru.1 @@ -1,51 +1,63 @@ -.TH VIMTUTOR 1 "2001 April 2" -.SH -vimtutor \- Vim -.SH +.TH VIMTUTOR 1 "12 2024" +.SH + vimtutor \[em] Vim. +.SH .br -.B vimtutor [] +.B vimtutor [\-g] [] .SH - + .B vimtutor - + .B Vim. - , - . + , . + , Σ + . .PP - + , .B vimtutor - , + , .B Vim. .PP - [] , - "ru" "it". - [] , - . , - . + \-g + , , , . + , +.B Vim. +.PP + [] , , +"ru" "it". + [] , , + . +, , , . .PP - + , .B Vim - Vi. + Vi. .SH + +.I "vim??" + ݣ , , vim91 +.B Vim 9.1 .TP 15 -/usr/local/lib/vim/tutor/tutor[.] - -.B vimtutor. +/usr/local/share/vim/vim??/tutor/tutor[.] + +.B Vimtutor. .TP 15 -/usr/local/lib/vim/tutor/tutor.vim - Vim, - -.B vimtutor. +/usr/local/share/vim/vim??/tutor/tutor.vim + +.B Vim, + +.B Vimtutor. .SH + .B Vimtutor - Vi . (Michael C. Pierce) - . (Robert K. Ware) Colorado School of Mines - (Charles Smith) Colorado State University. -E-mail: bware@mines.colorado.edu. + Vi . (Michael C. Pierce) . + (Robert K. Ware) Colorado School of Mines (Charles +Smith) Colorado State University. E-mail: bware@mines.colorado.edu ( +). .br - + .B Vim - (Bram Moolenaar). + (Bram Moolenaar). . -.SH +.SH vim(1) diff --git a/runtime/doc/vimtutor-ru.UTF-8.1 b/runtime/doc/vimtutor-ru.UTF-8.1 index 6b1ba90..27ec882 100644 --- a/runtime/doc/vimtutor-ru.UTF-8.1 +++ b/runtime/doc/vimtutor-ru.UTF-8.1 @@ -1,51 +1,63 @@ -.TH VIMTUTOR 1 "2001 April 2" -.SH ИМЯ -vimtutor \- учебник по Vim -.SH КОМАНДНАЯ СТРОКА +.TH VIMTUTOR 1 "12 августа 2024" +.SH НАЗНАЧЕНИЕ +Программа vimtutor \[em] выполняет запуск учебника по редактору Vim. +.SH КРАТКИЙ ОБЗОР .br -.B vimtutor [язык] +.B vimtutor [\-g] [язык] .SH ОПИСАНИЕ -Команда +По команде .B vimtutor -запускает учебник по +выполняется запуск редактора .B Vim. -При этом сначала происходит создание копии файла учебника, -чтобы его можно было редактировать без опасения потерять исходный файл. +с загруженным файлом, содержащем текст учебника. Но перед этим происходит +создание копии файла учебника, чтобы в нём можно было выполнять практические +задания без опасения испортить исходный файл. .PP -Программа +Практический курс, который будет открыт по команде .B vimtutor -полезна для новичков, желающих научиться самым основным командам +полезен для новичков, желающих научиться самым основным командам редактора .B Vim. .PP -Необязательный параметр [язык] представляет собой двухсимвольный код языка, -например "ru" или "it". -Если параметр [язык] не указан, то используется язык активной в настоящий -момент локали. Если учебник на этом языке не существует, то по умолчанию -используется учебник на английском языке. +Через необязательный аргумент командной строки \-g даётся указание на запуск +учебника в графическом интерфейсе редактора, если это, конечно, возможно. +При не возможности выполнить это, будет запущен консольный вариант редактора +.B Vim. +.PP +Необязательный аргумент [язык] задаётся как двухсимвольный код языка, например, +"ru" или "it". +Если аргумент [язык] не указан, то используется язык, заданный в действующих +в настоящий момент региональных настройках. Если учебника на этом языке не +существует, то, по умолчанию, используется учебник на английском языке. .PP -При работе с учебником +При работе с учебником, редактор .B Vim -всегда запускается в режиме совместимости с Vi. +всегда запускается в режиме совместимости с редактором Vi. .SH ФАЙЛЫ +Здесь и далее +.I "vim??" +означает сокращённую запись номера версии, например, vim91 для версии редактора +.B Vim 9.1 .TP 15 -/usr/local/lib/vim/tutor/tutor[.язык] -Текст учебника -.B vimtutor. +/usr/local/share/vim/vim??/tutor/tutor[.язык] +Файлы с текстом учебника +.B Vimtutor. .TP 15 -/usr/local/lib/vim/tutor/tutor.vim -Сценарий Vim, который используется для создания рабочей -копии текста учебника -.B vimtutor. +/usr/local/share/vim/vim??/tutor/tutor.vim +Командный файл редактора +.B Vim, +который используется для создания рабочей копии текста учебника +.B Vimtutor. .SH АВТОРЫ +Учебник .B Vimtutor -был впервые написан для Vi Майклом К. Пирсом (Michael C. Pierce) и -Робертом К. Уэа (Robert K. Ware) из Colorado School of Mines по -идее Чарльза Смита (Charles Smith) из Colorado State University. -E-mail: bware@mines.colorado.edu. +был впервые написан для Vi Майклом К. Пирсом (Michael C. Pierce) и Робертом К. +Уэа (Robert K. Ware) из Colorado School of Mines по идее Чарльза Смита (Charles +Smith) из Colorado State University. E-mail: bware@mines.colorado.edu (теперь +недоступен). .br -Впоследствии учебник был доработан для использования в +Впоследствии учебник был доработан для использования в редакторе .B Vim -Брамом Мооленааром (Bram Moolenaar). +Брамом Моленаром (Bram Moolenaar). Имена переводчиков учебника упоминаются в соответствующих файлах. -.SH СМОТРИ ТАКЖЕ +.SH СМОТРИТЕ ТАКЖЕ vim(1) diff --git a/runtime/doc/vimtutor.1 b/runtime/doc/vimtutor.1 index ec2d85a..a71bc02 100644 --- a/runtime/doc/vimtutor.1 +++ b/runtime/doc/vimtutor.1 @@ -1,4 +1,4 @@ -.TH VIMTUTOR 1 "2001 April 2" +.TH VIMTUTOR 1 "2024 August 12" .SH NAME vimtutor \- the Vim tutor .SH SYNOPSIS @@ -19,7 +19,7 @@ is useful for people that want to learn their first commands. .PP The optional argument \-g starts vimtutor with gvim rather than vim, if the -GUI version of vim is available, or falls back to Vim if gvim is not found. +GUI version of Vim is available, or falls back to vim if gvim is not found. .PP The optional [language] argument is the two-letter name of a language, like "it" or "es". @@ -32,12 +32,16 @@ Otherwise the English version will be used. is always started in Vi compatible mode. .SH FILES .TP 15 -/usr/local/lib/vim/tutor/tutor[.language] +/usr/local/share/vim/vim??/tutor/tutor[.language] The .B Vimtutor text file(s). +.br +.I vim?? +is short version number, like vim91 for +.B Vim 9.1 .TP 15 -/usr/local/lib/vim/tutor/tutor.vim +/usr/local/share/vim/vim??/tutor/tutor.vim The Vim script used to copy the .B Vimtutor text file. diff --git a/runtime/doc/vimtutor.man b/runtime/doc/vimtutor.man index 76f6471..f1e113e 100644 --- a/runtime/doc/vimtutor.man +++ b/runtime/doc/vimtutor.man @@ -16,7 +16,7 @@ DESCRIPTION commands. The optional argument -g starts vimtutor with gvim rather than vim, if - the GUI version of vim is available, or falls back to Vim if gvim is + the GUI version of Vim is available, or falls back to vim if gvim is not found. The optional [language] argument is the two-letter name of a language, @@ -28,10 +28,11 @@ DESCRIPTION Vim is always started in Vi compatible mode. FILES - /usr/local/lib/vim/tutor/tutor[.language] + /usr/local/share/vim/vim??/tutor/tutor[.language] The Vimtutor text file(s). + vim?? is short version number, like vim91 for Vim 9.1 - /usr/local/lib/vim/tutor/tutor.vim + /usr/local/share/vim/vim??/tutor/tutor.vim The Vim script used to copy the Vimtutor text file. AUTHOR @@ -47,4 +48,4 @@ SEE ALSO - 2001 April 2 VIMTUTOR(1) + 2024 August 12 VIMTUTOR(1) diff --git a/runtime/doc/windows.txt b/runtime/doc/windows.txt index e264e51..d3e5f67 100644 --- a/runtime/doc/windows.txt +++ b/runtime/doc/windows.txt @@ -1,4 +1,4 @@ -*windows.txt* For Vim version 9.1. Last change: 2024 Feb 20 +*windows.txt* For Vim version 9.1. Last change: 2024 Jul 09 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1223,7 +1223,8 @@ list of buffers. |unlisted-buffer| :bw[ipeout][!] N1 N2 ... Like |:bdelete|, but really delete the buffer. Everything related to the buffer is lost. All marks in this buffer - become invalid, option settings are lost, etc. Don't use this + become invalid, option settings are lost, the jumplist and + tagstack data will be purged, etc. Don't use this unless you know what you are doing. Examples: > :.+,$bwipeout " wipe out all buffers after the current " one diff --git a/runtime/doc/xxd-it.1 b/runtime/doc/xxd-it.1 index a4c1fe4..604d30a 100644 --- a/runtime/doc/xxd-it.1 +++ b/runtime/doc/xxd-it.1 @@ -1,4 +1,4 @@ -.TH XXD 1 "Agosto 1996" "Pagina di manuale per xxd" +.TH XXD 1 "Maggio 2024" "Pagina di manuale per xxd" .\" .\" 21 Maggio 1996 .\" Autore della pagina di manuale: @@ -190,7 +190,10 @@ Nel modificare immagini esadecimali, si tenga conto che salta il resto della riga, dopo aver letto i caratteri contenenti dati esadecimali (vedere opzione \-c). Ci implica pure che le modifiche alle colonne di caratteri stampabili ASCII (o EBCDIC) sono sempre ignorate. La ricostruzione da un file immagine -esadecimale in stile semplice (postscript) con xxd \-r \-p non dipende dal numero corretto di colonne. In questo caso, qualsiasi cosa assomigli a una coppia di cifre esadecimali interpretata [e utilizzata]. +esadecimale in stile semplice (postscript) con xxd \-r \-p non dipende dal numero +corretto di colonne. +In questo caso, qualsiasi cosa assomigli a una coppia di cifre esadecimali +interpretata [e utilizzata]. .PP Notare la differenza fra .br @@ -221,10 +224,11 @@ si aggiunge a 1k (1024) dove `dd' si era fermato. .PP Immagine esadecimale dalla posizione 0x100 (=1024\-768 ) del file in avanti. .br -\fI% sh \-c "dd of=normale bs=1k count=1; xxd \-s +\-768 > esadecimale" < file +\fI% sh \-c "dd of=normale bs=1k count=1; xxd \-s +\-768 > esadecimale" < file\fR .PP Comunque, questo capita raramente, e l'uso del `+' non serve quasi mai. -L'autore preferisce monitorare il comportamento di xxd con strace(1) o truss(1), quando si usa l'opzione \-s. +L'autore preferisce monitorare il comportamento di xxd con strace(1) o truss(1), +quando si usa l'opzione \-s. .SH ESEMPI .PP .br @@ -237,60 +241,63 @@ Stampa tutto tranne le prime tre righe (0x30 byte in esadecimale) di Stampa 3 righe (0x30 byte in esadecimale) alla fine di .BR file . .br -\fI% xxd \-s \-0x30 file +\fI% xxd \-s \-0x30 file\fR +.PP +Nota: I risultati degli esempi seguenti sono riferiti alla versione di +Maggio 2024 della pagina di manuale [quella che state leggendo]. .PP .br Stampa 120 byte come immagine esadecimale continua con 20 byte per riga. .br -\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR -.br -2e54482058584420312022417567757374203139 +\fI% xxd \-l 120 \-ps \-c 20 xxd-it.UTF-8.1\fR .br -39362220224d616e75616c207061676520666f72 +2e544820585844203120224d616767696f203230 .br -20787864220a2e5c220a2e5c222032317374204d +3234222022506167696e61206469206d616e7561 .br -617920313939360a2e5c22204d616e2070616765 +6c652070657220787864220a2e5c220a2e5c2220 .br -20617574686f723a0a2e5c2220202020546f6e79 +3231204d616767696f20313939360a2e5c222041 .br -204e7567656e74203c746f6e79407363746e7567 +75746f72652064656c6c6120706167696e612064 .br +69206d616e75616c653a0a2e5c2220202020546f +.PP .br -Stampa i primi 120 byte della pagina di manuale xxd.1 a 12 byte per riga. +Stampa i primi 120 byte di questa pagina di manuale a 12 byte per riga. .br -\fI% xxd \-l 120 \-c 12 xxd.1\fR +\fI% xxd \-l 120 \-c 12 xxd-it.UTF-8.1\fR .br -0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A +00000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M .br -000000c: 7567 7573 7420 3139 3936 2220 ugust 1996" +0000000c: 6167 6769 6f20 3230 3234 2220 aggio 2024" .br -0000018: 224d 616e 7561 6c20 7061 6765 "Manual page +00000018: 2250 6167 696e 6120 6469 206d "Pagina di m .br -0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\\ +00000024: 616e 7561 6c65 2070 6572 2078 anuale per x .br -0000030: 220a 2e5c 2220 3231 7374 204d "..\\" 21st M +00000030: 7864 220a 2e5c 220a 2e5c 2220 xd"..\"..\" .br -000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\\" +0000003c: 3231 204d 6167 6769 6f20 3139 21 Maggio 19 .br -0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut +00000048: 3936 0a2e 5c22 2041 7574 6f72 96..\" Autor .br -0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\\" +00000054: 6520 6465 6c6c 6120 7061 6769 e della pagi .br -0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent +00000060: 6e61 2064 6920 6d61 6e75 616c na di manual .br -000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug +0000006c: 653a 0a2e 5c22 2020 2020 546f e:..\" To .PP .br -Visualizza la data dal file xxd.1 +Visualizza la data dal file xxd-it.UTF-8.1 .br -\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +\fI% xxd \-s 0x3c \-l 14 \-c 14 xxd-it.UTF-8.1\fR .br -0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996 +0000003c: 3231 204d 6167 6769 6f20 3139 3936 21 Maggio 1996 .PP .br -Copiare +Copia .B input_file su .B output_file @@ -300,30 +307,30 @@ premettendogli 100 byte a 0x00. .br .br -Modificare (patch) la data nel file xxd.1 +Modifica (patch) la data nel file xxd-it.UTF-8.1 .br -\fI% echo "0000037: 3574 68" | xxd \-r \- xxd.1\fR +\fI% echo "000003c: 3331" | xxd \-r \- xxd-it.UTF-8.1\fR .br -\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +\fI% xxd \-s 0x3c \-l 14 \-c 14 xxd-it.UTF-8.1\fR .br -0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996 +0000003c: 3331 204d 6167 6769 6f20 3139 3936 31 Maggio 1996 .PP .br -Creare un file di 65537 byte tutto a 0x00, +Crea un file di 65537 byte tutto a 0x00, tranne l'ultimo carattere che una 'A' (esadecimale 0x41). .br \fI% echo "010000: 41" | xxd \-r > file\fR .PP .br -Stampa una immagine esadecimale del file di cui sopra con opzione autoskip. +Stampa un'immagine esadecimale del file di cui sopra con opzione autoskip. .br \fI% xxd \-a \-c 12 file\fR .br -0000000: 0000 0000 0000 0000 0000 0000 ............ +00000000: 0000 0000 0000 0000 0000 0000 ............ .br * .br -000fffc: 0000 0000 40 ....A +0000fffc: 0000 0000 41 ....A .PP Creare un file di 1 byte che contiene il solo carattere 'A'. Il numero dopo '\-r \-s' viene aggiunto a quello trovato nel file; @@ -388,7 +395,7 @@ La stranezza dello strumento rispecchia la mente del suo creatore. Usate a vostro rischio e pericolo. Copiate i file. Tracciate l'esecuzione. Diventate un mago. .br .SH VERSIONE -Questa pagina di manuale documenta la versione 1.7 di xxd. +Questa pagina di manuale documenta la versione 1.7 di xxd del maggio 2024. .SH AUTORE .br (c) 1990-1997 Juergen Weigert diff --git a/runtime/doc/xxd-it.UTF-8.1 b/runtime/doc/xxd-it.UTF-8.1 index 58b9789..9b67643 100644 --- a/runtime/doc/xxd-it.UTF-8.1 +++ b/runtime/doc/xxd-it.UTF-8.1 @@ -1,4 +1,4 @@ -.TH XXD 1 "Agosto 1996" "Pagina di manuale per xxd" +.TH XXD 1 "Maggio 2024" "Pagina di manuale per xxd" .\" .\" 21 Maggio 1996 .\" Autore della pagina di manuale: @@ -190,7 +190,10 @@ Nel modificare immagini esadecimali, si tenga conto che salta il resto della riga, dopo aver letto i caratteri contenenti dati esadecimali (vedere opzione \-c). Ciò implica pure che le modifiche alle colonne di caratteri stampabili ASCII (o EBCDIC) sono sempre ignorate. La ricostruzione da un file immagine -esadecimale in stile semplice (postscript) con xxd \-r \-p non dipende dal numero corretto di colonne. In questo caso, qualsiasi cosa assomigli a una coppia di cifre esadecimali è interpretata [e utilizzata]. +esadecimale in stile semplice (postscript) con xxd \-r \-p non dipende dal numero +corretto di colonne. +In questo caso, qualsiasi cosa assomigli a una coppia di cifre esadecimali è +interpretata [e utilizzata]. .PP Notare la differenza fra .br @@ -221,10 +224,11 @@ si aggiunge a 1k (1024) dove `dd' si era fermato. .PP Immagine esadecimale dalla posizione 0x100 (=1024\-768 ) del file in avanti. .br -\fI% sh \-c "dd of=normale bs=1k count=1; xxd \-s +\-768 > esadecimale" < file +\fI% sh \-c "dd of=normale bs=1k count=1; xxd \-s +\-768 > esadecimale" < file\fR .PP Comunque, questo capita raramente, e l'uso del `+' non serve quasi mai. -L'autore preferisce monitorare il comportamento di xxd con strace(1) o truss(1), quando si usa l'opzione \-s. +L'autore preferisce monitorare il comportamento di xxd con strace(1) o truss(1), +quando si usa l'opzione \-s. .SH ESEMPI .PP .br @@ -237,60 +241,63 @@ Stampa tutto tranne le prime tre righe (0x30 byte in esadecimale) di Stampa 3 righe (0x30 byte in esadecimale) alla fine di .BR file . .br -\fI% xxd \-s \-0x30 file +\fI% xxd \-s \-0x30 file\fR +.PP +Nota: I risultati degli esempi seguenti sono riferiti alla versione di +Maggio 2024 della pagina di manuale [quella che state leggendo]. .PP .br Stampa 120 byte come immagine esadecimale continua con 20 byte per riga. .br -\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR -.br -2e54482058584420312022417567757374203139 +\fI% xxd \-l 120 \-ps \-c 20 xxd-it.UTF-8.1\fR .br -39362220224d616e75616c207061676520666f72 +2e544820585844203120224d616767696f203230 .br -20787864220a2e5c220a2e5c222032317374204d +3234222022506167696e61206469206d616e7561 .br -617920313939360a2e5c22204d616e2070616765 +6c652070657220787864220a2e5c220a2e5c2220 .br -20617574686f723a0a2e5c2220202020546f6e79 +3231204d616767696f20313939360a2e5c222041 .br -204e7567656e74203c746f6e79407363746e7567 +75746f72652064656c6c6120706167696e612064 .br +69206d616e75616c653a0a2e5c2220202020546f +.PP .br -Stampa i primi 120 byte della pagina di manuale xxd.1 a 12 byte per riga. +Stampa i primi 120 byte di questa pagina di manuale a 12 byte per riga. .br -\fI% xxd \-l 120 \-c 12 xxd.1\fR +\fI% xxd \-l 120 \-c 12 xxd-it.UTF-8.1\fR .br -0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A +00000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M .br -000000c: 7567 7573 7420 3139 3936 2220 ugust 1996" +0000000c: 6167 6769 6f20 3230 3234 2220 aggio 2024" .br -0000018: 224d 616e 7561 6c20 7061 6765 "Manual page +00000018: 2250 6167 696e 6120 6469 206d "Pagina di m .br -0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\\ +00000024: 616e 7561 6c65 2070 6572 2078 anuale per x .br -0000030: 220a 2e5c 2220 3231 7374 204d "..\\" 21st M +00000030: 7864 220a 2e5c 220a 2e5c 2220 xd"..\"..\" .br -000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\\" +0000003c: 3231 204d 6167 6769 6f20 3139 21 Maggio 19 .br -0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut +00000048: 3936 0a2e 5c22 2041 7574 6f72 96..\" Autor .br -0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\\" +00000054: 6520 6465 6c6c 6120 7061 6769 e della pagi .br -0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent +00000060: 6e61 2064 6920 6d61 6e75 616c na di manual .br -000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug +0000006c: 653a 0a2e 5c22 2020 2020 546f e:..\" To .PP .br -Visualizza la data dal file xxd.1 +Visualizza la data dal file xxd-it.UTF-8.1 .br -\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +\fI% xxd \-s 0x3c \-l 14 \-c 14 xxd-it.UTF-8.1\fR .br -0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996 +0000003c: 3231 204d 6167 6769 6f20 3139 3936 21 Maggio 1996 .PP .br -Copiare +Copia .B input_file su .B output_file @@ -300,30 +307,30 @@ premettendogli 100 byte a 0x00. .br .br -Modificare (patch) la data nel file xxd.1 +Modifica (patch) la data nel file xxd-it.UTF-8.1 .br -\fI% echo "0000037: 3574 68" | xxd \-r \- xxd.1\fR +\fI% echo "000003c: 3331" | xxd \-r \- xxd-it.UTF-8.1\fR .br -\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +\fI% xxd \-s 0x3c \-l 14 \-c 14 xxd-it.UTF-8.1\fR .br -0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996 +0000003c: 3331 204d 6167 6769 6f20 3139 3936 31 Maggio 1996 .PP .br -Creare un file di 65537 byte tutto a 0x00, +Crea un file di 65537 byte tutto a 0x00, tranne l'ultimo carattere che è una 'A' (esadecimale 0x41). .br \fI% echo "010000: 41" | xxd \-r > file\fR .PP .br -Stampa una immagine esadecimale del file di cui sopra con opzione autoskip. +Stampa un'immagine esadecimale del file di cui sopra con opzione autoskip. .br \fI% xxd \-a \-c 12 file\fR .br -0000000: 0000 0000 0000 0000 0000 0000 ............ +00000000: 0000 0000 0000 0000 0000 0000 ............ .br * .br -000fffc: 0000 0000 40 ....A +0000fffc: 0000 0000 41 ....A .PP Creare un file di 1 byte che contiene il solo carattere 'A'. Il numero dopo '\-r \-s' viene aggiunto a quello trovato nel file; @@ -388,7 +395,7 @@ La stranezza dello strumento rispecchia la mente del suo creatore. Usate a vostro rischio e pericolo. Copiate i file. Tracciate l'esecuzione. Diventate un mago. .br .SH VERSIONE -Questa pagina di manuale documenta la versione 1.7 di xxd. +Questa pagina di manuale documenta la versione 1.7 di xxd del maggio 2024. .SH AUTORE .br (c) 1990-1997 Juergen Weigert diff --git a/runtime/doc/xxd-ja.UTF-8.1 b/runtime/doc/xxd-ja.UTF-8.1 index dabc477..93928fe 100644 --- a/runtime/doc/xxd-ja.UTF-8.1 +++ b/runtime/doc/xxd-ja.UTF-8.1 @@ -79,6 +79,9 @@ .IR \-C " | " \-capitalize \-i を使用した際に、C インクルードファイル形式の変数名を大文字にする。 .TP +.I \-d +オフセットを 16 進の代わりに 10 進で表示する。 +.TP .IR \-E " | " \-EBCDIC 右端に出力される文字のエンコーディングを ASCII から EBCDIC に変更する。 16 進ダンプの出力形式は変更されません。 @@ -135,7 +138,7 @@ C インクルードファイル形式で出力する。 たいていは、表示可能文字と非表示可能文字を区別するのに有用です。 .I \fIwhen\fP は -.BR never ", " always ", あるいは " auto +.BR never ", " always ", あるいは " auto " (デフォルト: auto) のいずれかです。 .BR $NO_COLOR 環境変数が設定されているときは、カラー表示は無効化されます。 diff --git a/runtime/doc/xxd-ru.1 b/runtime/doc/xxd-ru.1 index 8f32432..99b7461 100644 --- a/runtime/doc/xxd-ru.1 +++ b/runtime/doc/xxd-ru.1 @@ -1,57 +1,60 @@ -.TH XXD 1 "August 1996" " man xxd" +.TH XXD 1 "May 2024" " xxd" .\" .\" 21st May 1996 .\" Man page author: .\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> .\" Changes by Bram Moolenaar <Bram@vim.org> -.SH +.SH + .I xxd -\- - . -.SH +\[em] , + +.SH .B xxd \-h[elp] .br .B xxd -[] [_ [_]] +[] [_ [_]] .br .B xxd -\-r[evert] [] [_ [_]] +\-r[evert] [] [_ [_]] .SH + .I xxd - , - , . - - . - + , + , . + + . + .BR uuencode(1) -.BR uudecode(1), - ASCII-, - , , , -xxd , - . -.SH +.BR uudecode(1) +, +ASCII, , , , + xxd , + . +.SH .I _ - , . + , . , .I _ -.RB \` \- ', - . +.RB ' \- ', + . , .I _ ( -.RB \` \- ' -), . -.PP - , "" , - , . - -. , - . - , +.RB ' \- ' +), . +.PP + , "" , + , , , + - . + +. , + . + , .BR \-c8 , .BR "\-c 8" , .B \-c 010 @@ -61,118 +64,179 @@ xxd , .PP .TP .IR \-a " | " \-autoskip - : - '*'. - . + , . ., + , '*'. + . .TP .IR \-b " | " \-bits - ( ). - - "1" "0". - , - ( ascii ebcdic). \-p, \-i - . + ( ), . + , +, "1" "0". + ţ , + ASCII ( EBCDIC). +\-p, \-i . .TP .IR "\-c " | " \-cols " .RI < >, . 16 -(\-i: 12, \-ps: 30, \-b: 6). - : 256. +( \-i 12, \-ps \[em] 30, \-b \[em] 6). + \[em] 256. + \-ps. \-ps, + 0, . +.TP +.IR \-C " | " \-capitalize + + , + \-i. +.TP +.I \-d + , . .TP .IR \-E " | " \-EBCDIC - ASCII EBCDIC. - . , - \-r, \-p \-i. + ASCII, + EBCDIC. + . , + \-r, \-p \-i. +.TP +.IR \-e + + . + . + + +.RI "" \-g . + + + ASCII ( EBCDIC). + +\-r, \-p, \-i . .TP .IR "\-g " | " \-groupsize " - -.RI < > -( ), . + +.RI < > +( ), + . .I \-g 0 - . + . -.RI < "> " 2 - \fI1\fP . - postscript include. +.RI < ">, " 2 + , \fI4\fP + \fI1\fP . + PostScript include. .TP .IR \-h " | " \-help - . + +. . .TP .IR \-i " | " \-include - C. - , - , xxd -. + . + , + , xxd + . .TP .IR "\-l " | " \-len " - +, .RI < > - . + , . +.TP +.I "\-n " | " \-name " + \-i. + , \fI\fP + \fI\fP_len. +.TP +.I \-o + +.RI < > + . .TP .IR \-p " | " \-ps " | " \-postscript " | " \-plain - , - "" "postscript". + , + "" "PostScript". .TP .IR \-r " | " \-revert - : - ( ). - , xxd - . + , . . + ( + ). + , xxd + . .I \-r \-p "" - - . - . + - . + . + +.I \-r \-b + . +.TP +.IR \-R " " + + . + . + +.I \fI\fP + +.BR never " (), " always " (), " auto " (, ). + +.BR $NO_COLOR +, . .TP .I \-seek - + .I \-r -: +, .RI < > , . .TP -.I \-s [\+][\-]seek - ( ) +.I \-s [+][\-]seek + ( ) .RI < > _. -\fI\+ \fR, - (, - ). \fI\- \fR, - (, \fI \+ \fR: - ). - \-s , xxd . + \fI+ \fR, + (, + ). \fI\- \fR, + (, + \fI+\fR, + ). + \-s , xxd + . .TP .I \-u - . - . +, . + . .TP .IR \-v " | " \-version - . -.SH + . +.SH .PP + .I xxd \-r - . + , + . , - , - . xxd -lseek(2) . -, , -. + , + . +xxd lseek(2) . + , , + . .PP + .I xxd \-r - . . + , . + . .PP - -, + , +, .I xxd \-r - - (. \-c). , , - ascii ( ebcdic), . +, +(. \-c), . + , , ӣ +ASCII ( EBCDIC), . -postscript xxd \-r \-p . - , . +PostScript xxd \-r \-p . + , +. .PP .PP @@ -186,125 +250,139 @@ postscript xxd \-r \-p . .I xxd \-s \+seek .I xxd \-s seek, - , "" , lseek(2). - `+' , - , - , xxd . + , "" , + lseek(2). + '+' , + , + , xxd + . ( ݣ !) ... .PP - ; , 'cat' - : + , 'cat' + : .PP -\fI% sh \-c 'cat > plain_copy; xxd \-s 0 > hex_copy' < file +\fI% sh \-c "cat > plain_copy; xxd \-s 0 > hex_copy" < file\fR .PP - 0x480 -(= 1024+128). - `+' " ", `128' - , dd: + 0x480 (=1024+128). + '+' " ", '128' + , dd: .PP -\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file +\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +128 \> hex_snippet" < file\fR .PP - 0x100 -(= 1024-768): + 0x100 (=1024\[mi]768): .PP -\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file +\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +\-768 \> hex_snippet" < file\fR .PP - , , , - `+' . -xxd strace(1) truss(1) , + , , +, '+' . + xxd strace(1) truss(1) +, \-s. .SH .PP .br - ӣ, ң (0x30 ) -.B file + ӣ, ң (0x30 ) +.BR : -.PP -\fI% xxd \-s 0x30 file +.br +\fI% xxd \-s 0x30 file\fR .PP .br - (0x30 ) -.B file + (0x30 ) +.BR : -.PP -\fI% xxd \-s \-0x30 file -.PP .br - 120 - 20 : +\fI% xxd \-s \-0x30 file\fR .PP +.br + 120 + 20 +.br +( xxd.1 , + ): +.br \fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR .br -2e544820585844203120224d616e75616c207061 +2e544820585844203120224d6179203230323422 .br -676520666f7220787864220a2e5c220a2e5c2220 +20224d616e75616c207061676520666f72207878 .br -32317374204d617920313939360a2e5c22204d61 +64220a2e5c220a2e5c222032317374204d617920 .br -6e207061676520617574686f723a0a2e5c222020 +313939360a2e5c22204d616e2070616765206175 .br -2020546f6e79204e7567656e74203c746f6e7940 +74686f723a0a2e5c2220202020546f6e79204e75 .br -7363746e7567656e2e7070702e67752e6564752e +67656e74203c746f6e79407363746e7567656e2e .br -.PP + +.br + 120 12 +.br +( xxd.1 , + ): .br - 120 12 : -.PP \fI% xxd \-l 120 \-c 12 xxd.1\fR .br -0000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M +00000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M .br -000000c: 616e 7561 6c20 7061 6765 2066 anual page f +0000000c: 6179 2032 3032 3422 2022 4d61 ay 2024" "Ma .br -0000018: 6f72 2078 7864 220a 2e5c 220a or xxd"..\\". +00000018: 6e75 616c 2070 6167 6520 666f nual page fo .br -0000024: 2e5c 2220 3231 7374 204d 6179 .\\" 21st May +00000024: 7220 7878 6422 0a2e 5c22 0a2e r xxd"..\\".. .br -0000030: 2031 3939 360a 2e5c 2220 4d61 1996..\\" Ma +00000030: 5c22 2032 3173 7420 4d61 7920 \\" 21st May .br -000003c: 6e20 7061 6765 2061 7574 686f n page autho +0000003c: 3139 3936 0a2e 5c22 204d 616e 1996..\\" Man .br -0000048: 723a 0a2e 5c22 2020 2020 546f r:..\\" To +00000048: 2070 6167 6520 6175 7468 6f72 page author .br -0000054: 6e79 204e 7567 656e 7420 3c74 ny Nugent <t +00000054: 3a0a 2e5c 2220 2020 2054 6f6e :..\\" Ton .br -0000060: 6f6e 7940 7363 746e 7567 656e ony@sctnugen +00000060: 7920 4e75 6765 6e74 203c 746f y Nugent <to .br -000006c: 2e70 7070 2e67 752e 6564 752e .ppp.gu.edu. +0000006c: 6e79 4073 6374 6e75 6765 6e2e ny@sctnugen. .PP .br - xxd.1: + +.B xxd.1 +.br +( xxd.1 , + , , UTF-8 \[em] \flxxd \-s 0x50 \-l 13 \-c 13 xxd.1\fR): .PP -\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +\fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR .br -0000028: 3231 7374 204d 6179 2031 3939 21st May 199 +00000033: 3231 7374 204d 6179 2031 3939 36 21st May 1996 .PP .br .B _ .B _ - 100 0x00 : -.PP + 100 0x00 : +.br \fI% xxd _ | xxd \-r \-s 100 \> _\fR .br -.PP + .br - xxd.1: + +.B xxd.1 +.br +( xxd.1 , + ): .PP -\fI% echo '0000029: 3574 68' | xxd \-r \- xxd.1\fR +\fI% echo "0000034: 3574 68" | xxd \-r \- xxd.1\fR .br -\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +\fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR .br -0000028: 3235 7468 204d 6179 2031 3939 25th May 199 +00000033: 3235 7468 204d 6179 2031 3939 36 25th May 1996 .PP .br - 65537- , -0x00, , 'A' -(0x41): + 65537- , 0x00, + , 'A' (0x41): .PP -\fI% echo '010000: 41' | xxd \-r \> file\fR +\fI% echo "010000: 41" | xxd \-r > file\fR .PP .br @@ -312,97 +390,97 @@ xxd strace(1) truss(1) , .PP \fI% xxd \-a \-c 12 file\fR .br -0000000: 0000 0000 0000 0000 0000 0000 ............ +00000000: 0000 0000 0000 0000 0000 0000 ............ .br * .br -000fffc: 0000 0000 40 ....A +0000fffc: 0000 0000 41 ....A .PP 1- , 'A'. - '\-r \-s' , ; + '\-r \-s' , , , : .PP -\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> file\fR -.PP -xxd , -.B vim(1), - - `a' `z': +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 > file\fR .PP + xxd , +.B vim(1) +, + 'a' 'z': +.br \fI:'a,'z!xxd\fR .PP - xxd , -.B vim(1), - - `a' `z': -.PP + xxd , +.B vim(1) +, + 'a' 'z': +.br \fI:'a,'z!xxd \-r\fR .PP - xxd , -.B vim(1), - + xxd , +.B vim(1) +, . -.PP +.br \fI!!xxd \-r\fR .PP : -.PP +.br \fI% xxd \-c1 < /dev/term/b &\fR .br \fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR .br -\fI% echo \-n foo > /dev/term/b\fR +\fI% echo \-n foo \> /dev/term/b\fR .PP -.SH - xxd : +.SH + , xxd : .TP 0 . .TP \-1 ( -.I xxd \-r \-i +.I \%xxd \-r \-i ). .TP 1 - . + . .TP 2 - . + . .TP 3 - . + . .TP 4,5 . -.SH +.SH uuencode(1), uudecode(1), patch(1) .br .SH ţ . - ţ . , -, . + ţ . , , + . .br .SH - xxd 1.7. + xxd 1.7 2024-05. .SH .br -(c) 1990-1997 (Juergen Weigert) +(c) (Juergen Weigert), 1990-1997 .br -<jnweiger@informatik.uni-erlangen.de> +<jnweiger@informatik.uni\-erlangen.de> .LP . .br - - , - . + - , +. .br - , ޣ. + , ޣ. .PP - (Tony Nugent) + (Tony Nugent) .br <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> .br - (Bram Moolenaar). - (Juergen Weigert). + (Bram Moolenaar). + (Juergen Weigert). .PP diff --git a/runtime/doc/xxd-ru.UTF-8.1 b/runtime/doc/xxd-ru.UTF-8.1 index 4a41d66..65586dd 100644 --- a/runtime/doc/xxd-ru.UTF-8.1 +++ b/runtime/doc/xxd-ru.UTF-8.1 @@ -1,57 +1,60 @@ -.TH XXD 1 "August 1996" "Страница man для xxd" +.TH XXD 1 "May 2024" "Справочник по программе xxd" .\" .\" 21st May 1996 .\" Man page author: .\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> .\" Changes by Bram Moolenaar <Bram@vim.org> -.SH ИМЯ +.SH НАЗНАЧЕНИЕ +Программа .I xxd -\- создаёт представление файла в виде шестнадцатеричных кодов или выполняет -обратное преобразование. -.SH КОМАНДНАЯ СТРОКА +\[em] выполняет преобразование данных или в шестнадцатеричный вид, или выполняет +обратное преобразование из шестнадцатеричного кода в исходный формат +.SH КРАТКИЙ ОБЗОР .B xxd \-h[elp] .br .B xxd -[ключи] [входной_файл [выходной_файл]] +[аргументы] [входной_файл [выходной_файл]] .br .B xxd -\-r[evert] [ключи] [входной_файл [выходной_файл]] +\-r[evert] [аргументы] [входной_файл [выходной_файл]] .SH ОПИСАНИЕ +Программа .I xxd -создаёт представление указанного файла или данных, прочитанных из потока -стандартного ввода, в виде шестнадцатеричных кодов. Эта команда также может -выполнить обратное преобразование заданных шестнадцатеричными кодами данных -в исходный бинарный формат. -Подобно командам +создаёт представление указанного файла или данных, прочитанных из стандартного +потока ввода, в виде шестнадцатеричных кодов. Эта программа также может +выполнять обратное преобразование заданных шестнадцатеричными кодами данных +в исходный двоичных формат. +Подобно программам .BR uuencode(1) и -.BR uudecode(1), -она позволяет выполнять преобразование бинарных данных в ASCII-код, -который можно передавать по электронной почте, однако, помимо этого, программа -xxd позволяет выполнять декодирование в поток стандартного вывода, -а также может применяться для создания заплаток для бинарных файлов. -.SH КЛЮЧИ ЗАПУСКА +.BR uudecode(1) +, она позволяет выполнять преобразование двоичных данных в символы кодировки +ASCII, которые можно передавать по электронной почте, однако, помимо этого, +программа xxd позволяет выполнять декодирование в поток стандартного вывода, +а также может применяться для создания исправлений для двоичных файлов. +.SH АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ Если .I входной_файл -не задан, то соответствующие данные читаются из потока стандартного ввода. +не задан, то требуемые данные считываются из стандартного потока ввода. В случае, если в качестве .I входного_файла используется символ -.RB \` \- ', -источником данных также выступает поток стандартного ввода. +.RB ' \- ', +источником данных также выступает стандартный поток ввода. В том случае, если не указан .I выходной_файл (или вместо него используется символ -.RB \` \- ' -), результат преобразования направляется в поток стандартного вывода. -.PP -Обратите внимание, что используется "ленивый" алгоритм разбора ключей, который не -проверяет более одной буквы ключа, если в этом ключе не используется параметр. -Пробелы между единственным символом ключа и соответствующим параметром не являются -обязательными. Параметры ключей могут быть заданы с использованием десятичного, -шестнадцатеричного или восьмеричного формата. -Таким образом, ключи +.RB ' \- ' +), результат преобразования направляется в стандартный поток вывода. +.PP +Обратите внимание, что применяется "ленивый" алгоритм разбора аргументов, +который проверяет только первую букву аргумента, если, конечно, для этого +аргумента не указано какое-то значение. +Пробелы между односимвольным аргументом и его значением не являются +обязательными. Значения аргументов могут быть заданы в десятичном, +шестнадцатеричном или восьмеричном формате. +Таким образом, аргументы .BR \-c8 , .BR "\-c 8" , .B \-c 010 @@ -61,118 +64,179 @@ xxd позволяет выполнять декодирование в пото .PP .TP .IR \-a " | " \-autoskip -Включает автоматический пропуск: вместо последовательности -нулевых строк используется одиночный символ '*'. По умолчанию -не применяется. +Включить автоматический пропуск, т. е., вместо нескольких идущих подряд строк +с нулевым значением, используется одиночный символ '*'. +По умолчанию не применяется. .TP .IR \-b " | " \-bits -Вместо шестнадцатеричного кода используются биты (двоичные цифры). -При использовании этого ключа вместо обычного шестнадцатеричного представления -октетов используются наборы из восьми символов "1" и "0". Каждая строка -предваряется номером строки в шестнадцатеричном виде, а завершается символьным -представлением (в виде ascii или ebcdic). Ключи \-p, \-i в этом режиме -не работают. +Использовать биты (двоичный код), а не шестнадцатеричные цифры. +При указании этого аргумента, вместо обычного шестнадцатеричного представления +октетов, будет отображается набор из восьми цифр "1" и "0". Каждая строка +предваряется её номером в шестнадцатеричном виде, а завершается в виде символов +в кодировке ASCII (или в кодировке EBCDIC). Аргументы командной строки +\-p, \-i в этом режиме не применяются. .TP .IR "\-c кол " | " \-cols кол" Задаёт количество октетов .RI < кол >, которое выводится на каждой строке. По умолчанию используется значение 16 -(\-i: 12, \-ps: 30, \-b: 6). -Максимально допустимое значение: 256. +(для аргумента \-i используется 12, для \-ps \[em] 30, для \-b \[em] 6). +Максимально допустимое значение \[em] 256. +Максимальное значение не применяется с аргументом \-ps. Если с аргументом \-ps, +указано значение 0, то будет выведена просто одна длинная строка. +.TP +.IR \-C " | " \-capitalize +Преобразовать наименования переменных в верхний регистр при использовании стиля +отображения в виде подключаемых файлов языка Си, +который включается через аргумент командной строки \-i. +.TP +.I \-d +Отображать смещение не в шестнадцатеричном, а в десятичном формате. .TP .IR \-E " | " \-EBCDIC -Изменяет способ кодирования символов в правой колонке с ASCII на EBCDIC. Этот ключ -не изменяет шестнадцатеричное представление. Данный ключ не имеет смысла, -если используются ключи \-r, \-p или \-i. +Отображать символы в крайне правой колонке не в кодировке ASCII, +а в кодировке EBCDIC. Этот аргумент не влияет на шестнадцатеричное +представление данных. Данный аргумент не имеет смысла, если используются +аргументы командной строки \-r, \-p или \-i. +.TP +.IR \-e +Использовать обратный порядок байт при отображение шестнадцатеричного +представления данных. +Группа байт будет показана как двоичное слово от младших разрядов к старшим. +Используемое по умолчанию группирование по четыре байта может быть изменено +через аргумент командной строки +.RI "" \-g . +Действие этого аргумента распространяется только на шестнадцатеричное +представление данных и не оказывает влияние на символьное представление +в кодировке ASCII (или EBCDIC). +Аргументы командной строки +\-r, \-p, \-i не применяются в этом режиме. .TP .IR "\-g байт " | " \-groupsize байт" -Позволяет выполнять группировку указанного количества -.RI < байтов > -(две шестнадцатеричные цифры или восемь битов), отделяя группы друг от друга пробелами. +Выполнить группирование указанного количества +.RI < байт > +(две шестнадцатеричные цифры или восемь двоичных цифр), отделяя группы +друг от друга пробелами. Значение .I \-g 0 -применяется для отказа от использования группировки. +применяется для отказа от использования группирования. По умолчанию используется значение -.RI < байт "> равное " 2 -в обычном режиме и \fI1\fP в битовом режиме. Группировка не применяется -в режимах postscript и include. +.RI < байт ">, равное " 2 +при отображении в прямом порядке байт, \fI4\fP при отображении в обратном +порядке байт и \fI1\fP в двоичном режиме. Группировка не применяется +в режиме PostScript или include. .TP .IR \-h " | " \-help -Выводит справку по доступным ключам командной строки и завершает работу программы. +Показать краткую информацию об аргументах командной строки и завершить работу +программы. Создание шестнадцатеричного представления не выполняется. .TP .IR \-i " | " \-include -Позволяет создавать вывод в стиле подключаемых заголовочных файлов языка C. -Вывод содержит полноценное определение статического массива данных, имя которого -соответствует имени входного файла, если xxd не считывает данные из потока стандартного -ввода. +Создавать вывод в стиле подключаемых заголовочных файлов языка Си. +Вывод содержит полноценное определение статического массива данных, название +которого соответствует наименованию входного файла, если программа xxd +не считывает данные из стандартного потока ввода. .TP .IR "\-l длина " | " \-len длина" -Завершает работу после записи заданного в параметре +Указывает, что после записи заданного в параметре .RI < длина > -количества октетов. +количества октетов, работа программы будет завершена. +.TP +.I "\-n название " | " \-name название" +Изменить возвращаемое наименование переменной при использовании аргумента \-i. +Применяется к массиву байт, который будет именоваться как \fIназвание\fP и длина +файла как \fIназвание\fP_len. +.TP +.I \-o смещение +Указывает добавить +.RI < смещение > +в отображаемую позицию файла. .TP .IR \-p " | " \-ps " | " \-postscript " | " \-plain -Использует непрерывный формат вывода шестнадцатеричного кода, -известный как "простой" стиль или стиль "postscript". +Использовать непрерывный формата вывода шестнадцатеричного кода, +известного как "простой" стиль или стиль "PostScript". .TP .IR \-r " | " \-revert -Изменяет смысл операции на противоположный: позволяет выполнять преобразование -шестнадцатеричного представления в бинарный код (или применять результат в качестве заплаты). -Если вывод происходит не в поток стандартного вывода, то xxd выполняет добавление кода -к соответствующему файлу. При использовании комбинации ключей +Выполнить операцию обратного преобразования, т. е. преобразование +шестнадцатеричного представления в двоичный код (или применить результат +в качестве исправления). +Если вывод происходит не в стандартного поток вывода, то программа xxd выполняет +добавление кода к выходному файлу. При использовании комбинации аргументов .I \-r \-p происходит чтение "простого" шестнадцатеричного представления без использования -информации о номерах строк и какого-либо специального раскроя колонок. Пробелы -и символы новой строки могут встречаться в любом месте исходных данных. +информации о номерах строк и какого-либо специального распределения колонок. +Пробелы и символы новой строки могут встречаться в любом месте исходных данных. +При использовании комбинации аргументов +.I \-r \-b +будет происходить считывание двоичного представления вместо шестнадцатеричного. +.TP +.IR \-R " " когда +В выходных данных одни и те же шестнадцатеричные значения и строковые значения +будут подсвечиваться одним и тем же цветом. В основном это помогает различать +печатаемые и непечатаемые символы. +Где +.I \fIкогда\fP +может принимать значение +.BR never " (никогда), " always " (всегда), или " auto " (автовыбор, по умолчанию). +Если установлена переменная окружения +.BR $NO_COLOR +, то цветовая подсветка будет отключена. .TP .I \-seek смещение -При использовании после ключа +При указании после аргумента .I \-r -: добавлять указанное +, будет добавляться указанное .RI < смещение > к файловым позициям, обнаруженным в исходных данных. .TP -.I \-s [\+][\-]seek -Начинает работу с указанного абсолютного (или относительного) +.I \-s [+][\-]seek +Начинать обработку с указанного абсолютного (или относительного) .RI < смещения > в байтах во входном_файле. -\fI\+ \fRуказывает, что смещение является относительным по отношению -к текущей файловой позиции в потоке стандартного ввода (бессмысленно, если чтение -происходит не из потока стандартного ввода). \fI\- \fRуказывает, что должно быть прочитано -указанное количество символов от конца ввода (либо, если сочетается с \fI \+ \fR: -перед текущей позиции файла в потоке стандартного ввода). -Если ключ \-s не используется, то xxd начинает работу от текущей позиции в файле. +Где \fI+ \fRуказывает, что смещение является относительным по отношению +к текущей позиции данных в стандартном потоке ввода (бессмысленно, если чтение +происходит не из стандартного потока ввода). А параметр \fI\- \fRуказывает, +что должно быть прочитано указанное количество символов от конца ввода (либо, +если одновременно с параметром \fI+\fR, то перед текущей позицией данных +в стандартном потоке ввода). +Если аргумент \-s не используется, то программа xxd начинает обработку +от текущей позиции в файле. .TP .I \-u -Использует шестнадцатеричные цифры в верхнем регистре. По умолчанию используются цифры в -нижнем регистре символов. +Указывает, что в выводе отображать шестнадцатеричные цифры в верхнем регистре. +По умолчанию используются символы в нижнем регистре символов. .TP .IR \-v " | " \-version -Отображает информацию о версии программы. -.SH ПОДВОДНЫЕ КАМНИ +Показать информацию о версии программы и завершить работу. +.SH НЕКОТОРЫЕ РАЗЪЯСНЕНИЯ .PP +При указании команды .I xxd \-r -обладает встроенным интеллектом для распознавания информации о номерах строк. +при запуске программы, будет применяться некий встроенный алгоритм +для распознавания информации о номерах строк. Если возможен поиск по входному файлу, то номера строк в начале каждой строки -шестнадцатеричного представления могут быть неупорядоченными, некоторые строки могут -быть пропущены или пересекаться друг с другом. В этих случаях xxd использует -lseek(2) для перехода к следующей позиции. Если поиск по входному файлу -невозможен, то допустимы только пропуски строк, которые заполняются нулевыми -байтами. +шестнадцатеричного представления могут быть неупорядоченными, некоторые строки +могут быть пропущены или пересекаться друг с другом. В этих случаях программа +xxd использует функцию lseek(2) для перехода к следующей позиции. Если поиск по +входному файлу невозможен, то допустимы только пропуски строк, которые +заполняются нулевыми байтами. .PP +Использование команды .I xxd \-r -никогда не выводит сообщений об ошибках. Мусор пропускается молча. +приводит к тому, что сообщения об ошибках не будут отображаться. +Посторонние данные просто молча пропускаются. .PP -При редактировании шестнадцатеричных представлений бинарных файлов обращайте -внимание, что +При редактировании шестнадцатеричного представления двоичных файлов, обращайте +внимание, что по команде .I xxd \-r -пропускает в строке ввода любые данные после прочтения достаточного количества -колонок шестнадцатеричных данных (см. ключ \-c). Это означает, что изменения, -внесенные в колонки с печатными символами ascii (или ebcdic), всегда игнорируются. +, после считывания достаточного количества колонок шестнадцатеричных данных +(см. аргумент \-c), в строке ввода не будут обрабатываться остальные данные. +Это означает, что изменения, внесённые в колонке с текстом в кодировке +ASCII (или EBCDIC), всегда игнорируются. При обратном преобразовании шестнадцатеричного представления в стиле -postscript с помощью команды xxd \-r \-p количество колонок не учитывается. -В этом случае распознаются все символы, которые похожи на пары шестнадцатеричных цифр. +PostScript с помощью команды xxd \-r \-p количество колонок не учитывается. +В этом случае распознаются все символы, которые похожи на пары шестнадцатеричных +цифр. .PP Обратите внимание на различие между командами .PP @@ -186,125 +250,139 @@ postscript с помощью команды xxd \-r \-p количество к .I xxd \-s \+seek может отличаться от .I xxd \-s seek, -поскольку для того, чтобы "отмотать" данные на входе назад, используется вызов lseek(2). -При использовании `+' поведение будет отличаться, если входные данные -поступают с потока стандартного ввода, а позиция в файле стандартного ввода не находится -в начале файла к тому моменту, когда программа xxd запущена и приступает к чтению ввода. +поскольку для того, чтобы "отмотать" данные на входе назад, используется вызов +функции lseek(2). +При указании параметра '+' поведение будет отличаться, если входные данные +поступают со стандартного потока ввода, а позиция в файле стандартного ввода +не находится в начале файла к тому моменту, когда программа xxd запущена +и приступает к чтению ввода. Нижеследующие примеры помогут прояснить (или ещё больше запутать!) ситуацию... .PP -Отмотка назад потока стандартного ввода; необходимо, поскольку 'cat' уже выполнила -чтение до конца потока стандартного ввода: +Отмотка потока стандартного ввода назад необходима, поскольку программа 'cat' +уже выполнила чтение данных до конца из стандартного потока ввода: .PP -\fI% sh \-c 'cat > plain_copy; xxd \-s 0 > hex_copy' < file +\fI% sh \-c "cat > plain_copy; xxd \-s 0 > hex_copy" < file\fR .PP -Вывод шестнадцатеричного представления от позиции в файле 0x480 -(= 1024+128). -Символ `+' означает "относительно текущей позиции", таким образом `128' добавляется -к первому килобайту, где завершает работу dd: +Вывод шестнадцатеричного представления от позиции в файле 0x480 (=1024+128). +Параметр '+' означает "относительно текущей позиции", таким образом '128' +добавляется к первому килобайту, где завершает работу программа dd: .PP -\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file +\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +128 \> hex_snippet" < file\fR .PP -Вывод шестнадцатеричного представления от позиции в файле 0x100 -(= 1024-768): +Вывод шестнадцатеричного представления от позиции в файле 0x100 (=1024\[mi]768): .PP -\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file +\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +\-768 \> hex_snippet" < file\fR .PP -В то же время, следует заметить, что подобные ситуации встречаются довольно редко, -так что символ `+' обычно не используется. Автор предпочитает наблюдать за работой -xxd с помощью strace(1) или truss(1) в тех случаях, когда применяется ключ +В то же время, следует заметить, что подобные ситуации встречаются довольно +редко, так что параметр '+' обычно не используется. Автор предпочитает наблюдать +за работой программы xxd с помощью инструментов strace(1) или truss(1) в тех +случаях, когда применяется аргумент \-s. .SH ПРИМЕРЫ .PP .br -Вывести всё, кроме первых трёх строк (0x30 байтов) файла -.B file +Вывести всё, кроме первых трёх строк (0x30 байт) +.BR файла : -.PP -\fI% xxd \-s 0x30 file +.br +\fI% xxd \-s 0x30 file\fR .PP .br -Вывести три строки (0x30 байтов) от конца файла -.B file +Вывести три строки (0x30 байт) от конца +.BR файла : -.PP -\fI% xxd \-s \-0x30 file -.PP .br -Вывести 120 байтов в виде непрерывного шестнадцатеричного представления -по 20 октетов в строке: +\fI% xxd \-s \-0x30 file\fR .PP +.br +Вывести 120 байт в виде непрерывного шестнадцатеричного представления +по 20 октетов в строке +.br +(этот пример для справочника xxd.1 на английском языке, для русского языка будет +немного другой результат): +.br \fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR .br -2e544820585844203120224d616e75616c207061 +2e544820585844203120224d6179203230323422 .br -676520666f7220787864220a2e5c220a2e5c2220 +20224d616e75616c207061676520666f72207878 .br -32317374204d617920313939360a2e5c22204d61 +64220a2e5c220a2e5c222032317374204d617920 .br -6e207061676520617574686f723a0a2e5c222020 +313939360a2e5c22204d616e2070616765206175 .br -2020546f6e79204e7567656e74203c746f6e7940 +74686f723a0a2e5c2220202020546f6e79204e75 .br -7363746e7567656e2e7070702e67752e6564752e +67656e74203c746f6e79407363746e7567656e2e .br -.PP + +.br +Вывести первые 120 байт этого справочника по 12 октетов в строке +.br +(этот пример для справочника xxd.1 на английском языке, для русского языка будет +немного другой результат): .br -Вывести первые 120 байтов этой страницы справочника по 12 октетов в строке: -.PP \fI% xxd \-l 120 \-c 12 xxd.1\fR .br -0000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M +00000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M .br -000000c: 616e 7561 6c20 7061 6765 2066 anual page f +0000000c: 6179 2032 3032 3422 2022 4d61 ay 2024" "Ma .br -0000018: 6f72 2078 7864 220a 2e5c 220a or xxd"..\\". +00000018: 6e75 616c 2070 6167 6520 666f nual page fo .br -0000024: 2e5c 2220 3231 7374 204d 6179 .\\" 21st May +00000024: 7220 7878 6422 0a2e 5c22 0a2e r xxd"..\\".. .br -0000030: 2031 3939 360a 2e5c 2220 4d61 1996..\\" Ma +00000030: 5c22 2032 3173 7420 4d61 7920 \\" 21st May .br -000003c: 6e20 7061 6765 2061 7574 686f n page autho +0000003c: 3139 3936 0a2e 5c22 204d 616e 1996..\\" Man .br -0000048: 723a 0a2e 5c22 2020 2020 546f r:..\\" To +00000048: 2070 6167 6520 6175 7468 6f72 page author .br -0000054: 6e79 204e 7567 656e 7420 3c74 ny Nugent <t +00000054: 3a0a 2e5c 2220 2020 2054 6f6e :..\\" Ton .br -0000060: 6f6e 7940 7363 746e 7567 656e ony@sctnugen +00000060: 7920 4e75 6765 6e74 203c 746f y Nugent <to .br -000006c: 2e70 7070 2e67 752e 6564 752e .ppp.gu.edu. +0000006c: 6e79 4073 6374 6e75 6765 6e2e ny@sctnugen. .PP .br -Показать дату из файла xxd.1: +Показать дату из файла +.B xxd.1 +.br +(этот пример для справочника xxd.1 на английском языке, для русского языка будет +немного другая команда, например, для UTF-8 \[em] \flxxd \-s 0x50 \-l 13 \-c 13 xxd.1\fR): .PP -\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +\fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR .br -0000028: 3231 7374 204d 6179 2031 3939 21st May 199 +00000033: 3231 7374 204d 6179 2031 3939 36 21st May 1996 .PP .br Скопировать .B входной_файл в .B выходной_файл -с добавлением 100 байтов со значением 0x00 в начало файла: -.PP +с добавлением 100 байт со значением 0x00 в начало файла: +.br \fI% xxd входной_файл | xxd \-r \-s 100 \> выходной_файл\fR .br -.PP + .br -Заменить дату в файле xxd.1: +Заменить дату в файле +.B xxd.1 +.br +(этот пример для справочника xxd.1 на английском языке, для русского языка будут +немного другие команды): .PP -\fI% echo '0000029: 3574 68' | xxd \-r \- xxd.1\fR +\fI% echo "0000034: 3574 68" | xxd \-r \- xxd.1\fR .br -\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +\fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR .br -0000028: 3235 7468 204d 6179 2031 3939 25th May 199 +00000033: 3235 7468 204d 6179 2031 3939 36 25th May 1996 .PP .br -Создать 65537-байтный файл, все байты которого имеют значение -0x00, кроме последнего байта, который должен иметь значение 'A' -(0x41): +Создать 65537-байтный файл, все байты которого имеют значение 0x00, +кроме последнего байта, который должен иметь значение 'A' (0x41): .PP -\fI% echo '010000: 41' | xxd \-r \> file\fR +\fI% echo "010000: 41" | xxd \-r > file\fR .PP .br Создать шестнадцатеричное представление этого файла с @@ -312,97 +390,97 @@ xxd с помощью strace(1) или truss(1) в тех случаях, ког .PP \fI% xxd \-a \-c 12 file\fR .br -0000000: 0000 0000 0000 0000 0000 0000 ............ +00000000: 0000 0000 0000 0000 0000 0000 ............ .br * .br -000fffc: 0000 0000 40 ....A +0000fffc: 0000 0000 41 ....A .PP Создать 1-байтный файл, содержащий символ 'A'. -Число после '\-r \-s' добавляется к номерам строк, найденным в файле; +Число после аргументов '\-r \-s' добавляется к номерам строк, найденным в файле, иначе говоря, предшествующие байты пропускаются: .PP -\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> file\fR -.PP -xxd можно использовать в качестве фильтра в редакторе, например в -.B vim(1), -чтобы создать шестнадцатеричное представление области между -отметками `a' и `z': +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 > file\fR .PP +Программу xxd можно использовать в качестве фильтра в редакторе, например в +.B vim(1) +, чтобы создать шестнадцатеричное представление области между +закладками 'a' и 'z': +.br \fI:'a,'z!xxd\fR .PP -Вы можете использовать xxd в качестве фильтра в редакторе, например в -.B vim(1), -для восстановления данных из шестнадцатеричного представления -между отметками `a' и `z': -.PP +Можно использовать программу xxd в качестве фильтра в редакторе, например в +.B vim(1) +, для восстановления данных из шестнадцатеричного представления +между закладками 'a' и 'z': +.br \fI:'a,'z!xxd \-r\fR .PP -Вы можете использовать xxd в качестве фильтра в редакторе, например в -.B vim(1), -для восстановления данных из единственной строки +Можно использовать программу xxd в качестве фильтра в редакторе, например в +.B vim(1) +, для восстановления данных из единственной строки шестнадцатеричного представления. Поместите курсор в соответствующую строку и наберите -.PP +.br \fI!!xxd \-r\fR .PP Чтобы прочитать единственный символ из канала связи: -.PP +.br \fI% xxd \-c1 < /dev/term/b &\fR .br \fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR .br -\fI% echo \-n foo > /dev/term/b\fR +\fI% echo \-n foo \> /dev/term/b\fR .PP -.SH ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ -Программа xxd завершает работу со следующими значениями: +.SH КОДЫ ЗАВЕРШЕНИЯ +При завершении работы, программа xxd возвращает следующие значения: .TP 0 Ошибки не обнаружены. .TP \-1 Операция не поддерживается (выполнение -.I xxd \-r \-i +.I \%xxd \-r \-i пока невозможно). .TP 1 -Ошибка при разборе ключей командной строки. +Ошибка при разборе аргументов командной строки. .TP 2 -Проблемы во входном файле. +Ошибки во входном файле. .TP 3 -Проблемы в выходном файле. +Ошибки в выходном файле. .TP 4,5 Желательная позиция поиска недостижима. -.SH СМОТРИ ТАКЖЕ +.SH СМОТРИТЕ ТАКЖЕ uuencode(1), uudecode(1), patch(1) .br .SH ПРЕДУПРЕЖДЕНИЕ Странность этой программы соответствует особенностям мозга её создателя. -Используйте её на свой страх и риск. Копируйте файлы, отслеживайте -вызовы, становитесь волшебником. +Используйте её на свой страх и риск. Копируйте файлы, отслеживайте вызовы, +становитесь волшебником. .br .SH ВЕРСИЯ -Эта страница справочника документирует xxd версии 1.7. +Этот справочник документирует программу xxd версии 1.7 от 2024-05. .SH АВТОР .br -(c) 1990-1997 Юрген Вайгерт (Juergen Weigert) +(c) Юрген Вайгерт (Juergen Weigert), 1990-1997 .br -<jnweiger@informatik.uni-erlangen.de> +<jnweiger@informatik.uni\-erlangen.de> .LP Вы можете свободно распространять программу со ссылкой на меня. .br -Если использование этой программы принесло вам какой-то доход, -поделитесь со мной. +Если использование этой программы принесло вам какой-то доход, поделитесь со +мной. .br -Если вы потеряли деньги, то я тут не причём. +Если вы потеряли деньги, то я тут ни при чём. .PP -Первый вариант страницы справочника написан Тони Наджентом (Tony Nugent) +Первый вариант справочника написан Тони Наджентом (Tony Nugent) .br <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> .br -Небольшие изменения внесены Брамом Мооленааром (Bram Moolenaar). -Страница отредактирована Юргеном Вайгертом (Juergen Weigert). +Небольшие изменения внесены Брамом Моленаром (Bram Moolenaar). +Справочник отредактирован Юргеном Вайгертом (Juergen Weigert). .PP diff --git a/runtime/doc/xxd.1 b/runtime/doc/xxd.1 index c76f89b..2c00d53 100644 --- a/runtime/doc/xxd.1 +++ b/runtime/doc/xxd.1 @@ -1,4 +1,4 @@ -.TH XXD 1 "August 1996" "Manual page for xxd" +.TH XXD 1 "May 2024" "Manual page for xxd" .\" .\" 21st May 1996 .\" Man page author: @@ -190,7 +190,8 @@ When editing hex dumps, please note that skips everything on the input line after reading enough columns of hexadecimal data (see option \-c). This also means that changes to the printable ASCII (or EBCDIC) columns are always ignored. Reverting a plain (or PostScript) style -hex dump with xxd \-r \-p does not depend on the correct number of columns. Here, anything that looks like a pair of hex digits is interpreted. +hex dump with xxd \-r \-p does not depend on the correct number of columns. +Here, anything that looks like a pair of hex digits is interpreted. .PP Note the difference between .br @@ -224,7 +225,8 @@ Hex dump from file position 0x100 (=1024\-768) onwards. \fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +\-768 > hex_snippet" < file\fR .PP However, this is a rare situation and the use of `+' is rarely needed. -The author prefers to monitor the effect of xxd with strace(1) or truss(1), whenever \-s is used. +The author prefers to monitor the effect of xxd with strace(1) or truss(1), +whenever \-s is used. .SH EXAMPLES .PP .br @@ -239,22 +241,25 @@ Print 3 lines (hex 0x30 bytes) from the end of .br \fI% xxd \-s \-0x30 file\fR .PP +Note: The results of the examples below are relevant to the xxd.1 man page as of +May 2024 +.PP .br Print 120 bytes as a continuous hex dump with 20 octets per line. .br \fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR .br -2e54482058584420312022417567757374203139 +2e544820585844203120224d6179203230323422 .br -39362220224d616e75616c207061676520666f72 +20224d616e75616c207061676520666f72207878 .br -20787864220a2e5c220a2e5c222032317374204d +64220a2e5c220a2e5c222032317374204d617920 .br -617920313939360a2e5c22204d616e2070616765 +313939360a2e5c22204d616e2070616765206175 .br -20617574686f723a0a2e5c2220202020546f6e79 +74686f723a0a2e5c2220202020546f6e79204e75 .br -204e7567656e74203c746f6e79407363746e7567 +67656e74203c746f6e79407363746e7567656e2e .br .br @@ -262,32 +267,32 @@ Hex dump the first 120 bytes of this man page with 12 octets per line. .br \fI% xxd \-l 120 \-c 12 xxd.1\fR .br -0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A +00000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M .br -000000c: 7567 7573 7420 3139 3936 2220 ugust 1996" +0000000c: 6179 2032 3032 3422 2022 4d61 ay 2024" "Ma .br -0000018: 224d 616e 7561 6c20 7061 6765 "Manual page +00000018: 6e75 616c 2070 6167 6520 666f nual page fo .br -0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\\ +00000024: 7220 7878 6422 0a2e 5c22 0a2e r xxd"..\\".. .br -0000030: 220a 2e5c 2220 3231 7374 204d "..\\" 21st M +00000030: 5c22 2032 3173 7420 4d61 7920 \\" 21st May .br -000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\\" +0000003c: 3139 3936 0a2e 5c22 204d 616e 1996..\\" Man .br -0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut +00000048: 2070 6167 6520 6175 7468 6f72 page author .br -0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\\" +00000054: 3a0a 2e5c 2220 2020 2054 6f6e :..\\" Ton .br -0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent +00000060: 7920 4e75 6765 6e74 203c 746f y Nugent <to .br -000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug +0000006c: 6e79 4073 6374 6e75 6765 6e2e ny@sctnugen. .PP .br Display just the date from the file xxd.1 .br -\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +\fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR .br -0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996 +00000033: 3231 7374 204d 6179 2031 3939 36 21st May 1996 .PP .br Copy @@ -302,11 +307,11 @@ and prepend 100 bytes of value 0x00. .br Patch the date in the file xxd.1 .br -\fI% echo "0000037: 3574 68" | xxd \-r \- xxd.1\fR +\fI% echo "0000034: 3574 68" | xxd \-r \- xxd.1\fR .br -\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +\fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR .br -0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996 +00000033: 3235 7468 204d 6179 2031 3939 36 25th May 1996 .PP .br Create a 65537 byte file with all bytes 0x00, @@ -319,11 +324,11 @@ Hex dump this file with autoskip. .br \fI% xxd \-a \-c 12 file\fR .br -0000000: 0000 0000 0000 0000 0000 0000 ............ +00000000: 0000 0000 0000 0000 0000 0000 ............ .br * .br -000fffc: 0000 0000 40 ....A +0000fffc: 0000 0000 41 ....A .PP Create a 1 byte file containing a single 'A' character. The number after '\-r \-s' adds to the line numbers found in the file; @@ -388,7 +393,7 @@ The tool's weirdness matches its creator's brain. Use entirely at your own risk. Copy files. Trace it. Become a wizard. .br .SH VERSION -This manual page documents xxd version 1.7 +This manual page documents xxd version 1.7 from 2024-05. .SH AUTHOR .br (c) 1990-1997 by Juergen Weigert diff --git a/runtime/doc/xxd.man b/runtime/doc/xxd.man index b06971b..1251591 100644 --- a/runtime/doc/xxd.man +++ b/runtime/doc/xxd.man @@ -179,39 +179,42 @@ EXAMPLES Print 3 lines (hex 0x30 bytes) from the end of file. % xxd -s -0x30 file + Note: The results of the examples below are relevant to the xxd.1 man + page as of May 2024 + Print 120 bytes as a continuous hex dump with 20 octets per line. % xxd -l 120 -ps -c 20 xxd.1 - 2e54482058584420312022417567757374203139 - 39362220224d616e75616c207061676520666f72 - 20787864220a2e5c220a2e5c222032317374204d - 617920313939360a2e5c22204d616e2070616765 - 20617574686f723a0a2e5c2220202020546f6e79 - 204e7567656e74203c746f6e79407363746e7567 + 2e544820585844203120224d6179203230323422 + 20224d616e75616c207061676520666f72207878 + 64220a2e5c220a2e5c222032317374204d617920 + 313939360a2e5c22204d616e2070616765206175 + 74686f723a0a2e5c2220202020546f6e79204e75 + 67656e74203c746f6e79407363746e7567656e2e Hex dump the first 120 bytes of this man page with 12 octets per line. % xxd -l 120 -c 12 xxd.1 - 0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A - 000000c: 7567 7573 7420 3139 3936 2220 ugust 1996" - 0000018: 224d 616e 7561 6c20 7061 6765 "Manual page - 0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\ - 0000030: 220a 2e5c 2220 3231 7374 204d "..\" 21st M - 000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\" - 0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut - 0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\" - 0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent - 000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug + 00000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M + 0000000c: 6179 2032 3032 3422 2022 4d61 ay 2024" "Ma + 00000018: 6e75 616c 2070 6167 6520 666f nual page fo + 00000024: 7220 7878 6422 0a2e 5c22 0a2e r xxd"..\".. + 00000030: 5c22 2032 3173 7420 4d61 7920 \" 21st May + 0000003c: 3139 3936 0a2e 5c22 204d 616e 1996..\" Man + 00000048: 2070 6167 6520 6175 7468 6f72 page author + 00000054: 3a0a 2e5c 2220 2020 2054 6f6e :..\" Ton + 00000060: 7920 4e75 6765 6e74 203c 746f y Nugent <to + 0000006c: 6e79 4073 6374 6e75 6765 6e2e ny@sctnugen. Display just the date from the file xxd.1 - % xxd -s 0x36 -l 13 -c 13 xxd.1 - 0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996 + % xxd -s 0x33 -l 13 -c 13 xxd.1 + 00000033: 3231 7374 204d 6179 2031 3939 36 21st May 1996 Copy input_file to output_file and prepend 100 bytes of value 0x00. % xxd input_file | xxd -r -s 100 > output_file Patch the date in the file xxd.1 - % echo "0000037: 3574 68" | xxd -r - xxd.1 - % xxd -s 0x36 -l 13 -c 13 xxd.1 - 0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996 + % echo "0000034: 3574 68" | xxd -r - xxd.1 + % xxd -s 0x33 -l 13 -c 13 xxd.1 + 00000033: 3235 7468 204d 6179 2031 3939 36 25th May 1996 Create a 65537 byte file with all bytes 0x00, except for the last one which is 'A' (hex 0x41). @@ -219,9 +222,9 @@ EXAMPLES Hex dump this file with autoskip. % xxd -a -c 12 file - 0000000: 0000 0000 0000 0000 0000 0000 ............ + 00000000: 0000 0000 0000 0000 0000 0000 ............ * - 000fffc: 0000 0000 40 ....A + 0000fffc: 0000 0000 41 ....A Create a 1 byte file containing a single 'A' character. The number af‐ ter '-r -s' adds to the line numbers found in the file; in effect, the @@ -268,7 +271,7 @@ WARNINGS own risk. Copy files. Trace it. Become a wizard. VERSION - This manual page documents xxd version 1.7 + This manual page documents xxd version 1.7 from 2024-05. AUTHOR (c) 1990-1997 by Juergen Weigert @@ -282,4 +285,4 @@ AUTHOR <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> Small changes by Bram Moolenaar. Edited by Juergen Weigert. -Manual page for xxd August 1996 XXD(1) +Manual page for xxd May 2024 XXD(1) |