[Gnu-arch-users] log headers

[Albert Reiner]

Hi,

in the ++log.category--branch--version--... file I get from `tla
make-log` there are header fields Summary and Keywords.

Sometimes I wonder whether these work like in e-mail headers, i.e.,

- whether I can continue a long entry on the next line, provided it
  starts with some leading whitespace;

- whether there needs to be an empty line between the last header
  field and the beginning of the regular text;

- and whether I can just add my own X-Something headers if I want (not
  that I would know right now what I might want it for).

Currently I leave an empty line, and I squeeze everything on a single
line per header.

Also, how do I access those fields?  The Summary I can get with `tla
revisions -s`.  What about the keywords?  And the full text of the log
entry?  And the X-Something header if it is allowed?

I suspect all this is documented somewhere, but I haven't found
anything.  Where should I have looked?  (BTW, I would prefer a simple
man page by far to the `tla command -H` system.)

Thanks for any pointers,

Albert.