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


Invoking gcal2txt

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

gcal2txt [--help | --version] | [Resource-file|-]

If no resource-file argument is given or/but `-', the program reads and processes all input received from the standard input channel. 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 sense and purpose of gcal2txt is to retrieve all additional texts, which are put in output by means of txt2gcal.

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 gcal2txt. For that purpose, let's use the resource file `demo.rc' of the previous section (see section Invoking txt2gcal), which was created by means of txt2gcal from a text file and which looks like this:

$ cat 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'.

Now let's see, how this resource file will be processed by gcal2txt:

$ gcal2txt demo.rc
-|         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.