wossname

Function

Description

wossname searches for the specified keywords (or parts thereof) in the application short description (as displayed by a program when it starts), functional group name and keywords. The group name, application name and short description of any matching applications is output (screen by default). If no search words are specified, then details of all the EMBOSS programs are output. There are various options for controlling how the search is performed and what is given in the output file. Optionally, the output will be wrapped in HTML tags ready for inclusion in a Web page.

Usage

Command line arguments


Input file format

wossname reads the brief descriptions and the program groups from the ACD files. (ACD files control the parameters that the programs expect - don't worry about them unless you are writing EMBOSS programs).

The format of ACD files is documented elsewhere.

Output file format

The results are written out as a simple list preceded by the group that the programs belong to or the word that is being searched for.

If the -html, -prelink and -postlink qualifiers are specified, then the output will be wrapped in HTML tags, ready for inclusion in a Web page. Note that tags such as <HTML>, <BODY>, </BODY> and </HTML> are not output by this program as the list of programs is expected to form only part of the contents of a web page - the rest of the web page must be supplied by the user.

Data files

As noted above, the program ACD files are searched. The average user will not need to worry about this.

Notes

wossname reads the short descriptions and the program groups from the program ACD files. These file describe the command-line interface of the applications. You don't need to know about them unless you are writing EMBOSS programs. They are described in the EMBOSS Developers Manual.

If a program's ACD file does not specify a program group, then it will be automatically assigned to the group ASSORTED in the output file. A program can belong to more than one group.

References

None.

Warnings

None.

Diagnostic Error Messages

None.

Exit status

It always exits with status 0

Known bugs

None.

Author(s)

History

Target users

Comments