home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / POWERMAG / POWER02.MSA / ST_ZINE.SZ6_ARTICLE6.SZA < prev    next >
Encoding:
Text File  |  1989-04-04  |  13.9 KB  |  385 lines
  1. ST Zip Manual       
  2.  
  3.  
  4.  
  5.  
  6.  
  7.   ____________________________
  8.                _________  ***** ******    ******  *  *****
  9. __________________________         *          *     **   *    *    *
  10.             _________________ **     *         ***    *  ******
  11.    ________________            *   *       **       *  *
  12.              _____________ *****   *      ******  *  *
  13.       ______________________
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                 STZip version 0.7
  23.              (c) Vincent Pomey 1990, 1991
  24.  
  25.  
  26.  
  27.  
  28.    [ Ce fichier contient *VOLONTAIREMENT* la documentation de STZip ]
  29.  
  30.  
  31.  
  32.  
  33.       ******************
  34.       * O - Prologue   *
  35.       ******************
  36.  
  37.  
  38. STZip est un programme permettant de compresser et de décompresser des
  39. fichiers, c'est à dire de reduire leur taille. Vous pouvez ainsi de
  40. gagner de la place sur vos disquettes et réduire les temps de
  41. transmission lorsque vous échangez des fichiers par modem ou Minitel.
  42. Il permet également de stocker plusieurs fichiers dans un seul fichier,
  43. dont l'extension est généralement ZIP.
  44.  
  45. Il utilise des fichiers compatibles avec PKZip 1.1 sur IBM PC. Il
  46. décompresse également les fichiers crées par PKZip 0.9 (Reducing).
  47.  
  48. Vous pouvez et êtes encouragés à copier ce programme et à le mettre en
  49. téléchargement. Toute utilisation commerciale est interdite sans
  50. accord. La modification du programme et de la documentation n'est pas
  51. autorisee, sauf pour realiser une traduction.
  52.  
  53. Je décline toute responsabilité quant aux éventuels dommages pouvant
  54. résulter de l'utilisation de ce programme. Aucune garantie n'est fournie...
  55.  
  56. Lui meme est écrit en Modula-2 et en assembleur. Pour des informations
  57. sur le format des fichiers, lisez APPNOTE.TXT distribué avec PKZip.
  58.  
  59.  
  60.                   ----oooOooo---
  61.  
  62.  
  63. Il y a plusieurs manieres d'utiliser STZip :
  64.  
  65.     - en double cliquant sur STZIP.PRG, vous utiliserez l'interface GEM
  66.  
  67.     - en l'installant comme application dans le bureau : cliquez sur
  68.   STZIP.PRG, choisissez dans les menus du bureau 'Installer une application',
  69.   tapez ZIP et confirmez. Vous pouvez ensuite sauver le bureau. Maintenant,
  70.   pour utiliser STZip il vous suffit de double cliquer sur un fichier .ZIP
  71.   et vous vous retrouverez dans STZip interface GEM pour traiter ce fichier.
  72.  
  73.     - en renommant STZIP.PRG en STZIP.TTP et en utilisant une ligne de
  74.   commande. Bof ...
  75.  
  76.     - à partir d'un Shell texte ou d'un programme externe, en utilisant
  77.   aussi une ligne de commande.
  78.  
  79.  
  80.  
  81. L'utilisation de l'interface GEM est plus facile. Certaines possibilités
  82. sont présentes uniquement en GEM (les commentaires par exemple) alors que
  83. d'autre uniquement en ligne de commande (exclure certains fichiers de la
  84. compression par exemple).
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.       **********************************************
  92.       * I - Utilisation avec une ligne de commande *
  93.       **********************************************
  94.  
  95.  
  96. L'utilisation de STZip avec une ligne de commande est semblable à celle
  97. de Arc ou LHarc sur Atari, et PKZip sur PC.
  98.  
  99.      1 - Un tableau
  100.      --------------
  101.  
  102.      +------------------------------------------------------------------+
  103.      |          La syntaxe est de la forme :                |
  104.      |                                    |
  105.      |       StZip commande {options} [d:\path\] zipfile {fichier}    |
  106.      |                                    |
  107.      |                                    |
  108.      | Il doit y avoir une seule commande :                |
  109.      |                                    |
  110.      |      -a   ajoute des fichiers                    |
  111.      |     °-d   efface des fichiers                    |
  112.      |     °-f   'freshen' met à jour les fichiers contenus dans le zip    |
  113.      |     °-u   'update' ajoute les nouveaux fichiers et met à jour    |
  114.      |           ceux qui sont déjà dans le zip                |
  115.      |      -x   extrait des fichiers                    |
  116.      |      -v   liste des fichiers avec info                |
  117.      |      -l   liste des fichiers juste avec les noms            |
  118.      |      -?   une petite aide                        |
  119.      |                                    |
  120.      |                                    |
  121.      | Vous pouvez rajouter quelques options :                |
  122.      |                                    |
  123.      |      -o   écrase un fichier sans demander de confirmation lorsque    |
  124.      |           que le fichier existe déjà.                |
  125.      |      -r  `compression recursive : tous les fichiers contenus dans    |
  126.      |           les sous catalogues que vous avez demandé de        |
  127.      |           compresser seront également compressés.            |
  128.      |          `decompression recursive : les fichiers compressés dans    |
  129.      |           dans sous catalogues seront décompressés dans les    |
  130.      |           repertoires correspondants, ces repertoires seront    |
  131.      |           automatiquement crées s'ils n'existent pas.        |
  132.      |      -p   store pathname : le path des fichiers que vous avez    |
  133.      |           donnez dans la ligne de commande est stocké dans le zip    |
  134.      |           automatique lors d'une compression recursive        |
  135.      |     °-m   'move file' : les fichiers sont effacés après avoir été    |
  136.      |           compressés.                        |
  137.      |     °-t   la date du fichier .zip sera celle du fichier compressé    |
  138.      |           ayant la date la plus récente.                |
  139.      |      -z   modifier le commentaire pour l'ensemble du fichier zip    |
  140.      |           (le commentaire est affiche a chaque traitement)     |
  141.      |      -h   demande d'appuyer sur une touche avant de partir du    |
  142.      |           programme.                        |
  143.      |      -e   specifie la methode de compression :            |
  144.      |        -es    store, aucune compression            |
  145.      |        -eh    shrink, compression rapide            |
  146.      |        -ei    implode, meilleure compression (defaut)        |
  147.      |                                    |
  148.      +------------------------------------------------------------------+
  149.  
  150.  
  151.      2 - La ligne de commande
  152.      ------------------------
  153.  
  154.       Vous pouvez specifier le sous catalogue par defaut pour toutes les
  155. opérations apres les commandes et les options : par exemple d:\textes\.
  156. Notez le \ à la fin.
  157.  
  158.       Ensuite il faut mettre le nom du fichier zip qui va contenir ou
  159. qui contient deja des fichiers compresses. L'extension .ZIP est prise par
  160. defaut. Vous pouvez egalement donner des noms de catalogues, tous les
  161. fichiers a l'intérieur seront alors compresses.
  162.  
  163.       Après tout çà, vous mettez une liste de fichiers à traiter (ie : effacer,
  164. compresser ou decompresser).
  165.  
  166.       Vous pouvez utiliser les caracteres ? et * dans les noms de fichiers.
  167.             ? remplace un seul caractere,
  168.             * remplace un nombre quelconque de caracteres.
  169.  
  170.       Mettre aucun nom de fichier equivaut a mettre *.* (tous les fichiers).
  171.  
  172.  
  173.      3 - Liste externe
  174.      -----------------
  175.     
  176.       Si un nom commence par un @, cela veut dire qu'en fait ce fichier
  177. est une liste de fichiers à traiter. Si vous avez un fichier liste.txt
  178. contenant par exemple :
  179.  
  180.             *.mod
  181.             zip*.txt
  182.             fichier1.vdt
  183.  
  184.    alors stzip -a burp @liste.txt          est equivalent à
  185.      stzip -a burp *.mod zip*.txt fichier1.vdt
  186.  
  187.       stzip -a burp @    lira les noms de fichiers depuis l'entrée
  188. standard.
  189.  
  190.  
  191.      4 - Exclusion de fichiers
  192.      -------------------------
  193.       
  194.       Si un nom commence par un ~, cela veut dire qu'il ne faut PAS le
  195. traiter. Cela n'a un interèt uniquement quand on utilise des jokers, par
  196. exemple pour compresser tous les fichiers sauf les fichiers .BAK, il faut
  197. faire un truc dans le genre : stzip -a burp *.* ~*.bak    ...
  198.  
  199.      5 - Baratin
  200.      -----------
  201.  
  202.       Il peut y avoir une liste externe dans une liste externe, mais pas
  203. de noms ~. Les noms ~ de la ligne de commande s'appliquent pour tous les
  204. fichiers, y compris ceux des listes externes.
  205.  
  206.       Les matchs se font à la ms dos et non à la unix : *.* correspond
  207. a tous les fichiers et pas seulement ceux avec un point dans leur nom.
  208. Les paths avec des .. ne sont pas (toujours) supportés.
  209.  
  210.       Switch -p :
  211. si vous faites stzip -ap burp fichier\alt.txt , le nom du fichier stocké
  212. dans le zip sera fichier\alt.txt, alors que sans le switch p, il aurait
  213. été alt.txt. Le switch p est automatiquement actionné lors d'une
  214. compression recursive.
  215.  
  216.      6 - Compression recursive
  217.      -------------------------
  218.      
  219.       Si vous avez mis l'option -r lors d'une compression, une grande chose
  220. va se produire : les fichiers que vous donnez seront recherches également
  221. dans tous les sous catalogues en dessous de vous.
  222.  
  223.       Seconde tentative d'explication à base d'exemples, la première
  224. n'étant compréhensible qu'après quelques heures de méditation achevées par
  225. plusieurs aspirines.
  226.  
  227. (Pour mieux comprendre la seconde tentative, il faut savoir que les
  228. répertoires n'existe pas en fait dans un fichier zip. C'est le path du
  229. nom (stocké dans le .zip) du fichier qui contient des noms de sous répertoires)
  230.  
  231. rep est un répertoire.
  232. ...\ représente un nombre quelconque de répertoires, ou même aucun.
  233.  
  234. * stzip -ar burp
  235.    Tous les fichiers dans le catalogue courant sont compressés, y compris
  236. tous les sous répertoires.
  237.  
  238. *  stzip -ar burp rep
  239.    Les fichiers rep\...\*.* sont compressés.
  240.    Nom stocké    \_________/ dans le fichier zip.
  241.    En clair : tous les fichiers contenus dans rep sont compressés, y
  242. compris tous les sous catalogues se trouvant dans rep.
  243.  
  244. * stzip -ar burp rep\*.txt
  245.    Les fichiers rep\...\*.txt sont compressés.
  246.    Nom stocké    \___________/ dans le fichier zip.
  247.    En clair : tous les fichiers d'extension txt présents dans rep et les
  248. sous-répertoire de rep sont compressés.
  249.  
  250. * stzip -ar burp rep\fichier.txt
  251.    Les fichiers rep\...\fichier.txt sont compressés.
  252.    Nom stocké    \_________________/ dans le fichier zip.
  253.    En clair : tous les fichiers 'fichier.txt' présent dans le
  254. répertoire rep et dans les sous répertoire de rep seront compressés.
  255. Il est tout à fait possible qu'un seul fichier soit trouvé. Dans ce
  256. cas, c'est strictement identique à stzip -ap burp rep\fichier.txt.
  257.  
  258. * stzip -ar burp c:\rep
  259.    Les fichiers c:\rep\...\*.* sont compressés.
  260.    Nom stocké           \_____/ dans le fichier zip.
  261.    C'est à dire que c:\rep\ n'apparaitra PAS dans le nom des fichiers
  262. compressés, car c'est un path COMPLET, à la différence de rep\.
  263.    En utilisant également le changement du répertoire courant (du
  264. genre stzip -ar burp c:\rep1\ rep2\*.txt) il est possible de faire toute
  265. sorte de manipulation compliquées avec les noms des fichiers compressés.
  266. Dans cet exemple, les fichiers d'extension txt dans c:\rep1\rep2 seront
  267. compressés mais leur nom dans le fichier zip sera rep2\xxxxx.txt.
  268.  
  269.       Il n'est JAMAIS effectué de test sur le nom des répertoires.
  270. stzip -ar burp *.txt cherchera dans tous les répertoires, et pas
  271. seulement dans ceux d'extension txt !
  272.  
  273.       Certains shells type unix développent eux même les noms de
  274. fichiers avec des jokers. STZip ne reagit pas de la même manière à
  275. 'stzip -ar burp rep\a.txt rep\b.txt' et à
  276. 'stzip -ar burp rep\*.txt' alors que pour le shell c'est identique.
  277. Il est donc dans ce cas nécessaire de rajouter des apostrophes à rep\*.txt
  278. pour que le shell ne développe pas les noms des fichiers. Idem pour le
  279. caractère ~ qui peut poser des problèmes.
  280.  
  281.      7 - Décompression recursive
  282.      ---------------------------
  283.  
  284.       Lorsqu'un fichier zip contient des répertoires, il y a deux
  285. possibilitées :
  286. -les ignorer et décompresser ce que l'on veut dans le répertoire courant,
  287.     c'est le défaut, et ca permet de décompresser rapidement un fichier
  288.     précis sans créer de nombreux répertoires.
  289. -ou décompresser dans ces répertoires en les créant si c'est nécessaire.
  290.     Pour cela, il faut utiliser l'option -r.
  291.  
  292. Vous pouvez toujours utilisez des wildcards pour les noms des fichiers,
  293. et rajouter des paths. Si dans les parametres vous precisez un nom avec
  294. un path, par exemple infra\*.msg, alors tous les fichiers *.msg dans
  295. infra ET dans les sous catalogues d'infra seront extraits.
  296.  
  297.      8 - Commentaires
  298.      ----------------
  299.  
  300.     Le commentaire global pour le fichier zip (modifié à l'aide du
  301. switch -z) est affiché à chaque traitement du fichier.
  302.  
  303.  
  304.  
  305.       ***************************************
  306.       * II - Utilisation de l'interface Gem *
  307.       ***************************************
  308.  
  309. L'utilisation est dans le genre :
  310.     cf bouton 'Aide'
  311.  
  312.  
  313. Pour avoir des infos sur l'ensemble du fichier zip, il faut faire clic
  314. clic sur le nom du fichier zip.
  315.  
  316. Le bouton 'Sous dir. recursif' :
  317.    lors d'une compression, s'il est sélectionné, tous les sous
  318. répertoires seront également compressé.
  319.    lors d'une décompression, s'il est sélectionné, les fichiers seront
  320. extraits dans leur répertoire correspondant, et non dans le répertoire courant.
  321.  
  322.  
  323.       **************************
  324.       * III - Epilogue           *
  325.       **************************
  326.  
  327.      1 - Memoire
  328.      -----------
  329.  
  330. Pour aller plus vite, STZip utilise beaucoup de mémoire. Voici une liste
  331. approximative de ses besoins :
  332.  
  333.     Utilisation avec une ligne de commande :   95k
  334.     Utilisation avec l'interface Gem       :  120k
  335.  
  336. auxquels on rajoute pour compresser (shrink)   :   86k
  337.              compresser (implode)  : beaucoup !
  338.                décompresser (unshrink) :   74k
  339.                décompresser (expand)   :   20k
  340.                decompresser (explode)  : maxi 80k (plus en fait)
  341.  
  342. La mémoire supplémentaire est utilisée jusqu'à 128k comme buffer.
  343.  
  344.  
  345.      2 - Code de retour en Command Line
  346.      ----------------------------------
  347.  
  348. 1  : Pas assez de mémoire
  349. 2  : Fichier non trouve
  350. 3  : Option/Commande invalide
  351. 4  : Deux Commandes spécifiées
  352. 5  : Pas de fichier zip spécifié
  353. 6  : Pas de commandes spécifiée
  354. 7  : Erreur de lecture
  355. 8  : Le fichier zip est endomagé (ou ce n'en n'est pas un)
  356. 9  : Erreur d'ecriture
  357. 10 : Warning pendant décompression, pas assez de mémoire,
  358.      fichier endommagé ou bug de comp/decomp, erreur crc, erreur e/s,
  359.  
  360. 100 : Fonction non implemente
  361.  
  362.      3 - Limitations
  363.      ---------------
  364.  
  365. Le nombre de fichiers a l'intérieur d'un zip n'est limite que par la
  366. mémoire disponible lors du traitement. Neamoins, les boites en gem ne
  367. peuvent contenir que 200 fichiers chacunes (ce qui n'empeche pas un
  368. fichier zip de plus de 200 fichiers d'etre traite correctement en gem).
  369.  
  370. Le cryptage/décryptage n'est pas et ne sera pas supporté.
  371.  
  372.      4 - The end
  373.      -----------
  374.  
  375. Merci a H. Okumura pour son aide pour la compression 'sliding
  376. dictionnary' et a Philippe Regnauld pour le logo STZIP.
  377.  
  378. Bonne utilisation !
  379.  
  380.      Vincent Pomey, 28 avril 90, 13 avril 91.
  381.      
  382.  
  383. STZIP spread to you by DAD/IMPACT 5/92
  384.  
  385.