← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to doc/notes/architecture.txt

  • Committer: mattgiuca
  • Date: 2007-12-10 03:01:12 UTC
  • Revision ID: svn-v3-trunk0:2b9c9e99-6f39-0410-b283-7f802c844ae2:trunk:16
design notes/architecture.txt: Reworked and added sections following
    discussion with Tom Conway.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/notes/architecture.txt
122
122
(immediately when the first call to `write` or `write_html_headers` is made) -
123
123
in which the response headers are written to the server.
124
124
 
125
 
### Help files ###
126
 
 
127
 
There will be a "help" app which is special in that it goes inside all of the
128
 
other apps directories looking for a help file. So aside from "client.py",
129
 
another special file is "help.html" which is a static help file for each
130
 
module, sitting in that app's top-level directory.
131
 
 
132
 
help.html is not to be served directly. The "help" app will embed it within
133
 
another page. Therefore it is not a real HTML file - it should just be the
134
 
inside of a body (it should not contain html or body tags).
135
 
 
136
125
### Application directory hierarchy ###
137
126
 
138
127
Due to the handler, we have a nice property that the application directory
303
292
  Python process which loads a mod_python handler, cgihandler or psphandler on
304
293
  the given file.
305
294
* HTTP errors for banned files.
306
 
* When presented with a directory, it first tries to execute `__init__.py`
307
 
  (the default item for the directory). It could also look for `index.html` or
308
 
  `index.psp` if that failed. Failing that, it returns an HTTP 403 Forbidden
309
 
  error.
 
295
 
 
296
 **Discussion**: The question remains how exec should handle directories. It
 
297
 *could* redirect to the browser, but this would only be feasible if the user
 
298
was logged in (exec is available to the public). I would prefer if it acted
 
299
like a web server, either presenting a basic directory listing (possibly
 
300
using part of the browser code), or just giving a HTTP 403 Forbidden error.
310
301
 
311
302
### Console ###
312
303