PERMISSIONS

Not every of the following commands may be given by anyone. There are two groups of persons, who may try to give a command: An editor or somebody else.

Moreover some for some commands it matters, if they are given explicitly or implicitly. A implicit command is created automatically, when the header of a post is read.

Besides a few internal commands editors may give almost any command. Commands, which are available for everybody, are usually only permitted, if the command is given implicit.

COMMANDS

The commands are given with their arguments.

The most important commands are approve, language, and delete. These commands may be read first.

references [msg-id] ...
This command gives one or more keys msg-id for the posts the following commands refer to.

msg-id is the value of the Message-Id: field in the header of the post referred to. A msg-id always contains angle brackets (<>) and a at-sign (@).

If more than one msg-id is given, the following commands are executed for every post referenced this way.

If no msg-id is given, the following commands refer to no post at all. (It is allowed, though this makes no sense usually. However, on the future this may get some special meaning.)

Every references command overrides a previously given references command. In particular this means, that one references command lasts until the next one.

The approval queue reports of the clerk contains the Message-Id: field of the post. This can be simply copied.

Implicit generation
This command is generated implicitly for every reply to an entry of the approval queue on list-work, and thus must be given only when working with several posts in one command mail.

Permissions needed
Implicitly the command may be given by anyone.

Explicitly only editors may use this command.

Errors
If a certain msg-id is invalid, this is an error, but the remaining arguments are still considered.

If a certain msg-id can not be found in the approval queue, a warning is generated, but the command does not fail.

Example 1
        ! references <199707090952.JAA22903@example.com>
        ! approve

Refer to a certain post and approve it.

Example 2
        ! references
        !! <1.5.4.32.19970725034550.00701d38@anditel.andinet.lat.net>
        !! <199707251804.UAA16544@dredd.swip.net>
        ! delete

Refers to two posts and deletes them both. Note that the references command uses continuation lines (see SYNTAX in the Language manpage).

language tag ...
This command says, that the referenced post is written in language tag. This command overrides previous settings of the language. The new language tag is stored.

If more than one tag is given, the post is assumed to be written in all the languages given.

The tag has to conform to the ISO-encoding 639 for languages.

Implicit generation
An implicit command is generated by the language tags, which may be given in a new post. This way they are checked as any other language tag.

Permissions needed
Implicitly the command may be given by anyone.

Explicitly only editors may use this command.

Errors
This command fails if the referenced post is not in the approval queue, has no subject at all, or if one or more of tag is invalid.

Annotations
This command produces the annotations Orig-Language and Advised-Language when given explicitly.

Example
        ! language ca en

A post has been sent in Castillian and English.

subject word ...
This command sets a new Subject: line for the referenced post. The subject is constructed by joining all the words with an intervening space.

If the subject given does not start with a language tag, an exisiting language tag is preserved. If the subject starts with a language tag, an implicit language command is executed with this tag.

Permissions needed
Only editors may use this command.

Errors
This command fails if the referenced post is not in the approval queue.

Annotations
This command produces the annotation Orig-Subject.

Example 1
        ! subject (en) A clean subject is nice to read

Sets a Subject: for the referenced post together with the language tag.

Example 2
        ! subject (de) 'Eine "Uberschrift'

Sets a Subject: by using two words, one quoted by single quotes (see SYNTAX in the Language manpage).

approve
This command approves the post currently referenced. This means, that it is sent to all the moderated lists, which want this certain post.

If a post is successfully approved, it is implicitly removed from the approval queue.

Implicit generation
This command is implicitly generated for every new post going to list.

Permissions needed
Implicitly trusted users may use this command.

Explicitly only editors may use this command.

Errors
This command fails if the referenced post is not in the approval queue.

Annotations
This command generates the annotations Approved-By, Published-In and Archived-In.

Example
        Subject: Re: (en) A new post
        
        ! approve

Approve a post sent by replying to it.

sendto addr ...
This command sends the referenced post unconditionally to all of the given addresses. The post is not removed from the approval queue.
Implicit generation
For every new post an implicit command is generated which sends the post to the unmoderated list-raw.

If a new post looks like a reply, an implicit command of this type is generated, which directs it to the discussion list.

Permissions needed
Implicitly the command may be given by anyone.

Explicitly only editors may use this command.

Errors
This command fails if the referenced post is not in the approval queue.

Annotations
This command generates the annotation Published-In.

Example
        ! sendto list-d
        ! delete

This sends a post to list-d and deletes it afterwards. This is useful for replies, which do not look like a reply.

delete
This command deletes the referenced post from the approval queue.

Only a member of list-org may delete a post, thus this command fails if tried by anybody else.

Command to delete the referenced post from the approval queue.

Implicit generation
If a new post looks like a reply, an implicit command of this type is generated to prevent it from getting into the approval queue.

Permissions needed
Implicitly the command may be given by anyone.

Explicitly only editors may use this command.

Errors
This command fails if the referenced post is not in the approval queue.

Annotations
This command generates the annotation Deleted-By.

Example
        Subject: Re: Nice spam
        
        ! delete

Deletes a post by replying to it.

report report addr ...
This command creates a report called report, and sends it or to each of addr.

A report contains some sort of information about the current state of affairs. It can contain a lot of different informations.

Every report has to be configured in the configuration. Ask your maintainer for the current list of available reports.

Implicit generation
This command may be triggered by an command option given on the command line. addr is optional in this case, and the default addresses for report are used if necessary.

Permissions needed
This command may be given by anyone.

Errors
If the command is given explicit, it is an error to omit addr.

If something fails during the generation of the report, this command fails.

Example
        ! report approval smerten@oekonux.de

Send a report called approval to smerten@oekonux.de. Assumably this is a report about the contents of the current approval queue.

ERRORS

This is not yet documented. Immediately write a mail to smerten@oekonux.de asking for this particular document.