home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Controls / Visual Basic Controls.iso / vbcontrol / vidhandl / extraia.txt < prev    next >
Encoding:
Text File  |  1999-02-03  |  5.4 KB  |  132 lines
  1. EXTRAIA ver 2.0b
  2.  
  3. EXTRAIA.EXE is a simple program that is used to ungroup text files (such as
  4. source codes of programs in C and C++ or any other text files) grouped in one
  5. .SRC large archive, created by hand or by MONTA utility.
  6.  It's usage is:
  7.  
  8.     EXTRAIA filename[.SRC] [/B]       where:
  9.  
  10.     filename     pathname of archive
  11.     /B           extracts archives with binary file tags.
  12.  
  13. The .SRC extension is optional. However if you don't specify the filename
  14. extension EXTRAIA will assume it to be .SRC
  15.  
  16. The .SRC archive is usually a fully ASCII file where each stored file starts
  17. in the immediate line after the file opening tag and ends in the preceding
  18. line of a file closing tag. To be effective these tags must be at the
  19. beginning of the line (excluding the first line, which is reserved for comments,
  20. title, etc). The remaining space on the line after the file opentag is also
  21. reserved for comments.
  22.  
  23. EXTRAIA.EXE allows nested archives, which means that a EXTRAIA/MONTA archive
  24. can also stores other archives without misusing the end of a stored archive.
  25.  
  26. File tags:
  27.  
  28. The file opening tag (file opentag) is in the format of:
  29.  //<FILE="filename">
  30.  
  31. The file closing tag (file closetag) is in the format of:
  32.  //</FILE>
  33.  
  34. THE /B option
  35.    The /B option has been provided to allow compatibility with older versions,
  36. such as the .SRC archives that comes with CRT1_6s.ZIP. This option instructs
  37. EXTRAIA to seek for binary file opentag and file closetag in the archive
  38. instead of normal ASCII TAGS. The earlier versions recognized only these
  39. binary file tags because they are much smaller and easier to handle by
  40. computer. Although they are smaller, it's not advisable to use these tags
  41. because most text editor's can't handle them very well (I mean, even though
  42. they cause no problem to the editor, it's hard to write them in hand (you
  43. might need a binary editor to do so) and most Windows based editors can't
  44. display them correctly). They are:
  45.  
  46. Binary opentag => //filename
  47. Binary closetag => //
  48.  
  49.    EXTRAIA doesn't recognize binary tags and normal ASCII tags simultaneously.
  50. So when /B option is on, normal ASCII tags are considered as comments.
  51.  
  52. NOTICE: EXTRAIA doesn't recognize any file tag on the first line or in the
  53. middle of any line because a file tag is actually composed of a
  54. carriage-return/newline pair plus the tag as shown above. This is valid
  55. for ASCII tags and binary tags.
  56.  
  57. A VERY SIMPLE EXAMPLE
  58.    This is a very simple example of a .SRC archive. To test it you may use
  59. EXTRAIA with this file or simply copy the lines below. REMEMBER, the file
  60. opentag mustn't be on the first line. The file created will by DUMMY.FIL
  61. //<FILE="DUMMY.FIL">
  62.    HELLO WORLD!
  63. //</FILE>
  64.  
  65. A VERY IMPORTANT EXAMPLE
  66.    This example shows the results of misusing file tags and other EXTRAIA
  67. features not listed above.
  68.    Copy the lines below the dashed line and save it as a new filename, then
  69. try EXTRAIA on it.
  70. --------------------------------Example----------------------------------------
  71. The first line is reserved for comments. If any tag is located on this line it will be ignored
  72.  
  73. The first file:
  74. //<FILE="EXAMPLE1.TXT" Comments
  75. Comments> The comments ends in the line with a '>' character if the tag is an ASCII tag.
  76. This is the first example file. Run EXTRAIA again to check the nesting
  77. capabilities of EXTRAIA. EXAMPLE2.TXT, NULL.TXT and EXAMPLE3.TXT will be
  78. extracted
  79. //<FILE="example2.txt">
  80. Example 2
  81. //</FILE>
  82.   ways the tags doesn't work:
  83.     //<FILE="ERROR1.TXT">
  84.      The file tags mustn't be in the first line or in the middle of a line
  85.     //</FILE>
  86. //<File="ErroR2.Txt">
  87. The file tags must be in capital letters, but EXTRAIA is not case sensitive
  88. with filenames.
  89. //</File>
  90.  
  91.    If there's only one line between file opentag and file closetag, only the
  92. contents of the line will be saved. If the line is empty the file
  93. created will be zero in size (NULL.TXT).
  94.  
  95. //<FILE="NULL.TXT">This file is a empty file
  96.  
  97. //</FILE>
  98. //<FILE="EXAMPLE3.TXT">
  99.    A file open tag can be in the immediate line after a file close tag,
  100. but they can't be in the same line.
  101.    This is not true in the opposite case. Between a file open tag and a file
  102. close tag there must be at least one line.
  103. //</FILE>
  104. //</FILE> end of example1.txt
  105.  
  106.  
  107. COPYRIGHT:
  108.    These programs (MONTA.EXE, EXTRAIA.EXE and their source code) are
  109. freeware, that means you can use it and distribute it free of charges,
  110. but do not distribute modified versions, unless you explicitly
  111. warns the user the changes you've done. You can also use the ideas used
  112. in this program (they are on public domain).
  113.    I'm not responsible for any problem the misuse of this program causes in
  114. your system, so in no situation I will compensate any harm or damage caused
  115. by the misuse of this program OR any resulting from any ERROR this program
  116. might have.
  117.  
  118.    In the case of any doubts, complains, suggestions, or mistakes found,
  119. please reply to (preferably) jlfialho@iconet.com.br OR (alternate e-mail)
  120. jlfialho@yahoo.com
  121.  
  122.    I would be glad to receive (via e-mail) any improved version of this program
  123. you might create as any comments or suggestions about the program. Complains are
  124. also welcome.
  125.  
  126. For further information read MONTA.TXT or e-mail me.
  127.  
  128. By Márcio Afonso Arimura Fialho
  129.  
  130. http://pessoal.iconet.com.br/jlfialho
  131. E-mail: jlfialho@iconet.com.br OR (only in the case the first one doesn't work): jlfialho@yahoo.com
  132.