doc
This commit is contained in:
Gabriel Lorenzo
parent
c8def208a5
commit
d0971bb29e
|
|
@ -22,67 +22,74 @@
|
||||||
<tr valign="top">
|
<tr valign="top">
|
||||||
<td>-h</td>
|
<td>-h</td>
|
||||||
<td>--help</td>
|
<td>--help</td>
|
||||||
<td>Muestra ayuda sobre la sintaxis del programa y las opciones disponibles.
|
<td><div align="justify">Muestra ayuda sobre la sintaxis del programa
|
||||||
No se realiza ninguna otra operación.</td>
|
y las opciones disponibles. No se realiza ninguna otra operación.</div></td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr valign="top">
|
<tr valign="top">
|
||||||
<td>-d</td>
|
<td>-d</td>
|
||||||
<td>--debug</td>
|
<td>--debug</td>
|
||||||
<td>Permite utilizar el trazador durante la ejecución del programa.</td>
|
<td><div align="justify">Permite utilizar el trazador durante la ejecución
|
||||||
|
del programa.</div></td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr valign="top">
|
<tr valign="top">
|
||||||
<td>-l</td>
|
<td>-l</td>
|
||||||
<td>--list</td>
|
<td>--list</td>
|
||||||
<td>Genera un archivo de texto aparte que contiene el listado del programa
|
<td><div align="justify">Genera un archivo de texto aparte que contiene
|
||||||
en código intermedio (EML).</td>
|
el listado del programa en código intermedio (EML).</div></td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr valign="top">
|
<tr valign="top">
|
||||||
<td>-t</td>
|
<td>-t</td>
|
||||||
<td>--table</td>
|
<td>--table</td>
|
||||||
<td>Genera un archivo de texto aparte, con extensión .tab, que
|
<td><div align="justify">Genera un archivo de texto aparte, con extensión
|
||||||
contiene información avanzada para comprobar errores de compilación.</td>
|
.tab, que contiene información avanzada para comprobar errores
|
||||||
|
de compilación.</div></td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr valign="top">
|
<tr valign="top">
|
||||||
<td>-c</td>
|
<td>-c</td>
|
||||||
<td>--check</td>
|
<td>--check</td>
|
||||||
<td>No genera un ejecutable. Se utiliza cuando sólamente se quiere
|
<td><div align="justify">No genera un ejecutable. Se utiliza cuando
|
||||||
comprobar si un programa está escrito sin errores léxicos
|
sólamente se quiere comprobar si un programa está
|
||||||
ni de sintaxis.</td>
|
escrito sin errores léxicos ni de sintaxis.</div></td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr valign="top">
|
<tr valign="top">
|
||||||
<td>-s</td>
|
<td>-s</td>
|
||||||
<td>--system</td>
|
<td>--system</td>
|
||||||
<td>Permite especificar el Sistema Operativo para el cual se quiere
|
<td><div align="justify">Permite especificar el Sistema Operativo para
|
||||||
generar el ejecutable, en el caso de que se desee crear un ejecutable
|
el cual se quiere generar el ejecutable, en el caso de que se desee
|
||||||
para un sistema distinto del actual.</td>
|
crear un ejecutable para un sistema distinto del actual.</div></td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr valign="top">
|
<tr valign="top">
|
||||||
<td>-n</td>
|
<td>-n</td>
|
||||||
<td>--news</td>
|
<td>--news</td>
|
||||||
<td>Obtiene de Internet información de última hora acerca
|
<td><div align="justify">Obtiene de Internet información de última
|
||||||
de eDIV.</td>
|
hora acerca de eDIV.</div></td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr valign="top">
|
<tr valign="top">
|
||||||
<td>-v</td>
|
<td>-v</td>
|
||||||
<td>--version</td>
|
<td>--version</td>
|
||||||
<td>No realiza ninguna operación, salvo mostrar la versión
|
<td><div align="justify">No realiza ninguna operación, salvo
|
||||||
actual del compilador.</td>
|
mostrar la versión actual del compilador.</div></td>
|
||||||
</tr>
|
</tr>
|
||||||
</table>
|
</table>
|
||||||
<br>
|
<br>
|
||||||
</div>
|
</div>
|
||||||
</li>
|
</li>
|
||||||
<li><code>archivo.prg</code>: es el archivo fuente que se compilará.</li>
|
<li>
|
||||||
<li><code>ejecutable</code>: es el nombre que se quiere que tenga el ejecutable
|
<div align="justify"><code>archivo.prg</code>: es el archivo fuente que se
|
||||||
final. Si se omite, el ejecutable tendrá el mismo nombre que el archivo
|
compilará.</div>
|
||||||
fuente.</li>
|
</li>
|
||||||
|
<li>
|
||||||
|
<div align="justify"><code>ejecutable</code>: es el nombre que se quiere que
|
||||||
|
tenga el ejecutable final. Si se omite, el ejecutable tendrá el mismo
|
||||||
|
nombre que el archivo fuente.</div>
|
||||||
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
<p>Una vez ejecutado el programa con los parámetros adecuados, el compilador
|
<p align="justify">Una vez ejecutado el programa con los parámetros adecuados,
|
||||||
nos irá mostrando el estado del proceso, y por último nos informará
|
el compilador nos irá mostrando el estado del proceso, y por último
|
||||||
si la compilación ha tenido éxito. Si ocurre algún error,
|
nos informará si la compilación ha tenido éxito. Si ocurre
|
||||||
se mostrará un mensaje explicando el error. Si el error se encuentra
|
algún error, se mostrará un mensaje explicando el error. Si el
|
||||||
en el fichero fuente, se nos indicará el número de línea
|
error se encuentra en el fichero fuente, se nos indicará el número
|
||||||
y de carácter donde se localiza el error. Por ejemplo:</p>
|
de línea y de carácter donde se localiza el error. Por ejemplo:</p>
|
||||||
<br>
|
<br>
|
||||||
<table width="90%" border="0" align="center" cellpadding="0" cellspacing="0">
|
<table width="90%" border="0" align="center" cellpadding="0" cellspacing="0">
|
||||||
<tr>
|
<tr>
|
||||||
|
|
@ -152,45 +159,56 @@
|
||||||
</table></td>
|
</table></td>
|
||||||
</tr>
|
</tr>
|
||||||
</table>
|
</table>
|
||||||
|
<p align="justify">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.</p>
|
||||||
<p> </p>
|
<p> </p>
|
||||||
<h2>Esquema de funcionamiento del compilador</h2>
|
<h2>Esquema de funcionamiento del compilador</h2>
|
||||||
<p>No está de más tener una idea de las operaciones que hace el
|
<p align="justify">No está de más tener una idea de las operaciones
|
||||||
compilador, especialmente por si surge algún problema, para saber de
|
que hace el compilador, especialmente por si surge algún problema, para
|
||||||
dónde puede venir el fallo y cómo se puede arreglar.</p>
|
saber de dónde puede venir el fallo y cómo se puede arreglar.</p>
|
||||||
<ol>
|
<div align="justify">
|
||||||
|
<ol>
|
||||||
<li>Primero, eDIV lee la configuración del archivo <code>ediv.cfg</code>.
|
<li>Primero, eDIV lee la configuración del archivo <code>ediv.cfg</code>.
|
||||||
Dicho archivo es necesario, ya que contiene información acerca de los
|
Dicho archivo es necesario, ya que contiene información acerca de
|
||||||
ajustes por defecto del compilador y las prioridades de las librerías.</li>
|
los ajustes por defecto del compilador y las prioridades de las librerías.</li>
|
||||||
<li>A continuación, el programa detecta el idioma del sistema (si no
|
<li>A continuación, el programa detecta el idioma del sistema (si no
|
||||||
se ha forzado uno en el archivo de configuración).</li>
|
se ha forzado uno en el archivo de configuración).</li>
|
||||||
<li>Luego se procesan los argumentos de la línea de comandos.</li>
|
<li>Luego se procesan los argumentos de la línea de comandos.</li>
|
||||||
<li>Después se carga el archivo fuente (<code>.prg</code>) en memoria
|
<li>Después se carga el archivo fuente (<code>.prg</code>) en memoria
|
||||||
y se compone el nombre del ejecutable final.</li>
|
y se compone el nombre del ejecutable final.</li>
|
||||||
<li>Seguidamente se comprueba que existe el <em>stub</em> correspondiente al
|
<li>Seguidamente se comprueba que existe el <em>stub</em> correspondiente
|
||||||
Sistema Operativo elegido. El <em>stub</em> es un archivo con extensión
|
al Sistema Operativo elegido. El <em>stub</em> es un archivo con extensión
|
||||||
<code>.rel</code> o <code>.dbg</code> que contiene el primer segmento del
|
<code>.rel</code> o <code>.dbg</code> que contiene el primer segmento del
|
||||||
ejecutable final, al cual después se agregará el código
|
ejecutable final, al cual después se agregará el código
|
||||||
del programa compilado.</li>
|
del programa compilado.</li>
|
||||||
<li>A continuación se llama a una rutina de preparación que pone
|
<li>A continuación se llama a una rutina de preparación que
|
||||||
a cero los datos internos del compilador.</li>
|
pone a cero los datos internos del compilador.</li>
|
||||||
<li>Después se cargan todas las librerías que se encuentran en
|
<li>Después se cargan todas las librerías que se encuentran
|
||||||
el directorio correspondiente.</li>
|
en el directorio correspondiente.</li>
|
||||||
<li>Luego se realiza una primera compilación que tiene como único
|
<li>Luego se realiza una primera compilación que tiene como único
|
||||||
objetivo saber qué elementos de las librerías se utilizan, para
|
objetivo saber qué elementos de las librerías se utilizan,
|
||||||
poder descartar las librerías que no se usan en el programa.</li>
|
para poder descartar las librerías que no se usan en el programa.</li>
|
||||||
<li>Se vuelve a llamar a la rutina del paso 6, para restablecer todos los parámetros
|
<li>Se vuelve a llamar a la rutina del paso 6, para restablecer todos los
|
||||||
del compilador.</li>
|
parámetros del compilador.</li>
|
||||||
<li>De nuevo se cargan las librerías, pero esta vez sólamente
|
<li>De nuevo se cargan las librerías, pero esta vez sólamente
|
||||||
las que se utilizan.</li>
|
las que se utilizan.</li>
|
||||||
<li>Se compila de nuevo el programa. El resultado es un código intermedio
|
<li>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 ha reservado únicamente la memoria que necesita para las librerías
|
||||||
que el programa necesita específicamente. De esta forma hemos ahorrado
|
que el programa necesita específicamente. De esta forma hemos ahorrado
|
||||||
mucha memoria y espacio en el paquete final del programa compilado (ejecutable
|
mucha memoria y espacio en el paquete final del programa compilado (ejecutable
|
||||||
+ librerías), ya que hemos descartado todas las librerías innecesarias.</li>
|
+ librerías), ya que hemos descartado todas las librerías
|
||||||
<li>Se crea el archivo del ejecutable con el contenido del <em>stub</em>. Luego
|
innecesarias.</li>
|
||||||
se agrega el código intermedio comprimido del programa. Y por último,
|
<li>Se crea el archivo del ejecutable con el contenido del <em>stub</em>.
|
||||||
en el caso de que hayamos indicado el parámetro --debug, añadimos
|
Luego se agrega el código intermedio comprimido del programa. Y por
|
||||||
información de depurado al ejecutable para permitir que funcione el
|
último, en el caso de que hayamos indicado el parámetro --debug,
|
||||||
trazador. </li>
|
añadimos información de depurado al ejecutable para permitir
|
||||||
|
que funcione el trazador. </li>
|
||||||
|
</ol>
|
||||||
|
</div>
|
||||||
|
<ol>
|
||||||
</ol>
|
</ol>
|
||||||
<%end%>
|
<%end%>
|
||||||
|
|
@ -1,52 +1,96 @@
|
||||||
<%title%>Finalidad del proyecto<%/title%>
|
<%title%>Finalidad del proyecto<%/title%>
|
||||||
<p align="left"><h1>Finalidad del proyecto</h1></p>
|
<p align="left"><h1>Finalidad del proyecto</h1></p>
|
||||||
<p align="justify">He aquí una lista de los objetivos que nos hemos impuesto para el desarrollo de eDIV según su avance por las distintas versiones:</p>
|
<p align="justify">He aquí una lista de los objetivos que nos hemos impuesto
|
||||||
<p align="justify"><ul><li><h2>Versión 0.1</h2>
|
para el desarrollo de eDIV según su avance por las distintas versiones
|
||||||
<ul><li>Capacidad completa de compilar programas creados para DIV2 generando su correspondiente código EML (excepto las funciones predefinidas)</li>
|
(los marcados con un <img src="img/tick.gif" width="16" height="16" align="absmiddle"> están
|
||||||
<li>Generación de archivos ejecutables a partir de un stub (*.rel o *.dbg), con información de depurado o sin ella</li>
|
completados en la última versión):</p>
|
||||||
<li>Ejecución de programas sin optimizar, gestión de procesos, ejecución de funciones en las DLL</li>
|
<p align="justify">
|
||||||
<li>SDK</li>
|
<ul>
|
||||||
<li>Soporte de algunas funcionalidades básicas (sprites y algunas funciones)</li>
|
<li>
|
||||||
</ul><li><h2>Versión 0.2</h2>
|
<h2>Versión 0.1</h2>
|
||||||
<ul><li>Trazador de programas</li>
|
<ul>
|
||||||
<li>Soporte completo para gráficos 2D</li>
|
<li>Capacidad completa de compilar programas creados para DIV2 generando
|
||||||
<li>Ejecución de programas optimizados</li>
|
su correspondiente código EML (excepto las funciones predefinidas)
|
||||||
<li>Soporte completo de datos de tipo STRING, BYTE y WORD</li>
|
<img src="img/tick.gif" width="16" height="16" align="absmiddle"> </li>
|
||||||
<li>Arreglo de bugs que existiesen en el compilador de DIV2</li>
|
<li>Generación de archivos ejecutables a partir de un stub (*.rel
|
||||||
</ul><li><h2>Versión 0.3</h2>
|
o *.dbg), con información de depurado o sin ella <img src="img/tick.gif" width="16" height="16" align="absmiddle"></li>
|
||||||
<ul><li>IDE que como mínimo pueda editar programas y llamar al compilador</li>
|
<li>Ejecución de programas sin optimizar, gestión de procesos,
|
||||||
<li>Ejecución <i>perfecta</i> de cualquier programa que no use scroll, modo-7, modo-8, búsqueda de caminos ni red</li>
|
ejecución de funciones en las DLL <img src="img/tick.gif" width="16" height="16" align="absmiddle"></li>
|
||||||
<li>Trazador completo</li>
|
<li>SDK <img src="img/tick.gif" width="16" height="16" align="absmiddle"></li>
|
||||||
<li>Soporte para DLLs embebidas en el ejecutable</li>
|
<li>Soporte de algunas funcionalidades básicas (sprites y algunas
|
||||||
</ul><li><h2>Versión 0.4</h2>
|
funciones)</li>
|
||||||
<ul><li>IDE que pueda administrar proyectos, programas, MAPs, FPGs, FNTs, WAVs, etc (no necesariamente poder editarlos)</li>
|
</ul>
|
||||||
<li>Soporte de scroll y búsqueda de caminos</li>
|
<li>
|
||||||
<li>Mejoras del trazador</li>
|
<h2>Versión 0.2</h2>
|
||||||
<li>Soporte para <i>packfiles</i></li>
|
<ul>
|
||||||
<li>Soporte de ficheros de música (MOD, S3M, XM)</li>
|
<li>Trazador de programas</li>
|
||||||
</ul><li><h2>Versión 0.5</h2>
|
<li>Soporte completo para gráficos 2D</li>
|
||||||
<ul><li>IDE que pueda editar algunos tipos de archivo (como MAP, FPG, FNT), al menos de forma sencilla, y que sea capaz de modificar el <code>ediv.cfg</code>.</li>
|
<li>Ejecución de programas optimizados</li>
|
||||||
<li>Soporte de modos 7 y 8</li>
|
<li>Soporte completo de datos de tipo STRING, BYTE y WORD</li>
|
||||||
<li>Soporte de juego en red</li>
|
<li>Arreglo de bugs que existiesen en el compilador de DIV2</li>
|
||||||
<li>Compatibilidad al 100% con cualquier programa hecho para DIV2</li>
|
</ul>
|
||||||
</ul><li><h2>Versión 0.6</h2>
|
<li>
|
||||||
<ul><li>IDE con un editor gráfico decente</li>
|
<h2>Versión 0.3</h2>
|
||||||
<li>Implementación de mejoras en el lenguaje</li>
|
<ul>
|
||||||
<li>Implementación de nuevas funciones</li>
|
<li>IDE que como mínimo pueda editar programas y llamar al compilador</li>
|
||||||
<li>Soporte completo de gráficos de 16 y 24 bits</li>
|
<li>Ejecución <i>perfecta</i> de cualquier programa que no use scroll,
|
||||||
<li>Soporte para OGG, MP3, IT</li>
|
modo-7, modo-8, búsqueda de caminos ni red</li>
|
||||||
</ul><li><h2>Versión 0.7</h2>
|
<li>Trazador completo</li>
|
||||||
<ul><li>IDE con capacidad completa para editar MAPs, FPGs, FNTs, PALs, y con capacidad de modificación básica de WAVs y WLDs</li>
|
<li>Soporte para DLLs embebidas en el ejecutable</li>
|
||||||
<li>Más funciones nuevas</li>
|
</ul>
|
||||||
<li>Soporte de canal Alpha (gráficos de 32 bits)</li>
|
<li>
|
||||||
</ul><li><h2>Versión 0.8</h2>
|
<h2>Versión 0.4</h2>
|
||||||
<ul><li>IDE con capacidad completa para editar WAVs y WLDs</li>
|
<ul>
|
||||||
<li>Soporte de modo-6</li>
|
<li>IDE que pueda administrar proyectos, programas, MAPs, FPGs, FNTs, WAVs,
|
||||||
<li>Capacidad para renderizar los modos 7 y 8 usando OpenGL</li>
|
etc (no necesariamente poder editarlos)</li>
|
||||||
</ul><li><h2>Versión 0.9</h2>
|
<li>Soporte de scroll y búsqueda de caminos</li>
|
||||||
<ul><li>IDE completo</li>
|
<li>Mejoras del trazador</li>
|
||||||
<li>Soporte de sprites 3D (modo 6 y 9 con ctype=c_screen)</li>
|
<li>Soporte para <i>packfiles</i></li>
|
||||||
</ul><li><h2>Versión 1.0</h2>
|
<li>Soporte de ficheros de música (MOD, S3M, XM)</li>
|
||||||
<ul><li>Soporte completo de modo-9</li>
|
</ul>
|
||||||
</ul></ul>
|
<li>
|
||||||
|
<h2>Versión 0.5</h2>
|
||||||
|
<ul>
|
||||||
|
<li>IDE que pueda editar algunos tipos de archivo (como MAP, FPG, FNT),
|
||||||
|
al menos de forma sencilla, y que sea capaz de modificar el <code>ediv.cfg</code>.</li>
|
||||||
|
<li>Soporte de modos 7 y 8</li>
|
||||||
|
<li>Soporte de juego en red</li>
|
||||||
|
<li>Compatibilidad al 100% con cualquier programa hecho para DIV2</li>
|
||||||
|
</ul>
|
||||||
|
<li>
|
||||||
|
<h2>Versión 0.6</h2>
|
||||||
|
<ul>
|
||||||
|
<li>IDE con un editor gráfico decente</li>
|
||||||
|
<li>Implementación de mejoras en el lenguaje</li>
|
||||||
|
<li>Implementación de nuevas funciones</li>
|
||||||
|
<li>Soporte completo de gráficos de 16 y 24 bits</li>
|
||||||
|
<li>Soporte para OGG, MP3, IT</li>
|
||||||
|
</ul>
|
||||||
|
<li>
|
||||||
|
<h2>Versión 0.7</h2>
|
||||||
|
<ul>
|
||||||
|
<li>IDE con capacidad completa para editar MAPs, FPGs, FNTs, PALs, y con
|
||||||
|
capacidad de modificación básica de WAVs y WLDs</li>
|
||||||
|
<li>Más funciones nuevas</li>
|
||||||
|
<li>Soporte de canal Alpha (gráficos de 32 bits)</li>
|
||||||
|
</ul>
|
||||||
|
<li>
|
||||||
|
<h2>Versión 0.8</h2>
|
||||||
|
<ul>
|
||||||
|
<li>IDE con capacidad completa para editar WAVs y WLDs</li>
|
||||||
|
<li>Soporte de modo-6</li>
|
||||||
|
<li>Capacidad para renderizar los modos 7 y 8 usando OpenGL</li>
|
||||||
|
</ul>
|
||||||
|
<li>
|
||||||
|
<h2>Versión 0.9</h2>
|
||||||
|
<ul>
|
||||||
|
<li>IDE completo</li>
|
||||||
|
<li>Soporte de sprites 3D (modo 6 y 9 con ctype=c_screen)</li>
|
||||||
|
</ul>
|
||||||
|
<li>
|
||||||
|
<h2>Versión 1.0</h2>
|
||||||
|
<ul>
|
||||||
|
<li>Soporte completo de modo-9</li>
|
||||||
|
</ul>
|
||||||
|
</ul>
|
||||||
<%end%>
|
<%end%>
|
||||||
Binary file not shown.
Loading…
Reference in a new issue