=======================================================================


     //               ARestaure v2.03 - Documentación              //
   \X/                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~            \X/


          Traducción y adaptación de Dámaso Domínguez Estévez


        Este  manual describe la versión 2.03 del programa 'ARestaure'.
Esta  herramienta  es  ©1992 de Jehan-Yves PROUX y todo uso comercial o
venta  de  este  programa, sin autorización por escrito del autor, está
estrictamente prohibida.

        'ARestaure' puede ser copiado libremente y distribuído a través
de  cualquier  medio, a condición de que se trate del producto íntegro,
es decir, CON la documentación en TODAS las lenguas que se proporcionan
(por ahora francés, alemán e inglés) sin ningún cambio o modificación.

        A  pesar  de  las  numerosas  pruebas que he realizado, declino
cualquier  responsabilidad  sobre el empleo del programa.  Por ello, LA
UTILIZACION  DEL  PROGRAMA  ES  SIEMPRE  BAJO  SU PROPIO RIESGO:  no me
responsabilizo,  bajo  ninguna  circunstancia  ni  en  ningún  caso, de
cualquier  daño/efecto  directo  o indirecto, resultante del empleo del
programa 'ARestaure'.

        Este programa es 'ShareWare', así que si le gusta, lo encuentra
útil  o  lo emplea con frecuencia, le invito a enviarme una donación de
50  francos  franceses  a  la  dirección que se indica al final de este
documento,  gracias  a  lo  cual  se convertirá en usuario registrado y
recibirá una versión personalizada.  Los sistemas de pago admitidos son
los siguientes:

        - cheque de un banco europeo (en francos franceses),
        - en metálico (moneda europea o dólares USA).



Sumario:
~~~~~~~~

        1. Introducción
        2. ¿Cómo funciona?
        3. Empleo/Uso
           3.1 Modo de Recuperación
           3.2 Modo de Limpieza
        4. Lenguajes soportados
        5. Notas Adicionales
        6. Agradecimientos
        7. Historia
        8. Conclusión
        9. Sobre la traducción al español


1. Introducción
~~~~~~~~~~~~~~~

        ¿Ha  borrado  accidentalmente  un  fichero o se ha dado cuenta,
demasiado  tarde, que no ejecutó la instrucción "delete #?" en el cajón
correcto?

        ¿Si?   Yo  también...   Esta  razón me ha llevado a escribir el
programa  'ARestaure',  que  como  su  nombre  indica  (se pronuncia en
fraancés  algo así como 'ARestor'), le permitirá recuperar los ficheros
que ha destruído por descuido...  ¡terminando así las angustias y dudas
cada vez que pulsa <ENTER> después de un "delete XXX"!



2. ¿Como funciona?
~~~~~~~~~~~~~~~~~~

        Cuando  usted  borra  un fichero, se producen esencialmente dos
operaciones sobre el volumen en cuestión:

                -  su   fichero   es   desconectado  de  la  estructura
                        arborescente de ficheros del volumen.

                -  los sectores, que su fichero ocupaba, son declarados
                        como  libres en  el(los)  bloque(s) del mapa de
                        bits o bitmap del volumen (mapa que  indica qué
                        bloques   están   libres   y  cuales  no).   El
                        contenido  de  los  sectores  no  es  borrado o
                        "puesto  a cero" nunca con esta operación:  los
                        datos  permanecen  en  el  disco hasta que sean
                        utilizados  dichos  bloques libres  por otro(s)
                        fichero(s).

        'ARestaure'  explora  su  volumen  a  la  búsqueda  de ficheros
borrados y le permite recuperarlos.

        IMPORTANTE: Si  acaba  de  borrar  accidentalmente uno o varios
ficheros  o  cajones  y  desea recuperarlo(s), no escriba nada en dicho
volumen hasta después de haber empleado 'ARestaure'...  o quizás sea(n)
irrecuperable(s).



3. Empleo / Uso
~~~~~~~~~~~~~~~

        Para  arrancar  'ARestaure', pinche un par de veces rápidamente
sobre su icono en el WorkBench, o, teclee su nombre desde el Shell.

        'ARestaure'  buscará en su sistema todos las unidades que pueda
manejar y no mostrará más que éstas, así que tanto si posee particiones
Mac  como  Unix  o Atari, C=64, Sinclair QL, Apple-II o ¿porqué no, una
partición  MS-DOS?,  no  se  mostrarán  ésta(s) en pantalla.  De hecho,
'ARestaure'  sólo  puede tratar particiones o volúmenes Amiga:  OFS/SFS
(el  antiguo  sistema de ficheros) y FFS (el nuevo 'Sistema de Ficheros
Rápido'),  además  de  los  cuatro  nuevos  que  introduce  el  SO  3.0
(Internacional  -INTERNATIONAL FS- y Caché -DCFS-) que son sobre el 98%
de los discos que maneja normalmente nuetra estupenda máquina.

        Igualmente  notará  que 'ARestaure' no puede recuperar ficheros
borrados  de RAM:, pues esta unidad es simplemente memoria del sistema,
espacio  de  almacenamiento  que  se  libera a la vez que el fichero es
borrado:  por ello no se muestra.  Sin embargo, 'ARestaure' sí es capaz
de  recuperar  los  ficheros  borrados  de  RAD:   (tamaño/capacidad de
almacenamiento de la unidad fijo).


        Se encontrará en la pantalla con los siguientes botones:

        DF0: .. DF3:    un botón por unidad conectada (vacía o no)
        DH0: .. DHx:
        ..      ..
        ..      ..
        ..      ..
        ..      ..      y tantos botones como periféricos

        Français
        Deutsch         cambia el lenguaje actual de los mensajes
        English

        SauvCfg         o "SaveCfg" o "Speichern",
                        memoriza el lenguaje elegido (sólo si WB <2.1)

        Quitter         o "Quit" o "Ende",
                        para salir del programa 'ARestaure'.



        3.1. Modo de Recuperación
        ~~~~~~~~~~~~~~~~~~~~~~~~~

                Es   el   modo   por  defecto  del  programa,  y  puede
        comprobarlo  mirando  el menú Modo llamado "Mode" o "Modus", la
        opción "Restauration", "Restoration" o "Wiederherstellung".

                En  este  modo,  si  selecciona una unidad, el programa
        comienza  la  búsqueda  inmediata  en  dicha  unidad.   Un  LED
        parpadeante  sobre el botón de la unidad indica que el programa
        está realizando la búsqueda.

                Si  'ARestaure'  no  encuentra  ningún  fichero,  se lo
        señalará en la  caja de mensajes, sino  abrirá una  petición de
        ficheros estándar para que elija el o los ficheros a recuperar,
        seleccionando  usted  <Annuler>  /  <Cancel> /  <Abbruch>  para
        'Cancelar'   o   <Restaurer>  /  <Restore>  / <Spreichern> para
        'Recuperar' el(los)  fichero(s).   Terminada  la  operación  se
        volverá  a encontrar en el punto de partida, pudiendo abandonar
        el programa o recuperar datos de otra unidad.

                ¿Donde localizar los ficheros recuperados? Es imposible
        recolocarlos en su lugar inicial, previo al borrado, así que he
        decidido  que  sean  copiados  a T:, el directorio temporal que
        normalmente  está  asignado  a  la  RAM:   (mire  en su fichero
        's:startup-sequence').  Después basta con mover dichos ficheros
        a donde usted desee.

                NOTAS: Tenga  la  precaución  de  que  haya  suficiente
        espacio  en T:  para todos los ficheros a recuperar y de que no
        esté  asignado  a la misma unidad de la cual pretende recuperar
        los  ficheros  borrados.   Además  si varios ficheros tienen el
        mismo nombre, el programa los modificará añadiendo unos dígitos
        a  modo  de  contador  al  final  de  éste (del tipo ".03", por
        ejemplo).


        3.2 Modo de Limpieza
        ~~~~~~~~~~~~~~~~~~~~

                Después  de  varios usos del Modo de Recuperación (o si
        escribe  y  borra  muchos ficheros de la unidad), se encontrará
        con que 'ARestaure' le mostrará un buen lote de ficheros que no
        le  interesan  y dificultan la  localización  de  los sí son de
        interés, en  la  lista  mostrada   por  el  programa.   El gran
        acierto  del  Modo  de Limpieza es que  "pone a cero" todos los
        sectores  libres  de  manera  que  es  imposible  recuperar los
        ficheros.  Esto implica dos ventajas:

                - sólo podrá recuperar los ficheros borrados después de
                        esta operación.

                - si  otro usuario tiene acceso al disco, estará seguro
                        que  éste  sólo  podrá  acceder a los que usted
                        quiere (y no a los borrados y que dicho usuario
                        podría recuperar con la ayuda de 'ARestaure').

                Para emplear este modo,  active "Cleaning", "Nettoyage"
        o  "Reiningung"  en  el  menú  y  seleccione la unidad deseada.
        Después   de  una  petición  de  confirmación,  el  trabajo  se
        iniciará.  NOTA:  ¡el  disco  no puede  estar protegido  contra
        escritura!



4. Lenguajes soportados
~~~~~~~~~~~~~~~~~~~~~~~

        'ARestaure'  está  casi  listo para el sistema WB 2.1, que será
multilíngüe (según C= Amiga Autria en la revista alemana  de septiembre
del  92 'Amiga Magazin' [la revista alemana más conocida]:  'ARestaure'
soporta las tres lenguas con las que me desenvuelvo, o sea, francés (mi
lengua materna), alemán e inglés.

        Puede  elegir el lenguaje que desee desde la pantalla principal
del  programa.   Sin  embargo,  es imposible si la petición de ficheros
está  abierta:  no tengo necesidad de cambiar esto, pues supongo que un
usuario normal no va a cambiar continuamente de idioma.

        Para terminar con este tema, si desea traducir la documentación
de  cualquier programa creado por usted (sólo si es de DOMINIO PUBLICO)
del alemán o el inglés al francés, escríbame.

        P.S:   Igualmente busco a alguien que pueda corregir las faltas
que seguro contienen las versiones inglesa y alemana de este documento.



5. Notas Adicionales
~~~~~~~~~~~~~~~~~~~~

        Si  observa  con  detenimiento  la evolución del porcentaje del
disco  procesado  (aparece entre los botones de elección de lengua y el
de guardar la configuración), se dará cuenta de que la velocidad varía:
esto  es  debido a que el programa sólo lee (o escribe) en los sectores
libres.  La velocidad aumenta al procesar sectores ocupados.

        Puede  detener  el trabajo de recuperación o el de limpieza, en
cualquier momento, pulsando la tecla ESC.



6. Agradecimientos
~~~~~~~~~~~~~~~~~~

        Mi agradecimiento en  especial a las siguientes personas:

        - Muriel  PROUX,  mi esposa, por su paciencia  y su ayuda en la
                realización de la interface de usuario.

        - Denis  GOUNELLE,  por  sus  ideas  y  por las pruebas  que ha
                efectuado sobre mis versiones beta y previas.

        - Henric  GOMES, por haberme  hecho descubrir lo formidable que
                es el Amiga.

        - Commodore-Amiga  por  la  máquina...  lástima que  también se
                dedique a vender PCs.

        - Free Software Fundation por haber escrito el mejor editor que
                conozco (¡y además de Dominio Público!):  GNUEmacs, que
                empleo tanto profesionalmente bajo Unix como en casa en
                mi Amiga.

        - David GAY (Suiza)  por su conversión de GNUEmacs  para Amiga,
                ¡muy buen trabajo, David! ¡Continúa trabajando  para el
                Amiga!

        - Carsten  Lergenmüller,  Arthur  Isaak,  Bernd Hofmann,  Bernd
                Neudecker,   Dehnick  Wolf-Peter,  y  Tim  Rühsen  (los
                alemanes)  y Max Roemer, que han ayudado a escribir una
                documentación en alemán tan perfecta (!).



7. Historia
~~~~~~~~~~~

        v1.00   13-Oct-92
                o Primera versión distribuída.

        v1.XX   11-Nov-92
                o Versión previa de la v2.00,  distribución restringida
                  por validación.
                o Modo de Limpieza añadido
                o algunas E/S mejor verificadas
                o evolución del pourcentaje más fluída.
                o en Modo de Recuperación, si varios ficheros tienen el
                  mismo  nombre,  se añade ".XX" al final del nomre del
                  fichero.

        v2.00   28-Nov-92
                o la fecha de los ficheros es añadida en la petición de
                  ficheros de los ficheros borrados.
                o cambiado los bordesde los gadgets.

        v2.01   06-Dic-92
                o Ahora  empleo RemoveGList()  durante la búsqueda o la
                  limpieza,  para impedir al usuario la perturbación de
                  la visualización.
                o El usuario ahora puede  detener la operación pulsando
                  la tecla ESC (y no con un botón del ratón), ¡evitando
                  hacerlo  inadvertidamente  cuando  se está trabajando
                  sobre una partición de 60 Mb!

        v2.02   21-Feb-93
                o Corrección   debida  a  un  error  de  C=   [  :-)  ]
                  (DosEnvec->de_DosType  =  'DOS\0' bajo Kickstart2.04,
                  WB 2.1 en todos los discos incluso los formateados en
                  FFS).   Para  corregir este error, ahora leo la pista
                  de  arranque  de  todos los discos que son declarados
                  como OFS en DosEnvec, para comprobar si realmente son
                  OFS.
                o La  escritura  del  fichero  t:xx  que  antes  no era
                  verificada, ahora sí lo es.

        v2.03   21-May-93
                o Ahora  gestiona  los nuevas variantes  del sistema de
                  ficheros  del  SO  3.0  de  C=  (modo internacional y
                  caché).
                o Mejor gestión de los modos AA.
                o El botón  "SauvCfg"  /  "SaveCfg"  /  "Speichern"  se
                  desconecta  si  'ARestaure'  determina  la  lengua  a
                  emplear gracias a la biblioteca LOCALE.
                o Añado  una  ventana  para  indicar   al  usuario  que
                 'ARestaure'  es SHAREWARE (a 21-Mayo-1993, ¡aún no he
                  recibido ninguna contribución!).



8. Conclusión
~~~~~~~~~~~~~

        Espero  sus  sugerencias  y  comentarios  sobre  su  ¿correcto?
funcionamiento  (¡seguramente  algo se me habrá escapado!) e incluso su
donación si mi esfuerzo en desarrollar el programa le ha evitado perder
horas de trabajo.

        Puede escribirme en francés, en alemán o en inglés (en orden de
preferencia  decreciente:   el  francés  es  mi  lengua  natal)  a esta
dirección:

        Jehan-Yves PROUX
        46bis, Bd Robespierre
        F-78300 Poissy
        FRANCE - EUROPE

    Correo electrónico a través de Internet (E-Mail): jyp@ritd.co.uk


        ¡Hasta la próxima!



9. Traducción al castellano versión 1.1 (24-ABR-96)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 Autor de la traducción:

         Dámaso Domínguez Estévez
         Alonso Ojeda nº 7 - 1º
         36.207 Vigo (Pontevedra)
         SPAIN

  Queda  prohibida  la  modificación total o parcial de este documento,
sin   permiso  del  traductor  (salvo  por  el  propio  autor  original
Jehan-Yves  PROUX) y  NO ME HAGO RESPONSABLE DE LOS EFECTOS, DESEADOS O
NO,  DIRECTOS  O  INDIRECTOS,  QUE  PUEDA  OCASIONAR  EL EMPLEO DE ESTE
DOCUMENTO, que es de DISTRIBUCION LIBRE Y GRATUITA.

   ADVERTENCIA SOBRE EL PROGRAMA: El empleo la opción de limpieza puede
ser peligrosa en discos cuyo mapa de bits (mapa de bloques ocupados) no
sea   correcto,   pues  se  podrían  "limpiar"  bloques  cruciales  que
pertenezcan  a  ficheros  o  que  contengan  información vital sobre la
estructura del volumen... ¡y hablo con absoluto conocimiento de causa!

=======================================================================
