Re: Farsi/Persian Translation of Emacs Tutorial -- Ready for Inclusion in the Next Emacs

[Mohsen BANAN]

Eli Zaretskii <eliz@gnu.org> writes:

>> From: Mohsen BANAN <emacs@mohsen.1.banan.byname.net>
>> Cc: emacs-devel@gnu.org
>> Date: Sun, 23 Apr 2023 21:58:09 -0700
>>
>> Attached are three files:
>>
>> 1) TUTORIAL.fa  --- NEW FILE
>>  which goes in etc/tutorials/TUTORIAL.fa
>>
>> 2) persian.el  --- NEW FILE
>>  which goes in lisp/language/persian.el
>>
>> 3) 0001-Added-persian.el-to-loadup.el-and-minor-fixes-in-lis.patch
>>  patches to lisp/loadup.el
>>    which adds language/persian.el
>>  patches to language/misc-lang.el
>>    which are purely comment oriented.
>>
>> This is how I did it for myself.
>>
>> If you want to follow the same pattern, it is best
>> to take the persian part out of misc-lang.el and
>> perhaps create a separate file for arabic.
>>
>> I leave the arrangement in your capable hands ...
>
> Thanks.  I added the tutorial to the emacs-29 branch, and updated the
> existing Persian language environment with the tutorial information
> (and made also other minor relevant changes due to this addition).

Thank you very much Eli.

I rebuilt and noticed a couple of problems.

If you enter the Help Persian tutorial and then try
to immediately exit emacs, you get an error.

Here is my *Messages* buffer after that:
------
Preparing tutorial ...
help-with-tutorial: Search failed: "
<<"
run-hook-with-args-until-failure: Symbol’s value as variable is void: 
tutorial--starting-point
-------

I looked into it and the problem turns out to be
in my TUTORIAL.fa file which then triggers the
void tutorial--starting-point in tutorial.el.

I had missed the invisible
<<Blank lines inserted around following line by help-with-tutorial>>
line, as I had translated from the Help command
and not the TUTORIAL file.

I have added the translation of that line and have
tested it. Please apply the attached file, thanks.

As for the void: tutorial--starting-point: you may
want to look into that and make it more robust.
And perhaps issue an error saying the
<<Blank lines ...>> is missing.

But, if no other translator had made that mistake,
then it is just me and we can leave it as is.

My apologies for that sloppiness and thanks again.

...Mohsen

From 19b77cf11d2d7054dd2ca754779bdab9070803a5 Mon Sep 17 00:00:00 2001
From: Mohsen Banan <form@mohsen.banan.1.byname.net>
Date: Tue, 25 Apr 2023 14:49:28 -0700
Subject: [PATCH] Missing <<inserted by help-with-tutorial>> line.

---
 etc/tutorials/TUTORIAL.fa | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/etc/tutorials/TUTORIAL.fa b/etc/tutorials/TUTORIAL.fa
index 5c9c0e1941a..a26b292be9f 100644
--- a/etc/tutorials/TUTORIAL.fa
+++ b/etc/tutorials/TUTORIAL.fa
@@ -17,11 +17,10 @@
 کاراکترهای ">>" در حاشیه سمت راست فرمانهایی را برای شمامشخص می کند. برای مثال:
 
 
-
+<<خطهای خالی بعد از خط بعدی توسط help-with-tutorial درج میشود>>
 [وسط صفحه برای اهداف آموزشی خالی مانده است. ادامه متن در زیر]
 
 
-
 >> اکنون C-v را تایپ کنید (نمایش صفحه بعدی) تا یک صفحه کامل به پایین بروید.
       (این کار را با نگه داشتن کلید CONTROL و فشار کلید v انجام دهید).
       از این پس، لطفاً هر زمان که به انتهای صفحه رسیدید، این کار را انجام دهید.
-- 
2.30.2