The document states this is temporary. The feature isn't even in the main systemd code yet, but is on a separate branch. They're avoiding specifying a format until they're sure that it's nailed down, does what they need, doesn't have some unforseen problem that could only be found through widespread testing, etc.
Once it's a stable feature, expect the format to be documented. Until then, the documentation is available in the .c files for anyone who has some need to avoid the provided library interface.
Posted Nov 18, 2011 21:57 UTC (Fri) by mathstuf (subscriber, #69389)
[Link]
> They're avoiding specifying a format until they're sure that it's nailed down, does what they need, doesn't have some unforseen problem that could only be found through widespread testing, etc.
This is understandable, even appreciated. Having multiple minor versions of varying usefulness indefinitely supported just because they existed for a commit or two during the inital format designs would be crazy to expect.
> Once it's a stable feature, expect the format to be documented.
FTA:
> At this point we have no intention to standardize the format . We might document the on-disk format eventually
This is not a strong a guarantee as I'd like for this and certainly not something that would range a high level of expectancy from me. Before it becomes default in a major distribution, I'd like to see a format specification.