[ previous ] [ Copyright Notice ] [ Contents ]

The Smeg Manual - Chapter 4
Reference manual.


4.1 Commands.

A command is something one can type at the smeg> prompt, causing Smeg to take an action. It's possible to type more than one command per prompt, but at least one command should be present per line.


4.1.1 echo string - displays a string.

Echo will print its argument, a string, on the output channel. It's most useful in the rcfile, as a method of conveying information to the user.


4.1.2 less command - diverts output to pager.

The less command will execute its argument, another command, with the output channel piped to a pager. The exact pager can be changed using the set pager command. Mixing the less and print commands can lead to problems.


4.1.3 print command - diverts output to a printer.

The print command will execute its argument, another command, with the output channel piped to a print spooler. The exact pager can be changed using the set printcmd command. Mixing the less and print commands can lead to problems.


4.1.4 set string string - sets options.

This command sets a settable, identified by the first string, to a value specified by the second string. See the section on settables below for details on what can be set.


4.1.5 def string string - defines a procedure.

The def command creates a new procedure. The name of that procedure is set to the first string, while the second string is used to define the procedure's body. The second string is usually a quoted string. Please note that the body is not parsed before being defined. Instead, it's parsed when the procedure is called. This command can also be used to redefine a procedure.


4.1.6 call string - calls a procedure.

Call can be used to call a defined procedure. The procedure is parsed at call time, so an error message based on the procedure definition can be printed out.


4.1.7 tle string - loads two line elements from a file.

This command reads a set of two line elements from a file, specified by the argument. It uses them to initialize the satlist.


4.1.8 filter satlist expression - filters the satellite list.

This command applies the expression to the current satlist. Satellites that satisfy the expression are left on the list, while those that fail it are removed. See the section on expressions for more information on filters that can be applied to the satlist.


4.1.9 noradfilter - interactively filter satellites based on norad number.

The noradfilter command filters the satlist based only on norad numbers. Once run, it will prompt the user for a list of norad numbers. Enter the numbers, one per line. Terminate entry with a blank line. Smeg will use these numbers to filter the current satlist. (Note that this can only remove entries from the list, not add them.)


4.1.10 unfilter satlist - resets satlist to last element load.

Unfilter satlist will restore the satellite list to its state after the last tle command. It undoes all filtering done to the satlist in the intervening time.


4.1.11 predict passes [ [ timespec ] timespec ] - predicts passes.

Predict passes will create a list of passes. (A pass is defined as a timespan in which the satellite is above a minimum elevation, set by set minelev, defaulting to 0 degrees.) It can take zero, one, or two timespecs. If called without any arguments, it will predict passes for a period of one day starting at its invocation. If called with a single argument, it considers the argument to be the end of the prediction window (with the start being the current time.) Two arguments are used to specify a window in the order start, end.


[ previous ] [ Copyright Notice ] [ Contents ]
The Smeg Manual
0.98 (Visual Prerelease)
Tom Rothamel tom-smeg@onegeek.org