Home
Reference
Find details on the SPL language, toolkits, APIs, commands, and more.
SPLDOC markup
You can use SPLDOC markup in the descriptions associated with the SPL artifacts in a toolkit. The spl-make-doc command generates HTML documentation from the marked up artifacts.
Text markup
You can use SPLDOC markup to format text into pages, sections, paragraphs, lists, and blocks of code. You can also apply different typefaces, such as italics, bold, and monospace.
Page
You can start a page by starting a line with one or more + characters.

Welcome
Learn about the core capabilities of Teracloud® Streams, its architecture, and key concepts.
Installing
Use this information to install, upgrade, and uninstall the Teracloud® Streams product.
Configuring
Create a basic or an enterprise domain which is a single point for configuring and managing common resources, security, and instances.
Administering
Administer the product by using the Teracloud® Streams graphical user interface, APIs, or the streamtool command-line interface.
Developing
Develop stream applications with the Streams Processing Language (SPL), Java, and Python.
Troubleshooting
Resolve problems with Teracloud® Streams using the troubleshooting tools provided with the product as well as the resources offered by Teracloud Support.
Reference
Find details on the SPL language, toolkits, APIs, commands, and more.
- APIs
  Application programming interfaces (APIs) provide functions that simplify applications development.
- Job configuration overlays
  You can specify or change configuration parameters when you use the submitjob or updateoperators operations. The settings control submission constraints, host constraints and locations, and operator status. Parameters are captured and updated in the configuration JSON file. When you change the values in the job configuration overlay file, the changes override any previously set values.
- Commands
  Teracloud® Streams provides a number of commands you use to perform tasks.
- Operator model
  An operator model is an XML document that describes the basic properties of a primitive operator.
- Streams Processing Language (SPL)
  Streams Processing Language (SPL) is a distributed data flow composition language that is used in Teracloud® Streams. SPL has primitive types, program structures, and definitions that are tailored for streaming data.
- Toolkits
  A toolkit is a set of SPL artifacts, which are organized into a package. Toolkits make SPL or native functions and primitive or composite operators reusable across different applications.
- SPLDOC markup
  You can use SPLDOC markup in the descriptions associated with the SPL artifacts in a toolkit. The spl-make-doc command generates HTML documentation from the marked up artifacts.
  - Quick reference for SPLDOC markup
    SPLDOC markup tags document SPL artifacts in a toolkit.
  - Comments
    This information describes the comment syntax for the SPL artifacts in SPL files. SPLDOC comments are delimited by the forward slash and asterisk characters.
  - Text markup
    You can use SPLDOC markup to format text into pages, sections, paragraphs, lists, and blocks of code. You can also apply different typefaces, such as italics, bold, and monospace.
    - Page
      You can start a page by starting a line with one or more + characters.
    - Section
      You can start a section by starting a line with a # character, followed by the section title.
    - Paragraphs
      You can separate text into distinct paragraphs by using blank lines.
    - Italics and bold typeface
      You can mark up text to emphasize it with italics and bold typeface. Italics are delimited by one asterisk ( * ). Bold typeface is delimited by two asterisks ( ** ).
    - Monospace typeface
      To display text in monospace typeface, such as the text of inline code, delimit the text with back quotation marks (` `).
    - Code block
      To format a block of code with SPLDOC markup, indent each line of code by four or more spaces or by pressing the Tab key.
    - Lists
      SPLDOC supports markup for ordered and unordered lists. You can use this markup to create lists, nest lists within other lists, and embed paragraphs and code blocks in lists.
    - Tables
      You can create tables by using three or more hyphens.
  - Escape
    To suppress interpretation by the spl-make-doc command, precede the SPLDOC markup character by a backslash ( \ ), which is the escape character.
  - Links
    You can use SPLDOC to mark up different kinds of links.
  - Annotation tags
    You can use the SPLDOC annotation tags to document the interfaces that are exposed by the SPL composite operators and to exclude toolkit artifacts. You can also use SPLDOC annotation tags to document SPL and native functions.
  - Images
    You can embed image files in the generated document by specifying the image file name and a label for the image.
  - Formatting conventions
    By following the formatting conventions when you mark up the toolkit artifacts, you ensure that the spl-make-doc command interprets the markup correctly and generates the expected results.
Glossary
Use this glossary to find terms and definitions for Teracloud® Streams.

Page

You can start a page by starting a line with one or more + characters.

You specify one + character for each level in the page hierarchy followed by the page title, where a single + character indicates a page at one level below the starting page. If the generated index is rendered as a tree structure, then subpages are shown as child nodes of a parent page.

+ <page-title>

Restriction: The page markup is supported only in the SPLDOC descriptions for toolkits, namespaces, primitive operators, and SPL files.

Restriction: Page markup is only supported from a top section level, not from a subsection.

A new page is started by a + character.

The following SPLDOC markup generates four pages in addition to the starting page. The second and third pages are subpages of the first new page. The fourth page is a new page at the same level as the first new page. Both the first and fourth new pages are linked from the starting page.

/**
 * Example of new page markup.
 *
 * + The title for a new page
 * Text in the page. Following this sentence are links to subpages.
 * ++ The title for a new subpage 1
 * Text in the subpage 1. This is the second sentence.
 * ++ The title for a new subpage 2
 * Text in the subpage 2. This is the second sentence. 
 * + The title for another new page
 * Text in the page.
 */

The spl-make-doc command renders the markup as four new pages with titles similar to the examples. Each page contains links to any new subpages.

The title for a new page

Text in the page. Following this sentence are links to subpages.
The title for a new subpage 1
Text in the subpage 1.
The title for a new subpage 2
Text in the subpage 2.

The title for a new subpage 1 

Text in the subpage 1. This is the second sentence.

The title for a new subpage 2 

Text in the subpage 2. This is the second sentence.

The title for another new page

Text in the page.