Michal Privoznik bdd3dfba15 docs: Format @variable properly
When documenting our public API in some places we use '@' to
refer to the variable. For instance:

 * This API tries to set guest time to the given value. The time
 * to set (@seconds and @nseconds) should be in seconds relative
 * to the Epoch of 1970-01-01 00:00:00 in UTC.

However, when generating HTML documentation these tokens are
copied verbatim. What we can do is drop the '@' character and
wrap the variable in <code/> so that it is formatted properly.

Due to the way we 'parse' docs a token might actually be slightly
more than just '@variable'. For instance in the example above we
will have the following tokens: '(@seconds' and '@nseconds)'.
Thus we need to handle possible substring before and after
variable.

Signed-off-by: Michal Privoznik <mprivozn@redhat.com>
Reviewed-by: Ján Tomko <jtomko@redhat.com>
2021-09-15 08:37:40 +02:00
..
2021-09-09 17:53:18 +02:00
2021-09-14 14:25:56 -05:00
2021-03-15 17:31:35 +01:00
2021-03-15 17:31:35 +01:00
2021-06-07 08:05:59 -06:00
2021-09-13 12:45:17 +02:00
2021-09-15 08:37:40 +02:00
2021-04-15 15:42:21 +02:00