{"thread":{"id":"61278","subject":"[PATCH v3] send-email: make it easy to discern the messages for each patch","startedAt":"2024-04-06T00:50:25Z","lastAt":"2024-04-06T01:34:54Z","messageCount":5,"participants":["Dragan Simic","Junio C Hamano"],"isPatch":true,"patchVersion":3,"patchTotal":null},"messages":[{"id":"492341","messageId":"e3212c0a4ad331685c68c13afcdbced20982ab32.1712364420.git.dsimic@manjaro.org","threadId":"61278","inReplyTo":null,"subject":"[PATCH v3] send-email: make it easy to discern the messages for each patch","fromName":"Dragan Simic","fromEmail":"dsimic@manjaro.org","sentAt":"2024-04-06T00:50:18Z","receivedAt":"2024-04-06T00:50:25Z","isPatch":true,"sender":{"key":"dsimic@manjaro.org","avatar":null},"body":"When sending multiple patches at once, without confirming the sending of each\npatch separately, the displayed result statuses of sending each patch become\nbunched together with the messages produced for the subsequent patch.  This\nunnecessarily makes discerning each of the result statuses a bit difficult,\nas visible in the sample output excerpt below:\n\n    ...\n    MIME-Version: 1.0\n    Content-Transfer-Encoding: 8bit\n\n    Result: 250\n    OK. Log says:\n    ...\n\nAs visible above, bunching the \"Result: <status-code>\" lines together with\nthe messages produced for the subsequent patch makes the output unreadable.\nThus, let's add a newline after each displayed result status, except after\nthe last one, to make the outputs more readable, as visible in the sample\noutput excerpt below, produced after the addition of vertical whitespace:\n\n    ...\n    MIME-Version: 1.0\n    Content-Transfer-Encoding: 8bit\n\n    Result: 250\n\n    OK. Log says:\n    ...\n\nThese changes don't emit additional vertical whitespace after the result\nstatus produced for the last processed patch, i.e. the vertical whitespace\nis treated as a separator.  This follows the Git's general approach of not\nwasting the vertical screen space whenever possible.\n\nThe way the additional vertical separation between the messages produced for\neach patch is introduced to the source code also moves the already existing\nnewline characters out of the couple of translatable strings, which should\nhelp a bit with the translation efforts.\n\nFollowing the approach of making the produced output more readable, also\nemit additional vertical whitespace after the \"Send this email [y/n/...]?\"\nprompt.  The subsequent produced messages were also bunched together with\nthis prompt, as visible in the excerpt right below, which also contributed\nto making the discerning of the produced outputs unnecessarily hard.\n\n    ...\n    Send this email? ([y]es|[n]o|[e]dit|[q]uit|[a]ll): y\n    OK. Log says:\n    ...\n\nAs the final touch, make the above-mentioned prompt emitted without using\nunderlined text, which also applies to any other produced prompts, which made\nthem somewhat hard on the eyes, especially because the prompt's tailing space\ncharacter was also underlined.\n\nWhile there, remove a couple of spotted stray newlines in the source code\nand convert one indentation from spaces to tabs, for consistency.\n\nThe associated test, t9001, requires no updates to cover these changes.\n\nHelped-by: Junio C Hamano <gitster@pobox.com>\nSigned-off-by: Dragan Simic <dsimic@manjaro.org>\n---\n\nNotes:\n     * send-email: make produced outputs more readable by separating\n       the result statuses and the prompts from the subsequent patch\n       outputs, and by no longer using underlined text for the prompts\n    \n    Changes in v3:\n        - Removed a redundant comment, as suggested by Junio [1]\n        - Did the right thing and made the vertical separators emitted as\n          message separators, instead of having them emitted as message\n          terminators, as suggested by Junio [1]\n        - Additional vertical whitespace is now also emitted after the\n          prompt for sending emails, to \"de-bunch\" it from the subsequent\n          messages and make discerning the messages easier\n        - The above-mentioned prompt no longer uses underlined text, to make\n          it significantly easier on the eyes\n        - Fixed one indentation by spaces to use tabs and removed one stray\n          newline in the source code, as spotted\n        - Updated and extended the patch description to cover the changes\n        - Updated the \"what's cooking\" summary to cover the changes\n        - Cleaned up the older notes a bit\n    \n    Changes in v2:\n        - Improved the way additional newline separators are introduced to\n          the source code, as suggested by Junio, [2], to help a bit with\n          the translation efforts\n        - Improved the patch subject and description a bit, to provide some\n          additional information, as suggested by Junio [2]\n        - Added a Helped-by tag\n    \n    Notes for v1:\n        - This is a resubmission of the patch I submitted about a week and\n          a half ago; [3]  the patch subject in the original submission was\n          selected in a bit unfortunate way, which this submission corrects,\n          and also improves the patch description a bit\n        - There are no changes to the patch itself, vs. the original patch\n    \n    Link to v1: https://lore.kernel.org/git/62553db377c28458883b66bcdc0c58cc0f32d15b.1712250366.git.dsimic@manjaro.org/T/#u\n    Link to v2: https://lore.kernel.org/git/0e087ed992def0746f3d437253248904c2126464.1712262791.git.dsimic@manjaro.org/T/#u\n    \n    [1] https://lore.kernel.org/git/xmqqzfu8yc40.fsf@gitster.g/\n    [2] https://lore.kernel.org/git/xmqqy19tylrm.fsf@gitster.g/\n    [3] https://lore.kernel.org/git/6ee28707b9eb8bd8fdfc8756c351455c6bc3bb62.1711447365.git.dsimic@manjaro.org/\n\nRange-diff against v2:\n1:  0e087ed992de ! 1:  e3212c0a4ad3 send-email: make it easy to discern the messages for each patch\n    @@ Commit message\n     \n         As visible above, bunching the \"Result: <status-code>\" lines together with\n         the messages produced for the subsequent patch makes the output unreadable.\n    -    Thus, let's add a newline after each displayed result status, to make the\n    -    outputs more readable, as visible in the sample output excerpt below:\n    +    Thus, let's add a newline after each displayed result status, except after\n    +    the last one, to make the outputs more readable, as visible in the sample\n    +    output excerpt below, produced after the addition of vertical whitespace:\n     \n             ...\n             MIME-Version: 1.0\n             Content-Transfer-Encoding: 8bit\n     \n             Result: 250\n     \n             OK. Log says:\n             ...\n     \n    -    This change also adds a newline after the last produced result status, which\n    -    may be seen as redundant.  Though, it doesn't look too bad, and making that\n    -    last newline not displayed would make the code much more complex, which would\n    -    not be worth neither the time and effort now, nor the additional maintenance\n    -    burden in the future.\n    +    These changes don't emit additional vertical whitespace after the result\n    +    status produced for the last processed patch, i.e. the vertical whitespace\n    +    is treated as a separator.  This follows the Git's general approach of not\n    +    wasting the vertical screen space whenever possible.\n     \n    -    The way the additional newline separators are introduced to the source code\n    -    also moves the already existing newline characters out of the translatable\n    -    strings, which should help a bit with the translation efforts.\n    +    The way the additional vertical separation between the messages produced for\n    +    each patch is introduced to the source code also moves the already existing\n    +    newline characters out of the couple of translatable strings, which should\n    +    help a bit with the translation efforts.\n     \n    -    While there, remove one spotted stray newline in the source code.\n    +    Following the approach of making the produced output more readable, also\n    +    emit additional vertical whitespace after the \"Send this email [y/n/...]?\"\n    +    prompt.  The subsequent produced messages were also bunched together with\n    +    this prompt, as visible in the excerpt right below, which also contributed\n    +    to making the discerning of the produced outputs unnecessarily hard.\n    +\n    +        ...\n    +        Send this email? ([y]es|[n]o|[e]dit|[q]uit|[a]ll): y\n    +        OK. Log says:\n    +        ...\n    +\n    +    As the final touch, make the above-mentioned prompt emitted without using\n    +    underlined text, which also applies to any other produced prompts, which made\n    +    them somewhat hard on the eyes, especially because the prompt's tailing space\n    +    character was also underlined.\n    +\n    +    While there, remove a couple of spotted stray newlines in the source code\n    +    and convert one indentation from spaces to tabs, for consistency.\n    +\n    +    The associated test, t9001, requires no updates to cover these changes.\n     \n         Helped-by: Junio C Hamano <gitster@pobox.com>\n         Signed-off-by: Dragan Simic <dsimic@manjaro.org>\n     \n     \n      ## Notes ##\n          * send-email: make produced outputs more readable by separating\n    -       the result statuses from the subsequent patch outputs\n    +       the result statuses and the prompts from the subsequent patch\n    +       outputs, and by no longer using underlined text for the prompts\n    +\n    +    Changes in v3:\n    +        - Removed a redundant comment, as suggested by Junio [1]\n    +        - Did the right thing and made the vertical separators emitted as\n    +          message separators, instead of having them emitted as message\n    +          terminators, as suggested by Junio [1]\n    +        - Additional vertical whitespace is now also emitted after the\n    +          prompt for sending emails, to \"de-bunch\" it from the subsequent\n    +          messages and make discerning the messages easier\n    +        - The above-mentioned prompt no longer uses underlined text, to make\n    +          it significantly easier on the eyes\n    +        - Fixed one indentation by spaces to use tabs and removed one stray\n    +          newline in the source code, as spotted\n    +        - Updated and extended the patch description to cover the changes\n    +        - Updated the \"what's cooking\" summary to cover the changes\n    +        - Cleaned up the older notes a bit\n     \n         Changes in v2:\n             - Improved the way additional newline separators are introduced to\n    -          the source code, as suggested by Junio, [1], to help a bit with\n    +          the source code, as suggested by Junio, [2], to help a bit with\n               the translation efforts\n             - Improved the patch subject and description a bit, to provide some\n    -          additional information, as suggested by Junio [1]\n    +          additional information, as suggested by Junio [2]\n    +        - Added a Helped-by tag\n     \n         Notes for v1:\n             - This is a resubmission of the patch I submitted about a week and\n    -          a half ago. [2]  The patch subject in the original submission was\n    +          a half ago; [3]  the patch subject in the original submission was\n               selected in a bit unfortunate way, which this submission corrects,\n    -          and also improves the patch description a bit.\n    -        - There are no changes to the patch itself, vs. the original patch.\n    +          and also improves the patch description a bit\n    +        - There are no changes to the patch itself, vs. the original patch\n     \n         Link to v1: https://lore.kernel.org/git/62553db377c28458883b66bcdc0c58cc0f32d15b.1712250366.git.dsimic@manjaro.org/T/#u\n    +    Link to v2: https://lore.kernel.org/git/0e087ed992def0746f3d437253248904c2126464.1712262791.git.dsimic@manjaro.org/T/#u\n     \n    -    [1] https://lore.kernel.org/git/xmqqy19tylrm.fsf@gitster.g/\n    -    [2] https://lore.kernel.org/git/6ee28707b9eb8bd8fdfc8756c351455c6bc3bb62.1711447365.git.dsimic@manjaro.org/\n    +    [1] https://lore.kernel.org/git/xmqqzfu8yc40.fsf@gitster.g/\n    +    [2] https://lore.kernel.org/git/xmqqy19tylrm.fsf@gitster.g/\n    +    [3] https://lore.kernel.org/git/6ee28707b9eb8bd8fdfc8756c351455c6bc3bb62.1711447365.git.dsimic@manjaro.org/\n     \n      ## git-send-email.perl ##\n    +@@ git-send-email.perl: sub format_2822_time {\n    + my $compose_filename;\n    + my $force = 0;\n    + my $dump_aliases = 0;\n    ++my $needs_separator = 0;\n    + \n    + # Variables to prevent short format-patch options from being captured\n    + # as abbreviated send-email options\n    +@@ git-send-email.perl: sub get_patch_subject {\n    + \t\t\t$term = $ENV{\"GIT_SEND_EMAIL_NOTTY\"}\n    + \t\t\t\t? Term::ReadLine->new('git-send-email', \\*STDIN, \\*STDOUT)\n    + \t\t\t\t: Term::ReadLine->new('git-send-email');\n    ++\t\t\t$term->ornaments(0);\n    + \t\t}\n    + \t\treturn $term;\n    + \t}\n    +@@ git-send-email.perl: sub smtp_host_string {\n    + \n    + # Returns 1 if authentication succeeded or was not necessary\n    + # (smtp_user was not specified), and 0 otherwise.\n    +-\n    + sub smtp_auth_maybe {\n    + \tif (!defined $smtp_authuser || $auth || (defined $smtp_auth && $smtp_auth eq \"none\")) {\n    + \t\treturn 1;\n    +@@ git-send-email.perl: sub gen_header {\n    + sub send_message {\n    + \tmy ($recipients_ref, $to, $date, $gitversion, $cc, $ccline, $header) = gen_header();\n    + \tmy @recipients = @$recipients_ref;\n    ++\tmy $prompt_separator = 0;\n    + \n    + \tmy @sendmail_parameters = ('-i', @recipients);\n    + \tmy $raw_from = $sender;\n    +@@ git-send-email.perl: sub send_message {\n    + \t\t\texit(0);\n    + \t\t} elsif (/^a/i) {\n    + \t\t\t$confirm = 'never';\n    ++\t\t\t$needs_separator = 1;\n    + \t\t}\n    ++\t\t$prompt_separator = 1;\n    ++\t} else {\n    ++\t\t$needs_separator = 1;\n    + \t}\n    + \n    + \tunshift (@sendmail_parameters, @smtp_server_options);\n     @@ git-send-email.perl: sub send_message {\n      \t\tprint $sm \"$header\\n$message\";\n      \t\tclose $sm or die $!;\n      \t} else {\n     -\n      \t\tif (!defined $smtp_server) {\n      \t\t\tdie __(\"The required SMTP server is not properly defined.\")\n      \t\t}\n    +@@ git-send-email.perl: sub send_message {\n    + \t\t$smtp->dataend() or die $smtp->message;\n    + \t\t$smtp->code =~ /250|200/ or die sprintf(__(\"Failed to send %s\\n\"), $subject).$smtp->message;\n    + \t}\n    ++\tprint \"\\n\" if ($prompt_separator);\n    + \tif ($quiet) {\n    + \t\tprintf($dry_run ? __(\"Dry-Sent %s\\n\") : __(\"Sent %s\\n\"), $subject);\n    + \t} else {\n     @@ git-send-email.perl: sub send_message {\n      \t\tprint $header, \"\\n\";\n      \t\tif ($smtp) {\n      \t\t\tprint __(\"Result: \"), $smtp->code, ' ',\n     -\t\t\t\t($smtp->message =~ /\\n([^\\n]+\\n)$/s), \"\\n\";\n     +\t\t\t\t($smtp->message =~ /\\n([^\\n]+\\n)$/s);\n      \t\t} else {\n     -\t\t\tprint __(\"Result: OK\\n\");\n     +\t\t\tprint __(\"Result: OK\");\n      \t\t}\n    -+\t\t# Make it easy to discern the messages for each patch\n    -+\t\tprint \"\\n\\n\";\n    ++\t\tprint \"\\n\";\n      \t}\n      \n      \treturn 1;\n    +@@ git-send-email.perl: sub pre_process_file {\n    + sub process_file {\n    + \tmy ($t) = @_;\n    + \n    +-        pre_process_file($t, $quiet);\n    ++\tpre_process_file($t, $quiet);\n    ++\tprint \"\\n\" if ($needs_separator);\n    + \n    + \tmy $message_was_sent = send_message();\n    + \tif ($message_was_sent == -1) {\n\n git-send-email.perl | 18 +++++++++++++-----\n 1 file changed, 13 insertions(+), 5 deletions(-)\n\ndiff --git a/git-send-email.perl b/git-send-email.perl\nindex 821b2b3a135a..d445c22026df 100755\n--- a/git-send-email.perl\n+++ b/git-send-email.perl\n@@ -212,6 +212,7 @@ sub format_2822_time {\n my $compose_filename;\n my $force = 0;\n my $dump_aliases = 0;\n+my $needs_separator = 0;\n \n # Variables to prevent short format-patch options from being captured\n # as abbreviated send-email options\n@@ -936,6 +937,7 @@ sub get_patch_subject {\n \t\t\t$term = $ENV{\"GIT_SEND_EMAIL_NOTTY\"}\n \t\t\t\t? Term::ReadLine->new('git-send-email', \\*STDIN, \\*STDOUT)\n \t\t\t\t: Term::ReadLine->new('git-send-email');\n+\t\t\t$term->ornaments(0);\n \t\t}\n \t\treturn $term;\n \t}\n@@ -1361,7 +1363,6 @@ sub smtp_host_string {\n \n # Returns 1 if authentication succeeded or was not necessary\n # (smtp_user was not specified), and 0 otherwise.\n-\n sub smtp_auth_maybe {\n \tif (!defined $smtp_authuser || $auth || (defined $smtp_auth && $smtp_auth eq \"none\")) {\n \t\treturn 1;\n@@ -1510,6 +1511,7 @@ sub gen_header {\n sub send_message {\n \tmy ($recipients_ref, $to, $date, $gitversion, $cc, $ccline, $header) = gen_header();\n \tmy @recipients = @$recipients_ref;\n+\tmy $prompt_separator = 0;\n \n \tmy @sendmail_parameters = ('-i', @recipients);\n \tmy $raw_from = $sender;\n@@ -1554,7 +1556,11 @@ sub send_message {\n \t\t\texit(0);\n \t\t} elsif (/^a/i) {\n \t\t\t$confirm = 'never';\n+\t\t\t$needs_separator = 1;\n \t\t}\n+\t\t$prompt_separator = 1;\n+\t} else {\n+\t\t$needs_separator = 1;\n \t}\n \n \tunshift (@sendmail_parameters, @smtp_server_options);\n@@ -1576,7 +1582,6 @@ sub send_message {\n \t\tprint $sm \"$header\\n$message\";\n \t\tclose $sm or die $!;\n \t} else {\n-\n \t\tif (!defined $smtp_server) {\n \t\t\tdie __(\"The required SMTP server is not properly defined.\")\n \t\t}\n@@ -1663,6 +1668,7 @@ sub send_message {\n \t\t$smtp->dataend() or die $smtp->message;\n \t\t$smtp->code =~ /250|200/ or die sprintf(__(\"Failed to send %s\\n\"), $subject).$smtp->message;\n \t}\n+\tprint \"\\n\" if ($prompt_separator);\n \tif ($quiet) {\n \t\tprintf($dry_run ? __(\"Dry-Sent %s\\n\") : __(\"Sent %s\\n\"), $subject);\n \t} else {\n@@ -1686,10 +1692,11 @@ sub send_message {\n \t\tprint $header, \"\\n\";\n \t\tif ($smtp) {\n \t\t\tprint __(\"Result: \"), $smtp->code, ' ',\n-\t\t\t\t($smtp->message =~ /\\n([^\\n]+\\n)$/s), \"\\n\";\n+\t\t\t\t($smtp->message =~ /\\n([^\\n]+\\n)$/s);\n \t\t} else {\n-\t\t\tprint __(\"Result: OK\\n\");\n+\t\t\tprint __(\"Result: OK\");\n \t\t}\n+\t\tprint \"\\n\";\n \t}\n \n \treturn 1;\n@@ -1920,7 +1927,8 @@ sub pre_process_file {\n sub process_file {\n \tmy ($t) = @_;\n \n-        pre_process_file($t, $quiet);\n+\tpre_process_file($t, $quiet);\n+\tprint \"\\n\" if ($needs_separator);\n \n \tmy $message_was_sent = send_message();\n \tif ($message_was_sent == -1) {\n"},{"id":"492345","messageId":"xmqq8r1rs39g.fsf@gitster.g","threadId":"61278","inReplyTo":"e3212c0a4ad331685c68c13afcdbced20982ab32.1712364420.git.dsimic@manjaro.org","subject":"Re: [PATCH v3] send-email: make it easy to discern the messages for each patch","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2024-04-06T01:12:27Z","receivedAt":"2024-04-06T01:12:30Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Dragan Simic <dsimic@manjaro.org> writes:\n\n> As the final touch, make the above-mentioned prompt emitted without using\n> underlined text, which also applies to any other produced prompts, which made\n> them somewhat hard on the eyes, especially because the prompt's tailing space\n> character was also underlined.\n\nDon't do this, or at least don't do this in the same patch.\n\nAnother lesson to learn: resist temptation to grow the scope of the\ntopic.  Especially with ascetics, your preference may not be shared\nby other users, which would easily hold up the main part of the\npatch you wanted to improve and the reviewers have already spent\neffort on to polish to be ready.  Also are you sure in everybody's\nenvironment that ->ornaments() call is available and effective?\nThat is another thing that can hold up the rest of this change.\nDon't waste your effort so far and build it as a follow-up patch\nand do so after the dust settles.\n\nThanks.\n\n\n"},{"id":"492346","messageId":"235fa26a0803f7a8868fe908e4689bda@manjaro.org","threadId":"61278","inReplyTo":"xmqq8r1rs39g.fsf@gitster.g","subject":"Re: [PATCH v3] send-email: make it easy to discern the messages for each patch","fromName":"Dragan Simic","fromEmail":"dsimic@manjaro.org","sentAt":"2024-04-06T01:17:56Z","receivedAt":"2024-04-06T01:17:59Z","isPatch":true,"sender":{"key":"dsimic@manjaro.org","avatar":null},"body":"On 2024-04-06 03:12, Junio C Hamano wrote:\n> Dragan Simic <dsimic@manjaro.org> writes:\n> \n>> As the final touch, make the above-mentioned prompt emitted without \n>> using\n>> underlined text, which also applies to any other produced prompts, \n>> which made\n>> them somewhat hard on the eyes, especially because the prompt's \n>> tailing space\n>> character was also underlined.\n> \n> Don't do this, or at least don't do this in the same patch.\n> \n> Another lesson to learn: resist temptation to grow the scope of the\n> topic.  Especially with ascetics, your preference may not be shared\n> by other users, which would easily hold up the main part of the\n> patch you wanted to improve and the reviewers have already spent\n> effort on to polish to be ready.\n\nSo many lessons to learn. :)  Makes sense, here comes the v4, and\nan additional follow-up patch.\n\n> Also are you sure in everybody's\n> environment that ->ornaments() call is available and effective?\n> That is another thing that can hold up the rest of this change.\n> Don't waste your effort so far and build it as a follow-up patch\n> and do so after the dust settles.\n\nAccording to my research, the \"->ornaments(0)\" call should work in\nall environments as expected.  It's also officially documented. [1]\n\n[1] https://perldoc.perl.org/Term::ReadLine#ornaments\n"},{"id":"492357","messageId":"xmqqttkfqnvm.fsf@gitster.g","threadId":"61278","inReplyTo":"235fa26a0803f7a8868fe908e4689bda@manjaro.org","subject":"Re: [PATCH v3] send-email: make it easy to discern the messages for each patch","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2024-04-06T01:30:05Z","receivedAt":"2024-04-06T01:30:11Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Dragan Simic <dsimic@manjaro.org> writes:\n\n> According to my research, the \"->ornaments(0)\" call should work in\n> all environments as expected.  It's also officially documented. [1]\n>\n> [1] https://perldoc.perl.org/Term::ReadLine#ornaments\n\nGo back to the DESCRIPTION section and realize that it is a\nfront-end for different implementations.  The functions are listed\nin separate sections, the first section being \"Minimal set of\nsupported functions\", the other one being \"Additional\" that may or\nmay not be available/effective for everybody.  Which side does\nornaments fall in that page?\n\n"},{"id":"492358","messageId":"cd8ed09c0efa712aa93a45558bf6ad8e@manjaro.org","threadId":"61278","inReplyTo":"xmqqttkfqnvm.fsf@gitster.g","subject":"Re: [PATCH v3] send-email: make it easy to discern the messages for each patch","fromName":"Dragan Simic","fromEmail":"dsimic@manjaro.org","sentAt":"2024-04-06T01:34:51Z","receivedAt":"2024-04-06T01:34:54Z","isPatch":true,"sender":{"key":"dsimic@manjaro.org","avatar":null},"body":"On 2024-04-06 03:30, Junio C Hamano wrote:\n> Dragan Simic <dsimic@manjaro.org> writes:\n> \n>> According to my research, the \"->ornaments(0)\" call should work in\n>> all environments as expected.  It's also officially documented. [1]\n>> \n>> [1] https://perldoc.perl.org/Term::ReadLine#ornaments\n> \n> Go back to the DESCRIPTION section and realize that it is a\n> front-end for different implementations.  The functions are listed\n> in separate sections, the first section being \"Minimal set of\n> supported functions\", the other one being \"Additional\" that may or\n> may not be available/effective for everybody.  Which side does\n> ornaments fall in that page?\n\nWell spotted, thanks.  Perhaps it's the best to leave the prompts\nas-is until I spend some time to cover the possible Perl platform\nand package differences properly.\n\nFurthermore, it would be useful to add some color coding to the\nproduced outputs, so the failures and successes could be spotted\neven more easily, but that's perhaps a can of worms that's best\nif left unopened.\n"}]}