Short:    IBrowse CleanCache (& some HBasic code)
Author:   ast_dde@yahoo.es (Dámaso D. Estévez)
Uploader: ast_dde@yahoo.es (Dámaso D. Estévez)
Type:     comm/www
Version:  1.2

 =======
 ESPAÑOL
 =======

 Esta  utilidad  genera  una  copia  limpia del caché de IBrowse en otro
 lugar;  dicha  copia  incluirá  los  ficheros  `Databases/GlobalCache',
 `Cookies'  y sólo los del caché que deban conservarse por no haber sido
 borrados   y  por  estar  correctamente  referenciados  en  el  fichero
 `GlobalCache'.   Si observa que la herramienta funciona adecuadamente y
 está  dispuesto  a  correr  el riesgo, puede escribir un sencillo guión
 AmigaDOS  que  invoque  a  IBcc,  borre  el caché original y finalmente
 mueva/copie  los  ficheros  de  la copia limpia generada por IBcc en el
 lugar donde debería estar el caché de IBrowse.

 Instalación
 ~~~~~~~~~~~
 Copie el ejecutable donde quiera (el directorio `C:' podría ser un buen
 lugar)  y  el(los)  catálogo(s)  que  desee  instalar  en su sistema en
 el(los)  directorio(s) `Locale:Catalogs/<idioma>'.  Ejecute por primera
 vez `IBcc' y modifique el fichero de preferencias que se habrá generado
 en  el  directorio  `ENV:'  con un editor como `Ed', para definir dónde
 está  localizado  el  caché  de IBrowse y dónde quiere generar la nueva
 copia  (finalmente  copie  dicho fichero en `ENVARC:' si quiere que los
 ajustes sean permanentes).

 Prestaciones principales
 ~~~~~~~~~~~~~~~~~~~~~~~~
   * Puede ser ejecutado desde el CLI (precedido o no por el comando RUN
     del  sistema  operativo)  o  el Workbench, pero sólo podrá hacer su
     trabajo si IBrowse no está ejecutándose.  Puede ser interrumpido su
     trabajo enviando una señal Ctrl+C a la tarea.
   * Argumentos: `?'  para  pedir  ayuda  sobre la sintaxis, `FULL' para
     obtener  una información algo más detallada y `QUIET' para suprimir
     todos los mensajes, salvo los de error y de advertencia.
   * Soporte local
     (el inglés como interno y el español a través de catálogo).

 Notas
 ~~~~~
   * Mi  agradecimiento  a  Marnix  por su primera y original version en
     AMOS  llamada  `CacheClean',  así  como por la información sobre el
     sistema de caché utilizado por IBrowse.
   * Creado con S.O. 3.9, A1200/060, Hisoft Basic 2 y Developper CD 2.1.
   * Mi llave pública la puede encontrar aquí:
              <http://www.arrakis.es/~amidde/txt/PGP.txt>
   * Paquete sin garantías.  El usuario asume el riesgo de su uso.

 Historia
 ~~~~~~~~
 Versión 1.1
   * Al  copiar  los ficheros `Cookies' y `GlobalCache' ahora se muestra
     el camino completo (origen).
   * La  rutina  de  copia  de ficheros ahora SI clona correctamente los
     bits  de protección y fecha/hora de creación y reserva una cantidad
     de  memoria  variable  según  el  fichero  a  copiar  y  la memoria
     disponible.

                          -------- === -------

 =======
 ENGLISH
 =======

 This  utility  generates  a  cleaned  IBrowse cache at another location
 selected   by   the   user;  this  new  copy  will  include  the  files
 `Databases/GlobalCache',  `Cookies' and ONLY the cache files referenced
 correctly  by  the  `GlobalCache' file (the files marked as deleted and
 other  files not referenced won't be copied).  You can write a AmigaDOS
 script  for to invoke IBcc, delete all original cache files and finally
 move/copy the clean cache copy to IBrowse cache location.

 Instalation
 ~~~~~~~~~~~
 Copy  the executable in a directory (`C:' would be a good election) and
 the   catalog(s)   selected  in  the  `Locale:Catalogs/<your_language>'
 dir(s).   Execute  `IBcc' and modify the prefs file generated in `ENV:'
 dir  with  an  editor as `Ed', for to define the original IBrowse cache
 location  and  the new (cleaned) copy location (finally copy this prefs
 file to `ENVARC:' if you want save the changes for all sesions).

 Main features
 ~~~~~~~~~~~~~
   * You can run this utility from the CLI (with or without RUN command)
     or the Workbench. You can break the execution with Ctrl+C signal.
   * Arguments: `?'  for  to obtain info about the template,, `FULL' for
     to  obtain  some more info about the IBcc's work and `QUIET' for to
     hide all messages except warnings and errors.
   * Locale support (english as internal and spanish catalog).

 Notes
 ~~~~~
   * Thanks  to  Marnix  for their first and original AMOS version named
     `CacheClean' and the info about the IBrowse cache system.
   * Created with OS 3.9, A1200/060, Hisoft Basic 2 & Developper CD 2.1.
   * My public keyfile is here:
              <http://www.arrakis.es/~amidde/txt/PGP.txt>
   * Software without warranties. Use under your risk!!!!

 History
 ~~~~~~~
 Version 1.1
   * Now,  when  the  `Cookies'  & `GlobalCache' are copied, the program
     shows the full path (source).
   * The  files  copy's routine now clones correctly the protection bits
     and  the  creation  date/time  and  allocate  a memory chunk with a
     variable size (memory available/file size).