It reached EoL a while ago an our typed_ast dependency also stopped working
for 3.4. Ideally just use a more recent Python version, which also helps
us as we don't have to maintain support for multiple minor versions at once.
- Use correct capitalisation of PyCQA organisation in Github links
- Use current version number (1.7) in ChangeLog file
- Use readhedocs URL instead of outdated docs.pylint.org
- Avoid here in links in favor of actual info on link we're pointing to
Changed the documentation in couple of places, merged sections together,
described testing procedures and added more up-to-date information
in general.
The option ``--optimize-ast`` will control the peephole optimizer,
which is used to optimize a couple of AST subtrees. The current problem
solved by the peephole optimizer is when multiple joined strings,
with the addition operator, are encountered. If the numbers of such
strings is high enough, Pylint will then fail with a maximum recursion
depth exceeded error, due to its visitor architecture. The peephole
just transforms such calls, if it can, into the final resulting string
and this exhibit a problem, because the visit_binop method stops being
called (in the optimized AST it will be a Const node).
