diff --git a/docs/source/interactive/magics.rst b/docs/source/interactive/magics.rst index 0cc1c4f..bb562f4 100644 --- a/docs/source/interactive/magics.rst +++ b/docs/source/interactive/magics.rst @@ -5,18 +5,18 @@ Built-in magic commands .. note:: To Jupyter users: Magics are specific to and provided by the IPython kernel. - Whether magics are available on a kernel is a decision that is made by + Whether Magics are available on a kernel is a decision that is made by the kernel developer on a per-kernel basis. To work properly, Magics must use a syntax element which is not valid in the underlying language. For - example, the IPython kernel uses the `%` syntax element for magics as `%` - is not a valid unary operator in Python. While, the syntax element has - meaning in other languages. + example, the IPython kernel uses the `%` syntax element for Magics as `%` + is not a valid unary operator in Python. However, `%` might have meaning in + other languages. -Here is the help auto generated from the docstrings of all the available magics +Here is the help auto-generated from the docstrings of all the available Magics function that IPython ships with. -You can create an register your own magics with IPython. You can find many user -defined magics on `PyPI `_. Feel free to publish your own and +You can create an register your own Magics with IPython. You can find many user +defined Magics on `PyPI `_. Feel free to publish your own and use the ``Framework :: IPython`` trove classifier.