← Back to branch summary

~ubuntu-branches/ubuntu/raring/ipython/raring

« back to all changes in this revision

Viewing changes to docs/dist/html/_sources/development/config_blueprint.txt

  • Committer: Package Import Robot
  • Author(s): Julian Taylor
  • Date: 2011-11-22 23:40:57 UTC
  • mfrom: (6.1.5 sid)
  • Revision ID: package-import@ubuntu.com-20111122234057-ta86ocdahnhwmnd8
Tags: 0.11-2
* upload to unstable
* add patch fix-version-checks-for-pyzmq-2.1.10.patch
* fix debianize-error-messages.patch to reraise unknown exceptions
* suggest python-zmq for ipython package
* use dh_sphinxdoc
  - bump sphinx dependency to >= 1.0.7+dfsg-1~, replace libjs-jquery
    dependency with ${sphinxdoc:Depends} and drop ipython-doc.links
* remove empty directory from ipython
* link duplicate images in ipython-doc
* remove obsolete Conflicts and Replaces

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/dist/html/_sources/development/config_blueprint.txt
1
 
=========================================
2
 
Notes on the IPython configuration system
3
 
=========================================
4
 
 
5
 
This document has some random notes on the configuration system.
6
 
 
7
 
To start, an IPython process needs:
8
 
 
9
 
* Configuration files
10
 
* Command line options
11
 
* Additional files (FURL files, extra scripts, etc.)
12
 
 
13
 
It feeds these things into the core logic of the process, and as output,
14
 
produces:
15
 
 
16
 
* Log files
17
 
* Security files
18
 
 
19
 
There are a number of things that complicate this:
20
 
 
21
 
* A process may need to be started on a different host that doesn't have
22
 
  any of the config files or additional files.  Those files need to be
23
 
  moved over and put in a staging area.  The process then needs to be told
24
 
  about them.
25
 
* The location of the output files should somehow be set by config files or
26
 
  command line options.
27
 
* Our config files are very hierarchical, but command line options are flat,
28
 
  making it difficult to relate command line options to config files.
29
 
* Some processes (like ipcluster and the daemons) have to manage the input and
30
 
  output files for multiple different subprocesses, each possibly on a
31
 
  different host.  Ahhhh!
32
 
* Our configurations are not singletons.  A given user will likely have
33
 
  many different configurations for different clusters.