cat |

## Description

Write the content of a file to stdout.

## Parameters

file
  Description: file to be written

  Domain: valid filename

  Default: -

to_file
  Description: if specified this attribute defines the name of the file the input file will be written to

  Domain: valid filename

  Default: -

append
  Description: This attribute applies only if attribute 'to'file' was specified. If set to 'true' the content of 'file' will be appended to the file. Otherwise the file will be overwritten with the content of 'file'.

  Domain: Boolean (true|false)

  Default: false

## RNG Specification

    <define name="cat">
      <element name="cat">
        <ref name="dir_if_unless"/>
        <choice>
          <text/>
          <attribute name="file"/>
        </choice>
        <optional>
          <attribute name="to_file"/>
          <optional>
            <attribute name="append"/>
          </optional>
        </optional>
      </element>
    </define>

## Examples

      <cat file="my_file.txt"/>
      <cat file="my_file.txt" to_file="output.txt"/>
      <cat file="my_other_file.txt" to_file="output.txt" append="true"/>