home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / fido / ftsc_all.z43 / FSC-0043.001 < prev    next >
Text File  |  1990-04-01  |  5KB  |  115 lines
  1. Document: FSC-0043
  2. Version:  001
  3. Date:     04/01/90
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                   Some Hints on Recognizing Control Lines
  10.                         in FidoNet(r) Message Text
  11.                                Randy Bush
  12.                             1:105/6@FidoNet
  13.  
  14.  
  15.  
  16.  
  17. Status of this document:
  18.  
  19.      This FSC contains information of value to the general FidoNet(r)
  20.      community.  Distribution of this document is subject to the
  21.      restrictions stated in the copyright paragraph below.
  22.  
  23.      Fido and FidoNet are registered marks of Tom Jennings and Fido
  24.      Software.
  25.  
  26.  
  27. Copyright 1989-90, Randy Bush.  All rights reserved.  The right to distribute
  28. for non-commercial use is granted to the FidoNet Standards Committee, provided
  29. that no fee is charged.  This may be posted on FidoNet electronic BBSs which
  30. charge no fee for accessing this document.  Any and all other reproduction or
  31. excerpting requires the explicit written consent of the author.
  32.  
  33.  
  34. Implementors have had problems interpreting message text, both in netmail and
  35. echomail.  While the clues are usually to be found in some doucment or another,
  36. there seems to be a need to collect hints for some confusing aspects.  This
  37. informal document attempts to address that need.
  38.  
  39.  
  40. Filter out all <lf>s and 'soft' <cr>s and <lf>s.  They are surplus and will
  41. only confuse the rest of your code.
  42.  
  43. All control lines have their sentinels at the beginning of a line.  [ Note
  44. that an * Origin: line has a leading significant blank. ]
  45.  
  46. Do not process quoted control lines or control sentinels preceeded by blanks,
  47. tabs, ...
  48.  
  49. If you become confused, then bounce or sidetrack the message to a hold area
  50. for human intervention.  Don't try to rescue the situation.  None will notice
  51. when you succeed, and many will flame whan you fail.
  52.  
  53. A message is either netmail or echomail.  I.e. no ^aINTL, ^aFMPT, or ^aTOPT
  54. controls should be found or generated when there is an AREA: line or when in an
  55. echo area. Thus, echomail can not be routed across zones, but this is not a big
  56. loss.
  57.  
  58. Private netmail replies to echomail are netmail, i.e. may have ^aINTL etc.,
  59. and may not have AREA: line, SEEN-BY:, or ^aPATH: lines.  They may have a tear
  60. line and an origin line.
  61.  
  62. ^aEID lines are as in Opus 1.03.  Other forms are not to be generated, and,
  63. if found, may be safely disgarded.
  64.  
  65. An AREA: line must be the first non ^a line in the text.
  66.  
  67. The echomail control info is a four-part package at the end of the text.  It
  68. should not be, but occasionally is, followed by one or more ^a control lines.
  69. The four parts of an echomail trailer are:
  70.  
  71.   o a tear line, "---" and some very short text identifying the original echo
  72.     processor.  Eg.
  73.         --- Brag 3.14
  74.  
  75.   * note that some internetworking gateware may place a # Origin: line between
  76.     the tear line and the * Origin: line to indicate the true other network
  77.     address, whatver that may be.  The content of a # Origin: line is free to
  78.     be specified by the other network(s).  An example might be as follows:
  79.          # Origin: Political Statement (FishNet:914@201)
  80.  
  81.   o one * Origin: line, being " * Origin: " ends in "(" [Z:] N "/" N [.P] ")"
  82.     of FidoNet node of origin or the gate from FidoNet to another network
  83.          * Origin: <signature> (1:105/301)
  84.  
  85.   o as many SEEN-BY: lines as necessary, each being "SEEN-BY:" followed by one
  86.     or more
  87.         " " <net> "/" <node>
  88.     sequences.  Note that SEEN-BY: lines do not end in <space>.
  89.  
  90.     The net/node numbers in SEEN-BY: lines are sorted net major.  Within a
  91.     single SEEN-BY: line, net numbers are sticky, so the N/N is usually
  92.     abbreviated to N, Eg. 
  93.         SEEN-BY: 105/6 10 15 16 27 41 42 300 301 141/42 491
  94.  
  95.   o as many ^aPATH: lines as necessary, each being <ctrl-A> "PATH:" followed
  96.     by one or more
  97.         " " <net> "/" <node>
  98.     sequences.  The N/N in ^aPATH: lines are specifically not sorted.  Net
  99.     numbers are also sticky in ^aPATH: lines, eg.
  100.         PATH: 105/301 6 42
  101.  
  102. Remember that traffic costs much money, and do not create text unnecessary to
  103. FidoNet as a whole.
  104.  
  105. I did not invent this, so don't blame me.  I'm just trying to write it down.
  106.  
  107. And, lastly, try not to be inventive.  While the free-form syntax of this
  108. embedded stuff does provide fleibility and power, it also leaves a lot of room
  109. to make disgusting messes.  Compromise, cooperation, and a minimizalist touch
  110. are essential.
  111.  
  112. ---
  113.  
  114. Fido and FidoNet are registered marks of Tom Jennings and Fido Software.
  115.