• 
      

    Add fixes and improvements for intersphinx.

    Review Request #8955 — Created May 20, 2017 and submitted — Latest diff uploaded

    Information

    beanbag-docutils
    master
    64732d2...

    Reviewers

    Intersphinx is a handy way of referencing external documentation, but it
    has some limitations. Option directives cannot be looked up if using an
    intersphinx prefix or a program name, severely limiting their usefulness
    and reliability. It's also annoying to add a prefix to every reference
    in a file, if wanting to ensure a specific set of documentation is being
    used (like with release notes).

    This change introduces a new Sphinx extension that backports a fix
    targeting Sphinx 1.6.x for option references, ensuring that we can
    referencing them properly today.

    It also introduces a new directive for setting one or more specific
    intersphinx names that should be used for any unresolved references. No
    other intersphinx sets will be used when this is specified. This allows
    a page to ensure the proper sets of documentation are linked.

    Tested this with the RBTools release notes. Verified that all references
    worked properly.