home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 1 / Mecomp-CD.iso / amiga / librarys / xprascii.library / ascii.doc
Encoding:
Text File  |  1996-09-14  |  5.3 KB  |  164 lines
  1. xprascii.library -- version 2.4
  2. [Updated by Olaf `Olsen' Barthel <olsen@sourcery.han.de>]
  3.  
  4.  
  5. This is an XPR 2.0 implementation of the ASCII protocol.
  6.  
  7. based on xprascii.library 0.9 by W.G.J. Langeveld
  8.  
  9. Source code modifications and additions needed for XPR are:
  10.  
  11.     Copyright ©1992 Ueli Kaufmann, All Rights Reserved.
  12.  
  13. This software is provided "AS IS" without warranty of any kind, either
  14. expressed or implied, with respect to the programs described herein, their
  15. quality, performance, or fitness for any particular purpose.
  16.  
  17. In no event will the author(s) be liable for direct, indirect, incidental,
  18. or consequential damages.
  19.  
  20. redistribution of this software is permitted, provided that:
  21.  
  22.     1. all files are included, and in their original form.
  23.     2. if included with a particular product (commercial or
  24.        otherwise), proper credit is given to the authors in that
  25.        product's documentation.
  26.  
  27. By using or distributing this software, you agree to understand and accept
  28. the above.
  29.  
  30.  
  31.  
  32. There's nothing really fancy about it..(-:
  33.  
  34. Configurable options are:
  35.  `char delay'
  36.  `line delay'
  37.  `line-feed translation',
  38.  `carriage-return translation',
  39.  `uuencode/uudecode files'
  40.  `delete received uudecoded files'
  41.  `expand blank lines',
  42.  `prompt char'
  43.  `strip high bit'
  44.  
  45.  
  46. (C)har delay:  C<ticks>
  47. -------------
  48. A numeric value in ticks (1 tick = 20msecs) which causes XPr-ASCII
  49. to wait (also called "pacing") before transmitting each character.
  50. Values between zero and 500 (10 secs) are valid.
  51. (default: 0).
  52.  
  53.  
  54. (L)ine delay:  L<ticks>
  55. -------------
  56. Milliseconds to wait between the transmission of each line
  57. of text.  The same limits of the character delay option
  58. described in the previous section apply here.
  59. (default: 0)
  60.  
  61.  
  62. Carriage-(R)eturn translation:   R<n|s|x|a>
  63. ------------------------------
  64. The three options available determine how an incoming carriage
  65. return is to be handled.  You can either do nothing via the
  66. (N)one option, (S)trip it, e(X)change for a linefeed <LF>,
  67. or (A)dd a linefeed <LF> character to it.
  68. (default: "None")
  69.  
  70.  
  71. Line-(F)eed translation:   F<n|s|x|a>
  72. ------------------------
  73. Like the CR transl. feature described in the paragraph above, you
  74. can also select how an incoming linefeed <LF> character is to be
  75. translated.  As above, you can leave it alone (None), (S)trip it,
  76. e(X)change for a <CR> or (A)dd a carriage return <CR> character to it.
  77. (default: "None")
  78.  
  79.  
  80. (U)uencode/decode file when sending/receiving:   U<0|1>
  81. ----------------------------------------------
  82. XPr-Ascii gives you the chance to uuencode binary-files `on the fly'
  83. when they are sent. It's possible to uudecode files after receiving, too.
  84. (default: off)
  85.  
  86. * `forwarded' from UUCode.doc/UU3722.lha    by Klaus Alexander Seistrup
  87. *
  88. *   FUNCTION
  89. *       These programs/functions are primarily for use with electronic
  90. *       mail systems such as FidoNet and UUCP.
  91. *
  92. *       UUEncode sort of encrypts a program so that the output will only
  93. *       contain printable characters, thus allowing you to post a binary
  94. *       file in a message area.
  95. *
  96. *       UUDecode does the opposite thing: it decrypts an UUEncode'd ASCII
  97. *       file into its binary origin. It is *NOT* necessary to cut out the
  98. *       UUEncode'd part of a message in order to decode it - just pass the
  99. *       whole msg to UUDecode.
  100. *
  101. *       Please note that UUEncode doesn't perform any kind of compression!
  102. *       In fact, any UUEncode'd file will be *at least* one third bigger
  103. *       than the original file, due to the loss of information by convert-
  104. *       ing the file to ASCII.
  105. *
  106. *       Please also note that not all moderators welcome UUEncode't files
  107. *       and remember that a lot of people will be paying money for down-
  108. *       loading your messages - so use it with care, huh? :-)
  109. *       The encode file has an ordinary text form and can be  edited
  110. *       by any text editor to change the mode or remote name.
  111. *
  112. *       This version of uuencode  automatically  adds  checksums  to
  113. *       each  line,  and  an overall file size to the end.  Old ver-
  114. *       sions of uudecode will ignore this  extra  information,  new
  115. *       versions will check it and complain if it is in error.
  116.  
  117.  
  118.  
  119. (D)elete uudecoded file:   D<0|1>
  120. ------------------------
  121. Delete received uuencoded ascii-file after uudecoding.
  122. (default: off)
  123.  
  124.  
  125. (S)trip high bit:   S<0|1>
  126. -----------------
  127. Use this option if you want the high bit of each character
  128. reset that is received when using 8N1.
  129. (default: off)
  130.  
  131.  
  132. (E)xpand blanks:    E<0|1>
  133. ----------------
  134. When this feature is selected, XPr-ASCII will send one space
  135. character for lines which contain only an end-of-line
  136. character.  Use this option when the on-line text editor
  137. you're using exits its input mode whenever a carriage return
  138. is received without any text preceding it.
  139. (default: on).
  140.  
  141.  
  142. (P)rompt char:    P<char>
  143. --------------
  144. Instructs XPr-ASCII to wait for a specific character after
  145. transmitting a line of text.  If blank, text is sent continuously
  146. without interruption for the duration of the transfer.
  147. special chars are:
  148.  \0    = null   (prompt-char option is disabled)
  149.  \n    = newline         (ASCII 10)
  150.  \r    = carriage return (ASCII 13)
  151.  \\    = backslash       (ASCII 47)
  152.  \dNNN = Any decimal ASCII-value  fe: \27  Escape (ASCII 27)
  153. (default: null {=\0}).
  154.  
  155.  
  156.  
  157.  
  158. Send bug-reps, gifts, flames etc. to:
  159.  
  160. Ueli Kaufmann
  161. uucp:  Ueli_Kaufmann@augs1.adsp.sub.org
  162. znet:  U.KAUFMANN@LINK-CH1.ZER
  163. fido:  2:802/810.0 Ueli Kaufmann
  164.