
header_display_format
---------------------

   Usage: header_display_format number format-string

   This command can be used to customize the way article headers are
   presented in the header overview in article mode. You can specify up
   to 10 different formats and switch among them using
   toggle_header_formats (default binding: ESC a). This command may
   also be used with a prefix argument to select a particular format,
   e.g., ESC 0 ESC a will select the 0th format.

   Here are slrn's default settings:
        header_display_format 0 "%F%-5S%G%-5l:[%12r]%t%s"
        header_display_format 1 "%F%G%-5l:[%12r]%t%s"
        header_display_format 2 "%F%-5l:%t%s"
        header_display_format 3 "%F%-5S%-5l:%t%50s %r"
        header_display_format 4 "%F%-5S [%10r]:%t%49s %-19g[%17d]"

   number is the number of the format (0-9).

   format-string is a string containing printf(3) style % escapes. This
   is the generic format:
        %[[-*]w]x

   The brackets indicate optional items: w may consist of one or more
   digits and specifies the width of the field. In fields with a fixed
   width, the minus sign (-) can be used to right justify an item, the
   asterisk (*) to center justify it. Please note that these modifiers
   have no effect if the text does not fit into the field.

   The item specifier (x) is required and, depending on its value, has
   the following meaning:

         %   percent character
         C   prints `C' if current thread is collapsed
         D   date (as defined by overview_date_format)
         F   flags (read/unread, `*' and `#' tags, header number)
         G   GroupLens score
         P   prints `P' if current article has a parent (inside threads)
         S   score
         T   thread tree
         b   article size (numer of bytes)
         c   number of messages in current subthread
         d   date
         f   from header
         l   article length (number of lines)
         n   server number
         r   author's real name
         s   subject
         t   number of messages in thread plus tree

   Additionally, the special format descriptor %Xg can be used. It is not
   substituted by text, but specifies that the next write on the screen
   should take place in column X (numbered from 0). If X is negative, the
   cursor is placed X columns from the right edge of the window.

   Thus, "%F%-5l:%t%s%-20g %r" indicates that the header window will
   contain (in that order): the flags, the number of lines the article
   contains (right justified in a 5 character field), a `:', the tree,
   the subject, and, beginning 20 columns from the right edge of the
   window and separated by a blank, the author's real name.

   A %? construct can be used to print a string only if one of the above
   descriptors expands to a non-zero string (i.e. one that is not empty
   and does not contain only a single whitespace or the number `0'). It
   has the following syntax:

         %?<descriptor>?<optional string>?
         %?<descriptor>?<string if true>&<string if false>?

   You can use escape sequences in optional strings; however, it is not
   possible to nest them, nor to have literal `?' or `&' characters in
   them.

   Example: If you want to display the number of messages for collapsed
   threads and the number of lines in the message otherwise, you can use
   the following:

         %?C?%-3c&%-3l?

   Note: The descriptors %t and %T write directly to the screen, so they
   cannot be ``tested'' with the %? operator and ignore the requested
   field width (i.e. "%10t" is the same as "%t"; the ``10'' is ignored).
   The descriptor %t is included for backwards compatibility and
   equivalent to "%?C?%-3c&   ? %T".

   See also: group_display_format, overview_date_format

-- 
(C) Matthias Friedrich <mafr@topmail.de> and Thomas Schultz <tststs@gmx.de>.
The complete manual can be found at <htp://slrn.sourceforge.net/manual/>.
