yahoo-eng-team team mailing list archive

[Brian Rosmaita <rosmaita.fossdev@xxxxxxxxx>]

Looks like this was fixed a different way by Change-Id:
Ie29e71f0394a432c255804b0d549aba56d1d5a1d

https://review.openstack.org/#/c/549180/

** Changed in: glance
     Assignee: Sana Khan (sana.khan) => (unassigned)

** Changed in: glance
       Status: Triaged => Fix Released

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to Glance.
https://bugs.launchpad.net/bugs/1743040

Title:
  incorrect ReST markup in CLI documentation

Status in Glance:
  Fix Released

Bug description:
  This applies to the files in doc/source/cli

  The options are marked up as a definition list, with the options in
  bold, for example:

    **-o, --option**
      This is an option.

    **-a, --another**
      This is another option.

  This is a problem because when the document is rendered into HTML by
  Sphinx, '--' is converted into a single character, 0x2013 (en dash)
  instead of remaining as two consecutive hyphens.  This is confusing to
  readers.

  The options should instead be marked up as an option list:

    -o, --option  This is an option.
    -a, --another  This is another option.

  There must be at least 2 spaces between the option and the
  description.  The options will be rendered in monospace font and the
  two hyphens are preserved.

  See http://docutils.sourceforge.net/docs/user/rst/quickref.html
  #option-lists

To manage notifications about this bug go to:
https://bugs.launchpad.net/glance/+bug/1743040/+subscriptions