text-crossrefs: Document an expected error with sample-with-options.md

text-crossrefs/sample-with-options.md

@@ -52,6 +52,10 @@ Here are some precisions.[^2]
 
 [And this one is labelized at the end.]{#lblatend refanchor=end}
 
+<!-- Because of tcrf-default-reftype: note, the following line produces
+a reference to a void note label (since lblatend is not attached to a note)
+in formats that do not support the “line” reference type.
+This will make the Typst output with #ref uncompilable. -->
 What if you want to refer to the last line, i.e. [lblatend]{.tcrf reftype=line}?
 
 See [doubledlbl-beg->doubledlbl-end]{.tcrf  reftype="page"}.

text-crossrefs/test/sample-context-with-options.native

@@ -444,6 +444,9 @@
         , Span ( "lblatend" , [] , [] ) []
         ]
     ]
+, RawBlock
+    (Format "html")
+    "<!-- Because of tcrf-default-reftype: note, the following line produces\na reference to a void note label (since lblatend is not attached to a note)\nin formats that do not support the \8220line\8221 reference type.\nThis will make the Typst output with #ref uncompilable. -->"
 , Para
     [ Str "What"
     , Space

text-crossrefs/test/sample-latex-with-options.native

@@ -441,6 +441,9 @@
         , Span ( "lblatend" , [] , [] ) []
         ]
     ]
+, RawBlock
+    (Format "html")
+    "<!-- Because of tcrf-default-reftype: note, the following line produces\na reference to a void note label (since lblatend is not attached to a note)\nin formats that do not support the \8220line\8221 reference type.\nThis will make the Typst output with #ref uncompilable. -->"
 , Para
     [ Str "What"
     , Space

text-crossrefs/test/sample-opendocument-with-options.native

@@ -446,6 +446,9 @@
         , Span ( "lblatend" , [] , [] ) []
         ]
     ]
+, RawBlock
+    (Format "html")
+    "<!-- Because of tcrf-default-reftype: note, the following line produces\na reference to a void note label (since lblatend is not attached to a note)\nin formats that do not support the \8220line\8221 reference type.\nThis will make the Typst output with #ref uncompilable. -->"
 , Para
     [ Str "What"
     , Space

text-crossrefs/test/sample-typst-with-options.native

@@ -446,6 +446,9 @@
         , Span ( "lblatend" , [] , [] ) []
         ]
     ]
+, RawBlock
+    (Format "html")
+    "<!-- Because of tcrf-default-reftype: note, the following line produces\na reference to a void note label (since lblatend is not attached to a note)\nin formats that do not support the \8220line\8221 reference type.\nThis will make the Typst output with #ref uncompilable. -->"
 , Para
     [ Str "What"
     , Space