Home

       update the manpage accordingly - ics2txt - convert icalendar .ics file to plain text
  HTML git clone git://bitreich.org/ics2txt git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/ics2txt
   DIR Log
   DIR Files
   DIR Refs
   DIR Tags
   DIR README
       ---
   DIR commit 98971edcda214c5d5ac9e521363a0d5895c289d3
   DIR parent 37b4e99568c76d39376244f8f85fcf0dcfc95bd9
  HTML Author: Josuah Demangeon <me@josuah.net>
       Date:   Mon,  2 Mar 2020 08:21:12 +0100
       
       update the manpage accordingly
       
       Diffstat:
         M ics2txt.1                           |      48 +++++++++++++++++++++++--------
       
       1 file changed, 36 insertions(+), 12 deletions(-)
       ---
   DIR diff --git a/ics2txt.1 b/ics2txt.1
       @@ -12,18 +12,24 @@
        .Sh SYNOPSIS
        .
        .Nm ics2txt-tsv Ar <file.ics >file.tsv
       -.Nm ics2txt-txt Ar <file.tsv >file.txt
        .Nm ics2txt-ics Ar <file.tsv >file.ics
       +.Nm ics2txt-txt Ar <file.tsv >file.txt
        .Nm ics2txt-back Ar <file.txt >file.tsv
        .
        .Sh DESCRIPTION
        .
        .Nm
       -convert iCalendar 
       +is a set of tools to convert between iCalendar 
        .Pq ical
       -.Ar file.ics
       -or stdin if not specified to a tab separated value format, with one
       -line per entry, and one column per field:
       +and other simple text formats: tsv, custom-text.
       +They all read from either stdin or the file passed as argument, and
       +write to stdout.
       +.
       +.Pp
       +.The
       +.Pa file.tsv
       +files have one line per event, all with the following fields,
       +separated by one tab:
        .
        .Bl -offset 1n -width 1n -enum -compact
        .
       @@ -42,17 +48,35 @@ Location
        .It
        Summary
        .
       -.It description
       -description
       +.It
       +Description
        .
        .El
        .
       +.
       +.Sh EXAMPLES
       +.
       +Convert a calendar from HTTP
       +.Pa .ics
       +to custom
       +.Pa .txt
       +sorted by beginning:
       +.Dl curl "$url.ics" | ics2txt-tsv | sort -n -k 1,1 | ics2txt-txt
       +.
       +.Pp
       +Convert a custom
       +.Pa .txt
       +format back to an
       +.Pa .ics
       +file and publish it:
       +.Dl ics2txt-back cal.txt | ics2txt-ics | ssh "www@$host" 'cat >/var/www/cal.ics'
       +.
        .Pp
       -The
       -.Sq \en
       -and
       -.Sq \et
       -charaters may represent newlines and tabs.
       +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 }'
        .
        .
        .Sh SEE ALSO