Skip to content

Change filename to :file:filename throughout - #458

Merged
theacodes merged 3 commits into
pypa:masterfrom
9999years:master
Mar 18, 2018
Merged

Change filename to :file:filename throughout#458
theacodes merged 3 commits into
pypa:masterfrom
9999years:master

Conversation

@9999years

Copy link
Copy Markdown

Changes filenames written with code backticks to use the Sphinx file directive; ultimately, it renders the same.

This PR changes no text, only formatting.

Rebecca Turner added 3 commits March 17, 2018 20:47
With [PEP
566](https://www.python.org/dev/peps/pep-0566/#description-content-type-optional), the `long_description` can be Markdown with the `long_description_content_type` arg. This adds documentation for it

There were also a couple cases where filenames were enclosed with quotes
rather than as code; I've changed those to be `code` as well for
consistency.

See also:

 * [Relevant section in PEP 566](https://www.python.org/dev/peps/pep-0566/#description-content-type-optional)
 * [The CommonMark specification](http://spec.commonmark.org)
 * [The Description-Content-Type field documentation in the Python
   packaging documentation](https://packaging.python.org/specifications/core-metadata/#description-content-type-optional)
Changes filenames written with code backticks to use the Sphinx [file
directive](http://www.sphinx-doc.org/en/stable/markup/inline.html#role-file);
it renders the same but it's more semantic now.
@theacodes
theacodes merged commit 3f97bec into pypa:master Mar 18, 2018
@theacodes

Copy link
Copy Markdown
Member

Thanks again, @9999years!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants