doc
This commit is contained in:
Gabriel Lorenzo
parent
c8def208a5
commit
d0971bb29e
|
|
@ -22,67 +22,74 @@
|
|||
<tr valign="top">
|
||||
<td>-h</td>
|
||||
<td>--help</td>
|
||||
<td>Muestra ayuda sobre la sintaxis del programa y las opciones disponibles.
|
||||
No se realiza ninguna otra operación.</td>
|
||||
<td><div align="justify">Muestra ayuda sobre la sintaxis del programa
|
||||
y las opciones disponibles. No se realiza ninguna otra operación.</div></td>
|
||||
</tr>
|
||||
<tr valign="top">
|
||||
<td>-d</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 valign="top">
|
||||
<td>-l</td>
|
||||
<td>--list</td>
|
||||
<td>Genera un archivo de texto aparte que contiene el listado del programa
|
||||
en código intermedio (EML).</td>
|
||||
<td><div align="justify">Genera un archivo de texto aparte que contiene
|
||||
el listado del programa en código intermedio (EML).</div></td>
|
||||
</tr>
|
||||
<tr valign="top">
|
||||
<td>-t</td>
|
||||
<td>--table</td>
|
||||
<td>Genera un archivo de texto aparte, con extensión .tab, que
|
||||
contiene información avanzada para comprobar errores de compilación.</td>
|
||||
<td><div align="justify">Genera un archivo de texto aparte, con extensión
|
||||
.tab, que contiene información avanzada para comprobar errores
|
||||
de compilación.</div></td>
|
||||
</tr>
|
||||
<tr valign="top">
|
||||
<td>-c</td>
|
||||
<td>--check</td>
|
||||
<td>No genera un ejecutable. Se utiliza cuando sólamente se quiere
|
||||
comprobar si un programa está escrito sin errores léxicos
|
||||
ni de sintaxis.</td>
|
||||
<td><div align="justify">No genera un ejecutable. Se utiliza cuando
|
||||
sólamente se quiere comprobar si un programa está
|
||||
escrito sin errores léxicos ni de sintaxis.</div></td>
|
||||
</tr>
|
||||
<tr valign="top">
|
||||
<td>-s</td>
|
||||
<td>--system</td>
|
||||
<td>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.</td>
|
||||
<td><div align="justify">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.</div></td>
|
||||
</tr>
|
||||
<tr valign="top">
|
||||
<td>-n</td>
|
||||
<td>--news</td>
|
||||
<td>Obtiene de Internet información de última hora acerca
|
||||
de eDIV.</td>
|
||||
<td><div align="justify">Obtiene de Internet información de última
|
||||
hora acerca de eDIV.</div></td>
|
||||
</tr>
|
||||
<tr valign="top">
|
||||
<td>-v</td>
|
||||
<td>--version</td>
|
||||
<td>No realiza ninguna operación, salvo mostrar la versión
|
||||
actual del compilador.</td>
|
||||
<td><div align="justify">No realiza ninguna operación, salvo
|
||||
mostrar la versión actual del compilador.</div></td>
|
||||
</tr>
|
||||
</table>
|
||||
<br>
|
||||
</div>
|
||||
</li>
|
||||
<li><code>archivo.prg</code>: es el archivo fuente que se compilará.</li>
|
||||
<li><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.</li>
|
||||
<li>
|
||||
<div align="justify"><code>archivo.prg</code>: es el archivo fuente que se
|
||||
compilará.</div>
|
||||
</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>
|
||||
<p>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:</p>
|
||||
<p align="justify">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:</p>
|
||||
<br>
|
||||
<table width="90%" border="0" align="center" cellpadding="0" cellspacing="0">
|
||||
<tr>
|
||||
|
|
@ -152,45 +159,56 @@
|
|||
</table></td>
|
||||
</tr>
|
||||
</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>
|
||||
<h2>Esquema de funcionamiento del compilador</h2>
|
||||
<p>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.</p>
|
||||
<p align="justify">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.</p>
|
||||
<div align="justify">
|
||||
<ol>
|
||||
<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
|
||||
ajustes por defecto del compilador y las prioridades de las librerías.</li>
|
||||
Dicho archivo es necesario, ya que contiene información acerca de
|
||||
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
|
||||
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>Después se carga el archivo fuente (<code>.prg</code>) en memoria
|
||||
y se compone el nombre del ejecutable final.</li>
|
||||
<li>Seguidamente se comprueba que existe el <em>stub</em> correspondiente al
|
||||
Sistema Operativo elegido. El <em>stub</em> es un archivo con extensión
|
||||
<li>Seguidamente se comprueba que existe el <em>stub</em> correspondiente
|
||||
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
|
||||
ejecutable final, al cual después se agregará el código
|
||||
del programa compilado.</li>
|
||||
<li>A continuación se llama a una rutina de preparación que pone
|
||||
a cero los datos internos del compilador.</li>
|
||||
<li>Después se cargan todas las librerías que se encuentran en
|
||||
el directorio correspondiente.</li>
|
||||
<li>A continuación se llama a una rutina de preparación que
|
||||
pone a cero los datos internos del compilador.</li>
|
||||
<li>Después se cargan todas las librerías que se encuentran
|
||||
en el directorio correspondiente.</li>
|
||||
<li>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.</li>
|
||||
<li>Se vuelve a llamar a la rutina del paso 6, para restablecer todos los parámetros
|
||||
del compilador.</li>
|
||||
objetivo saber qué elementos de las librerías se utilizan,
|
||||
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 del compilador.</li>
|
||||
<li>De nuevo se cargan las librerías, pero esta vez sólamente
|
||||
las que se utilizan.</li>
|
||||
<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 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.</li>
|
||||
<li>Se crea el archivo del ejecutable con el contenido del <em>stub</em>. 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. </li>
|
||||
+ librerías), ya que hemos descartado todas las librerías
|
||||
innecesarias.</li>
|
||||
<li>Se crea el archivo del ejecutable con el contenido del <em>stub</em>.
|
||||
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. </li>
|
||||
</ol>
|
||||
</div>
|
||||
<ol>
|
||||
</ol>
|
||||
<%end%>
|
||||
|
|
@ -1,52 +1,96 @@
|
|||
<%title%>Finalidad del proyecto<%/title%>
|
||||
<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"><ul><li><h2>Versión 0.1</h2>
|
||||
<ul><li>Capacidad completa de compilar programas creados para DIV2 generando su correspondiente código EML (excepto las funciones predefinidas)</li>
|
||||
<li>Generación de archivos ejecutables a partir de un stub (*.rel o *.dbg), con información de depurado o sin ella</li>
|
||||
<li>Ejecución de programas sin optimizar, gestión de procesos, ejecución de funciones en las DLL</li>
|
||||
<li>SDK</li>
|
||||
<li>Soporte de algunas funcionalidades básicas (sprites y algunas funciones)</li>
|
||||
</ul><li><h2>Versión 0.2</h2>
|
||||
<ul><li>Trazador de programas</li>
|
||||
<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
|
||||
(los marcados con un <img src="img/tick.gif" width="16" height="16" align="absmiddle"> están
|
||||
completados en la última versión):</p>
|
||||
<p align="justify">
|
||||
<ul>
|
||||
<li>
|
||||
<h2>Versión 0.1</h2>
|
||||
<ul>
|
||||
<li>Capacidad completa de compilar programas creados para DIV2 generando
|
||||
su correspondiente código EML (excepto las funciones predefinidas)
|
||||
<img src="img/tick.gif" width="16" height="16" align="absmiddle"> </li>
|
||||
<li>Generación de archivos ejecutables a partir de un stub (*.rel
|
||||
o *.dbg), con información de depurado o sin ella <img src="img/tick.gif" width="16" height="16" align="absmiddle"></li>
|
||||
<li>Ejecución de programas sin optimizar, gestión de procesos,
|
||||
ejecución de funciones en las DLL <img src="img/tick.gif" width="16" height="16" align="absmiddle"></li>
|
||||
<li>SDK <img src="img/tick.gif" width="16" height="16" align="absmiddle"></li>
|
||||
<li>Soporte de algunas funcionalidades básicas (sprites y algunas
|
||||
funciones)</li>
|
||||
</ul>
|
||||
<li>
|
||||
<h2>Versión 0.2</h2>
|
||||
<ul>
|
||||
<li>Trazador de programas</li>
|
||||
<li>Soporte completo para gráficos 2D</li>
|
||||
<li>Ejecución de programas optimizados</li>
|
||||
<li>Soporte completo de datos de tipo STRING, BYTE y WORD</li>
|
||||
<li>Arreglo de bugs que existiesen en el compilador de DIV2</li>
|
||||
</ul><li><h2>Versión 0.3</h2>
|
||||
<ul><li>IDE que como mínimo pueda editar programas y llamar al compilador</li>
|
||||
<li>Ejecución <i>perfecta</i> de cualquier programa que no use scroll, modo-7, modo-8, búsqueda de caminos ni red</li>
|
||||
</ul>
|
||||
<li>
|
||||
<h2>Versión 0.3</h2>
|
||||
<ul>
|
||||
<li>IDE que como mínimo pueda editar programas y llamar al compilador</li>
|
||||
<li>Ejecución <i>perfecta</i> de cualquier programa que no use scroll,
|
||||
modo-7, modo-8, búsqueda de caminos ni red</li>
|
||||
<li>Trazador completo</li>
|
||||
<li>Soporte para DLLs embebidas en el ejecutable</li>
|
||||
</ul><li><h2>Versión 0.4</h2>
|
||||
<ul><li>IDE que pueda administrar proyectos, programas, MAPs, FPGs, FNTs, WAVs, etc (no necesariamente poder editarlos)</li>
|
||||
</ul>
|
||||
<li>
|
||||
<h2>Versión 0.4</h2>
|
||||
<ul>
|
||||
<li>IDE que pueda administrar proyectos, programas, MAPs, FPGs, FNTs, WAVs,
|
||||
etc (no necesariamente poder editarlos)</li>
|
||||
<li>Soporte de scroll y búsqueda de caminos</li>
|
||||
<li>Mejoras del trazador</li>
|
||||
<li>Soporte para <i>packfiles</i></li>
|
||||
<li>Soporte de ficheros de música (MOD, S3M, XM)</li>
|
||||
</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>
|
||||
</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>
|
||||
</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>
|
||||
</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>
|
||||
</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>
|
||||
</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>
|
||||
</ul>
|
||||
<li>
|
||||
<h2>Versión 1.0</h2>
|
||||
<ul>
|
||||
<li>Soporte completo de modo-9</li>
|
||||
</ul>
|
||||
</ul>
|
||||
<%end%>
|
||||
Binary file not shown.
Loading…
Reference in a new issue