Re: Sample markup documentation file for a Tcl/Tk package

Hi,
what did you use to produce the HTML with? For TIP 700, I propose Pandoc
for now as we do not yet have our own Tcl library that is capable of all
the markdown constructs we would like to have.
Especially the `[string]{.optarg}` construct you mention is not possible
to render with e.g. the tcllib markdown module as it is a Pandoc
markdown syntax element.
If you need to render it with Pandoc, you have to specify the
corresponding CSS element (Pandoc translates `.optarg` into a CSS class)
which could look like this (untested):
optarg {
  font-style: italic;
  &:before {
    content: '?';
  }
  &:after {
    content: '?';
  }
}
Regards, Torsten