Merge pull request #1850 from Kodiologist/pyssed-off
Documentation tweaks for `py` and `pys`
This commit is contained in:
commit
c2a3f61ab2
@ -1448,8 +1448,6 @@ parameter will be returned.
|
||||
True
|
||||
|
||||
|
||||
.. _py-specialform:
|
||||
|
||||
of
|
||||
--
|
||||
|
||||
@ -1477,6 +1475,9 @@ For instance:
|
||||
|
||||
(of Callable [int str] str) ; => Callable[[int, str], str]
|
||||
|
||||
|
||||
.. _py-specialform:
|
||||
|
||||
py
|
||||
--
|
||||
|
||||
@ -1489,9 +1490,11 @@ expression is returned from the ``py`` form. ::
|
||||
(print "A result from Python:" (py "'hello' + 'world'"))
|
||||
|
||||
The code must be given as a single string literal, but you can still use
|
||||
macros, :ref:`eval`, and related tools to construct the ``py`` form. If you
|
||||
want to evaluate some Python code that's only defined at run-time, try the
|
||||
standard Python function :func:`eval`.
|
||||
macros, :ref:`eval-fn`, and related tools to construct the ``py`` form. If
|
||||
having to backslash-escape internal double quotes is getting you down, try a
|
||||
:ref:`bracket string <syntax-bracket-strings>`. If you want to evaluate some
|
||||
Python code that's only defined at run-time, try the standard Python function
|
||||
:func:`eval`.
|
||||
|
||||
Python code need not syntactically round-trip if you use ``hy2py`` on a Hy
|
||||
program that uses ``py`` or ``pys``. For example, comments will be removed.
|
||||
|
@ -37,6 +37,8 @@ Hy allows double-quoted strings (e.g., ``"hello"``), but not single-quoted
|
||||
strings like Python. The single-quote character ``'`` is reserved for
|
||||
preventing the evaluation of a form (e.g., ``'(+ 1 1)``), as in most Lisps.
|
||||
|
||||
.. _syntax-bracket-strings:
|
||||
|
||||
Python's so-called triple-quoted strings (e.g., ``'''hello'''`` and
|
||||
``"""hello"""``) aren't supported. However, in Hy, unlike Python, any string
|
||||
literal can contain newlines. Furthermore, Hy supports an alternative form of
|
||||
|
Loading…
Reference in New Issue
Block a user