From d0971bb29eae055c0bd2f557a18a20ee24866528a0be42e82187cc325ab040f4 Mon Sep 17 00:00:00 2001 From: Gabriel Lorenzo Date: Sat, 7 Sep 2002 19:15:59 +0000 Subject: [PATCH] doc --- ediv/doc/html/compilador.dok | 146 +++++++++++++++++++--------------- ediv/doc/html/finalidad.dok | 142 +++++++++++++++++++++------------ ediv/src/visual c/ediv_ws.suo | Bin 16384 -> 16384 bytes 3 files changed, 175 insertions(+), 113 deletions(-) diff --git a/ediv/doc/html/compilador.dok b/ediv/doc/html/compilador.dok index 3332af8..83b5085 100644 --- a/ediv/doc/html/compilador.dok +++ b/ediv/doc/html/compilador.dok @@ -22,67 +22,74 @@ -h --help - Muestra ayuda sobre la sintaxis del programa y las opciones disponibles. - No se realiza ninguna otra operación. +
Muestra ayuda sobre la sintaxis del programa + y las opciones disponibles. No se realiza ninguna otra operación.
-d --debug - Permite utilizar el trazador durante la ejecución del programa. +
Permite utilizar el trazador durante la ejecución + del programa.
-l --list - Genera un archivo de texto aparte que contiene el listado del programa - en código intermedio (EML). +
Genera un archivo de texto aparte que contiene + el listado del programa en código intermedio (EML).
-t --table - Genera un archivo de texto aparte, con extensión .tab, que - contiene información avanzada para comprobar errores de compilación. +
Genera un archivo de texto aparte, con extensión + .tab, que contiene información avanzada para comprobar errores + de compilación.
-c --check - No genera un ejecutable. Se utiliza cuando sólamente se quiere - comprobar si un programa está escrito sin errores léxicos - ni de sintaxis. +
No genera un ejecutable. Se utiliza cuando + sólamente se quiere comprobar si un programa está + escrito sin errores léxicos ni de sintaxis.
-s --system - Permite especificar el Sistema Operativo para el cual se quiere - generar el ejecutable, en el caso de que se desee crear un ejecutable - para un sistema distinto del actual. +
Permite especificar el Sistema Operativo para + el cual se quiere generar el ejecutable, en el caso de que se desee + crear un ejecutable para un sistema distinto del actual.
-n --news - Obtiene de Internet información de última hora acerca - de eDIV. +
Obtiene de Internet información de última + hora acerca de eDIV.
-v --version - No realiza ninguna operación, salvo mostrar la versión - actual del compilador. +
No realiza ninguna operación, salvo + mostrar la versión actual del compilador.

-
  • archivo.prg: es el archivo fuente que se compilará.
    • -
  • ejecutable: es el nombre que se quiere que tenga el ejecutable - final. Si se omite, el ejecutable tendrá el mismo nombre que el archivo - fuente.
    • +
  • +
    archivo.prg: es el archivo fuente que se + compilará.
    +
    • +
  • +
    ejecutable: es el nombre que se quiere que + tenga el ejecutable final. Si se omite, el ejecutable tendrá el mismo + nombre que el archivo fuente.
    +
    • -

    Una vez ejecutado el programa con los parámetros adecuados, el compilador - nos irá mostrando el estado del proceso, y por último nos informará - si la compilación ha tenido éxito. Si ocurre algún error, - se mostrará un mensaje explicando el error. Si el error se encuentra - en el fichero fuente, se nos indicará el número de línea - y de carácter donde se localiza el error. Por ejemplo:

    +

    Una vez ejecutado el programa con los parámetros adecuados, + el compilador nos irá mostrando el estado del proceso, y por último + nos informará si la compilación ha tenido éxito. Si ocurre + algún error, se mostrará un mensaje explicando el error. Si el + error se encuentra en el fichero fuente, se nos indicará el número + de línea y de carácter donde se localiza el error. Por ejemplo:


    @@ -152,45 +159,56 @@
    +

    Es posible que, una vez corregido el error, al intentar compilar + de nuevo aparezca otro error. Hay que corregir todos los errores del programa + fuente para que eDIV sea capaz de compilarlo. También es posible que + se muestren mensajes de advertencia; si es así, eDIV compilará + el programa correctamente (siempre que no encuentre ningún error), aunque + es posible que desee corregir el listado para que no se muestren esos mensajes.

     

    Esquema de funcionamiento del compilador

    -

    No está de más tener una idea de las operaciones que hace el - compilador, especialmente por si surge algún problema, para saber de - dónde puede venir el fallo y cómo se puede arreglar.

    +

    No está de más tener una idea de las operaciones + que hace el compilador, especialmente por si surge algún problema, para + saber de dónde puede venir el fallo y cómo se puede arreglar.

    +
    +
      +
    1. Primero, eDIV lee la configuración del archivo ediv.cfg. + Dicho archivo es necesario, ya que contiene información acerca de + los ajustes por defecto del compilador y las prioridades de las librerías.
      2. +
    2. A continuación, el programa detecta el idioma del sistema (si no + se ha forzado uno en el archivo de configuración).
      3. +
    3. Luego se procesan los argumentos de la línea de comandos.
      4. +
    4. Después se carga el archivo fuente (.prg) en memoria + y se compone el nombre del ejecutable final.
      5. +
    5. Seguidamente se comprueba que existe el stub correspondiente + al Sistema Operativo elegido. El stub es un archivo con extensión + .rel o .dbg que contiene el primer segmento del + ejecutable final, al cual después se agregará el código + del programa compilado.
      6. +
    6. A continuación se llama a una rutina de preparación que + pone a cero los datos internos del compilador.
      7. +
    7. Después se cargan todas las librerías que se encuentran + en el directorio correspondiente.
      8. +
    8. Luego se realiza una primera compilación que tiene como único + objetivo saber qué elementos de las librerías se utilizan, + para poder descartar las librerías que no se usan en el programa.
      9. +
    9. Se vuelve a llamar a la rutina del paso 6, para restablecer todos los + parámetros del compilador.
      10. +
    10. De nuevo se cargan las librerías, pero esta vez sólamente + las que se utilizan.
      11. +
    11. Se compila de nuevo el programa. El resultado es un código intermedio + que ha reservado únicamente la memoria que necesita para las librerías + que el programa necesita específicamente. De esta forma hemos ahorrado + mucha memoria y espacio en el paquete final del programa compilado (ejecutable + + librerías), ya que hemos descartado todas las librerías + innecesarias.
      12. +
    12. Se crea el archivo del ejecutable con el contenido del stub. + Luego se agrega el código intermedio comprimido del programa. Y por + último, en el caso de que hayamos indicado el parámetro --debug, + añadimos información de depurado al ejecutable para permitir + que funcione el trazador.
      13. +
    +
      -
    1. Primero, eDIV lee la configuración del archivo ediv.cfg. - Dicho archivo es necesario, ya que contiene información acerca de los - ajustes por defecto del compilador y las prioridades de las librerías.
      2. -
    2. A continuación, el programa detecta el idioma del sistema (si no - se ha forzado uno en el archivo de configuración).
      3. -
    3. Luego se procesan los argumentos de la línea de comandos.
      4. -
    4. Después se carga el archivo fuente (.prg) en memoria - y se compone el nombre del ejecutable final.
      5. -
    5. Seguidamente se comprueba que existe el stub correspondiente al - Sistema Operativo elegido. El stub es un archivo con extensión - .rel o .dbg que contiene el primer segmento del - ejecutable final, al cual después se agregará el código - del programa compilado.
      6. -
    6. A continuación se llama a una rutina de preparación que pone - a cero los datos internos del compilador.
      7. -
    7. Después se cargan todas las librerías que se encuentran en - el directorio correspondiente.
      8. -
    8. Luego se realiza una primera compilación que tiene como único - objetivo saber qué elementos de las librerías se utilizan, para - poder descartar las librerías que no se usan en el programa.
      9. -
    9. Se vuelve a llamar a la rutina del paso 6, para restablecer todos los parámetros - del compilador.
      10. -
    10. De nuevo se cargan las librerías, pero esta vez sólamente - las que se utilizan.
      11. -
    11. Se compila de nuevo el programa. El resultado es un código intermedio - que ha reservado únicamente la memoria que necesita para las librerías - que el programa necesita específicamente. De esta forma hemos ahorrado - mucha memoria y espacio en el paquete final del programa compilado (ejecutable - + librerías), ya que hemos descartado todas las librerías innecesarias.
      12. -
    12. Se crea el archivo del ejecutable con el contenido del stub. Luego - se agrega el código intermedio comprimido del programa. Y por último, - en el caso de que hayamos indicado el parámetro --debug, añadimos - información de depurado al ejecutable para permitir que funcione el - trazador.
    <%end%> \ No newline at end of file diff --git a/ediv/doc/html/finalidad.dok b/ediv/doc/html/finalidad.dok index 0f77e81..1ecd03d 100644 --- a/ediv/doc/html/finalidad.dok +++ b/ediv/doc/html/finalidad.dok @@ -1,52 +1,96 @@ <%title%>Finalidad del proyecto<%/title%>

    Finalidad del proyecto

    -

    He aquí una lista de los objetivos que nos hemos impuesto para el desarrollo de eDIV según su avance por las distintas versiones:

    -

    +

    He aquí una lista de los objetivos que nos hemos impuesto + para el desarrollo de eDIV según su avance por las distintas versiones + (los marcados con un están + completados en la última versión):

    +

    +

    <%end%> \ No newline at end of file diff --git a/ediv/src/visual c/ediv_ws.suo b/ediv/src/visual c/ediv_ws.suo index 90251f4d980eb075599187dd9aa8963c3bd17e1fc8c80030f3201e22228644ce..8d82fcd0037f895dbb779be123b427f8c6899b65dc41462d15061bd6a0ad8df3 100644 GIT binary patch delta 583 zcmZo@U~Fh$+~C8)$UXTYivq8c(((4NLyXJ}K%lj`ip7hO=RXh#0=Xa>s77V;7uNGE zyo{1SA$}BLuJf$C3`{^FUL@hkUjzas9}zT|Tp}32!vmDyLXzD4MbIB;6em;&X2awX zu`82L2+*F`ICPNvJ`%jS-!~*mY+4@<|tz~hY@5b z5PX4c!w=LV0K_mqZ2qFXfQ|9r#=vaGO(y<~3QpEcozC}B5*5n?98hshI7eJ8K9T8FS! w8M}_n<<=}nj#I&*YPJn8qqr&#$^EvBjErfM58BmFzGSaAIl(+-vVgfB00(}i`Tzg`