Skip to content

chore: regenerate po/pot for app + man pages, translate Italian (pre-3.0.0) - #902

Merged
mrjimenez merged 3 commits into
amule-project:masterfrom
got3nks:chore/pre-release-po-pot-regen
Jun 7, 2026
Merged

chore: regenerate po/pot for app + man pages, translate Italian (pre-3.0.0)#902
mrjimenez merged 3 commits into
amule-project:masterfrom
got3nks:chore/pre-release-po-pot-regen

Conversation

@got3nks

@got3nks got3nks commented Jun 7, 2026

Copy link
Copy Markdown
Contributor

Pre-release pot/po refresh ahead of 3.0.0, per the plan in amule-org/amule-org.github.io#4. Three commits, one logical change each so reviewers can step through them.

1 · po/amule.pot + all 37 po/<lang>.po

Driven by scripts/update-po.sh (xgettext over POTFILES.in then msgmerge into every .po). The substantive change is the 16 Windows-installer translatable strings extracted into amule.pot via the packaging/windows/installer_strings.c stub added in #899 — each catalog gains those 16 entries with empty msgstr; the installer build's po-to-nsh.py bridge flips them from English fallback to translated text as soon as a non-empty msgstr is present.

The bulk of the diff outside that is cosmetic — gettext-tools rewraps some long strings and #: source-location refs shift by a few lines as source files have moved on since the last sweep. No msgid content was lost, no existing translation discarded.

2 · docs/man/po/manpages.pot + manpages-<lang>.po

Driven by po4a --no-translations --force po4a.config in docs/man/. Two things land:

  1. The stale #: source refs from docs/man: committed po/pot files are out of sync with po4a.config (stale .1 source refs) #894 now point at the templated *.1.in masters they actually come from (verified: 297 #: lines all read *.1.in, zero *.1 form remain) — in sync with po4a.config since the 5c9781e + a89d1e3 rename.
  2. The new msgids introduced by the audit fixes in docs/man: bring English masters back in sync with the source (#893) #900 (--configure-autostart, --force-zlib on amulecmd/amuleweb, --disable-fatal/--enable-stdin on amulegui, the -t/--category formatting + grammar / FILES section / GD-support / optional-arg clarifications) get extracted into manpages.pot and turn up as untranslated entries in each manpages-<lang>.po.

The rest of the man-page diff is line-wrap reflow — po4a 0.74 wraps strings differently than the version that last touched the catalogs. Fuzzy markers grow only on entries whose source string genuinely changed because of the #900 audit fixes.

3 · Italian translations for the strings introduced above

Closes out the Italian gap created by the prior two commits:

  • po/it.po — 14 newly translated installer-string entries (aMule (obbligatorio), Disinstalla, Crea un collegamento di aMule sul desktop., the running-process MessageBoxes, the upgrade-path DetailPrint, etc.) plus 4 fuzzy entries unfuzzied, including:

    • Uninstall had been msgmerge-mapped to the existing Installa translation — wrong direction; fixed to Disinstalla.
    • aMule application files (required). had been msgmerge-mapped to Integrazione di aMule non riuscita (unrelated); fixed to the literal File dell'applicazione aMule (obbligatori)..
  • docs/man/po/manpages-it.po — 9 newly translated entries (--configure-autostart, --force-zlib, the -t/--category clarification, the cas -o/-p optional-arg + GD-support paragraphs, the aMule-online-sign.* FILES entries) plus 5 fuzzy entries on synopsis lines and the "all link found" grammar fix.

Net: post-merge, it.po is 100% translated (was 1678/4 fuzzy/14 untranslated → 1696 translated/0 fuzzy/0 untranslated) and manpages-it.po is 100% translated (was 232/5 fuzzy/9 untranslated → 246 translated/0 fuzzy/0 untranslated).

Refs

Closes #894. Refs amule-org/amule-org.github.io#4.

got3nks added 3 commits June 7, 2026 14:47
Pre-release pot/po refresh ahead of 3.0.0. Driven by
scripts/update-po.sh which runs xgettext over POTFILES.in to
regenerate po/amule.pot and then msgmerge into every po/*.po.

The substantive change picked up by this sweep is the 16 Windows-
installer translatable strings extracted into amule.pot via the
packaging/windows/installer_strings.c stub added in amule-project#899 (the
LangString MYSTR_* set used by packaging/windows/installer.nsi via
the po-to-nsh.py bridge). Each catalog gains those 16 entries with
empty msgstr; translators see them in the next .po edit session and
the installer build's bridge script flips them from English
fallback to the translated text as soon as a non-empty msgstr is
present.

The bulk of the diff outside that is cosmetic: gettext-tools 0.27
rewraps some long strings differently than whatever version last
ran an update on the committed catalogs, and the #: source-location
refs shift by a few lines as source files have moved on since the
last sweep. No msgid content was lost; no existing translation was
discarded -- fuzzy markers grow only on entries whose source string
genuinely changed (e.g. man-page strings touched by the audit
fixes in amule-project#900).

Refs amule-org/amule-org.github.io#4 (pre-3.0.0 housekeeping).
Pre-release pot/po refresh ahead of 3.0.0. Runs

  cd docs/man && po4a --no-translations --force po4a.config

which re-walks the .1.in masters listed in po4a.config and rebuilds
docs/man/po/manpages.pot + each docs/man/po/manpages-<lang>.po from
scratch.

Two things land in this sweep:

  1. The stale #: source refs flagged in amule-project#894 now point at the
     templated masters they actually come from. All 297 #: lines
     read "*.1.in" (none of the old "*.1" form remain) -- in sync
     with po4a.config since the 5c9781e + a89d1e3 rename.

  2. The new msgids introduced by the man-page audit fixes in amule-project#900
     (--configure-autostart, --force-zlib on amulecmd/amuleweb,
     --disable-fatal/--enable-stdin on amulegui, the -t/--category
     formatting + grammar / FILES section / GD-support / optional-arg
     clarifications) get extracted into manpages.pot and turn up as
     untranslated entries in each manpages-<lang>.po.

The rest of the diff is line-wrap reflow -- po4a 0.74 wraps long
strings differently than the version that last touched the
catalogs, so msgid/msgstr bodies move across columns. No msgid
content was lost and no existing translation was discarded; fuzzy
markers grow only on entries whose source string genuinely changed
because of the amule-project#900 audit fixes.

Refs amule-org/amule-org.github.io#4 (pre-3.0.0 housekeeping)
Closes amule-project#894.
Picks up the entries left untranslated or marked fuzzy after the
preceding pot/po regen pass:

* po/it.po -- 14 untranslated installer-string entries (extracted
  from packaging/windows/installer_strings.c via amule-project#899) and 4 fuzzy
  entries:
  - 'Uninstall' had been msgmerge-mapped to the existing 'Installa'
    translation (wrong direction); fixed to 'Disinstalla'.
  - 'aMule application files (required).' had been msgmerge-mapped to
    the existing 'Integrazione di aMule non riuscita' translation
    (unrelated); fixed to the literal 'File dell'applicazione aMule
    (obbligatori).'.
  - 'Start aMule when I log in' kept the substantively correct
    existing translation, just unfuzzied.
  - The web-server-startup message updated to reference the
    -DBUILD_WEBSERVER=YES CMake flag we use today.

* docs/man/po/manpages-it.po -- 9 untranslated entries (the new
  --configure-autostart / --force-zlib / -t/--category / -o-and-p
  optional-arg / GD-support / aMule-online-sign FILES entries from
  the amule-project#900 audit fixes) and 5 fuzzy entries on synopsis lines and
  the 'all link found' grammar fix.

Refs amule-org/amule-org.github.io#4.
@mrjimenez
mrjimenez merged commit 3e9aec9 into amule-project:master Jun 7, 2026
7 checks passed
@danim7

danim7 commented Jun 7, 2026

Copy link
Copy Markdown
Contributor

@ngosang : We are two different persons translating into Spanish. To avoid doing the same work twice: are you working on the new strings after this PR? If not, i can do it myself this night.

mrjimenez pushed a commit that referenced this pull request Jun 7, 2026
mrjimenez pushed a commit that referenced this pull request Jun 7, 2026
got3nks added a commit to got3nks/amule that referenced this pull request Jun 7, 2026
…ule-project#912)

Extends existing categories (preferring extensions over new lines):
- Performance/Upload: amule-project#898 SlotAllocation default raised.
- Networking & Discovery: wire-parser hardening list extended with
  amule-project#879/amule-project#882/amule-project#890/amule-project#886; new amuleweb security hardening bullet
  consolidating ngosang's amule-project#869-amule-project#874 triage (all landed in amule-project#875);
  amulegui list extended with amule-project#857; shared-folder watcher extended
  with amule-project#858.
- Packaging: Windows installer i18n line extended with amule-project#899.
- Internals & Refactoring: new docs-polish + code-quality bullets
  covering amule-project#851/amule-project#855/amule-project#862/amule-project#888/amule-project#900/amule-project#866/amule-project#867/amule-project#895 and amule-project#909/amule-project#910/amule-project#912.
- Translations: new pre-release final-wave bullet covering amule-project#847/amule-project#856/
  amule-project#891/amule-project#908/amule-project#860/amule-project#904/amule-project#859/amule-project#863/amule-project#861/amule-project#880/amule-project#911/amule-project#901/amule-project#902/amule-project#889/amule-project#868/amule-project#853.
- Bug Fixes & Stability: amule-project#850/amule-project#854/amule-project#878/amule-project#906.
- CI: ccache wiring (amule-project#892, amule-project#903) + CodeQL binutils-dev (amule-project#907).

Contributors footer gains mifritscher and nguyenhoangminhhieu2004-gif
(both first-time contributors).

PR index extended through amule-project#912.
mrjimenez pushed a commit that referenced this pull request Jun 8, 2026
Extends existing categories (preferring extensions over new lines):
- Performance/Upload: #898 SlotAllocation default raised.
- Networking & Discovery: wire-parser hardening list extended with
  #879/#882/#890/#886; new amuleweb security hardening bullet
  consolidating ngosang's #869-#874 triage (all landed in #875);
  amulegui list extended with #857; shared-folder watcher extended
  with #858.
- Packaging: Windows installer i18n line extended with #899.
- Internals & Refactoring: new docs-polish + code-quality bullets
  covering #851/#855/#862/#888/#900/#866/#867/#895 and #909/#910/#912.
- Translations: new pre-release final-wave bullet covering #847/#856/
  #891/#908/#860/#904/#859/#863/#861/#880/#911/#901/#902/#889/#868/#853.
- Bug Fixes & Stability: #850/#854/#878/#906.
- CI: ccache wiring (#892, #903) + CodeQL binutils-dev (#907).

Contributors footer gains mifritscher and nguyenhoangminhhieu2004-gif
(both first-time contributors).

PR index extended through #912.
@got3nks
got3nks deleted the chore/pre-release-po-pot-regen branch June 8, 2026 10:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs/man: committed po/pot files are out of sync with po4a.config (stale .1 source refs)

3 participants