f536377e141a973c2310d813f74c03d4a9af73be
[privoxy.git] / TODO
1 $Id: TODO,v 1.37 2011/04/16 17:29:12 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 35) Do less work in the accept_connection() thread.
98     Partly done. Good enough?
99
100 36) Unload unused action files directly, even if they are
101     disabled without replacement.
102
103 38) In the final results, explicitly list disabled multi actions
104     with their parameters. Not as trivial as it sounds.
105
106 39) Verify loadcfg.c jarfile reloading and friends.
107     /* XXX: Does disabling this actually work? */
108
109 40) Fix core dumping in daemon mode. Introduce a cwd config option?
110
111 41) Change documentation framework to one that works cross-platform.
112     Evaluate WML.
113
114 42) Add DTrace hooks. Now that FreeBSD has userland DTrace
115     support there's no longer any reason not to.
116
117 43) Write a tool to check URL patterns against URLs in the log file.
118     This could be included in Privoxy-Regression-Test.
119
120 44) Privoxy-Log-Parser: Consider highlighting "Connection" in:
121     23:13:03.506 283b6100 Header: Replaced: 'Connection: Keep-Alive' with 'Connection: close'
122
123 49) Add FAQ for NTLM proxies. Still necessary?
124
125 50) Investigate possible PCRS template speedup when searching
126     macros with strstr() before compiling pcrs commands.
127     Investigated, needs some restructuring but is probably worth it.
128
129 51) Make user-manual directive more generic to allow serving
130     the FAQ and other stuff, too. Consider changing the port
131     for "same origin policy" issues.
132
133 53) Find a more reliable hoster. Involves finding out what our
134     requirements are and which SF alternatives fulfil them.
135     It would probably also make sense to look into what other
136     projects did when migrating away from SF.
137
138 54) Move away from CVS to a more modern revision control system.
139     Find out if there are any objection against going with Git.
140     Using Git would also have the advantage that SF now pretents
141     to support it, so we could do it independently from 53).
142
143 55) Apply for Coverity scans: http://scan.coverity.com/
144
145 56) Apply for the "free online access for qualified open-source
146     software projects" for the Co-Advisor HTTP compliance tests:
147     http://coad.measurement-factory.com/details.html#pricing
148
149 57) Allow piping into external programs to allow more powerful
150     filters and policy decisions. Incomplete support available
151     in Fabian's popen branch.
152
153 58) Move more template strings from the code into the actual templates.
154
155 59) Import the German template translation.
156
157 60) Ask the Russian translators for input on how to make their
158     life easier.
159
160 61) Consider (optionally?) skipping the hostname comparison when
161     checking if a connections that goes to a HTTP proxy can be reused.
162     Do all HTTP proxy support that? Is it worth it?
163
164 63) Reject clearly too large requests earlier?
165
166 64) Use proper copyright attribution. "Privoxy Developers"
167     is no legal entity.
168
169 65) Polish Website. Probably involves ditching the Docbook
170     mess in favour of wml. There should be already some threads
171     in the mailinglists archives about this.
172
173 66) Increase maximum number of action and filter files.
174
175 67) Clean up directory layout. Depends on 54 so we don't
176     lose the revision history.
177
178 68) Use standard make syntax so we don't depend on GNU make.
179
180 69) Update autoconf setup (or move away from it).
181
182 70) If the server connection is reset but the headers are
183     received, consider passing the mess to the client instead
184     of showing the connect-failed template. Relates to #2698674.
185
186 71) Allow to listen on multiple addresses without having to
187     bind to all.
188
189 74) Let Privoxy-Regression-Test optionally check that action
190     sections which disable actions actually are preceded by
191     sections that enable said actions.
192
193 75) Create a tool that creates Privoxy action (and filter?) files
194     out of adblock files. Could be implemented as option for
195     url-pattern-translator.pl.
196
197 76) Cache DNS responses. Note that this has been requested
198     several times by users, but is not a developer priority.
199     If you care about this, feel free to submit patches.
200
201 77) Allow to configure the IP address used in outgoing connections.
202
203 78) Allow to optionally use pcre's DFA algorithm.
204
205 79) Evaluate pcre alternatives.
206
207 80) Change FEATURE_EXTENDED_HOST_PATTERNS to support both
208     extended and vanilla host patterns at the same time.
209
210     Note that the requirement is to allow the user to decide
211     if the domain pattern should be interpreted as regex or
212     traditional host pattern and if it's not obvious that the
213     user made any decision, default to the latter.
214
215     Possible solutions would be:
216
217     1. An always-use-regex-domain-patterns config option
218     2. An enable-regex-domain-patterns-for-this-action-file option
219     3. An enable-regex-domain-patterns-for-this-action-file-until-the-user-says-otherwise option
220     4. A treat-the-domain-pattern-in-this-line-as-regex(-or-not) option
221     5. Combinations of the options above
222
223     With 2+4, 3+4 or 2+3+4 being the preferences until
224     further discussion.
225
226 82) Detect if the system time goes back in time let the user
227     know if it caused any connections to get closed.
228
229 83) Make the FAQ available through the CGI interface like the
230     user manual is.
231
232 84) Flesh out the user-manual delivery to serve pages from
233     other directories, too.
234
235 85) Once #84 is done, write a script that populates a directory with
236     various common third-party icons (stumbleupon.png, facebook.png ...)
237     and redirect requests for them to Privoxy.
238
239 86) Add a server-body-tagger action. This is trivial as as all the
240     functionallity required to do it already exists.
241
242 87) Add a client-body-tagger action. This is less trivial as we currently
243     don't buffer client bodies. After 14) is implemented it would be
244     trivial, though.
245
246 88) Investigate if there's a Perl module that Privoxy-Regression-Test
247     could optionally use to keep connections alive.
248
249 89) When multiple block actions apply, consider showing all the block
250     reasons on the blocked page that haven't been overruled, not just
251     the last one.
252
253 90) Implement NO-TAG: patterns that enable a section if the
254     provided pattern doesn't match any TAG. This would make
255     some things cleaner.
256
257 91) Add an optional limit for internal redirects. It would probably
258     be reasonable to default to a limit of one and showing an error
259     message if the request for the redirect URL would be redirected
260     again.