Citorio version 1.0 release 1
Copyright (C) 1995 Javier Cmara Melgosa
  Email: tjc@sag.es
Basado en Pundit, (C) 1990 by Jeff Bienstadt

INTRODUCCION E INSTALACION
==========================

Qu es esto?
-------------
Citorio es un programa para Windows que cada cierto nmero de segundos
muestra una ventana con una cita, frase o gracia. Ver "Uso de Citorio" ms
adelante para ms detalles.

Es un programa de 16 bits que funciona en Windows 3.1, Windows 95 y
Windows NT 3.51.
Tambin hay una versin que muestra citas sueltas en MS-DOS.

Licencia
--------
Citorio es FREEWARE - Es todo gratis para t. Puedes usarlo y distriburlo sin
problemas de conciencia, por lo que a m respecta.

De todas formas, si te gusta y tienes correo electrnico, satisface mi ego
mandando un mensaje a tjc@sag.es.

Las citas contenidas en CITORIO.EXE pueden modificarse... en principio (ver
"Aadiendo citas").
El copyright no incluye ni las citas (que han sido saqueadas de mltiples
fuentes, incluyendo otros programas de citas), ni los iconos.

Ficheros includos
------------------

  LEEME.TXT     Este fichero
  CITORIO.EXE   Ejecutable de Citorio/Win
  CITORIOD.EXE  Citorio/DOS - saca una cita en MS-DOS
  README.TXT    Instrucciones para usuarios no hispanohablantes
  FILE_ID.DIZ   Descripcin corta para BBSs
  CITORIO.INI   Fichero de configuracin de ejemplo

Instalacin
-----------

Lo mnimo necesario para usar Citorio es CITORIO.EXE. Si adems deseas
usar Citorio/DOS, copiar CITORIOD.EXE al mismo directorio que
CITORIO.EXE.

Puedes mover CITORIO.INI al directorio de Windows, si quieres. De todas
formas todo lo que ah pone se puede seleccionar mediante el dilogo de
configuracin de Citorio. Tras ejecutar CITORIO, se crear un CITORIO.INI
con valores por omisin.

Ejecutar CITORIO.EXE, mediante el Administrador de Archivos o con la
opcin Archivo/Ejecutar del Administrador de Programas.
Si te gusta, lo normal es que lo pongas en el grupo de Inicio,
mediante la opcin Archivo/Nuevo/Elemento de Programa del
Administrador de Programas.

USO DE CITORIO
==============

Descripcin
-----------

Citorio es un programa que peridicamente muestra una ventana con una cita
o frase graciosa o similar en una ventana. Mientras tanto, permanece oculta.
Sus caractersticas son:

  - Lo ms importante: La ventana de Citorio NO CAMBIA LA APLICACIN
    ACTIVA - es una ventana "topmost". O sea, puedes estar p.ej.
    escribiendo; el que Citorio aparezca no te impedir seguir hacindolo. La
    nica molestia es cuando debajo de donde aparece Citorio hay algo
    donde quieras pinchar con el ratn o as.

  - Junto con el texto de la cita se muestra un icono. Las citas estn
    clasificadas por carcter (ver "Las Citas de Citorio", ms
    adelante); para cada clase aparece un icono distinto.

  - Puede seleccionarse uno de los sonidos de Windows que sonar con
    cada cita (ver "Configuracin")

  - Se puede seleccionar un font distinto para el texto de la cita y
    para el nombre del autor (ver "Configuracin")

  - La posicin y ancho de la ventana se guardan de forma que Citorio
    aparece siempre en el mismo sitio. El alto de la ventana se ajusta
    automticamente para que quepa la cita entera.

  - Citorio sabe cules son las ltimas 700 citas que ha mostrado, de
    forma que la siguiente vez no mostrar ninguna de esas 700. As
    evita el repetirse demasiado.

  - El tiempo que la cita permanece visible, y el lapso de tiempo entre citas,
    es configurable (en segundos).

  - Hay una versin para MS-DOS, CITORIOD.EXE, que lee las citas
    contenidas en el propio CITORIO.EXE y muestra una al azar.

Y adems, es gratis y las citas estn en espaol.

Historia
--------

Citorio es una mejora de un programa shareware llamado Pundit (C) 1990 by
Jeff Bienstadt. Nunca hubo ms que una versin 1.0 de Pundit, y ya no est
en cica.indiana.edu, que es donde yo lo encontr.
Yo considero que he mejorado el programa, tanto por dentro como por
fuera, de una forma en que Citorio ya no es Pundit.

Ejecucin
---------

Ejectalo desde el Administrador de Archivos (con un doble click), desde
la opcin Archivo/Ejecutar del Administrador de Programas o creando un
icono para l en el Administrador de Programas. Lo normal es instalarlo
en el grupo de Inicio.

Citorio admite un argumento opcional que es un nmero de cita. Eso fuerza a
que la siguiente cita que se muestre sea ese nmero.

Si se ejecuta a Citorio cuando ya es ejecutndose, se mostrar la
ventana de la instancia anterior. Si se ha pasado un nmero de cita como
argumento, se mostrar esa cita directamente.

Citorio no se mostrar si el salvapantallas estndar (.SCR) de 
Windows se est ejecutando, pero s si est maximizada una ventana MS-DOS 
(entonces no se ver, claro).

Configuracin
-------------

La opcin "Men/Configuracin" de Citorio muestra un dilogo que permite
especificar:

  - El tiempo en segundos que una cita permanecer visible;
  - El tiempo en segundos que Citorio permanecer oculto entre citas;
  - El sonido de Windows que sonar cuando aparezca una cita
    (slo puede ser un sonido estndar, no un .WAV cualquiera);
  - Si se muestran o no iconos junto al texto de la cita;
  - El font a usar para pintar el texto de la cita;
  - El font a usar para pintar el texto del autor de la cita.

Adems, Citorio almacena automticamente la posicin y ancho de su
ventana.

La configuracin de Citorio se almacena en el fichero CITORIO.INI en el
directorio de Windows. Aqu se almacena tambin la lista de las ltimas
citas mostradas.

Ocultando a Citorio
-------------------

Para que Citorio se oculte antes de tiempo, pulsa el botn de minimizar.
Ten en cuenta que si en vez de minimizarlo lo cierras, Citorio simplemente
terminar y no volver a mostrarse.

Finalizando Citorio
-------------------

Citorio permanece oculto. Si quieres cancelarlo, basta con ejecutarlo
otra vez - la nueva instancia har que la anterior muestre su ventana (slo
habr una instancia corriendo en un momento dado).
En esa ventana puedes seleccionar la opcin Men/Salir, pulsar Alt+F4 o Cerrar
en el men de sistema para acabar con Citorio.

Citorio/Dos
-----------

CITORIOD.EXE es un programita MS-DOS que lee las citas dentro de
CITORIO.EXE y muestra una, aleatoriamente. Ejecuta

  CITORIOD /?

Y saldr:

Uso: CITORIOD [/?] | [/b] | [/l [c]]
(C) 1995 JCM - 	FREEWARE - Gratis, pero todos los derechos reservados
tjc@sag.es

  Esto muestra una cita aleatoriamente de las contenidas en CITORIO.EXE.
  CITORIO.EXE es un programa para Windows que contiene las citas en forma
  de recursos STRINGTABLE. Debe estar en el mismo directorio que CITORIOD.EXE

  /b,/B: "Bonito" - Aspecto 3D (requiere ANSI.SYS o sustituto)
  /l,/L: Lista TODAS las citas. Una cita puede ocupar mas de una linea,
  	asi que 'c' es el caracter que aparecera como delimitador del final
  	de cita, al principio de una linea. Por omision, es '%'.
  	  Se incluyen las clasificaciones de las citas, como #<letra>, pero
  	los demas codigos de control se procesan.

La idea es ejecutar a CITORIOD desde el AUTOEXEC.BAT.
CITORIOD.EXE debe residir en el mismo directorio de CITORIO.EXE.

La opcin /l es por si alguien est interesado en exportar las citas de
Citorio para otro "fortune program" (programa de citas). Esa opcin vuelca
todas las citas por la salida estndar.

Las citas de Citorio
====================

Las citas han sido obtenidas de un nmero diverso de fuentes, incluyendo
otros programas de citas. No considero que eso sea una violacin de la
propiedad intelectual; no pueden pretender hacer valer su copyright sobre
citas ajenas, aunque la recopilacin la hayan hecho ellos.
La traduccin del ingls al espaol ha sido libre... :-)
Citorio tiene tan pocas citas, en comparacin con las que me he ledo,
porque slo he puesto las que me gustaban (criterio discutible, en cualquier
caso).

Las citas de Citorio se almacenan como recursos STRINGTABLE dentro del
propio CITORIO.EXE. Esto en realidad es peor que tenerlas en un fichero
de texto externo.

Las strings de citas van desde 1 a MAX_CITAS. MAX_CITAS es el mximo nmero
de string pero *no* es una constante: est almacenado en la string nmero
30000.
Esto es as para permitir aadir citas con un editor de recursos - ver
"Aadiendo Citas", ms adelante.

Formato de una cita
-------------------
El formato de una string de cita es:

<texto> [ "*DD" | "*EX" ] [ "#"<clase> ]

** Autor de la cita
Dentro de <texto>, la secuencia "|a"<autor> separa el nombre del autor
del texto de la cita. Pueden aparecer varios "|a"; <autor> se considera
finalizado cuando aparece un salto de lnea.

** Citas de mas de 256 caracteres
Los recursos string no pueden sobrepasar los 256 caracteres. Para admitir
citas ms largas que eso, Citorio usa varias strings; todas menos la
ltima acaban en el carcter '-'. Citorio las concatenar todas al
leer la cita.

** Sufijos *DD y *EX
Esos dos sufijos son firmas predefinidas para una cita, que se abrevian pues
aparecen mucho en el conjunto.

El sufijo *DD indica que la cita es del libro "El Diccionario del Diablo",
de Ambrose Bierce. Este libro es una encantadora coleccin de
definiciones corrosivas. "*DD" se expande como "|aAmbrose Bierce, 'El
Diccionario del Diablo'"

El sufijo *EX indica que la cita se ha sacado de la respuesta a un examen, y se
expande como "|aRespuesta a un examen". Adems, esas citas llevan
implicitas la clasificacion de "divertida" (ver siguiente punto)

** Clasificacion de las citas

Las citas se clasifican segn su carcter en:

  Normales (Sin marca de clase)
  Divertida   (D)
  Deprimente  (P)
  Animosa     (!)
  Romantica   (R)
  Maliciosa   (M)
  De sexo o descerebrada (X)
  De vagos    (V)
  Ley de Murphy   (Y)
  Dicha por el ordenador  (O)

Para clasificar una cita hay que finalizar el texto completo de la cita con
"#"<letra>, donde <letra> es la letra asociada a la clase (listadas arriba).
En Citorio/Win, a cada clase corresponde un icono determinado. Las citas
no clasificadas (normales) se muestran con un icono de entre un conjunto de 21
que van usndose de forma cclica.

En Citorio/Dos la clasificacin se ignora.

** Ejemplos de strings de citas

Cita divertida de "El Diccionario del Diablo":
  1 "Cleptmano: Ladrn rico.*DD#D"

Cita normal con autor:
  352 "El hombre prudente (...texto...) la difamacin|aFranklin"

Cita larga y romntica:
  358 """Cmo es estar enamorado?""\n""Bueno, (...texto...) mareado. -"
  359   "Al tiempo (... texto...) se marcha""|aHobbes#R"

  Citorio concatenar siempre las strings 358 y 359.

Aadiendo citas a Citorio
-------------------------

Se pueden aadir, aunque sera ms sencillo si estuviesen en un fichero
de texto externo.
Se requiere un programa editor de recursos de ejecutables, como el Borland
Resource Workshop o el equivalente de Microsoft, que no recuerdo como se llama.
Ahora, si no tienes un editor de recursos... tendrs que conformarte con las
citas estndar. Se siente.

Lo que hay que tener en cuenta es que, si cambia el nmero de citas, hay que
cambiar el valor de la string 30000 (STR_NUM_CITAS), que contiene precisamente
el nmero total de strings. Citorio genera nmeros aleatorios entre 1 y el
valor almacenado en dicha string.

PARA TERMINAR
=============

Espero que te guste Citorio.
Sea as o no, si conoces citas interesantes puedes mandrmelas por correo
electrnico a tjc@sag.es. Ya he saqueado todos los programas de citas de
Cica, Garbo y Simtel as que no te molestes en ellos.

No creo que se le pueda aadir mucha funcionalidad a Citorio. Ideas:

- Sacar las citas a fichero de texto externo
- Incluir citas que sean bitmaps completos, como recursos (ej. el chiste de un
  peridico)
- Incluir sonidos (interesante?)

Yo no tengo planeado aadirle nada, de todas formas. Si libero nuevas versiones,
ser porque le aada nuevas citas.
