diff -r acf39baa1c7d -r 993903fd4434 README.md
--- a/README.md	Tue May 12 18:17:39 2020 -0500
+++ b/README.md	Tue May 12 18:38:00 2020 -0500
@@ -7,12 +7,16 @@
 The present package complements texlab with richer syntax highlighting. The
 grammar is derived from LaTeX-Workshop, but has improvements including
 
-  a) Highlighting of `todonotes` (see below).
+  a) Highlighting for the `todonotes` package: `\todo` as well as custom-defined
+     `\XYtodo` for author initials `X` and `Y`.
 
   b) Footnote highlighting.
 
   c) Highlighting of `comment` environments as comment blocks.
 
+The highlighting of todo-notes and footnotes has to be specifically configured:
+see below.
+
 ### How to enable
 
 This package does not override the standard “LaTeX” grammar. It provides the
@@ -59,4 +63,12 @@
 },
 ```
 
+Initial-prefixed `\XYtodo` custom todonotes commands are also supported.
+For example, `\lstodo{a latex-syntax todo}` will be highlighted if you do
+the above colour customisations and in your LaTeX source define
+```tex
+\newcommand{\abtodo}[2][]{\todo[color=DarkRed!40,#1]{#2}}
+```
+(The colour setting here only affects LaTeX output, not VSCode.)
+
   [texlab]: https://marketplace.visualstudio.com/items?itemName=efoerster.texlab