--- "include" topic #1 ---

Commands: include

  Format: include <list>

Causes all of the subscribers of the named list to receive submissions
to the currently selected list.  You must have owner access to both lists
to use this command.

The best way to explain this is by example.  Suppose you use the commands:

	select mylist
	include yourlist

This means any submission to "mylist" will go to all subscribers of "mylist"
as well as all subscribers of "yourlist".  Listmanager will weed out
duplicate addresses (e.g. a user subscribed to both) so that such users
only get one copy of things sent to "mylist".

Note that subscribers in an included list who set the "exclusive" flag will
not be included by this function.

You will see included lists in your member listing (output of "members")
with the member flag "include" next to it.

Note the following caveats to beware when using this feature.  It's tricky
to explain so you may find reading these points more than once will help
you to understand what's going on.

- member status is not implicit; this means members of "yourlist"
  do not become members of "mylist", and thus commands affected by such
  things as "memberlist" and "arch-members" will treat "yourlist" members
  as non-members (unless they were otherwise subscribed to "mylist" already)
- similiarly, owners of "yourlist" don't become owners of "mylist"
- if a subscriber of "yourlist" has the "digest" flag on, she/he will
  receive the digest of "mylist" if such is defined subject to the digest
  settings of "mylist"
- the only member flags whose effects carry from "yourlist" to "mylist"
  are "digest", "noownermail", "noerrormail", "pending" and "nosend"
- if "mylist" has the "match-domain" flag set, the rules of "match-domain"
  will be applied when merging the members of "yourlist" into the members
  of "mylist" for the purposes of distribution of messages; the addresses
  already on "mylist" will prevail if an address on "yourlist" is found to
  match
- if "mylist" is archived, submissions are kept in "mylist"'s archive,
  and not in "yourlist"'s archive
- any errors resulting from trying to deliver submissions to "mylist" to
  members of "yourlist" are reported to the owners of both lists

You may include more than one list, or nest includes if desired.  You can
even cause include loops (e.g. include "x" in "y", include "y" in "z", and
include "x" in "z"); listmanager safely detects these cases and includes each
list exactly once.

To stop including a list's subscribers, remove the entry with the "remove"
command.

See also: owner select

--- "include" topic #2 ---

Member flag: include

Subscribers with this flag set are actually other listmanager-controlled
lists whose subscribers are to be included in the selected list.  These
are added by the "include" command and removed by the "remove" command.

This flag cannot be set or cleared by list subscribers or list owners.
It is for internal use and reference purposes only.
