llvm dev - Aug 2016 - Using isonum.txt substitutions in reST documents?

I'd like to use one of the special marks (the circle-R registered
trademark symbol) on a webpage that's coded in .rst format.  On an
HTML page I'd use ® but I'm less comfortable with reST.  It
looks like I'd need to add
  .. include:: isonum.txt
and then I could use the |reg| substitution in the body text.

Would that work?  Would anybody mind?  I'd naively expect that
whatever process converts the .rst to HTML has isonum.txt, but I
don't actually know how that works.
Thanks,
--paulr

"Robinson, Paul via llvm-dev" <llvm-dev at lists.llvm.org>
writes:
> I'd like to use one of the special marks (the circle-R registered
> trademark symbol) on a webpage that's coded in .rst format.  On an
> HTML page I'd use &reg; but I'm less comfortable with reST.  It
> looks like I'd need to add
>   .. include:: isonum.txt
> and then I could use the |reg| substitution in the body text.
>
> Would that work?  Would anybody mind?  I'd naively expect that
> whatever process converts the .rst to HTML has isonum.txt, but I
> don't actually know how that works.
Yes, this seems fine, though the include is spelled like:

  .. include:: <isonum.txt>

The RST docs that describe this, for reference:

  http://docutils.sourceforge.net/docs/ref/rst/definitions.html

> > I'd like to use one of the special marks (the circle-R registered
> > trademark symbol) on a webpage that's coded in .rst format.  On an
> > HTML page I'd use ® but I'm less comfortable with
reST.  It
> > looks like I'd need to add
> >   .. include:: isonum.txt
> > and then I could use the |reg| substitution in the body text.
> >
> > Would that work?  Would anybody mind?  I'd naively expect that
> > whatever process converts the .rst to HTML has isonum.txt, but I
> > don't actually know how that works.
> 
> Yes, this seems fine, though the include is spelled like:
> 
>   .. include:: <isonum.txt>
> 
> The RST docs that describe this, for reference:
> 
>   http://docutils.sourceforge.net/docs/ref/rst/definitions.html
>
Oh, and that shows how to not have an intervening space too!
Excellent.  Thanks Justin!

If r278710 doesn't look right, or causes a problem, let me know.
--paulr