Versión preliminar 0.1.1
|
Índice
|
Características principales - Qué es MedPro y qué sabe hacer.
Parámetros en línea de comando - Cómo ejecutar MedPro.
Fichero de Configuración - Opciones en el fichero mve.ini.
Herramientas externas
mpScript - El lenguaje de programación (script) de MedPro.
Novedades - Histórico de nuevas opciones/modificaciones.
Miscelánea - Rarezas no documentadas en ninguna otra parte.
| Características Principales |
[En preparación].MedPro es un editor de textos de propósito general, aunque diseñado especialmente para programación. Esta documentación no pretende explicar para qué sirve y para qué no sirve un editor de textos, así que sólo se entrará en detalle en lo que realmente sea interesante o diferente.
MedPro es la evolución de otro programa, Med, cuyo nombre deriva de 'MultiEditor', desarrollado por mí desde 1991 a 1994 y que he usado para construir todo mi software (incluso sirvió para construirse a sí mismo, una vez que funcionaron las opciones básicas, y para hacer el MedPro). El sufijo Pro viene de profesional, sea lo que fuere eso. La diferencia básica entre uno y otro es que MedPro utiliza un gestor de memoria supuestamente ingenioso que permite abrir ficheros más grandes que la memoria convencional disponible, sin usar 32 bits.
[Hablar de las posibilidades: hipertexto, tags, ayudas, syntax hilight, lenguaje de scripting, wordwrap, indentación automática, iso-8859-1, compilación de proyectos]
| Parámetros en línea de comando |
Sintaxis
mp [-t tag] [-h hipertexto] [-iso|-noiso] [texto(s)...] [-s cadena] [-x fichero]OpcionesEl/los parámetros texto(s)... son los ficheros de texto que se desea editar. Si se especifican los caracteres * ó ? en dichos nombres, se mostrarán en una lista de selección los nombres de fichero que coincidan.
- -t tag
- Abre el fichero de código fuente que contenga el símbolo tag. Ver ctags.
- -h hipertexto[#página]
- Abre un fichero de hipertexto para su consulta y, opcionalmente, la página inicial, separada del nombre del fichero mediante el carácter #.
- -iso
-noiso- Utiliza (o no) la codificación de caracteres ISO-8859-1 en lugar del juego de caracteres propio del PC. Estos argumentos prevalecen sobre lo definido en el fichero de configuración.
- -s cadena
- Busca la cadena en el último fichero abierto y posiciona el cursor sobre ella. Sólo debe usarse después de un nombre de fichero.
- -x fichero
- Abre fichero para edición en modo hexadecimal.
| Fichero de Configuración |
Los comandos de configuración se escriben en ficheros de texto llamados mve.ini. Al iniciar MedPro, los comandos de configuración se intentan leer de un posible fichero de configuración existente en el directorio actual; de no encontrarse ahí, se buscarán en un fichero de configuración residente en el mismo directorio que el fichero ejecutable de MedPro. De esta forma, es posible tener un fichero de configuración genérico en el directorio del ejecutable y tener otros en cada directorio con sólo los comandos de configuración que difieran de lo definido en el principal.Estos ficheros tienen la estructura típica de los ficheros .ini, es decir, ficheros de texto con áreas definidas por un nombre entre corchetes y cada comando en la forma comando=valor. A continuación se detallan las áreas y los comandos disponibles:
[General]
- FontSize=[16, 14 ú 8]
- Define el tamaño del font de pantalla. Puede ser 16, 14 ú 8, según se quiera una visualización de 25, 28 ó 50 líneas.
- Mouse=[1 ó 0]
- Activa/desactiva el uso del ratón.
- NeedBlinkFix=[1 ó 0]
- Obliga al programa a no utilizar códigos de color con brillo para el fondo, en caso de que éstos se muestren erróneamente como caracteres con parpadeo. Tanto en los modos de vídeo VESA como en la visualización con 50 líneas (comando FontSize=8), este comando se activa automáticamente. Si se usa, los colores en pantalla aparecerán más apagados.
- LockScreen=segundos
- Número de segundos para el protector de pantalla. Si es 0, no hay protector de pantalla.
- Zoom=[1 ó 0]
- Si es 1, hace que todas las ventanas se abran por defecto a pantalla completa.
- Mode=modo de vídeo
Lins=número de líneas
Cols=número de columnas- [En preparación]. Modos VESA soportados: 0x108 (80x60), 0x109 (132x25), 0x10a (132x43), 0x10b (132x50) y 0x10c (132x60).
[MultiEditor]
- XMS=memoria en kilobytes
- Determina el máximo de memoria XMS a usar. Si se define como -1 (por defecto), se usará el máximo existente. Puede ser necesario usarlo si se invoca algún comando de compilación (mediante ^F9), ya que la memoria utilizada por el editor se mostrará como ocupada para el comando ejecutado.
- ISO-8859-1=[1 ó 0]
- Activa/desactiva el uso del juego de caracteres ISO-8859-1.
- WordWrap=columna
- Define la columna donde se hará wordwrapping. Si es 0, se desactiva.
- SaveTabs=[1 ó 0]
- Activa/desactiva la grabación de tabuladores en los textos.
- AutoIndent=[1 ó 0]
- Activa/desactiva la indentación automática.
- Win95LongFileNames=[1 ó 0]
- Activa/desactiva la capacidad para crear ficheros de texto con nombres largos desde Windows 9x. Debe tenerse en cuenta que esto no influye en la apertura de ficheros con nombre largo, que siempre es posible.
- TabSize=número
- Define el número de espacios en cada posición de tabulación.
- Keywords=fichero
LocalKeywords=fichero- Define los ficheros de definición de keywords (para el syntax hilight de lenguajes de programación). La diferencia entre ambos es que LocalKeywords lee por defecto el fichero keywords.ini y Keywords no. Esto permite tener un fichero por defecto en el mve.ini principal (mediante Keywords) que contenga los keywords genéricos del lenguaje de programación (como keyc.ini, que contiene los del lenguaje C) y otro local para cada directorio (mediante LocalKeywords), con definición de colores para las funciones de cada proyecto en particular.
- LastFile=fichero
- Último fichero leído.
[HyperHelpPath]
- Index=hipertexto
1=hipertexto
2=hipertexto
...
- Define las trayectorias de búsqueda de ayuda. El comando Index apunta al hipertexto que aparecerá al pulsar Alt-I o invocar el menú Ayuda/Indice (por defecto es index.htm). Los sucesivos comandos 1, 2, etc. son los hipertextos donde se buscará secuencialmente el término sobre el que se necesita la ayuda, invocada mediante la pulsación de la tecla F1 en cualquier lugar del texto o el menú Ayuda/Ayuda sobre....
| Herramientas externas |
ctags - Generador de tags.
Sintaxisctags [-m | -k] fuente(s)...
ctags explora los ficheros de código fuente enviados como argumento y crea una entrada en el fichero ctags.ini del directorio actual por cada función o procedimiento que encuentre. Esta información puede ser utilizada por el editor MedPro para acceder directamente a símbolos de un programa sin conocer el nombre del fichero en que están ubicados.
Opciones
Las opciones -m y -k son excluyentes.
- -m
- Crea, además de ctags.ini, un fichero llamado ctags.mvh, que contiene las mismas funciones en formato .mvh de ayuda en línea. Se utiliza para crear documentaciones.
- -k
- Crea, además de ctags.ini, un fichero llamado keywords.ini, que contiene las mismas funciones en formato de definiciones de 'syntax hilight' para MedPro, para usar mediante el comando de configuración LocalKeywords.
ctags determina el tipo de código fuente por la extensión del fichero, siendo .c y .h lenguaje C, .pas Pascal y .prg Clipper ó XBase.
kis - Información del sistema.
Muestra información diversa sobre el ordenador en el que se ejecuta. Equivale en MedPro a la opción de menú Ayuda/Sistema. Ejecutar kis para ver las opciones de que dispone.
| Miscelánea |
Errores, cosas que funcionan mal o de forma incompleta.
- Las opciones Copiar a/Pegar de Windows siempre envían basura de más.
- Imprimir funciona fatal desde la versión 2.0 beta, en algunos casos hasta bloquea el ordenador. Probablemente es una incompatiblidad con Windows 95.
- Algo raro pasa con las ayudas, que a veces no dan los mensajes de error correctamente.
- La implementación de los hipertextos en HTML es bastante incompleta (no acepta tablas, ni frames, ni por supuesto nada referente a gráficos).
- En la lectura de hipertextos .info de GNU falta implementar las referencias indirectas y las tablas de tags.
- Se debería poder buscar en páginas hipertexto y en la ventana de edición hexadecimal.
- En la ventana de edición hexadecimal los cambios modificados se hacen en el mismo momento, sin posibilidad de vuelta atrás.
Otras cosas.
- Si desde el menú principal se pulsa - (guión), se activa el protector de pantalla.
- Los hipertextos HTML pueden contener el token <x_mp_eop> como delimitador de subpáginas dentro de una misma página (que es algo que debía tener el HTML y no tiene).
- Si un archivo tiene la extensión .htm ó .html, se muestran resaltados los tokens entre '<' y '>' de forma automática.
- Los archivos makefile se graban siempre con tabuladores, ignorando lo definido en los switches de configuración.
| Novedades |
Últimas características implementadas.30/04/1999
- En la ventana de edición hexadecimal: en modo ASCII, ya se avanza el cursor de forma coherente (es decir, carácter a carácter); se puede buscar con la opción Varios/Buscar... (en hexadecimal o ASCII según el modo de edición) y la opción Varios/Ir a... permite saltar directamente hasta un offset.
- La opción de imprimir imprime sólo el texto seleccionado, si es que lo hay (si no, imprime el texto completo).