Minor improvement to various sections of Chapter 13. Scripting ( sections 2.6, 3.1, 3.2.5, 3.3.5)
2.6. Image-Dependent Scripts
?
1. Are there confusing references to Script-Fu menus in section Quoting 2.6. Image-Dependent Scripts
, https://docs.gimp.org/en/image-independent-script-fu.html:
Filters menu aCAR and CDRnd Script-Fu menu are regrouped in one Filters menu and organised according to new categories. Now if a plugin and a filter works similarly, they are nearby in the menu.
The Script-Fu menu only appears if you have loaded additional scripts: for example the gimp-resynthesizer pack corresponding to your Linux distribution (.deb, .rpm, .gz ...).
This looks to me a bit confusing. I suggest to replace it with:
The top level Filters menu, and a Script-Fu menu, are regrouped in a parent Filters menu, and a Script-Fu sub menu. Filters, and Filters → Script-Fu. This is according to new categories. Now if a plugin and a filter works similarly, they are nearby in the menu.
There can be another, top level, Script-Fu menu. It will appear only if you have loaded additional scripts, that are distributed separately from the basic gimp package. For example, the gimp-resynthesizer package from your Linux distribution (.deb, .rpm, .gz ...). Or home made, or downloaded, script-fus.
3.1. Getting Acquainted With Scheme
: add a few words about scheme
2. I suggest to add to 3.1. Getting Acquainted With Scheme
, https://docs.gimp.org/en/gimp-using-script-fu-tutorial.html the following 2 sentences:
Scheme is a minimalist dialect of the Lisp family of programming languages. Scheme consists of a small standard core with several tools for language extension.
These are the 2 opening sentences of Wikipedia's scheme article. They partially explain why scheme was chosen. and `hopefully' suggest the reader a broader context to look for.
3.2.5. Assigning A New Value To A Variable
modified?
3. Should the wording of the Note in section Outing the note in section 3.2.5. Assigning A New Value To A Variable
, https://docs.gimp.org/en/gimp-using-script-debian-l10n-english@lists.debian.orgfu-tutorial-identifier.html:
Note
The “\” indicates that there is no line break. Ignore it (don't type it in your Script-Fu console and don't hit Enter), just continue with the next line.
My problem is it begins with the word The
. My, possibly wrong, understanding of that note is the code in the page has a "\" character. Which is not the case. This is a general note. It does not refer to any particular code in the page. Unless my understating of the note is wrong, I suggest to change the wording as follow:
Note
A “\” at end of lines indicate there is no line break. Ignore it. Don't type it in your Script-Fu console, and don't hit Enter in the middle of a command. Just continue typing with the next line.
3.3.5. Accessing Values In A List
: What are the abbreviations for CAR and CDR?
4. Currently, section 3.3.5. Accessing Values In A List
, at https://docs.gimp.org/en/gimp-using-script-fu-tutorial-lists.html read
To access the values in a list, use the functions car and cdr, which return the first element of the list and the rest of the list, respectively. These functions break the list down into the head::tail construct I mentioned earlier.
In order to help memorize the abbreviations car
and cdr
better, if this can be achieved, I suggest:
To access the values in a list, use the functions car and cdr, which return the first element of the list and the rest of the list, respectively. These functions break the list down into the head::tail construct I mentioned earlier. The abbreviations for car and cdr are only indirectly related to this usage. They are more of historic tradition. The Wikipedia article CAR and CDR has more details about the context.