The difficulties of all sorts of special characters and "(custom) template syntax" have already been pointed out. Sophisticated formatting with HTML may be one option that is applicable in some cases, when bold and italic text makes it easier to spot the text that has to be replaced. But in many cases it can probably help to explicitly say what has to be replaced.
For example:
If your header is called example.h
, then you can include it with
#include <example.h>
Another example:
If you want to create a git tag named v1.4
, with a comment like this is my version 1.4
, then you can type
git tag -a v1.4 -m 'this is my version 1.4'
(Git is one example where this is notoriously difficult: There are names that are used by convention, but whenever something like origin
, master
or upstream
appears in a command, it's important to know that these might as well be called differently)
Re-stating what exactly has to be replaced could be done in addition to the formatting. Additionally, it allows to unpack any "template syntax" that has been used with an example:
You can copy a source file to a destination file with
cp <source> <destination>
For example, when your source file is path/to/source/file
and it should be copied to /path/to/destination/file
, then this can be done with
cp path/to/source/file /path/to/destination/file
cp <file1> <file2>
and kept in#include <headername.h>
.for
loopi
. :)cp C:\A/to/source/FILE1.TXT /C:\B/to/destination/FILE2.TXT
orcp <C:\A\FILE1.TXT> <C:\B\FILE2.TXT>
. If you introduce your pseudo-syntax to simplify things, then also explain it.