Update text-based metadata header: "/* TSDL" is sufficient

[ctf.git] / common-trace-format-specification.txt

diff --git a/common-trace-format-specification.txt b/common-trace-format-specification.txt
index 19194c840c706db912caf72185403f2c5345b7cd..da33bf30abed49ca3b7f7bb33be3aba027253125 100644 (file)
--- a/common-trace-format-specification.txt
+++ b/common-trace-format-specification.txt
@@ -935,12 +935,14 @@ tracer.
 
 The text-only meta-data file is a plain-text TSDL description. This file
 must begin with the following characters to identify the file as a CTF
-TSDL text-based metadata file:
+TSDL text-based metadata file (without the double-quotes) :
 
-/* TSDL */
+"/* TSDL"
 
 These characters allow automated discovery of file type. They are
-interpreted as a comment by the TSDL metadata parser.
+interpreted as a the beginning of a comment by the TSDL metadata parser.
+The comment can be continued to contain extra commented characters
+before it is closed.
 
 The packet-based meta-data is made of "meta-data packets", which each
 start with a meta-data packet header. The packet-based meta-data