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