From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#55250: [PATCH] Add Ukrainian tutorial Date: Wed, 04 May 2022 09:17:43 +0300 Message-ID: <83czgt4y9k.fsf@gnu.org> References: <4e7d4e649a87b149ae1f78eb980a99098be81167.camel@libre.net.ua> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="19861"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 55250@debbugs.gnu.org To: Denys Nykula Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed May 04 08:20:05 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nm8Mn-0004xC-8w for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 04 May 2022 08:20:05 +0200 Original-Received: from localhost ([::1]:52094 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nm8Ml-0000dg-Rl for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 04 May 2022 02:20:03 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38702) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nm8Ko-0000dV-IT for bug-gnu-emacs@gnu.org; Wed, 04 May 2022 02:18:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47602) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nm8Ko-0008VP-8z for bug-gnu-emacs@gnu.org; Wed, 04 May 2022 02:18:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nm8Ko-0006xe-15 for bug-gnu-emacs@gnu.org; Wed, 04 May 2022 02:18:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 04 May 2022 06:18:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 55250 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 55250-submit@debbugs.gnu.org id=B55250.165164505826727 (code B ref 55250); Wed, 04 May 2022 06:18:01 +0000 Original-Received: (at 55250) by debbugs.gnu.org; 4 May 2022 06:17:38 +0000 Original-Received: from localhost ([127.0.0.1]:41499 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nm8KP-0006x1-S8 for submit@debbugs.gnu.org; Wed, 04 May 2022 02:17:38 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:45348) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nm8KO-0006wm-Rm for 55250@debbugs.gnu.org; Wed, 04 May 2022 02:17:37 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:47676) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nm8KI-0007oO-Et; Wed, 04 May 2022 02:17:30 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=DRm5U48VpfSxcwfq4i9UXgk0evFozSahzlxs87xjoNI=; b=W/B8iBrH6SyB jTiqz9qFSqewdOUzd4h30lO0QmmW3ftrVRYwg4JhGwVwVhaF62SlfW5T8MpyBssbobYND0IMla6LS NE/e+x12eCGwDePenUVCmv1d/pYppSad9cUfE4lFa8E70cgI57jZb4CuJYehY0qi9wPQYmdA4F1cZ m2+pF/N0ibcX0CH03lejSHhMyG3ZUjmHbgo8UbRNSbnl04l7eAeeZn25b3gmgK2mo1IcAa4SOZRSS He+shkMamaMbQbjIfPdhecErn4V/hJwUkVS6ZX1KsI1SvROZjLcnFVOi0+nLdEtYiINh2/xE5a+Xi JsrTuFVrwBbS3O+DDDC9ew==; Original-Received: from [87.69.77.57] (port=4078 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nm8KH-00006F-TG; Wed, 04 May 2022 02:17:30 -0400 In-Reply-To: <4e7d4e649a87b149ae1f78eb980a99098be81167.camel@libre.net.ua> (message from Denys Nykula on Tue, 03 May 2022 22:34:09 +0300) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:231364 Archived-At: > From: Denys Nykula > Date: Tue, 03 May 2022 22:34:09 +0300 > > Hello. I translated the Emacs tutorial to Ukrainian. Thank you very much for this contribution, and for your interest in Emacs. > My translation has an additional section about installing and enabling > a known good version of reverse-im from MELPA using eww and shell- > command. That package makes all the default English bindings available > when writing long Cyrillic texts, such as this translation. This should not be in a tutorial. The translations of the tutorial should be strictly translations, with no additional material specific to the target language. And AFAUI from your short description, the reverse-im package is useful in very specific jobs, not in general for using Emacs in the Ukrainian language environment, so it is not appropriate for the tutorial in any case. Moreover, we generally refrain from advertising MELPA regardless, because that collection doesn't distinguish between Free and non-Free software packages it hosts. So for us to advertise that package, someone should submit it to either GNU ELPA or non-GNU ELPA; then we can think where in the Emacs documentation to mention it. So please remove that addition from the tutorial translation. > In lisp/language/cyrillic.el, using which I added the translation to > the menu, I see two sections about Ukrainian, both mentioning the koi8- > u layout. I have not seen anyone using that layout directly for over a > decade, as all new text here is UTF-8. But I am not familiar with the > codebase so I did not touch anything besides linking the tutorial. Thanks. KOI8-U is mentioned there as the preferred encoding. I understand you are saying this is obsolete, and Ukrainian users nowadays mostly use UTF-8 instead? Does it mean most Ukrainian Emacs users are forced to customize their Emacs to prefer UTF-8? Would it be possible for you to ask on some relevant forum whether indeed this is the case, so we have some more substantial basis for the decision to switch our defaults? What about input methods? do you have any information regarding modern input methods used for Ukrainian when the keyboard doesn't support the Ukrainian characters directly? Is the input method we set up by default in the Ukrainian language environment appropriate? > * etc/tutorials/TUTORIAL.uk: Create the translation. > * lisp/language/cyrillic.el: Link "Emacs Tutorial" > to the translation if the system is Ukrainian. > * etc/tutorials/TUTORIAL.translators: Attribute my work. Thanks. This addition of a new translation should be called out in etc/NEWS, as we have done for other added translations. > diff --git a/lisp/language/cyrillic.el b/lisp/language/cyrillic.el > index 4576373..9eaf00a 100644 > --- a/lisp/language/cyrillic.el > +++ b/lisp/language/cyrillic.el > @@ -131,7 +131,8 @@ 'koi8-u > :mime-charset 'koi8-u) > > (set-language-info-alist > - "Ukrainian" '((charset koi8-u) > + "Ukrainian" '((tutorial . "TUTORIAL.uk") > + (charset koi8-u) > (coding-system koi8-u) > (coding-priority koi8-u) > (nonascii-translation . koi8-u) As you see in other language-related settings, language-info-alist can include what we call "sample text", which is actually the greeting in the language from the etc/HELLO file. Would you like to add a Ukrainian greeting, both to the above setting of language-info-alist and to etc/HELLO? Finally, to be able to accept your contribution of this size, we'll need you to assign the copyright for your work to the FSF. If you are willing to do that, I will send you the form to fill and the instructions to go with it, to start your legal paperwork rolling. Thanks again for working on this.