Name

rdclilogedit — Command-line editor for Rivendell logs

Synopsis

rdclilogedit [OPTIONS]

Description

rdclilogedit(1) is a command-line editor for Rivendell logs. It is loosely styled after the venerable ed(1) command-line text editor.

Options

-n, --quiet, --silent

Suppress generation of the command-line prompt (often desirable when driving rdclilogedit(1) from a script).

Commands

rdclilogedit(1) supports the notion of an 'edit buffer' into which Rivendell logs can be loaded, modified and then saved back to the Rivendell database. The contents of the edit buffer can be manipulated by means of simple textual commands (seperated by newline or ; sent to STDIN). The following commands are supported:

addcart {line} {cart-num}

Add a new cart event before line line using cart cart-num.

addchain {line} {log-name}

Add a new chain-to event before line line pointing to log-name.

addmarker {line}

Add a new marker event before line line.

addtrack {line}

Add a new track event before line line.

bye

Exit the program.

deletelog {log-name}

Delete the log log-name from the Rivendell database.

exit

Exit the program.

header

Print the header data for the currently loaded log.

help [cmd-name]

Print help about command cmd-name. If cmd-name is omitted, print the full list of available commands.

list

Print the log in the edit buffer.

listlogs

Print a list of the available Rivendell logs.

listservices

Print a list of the available Rivendell services.

load {log-name}

Load the log log-name into the edit buffer.

new {log-name}

Create a new, empty log called log-name in the edit buffer.

quit

Exit the program.

remove {line}

Remove the log event at line line in the edit buffer.

save

Save the contents of the edit buffer.

saveas {log-name}

Save the contents of the edit buffer to a new log called log-name.

setautorefresh {yes|no}

Set the state of the log's auto-refresh flag.

setcart {line} {cart-num}

Set the cart event at line line to use cart number cart-num.

setcomment {line} {str}

Set the Comment field of the marker or track event at line line to str.

setdesc {str}

Set the Description field of the log to str.

setenddate [date]

Set the End Date of the log to date, where date is in the format YYYY-MM-DD. To clear the End Date value completely, omit the date parameter.

setlabel {line} {str}

Set the Label field of the chain-to or marker event at line line to str.

setpurgedate [date]

Set the Purge Date of the log to date, where date is in the format YYYY-MM-DD. To clear the Purge Date value completely, omit the date parameter.

setservice {str}

Set the log's owning Service to str. (To print a list of valid Service names, see listservices).

setstartdate [date]

Set the Start Date of the log to date, where date is in the format YYYY-MM-DD. To clear the Start Date value completely, omit the date parameter.

settime {line} {hard|none} [time]

Set the start time type and value for a log event. When specifying a type of hard, the time value (format HH:MM:SS) must also be specified.

settrans {line} {play|segue|stop}

Set the transition type for a log event.

unload

Unload and clear the contents of the edit buffer.

Bugs

rdclilogedit(1) has no ability to create or edit log link events (such as Music or Traffic links).