]> git.donarmstrong.com Git - perltidy.git/blob - TODO
add fix for #862667
[perltidy.git] / TODO
1 Perltidy TODO List
2     This is a partial "wish-list" of features to add and things to do. For
3     the latest list of bugs and feature requests at CPAN see:
4
5     https://rt.cpan.org/Public/Dist/Display.html?Name=Perl-Tidy
6
7   Improved Vertical Alignment
8     There are still many opportunities for improving vertical alignment.
9
10   Documentation
11     A FAQ is needed to explain some of the more subtle formatting issues,
12     and to give examples of different styles.
13
14     The -formatter callback object documentation is incomplete.
15
16   HTML writer
17     The HTML writer does not colorize interpolated identifiers in here
18     documents or quoted strings. The tokenizer outputs interpolation
19     information for here docs; it still needs to be updated to do this for
20     multi-line quotes. Then code needs to be written to scan for and markup
21     identifiers.
22
23 Things which have been suggested but will not be done
24   Recursive file processing
25     A -r flag might be nice, but this is best handled by an exterior shell
26     script.
27
28   Make perltidy support the syntax of module XXX
29     This generally won't be done unless the module is part of the core perl
30     distribution because it is such an open-ended problem. Compounding the
31     problem is the fact that perltidy often is invoked within an editor on
32     small snippets of code, so it must to work correctly without seeing any
33     particular 'use xxx' statement. Therefore, any syntax changes that
34     conflict with standard Perl syntax can't easily be handled.
35
36     However, an effort is being made to make perltidy generally more
37     tolerant of extensions to perl syntax. Also, the pre- and post-filter
38     capabilities of the Tidy.pm module may help.
39