]> git.donarmstrong.com Git - perltidy.git/blob - TODO
8eaabd68ac248c0196261ad30995240f6ae16a8a
[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   enable -ole under Windows
25     This only works under unix (or cygwin) at present. It doesn't work for
26     Windows versions, such as Active State, because they change line endings
27     that they don't like.
28
29   Documentation
30     A FAQ is needed to explain some of the more subtle formatting issues,
31     and to give examples of different styles.
32
33     The -formatter callback object documentation is incomplete.
34
35   HTML writer
36     The HTML writer does not colorize interpolated identifiers in here
37     documents or quoted strings. The tokenizer outputs interpolation
38     information for here docs; it still needs to be updated to do this for
39     multi-line quotes. Then code needs to be written to scan for and markup
40     identifiers.
41
42   Automatic style detection
43     It would be nice to write a program to read a sample of perl code and
44     write an approximate .perltidyrc file for that style.
45
46 Things which have been suggested but will not be done
47   Recursive file processing
48     A -r flag might be nice, but this is probably best handled by an
49     exterior shell script.
50