home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / utility / archiver / unarj_s1 / unarj_st.txt next >
Text File  |  1992-10-05  |  7KB  |  151 lines
  1. UNARJ V2.30 ATARI ST !!!
  2. ========================
  3.  
  4. ==== English translation of this documentation below the German text ==== 
  5.  
  6. Endlich ist es soweit, die (immer noch) aktuelle Version von ARJ hat nun 
  7. einen Auspacker auf dem ST. Dieses Programm basiert auf der Original-PC-
  8. Implementation von Robert K. Jung. Er hat diese Version "abgesegnet", das 
  9. heißt, sie darf als Freeware verbreitet werden. Also: Jeder, der möchte, 
  10. darf ein Kopie machen und uneingeschränkt damit arbeiten. Es soll aber das 
  11. gesamte Paket (mit Sources und Dokumentation, s. unten) kopiert werden. 
  12. Sie darf nicht kommerziell vertrieben werden!
  13.  
  14. Um UNARJ zum Funktionieren zu bewegen, mußte ein "wenig" Arbeit getan 
  15. werden, einteilbar in drei Teile:
  16.  
  17. a) UNARJ.H:
  18. Der ST-Turbo C-Compiler fühlte sich nicht verantwortlich, den Path-
  19. Seperator korrekt auf "\" zu setzen sondern blieb hartnäckig bei "/" (für 
  20. "Nichts besseres gefunden"). Dies habe ich korrigiert.
  21.  
  22. b) ENVIRON.C:
  23. Dieser Source-Text stellt die Portable Basis mit Zugriffen auf die 
  24. (Disketten-)Hardware bereit. Leider benimmt sich ST-Turbo C etwas anders 
  25. als das PC-Turbo C, als das es fehlerhafterweise erkannt wird. Hier mußten 
  26. vor allem andere #include's herhalten und die Implementationen wurden z. 
  27. T. komplett ungestrickt auf ST-Hardware-Konventionen.
  28.  
  29. c) UNARJ.C:
  30. Die Option "X" (auspacken mit Ordnern) funktionierte zwar theoretisch, 
  31. aber leider nicht praktisch, da der Befehl Fopen leider nur Dateien im 
  32. gleichen Verzeichnis erzeugen kann, sobald es aber "in die Tiefe" (also z. 
  33. B. ein Unterverzeichnis tiefer) geht, klappt das nicht mehr, da die ST-
  34. Version das nötige Unterverzeichnis nicht selber erzeugt. Von daher wird 
  35. nun bei Bedarf das entsprechende Verzeichnis erzeugt. [Eigentlich gehört 
  36. dieser Hardware-Zugriff in ENVIRON.C, aber die Aufdröselung wäre noch 
  37. komplizierter geworden, als es nun schon war. Sorry! :-)]
  38. Des weiteren ist die Option "V" (Verbose List - Listen mit Pfadnamen) 
  39. hinzugekommen: Sie zeigt die vollen Dateinamen, ohne Schnickschnack wie 
  40. "Länge ungepackt" etc., nur die Kompressions-Rate wird mit ausgegeben. 
  41. Diese Option ist nun voreingestellt, weil ich diese Ausgabe für 
  42. sinnvoller halte als "L".
  43.  
  44. Es liegt in der Natur der Sache, daß diese, von mir modifizerte Version 
  45. nicht mehr portabel sein kann. Wer sowas sucht, sollte besser die 
  46. Original-Sources nehmen, die ja auch beiliegen.
  47.  
  48. In dieser Package befinden sich die (modifizierten) Sources
  49.                         DECODE.C    (nicht modifiziert)
  50.                         ENVIRON.C
  51.                         UNARJ.C
  52.                         UNARJ.H
  53. sowie das Executable    UNARJ.TTP
  54. und diese Dokumentation UNARJ_ST.TXT.
  55. Hinzu kommt noch die Turbo C V2.0-Projekt-Datei
  56.                         UNARJ.PRJ
  57. die dann den Rest erledigt.
  58. Damit es hinterher nicht wieder heißt, ich hätte Programme ohne 
  59. Dokumentation weitergegeben, ist noch die Original-Package
  60.                         UNARJ230.EXE
  61. von Robert K Jung dabei, die die Dokumentation und die unveränderten 
  62. Source-Texte zu UNARJ enthält. Diese Datei kann recht einfach mit "UNARJ e 
  63. UNARJ230.EXE" ausgepackt werden.
  64.  
  65. Viel Spaß mit dieser ST-Version. Robert K. Jung hat mir versichert, daß 
  66. das ARJ im nächsten Jahr als ST-Implementation erscheinen wird. Ich 
  67. werde mich zukünftig um die Sache kümmern, einfach mal anfragen.
  68.  
  69. Gero Zahn, Sophienstraße 8, W-3060 Stadthagen, Deutschland
  70. Internet: q92127@pbhrzx.uni-paderborn.de
  71.  
  72. Robert K. Jung, 2606 Village Road West, Norwood Massachusetts 02062, USA
  73. Internet: robjung@world.std.com, CompuServe ID: 72677,445
  74.  
  75. ======================================================================
  76.       English translation - please excuse my poor English!
  77. ======================================================================
  78.  
  79. Finally it's done, the unpacking-utility for the (still) newest version 
  80. 2.30 of ARJ works on ST-computers.
  81.  
  82. This compilation bases on the original PC-implementation by Robert K. 
  83. Jung. He allowed to spread this package as freeware, which means that 
  84. anybody who wants to can make a copy of it and use it without 
  85. restrictions. It's important to copy the complete package (with sources 
  86. and documentation, see below). The package mustn't be sold!
  87.  
  88. To make UNARJ work it took a "bit" work, in three of four parts of the 
  89. source-text.
  90.  
  91. a) UNARJ.H:
  92. The ST-Turbo C-compiler didn't feel responsible to set the path-
  93. seperator (correctly) to "\" but it set it to "/" (for "didn't find 
  94. anything better than that"). This has been corrected.
  95.  
  96. b) ENVIRON.C:
  97. The source represents the portable basic I/O-routine on the (disk-
  98. )hardware. But also in these things ST-Turbo C behaved a bit different 
  99. to the PC-Turbo C, and (even worse) - the pre-processor-code of UNARJ 
  100. found no difference between these two completely different compilers. 
  101. The first thing was to replaces the #include's, the second one was to re-
  102. implement some pieces of code again for the ST-hardware.
  103.  
  104. c) UNARJ.C:
  105. The option "X" (extract with folders) should be able to work, but the ST-
  106. reality is again slightly different: The Fopen-command works only for 
  107. files in the same folder, but if it's necesary to create a file in a 
  108. folder doesn't exist yet the ST-GEMDOS doesn't do its work. So it was 
  109. necessary to implement a routine that creates a folder when needed. 
  110. [Actually this is a piece of code concerning the hardware, so it should 
  111. be in ENVIRON.C, but this would have been much more complicated to 
  112. implement. Sorry! :-)]
  113. By the way - UNARJ has been improved by another command-line-option "V" 
  114. (verbose list with pathnames). It shows the complete file-name without 
  115. making fuss about "length unpacked" or such things. Just the compression-
  116. rate is shown on screen. -- This option is the default-one because I 
  117. find it more important that "L".
  118.  
  119. There's no doubt about the fact that this modified version is no more 
  120. portable. If you look for something like that you should use the 
  121. original sources, which are part of this package as well.
  122.  
  123. This package contains the (modified) Sources
  124.                         DECCODE.C   (not changed)
  125.                         ENVIRON.C
  126.                         UNARJ.C
  127.                         UNARJ.H
  128. and the executable      UNARJ.TTP
  129. and this documentationn UNARJ_ST.TXT.
  130. To recompile it I've included the project-file
  131.                         UNARJ.PRJ
  132. that will do the work for you.
  133. Because it's a fine piece of personal style to copy documentations with 
  134. the programmes I've also included the Original UNARJ230-Package by 
  135. Robert K Jung           UNARJ230.EXE
  136. containing the original-documentation and the unchanged sources of 
  137. UNARJ. You can extract the archive by simply executing "UNARJ e 
  138. UNARJ230.EXE".
  139.  
  140. Have fun with this ST-version. Robert K. Jung promised, that the ST-
  141. implementation of ARJ will be developed during the next year. I will 
  142. take care of this in near future, just contact me!
  143.  
  144. Gero Zahn, Sophienstraße 8, W-3060 Stadthagen, Germany
  145. Internet: q92127@pbhrzx.uni-paderborn.de
  146.  
  147. Robert K. Jung, 2606 Village Road West, Norwood Massachusetts 02062, USA
  148. Internet: robjung@world.std.com, CompuServe ID: 72677,445
  149.  
  150. <EOF>
  151.