On 3/22/2010 21:53, Eric Kow wrote:
On Mon, Mar 22, 2010 at 14:02:57 -0400, Max Battcher wrote:
%YAML 1.2
---
Encoding: UTF-8
Patch version: 2.0+YAML
X-Musdex version: 10.03.22
...
So that's my current suggestion. Feel free to tear it apart.
My only remark is that we'd probably want to make sure we weren't
interfering with other tools making use of the long patch comments.
Indeed. However, Ignore-this had the same problem, at least initially.
I think I pointed out that YAML headers should be reasonably easy to
skip for most tools.
If some tool was already currently, in the wild, using YAML-formatted
long comments, such a tool could adapt to using the second and later
documents in the comment. It seems doubtful to me that there are any
current tools that use YAML, though.
The complication may be that darcs itself might be confused by existing
YAML documents in comments. If such things exist, and if they use an
explicit header, and if those documents' top level data structure is a
mapping (key: value), then there is a possibility of conflict. At which
point we could discuss insuring that the header keys that darcs uses are
things unlikely to be used by such imaginary strawman tools.
--
--Max Battcher--
http://worldmaker.net
_______________________________________________
darcs-users mailing list
[email protected]
http://lists.osuosl.org/mailman/listinfo/darcs-users
