index-range: metanorma/metanorma-bipm#67

author/topics/document-format/text.adoc

@@ -270,9 +270,11 @@ was to carry Excalibur (((Sword~A~, stem:[sqrt(2)], Excalibur))).
 --
 
 Metanorma supports index entries that involve ranges [added in https://github.com/metanorma/metanorma-standoc/releases/tag/v1.7.0],
-using the macro `index-range:to[(((...)))]`. The index entry range starts at the location of the 
-macro, as with `(((...)))`; the end of the range is the element with anchor `to`, and that is expected to be
-provided as a bookmark. The macro itself contains an Asciidoctor index entry.
+using the macro `index-range:to[...]`.
+The macro itself contains an Asciidoctor index entry, such as `+((...))+` or `+(((...)))+`.
+The index entry range starts at the location of the `index-range` macro, 
+in the same way as the index macro it contains; the end of the range is the element with the anchor `to`, 
+and that is expected to be provided as a bookmark. 
 
 [source,asciidoc]
 --
@@ -288,6 +290,9 @@ and so forth.[[end-range-1]]
 _Sic explicit fabula._[[end-range-2]]
 --
 
+The preceding example has a visible index entry for _**Arthur**_, ranging from the location of `+*Arthur*+`
+up to `end-range-1`, and a hidden index entry for _Sword~A~_, ranging from the location of `+Sword~A~+`
+up to `end-range-2`.
 
 Metanorma also supports "see" and "see also" crossreferences between
 index terms [added in https://github.com/metanorma/metanorma-standoc/releases/tag/v1.6.5],