ics2txt

commit e9d91a5ac44449450f9752bba23df8e80ab330ac
parent 661bba112f192b142affccb401ad9ffead2d2d45
Author: Josuah Demangeon <mail@josuah.net>
Date:   Tue, 12 Jun 2018 23:11:40 +0200

add a real README (not from the man pages)

Diffstat:
M
Makefile
 | 
3
---
M
README
 | 
121
++++++++++++++++++++++++++++++++++---------------------------------------------

2 files changed, 52 insertions(+), 72 deletions(-)
diff --git a/Makefile b/Makefile
@@ -3,9 +3,6 @@ MAN1	= ics2txt.1 txt2ics.1
 
 all:
 
-README: $(MAN1)
-	mandoc -T utf8 $(MAN1) | col -bx >$@
-
 install:
 	mkdir -p $(PREFIX)/bin
 	cp $(BIN) $(PREFIX)/bin
diff --git a/README b/README
@@ -1,69 +1,52 @@
-ICS2TXT(1)                  General Commands Manual                 ICS2TXT(1)
-
-NAME
-     ics2txt  convert ics file to plain text or TSV
-
-SYNOPSIS
-     ics2txt txt [+-]offset [ics file...]
-     ics2txt tsv [+-]offset [ics file...]
-
-DESCRIPTION
-     ics2txt displays iCalendar (ical, .ics) file or stdin if not specified in
-     the format described by the command:
-
-     txt     Display the ics2txt(s) file as plain text sorted by date.
-
-     tsv     Display the ics2txt(s) file as a tab-separated values (tsv) one
-             entry per line, with the following fields in order:
-             DTSTART      begin date as an UNIX timestamp
-             DTEND        end date as an UNIX timestamp
-             CATEGORY     category
-             SUMMARY      symmary
-             LOCATION     location
-             DESCRIPTION  description
-
-ENVIRONMENT
-     TZ      Timezone to use for printing the dates.
-
-SEE ALSO
-     calendar(1), date(1), txt2ics(1)
-
-STANDARDS
-     Desruisseaux, Internet Calendaring and Scheduling Core Object
-     Specification (iCalendar), RFC 5545, September 2009.
-
-AUTHORS
-     Josuah Demangeon <mail@josuah.net>
-
-OpenBSD 6.3                      May 21, 2018                      OpenBSD 6.3
-
-------------------------------------------------------------------------------
-
-TXT2ICS(1)                  General Commands Manual                 TXT2ICS(1)
-
-NAME
-     txt2ics  convert plain text to an ics file
-
-SYNOPSIS
-     txt2ics
-
-DESCRIPTION
-     txt2ics prompts the user for event information and print them in the
-     iCalendar format.  If stdin is ont a TTY, it will not print the prompt
-     string and act as a converter tool.
-
-     It uses floating events: If it is 12:30, it will always be 12:30 of the
-     country he resides in: if he moves to another time zone, it will be 12:30
-     of this new time zone.  See this as the time zone where the event happen.
-
-SEE ALSO
-     calendar(1), date(1), ics2txt(1)
-
-STANDARDS
-     Desruisseaux, Internet Calendaring and Scheduling Core Object
-     Specification (iCalendar), RFC 5545, September 2009.
-
-AUTHORS
-     Josuah Demangeon <mail@josuah.net>
-
-OpenBSD 6.3                      May 30, 2018                      OpenBSD 6.3
+agenda
+================================================================================
+
+*agenda* is an awk scripts to deal with iCal [1] format to publish,
+display and convert *.ics files.
+
+It is still a work in progress and should be released soon.  In the meantime,
+example output from l'agenda du libre [2]:
+
+	[2017/04]
+
+	19  16:00  Linux et les Logiciels Libres
+	    19:00  château Goerg, Callian, Provence-Alpes-Côte d&#39;Azur, France
+	           Venez découvrir Linux et les logiciels libres, mais aussi vous
+	           faire aider avec votre matériel informatique quel qu’il soit,
+	           imprimante, box, tablette, smartphone y compris.
+
+	    16:30  Permanence GNU/Linux - Les Quatre Libertés
+	    18:30  10 rue François Henry d’Harcourt, Montpellier, Occitanie, France
+
+	    17:00  Atelier artiste - hacker
+	    19:00  62 rue Fiéffé, Bordeaux, Nouvelle-Aquitaine, France
+	           Ateliers-cours à la fabrique-pola - L@bx
+
+	    17:00  Introduction à la programmation de jeux
+	    19:00  55 rue de Vincennes, Montreuil, Île-de-France, France
+
+	    17:30  SGEG
+	    20:00  8 rue Colary, Carnac, Bretagne, France
+	           Le SGEG (Sansten GNU Easy Group) vous invite tous les
+	           3e mercredi de chaque mois au SGEG Meeting pour discuter de
+	           Logiciel Libre, boire un verre, manger un morceau et surtout se
+	           rencontrer !
+
+	    17:30  Rencontre Logiciels Libres
+	    20:30  17 rue Bellegarde, Toulouse, Occitanie, France
+	           L’association Toulibre organise une rencontre autour des
+	           Logiciels Libres le mercredi 19 avril 2017, de 19h30 à 22h30 au
+	           Centre Culturel Bellegarde, 17 rue Bellegarde à Toulouse.
+
+	    19:00  Rencontre Tetalab
+	    21:00  12 rue Ferdinand Lassalle, Toulouse, Occitanie, France
+	           Rencontre hebdomadaire des hackers et artistes libristes
+	           Toulousains.
+
+	20  16:00  Soirée Cozy Cloud
+	    18:00  123 boulevard Louis Blanc, La Roche-sur-Yon, Pays de la Loire, France
+	           Le 20 Avril 2017, K’ Rément Libre et LabOuest vous proposent
+	           de venir découvrir Cozy.
+
+[1]: https://tools.ietf.org/rfc/rfc5545.txt
+[2]: https://www.agendadulibre.org