home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / mdf160.zip / MDF_BRA.TXT < prev    next >
Text File  |  1995-11-12  |  16KB  |  422 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   MDIFF  -  MPATCH
  12.                                     Release  1.50
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.   Simples mas completo este programa produz e aplica patches em seus programas
  27.            e arquivos de dados para Dos, OS/2, Windows95 e WindowsNT.
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                         Manual em Português(Brasileiro)
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.            (C) 1995/96 Maurizio Giunti - Todos os Direitos Reservados
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.      1.INDICE
  59.  
  60.  
  61.      1.INDICE                                                                 2
  62.  
  63.  
  64.      2.DISCLAIMER OF WARRANTY                                                 3
  65.  
  66.  
  67.      3.DISTRIBUIÇAO E USO                                                     3
  68.  
  69.  
  70.      4.PORQUE?                                                                3
  71.  
  72.  
  73.      5.O QUE O MDIFF-MPATCH FAZEM?                                            3
  74.  
  75.  
  76.      6.EXAMPLO                                                                3
  77.  
  78.  
  79.      7.DOS, OS/2, WINDOWS 95 E WINDOWS NT                                     4
  80.  
  81.  
  82.      8.LIMITES E BUGS CONHECIDOS                                              4
  83.  
  84.  
  85.      9.MDIFF - MDIFF2 - MDIFFW                                                4
  86.  
  87.  
  88.      10.MPATCH - MPATCH2 - MPATCHW                                            5
  89.  
  90.  
  91.      11.MDF2EXE - MDF2EXE2 - MDF2EXEW                                         6
  92.  
  93.  
  94.      12.SUGESTÖES                                                             6
  95.  
  96.  
  97.      13.BIBLIOTECAS PARA APLICAR PATCHES                                      6
  98.  
  99.  
  100.      14.REGISTERANDO O MDIFF                                                  6
  101.  
  102.  
  103.      15.COMO CONTACTAR O AUTHOR                                               7
  104.  
  105.  
  106.      16.AGRADECIMENTOS                                                        7
  107.  
  108.  
  109.  
  110.  
  111.  
  112.                                                                               2
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.      2.GARANTIA
  120.      Esse software e os arquivos que o acompanham sao vendidos como
  121.      estao, sem garantias de performance de vendas ou nenhuma outra
  122.      garantia, implicita ou explicita.
  123.      A unica garantia que acompanha esse software eh que ele ocupara
  124.      espaco de disco. Eu absolutamente NAO posso garantir que ele
  125.      funcionara perfeitamente ou que ele sera a solucao dos seus
  126.      problemas. No entanto ele nao eh um virus e nao contem (a menos que
  127.      infectado ou modificado apos a compilacao) "cavalos de troia",
  128.      acessos escusos nem armadilhas similares. De qualquer forma, o autor
  129.      nao eh responsavel por nenhum dano, moral ou material, direto ou
  130.      indireto, derivado do seu uso.
  131.  
  132.      3.DISTRIBUIÇÄO E USO
  133.      Este software é um programa Shareware : todos podem distribui-lo e usa-lo
  134.      por um periodo de avaliaçäo de 15 dias.  Após este periodo, os usuários
  135.      que desejarem continuar usando o programa, precisam registra-lo junto ao
  136.      seu autor, Maurizio Giunti.
  137.      Os usuários registrados, receberäo a sua "key de registro" que contém seu
  138.      nome (ou da empresa/organizaçäo no caso de licença de site).
  139.      Este software pode ser distribuido livrimente sem cisto, exceto no caso de
  140.      custos de cópia/envio.
  141.      É imperativo que seja sempre distribuido o PACOTE original sem qualquer
  142.      modificaçäo.
  143.      Esta é a unica execeçäo: você pode distribuir o  MPATCH.EXE, MPATCH2.EXE
  144.      e/ou MPATCHW.EXE  com um ou mais arquivos *.MDF produzidos com uma cópia
  145.      REGISTERADA do MDIFF. Também pode ser distribuido qualquer executavel
  146.      produzido com o MDF2EXE.EXE,  MDF2EXE2.EXE  e  MDF2EXEW.EXE que contenha
  147.      SOMENTE  patches MDF criados com uma cópia registrada do MDIFF.
  148.      Sobre os patches *.MDF o autor deste programa näo reclama direitos.
  149.  
  150.      4.PORQUE?
  151.      A alguns meses atrás, eu atualizava um programa meu: desde que o pacote
  152.      compactado tivesse 200 Kbytes, Eu pensei que seria ótimo usar patch, mas
  153.      Eu näo pude encontrar um programa que me satisfizesse pata fazer e aplicar
  154.      patches. Adcionalmente, näo encontrei nada que rodasse sob DOS e OS/2.
  155.      Eu decidi fazer meu software de patch e.....aqui está ele ! 8-)
  156.  
  157.      5.O QUE O MDIFF-MPATCH FAZEM?
  158.      MDIFF  cria arquivos de diferença binaria entre dois arquivos. Com MPATCH
  159.      e o velho arquivo você pode criar o novo arquivo usando o arquivo de
  160.      diferença. Qual é a vantagem? Usualmente o arquivo de diferença é menor
  161.      e de mais fácil distribuiçäo, especialmente via modem.
  162.  
  163.      6.EXAMPLO
  164.      Como exemplo, Eu pus em dois diretórios chamados OLD e NEW, respectivamente
  165.      MDIFF.EXE release 1.45a (um trabalho em progresso versäo alpha) e MDIFF.EXE
  166.      release 1.45:
  167.  
  168.      Diretório de  OLD\*.EXE
  169.      MDIFF.EXE       46602  16/08/95   21.01
  170.  
  171.      Diretório de  NEW\*.EXE
  172.      MDIFF.EXE       46602   21/08/95  00.45
  173.                                                                               3
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.      C:\>mdiff OLD\MDIFF.EXE NEW\MDIFF.EXE
  181.      MDIFF  V1.50 - MDF file generator (Dos)
  182.      (C) Copyright 1995/96 Maurizio Giunti
  183.  
  184.      Registered to: MAURIZIO GIUNTI
  185.  
  186.      OLD\MDIFF.EXE,NEW\MDIFF.EXE => MDIFF.MDF
  187.      Working...(100%)   MDF size: 1215 bytes   Rate: 2%
  188.      <Done!>
  189.  
  190.      Diretório de  *.MDF
  191.      MDIFF.MDF        1215   7/10/95  13.43
  192.  
  193.      Agora, nós podemos aplicar o patch chamado MDIFF.MDF no arquivo velho
  194.      e obter o novo a partir dele :
  195.  
  196.      C:\>mpatch MDIFF.MDF old\MDIFF.EXE
  197.      MPATCH  V1.50 - MDF file applier (Dos)
  198.      (C) Copyright 1995/96 Maurizio Giunti
  199.  
  200.      MDF file produced by: MAURIZIO GIUNTI
  201.  
  202.      Working: 0% |###########| 100%
  203.      <Done!>
  204.  
  205.      Eu obtenho o seguinte arquivo:
  206.  
  207.      Diretório de  *.EXE
  208.      MDIFF.EXE       46602  21/08/95   0.41
  209.  
  210.      com o BINARIO IGUAL ao novo arquivo.
  211.  
  212.      7.DOS, OS/2, WINDOWS 95 E WINDOWS NT
  213.      Eu usualmente crio MDIFF e MPATCH para Dos, OS/2 e Windows32  só compilando
  214.      o mesmo fonte, sem NENHUMA diferença entre eles. Também os arquivos de
  215.      diferença produzidos com MDIFF para Dos podem ser usados com MPATCH para
  216.      OS/2 ou Windows32 e viceversa.
  217.  
  218.      8.LIMITES E BUGS CONHECIDOS
  219.      MDIFF  näo pode trabalhar com arquivos maiores que 16 Mbytes e nao processa
  220.      arquivcos 20 veses menores que o corrente "chunk length".
  221.      Desde que o fonte é o mesmo para o MDIFF Dos, o MDIFF OS/2 näo reconhece
  222.      Atributos Extendidos: simplismente os ignora.
  223.      Também se você cria patches com o MDIFF para Dos ou OS/2, e você aplicar
  224.      com MPATCH para Windows32 e viceversa, se você cria patches com MDIFF para
  225.      Windows32 e aplicar com MPATCH para Dos ou OS/2, você vai obter uma data e
  226.      hora errada para o novo arquivo.  Este bug depende de uma implementaçäo
  227.      diferente da funçäo utime() nos compiladores da Borland  and   Microsoft.
  228.  
  229.      9.MDIFF - MDIFF2 - MDIFFW
  230.      MDIFF  comparra 2 arquivos e grava as diferenças entre eles num aqruivo de
  231.      diferença. Esta é a sintaxe de linha de comando:
  232.  
  233.                                                                               4
  234.  
  235.  
  236.  
  237.  
  238.  
  239.         MDIFF [-C<c>] [-R<r>] [-F<f>] [-S] [-Z] [-P<pwd>] <OldFile> <NewFile>
  240.                                      [<MDFfile>]
  241.  
  242.      <OldFile> é o nome do arquivo antigo, <NewFile> é o nome do novo arquivo.
  243.      Se você quiser, pode especificar o nome do arquivo de diferença que o
  244.      MDIFF  produzirá, senäo o MDIFF criará um arquivo com o mesmo nome do novo
  245.      arquivo, porém com a extensäo ".MDF".
  246.      Para procurar as diferenças entre arquivos, MDIFF usa uma string base de
  247.      tamanho definido chamada "Chunk". O tamanho do Chunk por default é de
  248.      16 bytes, mas você pode mudá-lo, a faixa é de 4-256, com a chave -C seguida
  249.      do tamanho desejado.
  250.      Quando o MDIFF perde o sincronismo entre os dois arquivos comparados, ele
  251.      busca o arquivo velho pelo chunk corrente. Esta busca é executada, por
  252.      default, numa faixa de 8 blocos de 512 bytes cada. Você pode mudar o número
  253.      de blocos procurados, numa faixa de 1-16, com a chave -R seguida pelo
  254.      número desejado de blocos.
  255.      Se esta busca falha, MDIFF tenta frocar o sincronismo com uma faixa de
  256.      busca maior. Esta faixa é definida como 1/16 do tamanho do arquivo antigo,
  257.      mas você pode mudar isto com a chave -F na linha de comando.
  258.      Se Você especificar a chave -S, MDIFF irá prover alguma informaçöes sobre
  259.      a composiçäo do arquivo de diferença.
  260.      Também você pode adicionar ao arquivo de diferença um pequeno comentário
  261.      (max. 2 Kbytes) para ser mostrado quando o patch for aplicado, usando a
  262.      chave -Z .
  263.      MDIFF pega o comentário do input standard, você pode digitar diretamente
  264.      ou redireciona-lo de um arquivo com o comando "<".
  265.      Você pode proteger o patch com uma password usando a chave -P seguida da
  266.      password. Note que a password e case sensitive.
  267.  
  268.      10.MPATCH - MPATCH2 - MPATCHW
  269.      Com o arquivo antigo e o arquivo .MDF, você pode criar o novo arquivo com
  270.      o MPATCH. Esta é a sintaxe de linha de comando:
  271.  
  272.                  MPATCH [-P<pwd>] <MDFfile> [<OldFile> [<NewFile>]]
  273.  
  274.      MPATCH precisa apenas do nome do arquivo MDF (<MDFfile>) porque ele contém
  275.      os nome dos dois outros arquivos, mas é possível sobrepor esses nomes
  276.      especificando os nomes na linha de comando. MPATCH tem apenas a chave -P
  277.      para que você possa especificar a paddword (caso exista).
  278.      Se algunm erro acontecer durante a aplicaçäo do patch, MPATCH retorna um
  279.      errorlevel como abaixo:
  280.      0        "OK!"
  281.      1        "Sem memória !"
  282.      2        "Näo pode abrir o arquivo MDF !"
  283.      3        "Arquivo MDF inválido !"
  284.      4        "Versäo do arquivo MDF incompátivel !"
  285.      5        "UNREGISTERED !"
  286.      6        "Arquivo ANTIGO incorreto ou ruim !"
  287.      7        "Näo pode abrir o arquivo ANTIGO !"
  288.      8        "Näo pode criar o NOVO arquivo !"
  289.      9        "Falha geral: NOVO arquivo corrompido !"
  290.      10       "Velho e NOVO arquivo nÄo podem ser os mesmos !"
  291.      11       "NOVO arquivo já sofreu patch !"
  292.      12       "Password errada !"
  293.  
  294.  
  295.                                                                               5
  296.  
  297.  
  298.  
  299.  
  300.  
  301.      11.MDF2EXE - MDF2EXE2 - MDF2EXEW
  302.      MDF2EXE  é um utilitário simples que pöe um ou mais (mais de 127) arquivos
  303.      de patch MDF criados pelo MDIFF, em um executável (Dos, OS/2 ou Windows32).
  304.      Isto permite que a simples chamada do executável, instale os patches.
  305.      A sintaxe do MDF2EXE é:
  306.  
  307.            MDF2EXE <mdf_file 1> [<mdf_file 2>....<mdf_file n>] <exe_file>
  308.  
  309.      Onde <mdf_file x> pode conter wildcards.
  310.      O  <exe_file> (PRECISA ter a extensäo .EXE) será executado sem nenhum
  311.      parametro na linha de comando. Ele irá automaticamente procurar e fazer os
  312.      updates necessários.
  313.      Eventualmente voce poderá usar a chave -P para especificar a password ou
  314.      as chaves -V  ou -L para listar os patches que fazem parte do arquivo.
  315.      Atençäo:  Näo comprima o arquivo self-extract com o PKLite ou LZexe ou
  316.      outro programa similar de compressäo/encriptaçäo.
  317.  
  318.      12.SUGESTOES
  319.      O melhor metodo de aplicar os arquivos de diferença e procurar o chunks do
  320.      novo arquivo dentro do antigo arquivo, mas isto é muito lento para fazer !
  321.      o algoritimo do MDIFF tenta fazer um diff pequeno para melhorar isto; as
  322.      veses é necessário que você mude os parametros da linha de comando para
  323.      ajudar também.
  324.      Veja esta soluçöes tipicas:
  325.      1.
  326.        Arquivos muito pequenos: use um chunk grande (32, 64  ou mais) para
  327.        redizir o tamanfo do arquivo diff, em particular de arquivos que contem
  328.        arquivos texto ou compactados.
  329.      2.
  330.        Arquivos texto: tente usaar um chunk de 32, algumas veses é melhor que
  331.        desligue o sync forçado or reduza este sync com a chave -F.
  332.      3.
  333.        Executáveis muito grandes: tente usar uma faixa de resync grande (16 ou
  334.        mais),com a chave -R.
  335.      Lembre-se: MDIFF  näo faz milagers! Se dois arquivos säo muito diferentes,
  336.      o patch será um arquivo muito grande. Nesta situaçäo, talvez seja vantagem
  337.      distribuir o novo arquivo. MDIFF é útil apenas quanto a quantidade de
  338.      alteraçöes é limitada.
  339.  
  340.      13.BIBLIOTECAS PARA APLICAR PATCHES
  341.      Incluido neste pacote, você encontrará um set completo de bibliotecas para
  342.      fazer seu programa de aplicar patches. Estas bibliotecas NÄO aplicam
  343.      patches gerados com uma cópia UNREGISTERED do MDIFF.
  344.      Ou seja estas bibliotecas somente aplicam patches gerados com uma versäo
  345.      registrada do MDIFF.
  346.  
  347.      14.REGISTRANDO O MDIFF
  348.      Registrando o MDIFF você obterá sua KEY DE REGISTRO que conterá o seu nome
  349.      (ou da firma/organizaçäo para site-licenses). Quando você produzir um patch
  350.      com o MDIFF registrado, ele gravará seu nome no patch. Quando o MPATCH for
  351.      instalar seus patches, seu nome será mostrado.
  352.      Também qualquer usuário registrado tem a permissäo de distribuir livremente
  353.      o MPATCH.EXE, MPATCH2.EXE e MPATCHW.EXE com qualquer MDF preparado  pelo
  354.      usuárioa. Qualquer patch self-extract produzido por um usuário registrado,
  355.      pode ser distribuido livremente.
  356.      Nenhum royalty ou taxa extra é requerido!
  357.      Incluso no pacote do MDIFF você irá encontrar um programa de registro for
  358.      Windows chamado REGISTER.EXE. Por favor, rode-o de DENTRO do Windows.
  359.                                                                               6
  360.  
  361.  
  362.  
  363.  
  364.  
  365.      REGISTER.EXE é uma pequena aplicaçäo Windows escrita por Grzegorz  (Greg)
  366.      Kochaniak, que provê as informaçöes para comprar o MDIFF e permite que
  367.      você envie diretamente para o Kagi Shareware service por snail  mail,
  368.      e-mail ou fax. Se você näo usa Windows, Por favor, me contacte.
  369.      Para informaçöes sobre Kagi Shareware por favor leia o arquivo KAGI.TXT.
  370.  
  371.      15.COMO CONTACTAR O AUTOR
  372.      Para qualquer problema ou pergunta, você pode me contactar no seguinte
  373.      endereço:
  374.  
  375.      snail mail:
  376.                      Maurizio Giunti
  377.                      Via G.B. Foggini, 24
  378.                      50142 Firenze (FI)
  379.                      ITALY
  380.  
  381.      e-mail:
  382.                      Fidonet:      2:332/102.3
  383.                      Internet:     giunti@kagi.com
  384.                                    giunti@abeline.it
  385.                                    giunti@statsun.ds.unifi.it
  386.  
  387.      16.AGRADECIMENTOS
  388.      Eu gostaria de agradeçer a quem me ajudou a desenvolver este software,
  389.      escrever a documentaçäo e a todos que ajudaram-me como beta-testers. Em
  390.      ordem alfabetica:
  391.  
  392.                             Mauricio Mello de Andreade
  393.  
  394.                                    Andrea Baitelli
  395.  
  396.                                     Silvia Borri
  397.  
  398.                                  Juan Jose Comellas
  399.  
  400.                                     Filippo Dini
  401.  
  402.                                  Fabrizio Fioravanti
  403.  
  404.                                  Cristiano Guidoccio
  405.  
  406.                                 Giovanni Lopes Pegna
  407.  
  408.                                   Marco Maccaferri
  409.  
  410.                                   Marco Menichelli
  411.  
  412.                                    Giuseppe Scarpi
  413.  
  414.                                    Toni Tatafiore
  415.  
  416.                                     Duncan Wilcox
  417.  
  418.  
  419.  
  420.                                                                               7
  421.  
  422.