annotate runtime/lang/README.txt @ 29003:5113fc1ba2e2

Added tag v8.2.5023 for changeset 48d74a5822ebf289c3d9c6bd7d849f3ece848b02
author Bram Moolenaar <Bram@vim.org>
date Thu, 26 May 2022 17:00:06 +0200
parents 2a4a2dc35c55
children 0fdf36de4018
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
14372
2a4a2dc35c55 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 7
diff changeset
1 Language files for Vim: Translated menus
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3 The contents of each menu file is a sequence of lines with "menutrans"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 commands. Read one of the existing files to get an idea of how this works.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6 More information in the on-line help:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8 :help multilang-menus
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 :help :menutrans
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 :help 'langmenu'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 :help :language
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 The "$VIMRUNTIME/menu.vim" file will search for a menu translation file. This
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 depends on the value of the "v:lang" variable.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 "menu_" . v:lang . ".vim"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 When the 'menutrans' option is set, its value will be used instead of v:lang.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20 The file name is always lower case. It is the full name as the ":language"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21 command shows (the LC_MESSAGES value).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 For example, to use the Big5 (Taiwan) menus on MS-Windows the $LANG will be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 Chinese(Taiwan)_Taiwan.950
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27 and use the menu translation file:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29 $VIMRUNTIME/lang/menu_chinese(taiwan)_taiwan.950.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 On Unix you should set $LANG, depending on your shell:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 csh/tcsh: setenv LANG "zh_TW.Big5"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 sh/bash/ksh: export LANG="zh_TW.Big5"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 and the menu translation file is:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38 $VIMRUNTIME/lang/menu_zh_tw.big5.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40 The menu translation file should set the "did_menu_trans" variable so that Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 will not load another file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 AUTOMATIC CONVERSION
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 When Vim was compiled with multi-byte support, conversion between latin1 and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 UTF-8 will always be possible. Other conversions depend on the iconv
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 library, which is not always available.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49 For UTF-8 menu files which only use latin1 characters, you can rely on Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50 doing the conversion. Let the UTF-8 menu file source the latin1 menu file,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 and put "scriptencoding latin1" in that one.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 Other conversions may not always be available (e.g., between iso-8859-# and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 MS-Windows codepages), thus the converted menu file must be available.