annotate src/po/README_mingw.txt @ 21311:e16619de8771 v8.2.1206

patch 8.2.1206: Vim9: crash in expr test when run in the GUI Commit: https://github.com/vim/vim/commit/1bce831e13c42daa3563c7f90432d9bd9b959b81 Author: Bram Moolenaar <Bram@vim.org> Date: Mon Jul 13 23:22:54 2020 +0200 patch 8.2.1206: Vim9: crash in expr test when run in the GUI Problem: Vim9: crash in expr test when run in the GUI. Solution: Temporarily comment out two test lines.
author Bram Moolenaar <Bram@vim.org>
date Mon, 13 Jul 2020 23:30:03 +0200
parents 7e367104f6b6
children 4027cefc2aab
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:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62 msgid "Messages maintainer: Bram Moolenaar <Bram@vim.org>"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63 You should include your name and E-mail address instead, for example:
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: