|
2 | 2 |
|
3 | 3 | ## Why updating and when?
|
4 | 4 |
|
5 |
| -Before a new release of Octave, the language files `libgui/languages/*.ts` have to be updated with changed or new strings in the source files in order to add translations afterwards. |
| 5 | +Before a new release of Octave, the language files `libgui/languages/*.ts` |
| 6 | +have to be updated with changed or new strings in the source files in order to |
| 7 | +add translations afterwards. |
6 | 8 |
|
7 | 9 | ## How to update the files (*.ts)
|
8 | 10 |
|
9 |
| - The update is carried out by the Qt-tool `lupdate` which collect strings in source files found in the search path(s) provided as input argument to `lupdate`. The tool `lupdate`is called from the script |
| 11 | +The update is carried out by the Qt-tool `lupdate` which collect strings in |
| 12 | +source files found in the search path(s) provided as input argument to |
| 13 | +`lupdate`. The tool `lupdate` is called from the script |
10 | 14 |
|
11 | 15 | - `libgui/languages/build_ts/update_ts_files`
|
12 | 16 |
|
13 | 17 | which also determines the required search paths for each language.
|
14 | 18 |
|
15 |
| -Besides source folders within `libgui`, the search path is extended by some Qt and Qsci files, collected in |
| 19 | +Besides source folders within `libgui`, the search path is extended by some Qt |
| 20 | +and Qsci files, collected in |
16 | 21 |
|
17 | 22 | - `libgui/build_ts/octave-qt` and
|
18 | 23 | - `libgui/build_ts/octave-qsci`
|
19 | 24 |
|
20 |
| -respectively, whenever there are no translation files for the language from Qt or QScintilla. |
| 25 | +respectively, whenever there are no translation files for the language from Qt |
| 26 | +or QScintilla. |
21 | 27 |
|
22 |
| -The Following steps are required in order to update the language files `libgui/languages/*.ts`: |
| 28 | +The following steps are required in order to update the language files |
| 29 | +`libgui/languages/*.ts`: |
23 | 30 |
|
24 | 31 | 1. Change into `libgui/languages`
|
25 | 32 | 2. Start the update by calling `build_ts/update_ts_files`
|
26 | 33 | 3. Select the language files that should be updated
|
27 | 34 |
|
28 | 35 | ## Updating Qt and Qsci used for the language files
|
29 | 36 |
|
30 |
| -From time to time, like, e.g., when a new major version of Qt is available, the source files in |
| 37 | +From time to time, for example when a new major version of Qt is available, the |
| 38 | +source files in |
31 | 39 |
|
32 | 40 | - `libgui/build_ts/octave-qt` and
|
33 | 41 | - `libgui/build_ts/octave-qsci`
|
34 | 42 |
|
35 |
| -should also be updated. These source are scanned for strings for language where no translation is provided by Qt and/or QScintilla. The sources are update with the following steps: |
| 43 | +should also be updated. These sources are scanned for strings for language |
| 44 | +where no translation is provided by Qt and/or QScintilla. The sources are |
| 45 | +updated with the following steps: |
36 | 46 |
|
37 | 47 | 1. Download the Qt sources (example for Qt6):
|
38 |
| - 1. `$ git clone git://code.qt.io/qt/qt5.git qt6` |
39 |
| - 2. `$ cd qt6` |
40 |
| - 3. `$ git switch 6.6` |
41 |
| - 4. `$ perl init-repository` |
42 |
| -2. [Download the latest QScintilla](https://riverbankcomputing.com/software/qscintilla/download) and unpack he archive to the desired location |
| 48 | + 1. `git clone git://code.qt.io/qt/qt5.git qt6` |
| 49 | + 2. `cd qt6` |
| 50 | + 3. `git switch 6.6` |
| 51 | + 4. `perl init-repository` |
| 52 | +2. [Download the latest QScintilla](https://riverbankcomputing.com/software/qscintilla/download) and unpack the archive to the desired location |
43 | 53 | 3. Change into `libgui/languages/build_ts`
|
44 |
| -4. Call `./update_external_sources path_qt path_qsci` where `path_qt` and `path_qsci` are the absolute or relative paths to the Qt and QScintilla sources respectively. |
| 54 | +4. Call `./update_external_sources path_qt path_qsci` where `path_qt` and |
| 55 | + `path_qsci` are the absolute or relative paths to the Qt and QScintilla |
| 56 | + sources respectively. |
0 commit comments