Invoking txt2gcal

The txt2gcal program creates a verbatim Gcal resource file from a text file. Its arguments are as follows:

txt2gcal [--help | --version] | [Text-file|-] [Date-part]

If no text-file argument is given or/but `-', the program reads and processes all input received from the standard input channel. If no date-part argument is given, txt2gcal creates a `0' for the date part. All results are always shown on the standard output channel. An exit status of 0 means all processing is successfully done, any other value means an error has occurred.

The program accepts the following options:

`--help'

Print a usage message listing all available options, then exit successfully.

`--version'

Print the version number, then exit successfully.

Here comes an example how to use txt2gcal. Let's suppose there is a text file by the name of `demo' with the following contents:

        Hi friends,

I'm the demo text containing funny characters and character
sequences like ~~ \~ % %% $a $1 %%%\
%\ %s %%foo %bar \%baz \\~ \~\ and so on...
I'm be anxious how I'll be transformed by `txt2gcal'.

and txt2gcal processes this file, redirecting the output to `demo.rc',:

$ txt2gcal demo 0*d1#999 > demo.rc
=> 0*d1#999 \        Hi friends,~\
=> ~\
=> I'm the demo text containing funny characters and character~\
=> sequences like \~\~ \\~ % %% \$a $1 %%%\ ~\
=> %\ \%s %\%foo \%bar \\%baz \\\~ \\~\ and so on...~\
=> I'm be anxious how I'll be transformed by `txt2gcal'.

then txt2gcal has now created a new Gcal resource file `demo.rc' from the text file `demo'. Let's finally see, how Gcal will interpret this new resource file:

$ gcal -H no -Ax -f ./demo.rc
-|
-| Thu, May   2nd 1996:
-|         Hi friends,
-|
-| I'm the demo text containing funny characters and character
-| sequences like ~~ \~ % %% $a $1 %%%\
-| %\ %s %%foo %bar \%baz \\~ \~\ and so on...
-| I'm be anxious how I'll be transformed by `txt2gcal'.

Go to the first, previous, next, last section, table of contents.