Skip to content

Commit 47b7bc7

Browse files
author
Rik
committed
maint: merge stable to default
2 parents 15af1fb + 0b7ddba commit 47b7bc7

File tree

1 file changed

+25
-13
lines changed

1 file changed

+25
-13
lines changed

libgui/languages/build_ts/README.md

Lines changed: 25 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,43 +2,55 @@
22

33
## Why updating and when?
44

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.
68

79
## How to update the files (*.ts)
810

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
1014

1115
- `libgui/languages/build_ts/update_ts_files`
1216

1317
which also determines the required search paths for each language.
1418

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
1621

1722
- `libgui/build_ts/octave-qt` and
1823
- `libgui/build_ts/octave-qsci`
1924

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.
2127

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`:
2330

2431
1. Change into `libgui/languages`
2532
2. Start the update by calling `build_ts/update_ts_files`
2633
3. Select the language files that should be updated
2734

2835
## Updating Qt and Qsci used for the language files
2936

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
3139

3240
- `libgui/build_ts/octave-qt` and
3341
- `libgui/build_ts/octave-qsci`
3442

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:
3646

3747
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
4353
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

Comments
 (0)