home *** CD-ROM | disk | FTP | other *** search
/ ftp.uv.es / 2014.11.ftp.uv.es.tar / ftp.uv.es / pub / msdos / network / bex.doc < prev    next >
Text File  |  1994-06-15  |  14KB  |  358 lines
  1.  
  2.  
  3.  
  4.                                     BEX
  5.  
  6.              Codificador/Decodificador BinHex 4.0 para UNIX & DOS
  7.  
  8.  
  9.                                =============
  10.                                Manual de Uso
  11.                                =============
  12.  
  13.  
  14.  
  15.     (c) Hector Rulot, Centro de Informatica, Universitat de Valencia (SPAIN)
  16.                                 16-Jun-1994
  17.  
  18.     
  19.     INTRODUCCION
  20.     ------------
  21.     
  22.     1) ?Para que sirve BEX?
  23.        
  24.        BEX permite codificar y decodificar ficheros con el formato de
  25.        codificacion BinHex 4.0. Este formato es un estandar de facto
  26.        para codificar como TEXTOS ficheros y aplicaciones Macintosh de
  27.        cualquier tipo, pero se usa tambien en otros entornos (DOS, UNIX,...)
  28.        
  29.        La razon fundamental de codificar un fichero como TEXTO es poder
  30.        enviarlo sin problemas a traves de un medio que solo es capaz de
  31.        transmitir TEXTOS, usualmente el correo electronico.
  32.        
  33.  
  34.     2) ?Que es un TEXTO?
  35.     
  36.        En el lenguaje informatico, solo se consideran como TEXTOS aquellos
  37.        ficheros que contienen texto legible para una persona pero en su
  38.        forma mas sencilla: series caracteres (a menudo unicamente ingleses)
  39.        separados por el(los) caracter(eres) de salto de linea. Se puede dar
  40.        por seguro que NO ES un fichero TEXTO un documento que contiene
  41.        realces (negritas, italicas, subrayados,...), formatos (magenes,
  42.        tabuladores, paginado,...), etc...
  43.        
  44.     
  45.     3) ?Como conseguir BEX?
  46.  
  47.        BEX se halla disponible para todos los usuarios de la Internet en el
  48.        servidor FTP anonimo de la Universitat de Valencia:
  49.        
  50.        ftp.uv.es:/pub/msdos/network/bex.exe
  51.        
  52.        [Acordarse de hacer la transferencia en binario]
  53.        
  54.        Los listados fuentes del programa, listos para su compilacion en
  55.        MSDOS (probado con Turbo C 2.0) y Unix (probado con HP-UX) estan
  56.        en:
  57.        
  58.        ftp.uv.es:/pub/src/bex101.tar.Z
  59.  
  60.     
  61.     DECODIFICACION
  62.     --------------
  63.     
  64.     4) ?Como se decodifica un fichero con BEX?
  65.     
  66.        BEX permite codificar/decodificar un fichero guardado como tal en
  67.        el sistema operativo en que se vaya a usar (MS-DOS o  UNIX ). 
  68.        
  69.        Si el fichero, como es usual, ha sido recibido por correo electronico 
  70.        (es una carta), dar al programa de lectura del correo las instrucciones
  71.        pertinentes para que guarde la carta en un fichero del ordenador.
  72.        IMPORTANTE: fijarse en que DIRECTORIO se guarda el fichero y en
  73.        con que NOMBRE se guarda (el programa de lectura de correo seguro
  74.        que lo pregunta). 
  75.        
  76.        Por convenio, los ficheros codificados en BinHex suelen llevar el
  77.        sufijo ".HQX". Procurar seguir el convenio y usar este sufijo
  78.        al bautizar el fichero donde se guarde la carta.
  79.        
  80.        Ejemplo (MS-DOS): nombre "misdatos.hqx", directorio "c:\miscosas". Es
  81.        decir, para el MS-DOS:  "c:\miscosas\misdatos"
  82.  
  83.        Para decodificar un fichero, usar BEX con la opcion "-u" sobre el
  84.        fichero en cuestion:
  85.        
  86.            bex -u c:\miscosas\misdatos.hqx
  87.            
  88.        Esto generara tres ficheros en el directorio actual (en MS-DOS, el
  89.        directorio actual suele aparecer cada vez que pide un comando:
  90.        "c:\aqui\estoy>  "). Los tres ficheros tendran el nombre que
  91.        originalmente tenia el fichero antes de codificar (o la mejor
  92.        aproximacion permitida por el sistema operativo en que se 
  93.        trabaje); pero uno de ellos no tendra sufijo, otro tendra el
  94.        sufijo ".CAB" y el otro el sufijo ".RSR".
  95.        
  96.        Por ejemplo, si documento original se llamaba "Cricket Graph 1.3.1 (S)",
  97.        [propaganda gratuita] se generan (MS-DOS):
  98.          
  99.          Cricket_.cab      (Informacion del Finder)
  100.          Cricket_.rsr      (Recursos)
  101.          Cricket_          (Datos)
  102.          
  103.        El fichero que normalmente interesa a un usuario MS-DOS o UNIX es el 
  104.        que no tiene sufijo (el de Datos). La "Informacion del Finder" y
  105.        los "Recursos" son las otras dos de las tres partes de las que se 
  106.        compone un archivo de Macintosh, y normalmente solo tienen utilidad o 
  107.        significado para un Macintosh.
  108.        
  109.  
  110.  
  111.     5) ?Puedo evitar que me genere los ficheros ".CAB" y ".RSR"?       
  112.    
  113.        Si, utilizando las opciones "-C" (no generar ".CAB") y "-R"
  114.        (no generar ".RSR").
  115.       
  116.        Ejemplo (MS-DOS):
  117.       
  118.             bex -u -C -R c:\miscosas\misdatos.hqx
  119.            
  120.        Tambien existe la opcion "-D", si lo interesa descartar son los "Datos"
  121.       
  122.       
  123.  
  124.     CODIFICACION
  125.     ------------  
  126.       
  127.     6) ?Como codificar un fichero con BEX?
  128.    
  129.        Si el fichero es un fichero que se va a codificar para su envio, se
  130.        supone que su duegno sabe su nombre y el directorio en que lo tiene.
  131.        
  132.        Ejemplo (MS-DOS): nombre "midocu", directorio "c:\miscosas". Es
  133.        decir, para el MS-DOS:  "c:\miscosas\midocu"
  134.        
  135.        Para codificar un fichero, usar BEX sin opciones (o con la opcion "-c"):
  136.        
  137.           bex c:\miscosas\midocu
  138.           
  139.        Esto genera en el directorio actual (en MS-DOS, el directorio actual 
  140.        suele aparecer cada vez que pide un comando:  "c:\aqui\estoy>  ") un
  141.        fichero con el mismo nombre que el original, pero con el sufijo ".hqx":
  142.        
  143.          midocu.hqx
  144.          
  145.        que es le fichero original codificado en BinHex 4.0.  Por convenio, 
  146.        los ficheros codificados en BinHex suelen llevar el sufijo ".HQX". 
  147.        
  148.        Si, como es usual, se desea mandar este fichero por correo, habra
  149.        que instruir al respecto al programa de correo para que lo haga. Ello
  150.        normalmente implicara insertar "midocu.hqx" en una carta mientras
  151.        se la esta escribiendo, o directamente usar el comando adecuado 
  152.        para "mandar un fichero texto" en el programa de correo.
  153.        
  154.       
  155.     7) ?Si tengo los recursos y la informacion de cabecera, puedo incluirlos
  156.        al generar el fichero codificado?
  157.        
  158.        Si. Esto puede ocurrir si se ha "despiezado" con BEX un fichero original
  159.        de Macintosh, se ha modificado alguna de sus partes y ahora quiere
  160.        recomponerse el original. Basta con que existan, en el mismo 
  161.        directorio que el fichero a codificar, ficheros con el mismo
  162.        nombre pero con los sufijos ".RSR" (Recursos) y ".CAB" (Informacion
  163.        del Finder). Si existen, BEX los incluira automaticamente al
  164.        generar el fichero codificado.
  165.        
  166.        Ej: Si en mi directorio actual tengo:
  167.        
  168.               midocu
  169.               midocu.rsr
  170.               midocu.cab
  171.               
  172.             Al hacer:
  173.             
  174.               bex midocu
  175.               
  176.             Se genera un "midocu.hqx" que contiene los tres anteriores.
  177.             
  178.  
  179.     8) ?Puedo cambiar el TIPO y el AUTOR de un fichero generado con BEX?
  180.     
  181.        En Macintosh, el TIPO y AUTOR de un fichero permiten saber que
  182.        aplicacion se lanzara por defecto para leer/modificar un determinado 
  183.        archivo (que aplicacion se lanza cuando se pica 2 veces en un archivo).
  184.        Tambien determina el que una aplicacion pueda abrir o no un 
  185.        archivo (una aplicacion normalmente solo puede ver/abrir aquellos
  186.        archivos de la que es AUTOR y/o que son del TIPO que sabe manejar).
  187.        
  188.        Para que BEX, al generar un fichero codificado BinHex, le ponga
  189.        un determinado TIPO y AUTOR (por defecto pone DOS? DOS?), basta
  190.        usar las opciones "-t" y "-a". El tipo y el autor son siempre de
  191.        4 letras.
  192.        
  193.        Por ejemplo, para especificar que para el Macintosh mi fichero
  194.        sera un documento TEXTO, que va a manejarse por el Microsoft Word
  195.        [propaganda gratuita], se pondria:
  196.        
  197.        bex -tTEXT -aMSWD midocu
  198.        
  199.  
  200.     9) ?Puedo hacer que siempre que codifique un determinado tipo de 
  201.        fichero en MS-DOS (o UNIX), bex ponga un TIPO y AUTOR adecuado
  202.        para el Macintosh?
  203.     
  204.        Si. BEX determina el tipo del fichero MS-DOS (o UNIX) a partir
  205.        del sufijo que tenga. Si este sufijo aparece en la "Tabla
  206.        de Sufijos", BEX le pondra el TIPO y AUTOR especificado en la
  207.        tabla.
  208.        
  209.        La "Tabla de Sufijos" es un fichero que esta en el directorio
  210.        actual y se llama "Mac.suf". Si tiene otro nombre y/o esta en
  211.        otro directorio, esto se le puede especificar a BEX con la
  212.        opcion "-T" [Atencion a la mayuscula].
  213.        
  214.        Ejemplo (MS-DOS):
  215.        
  216.              bex -Tc:\tablas\mitabla.tab midocu
  217.              
  218.        La "Tabla de Sufijos" es un fichero TEXTO (utilizar "edit" o
  219.        similar para crearlo/modificarlo). El contenido de la "Tabla de 
  220.        Sufijos" es una serie de lineas, cada ella con tres palabras (separadas 
  221.        por espacios):
  222.        
  223.            sufijo tipo autor
  224.            
  225.        El sufijo solo puede tener 3 letras en MS-DOS.
  226.        
  227.        Un ejemplo de tabla de sufijos para MS-DOS:
  228.        
  229.           PAS TEXT TPAS
  230.           TXT TEXT MWII
  231.           C   TEXT MSWD
  232.           CPP TEXT MSWD
  233.           BAT TEXT MWII
  234.           COM IBMB IBM
  235.           DOC WDBN MSWD
  236.           WKS XLS  XCEL
  237.           WK1 XLS  XCEL
  238.           XLS XLS  XCEL
  239.           XLC XLC  XCEL
  240.           RTF TEXT MSWD
  241.           PM3 ALB3 ALD3
  242.           PT3 ALT3 ALD3
  243.           PM4 ALB4 ALD4
  244.           PT4 ALT4 ALD4
  245.           
  246.       
  247.    OTROS DETALLES
  248.    --------------
  249.     
  250.    10) !Que barbaridad!. !Que complicado!. ?Hay mas?
  251.    
  252.        Poca cosa. BEX tiene ademas una opcion, "-o", que permite
  253.        escribir el fichero que genera en el "output" (la pantalla 
  254.        o el programa siguiente en una "pipe"). 
  255.        
  256.        Cuando decodifica, la opcion "-o" escribe en el "output" los
  257.        "Datos". "Recursos" e "Informacion del Finder" se descartan. 
  258.        Por ejemplo, si se ha recibido "listo.hqx", que contiene
  259.        un documento listo para imprimir en una DETERMINADA
  260.        impresora, se le podria mandar directamente (MS-DOS, suponiendo
  261.        la impresora en el puerto paralelo):
  262.        
  263.           bex -o listo.hqx >LPT1:
  264.        
  265.        Cuando codifica, la opcion "-o" escribe en el "output" el 
  266.        fichero codificado, lo cual en UNIX por ejemplo, permite
  267.        mandarlo directamente por correo con el comando mail:
  268.        
  269.            bex -o midocu | mail hector.rulot@uv.es
  270.            
  271.        Existe tambien una opcion "-d", que solo tiene utilidad para
  272.        saber porque un fichero no se puede codificar o decodificar.
  273.        Lo que BEX produce cuando se utiliza esta opcion solo
  274.        lo entendia (en pasado) el autor.
  275.        
  276.  
  277.    11) !Jamas podre acordarme de todas estas opciones sin el manual!
  278.    
  279.        Eso no es un pretexto valido para no usar BEX. Llamando a
  280.        BEX sin argumentos, proporciona una ayuda y un resumen de las 
  281.        opciones que soporta:
  282.        
  283.        bex
  284.        ..............
  285.        Binhex/UnBinHex, (c) by H.Rulot
  286.        e-mail:hmr@graf.ci.uv.es), Vers. 1.01 Sep. 1993 - CIUV
  287.  
  288.        Syntaxis: %s [-doucDRC] [-tTIPO] [-aAUTH] [-Tnomf] fic1 fic2...
  289.          -c      Codifica en BinHex los fichero indicados (defecto).
  290.          -u      Decodifica ficheros BinHex.
  291.          -o      Envia segmento de datos al output. Los demas se descartan.
  292.                  En codificacion, escribe en output en vez de en fichero.
  293.          -tTIPO  Especifica el TIPO de los ficheros a codificar.
  294.          -aAUTH  Especifica el AUTHor de los ficheros a codificar.
  295.          -Tnomf  Especifica el nombre del fichero de sufijos (Mac.suf por defecto).
  296.          -D      Descarta segmento de datos al decodificar.
  297.          -R      Descarta segmento de recursos al decodificar.
  298.          -C      No genera fichero de cabecera al decodificar.
  299.          -h      Proporciona mas ayuda.
  300.          -d      Activa traza de 'debugging'.
  301.          fic1 fic2... Ficheros a codificar/decodificar.
  302.        ..............
  303.  
  304.        E incluso da aun mas detalles si se usa la opcion "-h":
  305.  
  306.        bex -h
  307.        ..............
  308.        Binhex/UnBinHex, (c) by H.Rulot
  309.  
  310.        Al decodificar se generan los ficheros:
  311.           nombre       Con el segmento de datos.
  312.           nombre.rsr   Con el segmento de recursos.
  313.           nombre.cab   Con la informacion de cabecera.
  314.        Donde 'nombre' es el nombre del fichero especificado en el
  315.        fichero codificado.
  316.  
  317.          Al codificar 'fic', si existe fic.rsr, se le agnade como
  318.        fichero de recursos. Si existe fic.cab, se le utilizara
  319.        para generar la cabecera (sino, se genera una cabecera por defecto).
  320.  
  321.          Si existe el fichero de sufijos, y en el existe una linea con
  322.        'sufijo tipo autor' y el nombre del fichero termina con '.sufijo',
  323.        se utilizara 'tipo' y 'autor' al codificar el fichero.
  324.        ..............
  325.  
  326.    12) Tengo un amigo extranjero que quiere usar BEX, pero no entiende
  327.        ni la ayuda ni los mensajes de BEX...
  328.  
  329.        BEX existe en version inglesa para la exportacion. Solicitarmela
  330.        por correo electronico a "Hector.Rulot@uv.es". En un futuro,
  331.        estara en el mismo servidor FTP anonimo que la castellana.
  332.  
  333.        Este manual NO EXISTE (?ni existira?) en version inglesa.
  334.        
  335.    
  336.    13) ?Que tienen que ver BEX y POST (el programa de correo electronico
  337.        del mismo autor)? 
  338.  
  339.        BEX es una version independiente del modulo que utiliza POST
  340.        para enviar y/o recibir automaticamente ficheros codificados
  341.        en BinHex 4.0.
  342.  
  343.  
  344.    NOTAS IMPORTANTES
  345.    ----------------- 
  346.        
  347.        - Las opciones se ponen tal cual aparecen en el texto,
  348.              MAYUSCULAS o MINUSCULAS incluidas.
  349.  
  350.        - En UNIX todos los sufijos son en MINUSCULAS.
  351.  
  352.        - BEX no avisa si no encuentra la tabla de sufijos.
  353.        
  354.        - Para programadores: BEX puede utilizarse como MODULO, llamable
  355.          como rutinas C desde cualquier programa principal.
  356.        
  357.        
  358.