e20372d99345928157be8dd89598ad129603c098
[privoxy.git] / TODO
1 $Id: TODO,v 1.41 2011/04/16 17:30:36 fabiankeil Exp $
2
3 Some Privoxy related tasks, sorted by the time they
4 have been added, not by priority.
5
6 1)  Add some regression tests. Filters should be tested automatically
7     (variables too). Could probably reuse large parts of Privoxy-Filter-Test.
8
9 3)  Fix some more XXX: comments.
10
11 4)  Fix some more compiler warnings. (Especially on amd64)
12     Partly done.
13
14 6)  Remove actions that aren't needed anymore:
15
16     content-type-overwrite should probably stay as it's also
17     used by some of the CGI pages (XXX: name them).
18
19     crunch-client-header and crunch-server-header should probably
20     go, their only advantage is that their search strings can be
21     controlled through the CGI pages, other than that they only
22     have disadvantages.
23
24     crunch-if-none-match can be replaced with a header filter.
25
26     prevent-compression has a misleading name and could
27     be replaced with a header filter.
28
29 7)  force-text-mode has a stupid name and should probably
30     be renamed to force-filter-mode.
31
32 8)  handle-as-empty-document and handle-as-image should
33     be merged to something like handle-as{something} to
34     prevent them from being activated at the same time.
35
36 10) There's a bug in the CGI editor that turns the
37     first section's "Insert new section below" into
38     a "Insert new section above" button.
39
40 11) CGI templates should use semantically-correct HTML
41     and scale properly.
42
43 12) Add pipelining support.
44
45 13) Use zlib to deflate content before sending it to
46     the client. Measure if it makes a difference.
47
48     Update:
49     Note that this is already being worked on and mostly done
50     for buffered content and internal CGI responses.
51
52     The difference it does make, seems to be that it slows things
53     down if the client and Privoxy are running on the same system,
54     so for most users enabling it will make no sense.
55
56 14) Allow to filter POST parameters.
57
58 15) If trusted CGI pages are requested without trusted referrer,
59     set the status code to 403 instead of 200.
60
61 16) Filter SSL encrypted content as well.
62
63     At the beginning we could use a unencrypted connection between
64     client and Privoxy, and use an encrypted connection between
65     Privoxy and the server.
66
67     This should be good enough for most of the content the
68     user would want to filter.
69
70 19) enable-forward-fallback. Syntax? Suggested by K.R.
71
72 21) User Manual delivery doesn't accept multiple slashes. Should it?
73
74 22) Verify action files properly (Including arguments) and
75     act accordingly (should probably intercept all requests
76     with a "Invalid option foo detected" CGI page).
77
78 23) Do the same in case of syntax errors in the configuration file,
79     instead of just exiting or ignoring the problem.
80
81 25) Handle multiple filters with the same name better. Reject them?
82
83 26) Let show-url-info detect clearly invalid URLs.
84
85 27) Make errno logging less thread-unsafe.
86     Verify that it's really an improvement.
87
88 28) Don't take default ports in case of invalid forwarding ports.
89
90 31) If a string action foo is disabled csp->action->string[ACTION_STRING_FOO]
91     doesn't necessarily contain NULL, but may contain the string of an
92     enabled foo action in an overruled section. Is it a bug? Does it matter?
93
94 32) In case of forwarding failures with socks port == 9050,
95     show extra info about Tor (the whole FAQ entry?).
96
97 36) Unload unused action files directly, even if they are
98     disabled without replacement.
99
100 38) In the final results, explicitly list disabled multi actions
101     with their parameters. Not as trivial as it sounds.
102
103 40) When running in daemon mode, Privoxy's working directory is '/'
104     which means it may not have permissions to dump core when necessary.
105     Figure out a way to solve this. Introduce a cwd config option?
106
107 41) Change documentation framework to one that works cross-platform.
108     Evaluate WML.
109
110 42) Add DTrace hooks. Now that FreeBSD has userland DTrace
111     support there's no longer any reason not to.
112     DTrace bible preorderd.
113
114 43) Write a tool to check URL patterns against URLs in the log file.
115     This could be included in Privoxy-Regression-Test.
116
117 44) Privoxy-Log-Parser: Consider highlighting "Connection" in:
118     23:13:03.506 283b6100 Header: Replaced: 'Connection: Keep-Alive' with 'Connection: close'
119
120 49) Add FAQ for NTLM proxies. Still necessary?
121
122 50) Investigate possible PCRS template speedup when searching
123     macros with strstr() before compiling pcrs commands.
124     Investigated, needs some restructuring but is probably worth it.
125
126 51) Make user-manual directive more generic to allow serving
127     the FAQ and other stuff, too. Consider changing the port
128     for "same origin policy" issues.
129
130 53) Find a more reliable hoster. Involves finding out what our
131     requirements are and which SF alternatives fulfil them.
132     It would probably also make sense to look into what other
133     projects did when migrating away from SF.
134
135 54) Move away from CVS to a more modern revision control system.
136     Find out if there are any objection against going with Git.
137     Using Git would also have the advantage that SF now pretents
138     to support it, so we could do it independently from 53).
139
140 55) Apply for Coverity scans: http://scan.coverity.com/
141
142 56) Apply for the "free online access for qualified open-source
143     software projects" for the Co-Advisor HTTP compliance tests:
144     http://coad.measurement-factory.com/details.html#pricing
145
146 57) Allow piping into external programs to allow more powerful
147     filters and policy decisions. Incomplete support available
148     in Fabian's popen branch.
149
150 58) Move more template strings from the code into the actual templates.
151
152 59) Import the German template translation.
153
154 60) Ask the Russian translators for input on how to make their
155     life easier.
156
157 61) Consider (optionally?) skipping the hostname comparison when
158     checking if a connections that goes to a HTTP proxy can be reused.
159     Do all HTTP proxy support that? Is it worth it?
160
161 63) Reject clearly too large requests earlier?
162
163 64) Use proper copyright attribution. "Privoxy Developers"
164     is no legal entity.
165
166 65) Polish Website. Probably involves ditching the Docbook
167     mess in favour of wml. There should be already some threads
168     in the mailinglists archives about this.
169
170 66) Increase maximum number of action and filter files.
171
172 67) Clean up directory layout. Depends on 54 so we don't
173     lose the revision history.
174
175 68) Use standard make syntax so we don't depend on GNU make.
176
177 69) Update autoconf setup (or move away from it).
178
179 70) If the server connection is reset but the headers are
180     received, consider passing the mess to the client instead
181     of showing the connect-failed template. Relates to #2698674.
182
183 71) Allow to listen on multiple addresses without having to
184     bind to all.
185
186 74) Let Privoxy-Regression-Test optionally check that action
187     sections which disable actions actually are preceded by
188     sections that enable said actions.
189
190 75) Create a tool that creates Privoxy action (and filter?) files
191     out of adblock files. Could be implemented as option for
192     url-pattern-translator.pl.
193
194 76) Cache DNS responses. Note that this has been requested
195     several times by users, but is not a developer priority.
196     If you care about this, feel free to submit patches.
197
198 77) Allow to configure the IP address used in outgoing connections.
199
200 78) Allow to optionally use pcre's DFA algorithm.
201
202 79) Evaluate pcre alternatives.
203
204 80) Change FEATURE_EXTENDED_HOST_PATTERNS to support both
205     extended and vanilla host patterns at the same time.
206
207     Note that the requirement is to allow the user to decide
208     if the domain pattern should be interpreted as regex or
209     traditional host pattern and if it's not obvious that the
210     user made any decision, default to the latter.
211
212     Possible solutions would be:
213
214     1. An always-use-regex-domain-patterns config option
215     2. An enable-regex-domain-patterns-for-this-action-file option
216     3. An enable-regex-domain-patterns-for-this-action-file-until-the-user-says-otherwise option
217     4. A treat-the-domain-pattern-in-this-line-as-regex(-or-not) option
218     5. Combinations of the options above
219
220     With 2+4, 3+4 or 2+3+4 being the preferences until
221     further discussion.
222
223 82) Detect if the system time goes back in time let the user
224     know if it caused any connections to get closed.
225
226 83) Make the FAQ available through the CGI interface like the
227     user manual is.
228
229 84) Flesh out the user-manual delivery to serve pages from
230     other directories, too.
231
232 85) Once #84 is done, write a script that populates a directory with
233     various common third-party icons (stumbleupon.png, facebook.png ...)
234     and redirect requests for them to Privoxy.
235
236 86) Add a server-body-tagger action. This is trivial as as all the
237     functionallity required to do it already exists.
238
239 87) Add a client-body-tagger action. This is less trivial as we currently
240     don't buffer client bodies. After 14) is implemented it would be
241     trivial, though.
242
243 88) Investigate if there's a Perl module that Privoxy-Regression-Test
244     could optionally use to keep connections alive.
245
246 89) When multiple block actions apply, consider showing all the block
247     reasons on the blocked page that haven't been overruled, not just
248     the last one.
249
250 90) Implement NO-TAG: patterns that enable a section if the
251     provided pattern doesn't match any TAG. This would make
252     some things cleaner.
253
254 91) Add an optional limit for internal redirects. It would probably
255     be reasonable to default to a limit of one and showing an error
256     message if the request for the redirect URL would be redirected
257     again.