# HG changeset patch
# User Pierre-Yves David <pierre-yves.david@octobus.net>
# Date 1741689492 -3600
# Node ID fcd7cb10623df23ff4d03ec5ccfb4ee77bcb9b15
# Parent  6e1eb7212633b3af6feda2c06e8bc26253010aec
drawdag: add  documentation about special comment around files

The feature was not documented, so we start with documenting it before
extending it.

diff -r 6e1eb7212633 -r fcd7cb10623d tests/drawdag.py
--- a/tests/drawdag.py	Mon Mar 10 14:28:33 2025 +0100
+++ b/tests/drawdag.py	Tue Mar 11 11:38:12 2025 +0100
@@ -79,6 +79,19 @@
       # replace: A -> B -> C -> D  # chained 1 to 1 replacements
       # split: A -> B, C           # 1 to many
       # prune: A, B, C             # many to nothing
+
+Special comment can also be used to control file content for some revision.
+
+The example below create two extra files in A, update on in B.
+
+In all case the file matching the node name is created for all non-merge
+commit.
+
+    C # A/file/path=content in A
+    | # A/other/file/path=content for another file
+    B # B/file/path=updated content in B
+    | 
+    A
 """
 
 import collections