Commit Graph

557 Commits

Author SHA1 Message Date
Ryan Gonzalez
2f86801a14 Add documentation for annotations and of 2019-10-08 09:52:22 -05:00
Ryan Gonzalez
06213cd46c Remove some trailing whitespace from docs 2019-10-08 09:40:15 -05:00
Kodi Arfer
8351ccf9d9 Allow inline Python 2019-09-17 12:04:03 -04:00
Kodi Arfer
80771ac99c Remove documentation of print in api.rst
There is no longer any such special form. We just use Python 3's built-in function.
2019-09-17 12:04:03 -04:00
Kodi Arfer
f227f689d9 Advertise our Stack Overflow tag 2019-09-11 10:24:03 -04:00
Kodi Arfer
6c93fc6ff1 Overhaul introductory documentation
- Removed links to non-updated code and badges.
- Compressed `quickstart.rst` into a few sentences at the very start of the docs.
- Added a "Why Hy?" chapter discussing Hy's features and comparing Hy to Python and other Lisps.
- Rewrote the tutorial to be more accessible to non-Python programmers and to be greater in breadth but lesser in depth.
- Cut down on the self-congratulatory manic tone and exclamation points, while keeping the jokes I liked best.
2019-08-19 14:00:53 -04:00
Kodi Arfer
1e77f38d10 Expand the documentation of setv 2019-08-19 13:53:48 -04:00
Kodi Arfer
627455a336 Add some documentation anchors 2019-08-19 13:53:48 -04:00
Kodi Arfer
e5461f171c Update NEWS and documentation 2019-08-18 09:45:40 -04:00
lsusr
6929973d0d Fixed broken link to Graphviz 2019-08-17 00:39:04 -07:00
Kodi Arfer
0fcf570a3f Document await 2019-07-18 10:43:01 -04:00
Kodi Arfer
8b101d1214 Update documentation 2019-07-17 14:34:31 -04:00
Aaron Schumacher
d547610adb
typo: missing "a" 2019-06-25 11:52:33 -04:00
Kodi Arfer
704983ed44 Clean up coreteam.rst 2019-06-10 15:24:48 -04:00
Kodi Arfer
9914e9010c Update the docs for removing Python 2 support
Some of the example output may still be from Python 2.
2019-06-04 14:01:59 -04:00
Krystian Rosiński
0fd02bf52b Fix a typo in a tutorial example 2019-05-27 18:49:52 +02:00
Kodi Arfer
e77ce92635 Simplify gensym format 2019-04-29 08:10:51 -04:00
Kodi Arfer
6c74cf1f07 Add setx for assignment expressions 2019-04-23 15:35:12 -04:00
Kodi Arfer
7b3ef423c1 Use html.escape instead of cgi.escape
cgi.escape is gone as of Python 3.8.
2019-04-23 15:35:12 -04:00
Tristan Cacqueray
d793cee90a add tuple? function hy.core
`tuple?` will test if the argument is an instance of tuple.
2019-04-23 15:25:49 -04:00
Tristan Cacqueray
b0ed103931 add list? function to hy.core
`list?` will test if the argument is an instance of list.
2019-04-09 00:07:10 +00:00
Tristan Cacqueray
920057c621 Fix typo for HyList model name in the language internal doc 2019-03-26 01:48:13 +00:00
Kodi Arfer
30fc1425c1 Update docs and README 2019-03-17 18:40:37 -04:00
Tristan Cacqueray
5d7b069ecb Add collections indexes and slices tutorial
This change adds to the tutorial the hy way of accessing array.
2019-03-13 03:50:06 +00:00
Kodi Arfer
83e56de0c5 Document format strings 2019-02-27 12:05:19 -05:00
digikar99
d312dd5df2 Fix a ReST underline 2019-02-20 12:47:27 -05:00
digikar99
247e64950d Clean up the documentation of defclass 2019-02-20 12:47:25 -05:00
Brandon T. Willard
e468d5f081 Refactor REPL error handling and filter Hy internal trace output
These changes make the Hy REPL more closely follow `code.InteractiveConsole`'s
class interface and provide minimally intrusive traceback print-out filtering
via a context manager that temporarily alters `sys.excepthook`.  In other words,
exception messages from the REPL will no longer show Hy internal
code (e.g. importer, compiler and parsing functions).

The boolean variable `hy.errors._hy_filter_internal_errors` dynamically
enables/disables trace filtering, and the env variable
`HY_FILTER_INTERNAL_ERRORS` can be used as the initial value.
2019-02-07 13:43:58 -05:00
edouardklein
7d72e2fe74 Correct documentation of earmuff behavior
Another piece of fix #1714
2019-02-05 13:20:20 -05:00
Eli
e4fd74af1b Clarifying &optional documentation (fixes #1722) 2019-01-20 17:11:52 -05:00
Eli
3d2be62d4b Add synonyms for argument unpacking, for text-search purposes 2019-01-19 13:33:54 -05:00
Kodi Arfer
70747a58c3 Fix an example in interop.rst 2018-12-29 19:57:18 -05:00
Brandon T. Willard
690416b3d6 Update description of eval in core.rst 2018-11-28 17:08:10 -06:00
Brandon T. Willard
87a5b117a1 Implement new importer using PEP-302 semantics
Python 3.x is patched in a way that integrates `.hy` source files into
Pythons default `importlib` machinery.  In Python 2.7, a PEP-302 "importer"
and "loader" is implemented according to the standard `import` logic (via
`pkgutil` and later pure-Python `imp` package code).

In both cases, the entry-point for the loaders is through `sys.path_hooks` only.
As well, the import semantics have been updated all throughout to utilize
`importlib` and follow aspects of PEP-420.  This, along with some light
patches, should allow for basic use of `runpy`, `py_compile` and `reload`.

In all cases, if a `.hy` file is shadowed by a `.py`, Hy will silently use
`.hy`.
2018-08-25 22:50:38 -05:00
Kodi Arfer
45e99d027d Fix an intersphinx link 2018-07-24 09:31:36 -07:00
Kodi Arfer
1d2c73165d Make HyKeyword callable
Co-authored-by: Simon Gomizelj <simon@vodik.xyz>
2018-07-24 09:19:37 -07:00
Kodi Arfer
e05af9d7e0 Document function docstrings 2018-07-11 11:59:46 -07:00
Kodi Arfer
9859b0085c Document the required order of &-parameters 2018-07-11 11:36:32 -07:00
Kodi Arfer
9cc90362d0 Docs: string literal prefixes must be in lowercase 2018-07-11 11:24:19 -07:00
Kodi Arfer
da754c0e5d Update NEWS and docs for the new comprehensions 2018-06-13 17:31:08 -07:00
Kodi Arfer
8296a36e12 Add tests and docs for model patterns 2018-05-28 16:15:47 -07:00
Kodi Arfer
38fdcc2114 Don't let HySymbol inherit from HyString 2018-05-20 14:11:35 -07:00
Philip Xu
8a83d0c1ea Fixes #1605: remove macros ap-pipe and ap-compose
Anaphoric macros do not work well with point-free style programming, in
which case both threading macros and `comp` are more adequate.
2018-05-20 13:52:51 -07:00
Philip Xu
0b08916174 Fix typos and improve code examples 2018-05-16 18:25:53 -04:00
Philip Xu
643196c2b8 Remove mixtures of tabs and spaces 2018-05-15 23:29:07 -04:00
Kodi Arfer
87aced2370 Don't let HyExpression etc. inherit from HyList
This means the compiler no longer allows e.g. `(fn (x) ...)` in place of `(fn [x] ...)`.
2018-04-29 19:17:47 -07:00
Kodi Arfer
a605936651 Remove &key
It's redundant with &optional.
2018-04-19 09:26:02 -07:00
Kodi Arfer
bbf669d407 Update docs and NEWS for HyCons removal 2018-04-12 16:45:17 -07:00
Simon Gomizelj
69202df23d Update documentation and add a NEW entry 2018-04-07 22:29:20 -07:00
Kodi Arfer
474de9e4c3 Fix a typo in the mangling documentation 2018-04-04 10:51:03 -07:00