]> git.donarmstrong.com Git - perltidy.git/blob - TODO
upgrade to new version
[perltidy.git] / TODO
1 Perltidy TODO List
2     This is a partial "wish-list" of features to add and things to do. All
3     of these are of interest, but there is no particular schedule for
4     implementing them.
5
6   Improved Vertical Alignment
7     There are many opportunities for improving vertical alignment.
8
9   improved ?: formatting
10     An indentation level should be associated with ?: statements. This would
11     make nested ?: statements more readable.
12
13   improved internal if/unless formatting
14     Consider giving internal if/unless statements an additional level of
15     indentation. This would avoid running out of indentation levels.
16     Suggested by Jeff Armstorng. For example, we would like the 'ands' in
17     the following statement to be indented more than the if:
18
19         return $ship->chargeWeapons("phaser-canon")
20           if $encounter->description eq 'klingon'
21           and $ship->firepower >= $encounter->firepower
22           and $location->status ne 'neutral';
23
24   Documentation
25     A FAQ is needed to explain some of the more subtle formatting issues,
26     and to give examples of different styles.
27
28     The -formatter callback object documentation is incomplete.
29
30   HTML writer
31     The HTML writer does not colorize interpolated identifiers in here
32     documents or quoted strings. The tokenizer outputs interpolation
33     information for here docs; it still needs to be updated to do this for
34     multi-line quotes. Then code needs to be written to scan for and markup
35     identifiers.
36
37   Automatic style detection
38     It would be nice to write a program to read a sample of perl code and
39     write an approximate .perltidyrc file for that style.
40
41 Things which have been suggested but will not be done
42   Recursive file processing
43     A -r flag might be nice, but this is probably best handled by an
44     exterior shell script.
45