sigchq — Chequea un archivo XML para sigue
.
sigchq [opciones
] arch
[arch ...
]
Recibe uno o más archivos XML para
sigue
(DTDs prcla.dtd
,
individuo.dtd
, grupo.dtd
,
rep.dtd
o planest.dtd
) y
chequea su sintaxis y convenciones.
Las opciones son las siguientes:
-ayuda
Presenta ayuda corta y opciones
-D
Establece otro directorio en el cual buscar archivos con más precedencia
-man
Presenta página del manual
-refentry
Presenta página del manual en formato DocBook
-V
Versión de este programa
-f
Establece formato de descripciones: texto
, tex
o docbook
-l
Establece longitud máxima de descripciones. e.g -l 80
-c
Establece nombre del archivo de clasificaciones por defecto (si se omite se usa el mismo nombre del archivo de secuencia/progreso pero con extensión .cla)
-p
Indica predicado que debe cumplir el periodo. El predicado debe ser de la forma p=dato o p!=dato o p<dato o p<=dato o p>dato o p>=dato donde cada dato puede ser un flotante, un entero o una cadena (entre apostrofes), pueden usarse paréntesis y los operadores !p, p1 && p2 y p1 || p2. Del predicado se debe deducir un tipo único para p e.g -p "p='p/2006-1' || p='p/2006-2'". Algunos chequeos requieren buscar datos en rangos de periodos, en esos casos se emplea el orden usual del tipo p (lexicográfico en el caso de cadenas)
-cron
Especifica archivo con cronograma y tipo de periodos. Extrae periodos válidos del archivo especificado, de las secuencias con el tipo especificado. Separar archivo de tipo con ':'. e.g -cron "cron.sec:Periodo"
-g
Establece predicado para valoraciones de acuerdo al tipo de clasificación. Es de la forma t_1:p_1;t_2:p_2...t_n:p_n donde t_i es un tipo de clasificación referenciada (o vacío y si aplica a valoraciones fuera de clasificación), p_i es un predicado para ese tipo en la variable 'g' ---sintaxis análoga a la de la opción -p--- e.g -g ":(g='D' || g='I') ; Indicador:(g='E' || g='B' || g='I')" Para especificar valoraciones posibles en ejercicio emplee el tipo `ejercicio´.
-n
No usar archivo de clasificaciones por defecto
-b
Indica que no deben reportarse errores cuando falten datos al chequear individuos
-datos
Indica datos mínimos que cada persona debe tener y opcionalmente el formato. Separar un tipo de otro con ';' y si se desea especificar formato, escribirlo a continuación del tipo separado con ':'. El formato debe ser de la forma d=dato o d!=dato o d<dato o d<=dato o d>dato o d>=dato donde cada dato puede ser un flotante, un entero o una cadena (entre apostrofes), pueden usarse paréntesis y los operadores !p, p1 & & p2 y p1 || p2. Del predicado se debe deducir un tipo único para d e.g -datos "Nombre:d<>'';Tipo de documento:d='TI' || d='CC'"
-cursos
En un plan de estudios, establece orden de cursos. Separar un identificador de otro con ';' e.g -cursos "Nivel;Grado"
-asignaturas
En un plan de estudios, establece orden de asignaturas. Separar un identificador de otro con ';' e.g -asignaturas "Área;Asignatura"
Las convenciones precisas que cada formato debe seguir están en la documentación de cada formato (ver al final de está documentación)
Los errores son reportados por stderr
. Al
completar la revisión si encuentra algún error retornará 1 al sistema
operativo (en caso de éxito retorna 0).
El formato de los errores reportados es estándar:
archivo
:linea
:columna
mensaje_error
y puede ser empleado por varios editores de texto (e.g vi o emacs) para ubicar automáticamente la posición del error.