Click above to get retro games delivered to your door ever month!

     This new feature can be used to "filter" msgs, for example  calling
     PGP or other encryption utilities.

     The <utilno> must be in the  range 1 to 24 for utilities  that will
     be called with key definitions  (see below). Higher numbers can  be
     used  for  utilities  that  are  called  from  the EDITSAVEMENU (if
     enabled). See the EDITSAVEUTIL keyword for details.

     The  default  options  are  those  specified with the EXTERNOPTIONS
     keyword. With [-options], you can change the those options  locally
     for specific  utils. See  the EXTERNOPTIONS  keyword for  a list of
     valid options.

     The <commandline> specfies the DOS or OS/2 commandline you want  to
     execute. This works in the same way as for the external editor  and
     spellchecker. See the manual for details about this, especially  if
     you want to execute batchfiles. In the <commandline> you can use  @
     tokens to transfer information from the msg to the commandline. The
     @tokens are the same as for templates, and in addition you can  use
     two other @tokens:

         @path     The GOLDPATH, including a trailing backslash.
         @file     The full filename of the message file (GOLDED.MSG)
                   that will be written to disk before the utility is
                   called.
         @tmpfile  The full filename of a temporary message file
                   (GEDTMPxx.xxx) that will be written to disk before the
                   utility is called.

       Examples:

         EXTERNUTIL 1 c:\4dos\4dos.com /c c:\crypt\encrypt.bat @file
         EXTERNUTIL 2 c:\4dos\4dos.com /c c:\crypt\decrypt.bat @file

     To call a defined  external utility, you must  assign a key to  it.
     There are 24 new keyboard commands you can use in GOLDKEYS.CFG  for
     this purpose:

         ExternUtilNN

     Where NN is in the range 01 to 24 _with_ leading zero. Examples:

         F11 ExternUtil01
         F12 ExternUtil02

     Then if you press F11, you would call external utility number 1 and
     so on. The ExternUtilNN keywords  ONLY work in reader mode,  not in
     the internal editor or any other place.

     HOW IT WORKS:

     1.  Just before the external utility is called, GoldED writes the
         current message text  to the GOLDED.MSG  file in the  GOLDPATH.
         The  file  is  written  as  a  textfile  with  each  line CR-LF
         terminated. The content is exactly as you see it on the screen,
         which means that kludges are only included if you have  enabled
         kludge viewing.  If the  -NoKeepCtrl option  is used,  kludges,
         tearline and origin are stripped before the file is written. If
         the token @tmpfile is used, a temporary file named GEDTMPxx.xxx
         (where xx.xxx is something unique) is created with exactly  the
         same content as @file.

     2.  GoldED clears the screen and then calls the utility after
         swapping  itself  out  of  memory  (if  swapping  is enabled or
         relevant for the version).

     3.  The utility can now load and process the @file and/or
         @tmpfile, or do anything else you want. It doesn't have to have
         anything  to  do  with  the  current  msg.  You  could  call  a
         spreadsheet, a game,  whatever. But I  think this feature  will
         mainly be  used for  utilities that  process the  @file. If the
         utility processes the @file, it could write the changes back to
         the @file.

     4.  After returning from the utility, GoldED reloads the @file and
         displays it just as if it was the current message. For example,
         if your utility was a decrypter and the msg was encrypted,  you
         would now see the decrypted msg. Neat eh? :-)

     5.  If you want to make the reloaded text permanent (save it in
         the msg), you can use  the Change Msg function and  immediately
         choose "Save Message"  from the Editing  menu (if enabled  with
         EDITMENU Yes). This is in fact the method you could use if  you
         wanted to  EN-crypt a  msg (however,  it is  easier to  use the
         method which involves the EDITSAVEUTIL keyword).

         The QUOTESPACING feature can  interfere with encoded msgs  that
         include the '>' character at the beginning of lines (often seen
         in  uuencoded  msgs),  by  automatically  inserting blank lines
         before and after the lines  with '>'. I have therefore  changed
         the quotespacing default  from YES to  NO. Be sure  to check if
         you have a different setting if you are using an older  edition
         of the advanced configuration files.

         If  the  string  -----BEGIN  PGP MESSAGE-----  is found  as the
         first  27  characters  in  a  reloaded  message,  GoldED   will
         automatically  add  the  FSC-0073  kludge  "^aENC:  PGP"  to
         indicate that the message is encrypted. This kludge may be used
         by some software  to set up  alternative routing for  encrypted
         mail which would  otherwise be bounced  if sent through  normal
         channels.

         See  the  "Using  PGP  as  an  External  Utility"  chapter  for
         batchfile  examples  and  instructions  on  how to use this new
         feature with PGP.

         !!! IMPORTANT !!! From FidoNet Policy 4.07 (chapter 2.1.4):

         "[..] Therefore,  encrypted and/or  commercial traffic  that is
         routed without the express permission  of all the links in  the
         delivery system constitutes annoying behavior."

         So be careful with this feature!

         TIP: You can use the  EXTERNUTIL feature to setup keys  to view
         or print an  attached fax. Use  something like this  in GOLDED.
         CFG:

         EXTERNUTIL 11 c:\zfax\zfax.com pf @subject     ; print fax
         EXTERNUTIL 12 c:\zfax\zfax.com vf @subject     ; view fax

         And this in GOLDKEYS.CFG:

         @F11  ExternUtil11    ; Press Alt-F11 to print the fax
         @F12  ExternUtil12    ; Press Alt-F12 to view the fax

         Or choose your own key assignments and fax view/print utils.

         Note  that  this  assumes  that  the  fax file is listed in the
         subject line like an attached file.