io7m | single-page | multi-page | Laurel User Manual 0.99.1-SNAPSHOT
5. Theory Of Operation
Previous
5. Theory Of Operation
Up
5.2. Categories
Next

# 5.1. Captions

- 5.1.1. Overview
- 5.1.2. Format
- 5.1.3. Caption Files

## 5.1.1. Overview

1
A caption is a string that can be applied to an image to describe some element of that image.

## 5.1.2. Format

1
Captions must conform to the following format:

### 5.1.2.2. Caption Format

    caption ::= [a-z0-9A-Z_-][a-z0-9A-Z_ \-']*

## 5.1.3. Caption Files

1
A caption file is a file consisting of a comma-separated list of captions. More formally, the file conforms to the following format:

### 5.1.3.2. Caption File Format

    caption_file ::= caption ("," caption)+ [ "," ]

3
An example caption file is as follows:

### 5.1.3.4. Caption File Format

    red drapes,
    black and white zigzag floor,
    red chair,
    gold lamp,
    coffee cup,

5
Note that the trailing comma on the last line is optional. All whitespace around commas is ignored.
5. Theory Of Operation
Previous
5. Theory Of Operation
Up
5.2. Categories
Next
io7m | single-page | multi-page | Laurel User Manual 0.99.1-SNAPSHOT