From patchwork Fri May 21 16:51:17 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: =?utf-8?q?Mario_Bl=C3=A4ttermann?= X-Patchwork-Id: 1926 Return-Path: Delivered-To: patchwork@archlinux.org Received: from mail.archlinux.org [95.216.189.61] by patchwork.archlinux.org with IMAP (fetchmail-6.4.19) for (single-drop); Fri, 21 May 2021 16:51:33 +0000 (UTC) Received: from mail.archlinux.org by mail.archlinux.org with LMTP id sFJxHRTlp2DcAAoAK+/4rw (envelope-from ) for ; Fri, 21 May 2021 16:51:32 +0000 Received: from luna.archlinux.org (luna.archlinux.org [5.9.250.164]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-384) server-signature RSA-PSS (4096 bits)) (No client certificate requested) by mail.archlinux.org (Postfix) with ESMTPS id DD5D35D02DD; Fri, 21 May 2021 16:51:31 +0000 (UTC) Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id 927222C8F1; Fri, 21 May 2021 16:51:31 +0000 (UTC) Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id B11452C8EC for ; Fri, 21 May 2021 16:51:30 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on luna.archlinux.org X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=none autolearn=unavailable version=3.4.6 X-Spam-BL-Results: Received: from mail.archlinux.org (mail.archlinux.org [95.216.189.61]) by luna.archlinux.org (Postfix) with ESMTPS for ; Fri, 21 May 2021 16:51:30 +0000 (UTC) Received: from mail-vk1-xa30.google.com (mail-vk1-xa30.google.com [IPv6:2607:f8b0:4864:20::a30]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-384) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by mail.archlinux.org (Postfix) with ESMTPS id B0AA75D02DC for ; Fri, 21 May 2021 16:51:29 +0000 (UTC) Received: by mail-vk1-xa30.google.com with SMTP id w3so4379017vkb.4 for ; Fri, 21 May 2021 09:51:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=JqszZHw3eB4Tz118TKZBFZvpRkrNv6xAnuUp4U2NO9c=; b=JLf4l5LA6K29ub2zc4afI8+MBaWa0Ye8dsSMtkxsUqCZWppZsEvHsSx3EZMC9NU3Dy Qv+50nH8lo3Hhx9HN54w9EfyXgQ68/+effO0yRrPRsqzihnAVCrgCkEjIKgTvuqry4MZ M3Mm01OzImuPjymaAwxzZYXG+/etTZGWinEv5pJCcRCE4j3+cDM7epy+CGafPZs16jSd OJO3GTTJt+DdDCkaC1HiwU9Ym5TTzIFCMF5Bzbd+P6evO+HzN7xMRhX0c25nVX3L8qf0 BCxrUPMqIe2q6RfSNwY+Vy7F8XcLjnh3Cx6dKjhmiU6xPkagnndth+uC+U5chLE9K0Th n3aA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=JqszZHw3eB4Tz118TKZBFZvpRkrNv6xAnuUp4U2NO9c=; b=hTk7kqweoimXY3Lvg1eUMqwRcsFVIdBSnhZ2+vjwOKsSZkb8WQfACHkk9UIFmthrdY OvoKDjUIUsEJsTgWlbhNjfIhRzghUWL8ikxCX+LlSB5RtGUzQ12s4oX8tSjgiG8cBWNj m7yLaNwHmUIafF3YcMwq48yAQbyiG+pmG5n2lXJYeRkxqWUos6vpwmc2u8+JCOfQGwL1 52c7p9dUwleFBpE6DHewuweLrmgtav8y5c2GBHGFWegsAjvhHBgMbq3E+mE3YQhVkIPw 2AmFpp7EckKsQBNvaJKHXFHig+eAaMNjvLmNYFP27faANy/VG+uDnPZTzJH6r2sAPeGZ ZUsA== X-Gm-Message-State: AOAM530Y+ZFmRruPyyJWkakkZ5yagjcDzIwEAh97lCn0+b8Y8SC5c/Kw IRTRayTUXqwTdtqkr5sCVhKq+sQbNkjcP5UTwkVov7qfso3mmg== X-Google-Smtp-Source: ABdhPJw5C182Hf462dOze6LtrqlrvSAHTi4HcJs/pMe1p6kFUhOuzYnva3C7GrcWmuk83W6eaj0WEVYiMCGo7qcNPOM= X-Received: by 2002:a1f:d905:: with SMTP id q5mr11258370vkg.9.1621615888182; Fri, 21 May 2021 09:51:28 -0700 (PDT) MIME-Version: 1.0 From: =?utf-8?q?Mario_Bl=C3=A4ttermann?= Date: Fri, 21 May 2021 18:51:17 +0200 Message-ID: To: Discussion list for pacman development , Rafael Fontenelle Subject: [pacman-dev] Translation of man pages X-BeenThere: pacman-dev@lists.archlinux.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Discussion list for pacman development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Discussion list for pacman development Errors-To: pacman-dev-bounces@lists.archlinux.org Sender: "pacman-dev" Authentication-Results: mail.archlinux.org; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20161025 header.b=JLf4l5LA; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (mail.archlinux.org: domain of pacman-dev-bounces@lists.archlinux.org designates 5.9.250.164 as permitted sender) smtp.mailfrom=pacman-dev-bounces@lists.archlinux.org X-Rspamd-Queue-Id: DD5D35D02DD X-Spamd-Result: default: False [2.89 / 15.00]; HAS_REPLYTO(0.00)[pacman-dev@lists.archlinux.org]; R_SPF_ALLOW(-0.20)[+ip4:5.9.250.164:c]; R_DKIM_REJECT(1.00)[gmail.com:s=20161025]; HAS_ATTACHMENT(0.00)[]; FREEMAIL_FROM(0.00)[gmail.com]; MIME_BASE64_TEXT_BOGUS(1.00)[]; MID_RHS_MATCH_FROMTLD(0.00)[]; TO_DN_ALL(0.00)[]; DKIM_TRACE(0.00)[gmail.com:-]; MIME_BASE64_TEXT(0.10)[]; RCPT_COUNT_TWO(0.00)[2]; RCVD_IN_DNSWL_MED(-0.40)[95.216.189.61:received,5.9.250.164:from]; MAILLIST(-0.20)[mailman]; MIME_TRACE(0.00)[0:+,1:+,2:+,3:~]; RCVD_TLS_LAST(0.00)[]; ASN(0.00)[asn:24940, ipnet:5.9.0.0/16, country:DE]; TAGGED_FROM(0.00)[]; FROM_NEQ_ENVFROM(0.00)[marioblaettermann@gmail.com,pacman-dev-bounces@lists.archlinux.org]; ARC_NA(0.00)[]; RCVD_COUNT_FIVE(0.00)[6]; FROM_HAS_DN(0.00)[]; MIME_GOOD(-0.10)[multipart/mixed,text/plain,text/x-patch]; REPLYTO_DOM_NEQ_FROM_DOM(0.00)[]; MIME_BAD_ATTACHMENT(1.60)[cfg]; HAS_LIST_UNSUB(-0.01)[]; RCVD_IN_DNSWL_NONE(0.00)[2607:f8b0:4864:20::a30:received]; NEURAL_HAM(-0.00)[-1.000]; FORGED_SENDER_MAILLIST(0.00)[]; DMARC_POLICY_SOFTFAIL(0.10)[gmail.com : SPF not aligned (relaxed),none] X-Rspamd-Server: mail.archlinux.org Hello, the translation help page [1] says: --- There are currently no efforts underway to include translated manual pages in the pacman codebase. However, this is not to say translations are unwelcome. If someone has experience with i18n man pages and how to best include them with our source, please contact the pacman-dev mailing list at pacman-dev@archlinux.org. --- OK, then let me introduce my approach. Although the man page translations are already maintained in the manpages-l10n project [2] for some years, I think it is it better to use Pacman's upstream tree instead. The external maintenance has some disadvantages: We download distribution packages, create the templates, translate them and release the translated man pages some months later. Besides this delay, we don't know how many users know about the existence of the translated versions. Having the translations in the upstream project (translated using Transifex) would be better, and the localized versions would be released with Pacman itself and always in sync with the English ones. See the attached patch and config file. The patch manpage-markup.diff fixes the Asciidoc markup to get Po4a [3] properly working. After applying the patch, put po4a.cfg in doc/po/. I've imported German, Brazilian Portuguese and French translations from manpages-l10n, but even compressed they are too big for the list. The .po files will follow in separate mails.To test the creation of the translated Asciidoc files, just run 'po4a po4a.cfg'. This command creates a translation template and a subdirectory for each language and saves the resulting files there. Once you have the Asciidoc files, they can be processed further like those in doc/. Unfortunately, I don't have neither Autotools nor Meson knowledge, maybe someone else can help with integration into the build systems? [1] https://archlinux.org/pacman/translation-help.html#_translating_manpages [2] https://salsa.debian.org/manpages-l10n-team/manpages-l10n [3] https://po4a.org/index.php.en Best Regards, Mario diff --git a/doc/makepkg.conf.5.asciidoc b/doc/makepkg.conf.5.asciidoc index 76c27f6a..a5ff4c99 100644 --- a/doc/makepkg.conf.5.asciidoc +++ b/doc/makepkg.conf.5.asciidoc @@ -39,11 +39,11 @@ Options well, and any protocol can have a download agent. Any spaces in option arguments are required to be escaped to avoid being split. Several examples are provided in the default makepkg.conf. - + - If present, `%u` will be replaced with the download URL. Otherwise, the - download URL will be placed on the end of the command. If present, `%o` will - be replaced with the local file name, plus a ``.part'' extension, which allows - makepkg to handle resuming file downloads. ++ +If present, `%u` will be replaced with the download URL. Otherwise, the +download URL will be placed on the end of the command. If present, `%o` will +be replaced with the local file name, plus a ``.part'' extension, which allows +makepkg to handle resuming file downloads. **VCSCLIENTS=(**\'protocol::package' ...**)**:: Sets the packages required to fetch version controlled source files. When @@ -282,9 +282,9 @@ Options Specify a command prefix for running pacman as root. If unset, makepkg will check for the presence of sudo(8) and su(1) in turn, and try the first one it finds. - + - If present, `%c` will be replaced with the shell-quoted form of the command - to run. Otherwise, the command to run is appended to the auth command. ++ +If present, `%c` will be replaced with the shell-quoted form of the command +to run. Otherwise, the command to run is appended to the auth command. diff --git a/doc/pacman.conf.5.asciidoc b/doc/pacman.conf.5.asciidoc index fd765f3d..fbf6ba78 100644 --- a/doc/pacman.conf.5.asciidoc +++ b/doc/pacman.conf.5.asciidoc @@ -127,10 +127,10 @@ Options instances of `%o` will be replaced with the local filename, plus a ``.part'' extension, which allows programs like wget to do file resumes properly. - + - This option is useful for users who experience problems with built-in - HTTP/FTP support, or need the more advanced proxy support that comes with - utilities like wget. ++ +This option is useful for users who experience problems with built-in +HTTP/FTP support, or need the more advanced proxy support that comes with +utilities like wget. *NoUpgrade =* file ...:: All files listed with a `NoUpgrade` directive will never be touched during diff --git a/doc/repo-add.8.asciidoc b/doc/repo-add.8.asciidoc index 8de4485b..1b637c2e 100644 --- a/doc/repo-add.8.asciidoc +++ b/doc/repo-add.8.asciidoc @@ -1,5 +1,5 @@ repo-add(8) -========== +=========== Name ----