Bug#368405: manual page unclear

[Frederik Eaton]

Package: exim4
Version: 4.50-8
Severity: normal

For instance consider this piece of the man page:
 
       -t        When  Exim is receiving a locally-generated, non-SMTP message 
                 on its standard input, the -t option causes the recipients of 
                 the message to be obtained from the To:, Cc:, and Bcc: header 
                 lines in the message instead of from the  command  arguments. 
                 The addresses are extracted before any rewriting takes place. 
 
"When Exim is receiving a locally-generated, non-SMTP message on its
standard input...". So which options must I pass to exim, along with
"-t", to get it to "receive a locally-generated non-SMTP message on
its standard input"? Good luck finding the answer in the man page, or
in the specification. The answer seems to be "none" but I don't know
how I was supposed to figure that out, other than by trial and error.

It seems like a pretty typical use case to me, though. I think that
something should be said near the top of the manual page about common
use cases such as this. The most common options options can be put
before the others, which would help a lot, but there should be some
introductory text as well.

Frederik

-- Package-specific info:
Exim version 4.50 #1 built 27-May-2005 08:08:19
Copyright (c) University of Cambridge 2004
Berkeley DB: Sleepycat Software: Berkeley DB 4.2.52: (December  3, 2003)
Support for: iconv() IPv6 GnuTLS
Lookups: lsearch wildlsearch nwildlsearch iplsearch cdb dbm dbmnz dsearch nis nis0 passwd
Authenticators: cram_md5 plaintext
Routers: accept dnslookup ipliteral manualroute queryprogram redirect
Transports: appendfile/maildir/mailstore autoreply lmtp pipe smtp
Fixed never_users: 0
Configuration file is /var/lib/exim4/config.autogenerated

-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (500, 'stable'), (1, 'experimental')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.14-1-k7
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)

Versions of packages exim4 depends on:
ii  exim4-base                    4.50-8     support files for all exim MTA (v4
ii  exim4-daemon-light            4.50-8     lightweight exim MTA (v4) daemon

exim4 recommends no packages.

-- no debconf information