4.5.2.1 Log Message Elements

Patcher has the ability to initialize the log message with different elements. These elements are specified with the :log-message-items project option. Its value is either nil, meaning that you don't want any initialization, or a list of symbols specifying the elements you desire. The available items are:

subject

The subject of the message. The subject's prefix is automatically removed.

compressed-change-logs

The “compressed” ChangeLog entries. Only the most important part of the ChangeLogs is preserved, so the entries appear in a more compact fashion.

change-logs

The raw ChangeLog entries.

By default, only the message's subject is used. When using more than one item, they appear in the order specified above. If anything appears before the raw ChangeLog entries, a separator string is used. This string is specified by the :change-logs-separator project option. By default the string looks like “— ChangeLog entries follow: —”.

Note that it only makes sense to set :log-message-items to nil if you also ask Patcher to let you edit the message (see Log Message Editing). Otherwise, your commit would end up with empty log messages.