
 ۻ   ۻ  ۻ     El Conversor RCVT
 ۻ ۻ ۻ    ~~~~~~~~~~~~~~~~~
 ɼ ۺ ɼ    Utilidad de Conversin de Archivos v1.02
 ۻ ۺ ۻ    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 ۺ  ۺ ۺ  ۺ ۺ  ۺ    Manual el Usuario
 ͼ  ͼ ͼ  ͼ ͼ  ͼ    ~~~~~~~~~~~~~~~~~

   La Utilidad de Conversin de Archivos RCVT proporciona la facilidad
   de convertir diferentes tipos de archivos a un formato determinado.

   RCVT extrae los ficheros del archivo fuente y los comprime en un
   archivo nuevo, borrando el archivo fuente si el nuevo es correcto
   (verificado con exito).

   El fichero de configuracin RCVT.CFG contiene los tipos de compresores
   y opciones a usar. Los tipos de compresores se definen con llamadas
   al compresor para descomprimir, comprimir y verificar los correspon-
   dientes archivos.

   Esta utilidad ha sido especialmente diseada para convertir diferentes
   tipos de archivos a formato RAR para obtener un ratio de compresin
   mayor para sus datos. Sin embargo, tambien es posible reconfigurar
   RCVT para la conversin a otro formato de compresin, poniendo su
   definicin antes de la de los dems.


      1. El fichero de configuracin RCVT.CFG

   El fichero de configuracin RCVT.CFG es un fichero de texto que
   contiene las opciones y definiciones de formatos. RCVT.CFG debe estar
   en el mismo directorio que RCVT.EXE.

   Las lneas que empiezen con un punto y coma ';' son comentarios que
   sern ignorados por RCVT.EXE.


      1.1. Opciones

   OnError  NextArchive | Abort

   El valor de esta opcin determina si RCVT debe seguir con la conversin
   del siguiente archivo cuando se detecta un error en el archivo actual.
   Use 'Abort' en esta opcin si quiere que RCVT interrumpa el proceso
   cuando se produzca un error.


   RepackRatio <Porcentaje>


   Especifica el ratio mnimo aceptable despus de recomprimir.


   Add <fichero>

   Especifica el nombre del fichero que debe ser aadido a cada archivo
   convertido. Puede especificar la trayectoria completa. Se permiten
   multiples opciones "Add".


   Del <fichero>

   Especifica el/los fichero(s) que no sern permitidos en el archivo
   convertido. Se permiten comodines. Si no se especifica una trayectoria
   completa se asume el directorio raiz del archivo. Se permiten multiples
   opciones "Del".


   Scan <programa>

   Usted puede especificar un programa que procese los ficheros extrados
   antes de recomprimirlos, por ejemplo, una utilidad antivirus. Si esta
   utilidad devuelve un cdigo de salida (ERRORLEVEL) diferente de cero los
   ficheros no sern recomprimidos y el correspondiente mensaje de error
   ser registrado en el fichero de resultados RCVT.LOG. Se permiten
   multiples opciones "Scan".


   Filelist <fichero>

   Especifica el fichero donde se hallan listados los archivos fuente.
   El nombre del archivo fuente es reemplazado con el nuevo as como el
   tamao actual si es posible. Si no se especifica una trayectoria
   completa se buscar este fichero en el mismo directorio que el/los
   archivo(s) a procesar. Se permiten multiples opciones "Filelist"


      1.2. Definicin de compresores

   Cada compresor se define con 4 lneas.

   La primera lnea declara el tipo de archivo: la extensin del archivo
   y opcionalmente, la firma del compresor (la mscara genrica conteniendo
   hasta 32 bytes como nmeros exadecimales), por ejemplo:

    ; Formato RAR antiguo (antes de la versin 1.50)
    .RAR 52457E5E

   La firma del compresor es opcional, de forma que los archivos pueden
   ser distinguidos solamente por su extensin, por ejemplo:

    ; Formato ZIP
    .ZIP

   Las dems lneas definen las llamadas al compresor para comprimir,
   extraer y verificar el archivo:

    PACK <lnea de comandos>  para comprimir (crear el archivo)
    EXTR <lnea de comandos>  para extraer ficheros del archivo
    TEST <lnea de comandos>  para verificar los ficheros del archivo

   A continuacin sigue un ejemplo completo para la definicin del
   formato RAR:

    ; Definicin del formato principal: convertir a RAR
    .RAR
    PACK RAR a -s -std -c- -r -z$CMT$
    EXTR RAR x -std -c- -y -av-
    TEST RAR t -std -c-

   (Vea el manual de usuario de RAR para una descripcin completa de
   las ordenes y opciones de la lnea de comandos.)

   Al procesar archivos .RAR, .ARJ y .ZIP, el comentario del archivo
   fuente es guardado en un fichero temporal y ms tarde es aadido
   al nuevo fichero. Para especificar el comentario de archivo en la
   lnea de comandos use el macro '$CMT$'. RCVT lo substituye con el
   nombre del fichero temporal al convertir el archivo al nuevo formato.

   NOTA: las lneas de comandos para PACK y EXTR deben ser definidas
	 para comprimir/extraer con subdirectorios.

   La lnea de comandos para TEST es opcional. Se usa para verificar
   el nuevo archivo (verificando que los ficheros pueden ser extrados
   sin errores). En caso de que el programa devuelva un cdigo de retorno
   diferente de cero (ERRORLEVEL) el nuevo archivo es borrado, dejando
   el archivo fuente intacto, y el error es reportado en el fichero de
   resultados RCVT.LOG.

   Si no se especifica la lnea de comandos para TEST, entonces se asume
   que los nuevos archivos son correctos sin verificarlos. De todas
   formas, se recomienda que especifique la lnea TEST siempre que sea
   posible.

   NOTA: Los programas definidos en RCVT.CFG han de estar en el path
	 para que puedan ser llamados por RCVT.


      2. Uso

      Para ejecutar RCVT siga la siguiente sintaxis:

	RCVT [-opcin[-]] <archivo>

      Slo precisa especificar el nombre del archivo (se permiten
      comodines). Las opciones son:

	    -r[-]: convertir archivos en los subdirectorios
	    -n[+]: convertir archivos anidados
	    -k[+]: guardar fecha del archivo

      Ejemplos:

	Convertir todos los archivos del disco actual:
	RCVT -r *.*

	Convertir el archivo book.lzh:
	RCVT book.lzh

   La extraccin se realiza en un directorio temporal creado en el
   directorio actual. Luego, si se ha especificado la opcin SCAN,
   los ficheros son procesados. Los ficheros especificados en la opcin
   DEL no se incluirn en el nuevo archivo. Los ficheros incluidos en
   la opcin ADD sern aadidos al archivo final.

   Despues de que el nuevo archivo sea creado con exito (y verificado
   con la lnea de comandos TEST) el archivo original ser borrado.

   Los archivos anidados (archivos dentro del archivo) tambien sern
   recomprimidos mientras no se use la opcin '-n-'.

   Los comentarios de archivo son restaurados en el archivo final si
   el formato final admite la opcin de aadir el comentario "$CMT$".
   Las etiquetas de volumen y dems informaciones especificas son
   ignoradas y no se aaden al archivo final.

   Cuando el compresor devuelve un error, RCVT detiene el proceso si se
   especific la opcin 'OnError Abort', en caso contrario el proceso
   continua con el siguiente archivo. Los errores se registran en el
   fichero RCVT.LOG, localizado en el mismo directorio que RCVT.EXE.
