rfctr: change param ref from asterisk to backticks

Sphinx handling is actually better, not only using italic but also a
mono-width font.

Author: scanny

docs/api/document.rst

@@ -50,68 +50,68 @@ if that behavior is desired.
 
    .. attribute:: author
 
-      *string* -- An entity primarily responsible for making the content of the
+      `string` -- An entity primarily responsible for making the content of the
       resource.
 
    .. attribute:: category
 
-      *string* -- A categorization of the content of this package. Example
+      `string` -- A categorization of the content of this package. Example
       values might include: Resume, Letter, Financial Forecast, Proposal,
       or Technical Presentation.
 
    .. attribute:: comments
 
-      *string* -- An account of the content of the resource.
+      `string` -- An account of the content of the resource.
 
    .. attribute:: content_status
 
-      *string* -- completion status of the document, e.g. 'draft'
+      `string` -- completion status of the document, e.g. 'draft'
 
    .. attribute:: created
 
-      *datetime* -- time of intial creation of the document
+      `datetime` -- time of intial creation of the document
 
    .. attribute:: identifier
 
-      *string* -- An unambiguous reference to the resource within a given
+      `string` -- An unambiguous reference to the resource within a given
       context, e.g. ISBN.
 
    .. attribute:: keywords
 
-      *string* -- descriptive words or short phrases likely to be used as
+      `string` -- descriptive words or short phrases likely to be used as
       search terms for this document
 
    .. attribute:: language
 
-      *string* -- language the document is written in
+      `string` -- language the document is written in
 
    .. attribute:: last_modified_by
 
-      *string* -- name or other identifier (such as email address) of person
+      `string` -- name or other identifier (such as email address) of person
       who last modified the document
 
    .. attribute:: last_printed
 
-      *datetime* -- time the document was last printed
+      `datetime` -- time the document was last printed
 
    .. attribute:: modified
 
-      *datetime* -- time the document was last modified
+      `datetime` -- time the document was last modified
 
    .. attribute:: revision
 
-      *int* -- number of this revision, incremented by Word each time the
+      `int` -- number of this revision, incremented by Word each time the
       document is saved. Note however |docx| does not automatically increment
       the revision number when it saves a document.
 
    .. attribute:: subject
 
-      *string* -- The topic of the content of the resource.
+      `string` -- The topic of the content of the resource.
 
    .. attribute:: title
 
-      *string* -- The name given to the resource.
+      `string` -- The name given to the resource.
 
    .. attribute:: version
 
-      *string* -- free-form version string
+      `string` -- free-form version string

docs/api/shared.rst

@@ -52,7 +52,7 @@ allowing values to be expressed in the units most appropriate to the context.
    :members:
    :undoc-members:
 
-   *r*, *g*, and *b* are each an integer in the range 0-255 inclusive. Using
+   `r`, `g`, and `b` are each an integer in the range 0-255 inclusive. Using
    the hexidecimal integer notation, e.g. `0x42` may enhance readability
    where hex RGB values are in use::
 

docs/dev/analysis/features/header.rst

@@ -10,15 +10,15 @@ a section title or page number. Such a header is also known as a running head.
 
 A page footer is analogous in every way to a page header except that it appears at the
 bottom of a page. It should not be confused with a footnote, which is not uniform
-between pages. For brevity's sake, the term *header* is often used here to refer to what
+between pages. For brevity's sake, the term `header` is often used here to refer to what
 may be either a header or footer object, trusting the reader to understand its
 applicability to both object types.
 
 In book-printed documents, where pages are printed on both sides, when opened, the front
-or *recto* side of each page appears to the right of the bound edge and the back or
-*verso* side of each page appears on the left. The first printed page receives the
+or `recto` side of each page appears to the right of the bound edge and the back or
+`verso` side of each page appears on the left. The first printed page receives the
 page-number "1", and is always a recto page. Because pages are numbered consecutively,
-each recto page receives an *odd* page number and each verso page receives an *even*
+each recto page receives an `odd` page number and each verso page receives an `even`
 page number.
 
 The header appearing on a recto page often differs from that on a verso page. Supporting

docs/dev/analysis/features/sections.rst

@@ -2,7 +2,7 @@
 Sections
 ========
 
-Word supports the notion of a *section*, having distinct page layout settings.
+Word supports the notion of a `section`, having distinct page layout settings.
 This is how, for example, a document can contain some pages in portrait layout
 and others in landscape. Section breaks are implemented completely differently
 from line, page, and column breaks. The former adds a ``<w:pPr><w:sectPr>``

docs/dev/analysis/features/shapes/index.rst

@@ -2,8 +2,8 @@
 Shapes (in general)
 ===================
 
-A graphical object that appears in a Word document is known as a *shape*.
-A shape can be *inline* or *floating*. An inline shape appears on a text
+A graphical object that appears in a Word document is known as a `shape`.
+A shape can be `inline` or `floating`. An inline shape appears on a text
 baseline as though it were a character glyph and affects the line height.
 A floating shape appears at an arbitrary location on the document and text may
 wrap around it. Several types of shape can be placed, including a picture, a

docs/dev/analysis/features/styles/character-style.rst

@@ -62,7 +62,7 @@ A baseline regular run::
     </w:r>
   </w:p>
 
-Adding *Emphasis* character style::
+Adding `Emphasis` character style::
 
   <w:p>
     <w:r>

docs/dev/analysis/features/styles/index.rst

@@ -11,7 +11,7 @@ Styles
    character-style
    latent-styles
 
-Word supports the definition of *styles* to allow a group of formatting
+Word supports the definition of `styles` to allow a group of formatting
 properties to be easily and consistently applied to a paragraph, run, table,
 or numbering scheme, all at once. The mechanism is similar to how Cascading
 Style Sheets (CSS) works with HTML.

docs/dev/analysis/features/styles/latent-styles.rst

@@ -132,7 +132,7 @@ The `w:latentStyles` element used in the default Word 2011 template::
 Latent style behavior
 ---------------------
 
-* A style has two categories of attribute, *behavioral* and *formatting*.
+* A style has two categories of attribute, `behavioral` and `formatting`.
   Behavioral attributes specify where and when the style should appear in the
   user interface. Behavioral attributes can be specified for latent styles
   using the ``<w:latentStyles>`` element and its ``<w:lsdException>`` child
@@ -157,14 +157,14 @@ Latent style behavior
   value is 0 if not specified.
 
 * **semiHidden**. The `semiHidden` attribute causes the style to be excluded
-  from the recommended list. The notion of *semi* in this context is that
+  from the recommended list. The notion of `semi` in this context is that
   while the style is hidden from the recommended list, it still appears in
   the "All Styles" list. This attribute is removed on first application of
   the style if an `unhideWhenUsed` attribute set |True| is also present.
 
 * **unhideWhenUsed**. The `unhideWhenUsed` attribute causes any `semiHidden`
   attribute to be removed when the style is first applied to content. Word
-  does *not* remove the `semiHidden` attribute just because there exists an
+  does `not` remove the `semiHidden` attribute just because there exists an
   object in the document having that style. The `unhideWhenUsed` attribute is
   not removed along with the `semiHidden` attribute when the style is
   applied.

docs/dev/analysis/features/styles/style.rst

@@ -16,7 +16,7 @@ There are six behavior properties:
 
 hidden
     Style operates to assign formatting properties, but does not appear in
-    the UI under any circumstances. Used for *internal* styles assigned by an
+    the UI under any circumstances. Used for `internal` styles assigned by an
     application that should not be under the control of an end-user.
 
 priority
@@ -98,10 +98,10 @@ semi-hidden
 -----------
 
 The `w:semiHidden` element specifies visibility of the style in the so-called
-*main* user interface. For Word, this means the style gallery and the
+`main` user interface. For Word, this means the style gallery and the
 recommended, styles-in-use, and in-current-document lists. The all-styles
 list and current-style dropdown in the styles pane would then be considered
-part of an *advanced* user interface.
+part of an `advanced` user interface.
 
 Behavior
 ~~~~~~~~

docs/dev/analysis/features/table/table-props.rst

@@ -23,7 +23,7 @@ a table::
 Autofit
 -------
 
-Word has two algorithms for laying out a table, *fixed-width* or *autofit*.
+Word has two algorithms for laying out a table, *fixed-width* or `autofit`.
 The default is autofit. Word will adjust column widths in an autofit table
 based on cell contents. A fixed-width table retains its column widths
 regardless of the contents. Either algorithm will adjust column widths