flnews_post_proc 2.0 → 2.04

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f9d2ff5d6f33555a5059614972dcd6f01920b1a7274662509154e7092db9ca22
-  data.tar.gz: 9a75540a2daf3b02cd91d2a11f8087a8ddeabc1ccea42be76af23127e0bd9d06
+  metadata.gz: f0e31bc94142a2ec47e03c78802b468055b2728fa4d74fa320fcfb5d007ce98a
+  data.tar.gz: 8a877289ebfe3c40cc3cf1f02046c667ceec6ba722a7181493d8be819f75af31
 SHA512:
-  metadata.gz: 78e67d90fbacd419f0b7d543bb4ea66ea6c06440b6eff215159462f725eef8eb736db604587aa1980929c1f9a65b64fd37ded814735398a84784125acc700da4
-  data.tar.gz: 45cec798380b42fd1b795a90c3dfd712a9b5f09da94ef592eb0123f9ec615204849781454ca50c386319edbbe280dab10a613e5c358fe2fb605891400a8c5163
+  metadata.gz: 224cb017bcd798025b4d159536fce5753a58442d27fde12caad6c7d710330bac1a58fd17c2128310144795143b3ad238582cecdc451baa0c94aa242ff9a067e1
+  data.tar.gz: 2d3d88a9bec625acaea47d547d28fc7084a7c56259255e50d312d44808d28d3306e111eed8b9bbea97721cccbe85612de56d970f96f9e6177c650f36a3df8c4b

data/bin/flnews_post_proc

@@ -3,7 +3,7 @@
 
 =begin
 /***************************************************************************
- *   ©2023-2024, Michael Uplawski <michael.uplawski@uplawski.eu>           *
+ *   ©2023-2026, Michael Uplawski <michael.uplawski@uplawski.eu>           *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *
  *   it under the terms of the DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE *
@@ -22,8 +22,7 @@ if ! (/linux/ =~ RUBY_PLATFORM)
   exit false
 end
 
-# needs the ruby-filemagic gem
-require 'filemagic'
+require 'mimemagic'
 require 'tempfile'
 
 require_relative '../lib/override'
@@ -68,21 +67,24 @@ if (!STDIN.tty?)
   if !artext.strip.empty? 
     # Be sure to know what you are doing.
     # Ask around in case of doubt.
-    mime = FileMagic.mime.buffer artext
-    debug('mime is ' << mime.split(';')[0])
-    if (['news', 'rfc822'].none? {|m|  mime.start_with?('message/' << m) } )
+    type = ''
+    magic = MimeMagic.by_magic(artext)
+    # mime = FileMagic.mime.buffer artext
+    debug('magic is ' << magic.to_s)
+    type = magic.type if magic
+    if (['news', 'rfc822'].none? {|m| type.start_with?('message/' << m) } )
       # Not a pure news message
       # Add more reactions, as you stumble upon them ...
-      warn ("Input is of wrong mime-type " << mime.split(';')[0])
+      warn ("Input is of wrong type " << type)
 
       # Javascript okay
-      if (['javascript'].any? {|m| mime.start_with?('application/' << m)} )
+      if (['javascript'].any? {|m| type.start_with?('application/' << m)} )
         warn 'Input contains java-script code!'
       # C okay
-      elsif(['x-c'].any? {|m| mime.start_with?('text/' << m)} )
+      elsif(['x-c'].any? {|m| type.start_with?('text/' << m)} )
         warn 'Input contains C- or C++ code!'
       # Ruby okay
-      elsif(['x-ruby'].any? {|m| mime.start_with?('text/' << m) })
+      elsif(['x-ruby'].any? {|m| type.start_with?('text/' << m) })
         warn 'Input contains Ruby-code!'
       else
         warn 'Input contains other things than plain-text, but I cannot say, what.'
@@ -98,16 +100,31 @@ if (!STDIN.tty?)
     # if not disabled (default is true)
     if config.OVERRIDE_CONFIG != false
       cdlg = OverrideDlg.new
-      discarded = cdlg.show
-      if discarded && !discarded.empty?    
+      dlg_result = cdlg.show
+      discarded = ''
+      enabled = '' 
+      discarded = dlg_result[0]
+      enabled = dlg_result[1]
+      if discarded && discarded.respond_to?(:to_str) && !discarded.empty?    
         debug('options overriden ' << discarded)
         OverrideDlg.cvars.each do |v|    
-          if discarded.include?(v.to_s)
-            debug('removing ' << v.to_s)
+          vstr = v.to_s.strip
+          if discarded.include?(vstr)
             config.set(v, nil)
+            if v == :DEBUG_LOG
+              info 'will stop logging now!'
+              clear_log
+              set_target nil
+            end
           end
         end
       end
+      if enabled && enabled.respond_to?(:to_str) && !enabled.empty?
+        debug('additional options: ' << enabled)
+        enabled.split do |opt| 
+          config.set(opt.to_sym, true)
+        end
+      end
       debug('new config: ' << config.inspect)
     end
     #<--------------
@@ -116,9 +133,58 @@ if (!STDIN.tty?)
     # and get a result.
     article = pp.article
     if article 
-      # -------------> The main objective <------
-      puts article
-      # <------------- over and out ------>
+      if config.DRAFT_ONLY
+        draft_dir = config.DRAFT_DIR
+        if !draft_dir || draft_dir.empty?
+          draft_dir = ENV['TEMP']
+          warn 'Will write a draft to the temporary directory ' << draft_dir
+        end
+        if draft_dir
+          draft_dir = File.expand_path(draft_dir)
+          debug 'article is a draft, writing to ' << draft_dir
+          draft_dir << File::Separator if !draft_dir.strip.end_with?(File::Separator)
+          mode = 'w+'
+          begin
+            Dir.mkdir(draft_dir) if !File::exist?(draft_dir)
+            ext = '.draft'
+            nbr = 1
+            if File.exist?(draft_dir) && File.directory?(draft_dir)
+              nbr = Dir::children(draft_dir).collect do |dc|
+                debug ' found file ' << dc
+                File::file?(dc) && dc.strip.end_with?(ext)
+              end.length + 1
+
+              groups = pp.newsgroups.groups
+              fname = draft_dir + nbr.to_s << '_' << groups[0] 
+              fname << '++' if groups.length > 1
+              fname << ext
+              debug 'Draft will be ' << fname 
+              debug 'newsgroups are ' << pp.newsgroups.groups.to_s
+              text = pp.newsgroups.groups.join(", ") << $LN << $LN << pp.body.join
+              File::write(fname, text)
+              info 'Draft written alright' if File::exist?(fname)
+            else
+              fatal 'draft_dir does not exist and could not be created'
+              exit false
+            end
+          rescue Exception => ex
+            fatal "Cannot write draft (" << ex.message << ")"
+            exit false
+          end
+          # Post-Processing ends here ...
+        else
+          fatal "ABORTING: Directory for draft messages is not set!\nSee configuration, option DRAFT_DIR."
+          info "Nothing saved, nothing posted!"
+          # ... or here
+          exit false
+        end
+      else
+        debug 'writing article to STDOUT'
+        # -------------> The main objective <------
+        puts article
+        #  ... or here
+        # <------------- over and out ------>
+      end
       exit true
     end
     # whatever.

data/changes.txt

@@ -0,0 +1,46 @@
+v.2.04
+    *) Gemspec: Dependencies added
+       -) gem New_rfc_2047 was missing from the specs.
+       -) MimeMagic was already in the specs
+
+v.2.03
+    *) Ruby-Filemagic has been replaced by MimeMagic.
+    *) Calls to force_encoding() prior String.gsub have been added 
+       Ruby 4.1.0 appears to be stricter in handling encoding mismatches.
+    *) Bugfix: A typo in a require statement had been corrected.
+    *) Whiptail dialog code removed
+
+v.2.02
+    *) Bugfix: There was output to STDOUT unrelated to the message in
+       preparation which made Flnews complain. Also, posting was impossible.
+v.2.01 
+    *) The documentation has been updated.
+    *) Corrected behavior when logging is disabled in the interactive dialog
+       (pure text only, see next).
+    *) Whiptail dialog disabled.
+       The “Override-dialog” must be extended to honor new options. Whiptail is
+       too mind bending for me.  The code is still there, but will probably
+       disappear in future program versions.
+    *) Draft messages.
+         - New configuration option DRAFT_DIR defaults to $TEMP from the
+           current environment.
+         - Override-dialog as pure text shows new option DRAFT_ONLY.
+           When explicitly activated, nothing is posted, but the message stored
+           in the DRAFT_DIR (see documentation for more).
+    *) This file renamed 'changes.txt'
+    *) Pure text dialog to override settings corrected:
+         - Option "No Archive" is toggled correctly
+         - Unbuffered input from STDIN simplified
+v.2.0
+    *) Supersedes will have a new signature by default
+    *) Obsolete code for Yad and Zenity dialogs removed.
+v 1.99
+    *) Bugfix: The value of a custom header can include a colon.
+       Example:   x-my-header: apples: 2,90, peers: 3,10
+       (before, the value would have been clipped after the first ':')
+v 1.98
+    *) New change log (this file) 
+    *) In the configuration file, log levels can be in upper case.
+v 1.97
+    *) Custom headers are RFC 2047 encoded, if need be.
+       (before, they had to be ASCII only or were discarded).

data/doc/html/flnews_post_proc.html

@@ -266,17 +266,22 @@
         <h3>Dialog for Overriding Settings</h3>
 
         <blockquote>
-          <p><strong>IMPORTANT</strong>: As of version 1.72, YAD or
-          Zenity cannot be used for the dialog interface.</p>
+          <p><strong>IMPORTANT</strong>: As of version 2.01, only
+          the text interface remains to display the dialog.
+          <a class="reference external" href=
+          "https://xterm.dev/">XTerm</a> must be installed to use
+          the dialog.</p>
 
           <p>Before the post-processor runs, a dialog can be
           displayed to allow users to <strong>disable</strong>
           certain <a class="reference internal" href=
-          "#configuration">CONFIGURATION</a> options. If Whiptail
-          or xterm are available, you can choose to disable the
+          "#configuration">CONFIGURATION</a> options and – as of
+          version 2.01 – to <strong>enable</strong> others . If
+          XTerm is available, you can choose to disable the
           following options. You <strong>cannot</strong> enable
           options that haven't already been set in the
-          configuration.</p>
+          configuration. But you can choose to add an option that
+          is not present in the configuration file:</p>
 
           <blockquote>
             <ul class="simple">
@@ -306,6 +311,27 @@
             </ul>
           </blockquote>
 
+          <p>There is 1 additional option, which is disabled by
+          default, that you can enable only in the dialog and
+          nowhere else:</p>
+
+          <blockquote>
+            <ul class="simple">
+              <li>
+                <p>The current message can be saved as a draft,
+                <strong>instead</strong> of being posted to
+                Usenet.</p>
+              </li>
+            </ul>
+          </blockquote>
+
+          <p>When your configuration contains the path to a
+          directory for these drafts (option <a class=
+          "reference internal" href="#draft-dir">DRAFT_DIR</a>), it
+          will be used to store these draft messages, otherwise the
+          temporary directory from the environment variable
+          $TEMP.</p>
+
           <p>Pressing Esc or the Cancel button on the dialog will
           interrupt the process, and flnews will not post the
           article.</p>
@@ -584,6 +610,37 @@ comp.*: /home/[user]/.my_sigs</pre>
 
           <p>EXAMPLE: yes</p>
         </blockquote>
+
+        <p id="draft-dir"><strong>DRAFT_DIR</strong>
+        </p>
+
+        <blockquote>
+          <p>The path to a directory for draft messages. You can
+          activate an option DRAFT_ONLY in the <a class=
+          "reference internal" href=
+          "#dialog-for-overriding-settings">Dialog for Overriding
+          Settings</a>. The current message will then be saved to
+          this directory, <strong>instead</strong> of being posted
+          to Usenet. If you leave this option empty, a temporary
+          directory ($TEMP) will be used instead. The draft files
+          will be named according to this schema:</p>
+
+          <blockquote>
+            <p>[n][1st_group][++].draft</p>
+          </blockquote>
+
+          <p>where <em>n</em> is the number of files in this
+          directory, <em>1st_group</em> the first newsgroup that
+          the message was addressed to and <em>++</em> an optional
+          suffix, indicating that there are more newsgroups in the
+          list (cross post). The content of a draft file is the
+          current body of the message, preceded by the list of
+          newsgroups.</p>
+
+          <p>DEFAULT: empty</p>
+
+          <p>EXAMPLE: ~/.flnews_drafts</p>
+        </blockquote>
       </section>
     </section>
 
@@ -657,43 +714,10 @@ comp.*: /home/[user]/.my_sigs</pre>
         <span id="signatures-in-supersedes"></span>
         <h3>Signatures in Supersedes</h3>
 
-        <blockquote>
-          <p>When superseding an existing post, the post-processor
-          will NOT automatically add a signature. This preserves
-          the original post content as much as possible.</p>
-
-          <p>To retain the signature from the original post:</p>
-
-          <ol class="arabic simple">
-            <li>
-              <p>In flnews, select the entire article body with the
-              mouse—from the first line (including any
-              introductions) down to the last line of the
-              signature.</p>
-            </li>
-
-            <li>
-              <p>From the Article menu, select
-              <strong>Supersede</strong>.</p>
-            </li>
-
-            <li>
-              <p>Edit the article text as needed. The signature
-              will be included in te editable text (normally,
-              flnews strips signatures before opening the
-              editor).</p>
-            </li>
-
-            <li>
-              <p>Send the article.</p>
-            </li>
-          </ol>
-
-          <p><strong>Note:</strong> The <a class=
-          "reference internal" href="#override-dialog">override
-          dialog</a> (see above) does not affect signatures in
-          superseding posts.</p>
-        </blockquote>
+        <p>Since version 2.0, signatures in supersedes are not
+        handled differently from other articles. This paragraph
+        will be removed in the next version of the
+        documentation.</p>
       </section>
 
       <section id="testing-1">
@@ -711,13 +735,13 @@ comp.*: /home/[user]/.my_sigs</pre>
               <p><strong>:~$ /usr/local/bin/[post-processor] &lt;
               [test-article]</strong>
               </p>
-            </li>
-          </ol>
 
-          <p>This will show the modified article, and you can pipe
-          it into another file for further testing.</p>
+              <blockquote>
+                <p>This will show the modified article, and you can
+                pipe it into another file for further testing.</p>
+              </blockquote>
+            </li>
 
-          <ol class="arabic simple" start="2">
             <li>
               <p>Post directly to a test newsgroup (e.g.,
               alt.test). This is essential before posting to real
@@ -801,7 +825,7 @@ comp.*: /home/[user]/.my_sigs</pre>
           "https://creativecommons.org/licenses/by-nd/4.0/">CC
           BY-ND 4.0</a></p>
 
-          <p>Date: 2026-07-16</p>
+          <p>Date: 2026-08-01</p>
         </blockquote>
 
         <p><strong>Ω</strong>
@@ -811,7 +835,7 @@ comp.*: /home/[user]/.my_sigs</pre>
   </main>
 
   <div id='page_dt'>
-    2026-07-16
+    2026-08-01
   </div>
 </body>
 </html>

data/doc/rst/flnews_post_proc.rst

@@ -10,6 +10,7 @@ flnews_post_proc
 .. _CC By-ND 4.0: https://creativecommons.org/licenses/by-nd/4.0/
 .. _rubygems.org: https://rubygems.org/gems/flnews_post_proc
 .. _en Français: https://www.uplawski.eu/div/flnews/gem_doc/fr
+.. _XTerm: https://xterm.dev/
 
 
 ------------------------------------------
@@ -100,13 +101,15 @@ Limitations of Basic Newsreaders
 
 Dialog for Overriding Settings
 ------------------------------
-  **IMPORTANT**: As of version 1.72, YAD or Zenity cannot be used for the dialog
-  interface.
+  **IMPORTANT**: As of version 2.01, only the text interface remains to display the dialog. 
+  `XTerm`_ must be installed to use the dialog.
 
   Before the post-processor runs, a dialog can be displayed to allow users to
-  **disable** certain `CONFIGURATION`_ options. If Whiptail or xterm are available,
-  you can choose to disable the following options. You **cannot** enable options
-  that haven't already been set in the configuration.
+  **disable** certain `CONFIGURATION`_ options and – as of version 2.01 – to
+  **enable** others . If XTerm is available, you can choose to disable the
+  following options. You **cannot** enable options that haven't already been
+  set in the configuration. But you can choose to add an option that is not present
+  in the configuration file:
 
     * Signatures (if set in the `CONFIGURATION`_) can be **ignored**. A default signature will be used, or no signature at all.
 
@@ -116,6 +119,13 @@ Dialog for Overriding Settings
 
     * Logging can be **disabled**, if enabled.
 
+  There is 1 additional option, which is disabled by default, that you can enable only in the dialog and nowhere else:
+     
+    * The current message can be saved as a draft,  **instead** of being posted to Usenet.
+
+  When your configuration contains the path to a directory for these drafts (option `DRAFT_DIR`_), it will be used to store
+  these draft messages, otherwise the temporary directory from the environment variable $TEMP. 
+
   Pressing Esc or the Cancel button on the dialog will interrupt the process, and
   flnews will not post the article.
 
@@ -325,6 +335,28 @@ Configuration Options
 
   EXAMPLE: yes
 
+.. _DRAFT_DIR:
+
+**DRAFT_DIR**
+
+  The path to a directory for draft messages. You can activate an option
+  DRAFT_ONLY in the `Dialog for Overriding Settings`_. The current message will
+  then be saved to this directory, **instead** of being posted to Usenet.
+  If you leave this option empty, a temporary directory ($TEMP) will be used instead.
+  The draft files will be named according to this schema:
+
+    [n][1st_group][++].draft
+
+  where *n* is the number of files in this directory, *1st_group* the first
+  newsgroup that the message was addressed to and *++* an optional suffix,
+  indicating that there are more newsgroups in the list (cross post). The
+  content of a draft file is the current body of the message, preceded by the
+  list of newsgroups.
+
+  DEFAULT: empty
+
+  EXAMPLE: ~/.flnews_drafts
+
 .. _Other Information:
 
 Other Information
@@ -377,20 +409,9 @@ Editing footnotes
 
 Signatures in Supersedes
 ------------------------
-  When superseding an existing post, the post-processor will NOT automatically add a signature.
-  This preserves the original post content as much as possible.
-
-  To retain the signature from the original post:
-
-  1. In flnews, select the entire article body with the mouse—from the first line (including any introductions) down to the last line of the signature.
-
-  2. From the Article menu, select **Supersede**.
-
-  3. Edit the article text as needed. The signature will be included in te editable text (normally, flnews strips signatures before opening the editor).
-
-  4. Send the article.
-
-  **Note:** The `override dialog`_ (see above) does not affect signatures in superseding posts.
+Since version 2.0, signatures in supersedes are not handled differently from
+other articles. This paragraph will be removed in the next version of the
+documentation.
 
 .. _Testing:
 
@@ -402,8 +423,8 @@ Testing
 
      **:~$ /usr/local/bin/[post-processor] < [test-article]**
 
-  This will show the modified article, and you can pipe it into another file
-  for further testing.
+      This will show the modified article, and you can pipe it into another file
+      for further testing.
 
   2. Post directly to a test newsgroup (e.g., alt.test). This is essential before posting to real newsgroups, 
      especially when the post-processor will alter the article.

data/lib/basic_logging.rb

@@ -60,18 +60,19 @@ module BasicLogging
       msg = calling_method << ": ERROR : invalid log level \"" << lv.to_s << "\""
       msg << "\n" << "Keepinng old log level " << Levels.keys.detect {| k| Levels[k] == @@log_level}.to_s
       STDERR.puts msg
-      puts msg
+      # puts msg
     end
   end
 
   # set the log target 
   def set_target(tg)
-    if tg.respond_to?(:to_io) 
+    # STDOUT.puts 'BASICLOGGING : Setting target to ' << tg.to_s
+    if tg && tg.respond_to?(:to_io) 
       @@target = tg
-    elsif(!File::exist?(tg) || ( File.file?(tg) && File.writable?(tg) ) )
-      @@target = File.open(tg, 'w+')  
     elsif !tg || tg.respond_to?(:to_str) && tg.strip.empty?
       @@target = nil
+    elsif(!File::exist?(tg) || ( File.file?(tg) && File.writable?(tg) ) )
+      @@target = File.open(tg, 'w+')  
     else
       STDERR.puts calling_method << ': ERROR : target ' << tg.to_str << ' cannot be set'
       STDERR.puts "Keeping old target " << @@target.inspect

data/lib/body.rb

@@ -2,7 +2,7 @@
 
 =begin
   /***************************************************************************
-   *   2023-2025, Michael Uplawski <michael.uplawski@uplawski.eu>            *
+   *   2023-2026, Michael Uplawski <michael.uplawski@uplawski.eu>            *
    *   This program is free software; you can redistribute it and/or modify  *
    *   it under the terms of the WTFPL 2.0 or later, see                     * 
    *   http://www.wtfpl.net/about/                                           *
@@ -167,7 +167,8 @@ class Body
   end
 
   def join 
-    new_body = @lines.join("\r\n") << "\r\n"
+    lines = @lines.collect{|l| l.force_encoding('utf-8')}
+    new_body = lines.join("\r\n") << "\r\n"
     # replace ellipsis 
     new_body.gsub!('...', '…')
     return new_body
@@ -187,21 +188,11 @@ class Body
     if @@config.VFY_URLS
       debug 'verifying URLs'
       @lines.each_with_index do | l, i | 
-        # leave cited lines as they are.
+        # leave quoted lines as they are.
         if !l.start_with?( '>') 
-=begin Currently Unused
-          # IMPORTANT --------------------------------->
-          # IT IS HENCEFORTH PROHIBITED TO WRITE AN EMAIL-ADDRESS
-          # IN THE BODY OF A NEWS-POST AND TO NOT PREPEND IT WITH
-          # mailto:
-          #  ... Because I do not know what to do in these cases,
-          #  and I am the boss!
-          #  <----------------------------
-
-          # BUGFIX : Urls with @
-          # BUGFIX : email address in the intro 
-          new_line = handle_news(l) if !@intro || l.strip != @intro.strip
-=end
+          #  Handling of news- and mail-links has been
+          #  removed.
+          #
           # http(s)
           if l.include?('http')
             new_line = handle_http(l)
@@ -218,7 +209,8 @@ class Body
     ref_delim = @@config.REFERENCES_DELIMITER
     debug('references delimiter is ' << ref_delim)
     references = Array.new
-    body = @lines.join($LN)
+    # avoids a lot of trouble
+    body = @lines.join($LN).force_encoding('utf-8')
     if ref_delim && !ref_delim.strip.empty? 
       unless ref_delim == ref_delim.reverse
         ref_delim.strip!
@@ -276,34 +268,6 @@ class Body
   end
   private 
 
-  # handle <news:..@...>
-  def handle_news(l)
-    # ... “Do not trust nobody!”
-    if l.include?('@') && ! l.include?('http:') && ! l.include?('https:') 
-      # And I forgot how this works. It does.
-      l.split.collect do |ele| 
-        # angular brackets are there alright. Hurra. 
-        url = ele.match(/\<(.*)\>/)
-        unless !url
-          debug(' with angular brackets: ' << url.inspect)
-          l = l.sub(url[1], 'news:' << url[1]) if !url[1].start_with?('mailto') && !url[1].start_with?('news')
-        else
-          url = ele.match(/\S+@(\.|[^\p{P}]+)\S+/)
-          if url
-            debug(' withOUT angular brackets: ' << url.inspect)
-            if !url[0].start_with?('mailto') && !url[0].start_with?('news')
-              l.sub!(url[0], 'news:' << url[0] )          
-            end
-            l.sub!('news:', '<news:')
-            l.sub!(url[0], url[0] << '>')
-          end
-        end
-      end # url_strs = collect
-      debug(' news: line is now ' << l)
-      return l
-    end
-  end
-
   # formatting http URLs, not much is done here.
   def handle_http(l)
     debug('handle http')

data/lib/color_output.rb

@@ -1,7 +1,7 @@
 #encoding: UTF-8
 =begin
-/***************************************************************************
- *   2023-2024, Michael Uplawski <michael.uplawski@uplawski.eu>            *
+ ***************************************************************************
+ *   2023-2026, Michael Uplawski <michael.uplawski@uplawski.eu>            *
  *   This program is free software; you can redistribute it and/or modify  *
  *   it under the terms of the WTFPL 2.0 or later, see                     * 
  *   http://www.wtfpl.net/about/                                           *
@@ -10,7 +10,7 @@
  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *
  *                                                                         *
- ***************************************************************************/
+ ***************************************************************************
 =end
 
 # Functions to apply colors to terminal output.