annotate src/po/README_mingw.txt @ 33713:9aa03e12b2b5 v9.0.2090

patch 9.0.2090: complete_info() skips entries with 'noselect' Commit: https://github.com/vim/vim/commit/57f9ce1a0977da13e5923214086795ffa2d28ce1 Author: Christian Brabandt <cb@256bit.org> Date: Sat Nov 4 09:58:14 2023 +0100 patch 9.0.2090: complete_info() skips entries with 'noselect' Problem: complete_info() skips entries with 'noselect' Solution: Check, if first entry is at original text state Unfortunately, Commit daef8c74375141974d61b85199b383017644978c introduced a regression, that when ':set completeopt+=noselect' is set and no completion item has been selected yet, it did not fill the complete_info['items'] list. This happened, because the current match item did not have the CP_ORIGINAL_TEXT flag set and then the cp->prev pointer did point to the original flag item, which caused the following while loop to not being run but being skipped instead. So when the 'noselect' is set, only start with to the previous selection item, if the initial completion item has the CP_ORIGINAL_TEXT flag set, else use the 2nd previous item instead. fixes: #13451 closes: #13452 Signed-off-by: Christian Brabandt <cb@256bit.org>
author Christian Brabandt <cb@256bit.org>
date Sat, 04 Nov 2023 10:15:04 +0100
parents def9fc5c92d1
children 45c0a5330758
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1 TRANSLATING VIM MESSAGES
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3 This file explains how to create and maintain po files using
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 gnu-gettext.win32, a MINGW32 Windows port of gettext by Franco Bez
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5 <franco.bez@gmx.de>. You can find it at:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 http://home.a-city.de/franco.bez/gettext/gettext_win32_en.html
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 First read the README.txt file for the general remarks
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 The file that does the work is Make_ming.mak in the po directory. It is an
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 adaptation of the Unix Makefile, but it does NOT test the presence of any po,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 pot, or mo files, so use it at your own risk but with care: it could even kill
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 your canary. It has been tested by me several times (and with different
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 languages) with success.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 The make utility must be run from the po directory.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19
2453
1cd1c68045a2 Fix typos in README files. (Dominique Pelle)
Bram Moolenaar <bram@vim.org>
parents: 440
diff changeset
20 First of all you must set the environment variable LANGUAGE to xx, where xx is
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21 the name of your language. You can do it from the command line or adding a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22 line to your autoexec.bat file: set LANGUAGE=xx. You must also add your
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 language to the Make_ming.mak file in the lines LANGUAGES, MOFILES, AND
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 POFILES.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26 If you don't have a xx.po file, you must create it with the command:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 make -f Make_ming.mak first_time
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30 This will produce a new brand xx.po file with all the messages in Vim ready
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 for translation. Then you must source the cleanup.vim script from inside Vim;
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32 it will comment the untranslated messages (now, all). I recommend to use
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 syntax highlighting so you can identify the untranslated messages easily.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 You also must remove the '..\' that prepends the name of the source files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 (I don't no why, but make is unable to change the directory from po to src and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 back to po, so all the work must be done from the po dir, hence the '..\')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38 Then you must go step (2) below.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40 If you are updating a po file you must follow the next steps (they are nearly
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 the same as in the Unix case, only the commands change):
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 (1) Add new and changed messages from the Vim sources:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45 make -f Make_ming.mak xx
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 This will extract all the strings from Vim and merge them in with the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 existing translations. Requires the GNU gettext utilities. Also requires
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49 unpacking the extra archive.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50 Your original xx.po file will be copied to xx.po.orig
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 -- After you do this, you MUST do the next three steps! --
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54 (2) Translate
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 See the gettext documentation on how to do this. You can also find
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56 examples in the other po files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
57 Search the po file for items that require translation:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
58 /\#\~ and also the fuzzy translations, /\#, fuzzy
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59 Remove "#~" and "#, fuzzy" after adding the translation.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
60
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61 There is one special message:
32770
4027cefc2aab Farewell to Bram and dedicate upcoming Vim 9.1 to him (#12749)
Christian Brabandt <cb@256bit.org>
parents: 7374
diff changeset
62 msgid "Messages maintainer: The Vim Project"
33223
def9fc5c92d1 patch 9.0.1886: Various Typos
Christian Brabandt <cb@256bit.org>
parents: 32770
diff changeset
63 You should include your name and e-mail address instead, for example:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
64 msgstr "Berichten übersetzt bei: John Doe <john@doe.org>"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
65
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
66 (3) Clean up
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
67 This is very important to make sure the translation works on all systems.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
68 Comment-out all non-translated strings. There are two types:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69 - items marked with "#, fuzzy"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
70 - items with an empty msgstr
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71 You can do this with the cleanup.vim script:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
72
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
73 :source cleanup.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
74
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75 (4) Check:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
76
440
eb531146be0e updated for version 7.0114
vimboss
parents: 7
diff changeset
77 vim -S check.vim xx.po
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
78 make -f Make_ming.mak xx.mo
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80 Look out for syntax errors and fix them.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82 (5) This is an extra step, ;-). If you want the vim.mo file installed in your
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
83 system you must run:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
84
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85 make -f Make_ming.mak install
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
87 This will create the xx\LC_MESSAGES directory (if it does not exist) and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88 will copy vim.po to it.
7374
7e367104f6b6 commit https://github.com/vim/vim/commit/013806229a1e15480592f6bc8453130685ec750b
Christian Brabandt <cb@256bit.org>
parents: 2453
diff changeset
89 You can also use the following command to install all languages:
7e367104f6b6 commit https://github.com/vim/vim/commit/013806229a1e15480592f6bc8453130685ec750b
Christian Brabandt <cb@256bit.org>
parents: 2453
diff changeset
90
7e367104f6b6 commit https://github.com/vim/vim/commit/013806229a1e15480592f6bc8453130685ec750b
Christian Brabandt <cb@256bit.org>
parents: 2453
diff changeset
91 make -f Make_ming.mak install-all
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
92
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93 (6) Another extra step ;-)). The command:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
94
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95 make -f Make_ming.mak clean
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
96
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
97 will delete the temp files created during the process.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
98
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
99 Suggestions will be welcomed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
101 Eduardo F. Amatria <eferna1@platea.pntic.mec.es>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
102
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103 Happy Vimming with NLS!!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
105 vim:tw=78: