Introduction
Introduction Statistics Contact Development Disclaimer Help
merge the man page and README - ics2txt - convert icalendar .ics file to plain …
git clone git://bitreich.org/ics2txt git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws…
Log
Files
Refs
Tags
README
---
commit 22d6fb0c1075eda38c175b3566c76259a1ae94c1
parent 98971edcda214c5d5ac9e521363a0d5895c289d3
Author: Josuah Demangeon <[email protected]>
Date: Mon, 2 Mar 2020 08:28:10 +0100
merge the man page and README
Diffstat:
M README | 52 ++++++++++++++++++++++++++++-…
M ics2txt.1 | 13 ++++++++-----
2 files changed, 55 insertions(+), 10 deletions(-)
---
diff --git a/README b/README
@@ -1,7 +1,49 @@
-sical
-=====
+ICS2TXT(1) General Commands Manual ICS2TXT(1)
-*sical* is set of awk scripts to deal with iCal [1] format to publish,
-display and convert *.ics files, though a simple central TSV format.
+NAME
+ ics2txt – convert ics file to simpler tsv or txt formats
-[1]: https://tools.ietf.org/rfc/rfc5545.txt
+SYNOPSIS
+ ics2txt-tsv <file.ics >file.tsv
+ ics2txt-ics <file.tsv >file.ics
+ ics2txt-txt <file.tsv >file.txt
+ ics2txt-back <file.txt >file.tsv
+
+DESCRIPTION
+ ics2txt is set of awk scripts to deal with iCal (.ics) format to publish,
+ display and convert *.ics files, though a simple central TSV format.
+
+ They all read from either stdin or the file passed as argument, and write
+ to stdout.
+
+ file.tsv files have one line per event, all with the following fields,
+ separated by one tab:
+ 1. Begining (epoch)
+ 2. End (epoch)
+ 3. Category
+ 4. Location
+ 5. Summary
+ 6. Description
+
+EXAMPLES
+ Convert a calendar from HTTP .ics to custom .txt sorted by beginning:
+ curl $url.ics | ics2txt-tsv | sort -n -k 1,1 | ics2txt-txt
+
+ Convert a custom .txt format back to an .ics file and publish it:
+ ics2txt-back cal.txt | ics2txt-ics | ssh www@$host 'cat
+ >/var/www/cal.ics'
+
+ Split an file according to the category, saved as .tsv:
+ ics2txt-tsv cal.txt | awk -F '\t' '{ f = $3".tsv"; print >>f }'
+
+SEE ALSO
+ cal(1), calendar(1), date(1), sort(1)
+
+STANDARDS
+ Desruisseaux, Internet Calendaring and Scheduling Core Object
+ Specification (iCalendar), RFC 5545, September 2009.
+
+AUTHORS
+ Josuah Demangeon <[email protected]>
+
+OpenBSD 6.6 March 1, 2020 OpenBSD 6.6
diff --git a/ics2txt.1 b/ics2txt.1
@@ -19,9 +19,11 @@
.Sh DESCRIPTION
.
.Nm
-is a set of tools to convert between iCalendar
-.Pq ical
-and other simple text formats: tsv, custom-text.
+is set of awk scripts to deal with iCal
+.Pq Pa .ics
+format to publish, display and convert *.ics files, though a simple
+central TSV format.
+.Pp
They all read from either stdin or the file passed as argument, and
write to stdout.
.
@@ -76,14 +78,15 @@ Split an
.ics
file according to the category, saved as
.Pa .tsv :
-.Dl ics2txt-tsv cal.txt | awk -F '\t' '{ file = $3".tsv"; print >>file }'
+.Dl ics2txt-tsv cal.txt | awk -F '\et' '{ f = $3".tsv"; print >>f }'
.
.
.Sh SEE ALSO
.
.Xr cal 1 ,
.Xr calendar 1 ,
-.Xr date 1
+.Xr date 1 ,
+.Xr sort 1
.
.
.Sh STANDARDS
You are viewing proxied material from bitreich.org. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.