'Twas brillig, and Colin Guthrie at 30/09/11 11:29 did gyre and gimble: > 'Twas brillig, and Tanu Kaskinen at 30/09/11 10:05 did gyre and gimble: >> On Fri, 2011-09-30 at 11:12 +0300, David Henningsson wrote: >>> Would it be possible to have some documentation, that would at least >>> explain the expected format of this fallback volume table? >> >> Good point. I'll write something. What would be the best location for >> the documentation - a text file, a wiki page or a comment in the code? >> I'd choose the text file, because I think such file format >> specifications should come with the code, but having it as a comment in >> the code would be too cumbersome to link to from the wiki etc. > > Does the file format accept comments? If so then perhaps just an > annotated example file with comments would suffice? > > If we need to link it from the wiki then a link to the cgit view would > be perfectly acceptable. OK, pushed now with a minor tweak to allow lines starting with ; to be comments too in order to maintain consistency with the other types of files we read (config files etc.) Col -- Colin Guthrie gmane(at)colin.guthr.ie http://colin.guthr.ie/ Day Job: Tribalogic Limited http://www.tribalogic.net/ Open Source: Mageia Contributor http://www.mageia.org/ PulseAudio Hacker http://www.pulseaudio.org/ Trac Hacker http://trac.edgewall.org/
