repasa — Permite repasar definiciones eventualmente clasificadas y organizadas dentro de una secuencia empleando una interfaz texto
repasa [opciones] arch-sec|arch-cla|arch-def [ ...]
Este programa permite repasar definiciones. Puede cuestionar sobre definiciones bien con preguntas abiertas o bien con preguntas de selección múltiple.
En la línea de comandos puede recibir información sobre las definiciones disponibles para preguntar en:
De cada archivo de definiciones leerá todas las definiciones, suponiendo
que no están clasificadas ni en secuencia alguna; estas definiciones no
tendrán peso.
De cada archivo de clasificaciones leerá todas las definiciones referenciadas
junto con el peso de las que tengan.
De cada archivo de secuencia permitirá escoger la(s) secuencia(s) por repasar
(a menos que se especifique todas con la opción -todas),
y tendrá en cuenta las definiciones referenciadas en las clasificaciones
referenciadas en la(s) secuencia(s) escogida(s).
Además del peso, de las pistas, de las palabras de despiste, de
la heurística de respuesta y de la historia de progreso, cada definición
leída tendrá asociada la(s) secuencia(s) que
la referencia(n) y la(s) clasificación(es) que la referencia(n).
Información que puede ser mostrada o no de acuerdo a las opciones elegidas
(e.g -prescla, -prescla-no,
-prehist, etc).
Las preguntas que se hacen durante una sesión se determinan:
De acuerdo a la cantidad máxima
de preguntas especificada con la opción -maxpreg
(por defecto
10).valor
De acuerdo al valor de política, calculado empleando una política de estudio. Se preguntan los que mayor valor de política tengan.
El orden de formulación es aleatorio.
La política de estudio es una función
que a partir de información sobre cada definición (peso e historia de progreso)
calcula el valor de política (i.e un número flotante). Hay varias políticas
de estudio predefinidas (elegibles con opciones de la forma
pol_ desde la línea de
comandos). También es posible especificar su propia política de estudio
como una función en lenguaje idprom escrita un archivo,
archivo que se especifica con la opción pol_prom (ver
sección sobre política de estudio).
En las preguntas abiertas puede emplearse una heurística para
determinar si la respuesta dada por quien repasa es correcta. En el momento
de este escrito la única heurística implementada es "indist" que
no hace distinción entre mayúsculas y minúsculas.
En las preguntas de selección múltiple el número de opciones por
defecto es 4. Puede cambiarse con la opción -nummultiple
, las opciones se sacarán
aleatoriamente de las palabras de despiste que haya para la definición
y de ser necesario de otras palabras leídas. Por defecto se hacen
preguntas abiertas o de selección múltiple de forma aleatoria, puede
especificarse hacer sólo un tipo de pregunta con las opciones
valorforma_abierta o forma_multiple.
Si la respuesta a una pregunta es errada, de acuerdo a las opciones, podría
mostrarse a quien repasa la secuencia en la que aparece la definición
(opciones -pressec-no o -presec),
una pista si hay una para la definición (-prespista
o -prespista-no) y eventualmente repetir la pregunta
(-repetir o -repetir-no).
Al final de la sesión, el progreso de quien repasa (i.e cantidad de veces que
se formula cada pregunta y número de respuestas correctas)
es almacenado en un archivo
de progreso que por defecto es ~/.repasa y que
puede cambiarse con la opción
-prd (ver
prd(5)).
También al final de la sesión se envía un correo a una cuenta configurada
(opción archivocorreo o a 'structio-info@lists.sourceforge.net') con las sugerencias que quien repasa haya
hecho a las preguntas que contesta erradamente.
Las opciones son las siguientes:
-ayudaPresenta ayuda corta y opciones
-DEstablece otro directorio en el cual buscar archivos con más precedencia
-manPresenta página del manual
-refentryPresenta página del manual en formato DocBook
-VVersión de este programa
-cEstablece nombre del archivo de clasificaciones por defecto (si se omite se usa el mismo nombre del archivo de secuencia pero con extensión .cla)
-dEstablece nombre del archivo de definiciones por defecto (si se omite se usa el mismo nombre del archivo especificado pero con extensión .def)
-forma-abiertaForma de pregunta: abierta
-forma-aleatoriaForma de pregunta: aleatoria
-forma-multipleForma de pregunta: selección múltiple
-forma-ahorcadoForma de pregunta: ahorcado
-correoEstablece correo al cual enviar sugerencias sobre preguntas o respuestas (por defecto structio-info@lists.sourceforge.net)
-nummultipleEstablece cantidad máxima de opciones en una pregunta de selección múltiple (por defecto 4)
-maxpregEstablece cantidad máxima de preguntas (por defecto 10)
-todaspregIndica que todas las definiciones disponibles deben preguntarse
-prdEstablece nombre del archivo de progreso por defecto
-pol-aleatoriaEl valor de política es aleatorio
-pol-autoresCómo política usa valores predeterminados para cada definición
-pol-igualUsa política en la que todas las preguntas tienen igual valor
-pol-progresoUsa una política que tiene en cuenta su progreso
-pol-promUsa como valor de política el computado por un programa en lenguaje prom , e.g -pol-prom "mifun.prom"
-presclaPresenta clasificaciones
-prescla-noNo presenta clasificaciones (por defecto)
-preshistPresenta historial de progreso
-preshist-noNo presenta historial de progreso (por defecto)
-prespesoPresenta pesos
-prespeso-noNo presenta pesos (por defecto)
-prespistaPresenta pistas (por defecto)
-prespista-noNo presenta pistas
-prespolPresenta valor de pregunta con política de estudio (por defecto)
-prespol-noNo presenta valor de pregunta con política de estudio
-pressecPresenta secuencias (por defecto)
-pressec-noNo presenta secuencias
-repetirRepite pregunta en caso de falla (por defecto)
-repetir-noNo repite pregunta en caso de falla
-tiempoIndica que no se podrá elegir secuencia por estudiar, se escogerán todas
-todasIndica que no se podrá elegir secuencia por estudiar, se escogerán todas
La función en lenguaje prom que escriba recibirá
las siguientes variables con valores relacionados con una sola definición:
bienArreglo de flotantes con el número de veces
que se respondió correctamente la definición en las fechas
del arreglo dia.
diaArreglo de flotantes con las fechas en las que la palabra fue contestada. Ordenada, las fechas más antiguas primero. Cada fecha es el número de días desde el 1/Ene/1970.
ejecutorCadena constante "repasa"
hoyFecha de hoy contada en días desde el 1/Ene/1970 y convertida a flotante.
maxpesoPeso máximo de todas las palabras.
pesoEntero con peso de la palabra de acuerdo a la clasificación
preguntadaArreglo de flotantes con la cantidad de veces
que la pregunta se formuló en las fechas del arreglo
dia.
Es recomendable que comience su función asegurando que está siendo usada en el contexto correcto:
assert(ejecutor=="repasa");
Puede emplear todas las construcciones del lenguaje (intprom(1)) para retornar un flotante con el valor de política. Entre mayor sea el valor retornado más posibilidad tendrá la definición de ser preguntada en la sesión. Por ejemplo para tener en cuenta sólo el peso de la palabra:
assert(ejecutor=="repasa"); return peso;