GNU Mailutils Manual (split by node):   Section:   Chapter:FastBack: Programs   Up: Reading Mail   FastForward: Libraries   Contents: Table of ContentsIndex: Function Index

3.5.5.5 Controlling Header Display

To control which headers in the message should be displayed, mail keeps two lists: a retained header list and an ignored header list. If retained header list is not empty, only the header fields listed in it are displayed when printing the message. Otherwise, if ignored header list is not empty, only the headers not listed in this list are displayed. The uppercase variants of message-displaying commands can be used to print all the headers.

The following commands modify and display the contents of both lists.

discard [header-field-list]
di [header-field-list]
ignore [header-field-list]
ig [header-field-list]

Add header-field-list to the ignored list. When used without arguments, this command prints the contents of ignored list.

retain [header-field-list]
ret [header-field-list]

Add header-field-list to the retained list. When used without arguments, this command prints the contents of retained list.