# echo

## Description

Echo a message to stdout.

## Parameters

message
  Description: Message to be echoed

  Domain: -

  Default: -

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

  Domain: valid filename

  Default: -

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

  Domain: Boolean (true|false)

  Default: false

## RNG Specification

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

## Examples

      <echo message="Hello world!"/>
      <echo message="Hello world!" to_file="messages.txt"/>
      <echo message="Hello world again!" to_file="messages.txt" append="true"/>
      <echo>Hello from inside 'echo'</echo>
      <echo>Hello from inside 'echo'
      using more than one line</echo>