flnews_post_proc 2.05 → 2.09

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87bf0a3e9a8c5ab513c440c94fd798aba136a4fd72fb351cfbf133f1270e2758
-  data.tar.gz: 32f644c07859db2b6569621b471a786e4409e0cdaffb5e67a193e54d7f7e99a7
+  metadata.gz: 18f792835e686af8a36729221515ac5c0c8a098ffa9af305c5fc0b8c9c238ee9
+  data.tar.gz: 7934370fa70a6c604e940889859adf606a4b811d3b0b7ca49bf15a6555fc5cd6
 SHA512:
-  metadata.gz: ae7465a7d6e9ec4dee294344bbdb1d6c10950351f6d5eeddb84c324d3700e653d4bb305170415071632208b3f5ec0e2f4ec05ada59dee07d9426cde2f7e87a1d
-  data.tar.gz: e0180d504592a9ab223d46c994b5a79ae81bb5a2b62970915b0b683d546c79ef2affdd12c6b17932f71a63639d9fc8c25ad41289ec69ce03a429ae71db6c92b0
+  metadata.gz: cf57d03010ef6b7eb4791593c28391463166793a16ff93a091bc547d107447ec6afbcb56fc4b6c3aad8155c9d0c25fa8d3b4937242fe762eb395ef5e5d16970c
+  data.tar.gz: eafa122440c8870fa7fcc308f2e738513d5092f09f22ec26bbdf9ce9d5ce63c1953b66b5d0e55dae05f14be438e1f024c02275e43f9875be60da944eca712543

data/README.md

@@ -47,6 +47,11 @@ This way, the gem file will be downloaded from rubygems.org and installed in
 the designated path for ruby-gems. If the installation completes without  
 errors, the command **flnews_post_proc** will become immediately available.
 
+To have the man page at your disposal when you call *man flnews_post_proc*, 
+you need to install the 'manpages' gem (**gem install manpages**). Then, having
+installed flnews_post_proc as explained above, execute also 
+**gem manpages --update-all**.
+
 For other uses of the gem utility, see the output of  
 user@machine:~$ **gem --help**
 

data/bin/flnews_post_proc

@@ -62,6 +62,7 @@ config = Configuration::instance
 if (!STDIN.tty?)
   # read from STDIN
   artext = ARGF.read
+  artext.force_encoding('UTF-8')
 
   # There is content, create the post-processor.
   if !artext.strip.empty? 

data/changes.txt

@@ -1,5 +1,37 @@
+V. 2.09 
+    *) Upon installation of the program, the English man page can be made
+       accessible in the ordinary way, if the manpages gem is already 
+       installed.
+
+V. 2.08
+    *) Bugfix: A random signature could not be set due to 
+       the interfering process of rearranging them in the signature
+       file. -> Changed the order of actions.
+    *) The gem tool suddenly imposes duplication of the homepage
+       URL in the specs. Okay. Done. Beats me.
+
+v. 2.07
+    *) Logging: exception in case of invalid target file is now handled.
+    *) Configuration variable “NAME_POSTPROCESSOR” can be set to true
+       or yes in order to create a custom header 
+       X-Post-Processor: flnews_post_proc [version]
+       The default is empty, no or false, i.e. no additional header.
+       The setting is independent of the presence of other custom headers
+       and cannot be influenced in the Override Dialog, only in the
+       configuration file.
+
+v. 2.06
+    *) The content of the signature file is (again) rearranged after
+       having picked a random signature, to provide for better randomness.
+       It is not proven that this is better but something must be done.
+
+    *) Ruby 4.1.0 chokes again at an encoding mismatch, when calling
+       Array.join('delimiter') before the encoding is enforced. I have
+       forced UTF-8 an all Array elements prior join(). This works now.
+
 v.2.05
     *) Gemspec: Dependency for io-console added.
+
 v.2.04
     *) Gemspec: Dependencies added
        -) gem New_rfc_2047 was missing from the specs.

data/doc/fr/html/flnews_post_proc.html

@@ -82,7 +82,7 @@
 
         <li>
           <p><a class="reference internal" href=
-          "#autres-informations" id="toc-entry-7">Autres
+          "#autres-informations-1" id="toc-entry-7">Autres
           Informations</a>
           </p>
 
@@ -346,6 +346,24 @@
           </li>
         </ul>
 
+        <p>Il existe une option supplémentaire, désactivée par
+        défaut, que vous ne pouvez activer que dans la boîte de
+        dialogue et nulle part ailleurs :</p>
+
+        <ul class="simple">
+          <li>
+            <p>Le message en cours peut être enregistré comme
+            brouillon, au lieu d'être publié sur Usenet.</p>
+          </li>
+        </ul>
+
+        <p>Si votre configuration contient le chemin d'accès à un
+        répertoire destiné à ces brouillons (option
+        <em>DRAFT_DIR</em>), celui-ci sera utilisé pour stocker ces
+        brouillons ; sinon, c'est le répertoire temporaire défini
+        par la variable d'environnement <em>$TEMP</em> qui sera
+        utilisé.</p>
+
         <p>En tapant Esc ou en poussant le bouton « Annuler » du
         dialogue, vous pouvez interrompre le processus, flnews ne
         va pas envoyer l'article.</p>
@@ -517,6 +535,27 @@ alt.fr.test: /home/[utilisateur]/.signatures</pre>
 - 'X-Another-Header: care not!'</pre>
         </blockquote>
 
+        <p><strong>NAME_POSTPROCESSOR</strong>
+        </p>
+
+        <blockquote>
+          <p>Si la valeur est "yes" ou "true", ajoute une entête
+          "X-Post-Processor" avec le nom et la version du
+          programme. Laissez vide ou notez explicitement "no" ou
+          "false" afin d'éviter la création de l'entête. Ce réglage
+          est indépendant de la présence ou absence d'autres
+          entêtes supplémentaires et ne peut pas être manipulé dans
+          le dialog graphique avant l'envoi d'un message, seulement
+          dans le fichier de configuration.</p>
+
+          <p>CONTENU : yes, YES, True, no, NO, vide, False et
+          variations.</p>
+
+          <p>PAR DÉFAUT : Vide</p>
+
+          <p>EXEMPLE : Yes</p>
+        </blockquote>
+
         <p><strong>NO_ARCHIVE_GROUPS</strong>
         </p>
 
@@ -682,7 +721,7 @@ alt.fr.test: /home/[utilisateur]/.signatures</pre>
 
           <p>PAR DÉFAUT : yes</p>
 
-          <p>EXEMPLE: No</p>
+          <p>EXEMPLE : No</p>
         </blockquote>
 
         <p><strong>USE_OLD</strong>
@@ -699,14 +738,49 @@ alt.fr.test: /home/[utilisateur]/.signatures</pre>
           <p>Ne changez pas cette variable ou notez la valeur
           'false' afin d'ignorer les changements de l'objet.</p>
 
-          <p>PAR DEFAUT: false</p>
+          <p>PAR DÉFAUT : false</p>
 
-          <p>EXEMPLE: yes</p>
+          <p>EXEMPLE : yes</p>
+        </blockquote>
+
+        <p id="draft-dir"><strong>DRAFT_DIR</strong>
+        </p>
+
+        <blockquote>
+          <p>Chemin d'accès au répertoire contenant les brouillons
+          de messages.</p>
+
+          <p>Vous pouvez activer l'option <em>DRAFT_ONLY</em> dans
+          la boîte de <cite>Dialogue pour désactiver des
+          options</cite>. Le message en cours sera alors enregistré
+          dans ce répertoire, <strong>au lieu d'être
+          publié</strong> sur Usenet. Si vous ne renseignez pas
+          cette option, un répertoire temporaire ($TEMP) sera
+          utilisé à la place. Les fichiers de brouillon seront
+          nommés selon le schéma suivant :</p>
+
+          <blockquote>
+            <p>[n][1er_groupe][++].draft</p>
+          </blockquote>
+
+          <p>où <em>n</em> correspond au nombre de fichiers dans ce
+          répertoire, <em>1er_groupe</em> au premier groupe de
+          discussion auquel le message était adressé et <em>++</em>
+          à un suffixe facultatif, indiquant qu’il y a d’autres
+          groupes de discussion dans la liste (publication
+          croisée). Le contenu d’un fichier brouillon correspond au
+          corps actuel du message, précédé de la liste des groupes
+          de discussion.</p>
+
+          <p>PAR DÉFAUT : vide</p>
+
+          <p>EXEMPLE : ~/flnews_brouillons</p>
         </blockquote>
       </section>
     </section>
 
-    <section id="autres-informations">
+    <section id="autres-informations-1">
+      <span id="autres-informations"></span>
       <h2>Autres Informations</h2>
 
       <section id="changement-de-l-objet-1">
@@ -908,7 +982,18 @@ alt.fr.test: /home/[utilisateur]/.signatures</pre>
         "https://creativecommons.org/licenses/by-nd/4.0/deed.fr">CC
         BY-ND 4.0</a></p>
 
-        <p>Date: 2026-08-11</p>
+        <p>Date: 2026-09-22</p>
+
+        <p>On peut accéder aux pages de manuel de la manière
+        habituelle, en exécutant <em>man</em>
+        <strong>flnews_post_proc</strong>, <strong>si</strong> le
+        gem <a class="reference external" href=
+        "https://rubygems.org/gems/manpages">manpages</a> est
+        installé. Au départ, l'exécution de <em>gem manpages
+        --update-all</em> garantira que les pages de manuel de tous
+        les paquets qui fournissent une telle documentation soient
+        copiées aux emplacements par défaut des pages de
+        manuel.</p>
 
         <p><strong>Ω</strong>
         </p>
@@ -917,7 +1002,7 @@ alt.fr.test: /home/[utilisateur]/.signatures</pre>
   </main>
 
   <div id='page_dt'>
-    2026-08-11
+    2026-09-22
   </div>
 </body>
 </html>

data/doc/fr/rst/flnews_post_proc.rst

@@ -5,6 +5,8 @@ flnews_post_proc
 =======================
 
 .. |program| replace:: **flnews_post_proc**
+.. _CC By-ND 4.0: https://creativecommons.org/licenses/by-nd/4.0/deed.fr
+.. _manpages: https://rubygems.org/gems/manpages
 
 ------------------------------------------
 Post-Traitement pour flnews
@@ -142,6 +144,15 @@ Vous **ne pouvez pas** activer des options qui n'ont pas été activées au pré
 
 * L'écriture d'un protocole peut être arrêtée.  
 
+Il existe une option supplémentaire, désactivée par défaut, que vous ne pouvez activer que dans la boîte de dialogue et nulle part ailleurs :
+
+* Le message en cours peut être enregistré comme brouillon, au lieu d'être publié sur Usenet.
+
+Si votre configuration contient le chemin d'accès à un répertoire destiné à ces
+brouillons (option *DRAFT_DIR*), celui-ci sera utilisé pour stocker ces
+brouillons ; sinon, c'est le répertoire temporaire défini par la variable
+d'environnement *$TEMP* qui sera utilisé.
+
 En tapant Esc ou en poussant le bouton « Annuler » du dialogue, vous pouvez
 interrompre le processus, flnews ne va pas envoyer l'article.
 
@@ -271,6 +282,22 @@ Options de configuration
         - 'X-My-Header: nothing fancy'
         - 'X-Another-Header: care not!' 
 
+**NAME_POSTPROCESSOR**
+
+    Si la valeur est "yes" ou "true", ajoute une entête "X-Post-Processor" avec
+    le nom et la version du programme. Laissez vide ou notez explicitement "no"
+    ou "false" afin d'éviter la création de l'entête.  
+    Ce réglage est indépendant de la présence ou absence d'autres entêtes
+    supplémentaires et ne peut pas être manipulé dans le dialog graphique avant
+    l'envoi d'un message, seulement dans le fichier de configuration.
+
+    CONTENU : yes, YES, True, no, NO, vide, False et variations.
+
+    PAR DÉFAUT : Vide
+
+    EXEMPLE : Yes
+
+
 **NO_ARCHIVE_GROUPS**
 
     Les newsgroups, où les entêtes « Archive: no » et « X-No-Archive: yes »
@@ -393,7 +420,7 @@ Options de configuration
 
     PAR DÉFAUT : yes
 
-    EXEMPLE: No
+    EXEMPLE : No
 
 **USE_OLD**
 
@@ -404,10 +431,36 @@ Options de configuration
     Ne changez pas cette variable ou notez la valeur 'false' afin d'ignorer
     les changements de l'objet.
 
-    PAR DEFAUT: false
+    PAR DÉFAUT : false
 
-    EXEMPLE: yes
+    EXEMPLE : yes
 
+.. _DRAFT_DIR:
+ 
+**DRAFT_DIR**
+
+    Chemin d'accès au répertoire contenant les brouillons de messages.
+
+    Vous pouvez activer l'option *DRAFT_ONLY* dans la boîte de `Dialogue pour
+    désactiver des options`. Le message en cours sera alors enregistré dans ce
+    répertoire, **au lieu d'être publié** sur Usenet. Si vous ne renseignez pas
+    cette option, un répertoire temporaire ($TEMP) sera utilisé à la place. Les
+    fichiers de brouillon seront nommés selon le schéma suivant :
+
+        [n][1er_groupe][++].draft
+
+    où *n* correspond au nombre de fichiers dans ce répertoire, *1er_groupe* au
+    premier groupe de discussion auquel le message était adressé et *++* à un
+    suffixe facultatif, indiquant qu’il y a d’autres groupes de discussion dans
+    la liste (publication croisée). Le contenu d’un fichier brouillon
+    correspond au corps actuel du message, précédé de la liste des groupes de
+    discussion.
+
+    PAR DÉFAUT : vide
+
+    EXEMPLE : ~/flnews_brouillons
+
+.. _Autres Informations:
 
 Autres Informations
 ===================
@@ -526,7 +579,7 @@ Auteur
 
 Ce document
 -------------
-.. _CC By-ND 4.0: https://creativecommons.org/licenses/by-nd/4.0/deed.fr
+
 .. |date| date::
 
 ©Michael Uplawski <michael.uplawski@uplawski.eu>
@@ -535,4 +588,11 @@ License: `CC BY-ND 4.0`_
 
 Date: |date|
 
+
+On peut accéder aux pages de manuel de la manière habituelle, en exécutant
+*man* |program|, **si** le gem `manpages`_ est installé. Au départ,
+l'exécution de *gem manpages --update-all* garantira que les pages de manuel
+de tous les paquets qui fournissent une telle documentation soient copiées
+aux emplacements par défaut des pages de manuel.
+
 **Ω**

data/doc/html/flnews_post_proc.html

@@ -485,6 +485,26 @@ comp.*: /home/[user]/.my_sigs</pre>
 - 'X-Another-Header: care not!'</pre>
         </blockquote>
 
+        <p><strong>NAME_POSTPROCESSOR</strong>
+        </p>
+
+        <blockquote>
+          <p>Can be used to set a custom header "X-Post-Processor"
+          with the name of the program and its current version.
+          Leave empty or set to no or false to avoid the creation
+          of this header. This setting is independent of the
+          presence or absence of other custom headers and cannot be
+          manipulated in the Override Dialog, only in the
+          configuration file.</p>
+
+          <p>CONTENT: yes, YES, True, no, NO, empty string, False
+          and variations.</p>
+
+          <p>DEFAULT: Empty</p>
+
+          <p>EXAMPLE: Yes</p>
+        </blockquote>
+
         <p><strong>NO_ARCHIVE_GROUPS</strong>
         </p>
 
@@ -866,9 +886,18 @@ comp.*: /home/[user]/.my_sigs</pre>
           "https://creativecommons.org/licenses/by-nd/4.0/">CC
           BY-ND 4.0</a></p>
 
-          <p>Date: 2026-08-11</p>
+          <p>Date: 2026-09-22</p>
         </blockquote>
 
+        <p>The man page can be accessed in the ordinary way, by
+        executing <em>man</em> <strong>flnews_post_proc</strong>,
+        <strong>if</strong> the <a class="reference external" href=
+        "https://rubygems.org/gems/manpages">manpages</a> gem is
+        installed. Initially, executing <em>gem manpages
+        --update-all</em> will ensure that the man pages for all
+        packages which provide such documentation are copied to the
+        default locations for man pages.</p>
+
         <p><strong>Ω</strong>
         </p>
       </section>
@@ -876,7 +905,7 @@ comp.*: /home/[user]/.my_sigs</pre>
   </main>
 
   <div id='page_dt'>
-    2026-08-11
+    2026-09-22
   </div>
 </body>
 </html>