Topics Keyword

Topics= topic1,topic2,...topic23

This keyword is not available in LISTSERV Lite.

This keyword provides a way to run a mailing list where several sub-topics are being discussed in parallel, allowing subscribers to only receive messages related to their topics of interest.

Through the "Topics=" keyword, the list owner can define up to 23 topics for the list. For example:

• Topics= News,Benchmarks,Meetings,Beta-tests

To save disk space, LISTSERV remembers which topics subscribers have selected through their ordering in the "Topics=" keyword. That is, "News" is "Topic 1" for LISTSERV, "Benchmarks" is "Topic 2", and so on. This means that you can change the name of a topic without requiring users to alter their subscriptions (for instance, you could decide that "Tests" is a better name than "Beta-tests" and just make the change). However, you must never change the order of the topics in the "Topics=" keyword. If you want to remove a topic, replace it with a comma. For instance, to remove the "Meetings" topic, you would change the keyword to:

• Topics= News,Benchmarks,,Beta-tests

Topic names can contain any character except space, colon and comma. The use of double quotes or equal signs is discouraged since they require special attention when coding list header keywords. In addition, topic names may not start with a plus or minus sign, and the words ALL, NONE, RE, OTHER and OTHERS are reserved.

Posters label their messages through the subject line. LISTSERV first skips any possible sequence of "Re:" keywords, and takes anything to the left of a colon as a list of topics, separated by commas. The posting is considered to belong to all the topics listed before the colon. If none of these topics is valid for the list, it is classified in a special topic, "Other". If some of the topics are valid but others are undefined, the invalid ones are ignored. The subject field is left unchanged. Here is an example:

• Subject: Benchmarks,News: Benchmarks for XYZ now available

Messages that should be read by everyone can be posted to the special topic "All". Topic names can be shortened to any unambiguous abbreviation. In our example, "Be" is ambiguous because it could be either "Beta-tests" or "Benchmarks", but "Bench" is acceptable.

Subscribers can select the topics they wish to receive on the subscription screen in the web interface or with the SET command. The syntax is 'SET listname TOPICS: xxx' where 'xxx' can be:

• A list of all the topics the user wishes to receive. In that case these topics replace any other topics the user may have subscribed to before. For instance, after 'SET XYZ-L TOPICS: NEWS BENCH', the user will receive news and benchmarks, and nothing else.


• Updates to the list of topics the user currently receives. A plus sign indicates a topic that should be added, a minus sign requests the removal of a topic. For instance, 'SET XYZ-L TOPICS: +NEWS -BENCH' adds news and removes benchmarks. If a topic name is given without a + or - sign, + is assumed: 'SET XYZ-L TOPICS: +NEWS BENCH' adds news and benchmarks. The first topic name must have the plus sign to show that this is an addition, and not a replacement.


• A combination of the above, mostly useful to enable all but a few topics: 'SET XYZ-L TOPICS: ALL -MEETINGS'.

The colon after the keyword TOPICS: is optional, and TOPICS= is also accepted. Do not forget to include the special OTHER topic if you want to receive general discussions that were not labeled properly. On the other hand, if you only want to receive properly labeled messages you should not include it. ALL does include OTHER.

Finally, it is important to note that topics are active only when your subscription is set to MAIL. Digests and indexes always contain all the postings that were made because the same digest is prepared and sent to all the subscribers.