Bug 76814

sendmail.mc could use a few more comments, and some organization to make it less
cryptic.  Simply saying RTFM doesn't help when you are specifying something
undocumented (like specific parameters).  Also, there are redundancies and
useless statments that should(?) be removed.

Examples:

The last line of /etc/mail/sendmail.mc is
  Cwlocalhost.localdomain
which is all fine and dandy, but isn't explained.

The "proper" way to add to the w class is with the more descriptive macro
  dnl Mail sent to the loopback interface's FQDN should be delivered to this machine
  LOCAL_DOMAIN(`localhost.localdomain')dnl

Of course this is completely unnecessary since localhost.localdomain is ALSO
defined by default in /etc/mail/local-host-names.  Pick one or the other. You
don't need both.

The there is
  undefine(`UUCP_RELAY')dnl
  undefine(`BITNET_RELAY')dnl
again, fine and dandy, but superfluous since they aren't defined by default
anyways.  Perhaps what was meant is
  dnl Remove the "dnl " at the beginning of the respective line if you need these
  dnl define(`UUCP_RELAY')dnl
  dnl define(`BITNET_RELAY')dnl
Though anyone setting up UUCP and BITNET relay (whoa, that brings back memories)
should be able to RTFM.

And since the #1 question asked is, "Why does my mail show up as comming from
user.com instead of user?"
  dnl All mail from this host should appear to be sent from mydomain.com
  dnl MASQUERADE_AS(`mydomain.com')dnl
Of course the Mozilla users won't have noticed this.

The first thing I always do is:
  cd /etc/mail
  ln -s ../../usr/share/doc/sendmail/doc/ops/ops.ps .
  ln -s ../../usr/share/doc/sendmail/doc/ops/ops.me .
Though how many people know how to read the *.me?
  nroff -me ../../usr/share/doc/sendmail/doc/ops/ops.me op.man
Even stuffing the *.man in the docs directory whould be enough.

Well, you get the idea by now I hope.  Something to consider for 9.0 :)