Mercurial > docs > master

comparison ch03.roff @ 84:c35ec2b7de5d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
style: New macros .Ar (argument) and .Hd (header field)
author markus schnalke <meillo@marmaro.de>
date Wed, 06 Jun 2012 18:27:28 +0200
parents ff4537327162
children fb0d1b4c8fb1
comparison
equal deleted inserted replaced
83:99ab58dc891f 84:c35ec2b7de5d
773 .P 773 .P
774 The 774 The
775 .I draft_from 775 .I draft_from
776 masquerading type instructed 776 masquerading type instructed
777 .Pn post 777 .Pn post
778 to use the value of the `From:' header as SMTP envelope sender. 778 to use the value of the
779 .Hd From
780 header field as SMTP envelope sender.
779 Sender addresses could be replaced completely. 781 Sender addresses could be replaced completely.
780 .Ci b14ea6073f77b4359aaf3fddd0e105989db9 782 .Ci b14ea6073f77b4359aaf3fddd0e105989db9
781 Mmh offers a kind of masquerading similar in effect, but 783 Mmh offers a kind of masquerading similar in effect, but
782 with technical differences. 784 with technical differences.
783 As mmh does not transfer messages itself, the local MTA has final control 785 As mmh does not transfer messages itself, the local MTA has final control
784 over the sender's address. Any masquerading mmh introduces may be reverted 786 over the sender's address. Any masquerading mmh introduces may be reverted
785 by the MTA. 787 by the MTA.
786 In times of pedantic spam checking, an MTA will take care to use 788 In times of pedantic spam checking, an MTA will take care to use
787 sensible envelope sender addresses to keep its own reputation up. 789 sensible envelope sender addresses to keep its own reputation up.
788 Nonetheless, the MUA can set the `From:' header and thereby propose 790 Nonetheless, the MUA can set the
791 .Hd From
792 header field and thereby propose
789 a sender address to the MTA. 793 a sender address to the MTA.
790 The MTA may then decide to take that one or generate the canonical sender 794 The MTA may then decide to take that one or generate the canonical sender
791 address for use as envelope sender address. 795 address for use as envelope sender address.
792 .P 796 .P
793 In mmh, the MTA will always extract the recipient and sender from the 797 In mmh, the MTA will always extract the recipient and sender from the
794 message headers (\c 798 message header (\c
795 .Pn sendmail 's 799 .Pn sendmail 's
796 .Sw -t 800 .Sw -t
797 switch). 801 switch).
798 The `From:' header of the draft may be set arbitrary by the user. 802 The
803 .Hd From
804 header field of the draft may be set arbitrary by the user.
799 If it is missing, the canonical sender address will be generated by the MTA. 805 If it is missing, the canonical sender address will be generated by the MTA.
800 806
801 .U3 "Remaining Options 807 .U3 "Remaining Options
802 .P 808 .P
803 Two configure options remain in mmh. 809 Two configure options remain in mmh.
923 .Sw -nomoreproc 929 .Sw -nomoreproc
924 at the command line statically, too. 930 at the command line statically, too.
925 931
926 .U2 "Removed support for header fields 932 .U2 "Removed support for header fields
927 .P 933 .P
928 The `Encrypted' header had been introduced by RFC\^822, but already 934 The
935 .Hd Encrypted
936 header field had been introduced by RFC\^822, but already
929 marked legacy in RFC 2822. It was superseded by FIXME. 937 marked legacy in RFC 2822. It was superseded by FIXME.
930 Mmh does no more support this header. 938 Mmh does no more support this header field.
931 .P 939 .P
932 Native support for `Face' headers 940 Native support for
933 had been removed, as well. 941 .Hd Face
934 The feature is similar to the `X-Face' header in its intent, 942 header fields had been removed, as well.
943 The feature is similar to the
944 .Hd X-Face
945 header field in its intent,
935 but takes a different approach to store the image. 946 but takes a different approach to store the image.
936 Instead of encoding the image data directly into the header, 947 Instead of encoding the image data directly into the header field,
937 the the header contains the hostname and UDP port where the image 948 the it contains the hostname and UDP port where the image
938 date could be retrieved. 949 date could be retrieved.
939 Neither `X-Face' nor the here described `Face' system 950 Neither
951 .Hd X-Face
952 nor the here described
953 .Hd Face
954 system
940 \** 955 \**
941 .FS 956 .FS
942 There is also a newer but different system, invented 2005, 957 There is also a newer but different system, invented 2005,
943 using `Face' headers. 958 using
944 It is the successor of `X-Face' providing colored PNG images. 959 .Hd Face
960 headers.
961 It is the successor of
962 .Hd X-Face
963 providing colored PNG images.
945 .FE 964 .FE
946 became well used in the large scale. 965 became well used in the large scale.
947 It's still possible to use a Face systems, 966 It's still possible to use a Face systems,
948 although mmh does not provide support for any of the different systems 967 although mmh does not provide support for any of the different systems
949 anymore. It's fairly easy to write a small shell script to 968 anymore. It's fairly easy to write a small shell script to
950 extract the embedded or fetch the external Face data and display the image. 969 extract the embedded or fetch the external Face data and display the image.
951 Own Face headers can be added into the draft template files. 970 Own
952 .P 971 .Hd Face
953 `Content-MD5' headers were introduced by RFC\^1864. They provide only 972 header field can be added into the draft template files.
973 .P
974 .Hd Content-MD5
975 header fields were introduced by RFC\^1864. They provide only
954 a verification of data corruption during the transfer. By no means can 976 a verification of data corruption during the transfer. By no means can
955 they ensure verbatim end-to-end delivery of the contents. This is clearly 977 they ensure verbatim end-to-end delivery of the contents. This is clearly
956 stated in the RFC. The proper approach to provide verificationability 978 stated in the RFC. The proper approach to provide verificationability
957 of content in an end-to-end relationship is the use of digital cryptography 979 of content in an end-to-end relationship is the use of digital cryptography
958 (RFCs FIXME). On the other hand, transfer protocols should ensure the 980 (RFCs FIXME). On the other hand, transfer protocols should ensure the
959 integrity of the transmission. In combinations these two approaches 981 integrity of the transmission. In combinations these two approaches
960 make the `Content-MD5' header field useless. In consequence, I removed 982 make the
983 .Hd Content-MD5
984 header field useless. In consequence, I removed
961 the support for it. By this removal, MD5 computation is not needed 985 the support for it. By this removal, MD5 computation is not needed
962 anywhere in mmh. Hence, over 500 lines of code were removed by this one 986 anywhere in mmh. Hence, over 500 lines of code were removed by this one
963 change. Even if the `Content-MD5' header field is useful sometimes, 987 change. Even if the
988 .Hd Content-MD5
989 header field is useful sometimes,
964 I value its usefulnes less than the improvement in maintainability, caused 990 I value its usefulnes less than the improvement in maintainability, caused
965 by the removal. 991 by the removal.
966 992
967 .U2 "Prompter's Control Keys 993 .U2 "Prompter's Control Keys
968 .P 994 .P
978 .Pn mailx . 1004 .Pn mailx .
979 Apparently, 1005 Apparently,
980 .Pn prompter 1006 .Pn prompter
981 hadn't been touched lately. Otherwise it's hardly explainable why it 1007 hadn't been touched lately. Otherwise it's hardly explainable why it
982 still offered the switches 1008 still offered the switches
983 .Sw "-erase \f(CIchr\fP 1009 .Sw -erase
984 and 1010 .Ar chr
985 .Sw "-kill \f(CIchr\fP 1011 and
1012 .Sw -kill
1013 .Ar chr
986 to name the characters for command line editing. 1014 to name the characters for command line editing.
987 The times when this had been necessary are long time gone. 1015 The times when this had been necessary are long time gone.
988 Today these things work out-of-the-box, and if not, are configured 1016 Today these things work out-of-the-box, and if not, are configured
989 with the standard tool 1017 with the standard tool
990 .Pn stty . 1018 .Pn stty .