Согласно справке, в комментариях поддерживается
встраиваемый код в одиночных кавычках
Увы, на практике используется не одинарная кавычка ('), а обратная кавычка (`). Итог - невозможность нормального оформления комментария, содержащего фрагменты MySQL-кода, где бэктики используются для обрамления имён.
Возможные варианты:
- Оставить обратную кавычку, поправить текст справки;
- Заменить обратную кавычку на одинарную кавычку;
- Использовать иное обрамление для форматирования кода, поправить текст справки.
Поскольку одинарные кавычки тоже используются во многих диалектах кода, наиболее разумным видится вариант 3. А в качестве обрамления кода я бы предложил удвоенную обратную кавычку (так же, как удвоенная звёздочка для полужирного шрифта) - по-моему, такое сочетание нигде не используется в качестве служебного или структурного, а если попадётся в литерале - вот это как раз можно и пережить.
SQL
в комментах?Tuple`2
всё работает, насколько я вижу.