merge the man page and README - ics2txt - convert icalendar .ics file to plain text
 (HTM) git clone git://bitreich.org/ics2txt git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/ics2txt
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) Tags
 (DIR) README
       ---
 (DIR) commit 22d6fb0c1075eda38c175b3566c76259a1ae94c1
 (DIR) parent 98971edcda214c5d5ac9e521363a0d5895c289d3
 (HTM) Author: Josuah Demangeon <me@josuah.net>
       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(-)
       ---
 (DIR) 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 <me@josuah.net>
       +
       +OpenBSD 6.6                      March 1, 2020                     OpenBSD 6.6
 (DIR) 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