# Lines starting with # are ignored. # Lines can be continued on the next line using trailing backslash. # # Format: # %summary:: summary format # section:: element1[,element2]... # The literal text line to be added to Bugzilla comment. Can be empty. # (IOW: empty lines are NOT ignored!) # # Summary format is a line of text, where %element% is replaced by # text element's content, and [[...%element%...]] block is used only if # %element% exists. [[...]] blocks can nest. # # Sections can be: # - %summary: bug summary format string. # - %attach: a list of elements to attach. # - text, double colon (::) and the list of comma-separated elements. # Text can be empty (":: elem1, elem2, elem3" works), # in this case "Text:" header line will be omitted. # # Elements can be: # - problem directory element names, which get formatted as # : # or # : # : # : # : # - problem directory element names prefixed by "%bare_", # which is formatted as-is, without ":" and colons # - %oneline, %multiline, %text wildcards, which select all corresponding # elements for output or attachment # - %binary wildcard, valid only for %attach section, instructs to attach # binary elements # - problem directory element names prefixed by "-", # which excludes given element from all wildcards # # Nonexistent elements are silently ignored. # If none of elements exists, the section will not be created. # When we add a comment to an existing BZ, %summary is ignored # (it specifies *new bug* summary field): # %summary:: blah blah # When dup is detected, BZ reporter adds a comment to it. # This comment may interrupt an ongoing conversation in the BZ. # (Three people independently filed a bug against abrt about this). # Need to clearly explain what this comment is, to prevent confusion. # Hopefully, this line would suffice: Another user experienced a similar problem: # If user filled out comment field, show it: :: %bare_comment # var_log_messages has too much variance (time/date), # we exclude it from message so that dup message elimination has more chances to work :: \ -pkg_arch,-pkg_epoch,-pkg_name,-pkg_release,-pkg_version,\ -component,-architecture,\ -analyzer,-count,-duphash,-uuid,-abrt_version,\ -username,-hostname,-os_release,-os_info,\ -time,-pid,-pwd,-last_occurrence,-ureports_counter,\ -var_log_messages,\ %oneline