Topic: Responses

Certain operations cause listmanager to generate a response message, either
to the owner of the list involved or the user submitting the request, or
sometimes both.  In certain limited cases, the body of these messages can be
tailored to the desires of the list owner and/or the system administrator.

A configurable response must first have the default format defined by the
system administrator.  This is done by creating a template for the message
in the "response directory" (see the man page for listmanager for information
about defining this directory).  The template should be placed in a file
named after the message it defines; e.g. "ack" for the "ack" message for
all lists.

If a listmanager response message is configurable, the system-wide default
template is mandatory, and listmanager will not start in any mode except the
CLI mode if any mandatory response files are absent.

A list owner may override the system-defined default by defining a response
file for the list using the "set" command.  The list of responses that can
be defined in that way can be found in the "Files" help file.

The template should contain the text you wish to have sent out in response
to the event whose response message you are defining.  listmanager will add
the required headers to the message and leave a blank line before starting
to use the template you have defined.

listmanager supports a printf-style set of tokens that can be expanded based
on properties of the list or other variables.  These are:

	%D	the domain of the list (if set) or the value of the
		"masquerade" configuration parameter (if set), or the
		hostname where listmanager is running
	%L	the name of the list
	%S	the sender of the submission or request
	%b	the number of bytes in the submission, or 0 if no submission
		is involved
	%i	the value of the Message-ID header of the submission or
		request
	%l	the number of lines in the submission, or 0 if no submission
		is involved
	%m	the number of members on the list referenced by the submission
		or request
	%s	the subject of the submission or request
	%%	a percent sign

See also: Files, set