Fossil

Help: suggested-downloads
Login

The "suggested-downloads" setting:

This setting controls the suggested tarball/ZIP downloads on the /download page. The value is a TCL list. Each set of four items defines a set of check-ins to be added to the suggestion list. The items in each group are:
    COUNT   TAG   MAX_AGE    COMMENT

COUNT is the number of check-ins to match, starting with the most recent and working bacwards in time. Check-ins match if they contain the tag TAG. If MAX_AGE is not an empty string, then it specifies the maximum age of any matching check-in. COMMENT is an optional comment for each match.

The special value of "OPEN-LEAF" for TAG matches any check-in that is an open leaf.

MAX_AGE is of the form "{AMT UNITS}" where AMT is a floating point value and UNITS is one of "seconds", "hours", "days", "weeks", "months", or "years". If MAX_AGE is an empty string then there is no age limit.

If COMMENT is not an empty string, then it is an additional comment added to the output description of the suggested download. The idea of COMMENT is to explain to the reader why a check-in is a suggested download.

Example:

       1   trunk     {}         {Latest Trunk Check-in}
       5   OPEN-LEAF {1 month}  {Active Branch}
       999 release   {1 year}   {Official Release}

The value causes the /download page to show the union of the most recent trunk check-in of any age, the five most recent open leaves within the past month, and essentially all releases within the past year. If the same check-in matches more than one rule, the COMMENT of the first match is used.