calendar és un altre dels molts petits programes que es poden trobar als sistemes UNIX que fan una cosa senzilla, que la fan bé, i que es poden ajuntar amb altres petits programes per a realitzar tasques útils per a l'usuari. La tradicional i efectiva filosofia UNIX, ni més ni menys.
N'hi ha prou amb crear el fitxer calendar a la carpeta .calendar i afegir-hi línies amb les dates que ens interessin amb el format data <tabulació> descripció de la data. Finalment, si afegeixo calendar al fitxer .bashrc sempre que obri una finestra de terminal em revisarà el calendari.
Una altre forma d'utilitzar aquest petit programa podria ser invocant-lo des d'una aplicació que fem servir de forma habitual, potser una macro d'OpenOffice.org/LibreOffice o des d'un menú de llançament d'aplicacions fet amb zenity.
El que ve a continuació és la traducció lliure de la pàgina del manual de calendar.
Us:
calendar [-ab] [-A num] [-B num] [-l num] [-w num] [-f fitxer_de_calendari] [-t [[[cc]aa][mm]]dd]
Descripció:
Aquesta utilitat busca al directori actual, o al directori especificat a la variable d'entorn CALENDAR_DIR, un fitxer amb el nom calendar i mostra les línies que comencen amb la data d'avui i demà. Els divendres es mostren els events de tot el cap de setmana.
Les opcions són:
-A num Mostra els propers esdeveniments d'avui i dels propers num dies. Per defecte és un dia.
-a Processa els fitxers “calendar” de tots els usuaris i els envia un corru amb els resultats a cadascun d'ells. requereix privilegis de súper-usuari.
-B num Mostra els fets esdevinguts entre d'avui i els passats num dies.
-b Força mode de càlcul especial de dates per als calendaris KOI8.
-l num Mostra els propers esdeveniments d'avui i dels propers num dies. Per defecte és un dia.
-w num Mostra els propers esdeveniments d'avui i dels propers dos dies, però només si avui és divendres. És dir, mostra els esdeveniments del cap de setmana.
-f fitxer_de_calendari fa servir fitxer_de_calendari en comptes del fitxer per defecte calendar.
-t [[[cc]aa][mm]]dd fa servir la data especificada per cc, centúria; aa, any; mm, mes; dd, dia; en comptes de la data d'avui.
Les línies poden començar amb mes i dia. Si estan ben definides les característiques locals del sistema es poden fer servir els noms dels mesos i els dies de la setmana.
Un asterisc ('*') vol dir cada mes.
Un dia sense mes vol dir aquell dia cada setmana
Un mes sense dia vol dir el primer dia d'aquell mes.
Dos números volen dir mes i dia.
les línies que comencen amb un caràcter de tabulació es refereixen a l'última data entrada, permetent d'aquesta forma línies d'especificacions múltiples per a una data
Els dies de la setmana poden anar seguits de “-4” ... “+5” (àlies last, first, second, third, fourth) per esdeveniments amb data variable del tipus “el darrer dilluns d'abril”.
El diumenge de pasqua és 'Easter' en anglès. Es pot posar un àlies fent Easter=àlies i fer servir l'àlies
Per conveni, les dates seguides d'un asterisc (‘*’) no són fixes, és dir, canvien d'any en any.
Les descripcions del dia inicien després del primer caràcter de tabulació de la línia. Si una línia no té caràcter de tabulació, no es mostra. Si el primer caràcter d'una línia és una tabulació aleshores es tracta de la continuació de la descripció prèvia.
El calendari és preprocessa amb el preprocessador de C, cpp, permetent la inclusió de fitxers compartits com poden ser, per exemple, les vacances de l'empresa, el calendari de reunions, o l'agenda de cursos.
Si el fitxer compartit no es referencia per una ubicació absoluta aleshores es mira primer al directori actual (o home) i després a /etc/calendar, i finalment a /usr/share/calendar.
Les línies buides o protegides amb comentaris amb la sintaxi de C son ignorades.
On busca el calendari?
calendar fitxers al directori actual.
~/.calendar directori ocult ubicat al directori de l'usuri.
~/.calendar/calendar fitxers que fa servir si no hi un fitxer calendar al directori actual.
~/.calendar/nomail si el fitxer nomail existeix, no s'envia el calendari del dia a aquel usuari (opció -a).
Els següents fitxers es poden trobar a /usr/share/calendar i contenen llistes d'efemèrides
calendar.all fitxers calendar nacionals i internacionals.
calendar.birthday dates de naixement i decés de personatges famosos.
calendar.christian calendari cristià (però no està de més revisar-ne les dates).
calendar.computer efemèrides rel·lacionades amb el món de la informàtica.
calendar.croatian calendari croata.
calendar.discordian el calendari de la discòrdia.
calendar.fictional dates i efemèrides fantàstiques i de ficció .
calendar.french calendari francès.
calendar.german calendari alemany.
calendar.history miscel·lània d'efemèrides.
calendar.holiday altres festes.
calendar.judaic calendari jueu.
calendar.music dates del món del rock and roll.
calendar.openbsd esdeveniments rel·lacionats amb el bsd.
calendar.pagan festes paganes.
calendar.russian calendari rus.
calendar.space història de cursa espacial.
calendar.ushistory esdeveniments històrics dels EUA.
calendar.usholiday festes dels EUA.
calendar.world esdeveniments mundials.
Exemple (\t és el caràcter de tabulació):
LANG=C
Easter=DiumengePasqua
#include <calendar.usholiday>
#include <calendar.birthday>
6/15\tJune 15 (Si és ambigu, es prem mes/dia).
Jun. 15\tJuny 15.
15 June\tJuny 15.
Thursday\tCada dijous.
June\tCada primer de juny.
15 *\tEl 16 de cada mes.
May Sun+2\tsegon diumenge de maig (Muttertag)
04/SunLast\túltim diumenge d'abril,
\tentra l'horari d'estiu a europa
Easter\tdiumenge de pasqua
DiumengePasqua\tdiumenge de pasqua (amb àlies)
Easter-2\tdivendres sant (2 dies abans de diumenge de pasqua)
DiumengePasqua\t-2\tdivendres sant(com abans, però amb àlies)
Paskha\tPasqua ortodoxa
Un altre exemple, més senzill:
#include <calendar.usholiday>
#include <calendar.russian>
#include <calendar.discordian>
#include <calendar.christian>
#include <calendar.computer>
#include <calendar.birthday>
07/31 últim dia de les vacances d'estiu 2011
08/01 Sant Tornem-Hi
El resultat avui és (30 de juliol):
