Web   ·   Wiki   ·   Activities   ·   Blog   ·   Lists   ·   Chat   ·   Meeting   ·   Bugs   ·   Git   ·   Translate   ·   Archive   ·   People   ·   Donate
summaryrefslogtreecommitdiffstats
path: root/IPython/usage.pyo
blob: 49d1b679f41504ee41458c4bc9f2b165e5d8ea2c (plain)
ofshex dumpascii
0000 d1 f2 0d 0a 9c 82 e6 49 63 00 00 00 00 00 00 00 00 01 00 00 00 40 00 00 00 73 1c 00 00 00 64 00 .......Ic............@...s....d.
0020 00 5a 00 00 65 00 00 5a 01 00 64 01 00 5a 02 00 64 02 00 5a 03 00 64 03 00 53 28 04 00 00 00 73 .Z..e..Z..d..Z..d..Z..d..S(....s
0040 be 52 00 00 0a 49 50 79 74 68 6f 6e 20 2d 2d 20 41 6e 20 65 6e 68 61 6e 63 65 64 20 49 6e 74 65 .R...IPython.--.An.enhanced.Inte
0060 72 61 63 74 69 76 65 20 50 79 74 68 6f 6e 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ractive.Python.=================
0080 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 41 20 50 79 74 68 ========================..A.Pyth
00a0 6f 6e 20 73 68 65 6c 6c 20 77 69 74 68 20 61 75 74 6f 6d 61 74 69 63 20 68 69 73 74 6f 72 79 20 on.shell.with.automatic.history.
00c0 28 69 6e 70 75 74 20 61 6e 64 20 6f 75 74 70 75 74 29 2c 20 64 79 6e 61 6d 69 63 20 6f 62 6a 65 (input.and.output),.dynamic.obje
00e0 63 74 0a 69 6e 74 72 6f 73 70 65 63 74 69 6f 6e 2c 20 65 61 73 69 65 72 20 63 6f 6e 66 69 67 75 ct.introspection,.easier.configu
0100 72 61 74 69 6f 6e 2c 20 63 6f 6d 6d 61 6e 64 20 63 6f 6d 70 6c 65 74 69 6f 6e 2c 20 61 63 63 65 ration,.command.completion,.acce
0120 73 73 20 74 6f 20 74 68 65 20 73 79 73 74 65 6d 0a 73 68 65 6c 6c 20 61 6e 64 20 6d 6f 72 65 2e ss.to.the.system.shell.and.more.
0140 0a 0a 49 50 79 74 68 6f 6e 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 65 6d 62 65 64 64 65 64 20 69 ..IPython.can.also.be.embedded.i
0160 6e 20 72 75 6e 6e 69 6e 67 20 70 72 6f 67 72 61 6d 73 2e 20 53 65 65 20 45 4d 42 45 44 44 49 4e n.running.programs..See.EMBEDDIN
0180 47 20 62 65 6c 6f 77 2e 0a 0a 0a 55 53 41 47 45 0a 20 20 20 20 20 20 20 69 70 79 74 68 6f 6e 20 G.below....USAGE........ipython.
01a0 5b 6f 70 74 69 6f 6e 73 5d 20 66 69 6c 65 73 0a 0a 20 20 20 20 20 20 20 49 66 20 69 6e 76 6f 6b [options].files.........If.invok
01c0 65 64 20 77 69 74 68 20 6e 6f 20 6f 70 74 69 6f 6e 73 2c 20 69 74 20 65 78 65 63 75 74 65 73 20 ed.with.no.options,.it.executes.
01e0 61 6c 6c 20 74 68 65 20 66 69 6c 65 73 20 6c 69 73 74 65 64 20 69 6e 0a 20 20 20 20 20 20 20 73 all.the.files.listed.in........s
0200 65 71 75 65 6e 63 65 20 61 6e 64 20 64 72 6f 70 73 20 79 6f 75 20 69 6e 74 6f 20 74 68 65 20 69 equence.and.drops.you.into.the.i
0220 6e 74 65 72 70 72 65 74 65 72 20 77 68 69 6c 65 20 73 74 69 6c 6c 20 61 63 6b 6e 6f 77 6c 65 64 nterpreter.while.still.acknowled
0240 67 69 6e 67 0a 20 20 20 20 20 20 20 61 6e 79 20 6f 70 74 69 6f 6e 73 20 79 6f 75 20 6d 61 79 20 ging........any.options.you.may.
0260 68 61 76 65 20 73 65 74 20 69 6e 20 79 6f 75 72 20 69 70 79 74 68 6f 6e 72 63 20 66 69 6c 65 2e have.set.in.your.ipythonrc.file.
0280 20 54 68 69 73 20 62 65 68 61 76 69 6f 72 20 69 73 0a 20 20 20 20 20 20 20 64 69 66 66 65 72 65 .This.behavior.is........differe
02a0 6e 74 20 66 72 6f 6d 20 73 74 61 6e 64 61 72 64 20 50 79 74 68 6f 6e 2c 20 77 68 69 63 68 20 77 nt.from.standard.Python,.which.w
02c0 68 65 6e 20 63 61 6c 6c 65 64 20 61 73 20 70 79 74 68 6f 6e 20 2d 69 20 77 69 6c 6c 0a 20 20 20 hen.called.as.python.-i.will....
02e0 20 20 20 20 6f 6e 6c 79 20 65 78 65 63 75 74 65 20 6f 6e 65 20 66 69 6c 65 20 61 6e 64 20 77 69 ....only.execute.one.file.and.wi
0300 6c 6c 20 69 67 6e 6f 72 65 20 79 6f 75 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 65 74 ll.ignore.your.configuration.set
0320 75 70 2e 0a 0a 20 20 20 20 20 20 20 50 6c 65 61 73 65 20 6e 6f 74 65 20 74 68 61 74 20 73 6f 6d up..........Please.note.that.som
0340 65 20 6f 66 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 20 61 e.of.the.configuration.options.a
0360 72 65 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 61 74 0a 20 20 20 20 20 20 20 74 68 65 20 63 re.not.available.at........the.c
0380 6f 6d 6d 61 6e 64 20 6c 69 6e 65 2c 20 73 69 6d 70 6c 79 20 62 65 63 61 75 73 65 20 74 68 65 79 ommand.line,.simply.because.they
03a0 20 61 72 65 20 6e 6f 74 20 70 72 61 63 74 69 63 61 6c 20 68 65 72 65 2e 20 4c 6f 6f 6b 20 69 6e .are.not.practical.here..Look.in
03c0 74 6f 0a 20 20 20 20 20 20 20 79 6f 75 72 20 69 70 79 74 68 6f 6e 72 63 20 63 6f 6e 66 69 67 75 to........your.ipythonrc.configu
03e0 72 61 74 69 6f 6e 20 66 69 6c 65 20 66 6f 72 20 64 65 74 61 69 6c 73 20 6f 6e 20 74 68 6f 73 65 ration.file.for.details.on.those
0400 2e 20 54 68 69 73 20 66 69 6c 65 0a 20 20 20 20 20 20 20 74 79 70 69 63 61 6c 6c 79 20 69 6e 73 ..This.file........typically.ins
0420 74 61 6c 6c 65 64 20 69 6e 20 74 68 65 20 24 48 4f 4d 45 2f 2e 69 70 79 74 68 6f 6e 20 64 69 72 talled.in.the.$HOME/.ipython.dir
0440 65 63 74 6f 72 79 2e 0a 0a 20 20 20 20 20 20 20 46 6f 72 20 57 69 6e 64 6f 77 73 20 75 73 65 72 ectory..........For.Windows.user
0460 73 2c 20 24 48 4f 4d 45 20 72 65 73 6f 6c 76 65 73 20 74 6f 20 43 3a 5c 44 6f 63 75 6d 65 6e 74 s,.$HOME.resolves.to.C:\Document
0480 73 20 61 6e 64 0a 20 20 20 20 20 20 20 53 65 74 74 69 6e 67 73 5c 59 6f 75 72 55 73 65 72 4e 61 s.and........Settings\YourUserNa
04a0 6d 65 20 69 6e 20 6d 6f 73 74 20 69 6e 73 74 61 6e 63 65 73 2c 20 61 6e 64 20 5f 69 70 79 74 68 me.in.most.instances,.and._ipyth
04c0 6f 6e 20 69 73 20 75 73 65 64 20 69 6e 73 74 65 61 64 0a 20 20 20 20 20 20 20 6f 66 20 2e 69 70 on.is.used.instead........of..ip
04e0 79 74 68 6f 6e 2c 20 73 69 6e 63 65 20 73 6f 6d 65 20 57 69 6e 33 32 20 70 72 6f 67 72 61 6d 73 ython,.since.some.Win32.programs
0500 20 68 61 76 65 20 70 72 6f 62 6c 65 6d 73 20 77 69 74 68 20 64 6f 74 74 65 64 20 6e 61 6d 65 73 .have.problems.with.dotted.names
0520 0a 20 20 20 20 20 20 20 69 6e 20 64 69 72 65 63 74 6f 72 69 65 73 2e 0a 0a 20 20 20 20 20 20 20 ........in.directories..........
0540 49 6e 20 74 68 65 20 72 65 73 74 20 6f 66 20 74 68 69 73 20 74 65 78 74 2c 20 77 65 20 77 69 6c In.the.rest.of.this.text,.we.wil
0560 6c 20 72 65 66 65 72 20 74 6f 20 74 68 69 73 20 64 69 72 65 63 74 6f 72 79 20 61 73 0a 20 20 20 l.refer.to.this.directory.as....
0580 20 20 20 20 49 50 59 54 48 4f 4e 44 49 52 2e 0a 0a 0a 53 50 45 43 49 41 4c 20 54 48 52 45 41 44 ....IPYTHONDIR....SPECIAL.THREAD
05a0 49 4e 47 20 4f 50 54 49 4f 4e 53 0a 20 20 20 20 20 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ING.OPTIONS........The.following
05c0 20 73 70 65 63 69 61 6c 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 4f 4e 4c 59 20 76 61 6c 69 64 20 .special.options.are.ONLY.valid.
05e0 61 74 20 74 68 65 20 20 62 65 67 69 6e 6e 69 6e 67 20 20 6f 66 20 20 74 68 65 0a 20 20 20 20 20 at.the..beginning..of..the......
0600 20 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 2c 20 61 6e 64 20 6e 6f 74 20 6c 61 74 65 72 2e 20 20 ..command.line,.and.not.later...
0620 54 68 69 73 20 69 73 20 62 65 63 61 75 73 65 20 74 68 65 79 20 63 6f 6e 74 72 6f 6c 20 74 68 65 This.is.because.they.control.the
0640 20 69 6e 69 74 69 61 6c 2d 0a 20 20 20 20 20 20 20 69 7a 61 74 69 6f 6e 20 6f 66 20 69 70 79 74 .initial-........ization.of.ipyt
0660 68 6f 6e 20 69 74 73 65 6c 66 2c 20 62 65 66 6f 72 65 20 74 68 65 20 6e 6f 72 6d 61 6c 20 6f 70 hon.itself,.before.the.normal.op
0680 74 69 6f 6e 2d 68 61 6e 64 6c 69 6e 67 20 20 6d 65 63 68 61 6e 69 73 6d 0a 20 20 20 20 20 20 20 tion-handling..mechanism........
06a0 69 73 20 61 63 74 69 76 65 2e 0a 0a 20 20 20 20 20 20 20 2d 67 74 68 72 65 61 64 2c 20 2d 71 74 is.active..........-gthread,.-qt
06c0 68 72 65 61 64 2c 20 2d 71 34 74 68 72 65 61 64 2c 20 2d 77 74 68 72 65 61 64 2c 20 2d 70 79 6c hread,.-q4thread,.-wthread,.-pyl
06e0 61 62 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4f 6e 6c 79 20 4f 4e 45 20 6f 66 20 74 68 ab................Only.ONE.of.th
0700 65 73 65 20 63 61 6e 20 62 65 20 67 69 76 65 6e 2c 20 61 6e 64 20 69 74 20 63 61 6e 20 6f 6e 6c ese.can.be.given,.and.it.can.onl
0720 79 20 62 65 20 67 69 76 65 6e 20 61 73 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 y.be.given.as.the...............
0740 66 69 72 73 74 20 6f 70 74 69 6f 6e 20 70 61 73 73 65 64 20 74 6f 20 49 50 79 74 68 6f 6e 20 28 first.option.passed.to.IPython.(
0760 69 74 20 77 69 6c 6c 20 68 61 76 65 20 6e 6f 20 65 66 66 65 63 74 20 69 6e 20 61 6e 79 0a 20 20 it.will.have.no.effect.in.any...
0780 20 20 20 20 20 20 20 20 20 20 20 20 6f 74 68 65 72 20 70 6f 73 69 74 69 6f 6e 29 2e 20 20 54 68 ............other.position)...Th
07a0 65 79 20 70 72 6f 76 69 64 65 20 74 68 72 65 61 64 69 6e 67 20 73 75 70 70 6f 72 74 20 66 6f 72 ey.provide.threading.support.for
07c0 20 74 68 65 20 47 54 4b 2c 20 51 54 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6e 64 20 57 .the.GTK,.QT...............and.W
07e0 58 57 69 64 67 65 74 73 20 74 6f 6f 6c 6b 69 74 73 2c 20 61 6e 64 20 66 6f 72 20 74 68 65 20 6d XWidgets.toolkits,.and.for.the.m
0800 61 74 70 6c 6f 74 6c 69 62 20 6c 69 62 72 61 72 79 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 atplotlib.library...............
0820 20 20 57 69 74 68 20 61 6e 79 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 66 6f 75 72 20 6f 70 74 ..With.any.of.the.first.four.opt
0840 69 6f 6e 73 2c 20 49 50 79 74 68 6f 6e 20 73 74 61 72 74 73 20 72 75 6e 6e 69 6e 67 20 61 0a 20 ions,.IPython.starts.running.a..
0860 20 20 20 20 20 20 20 20 20 20 20 20 20 73 65 70 61 72 61 74 65 20 74 68 72 65 61 64 20 66 6f 72 .............separate.thread.for
0880 20 74 68 65 20 67 72 61 70 68 69 63 61 6c 20 74 6f 6f 6c 6b 69 74 27 73 20 6f 70 65 72 61 74 69 .the.graphical.toolkit's.operati
08a0 6f 6e 2c 20 73 6f 20 74 68 61 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 79 6f 75 20 63 61 on,.so.that...............you.ca
08c0 6e 20 6f 70 65 6e 20 61 6e 64 20 63 6f 6e 74 72 6f 6c 20 67 72 61 70 68 69 63 61 6c 20 65 6c 65 n.open.and.control.graphical.ele
08e0 6d 65 6e 74 73 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 61 6e 0a 20 20 20 20 20 20 20 20 20 20 20 ments.from.within.an............
0900 20 20 20 49 50 79 74 68 6f 6e 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 2c 20 77 69 74 68 6f 75 74 ...IPython.command.line,.without
0920 20 62 6c 6f 63 6b 69 6e 67 2e 20 20 41 6c 6c 20 66 6f 75 72 20 70 72 6f 76 69 64 65 0a 20 20 20 .blocking...All.four.provide....
0940 20 20 20 20 20 20 20 20 20 20 20 65 73 73 65 6e 74 69 61 6c 6c 79 20 74 68 65 20 73 61 6d 65 20 ...........essentially.the.same.
0960 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 2c 20 72 65 73 70 65 63 74 69 76 65 6c 79 20 66 6f 72 20 functionality,.respectively.for.
0980 47 54 4b 2c 20 51 54 33 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 51 54 34 20 61 6e 64 20 GTK,.QT3,...............QT4.and.
09a0 57 58 57 69 64 67 65 74 73 20 28 76 69 61 20 74 68 65 69 72 20 50 79 74 68 6f 6e 20 69 6e 74 65 WXWidgets.(via.their.Python.inte
09c0 72 66 61 63 65 73 29 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4e 6f 74 65 20 74 68 61 rfaces).................Note.tha
09e0 74 20 77 69 74 68 20 2d 77 74 68 72 65 61 64 2c 20 79 6f 75 20 63 61 6e 20 61 64 64 69 74 69 6f t.with.-wthread,.you.can.additio
0a00 6e 61 6c 6c 79 20 75 73 65 20 74 68 65 20 2d 77 78 76 65 72 73 69 6f 6e 0a 20 20 20 20 20 20 20 nally.use.the.-wxversion........
0a20 20 20 20 20 20 20 20 6f 70 74 69 6f 6e 20 74 6f 20 72 65 71 75 65 73 74 20 61 20 73 70 65 63 69 .......option.to.request.a.speci
0a40 66 69 63 20 76 65 72 73 69 6f 6e 20 6f 66 20 77 78 20 74 6f 20 62 65 20 75 73 65 64 2e 20 20 54 fic.version.of.wx.to.be.used...T
0a60 68 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 71 75 69 72 65 73 20 74 68 61 74 20 his...............requires.that.
0a80 79 6f 75 20 68 61 76 65 20 74 68 65 20 27 77 78 76 65 72 73 69 6f 6e 27 20 50 79 74 68 6f 6e 20 you.have.the.'wxversion'.Python.
0aa0 6d 6f 64 75 6c 65 20 69 6e 73 74 61 6c 6c 65 64 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 module.installed,...............
0ac0 77 68 69 63 68 20 69 73 20 70 61 72 74 20 6f 66 20 72 65 63 65 6e 74 20 77 78 50 79 74 68 6f 6e which.is.part.of.recent.wxPython
0ae0 20 64 69 73 74 72 69 62 75 74 69 6f 6e 73 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 .distributions.................I
0b00 66 20 2d 70 79 6c 61 62 20 69 73 20 67 69 76 65 6e 2c 20 49 50 79 74 68 6f 6e 20 6c 6f 61 64 73 f.-pylab.is.given,.IPython.loads
0b20 20 73 70 65 63 69 61 6c 20 73 75 70 70 6f 72 74 20 66 6f 72 20 74 68 65 20 6d 61 74 2d 0a 20 20 .special.support.for.the.mat-...
0b40 20 20 20 20 20 20 20 20 20 20 20 20 70 6c 6f 74 6c 69 62 20 6c 69 62 72 61 72 79 20 28 68 74 74 ............plotlib.library.(htt
0b60 70 3a 2f 2f 6d 61 74 70 6c 6f 74 6c 69 62 2e 73 6f 75 72 63 65 66 6f 72 67 65 2e 6e 65 74 29 2c p://matplotlib.sourceforge.net),
0b80 20 61 6c 6c 6f 77 69 6e 67 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 65 72 61 63 74 .allowing...............interact
0ba0 69 76 65 20 75 73 61 67 65 20 6f 66 20 61 6e 79 20 6f 66 20 69 74 73 20 62 61 63 6b 65 6e 64 73 ive.usage.of.any.of.its.backends
0bc0 20 61 73 20 64 65 66 69 6e 65 64 20 69 6e 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 .as.defined.in.the..............
0be0 20 75 73 65 72 27 73 20 2e 6d 61 74 70 6c 6f 74 6c 69 62 72 63 20 66 69 6c 65 2e 20 20 49 74 20 .user's..matplotlibrc.file...It.
0c00 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 61 63 74 69 76 61 74 65 73 20 47 54 4b 2c 20 51 54 0a automatically.activates.GTK,.QT.
0c20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f 72 20 57 58 20 74 68 72 65 61 64 69 6e 67 20 66 6f ..............or.WX.threading.fo
0c40 72 20 49 50 79 68 74 6f 6e 20 69 66 20 74 68 65 20 63 68 6f 69 63 65 20 6f 66 20 6d 61 74 70 6c r.IPyhton.if.the.choice.of.matpl
0c60 6f 74 6c 69 62 20 62 61 63 6b 65 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 71 75 otlib.backend...............requ
0c80 69 72 65 73 20 69 74 2e 20 20 49 74 20 61 6c 73 6f 20 6d 6f 64 69 66 69 65 73 20 74 68 65 20 25 ires.it...It.also.modifies.the.%
0ca0 72 75 6e 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 63 6f 72 72 65 63 74 6c 79 0a 20 20 20 20 20 20 20 run.command.to.correctly........
0cc0 20 20 20 20 20 20 20 65 78 65 63 75 74 65 20 28 77 69 74 68 6f 75 74 20 62 6c 6f 63 6b 69 6e 67 .......execute.(without.blocking
0ce0 29 20 61 6e 79 20 6d 61 74 70 6c 6f 74 6c 69 62 2d 62 61 73 65 64 20 73 63 72 69 70 74 20 77 68 ).any.matplotlib-based.script.wh
0d00 69 63 68 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 6c 6c 73 20 73 68 6f 77 28 29 20 61 ich...............calls.show().a
0d20 74 20 74 68 65 20 65 6e 64 2e 0a 0a 20 20 20 20 20 20 20 2d 74 6b 20 20 20 20 54 68 65 20 2d 67 t.the.end..........-tk....The.-g
0d40 2f 71 2f 71 34 2f 77 74 68 72 65 61 64 20 6f 70 74 69 6f 6e 73 2c 20 61 6e 64 20 2d 70 79 6c 61 /q/q4/wthread.options,.and.-pyla
0d60 62 20 28 69 66 20 6d 61 74 70 6c 6f 74 6c 69 62 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 b.(if.matplotlib.is.............
0d80 20 20 63 6f 6e 66 69 67 75 72 65 64 20 74 6f 20 75 73 65 20 47 54 4b 2c 20 51 54 20 6f 72 20 57 ..configured.to.use.GTK,.QT.or.W
0da0 58 29 2c 20 77 69 6c 6c 20 6e 6f 72 6d 61 6c 6c 79 20 62 6c 6f 63 6b 20 54 6b 0a 20 20 20 20 20 X),.will.normally.block.Tk......
0dc0 20 20 20 20 20 20 20 20 20 67 72 61 70 68 69 63 61 6c 20 69 6e 74 65 72 66 61 63 65 73 2e 20 20 .........graphical.interfaces...
0de0 54 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 77 68 65 6e 20 47 54 4b 2c 20 51 54 20 6f 72 20 This.means.that.when.GTK,.QT.or.
0e00 57 58 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 72 65 61 64 69 6e 67 20 69 73 20 61 63 WX...............threading.is.ac
0e20 74 69 76 65 2c 20 61 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20 6f 70 65 6e 20 61 20 54 6b 20 47 tive,.any.attempt.to.open.a.Tk.G
0e40 55 49 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 UI.will.result.in...............
0e60 61 20 64 65 61 64 20 77 69 6e 64 6f 77 2c 20 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 63 61 75 73 a.dead.window,.and.possibly.caus
0e80 65 20 74 68 65 20 50 79 74 68 6f 6e 20 69 6e 74 65 72 70 72 65 74 65 72 20 74 6f 0a 20 20 20 20 e.the.Python.interpreter.to.....
0ea0 20 20 20 20 20 20 20 20 20 20 63 72 61 73 68 2e 20 20 41 6e 20 65 78 74 72 61 20 6f 70 74 69 6f ..........crash...An.extra.optio
0ec0 6e 2c 20 2d 74 6b 2c 20 69 73 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 61 64 64 72 65 73 73 20 n,.-tk,.is.available.to.address.
0ee0 74 68 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 73 73 75 65 2e 20 20 49 74 20 63 61 this...............issue...It.ca
0f00 6e 20 4f 4e 4c 59 20 62 65 20 67 69 76 65 6e 20 61 73 20 61 20 53 45 43 4f 4e 44 20 6f 70 74 69 n.ONLY.be.given.as.a.SECOND.opti
0f20 6f 6e 20 61 66 74 65 72 20 61 6e 79 20 6f 66 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 on.after.any.of.the.............
0f40 20 20 61 62 6f 76 65 20 28 2d 67 74 68 72 65 61 64 2c 20 2d 71 74 68 72 65 61 64 2c 20 71 34 74 ..above.(-gthread,.-qthread,.q4t
0f60 68 72 65 61 64 2c 20 2d 77 74 68 72 65 61 64 20 6f 72 20 2d 70 79 6c 61 62 29 2e 0a 0a 20 20 20 hread,.-wthread.or.-pylab)......
0f80 20 20 20 20 20 20 20 20 20 20 20 49 66 20 2d 74 6b 20 69 73 20 67 69 76 65 6e 2c 20 49 50 79 74 ...........If.-tk.is.given,.IPyt
0fa0 68 6f 6e 20 77 69 6c 6c 20 74 72 79 20 74 6f 20 63 6f 6f 72 64 69 6e 61 74 65 20 54 6b 20 74 68 hon.will.try.to.coordinate.Tk.th
0fc0 72 65 61 64 69 6e 67 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 77 69 74 68 20 47 54 4b 2c 20 reading...............with.GTK,.
0fe0 51 54 20 6f 72 20 57 58 2e 20 20 54 68 69 73 20 69 73 20 68 6f 77 65 76 65 72 20 70 6f 74 65 6e QT.or.WX...This.is.however.poten
1000 74 69 61 6c 6c 79 20 75 6e 72 65 6c 69 61 62 6c 65 2c 20 61 6e 64 0a 20 20 20 20 20 20 20 20 20 tially.unreliable,.and..........
1020 20 20 20 20 20 79 6f 75 20 77 69 6c 6c 20 68 61 76 65 20 74 6f 20 74 65 73 74 20 6f 6e 20 79 6f .....you.will.have.to.test.on.yo
1040 75 72 20 70 6c 61 74 66 6f 72 6d 20 61 6e 64 20 50 79 74 68 6f 6e 20 63 6f 6e 66 69 67 75 72 61 ur.platform.and.Python.configura
1060 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 tion...............to.determine.
1080 77 68 65 74 68 65 72 20 69 74 20 77 6f 72 6b 73 20 66 6f 72 20 79 6f 75 2e 20 20 44 65 62 69 61 whether.it.works.for.you...Debia
10a0 6e 20 75 73 65 72 73 20 68 61 76 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 70 6f 72 n.users.have...............repor
10c0 74 65 64 20 73 75 63 63 65 73 73 2c 20 61 70 70 61 72 65 6e 74 6c 79 20 64 75 65 20 74 6f 20 74 ted.success,.apparently.due.to.t
10e0 68 65 20 66 61 63 74 20 74 68 61 74 20 44 65 62 69 61 6e 20 62 75 69 6c 64 73 0a 20 20 20 20 20 he.fact.that.Debian.builds......
1100 20 20 20 20 20 20 20 20 20 61 6c 6c 20 6f 66 20 54 63 6c 2c 20 54 6b 2c 20 54 6b 69 6e 74 65 72 .........all.of.Tcl,.Tk,.Tkinter
1120 20 61 6e 64 20 50 79 74 68 6f 6e 20 77 69 74 68 20 70 74 68 72 65 61 64 73 20 73 75 70 70 6f 72 .and.Python.with.pthreads.suppor
1140 74 2e 20 20 55 6e 64 65 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f 74 68 65 72 20 4c 69 t...Under...............other.Li
1160 6e 75 78 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 73 20 28 73 75 63 68 20 61 73 20 46 65 64 6f 72 61 nux.environments.(such.as.Fedora
1180 20 43 6f 72 65 20 32 2f 33 29 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 .Core.2/3),.this.option.........
11a0 20 20 20 20 20 20 68 61 73 20 63 61 75 73 65 64 20 72 61 6e 64 6f 6d 20 63 72 61 73 68 65 73 20 ......has.caused.random.crashes.
11c0 61 6e 64 20 6c 6f 63 6b 75 70 73 20 6f 66 20 74 68 65 20 50 79 74 68 6f 6e 20 69 6e 74 65 72 70 and.lockups.of.the.Python.interp
11e0 72 65 74 65 72 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 55 6e 64 65 72 20 6f 74 68 65 72 reter................Under.other
1200 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 73 20 28 4d 61 63 20 4f 53 58 20 61 6e 64 20 .operating.systems.(Mac.OSX.and.
1220 57 69 6e 64 6f 77 73 29 2c 20 79 6f 75 27 6c 6c 20 6e 65 65 64 0a 20 20 20 20 20 20 20 20 20 20 Windows),.you'll.need...........
1240 20 20 20 20 74 6f 20 74 72 79 20 69 74 20 74 6f 20 66 69 6e 64 20 6f 75 74 2c 20 73 69 6e 63 65 ....to.try.it.to.find.out,.since
1260 20 63 75 72 72 65 6e 74 6c 79 20 6e 6f 20 75 73 65 72 20 72 65 70 6f 72 74 73 20 61 72 65 0a 20 .currently.no.user.reports.are..
1280 20 20 20 20 20 20 20 20 20 20 20 20 20 61 76 61 69 6c 61 62 6c 65 2e 0a 0a 20 20 20 20 20 20 20 .............available..........
12a0 20 20 20 20 20 20 20 54 68 65 72 65 20 69 73 20 75 6e 66 6f 72 74 75 6e 61 74 65 6c 79 20 6e 6f .......There.is.unfortunately.no
12c0 20 77 61 79 20 66 6f 72 20 49 50 79 74 68 6f 6e 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 20 61 .way.for.IPython.to.determine..a
12e0 74 20 20 72 75 6e 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 69 6d 65 20 20 77 68 65 74 t..run-...............time..whet
1300 68 65 72 20 2d 74 6b 20 77 69 6c 6c 20 77 6f 72 6b 20 72 65 6c 69 61 62 6c 79 20 6f 72 20 6e 6f her.-tk.will.work.reliably.or.no
1320 74 2c 20 73 6f 20 79 6f 75 20 77 69 6c 6c 20 6e 65 65 64 20 74 6f 0a 20 20 20 20 20 20 20 20 20 t,.so.you.will.need.to..........
1340 20 20 20 20 20 64 6f 20 73 6f 6d 65 20 65 78 70 65 72 69 6d 65 6e 74 73 20 62 65 66 6f 72 65 20 .....do.some.experiments.before.
1360 72 65 6c 79 69 6e 67 20 6f 6e 20 69 74 20 66 6f 72 20 72 65 67 75 6c 61 72 20 77 6f 72 6b 2e 0a relying.on.it.for.regular.work..
1380 0a 41 20 57 41 52 4e 49 4e 47 20 41 42 4f 55 54 20 53 49 47 4e 41 4c 53 20 41 4e 44 20 54 48 52 .A.WARNING.ABOUT.SIGNALS.AND.THR
13a0 45 41 44 53 0a 0a 20 20 20 20 20 20 20 57 68 65 6e 20 61 6e 79 20 6f 66 20 74 68 65 20 74 68 72 EADS.........When.any.of.the.thr
13c0 65 61 64 20 73 79 73 74 65 6d 73 20 28 47 54 4b 2c 20 51 54 20 6f 72 20 57 58 29 20 61 72 65 20 ead.systems.(GTK,.QT.or.WX).are.
13e0 61 63 74 69 76 65 2c 20 65 69 74 68 65 72 0a 20 20 20 20 20 20 20 64 69 72 65 63 74 6c 79 20 6f active,.either........directly.o
1400 72 20 76 69 61 20 2d 70 79 6c 61 62 20 77 69 74 68 20 61 20 74 68 72 65 61 64 65 64 20 62 61 63 r.via.-pylab.with.a.threaded.bac
1420 6b 65 6e 64 2c 20 69 74 20 69 73 20 69 6d 70 6f 73 73 69 62 6c 65 20 74 6f 0a 20 20 20 20 20 20 kend,.it.is.impossible.to.......
1440 20 69 6e 74 65 72 72 75 70 74 20 6c 6f 6e 67 2d 72 75 6e 6e 69 6e 67 20 50 79 74 68 6f 6e 20 63 .interrupt.long-running.Python.c
1460 6f 64 65 20 76 69 61 20 43 74 72 6c 2d 43 2e 20 20 49 50 79 74 68 6f 6e 20 63 61 6e 20 6e 6f 74 ode.via.Ctrl-C...IPython.can.not
1480 20 70 61 73 73 0a 20 20 20 20 20 20 20 74 68 65 20 4b 65 79 62 6f 61 72 64 49 6e 74 65 72 72 75 .pass........the.KeyboardInterru
14a0 70 74 20 65 78 63 65 70 74 69 6f 6e 20 28 6f 72 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 pt.exception.(or.the.underlying.
14c0 53 49 47 49 4e 54 29 20 61 63 72 6f 73 73 0a 20 20 20 20 20 20 20 74 68 72 65 61 64 73 2c 20 73 SIGINT).across........threads,.s
14e0 6f 20 61 6e 79 20 6c 6f 6e 67 2d 72 75 6e 6e 69 6e 67 20 70 72 6f 63 65 73 73 20 73 74 61 72 74 o.any.long-running.process.start
1500 65 64 20 66 72 6f 6d 20 49 50 79 74 68 6f 6e 20 77 69 6c 6c 20 72 75 6e 20 74 6f 0a 20 20 20 20 ed.from.IPython.will.run.to.....
1520 20 20 20 63 6f 6d 70 6c 65 74 69 6f 6e 2c 20 6f 72 20 77 69 6c 6c 20 68 61 76 65 20 74 6f 20 62 ...completion,.or.will.have.to.b
1540 65 20 6b 69 6c 6c 65 64 20 76 69 61 20 61 6e 20 65 78 74 65 72 6e 61 6c 20 28 4f 53 2d 62 61 73 e.killed.via.an.external.(OS-bas
1560 65 64 29 0a 20 20 20 20 20 20 20 6d 65 63 68 61 6e 69 73 6d 2e 0a 0a 20 20 20 20 20 20 20 54 6f ed)........mechanism..........To
1580 20 74 68 65 20 62 65 73 74 20 6f 66 20 6d 79 20 6b 6e 6f 77 6c 65 64 67 65 2c 20 74 68 69 73 20 .the.best.of.my.knowledge,.this.
15a0 6c 69 6d 69 74 61 74 69 6f 6e 20 69 73 20 69 6d 70 6f 73 65 64 20 62 79 20 74 68 65 20 50 79 74 limitation.is.imposed.by.the.Pyt
15c0 68 6f 6e 0a 20 20 20 20 20 20 20 69 6e 74 65 72 70 72 65 74 65 72 20 69 74 73 65 6c 66 2c 20 61 hon........interpreter.itself,.a
15e0 6e 64 20 69 74 20 63 6f 6d 65 73 20 66 72 6f 6d 20 74 68 65 20 64 69 66 66 69 63 75 6c 74 79 20 nd.it.comes.from.the.difficulty.
1600 6f 66 20 77 72 69 74 69 6e 67 0a 20 20 20 20 20 20 20 70 6f 72 74 61 62 6c 65 20 73 69 67 6e 61 of.writing........portable.signa
1620 6c 2f 74 68 72 65 61 64 65 64 20 63 6f 64 65 2e 20 20 49 66 20 61 6e 79 20 75 73 65 72 20 69 73 l/threaded.code...If.any.user.is
1640 20 61 6e 20 65 78 70 65 72 74 20 6f 6e 20 74 68 69 73 20 74 6f 70 69 63 0a 20 20 20 20 20 20 20 .an.expert.on.this.topic........
1660 61 6e 64 20 63 61 6e 20 73 75 67 67 65 73 74 20 61 20 62 65 74 74 65 72 20 73 6f 6c 75 74 69 6f and.can.suggest.a.better.solutio
1680 6e 2c 20 49 20 77 6f 75 6c 64 20 6c 6f 76 65 20 74 6f 20 68 65 61 72 20 61 62 6f 75 74 20 69 74 n,.I.would.love.to.hear.about.it
16a0 2e 20 20 49 6e 0a 20 20 20 20 20 20 20 74 68 65 20 49 50 79 74 68 6f 6e 20 73 6f 75 72 63 65 73 ...In........the.IPython.sources
16c0 2c 20 6c 6f 6f 6b 20 61 74 20 74 68 65 20 53 68 65 6c 6c 2e 70 79 20 6d 6f 64 75 6c 65 2c 20 61 ,.look.at.the.Shell.py.module,.a
16e0 6e 64 20 69 6e 20 70 61 72 74 69 63 75 6c 61 72 20 61 74 0a 20 20 20 20 20 20 20 74 68 65 20 72 nd.in.particular.at........the.r
1700 75 6e 63 6f 64 65 28 29 20 6d 65 74 68 6f 64 2e 0a 0a 52 45 47 55 4c 41 52 20 4f 50 54 49 4f 4e uncode().method...REGULAR.OPTION
1720 53 0a 20 20 20 20 20 20 20 41 66 74 65 72 20 74 68 65 20 61 62 6f 76 65 20 74 68 72 65 61 64 69 S........After.the.above.threadi
1740 6e 67 20 6f 70 74 69 6f 6e 73 20 68 61 76 65 20 62 65 65 6e 20 67 69 76 65 6e 2c 20 72 65 67 75 ng.options.have.been.given,.regu
1760 6c 61 72 20 6f 70 74 69 6f 6e 73 20 20 63 61 6e 0a 20 20 20 20 20 20 20 66 6f 6c 6c 6f 77 20 20 lar.options..can........follow..
1780 69 6e 20 61 6e 79 20 6f 72 64 65 72 2e 20 20 41 6c 6c 20 6f 70 74 69 6f 6e 73 20 63 61 6e 20 62 in.any.order...All.options.can.b
17a0 65 20 61 62 62 72 65 76 69 61 74 65 64 20 74 6f 20 74 68 65 69 72 20 73 68 6f 72 74 65 73 74 0a e.abbreviated.to.their.shortest.
17c0 20 20 20 20 20 20 20 6e 6f 6e 2d 61 6d 62 69 67 75 6f 75 73 20 66 6f 72 6d 20 61 6e 64 20 61 72 .......non-ambiguous.form.and.ar
17e0 65 20 63 61 73 65 2d 73 65 6e 73 69 74 69 76 65 2e 20 20 4f 6e 65 20 6f 72 20 74 77 6f 20 20 64 e.case-sensitive...One.or.two..d
1800 61 73 68 65 73 20 20 63 61 6e 20 20 62 65 0a 20 20 20 20 20 20 20 75 73 65 64 2e 20 20 20 53 6f ashes..can..be........used....So
1820 6d 65 20 6f 70 74 69 6f 6e 73 20 68 61 76 65 20 61 6e 20 61 6c 74 65 72 6e 61 74 65 20 73 68 6f me.options.have.an.alternate.sho
1840 72 74 20 66 6f 72 6d 2c 20 69 6e 64 69 63 61 74 65 64 20 61 66 74 65 72 20 61 20 7c 2e 0a 0a 20 rt.form,.indicated.after.a.|....
1860 20 20 20 20 20 20 4d 6f 73 74 20 6f 70 74 69 6f 6e 73 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 73 ......Most.options.can.also.be.s
1880 65 74 20 66 72 6f 6d 20 79 6f 75 72 20 20 69 70 79 74 68 6f 6e 72 63 20 20 63 6f 6e 66 69 67 75 et.from.your..ipythonrc..configu
18a0 72 61 74 69 6f 6e 20 20 66 69 6c 65 2e 0a 20 20 20 20 20 20 20 53 65 65 20 74 68 65 20 70 72 6f ration..file.........See.the.pro
18c0 76 69 64 65 64 20 65 78 61 6d 70 6c 65 73 20 66 6f 72 20 61 73 73 69 73 74 61 6e 63 65 2e 20 20 vided.examples.for.assistance...
18e0 4f 70 74 69 6f 6e 73 20 67 69 76 65 6e 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 2d 0a 20 20 20 Options.given.on.the.comman-....
1900 20 20 20 20 64 6c 69 6e 65 20 6f 76 65 72 72 69 64 65 20 74 68 65 20 76 61 6c 75 65 73 20 73 65 ....dline.override.the.values.se
1920 74 20 69 6e 20 74 68 65 20 69 70 79 74 68 6f 6e 72 63 20 66 69 6c 65 2e 0a 0a 20 20 20 20 20 20 t.in.the.ipythonrc.file.........
1940 20 41 6c 6c 20 6f 70 74 69 6f 6e 73 20 77 69 74 68 20 61 20 5b 6e 6f 5d 20 70 72 65 70 65 6e 64 .All.options.with.a.[no].prepend
1960 65 64 20 63 61 6e 20 62 65 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 6e 65 67 61 74 65 64 20 66 ed.can.be.specified.in.negated.f
1980 6f 72 6d 0a 20 20 20 20 20 20 20 28 75 73 69 6e 67 20 2d 6e 6f 6f 70 74 69 6f 6e 20 69 6e 73 74 orm........(using.-nooption.inst
19a0 65 61 64 20 6f 66 20 2d 6f 70 74 69 6f 6e 29 20 74 6f 20 74 75 72 6e 20 74 68 65 20 66 65 61 74 ead.of.-option).to.turn.the.feat
19c0 75 72 65 20 6f 66 66 2e 0a 0a 20 20 20 20 20 20 20 2d 68 2c 20 2d 2d 68 65 6c 70 0a 20 20 20 20 ure.off..........-h,.--help.....
19e0 20 20 20 20 20 20 20 20 20 20 53 68 6f 77 20 73 75 6d 6d 61 72 79 20 6f 66 20 6f 70 74 69 6f 6e ..........Show.summary.of.option
1a00 73 2e 0a 0a 20 20 20 20 20 20 20 2d 70 79 6c 61 62 20 54 68 69 73 20 63 61 6e 20 6f 6e 6c 79 20 s..........-pylab.This.can.only.
1a20 62 65 20 67 69 76 65 6e 20 61 73 20 74 68 65 20 66 69 72 73 74 20 6f 70 74 69 6f 6e 20 70 61 73 be.given.as.the.first.option.pas
1a40 73 65 64 20 74 6f 20 49 50 79 74 68 6f 6e 20 28 69 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 sed.to.IPython.(it..............
1a60 20 77 69 6c 6c 20 68 61 76 65 20 6e 6f 20 65 66 66 65 63 74 20 69 6e 20 61 6e 79 20 6f 74 68 65 .will.have.no.effect.in.any.othe
1a80 72 20 70 6f 73 69 74 69 6f 6e 29 2e 20 49 74 20 61 64 64 73 20 73 70 65 63 69 61 6c 20 73 75 70 r.position)..It.adds.special.sup
1aa0 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 6f 72 74 20 20 20 66 6f 72 20 20 74 68 65 20 -...............port...for..the.
1ac0 20 6d 61 74 70 6c 6f 74 6c 69 62 20 20 6c 69 62 72 61 72 79 20 20 28 68 74 74 70 3a 2f 2f 6d 61 .matplotlib..library..(http://ma
1ae0 74 70 6c 6f 74 6c 69 62 2e 73 6f 75 72 63 65 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 tplotlib.source-...............f
1b00 6f 72 67 65 2e 6e 65 74 29 2c 20 61 6c 6c 6f 77 69 6e 67 20 69 6e 74 65 72 61 63 74 69 76 65 20 orge.net),.allowing.interactive.
1b20 75 73 61 67 65 20 6f 66 20 61 6e 79 20 6f 66 20 69 74 73 20 62 61 63 6b 65 6e 64 73 20 61 73 0a usage.of.any.of.its.backends.as.
1b40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 65 66 69 6e 65 64 20 20 69 6e 20 20 74 68 65 20 20 ..............defined..in..the..
1b60 75 73 65 72 27 73 20 20 2e 6d 61 74 70 6c 6f 74 6c 69 62 72 63 20 20 66 69 6c 65 2e 20 20 49 74 user's...matplotlibrc..file...It
1b80 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 63 74 .automatically...............act
1ba0 69 76 61 74 65 73 20 47 54 4b 20 6f 72 20 57 58 20 74 68 72 65 61 64 69 6e 67 20 66 6f 72 20 49 ivates.GTK.or.WX.threading.for.I
1bc0 50 79 68 74 6f 6e 20 69 66 20 74 68 65 20 63 68 6f 69 63 65 20 6f 66 20 20 6d 61 74 2d 0a 20 20 Pyhton.if.the.choice.of..mat-...
1be0 20 20 20 20 20 20 20 20 20 20 20 20 70 6c 6f 74 6c 69 62 20 20 62 61 63 6b 65 6e 64 20 72 65 71 ............plotlib..backend.req
1c00 75 69 72 65 73 20 69 74 2e 20 20 49 74 20 61 6c 73 6f 20 6d 6f 64 69 66 69 65 73 20 74 68 65 20 uires.it...It.also.modifies.the.
1c20 40 72 75 6e 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 6f 20 63 6f @run.command...............to.co
1c40 72 72 65 63 74 6c 79 20 65 78 65 63 75 74 65 20 20 28 77 69 74 68 6f 75 74 20 20 62 6c 6f 63 6b rrectly.execute..(without..block
1c60 69 6e 67 29 20 20 61 6e 79 20 20 6d 61 74 70 6c 6f 74 6c 69 62 2d 62 61 73 65 64 0a 20 20 20 20 ing)..any..matplotlib-based.....
1c80 20 20 20 20 20 20 20 20 20 20 73 63 72 69 70 74 20 77 68 69 63 68 20 63 61 6c 6c 73 20 73 68 6f ..........script.which.calls.sho
1ca0 77 28 29 20 61 74 20 74 68 65 20 65 6e 64 2e 0a 0a 20 20 20 20 20 20 20 2d 61 75 74 6f 63 61 6c w().at.the.end..........-autocal
1cc0 6c 20 3c 76 61 6c 3e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4d 61 6b 65 20 49 50 79 74 68 l.<val>...............Make.IPyth
1ce0 6f 6e 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 61 6c 6c 20 61 6e 79 20 63 61 6c 6c 61 62 on.automatically.call.any.callab
1d00 6c 65 20 6f 62 6a 65 63 74 20 65 76 65 6e 20 69 66 20 79 6f 75 0a 20 20 20 20 20 20 20 20 20 20 le.object.even.if.you...........
1d20 20 20 20 20 64 69 64 6e 27 74 20 74 79 70 65 20 65 78 70 6c 69 63 69 74 20 70 61 72 65 6e 74 68 ....didn't.type.explicit.parenth
1d40 65 73 65 73 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 27 73 74 72 20 34 33 27 20 62 65 63 6f eses..For.example,.'str.43'.beco
1d60 6d 65 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 27 73 74 72 28 34 33 29 27 20 61 75 74 6f mes...............'str(43)'.auto
1d80 6d 61 74 69 63 61 6c 6c 79 2e 20 20 54 68 65 20 76 61 6c 75 65 20 63 61 6e 20 62 65 20 27 30 27 matically...The.value.can.be.'0'
1da0 20 74 6f 20 64 69 73 61 62 6c 65 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 65 .to.disable.the...............fe
1dc0 61 74 75 72 65 2c 20 27 31 27 20 66 6f 72 20 27 73 6d 61 72 74 27 20 61 75 74 6f 63 61 6c 6c 2c ature,.'1'.for.'smart'.autocall,
1de0 20 77 68 65 72 65 20 69 74 20 69 73 20 6e 6f 74 20 61 70 70 6c 69 65 64 20 69 66 0a 20 20 20 20 .where.it.is.not.applied.if.....
1e00 20 20 20 20 20 20 20 20 20 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6d 6f 72 65 20 61 72 67 75 ..........there.are.no.more.argu
1e20 6d 65 6e 74 73 20 6f 6e 20 74 68 65 20 6c 69 6e 65 2c 20 61 6e 64 20 27 32 27 20 66 6f 72 20 27 ments.on.the.line,.and.'2'.for.'
1e40 66 75 6c 6c 27 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 75 74 6f 63 61 6c 6c 2c 20 77 68 full'...............autocall,.wh
1e60 65 72 65 20 61 6c 6c 20 63 61 6c 6c 61 62 6c 65 20 6f 62 6a 65 63 74 73 20 61 72 65 20 61 75 74 ere.all.callable.objects.are.aut
1e80 6f 6d 61 74 69 63 61 6c 6c 79 20 63 61 6c 6c 65 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 omatically.called...............
1ea0 28 65 76 65 6e 20 69 66 20 6e 6f 20 61 72 67 75 6d 65 6e 74 73 20 61 72 65 20 70 72 65 73 65 6e (even.if.no.arguments.are.presen
1ec0 74 29 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 27 31 27 2e 0a 0a 20 20 20 20 20 20 t)...The.default.is.'1'.........
1ee0 20 2d 5b 6e 6f 5d 61 75 74 6f 69 6e 64 65 6e 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 .-[no]autoindent...............T
1f00 75 72 6e 20 61 75 74 6f 6d 61 74 69 63 20 69 6e 64 65 6e 74 61 74 69 6f 6e 20 6f 6e 2f 6f 66 66 urn.automatic.indentation.on/off
1f20 2e 0a 0a 20 20 20 20 20 20 20 2d 5b 6e 6f 5d 61 75 74 6f 6d 61 67 69 63 0a 20 20 20 20 20 20 20 ..........-[no]automagic........
1f40 20 20 20 20 20 20 20 4d 61 6b 65 20 6d 61 67 69 63 20 63 6f 6d 6d 61 6e 64 73 20 61 75 74 6f 6d .......Make.magic.commands.autom
1f60 61 74 69 63 20 28 77 69 74 68 6f 75 74 20 6e 65 65 64 69 6e 67 20 74 68 65 69 72 20 66 69 72 73 atic.(without.needing.their.firs
1f80 74 20 63 68 61 72 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 63 74 65 72 20 74 6f 20 62 t.char-...............acter.to.b
1fa0 65 20 25 29 2e 20 20 54 79 70 65 20 25 6d 61 67 69 63 20 61 74 20 20 74 68 65 20 20 49 50 79 74 e.%)...Type.%magic.at..the..IPyt
1fc0 68 6f 6e 20 20 70 72 6f 6d 70 74 20 20 66 6f 72 20 20 6d 6f 72 65 0a 20 20 20 20 20 20 20 20 20 hon..prompt..for..more..........
1fe0 20 20 20 20 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 0a 20 20 20 20 20 20 20 2d 5b 6e 6f 5d 61 .....information..........-[no]a
2000 75 74 6f 65 64 69 74 5f 73 79 6e 74 61 78 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 57 68 65 utoedit_syntax...............Whe
2020 6e 20 61 20 73 79 6e 74 61 78 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 61 66 74 65 72 20 65 64 n.a.syntax.error.occurs.after.ed
2040 69 74 69 6e 67 20 61 20 66 69 6c 65 2c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 20 20 20 20 iting.a.file,.automatically.....
2060 20 20 20 20 20 20 20 20 20 20 6f 70 65 6e 20 74 68 65 20 66 69 6c 65 20 74 6f 20 74 68 65 20 74 ..........open.the.file.to.the.t
2080 72 6f 75 62 6c 65 20 63 61 75 73 69 6e 67 20 6c 69 6e 65 20 66 6f 72 20 63 6f 6e 76 65 6e 69 65 rouble.causing.line.for.convenie
20a0 6e 74 20 66 69 78 69 6e 67 2e 0a 0a 20 20 20 20 20 20 20 2d 5b 6e 6f 5d 62 61 6e 6e 65 72 0a 20 nt.fixing..........-[no]banner..
20c0 20 20 20 20 20 20 20 20 20 20 20 20 20 50 72 69 6e 74 20 74 68 65 20 69 6e 74 69 61 6c 20 69 6e .............Print.the.intial.in
20e0 66 6f 72 6d 61 74 69 6f 6e 20 62 61 6e 6e 65 72 20 28 64 65 66 61 75 6c 74 20 6f 6e 29 2e 0a 0a formation.banner.(default.on)...
2100 20 20 20 20 20 20 20 2d 63 20 3c 63 6f 6d 6d 61 6e 64 3e 0a 20 20 20 20 20 20 20 20 20 20 20 20 .......-c.<command>.............
2120 20 20 45 78 65 63 75 74 65 20 20 74 68 65 20 20 67 69 76 65 6e 20 20 63 6f 6d 6d 61 6e 64 20 20 ..Execute..the..given..command..
2140 73 74 72 69 6e 67 2c 20 61 6e 64 20 73 65 74 20 73 79 73 2e 61 72 67 76 20 74 6f 20 5b 27 63 27 string,.and.set.sys.argv.to.['c'
2160 5d 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 68 69 73 20 69 73 20 73 69 6d 69 6c 61 72 ]................This.is.similar
2180 20 74 6f 20 74 68 65 20 2d 63 20 6f 70 74 69 6f 6e 20 69 6e 20 20 74 68 65 20 20 6e 6f 72 6d 61 .to.the.-c.option.in..the..norma
21a0 6c 20 20 50 79 74 68 6f 6e 20 20 69 6e 74 65 72 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l..Python..inter-...............
21c0 70 72 65 74 65 72 2e 0a 0a 20 20 20 20 20 20 20 2d 63 61 63 68 65 5f 73 69 7a 65 7c 63 73 20 3c preter..........-cache_size|cs.<
21e0 6e 3e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 69 7a 65 20 20 6f 66 20 20 74 68 65 20 6f n>...............Size..of..the.o
2200 75 74 70 75 74 20 63 61 63 68 65 20 28 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 65 utput.cache.(maximum.number.of.e
2220 6e 74 72 69 65 73 20 74 6f 20 68 6f 6c 64 20 69 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ntries.to.hold.in...............
2240 6d 65 6d 6f 72 79 29 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 31 30 30 30 2c 20 79 memory)...The.default.is.1000,.y
2260 6f 75 20 63 61 6e 20 63 68 61 6e 67 65 20 69 74 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 20 69 6e ou.can.change.it.permanently..in
2280 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 79 6f 75 72 20 20 63 6f 6e 66 69 67 20 20 66 69 6c ...............your..config..fil
22a0 65 2e 20 20 20 53 65 74 74 69 6e 67 20 20 69 74 20 20 74 6f 20 20 30 20 63 6f 6d 70 6c 65 74 65 e....Setting..it..to..0.complete
22c0 6c 79 20 64 69 73 61 62 6c 65 73 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 ly.disables.the...............ca
22e0 63 68 69 6e 67 20 73 79 73 74 65 6d 2c 20 61 6e 64 20 74 68 65 20 6d 69 6e 69 6d 75 6d 20 76 61 ching.system,.and.the.minimum.va
2300 6c 75 65 20 61 63 63 65 70 74 65 64 20 20 69 73 20 20 32 30 20 20 28 69 66 20 20 79 6f 75 0a 20 lue.accepted..is..20..(if..you..
2320 20 20 20 20 20 20 20 20 20 20 20 20 20 70 72 6f 76 69 64 65 20 20 61 20 76 61 6c 75 65 20 6c 65 .............provide..a.value.le
2340 73 73 20 74 68 61 6e 20 32 30 2c 20 69 74 20 69 73 20 72 65 73 65 74 20 74 6f 20 30 20 61 6e 64 ss.than.20,.it.is.reset.to.0.and
2360 20 61 20 77 61 72 6e 69 6e 67 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 73 73 75 .a.warning.is...............issu
2380 65 64 29 2e 20 20 54 68 69 73 20 6c 69 6d 69 74 20 69 73 20 64 65 66 69 6e 65 64 20 62 65 63 61 ed)...This.limit.is.defined.beca
23a0 75 73 65 20 6f 74 68 65 72 77 69 73 65 20 20 79 6f 75 27 6c 6c 20 20 73 70 65 6e 64 0a 20 20 20 use.otherwise..you'll..spend....
23c0 20 20 20 20 20 20 20 20 20 20 20 6d 6f 72 65 20 74 69 6d 65 20 72 65 2d 66 6c 75 73 68 69 6e 67 ...........more.time.re-flushing
23e0 20 61 20 74 6f 6f 20 73 6d 61 6c 6c 20 63 61 63 68 65 20 74 68 61 6e 20 77 6f 72 6b 69 6e 67 2e .a.too.small.cache.than.working.
2400 0a 0a 20 20 20 20 20 20 20 2d 63 6c 61 73 73 69 63 7c 63 6c 0a 20 20 20 20 20 20 20 20 20 20 20 .........-classic|cl............
2420 20 20 20 47 69 76 65 73 20 49 50 79 74 68 6f 6e 20 61 20 73 69 6d 69 6c 61 72 20 66 65 65 6c 20 ...Gives.IPython.a.similar.feel.
2440 74 6f 20 74 68 65 20 63 6c 61 73 73 69 63 20 50 79 74 68 6f 6e 20 70 72 6f 6d 70 74 2e 0a 0a 20 to.the.classic.Python.prompt....
2460 20 20 20 20 20 20 2d 63 6f 6c 6f 72 73 20 3c 73 63 68 65 6d 65 3e 0a 20 20 20 20 20 20 20 20 20 ......-colors.<scheme>..........
2480 20 20 20 20 20 43 6f 6c 6f 72 20 20 73 63 68 65 6d 65 20 20 66 6f 72 20 20 70 72 6f 6d 70 74 73 .....Color..scheme..for..prompts
24a0 20 20 61 6e 64 20 65 78 63 65 70 74 69 6f 6e 20 72 65 70 6f 72 74 69 6e 67 2e 20 20 43 75 72 72 ..and.exception.reporting...Curr
24c0 65 6e 74 6c 79 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6d 70 6c 65 6d 65 6e 74 65 64 3a ently...............implemented:
24e0 20 4e 6f 43 6f 6c 6f 72 2c 20 4c 69 6e 75 78 2c 20 61 6e 64 20 4c 69 67 68 74 42 47 2e 0a 0a 20 .NoColor,.Linux,.and.LightBG....
2500 20 20 20 20 20 20 2d 5b 6e 6f 5d 63 6f 6c 6f 72 5f 69 6e 66 6f 0a 20 20 20 20 20 20 20 20 20 20 ......-[no]color_info...........
2520 20 20 20 20 49 50 79 74 68 6f 6e 20 63 61 6e 20 64 69 73 70 6c 61 79 20 69 6e 66 6f 72 6d 61 74 ....IPython.can.display.informat
2540 69 6f 6e 20 61 62 6f 75 74 20 6f 62 6a 65 63 74 73 20 76 69 61 20 61 20 73 65 74 20 6f 66 20 66 ion.about.objects.via.a.set.of.f
2560 75 6e 63 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 69 6f 6e 73 2c 20 61 6e 64 20 6f 70 unc-...............tions,.and.op
2580 74 69 6f 6e 61 6c 6c 79 20 63 61 6e 20 75 73 65 20 63 6f 6c 6f 72 73 20 66 6f 72 20 74 68 69 73 tionally.can.use.colors.for.this
25a0 2c 20 73 79 6e 74 61 78 20 68 69 67 68 6c 69 67 68 74 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ,.syntax.highlight-.............
25c0 20 20 69 6e 67 20 73 6f 75 72 63 65 20 63 6f 64 65 20 61 6e 64 20 76 61 72 69 6f 75 73 20 6f 74 ..ing.source.code.and.various.ot
25e0 68 65 72 20 20 65 6c 65 6d 65 6e 74 73 2e 20 20 20 48 6f 77 65 76 65 72 2c 20 20 62 65 63 61 75 her..elements....However,..becau
2600 73 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 69 73 20 20 69 6e 66 6f 72 6d 61 74 69 se...............this..informati
2620 6f 6e 20 20 69 73 20 20 70 61 73 73 65 64 20 20 74 68 72 6f 75 67 68 20 61 20 70 61 67 65 72 20 on..is..passed..through.a.pager.
2640 28 6c 69 6b 65 20 27 6c 65 73 73 27 29 20 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 (like.'less').and...............
2660 6d 61 6e 79 20 70 61 67 65 72 73 20 67 65 74 20 63 6f 6e 66 75 73 65 64 20 77 69 74 68 20 63 6f many.pagers.get.confused.with.co
2680 6c 6f 72 20 63 6f 64 65 73 2c 20 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 6f 66 66 20 62 79 lor.codes,.this.option.is.off.by
26a0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 65 66 61 75 6c 74 2e 20 20 20 59 6f 75 20 20 63 ...............default....You..c
26c0 61 6e 20 20 74 65 73 74 20 20 69 74 20 61 6e 64 20 74 75 72 6e 20 69 74 20 6f 6e 20 70 65 72 6d an..test..it.and.turn.it.on.perm
26e0 61 6e 65 6e 74 6c 79 20 69 6e 20 79 6f 75 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 70 anently.in.your...............ip
2700 79 74 68 6f 6e 72 63 20 66 69 6c 65 20 69 66 20 69 74 20 77 6f 72 6b 73 20 66 6f 72 20 79 6f 75 ythonrc.file.if.it.works.for.you
2720 2e 20 20 41 73 20 61 20 72 65 66 65 72 65 6e 63 65 2c 20 74 68 65 20 20 27 6c 65 73 73 27 0a 20 ...As.a.reference,.the..'less'..
2740 20 20 20 20 20 20 20 20 20 20 20 20 20 70 61 67 65 72 20 20 73 75 70 70 6c 69 65 64 20 20 77 69 .............pager..supplied..wi
2760 74 68 20 20 4d 61 6e 64 72 61 6b 65 20 38 2e 32 20 77 6f 72 6b 73 20 6f 6b 2c 20 62 75 74 20 74 th..Mandrake.8.2.works.ok,.but.t
2780 68 61 74 20 69 6e 20 52 65 64 48 61 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 37 2e 32 20 hat.in.RedHat...............7.2.
27a0 64 6f 65 73 6e 27 74 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 65 73 74 20 69 74 20 doesn't.................Test.it.
27c0 61 6e 64 20 74 75 72 6e 20 69 74 20 6f 6e 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 69 66 20 69 74 and.turn.it.on.permanently.if.it
27e0 20 77 6f 72 6b 73 20 77 69 74 68 20 79 6f 75 72 20 73 79 73 74 65 6d 2e 0a 20 20 20 20 20 20 20 .works.with.your.system.........
2800 20 20 20 20 20 20 20 54 68 65 20 20 6d 61 67 69 63 20 66 75 6e 63 74 69 6f 6e 20 40 63 6f 6c 6f .......The..magic.function.@colo
2820 72 5f 69 6e 66 6f 20 61 6c 6c 6f 77 73 20 79 6f 75 20 74 6f 20 74 6f 67 67 6c 65 20 74 68 69 73 r_info.allows.you.to.toggle.this
2840 20 69 6e 74 65 72 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 63 74 69 76 65 6c 79 20 66 .inter-...............actively.f
2860 6f 72 20 74 65 73 74 69 6e 67 2e 0a 0a 20 20 20 20 20 20 20 2d 5b 6e 6f 5d 63 6f 6e 66 69 72 6d or.testing..........-[no]confirm
2880 5f 65 78 69 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 65 74 20 74 6f 20 63 6f 6e 66 69 _exit...............Set.to.confi
28a0 72 6d 20 77 68 65 6e 20 79 6f 75 20 74 72 79 20 74 6f 20 65 78 69 74 20 49 50 79 74 68 6f 6e 20 rm.when.you.try.to.exit.IPython.
28c0 77 69 74 68 20 20 61 6e 20 20 45 4f 46 20 20 28 43 6f 6e 2d 0a 20 20 20 20 20 20 20 20 20 20 20 with..an..EOF..(Con-............
28e0 20 20 20 74 72 6f 6c 2d 44 20 69 6e 20 55 6e 69 78 2c 20 43 6f 6e 74 72 6f 6c 2d 5a 2f 45 6e 74 ...trol-D.in.Unix,.Control-Z/Ent
2900 65 72 20 69 6e 20 57 69 6e 64 6f 77 73 29 2e 20 4e 6f 74 65 20 74 68 61 74 20 75 73 69 6e 67 20 er.in.Windows)..Note.that.using.
2920 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 61 67 69 63 20 66 75 6e 63 74 69 6f 6e the...............magic.function
2940 73 20 40 45 78 69 74 20 6f 72 20 40 51 75 69 74 20 79 6f 75 20 20 63 61 6e 20 20 66 6f 72 63 65 s.@Exit.or.@Quit.you..can..force
2960 20 20 61 20 20 64 69 72 65 63 74 20 20 65 78 69 74 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ..a..direct..exit,..............
2980 20 62 79 70 61 73 73 69 6e 67 20 61 6e 79 20 63 6f 6e 66 69 72 6d 61 74 69 6f 6e 2e 0a 0a 20 20 .bypassing.any.confirmation.....
29a0 20 20 20 20 20 2d 5b 6e 6f 5d 64 65 62 75 67 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 68 .....-[no]debug...............Sh
29c0 6f 77 20 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 20 61 62 6f 75 74 20 74 68 65 20 6c 6f 61 64 69 ow..information..about.the.loadi
29e0 6e 67 20 70 72 6f 63 65 73 73 2e 20 56 65 72 79 20 75 73 65 66 75 6c 20 74 6f 20 70 69 6e 0a 20 ng.process..Very.useful.to.pin..
2a00 20 20 20 20 20 20 20 20 20 20 20 20 20 64 6f 77 6e 20 70 72 6f 62 6c 65 6d 73 20 77 69 74 68 20 .............down.problems.with.
2a20 79 6f 75 72 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 69 6c 65 73 20 6f 72 20 20 74 6f 20 your.configuration.files.or..to.
2a40 20 67 65 74 20 20 64 65 74 61 69 6c 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 62 6f 75 .get..details...............abou
2a60 74 20 73 65 73 73 69 6f 6e 20 72 65 73 74 6f 72 65 73 2e 0a 0a 20 20 20 20 20 20 20 2d 5b 6e 6f t.session.restores..........-[no
2a80 5d 64 65 65 70 5f 72 65 6c 6f 61 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 50 79 74 68 ]deep_reload...............IPyth
2aa0 6f 6e 20 20 63 61 6e 20 75 73 65 20 74 68 65 20 64 65 65 70 5f 72 65 6c 6f 61 64 20 6d 6f 64 75 on..can.use.the.deep_reload.modu
2ac0 6c 65 20 77 68 69 63 68 20 72 65 6c 6f 61 64 73 20 63 68 61 6e 67 65 73 20 69 6e 0a 20 20 20 20 le.which.reloads.changes.in.....
2ae0 20 20 20 20 20 20 20 20 20 20 6d 6f 64 75 6c 65 73 20 72 65 63 75 72 73 69 76 65 6c 79 20 28 69 ..........modules.recursively.(i
2b00 74 20 72 65 70 6c 61 63 65 73 20 74 68 65 20 72 65 6c 6f 61 64 28 29 20 66 75 6e 63 74 69 6f 6e t.replaces.the.reload().function
2b20 2c 20 20 73 6f 20 20 79 6f 75 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 6f 6e 27 74 20 6e ,..so..you...............don't.n
2b40 65 65 64 20 74 6f 20 63 68 61 6e 67 65 20 61 6e 79 74 68 69 6e 67 20 74 6f 20 75 73 65 20 69 74 eed.to.change.anything.to.use.it
2b60 29 2e 20 64 65 65 70 5f 72 65 6c 6f 61 64 28 29 20 66 6f 72 63 65 73 20 61 0a 20 20 20 20 20 20 )..deep_reload().forces.a.......
2b80 20 20 20 20 20 20 20 20 66 75 6c 6c 20 72 65 6c 6f 61 64 20 6f 66 20 6d 6f 64 75 6c 65 73 20 77 ........full.reload.of.modules.w
2ba0 68 6f 73 65 20 63 6f 64 65 20 6d 61 79 20 68 61 76 65 20 20 63 68 61 6e 67 65 64 2c 20 20 77 68 hose.code.may.have..changed,..wh
2bc0 69 63 68 20 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 65 66 61 75 6c 74 20 72 ich..the...............default.r
2be0 65 6c 6f 61 64 28 29 20 66 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 2e 0a 0a 20 20 20 20 eload().function.does.not.......
2c00 20 20 20 20 20 20 20 20 20 20 57 68 65 6e 20 20 64 65 65 70 5f 72 65 6c 6f 61 64 20 20 69 73 20 ..........When..deep_reload..is.
2c20 6f 66 66 2c 20 49 50 79 74 68 6f 6e 20 77 69 6c 6c 20 75 73 65 20 74 68 65 20 6e 6f 72 6d 61 6c off,.IPython.will.use.the.normal
2c40 20 72 65 6c 6f 61 64 28 29 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 75 74 20 64 65 65 .reload(),...............but.dee
2c60 70 5f 72 65 6c 6f 61 64 20 77 69 6c 6c 20 73 74 69 6c 6c 20 62 65 20 61 76 61 69 6c 61 62 6c 65 p_reload.will.still.be.available
2c80 20 61 73 20 64 72 65 6c 6f 61 64 28 29 2e 20 54 68 69 73 20 20 66 65 61 2d 0a 20 20 20 20 20 20 .as.dreload()..This..fea-.......
2ca0 20 20 20 20 20 20 20 20 74 75 72 65 20 20 69 73 20 20 6f 66 66 20 20 62 79 20 64 65 66 61 75 6c ........ture..is..off..by.defaul
2cc0 74 20 5b 77 68 69 63 68 20 6d 65 61 6e 73 20 74 68 61 74 20 79 6f 75 20 68 61 76 65 20 62 6f 74 t.[which.means.that.you.have.bot
2ce0 68 20 6e 6f 72 6d 61 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 6c 6f 61 64 28 29 20 h.normal...............reload().
2d00 61 6e 64 20 64 72 65 6c 6f 61 64 28 29 5d 2e 0a 0a 20 20 20 20 20 20 20 2d 65 64 69 74 6f 72 20 and.dreload()]..........-editor.
2d20 3c 6e 61 6d 65 3e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 57 68 69 63 68 20 65 64 69 74 6f <name>...............Which.edito
2d40 72 20 74 6f 20 75 73 65 20 77 69 74 68 20 74 68 65 20 40 65 64 69 74 20 63 6f 6d 6d 61 6e 64 2e r.to.use.with.the.@edit.command.
2d60 20 42 79 20 64 65 66 61 75 6c 74 2c 20 20 49 50 79 74 68 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 .By.default,..IPython...........
2d80 20 20 20 20 77 69 6c 6c 20 20 68 6f 6e 6f 72 20 20 79 6f 75 72 20 45 44 49 54 4f 52 20 65 6e 76 ....will..honor..your.EDITOR.env
2da0 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 28 69 66 20 6e 6f 74 20 73 65 74 2c 20 76 ironment.variable.(if.not.set,.v
2dc0 69 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 55 6e 69 78 20 64 65 66 61 i.is...............the.Unix.defa
2de0 75 6c 74 20 61 6e 64 20 6e 6f 74 65 70 61 64 20 74 68 65 20 57 69 6e 64 6f 77 73 20 6f 6e 65 29 ult.and.notepad.the.Windows.one)
2e00 2e 20 53 69 6e 63 65 20 74 68 69 73 20 65 64 69 74 6f 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 ..Since.this.editor.............
2e20 20 20 69 73 20 20 69 6e 76 6f 6b 65 64 20 6f 6e 20 74 68 65 20 66 6c 79 20 62 79 20 49 50 79 74 ..is..invoked.on.the.fly.by.IPyt
2e40 68 6f 6e 20 61 6e 64 20 69 73 20 6d 65 61 6e 74 20 66 6f 72 20 65 64 69 74 69 6e 67 20 73 6d 61 hon.and.is.meant.for.editing.sma
2e60 6c 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 64 65 20 73 6e 69 70 70 65 74 73 2c 20 ll...............code.snippets,.
2e80 79 6f 75 20 6d 61 79 20 77 61 6e 74 20 74 6f 20 75 73 65 20 61 20 73 6d 61 6c 6c 2c 20 20 6c 69 you.may.want.to.use.a.small,..li
2ea0 67 68 74 77 65 69 67 68 74 20 20 65 64 69 74 6f 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ghtweight..editor...............
2ec0 68 65 72 65 20 28 69 6e 20 63 61 73 65 20 79 6f 75 72 20 64 65 66 61 75 6c 74 20 45 44 49 54 4f here.(in.case.your.default.EDITO
2ee0 52 20 69 73 20 73 6f 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 45 6d 61 63 73 29 2e 0a 0a 20 20 20 R.is.something.like.Emacs)......
2f00 20 20 20 20 2d 69 70 79 74 68 6f 6e 64 69 72 20 3c 6e 61 6d 65 3e 0a 20 20 20 20 20 20 20 20 20 ....-ipythondir.<name>..........
2f20 20 20 20 20 20 54 68 65 20 20 6e 61 6d 65 20 20 6f 66 20 20 79 6f 75 72 20 20 49 50 79 74 68 6f .....The..name..of..your..IPytho
2f40 6e 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 64 69 72 65 63 74 6f 72 79 20 49 50 59 54 48 4f n.configuration.directory.IPYTHO
2f60 4e 44 49 52 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 68 69 73 20 63 61 6e 20 61 6c 73 NDIR................This.can.als
2f80 6f 20 62 65 20 20 73 70 65 63 69 66 69 65 64 20 20 74 68 72 6f 75 67 68 20 20 74 68 65 20 20 65 o.be..specified..through..the..e
2fa0 6e 76 69 72 6f 6e 6d 65 6e 74 20 20 76 61 72 69 61 62 6c 65 0a 20 20 20 20 20 20 20 20 20 20 20 nvironment..variable............
2fc0 20 20 20 49 50 59 54 48 4f 4e 44 49 52 2e 0a 0a 20 20 20 20 20 20 20 2d 6c 6f 67 7c 6c 20 47 65 ...IPYTHONDIR..........-log|l.Ge
2fe0 6e 65 72 61 74 65 20 20 61 20 6c 6f 67 20 66 69 6c 65 20 6f 66 20 61 6c 6c 20 69 6e 70 75 74 2e nerate..a.log.file.of.all.input.
3000 20 54 68 65 20 66 69 6c 65 20 69 73 20 6e 61 6d 65 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 .The.file.is.named..............
3020 20 69 70 79 74 68 6f 6e 5f 6c 6f 67 2e 70 79 20 69 6e 20 79 6f 75 72 20 63 75 72 72 65 6e 74 20 .ipython_log.py.in.your.current.
3040 64 69 72 65 63 74 6f 72 79 20 28 77 68 69 63 68 20 70 72 65 76 65 6e 74 73 20 6c 6f 67 73 0a 20 directory.(which.prevents.logs..
3060 20 20 20 20 20 20 20 20 20 20 20 20 20 66 72 6f 6d 20 6d 75 6c 74 69 70 6c 65 20 49 50 79 74 68 .............from.multiple.IPyth
3080 6f 6e 20 73 65 73 73 69 6f 6e 73 20 66 72 6f 6d 20 74 72 61 6d 70 6c 69 6e 67 20 65 61 63 68 20 on.sessions.from.trampling.each.
30a0 6f 74 68 65 72 29 2e 20 59 6f 75 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 6e 20 75 73 other)..You...............can.us
30c0 65 20 74 68 69 73 20 74 6f 20 6c 61 74 65 72 20 72 65 73 74 6f 72 65 20 61 20 73 65 73 73 69 6f e.this.to.later.restore.a.sessio
30e0 6e 20 62 79 20 6c 6f 61 64 69 6e 67 20 79 6f 75 72 20 6c 6f 67 66 69 6c 65 0a 20 20 20 20 20 20 n.by.loading.your.logfile.......
3100 20 20 20 20 20 20 20 20 61 73 20 61 20 66 69 6c 65 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 ........as.a.file.to.be.executed
3120 20 77 69 74 68 20 6f 70 74 69 6f 6e 20 2d 6c 6f 67 70 6c 61 79 20 28 73 65 65 20 62 65 6c 6f 77 .with.option.-logplay.(see.below
3140 29 2e 0a 0a 20 20 20 20 20 20 20 2d 6c 6f 67 66 69 6c 65 7c 6c 66 0a 20 20 20 20 20 20 20 20 20 )..........-logfile|lf..........
3160 20 20 20 20 20 53 70 65 63 69 66 79 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 79 6f 75 72 20 6c 6f .....Specify.the.name.of.your.lo
3180 67 66 69 6c 65 2e 0a 0a 20 20 20 20 20 20 20 2d 6c 6f 67 70 6c 61 79 7c 6c 70 0a 20 20 20 20 20 gfile..........-logplay|lp......
31a0 20 20 20 20 20 20 20 20 20 52 65 70 6c 61 79 20 20 61 20 70 72 65 76 69 6f 75 73 20 6c 6f 67 2e .........Replay..a.previous.log.
31c0 20 46 6f 72 20 72 65 73 74 6f 72 69 6e 67 20 61 20 73 65 73 73 69 6f 6e 20 61 73 20 63 6c 6f 73 .For.restoring.a.session.as.clos
31e0 65 20 61 73 20 70 6f 73 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 69 62 6c 65 20 74 6f e.as.pos-...............sible.to
3200 20 74 68 65 20 73 74 61 74 65 20 79 6f 75 20 6c 65 66 74 20 69 74 20 69 6e 2c 20 75 73 65 20 74 .the.state.you.left.it.in,.use.t
3220 68 69 73 20 6f 70 74 69 6f 6e 20 20 28 64 6f 6e 27 74 20 20 6a 75 73 74 0a 20 20 20 20 20 20 20 his.option..(don't..just........
3240 20 20 20 20 20 20 20 72 75 6e 20 74 68 65 20 6c 6f 67 66 69 6c 65 29 2e 20 57 69 74 68 20 2d 6c .......run.the.logfile)..With.-l
3260 6f 67 70 6c 61 79 2c 20 49 50 79 74 68 6f 6e 20 77 69 6c 6c 20 74 72 79 20 74 6f 20 72 65 63 6f ogplay,.IPython.will.try.to.reco
3280 6e 73 74 72 75 63 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 70 72 65 76 69 6f nstruct...............the.previo
32a0 75 73 20 77 6f 72 6b 69 6e 67 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 69 6e 20 66 75 6c 6c 2c 20 us.working.environment.in.full,.
32c0 6e 6f 74 20 6a 75 73 74 20 20 65 78 65 63 75 74 65 20 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 not.just..execute..the..........
32e0 20 20 20 20 20 63 6f 6d 6d 61 6e 64 73 20 69 6e 20 74 68 65 20 6c 6f 67 66 69 6c 65 2e 0a 20 20 .....commands.in.the.logfile....
3300 20 20 20 20 20 20 20 20 20 20 20 20 57 68 65 6e 20 20 61 20 20 73 65 73 73 69 6f 6e 20 69 73 20 ............When..a..session.is.
3320 72 65 73 74 6f 72 65 64 2c 20 6c 6f 67 67 69 6e 67 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c restored,.logging.is.automatical
3340 6c 79 20 74 75 72 6e 65 64 20 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 67 61 69 6e ly.turned.on...............again
3360 20 77 69 74 68 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 6c 6f 67 66 69 6c 65 20 69 74 .with.the.name.of.the.logfile.it
3380 20 77 61 73 20 69 6e 76 6f 6b 65 64 20 20 77 69 74 68 20 20 28 69 74 20 20 69 73 0a 20 20 20 20 .was.invoked..with..(it..is.....
33a0 20 20 20 20 20 20 20 20 20 20 72 65 61 64 20 20 66 72 6f 6d 20 74 68 65 20 6c 6f 67 20 68 65 61 ..........read..from.the.log.hea
33c0 64 65 72 29 2e 20 53 6f 20 6f 6e 63 65 20 79 6f 75 27 76 65 20 74 75 72 6e 65 64 20 6c 6f 67 67 der)..So.once.you've.turned.logg
33e0 69 6e 67 20 6f 6e 20 66 6f 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 20 73 65 73 73 69 ing.on.for...............a.sessi
3400 6f 6e 2c 20 79 6f 75 20 63 61 6e 20 71 75 69 74 20 49 50 79 74 68 6f 6e 20 61 6e 64 20 72 65 6c on,.you.can.quit.IPython.and.rel
3420 6f 61 64 20 69 74 20 61 73 20 6d 61 6e 79 20 20 74 69 6d 65 73 20 20 61 73 0a 20 20 20 20 20 20 oad.it.as.many..times..as.......
3440 20 20 20 20 20 20 20 20 79 6f 75 20 20 77 61 6e 74 20 20 61 6e 64 20 20 69 74 20 20 77 69 6c 6c ........you..want..and..it..will
3460 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 6c 6f 67 20 69 74 73 20 68 69 73 74 6f 72 79 20 61 6e 64 .continue.to.log.its.history.and
3480 20 72 65 73 74 6f 72 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 72 6f 6d 20 74 68 65 20 .restore...............from.the.
34a0 62 65 67 69 6e 6e 69 6e 67 20 65 76 65 72 79 20 74 69 6d 65 2e 0a 0a 20 20 20 20 20 20 20 20 20 beginning.every.time............
34c0 20 20 20 20 20 43 61 76 65 61 74 73 3a 20 74 68 65 72 65 20 61 72 65 20 6c 69 6d 69 74 61 74 69 .....Caveats:.there.are.limitati
34e0 6f 6e 73 20 69 6e 20 74 68 69 73 20 6f 70 74 69 6f 6e 2e 20 54 68 65 20 68 69 73 74 6f 72 79 20 ons.in.this.option..The.history.
3500 76 61 72 69 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 62 6c 65 73 20 20 5f 69 2a 2c 5f vari-...............ables.._i*,_
3520 2a 20 61 6e 64 20 5f 64 68 20 64 6f 6e 27 74 20 67 65 74 20 72 65 73 74 6f 72 65 64 20 70 72 6f *.and._dh.don't.get.restored.pro
3540 70 65 72 6c 79 2e 20 49 6e 20 74 68 65 20 66 75 74 75 72 65 0a 20 20 20 20 20 20 20 20 20 20 20 perly..In.the.future............
3560 20 20 20 77 65 20 77 69 6c 6c 20 74 72 79 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 66 75 6c 6c ...we.will.try.to.implement.full
3580 20 20 73 65 73 73 69 6f 6e 20 20 73 61 76 69 6e 67 20 20 62 79 20 20 77 72 69 74 69 6e 67 20 20 ..session..saving..by..writing..
35a0 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 72 69 65 76 69 6e 67 20 20 61 20 and...............retrieving..a.
35c0 66 61 69 6c 65 64 20 62 65 63 61 75 73 65 20 6f 66 20 69 6e 68 65 72 65 6e 74 20 6c 69 6d 69 74 failed.because.of.inherent.limit
35e0 61 74 69 6f 6e 73 20 6f 66 20 50 79 74 68 6f 6e 27 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ations.of.Python's..............
3600 20 50 69 63 6b 6c 65 20 6d 6f 64 75 6c 65 2c 20 73 6f 20 74 68 69 73 20 6d 61 79 20 68 61 76 65 .Pickle.module,.so.this.may.have
3620 20 74 6f 20 77 61 69 74 2e 0a 0a 20 20 20 20 20 20 20 2d 5b 6e 6f 5d 6d 65 73 73 61 67 65 73 0a .to.wait..........-[no]messages.
3640 20 20 20 20 20 20 20 20 20 20 20 20 20 20 50 72 69 6e 74 20 6d 65 73 73 61 67 65 73 20 77 68 69 ..............Print.messages.whi
3660 63 68 20 49 50 79 74 68 6f 6e 20 63 6f 6c 6c 65 63 74 73 20 61 62 6f 75 74 20 69 74 73 20 73 74 ch.IPython.collects.about.its.st
3680 61 72 74 75 70 20 20 70 72 6f 63 65 73 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 64 65 artup..process...............(de
36a0 66 61 75 6c 74 20 6f 6e 29 2e 0a 0a 20 20 20 20 20 20 20 2d 5b 6e 6f 5d 70 64 62 0a 20 20 20 20 fault.on)..........-[no]pdb.....
36c0 20 20 20 20 20 20 20 20 20 20 41 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 20 63 61 6c 6c 20 74 68 ..........Automatically..call.th
36e0 65 20 70 64 62 20 64 65 62 75 67 67 65 72 20 61 66 74 65 72 20 65 76 65 72 79 20 75 6e 63 61 75 e.pdb.debugger.after.every.uncau
3700 67 68 74 20 65 78 63 65 70 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 69 6f 6e 2e 20 49 ght.excep-...............tion..I
3720 66 20 79 6f 75 20 61 72 65 20 75 73 65 64 20 74 6f 20 64 65 62 75 67 67 69 6e 67 20 20 75 73 69 f.you.are.used.to.debugging..usi
3740 6e 67 20 20 70 64 62 2c 20 20 74 68 69 73 20 20 70 75 74 73 20 20 79 6f 75 0a 20 20 20 20 20 20 ng..pdb,..this..puts..you.......
3760 20 20 20 20 20 20 20 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 20 69 6e 73 69 64 65 20 6f 66 ........automatically..inside.of
3780 20 69 74 20 61 66 74 65 72 20 61 6e 79 20 63 61 6c 6c 20 28 65 69 74 68 65 72 20 69 6e 20 49 50 .it.after.any.call.(either.in.IP
37a0 79 74 68 6f 6e 20 6f 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 20 63 6f 64 65 20 63 ython.or...............in.code.c
37c0 61 6c 6c 65 64 20 62 79 20 69 74 29 20 77 68 69 63 68 20 74 72 69 67 67 65 72 73 20 20 61 6e 20 alled.by.it).which.triggers..an.
37e0 20 65 78 63 65 70 74 69 6f 6e 20 20 77 68 69 63 68 20 20 67 6f 65 73 0a 20 20 20 20 20 20 20 20 .exception..which..goes.........
3800 20 20 20 20 20 20 75 6e 63 61 75 67 68 74 2e 0a 0a 20 20 20 20 20 20 20 2d 5b 6e 6f 5d 70 70 72 ......uncaught..........-[no]ppr
3820 69 6e 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 50 79 74 68 6f 6e 20 20 63 61 6e 20 20 int...............IPython..can..
3840 6f 70 74 69 6f 6e 61 6c 6c 79 20 20 75 73 65 20 74 68 65 20 70 70 72 69 6e 74 20 28 70 72 65 74 optionally..use.the.pprint.(pret
3860 74 79 20 70 72 69 6e 74 65 72 29 20 6d 6f 64 75 6c 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ty.printer).module..............
3880 20 66 6f 72 20 64 69 73 70 6c 61 79 69 6e 67 20 72 65 73 75 6c 74 73 2e 20 70 70 72 69 6e 74 20 .for.displaying.results..pprint.
38a0 74 65 6e 64 73 20 74 6f 20 67 69 76 65 20 61 20 6e 69 63 65 72 20 64 69 73 70 6c 61 79 20 20 6f tends.to.give.a.nicer.display..o
38c0 66 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 65 73 74 65 64 20 20 64 61 74 61 20 73 74 72 f...............nested..data.str
38e0 75 63 74 75 72 65 73 2e 20 49 66 20 79 6f 75 20 6c 69 6b 65 20 69 74 2c 20 79 6f 75 20 63 61 6e uctures..If.you.like.it,.you.can
3900 20 74 75 72 6e 20 69 74 20 6f 6e 20 70 65 72 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6d .turn.it.on.per-...............m
3920 61 6e 65 6e 74 6c 79 20 69 6e 20 79 6f 75 72 20 63 6f 6e 66 69 67 20 66 69 6c 65 20 28 64 65 66 anently.in.your.config.file.(def
3940 61 75 6c 74 20 6f 66 66 29 2e 0a 0a 20 20 20 20 20 20 20 2d 70 72 6f 66 69 6c 65 7c 70 20 3c 6e ault.off)..........-profile|p.<n
3960 61 6d 65 3e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 41 73 73 75 6d 65 20 74 68 61 74 20 79 ame>...............Assume.that.y
3980 6f 75 72 20 63 6f 6e 66 69 67 20 66 69 6c 65 20 69 73 20 69 70 79 74 68 6f 6e 72 63 2d 3c 6e 61 our.config.file.is.ipythonrc-<na
39a0 6d 65 3e 20 28 6c 6f 6f 6b 73 20 69 6e 20 20 63 75 72 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 me>.(looks.in..cur-.............
39c0 20 20 72 65 6e 74 20 64 69 72 20 66 69 72 73 74 2c 20 74 68 65 6e 20 69 6e 20 49 50 59 54 48 4f ..rent.dir.first,.then.in.IPYTHO
39e0 4e 44 49 52 29 2e 20 54 68 69 73 20 69 73 20 61 20 71 75 69 63 6b 20 77 61 79 20 74 6f 20 6b 65 NDIR)..This.is.a.quick.way.to.ke
3a00 65 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6e 64 20 6c 6f 61 64 20 6d 75 6c 74 69 70 ep...............and.load.multip
3a20 6c 65 20 63 6f 6e 66 69 67 20 66 69 6c 65 73 20 66 6f 72 20 64 69 66 66 65 72 65 6e 74 20 20 74 le.config.files.for.different..t
3a40 61 73 6b 73 2c 20 20 65 73 70 65 63 69 61 6c 6c 79 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 asks,..especially...............
3a60 69 66 20 20 79 6f 75 20 20 75 73 65 20 20 74 68 65 20 69 6e 63 6c 75 64 65 20 6f 70 74 69 6f 6e if..you..use..the.include.option
3a80 20 6f 66 20 63 6f 6e 66 69 67 20 66 69 6c 65 73 2e 20 59 6f 75 20 63 61 6e 20 6b 65 65 70 20 61 .of.config.files..You.can.keep.a
3aa0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 62 61 73 69 63 20 49 50 59 54 48 4f 4e 44 49 52 2f ...............basic.IPYTHONDIR/
3ac0 69 70 79 74 68 6f 6e 72 63 20 66 69 6c 65 20 61 6e 64 20 74 68 65 6e 20 68 61 76 65 20 20 6f 74 ipythonrc.file.and.then.have..ot
3ae0 68 65 72 20 20 27 70 72 6f 66 69 6c 65 73 27 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 77 68 her..'profiles'...............wh
3b00 69 63 68 20 20 69 6e 63 6c 75 64 65 20 20 74 68 69 73 20 20 6f 6e 65 20 20 61 6e 64 20 20 6c 6f ich..include..this..one..and..lo
3b20 61 64 20 65 78 74 72 61 20 74 68 69 6e 67 73 20 66 6f 72 20 70 61 72 74 69 63 75 6c 61 72 0a 20 ad.extra.things.for.particular..
3b40 20 20 20 20 20 20 20 20 20 20 20 20 20 74 61 73 6b 73 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a .............tasks..For.example:
3b60 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 31 29 20 24 48 4f 4d 45 2f 2e 69 70 79 74 68 6f ................1).$HOME/.ipytho
3b80 6e 2f 69 70 79 74 68 6f 6e 72 63 20 3a 20 6c 6f 61 64 20 62 61 73 69 63 20 74 68 69 6e 67 73 20 n/ipythonrc.:.load.basic.things.
3ba0 79 6f 75 20 61 6c 77 61 79 73 20 77 61 6e 74 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 32 you.always.want................2
3bc0 29 20 20 24 48 4f 4d 45 2f 2e 69 70 79 74 68 6f 6e 2f 69 70 79 74 68 6f 6e 72 63 2d 6d 61 74 68 )..$HOME/.ipython/ipythonrc-math
3be0 20 20 3a 20 20 6c 6f 61 64 20 20 28 31 29 20 20 61 6e 64 20 62 61 73 69 63 20 6d 61 74 68 2d 0a ..:..load..(1)..and.basic.math-.
3c00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 6c 61 74 65 64 20 6d 6f 64 75 6c 65 73 2e 0a 20 ..............related.modules...
3c20 20 20 20 20 20 20 20 20 20 20 20 20 20 33 29 20 24 48 4f 4d 45 2f 2e 69 70 79 74 68 6f 6e 2f 69 .............3).$HOME/.ipython/i
3c40 70 79 74 68 6f 6e 72 63 2d 6e 75 6d 65 72 69 63 20 3a 20 6c 6f 61 64 20 28 31 29 20 61 6e 64 20 pythonrc-numeric.:.load.(1).and.
3c60 20 4e 75 6d 65 72 69 63 20 20 61 6e 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 6c 6f 74 .Numeric..and...............plot
3c80 74 69 6e 67 20 6d 6f 64 75 6c 65 73 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 69 6e ting.modules.................Sin
3ca0 63 65 20 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 63 72 65 61 74 65 20 61 6e 20 ce..it.is.possible.to.create.an.
3cc0 65 6e 64 6c 65 73 73 20 6c 6f 6f 70 20 62 79 20 68 61 76 69 6e 67 20 63 69 72 63 75 2d 0a 20 20 endless.loop.by.having.circu-...
3ce0 20 20 20 20 20 20 20 20 20 20 20 20 6c 61 72 20 66 69 6c 65 20 69 6e 63 6c 75 73 69 6f 6e 73 2c ............lar.file.inclusions,
3d00 20 49 50 79 74 68 6f 6e 20 77 69 6c 6c 20 73 74 6f 70 20 69 66 20 69 74 20 72 65 61 63 68 65 73 .IPython.will.stop.if.it.reaches
3d20 20 20 31 35 20 20 72 65 63 75 72 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 69 76 65 20 ..15..recur-...............sive.
3d40 69 6e 63 6c 75 73 69 6f 6e 73 2e 0a 0a 20 20 20 20 20 20 20 2d 70 72 6f 6d 70 74 5f 69 6e 31 7c inclusions..........-prompt_in1|
3d60 70 69 31 20 3c 73 74 72 69 6e 67 3e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 70 65 63 69 pi1.<string>...............Speci
3d80 66 79 20 20 74 68 65 20 73 74 72 69 6e 67 20 75 73 65 64 20 66 6f 72 20 69 6e 70 75 74 20 70 72 fy..the.string.used.for.input.pr
3da0 6f 6d 70 74 73 2e 20 4e 6f 74 65 20 74 68 61 74 20 69 66 20 79 6f 75 20 61 72 65 0a 20 20 20 20 ompts..Note.that.if.you.are.....
3dc0 20 20 20 20 20 20 20 20 20 20 75 73 69 6e 67 20 6e 75 6d 62 65 72 65 64 20 70 72 6f 6d 70 74 73 ..........using.numbered.prompts
3de0 2c 20 74 68 65 20 6e 75 6d 62 65 72 20 69 73 20 72 65 70 72 65 73 65 6e 74 65 64 20 77 69 74 68 ,.the.number.is.represented.with
3e00 20 61 20 27 5c 23 27 20 69 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 20 73 74 .a.'\#'.in...............the..st
3e20 72 69 6e 67 2e 20 20 44 6f 6e 27 74 20 66 6f 72 67 65 74 20 74 6f 20 71 75 6f 74 65 20 73 74 72 ring...Don't.forget.to.quote.str
3e40 69 6e 67 73 20 77 69 74 68 20 73 70 61 63 65 73 20 65 6d 62 65 64 64 65 64 0a 20 20 20 20 20 20 ings.with.spaces.embedded.......
3e60 20 20 20 20 20 20 20 20 69 6e 20 74 68 65 6d 2e 20 44 65 66 61 75 6c 74 3a 20 27 49 6e 20 5b 5c ........in.them..Default:.'In.[\
3e80 23 5d 3a 20 27 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4d 6f 73 74 20 62 61 73 68 2d #]:.'.................Most.bash-
3ea0 6c 69 6b 65 20 20 65 73 63 61 70 65 73 20 20 63 61 6e 20 20 62 65 20 20 75 73 65 64 20 20 74 6f like..escapes..can..be..used..to
3ec0 20 20 63 75 73 74 6f 6d 69 7a 65 20 20 49 50 79 74 68 6f 6e 27 73 0a 20 20 20 20 20 20 20 20 20 ..customize..IPython's..........
3ee0 20 20 20 20 20 70 72 6f 6d 70 74 73 2c 20 61 73 20 77 65 6c 6c 20 61 73 20 61 20 66 65 77 20 61 .....prompts,.as.well.as.a.few.a
3f00 64 64 69 74 69 6f 6e 61 6c 20 6f 6e 65 73 20 77 68 69 63 68 20 61 72 65 20 49 50 79 74 68 6f 6e dditional.ones.which.are.IPython
3f20 2d 73 70 65 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 69 66 69 63 2e 20 20 41 6c 6c 20 -spe-...............cific...All.
3f40 76 61 6c 69 64 20 70 72 6f 6d 70 74 20 65 73 63 61 70 65 73 20 61 72 65 20 64 65 73 63 72 69 62 valid.prompt.escapes.are.describ
3f60 65 64 20 69 6e 20 64 65 74 61 69 6c 20 69 6e 20 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 ed.in.detail.in..the............
3f80 20 20 20 43 75 73 74 6f 6d 69 7a 61 74 69 6f 6e 20 73 65 63 74 69 6f 6e 20 6f 66 20 74 68 65 20 ...Customization.section.of.the.
3fa0 49 50 79 74 68 6f 6e 20 48 54 4d 4c 2f 50 44 46 20 6d 61 6e 75 61 6c 2e 0a 0a 20 20 20 20 20 20 IPython.HTML/PDF.manual.........
3fc0 20 2d 70 72 6f 6d 70 74 5f 69 6e 32 7c 70 69 32 20 3c 73 74 72 69 6e 67 3e 0a 20 20 20 20 20 20 .-prompt_in2|pi2.<string>.......
3fe0 20 20 20 20 20 20 20 20 53 69 6d 69 6c 61 72 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 ........Similar.to.the.previous.
4000 6f 70 74 69 6f 6e 2c 20 62 75 74 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 63 6f 6e 74 69 6e 75 option,.but.used.for.the.continu
4020 61 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 72 6f 6d 70 74 73 2e 20 54 68 65 ation...............prompts..The
4040 20 73 70 65 63 69 61 6c 20 73 65 71 75 65 6e 63 65 20 27 5c 44 27 20 69 73 20 73 69 6d 69 6c 61 .special.sequence.'\D'.is.simila
4060 72 20 74 6f 20 27 5c 23 27 2c 20 62 75 74 20 77 69 74 68 0a 20 20 20 20 20 20 20 20 20 20 20 20 r.to.'\#',.but.with.............
4080 20 20 61 6c 6c 20 64 69 67 69 74 73 20 72 65 70 6c 61 63 65 64 20 64 6f 74 73 20 28 73 6f 20 79 ..all.digits.replaced.dots.(so.y
40a0 6f 75 20 63 61 6e 20 68 61 76 65 20 79 6f 75 72 20 63 6f 6e 74 69 6e 75 61 74 69 6f 6e 0a 20 20 ou.can.have.your.continuation...
40c0 20 20 20 20 20 20 20 20 20 20 20 20 70 72 6f 6d 70 74 20 61 6c 69 67 6e 65 64 20 77 69 74 68 20 ............prompt.aligned.with.
40e0 79 6f 75 72 20 69 6e 70 75 74 20 70 72 6f 6d 70 74 29 2e 20 20 44 65 66 61 75 6c 74 3a 20 27 20 your.input.prompt)...Default:.'.
4100 2e 5c 44 2e 3a 20 27 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6e 6f 74 65 20 74 68 72 65 .\D.:.'...............(note.thre
4120 65 20 73 70 61 63 65 73 20 61 74 20 74 68 65 20 73 74 61 72 74 20 66 6f 72 20 61 6c 69 67 6e 6d e.spaces.at.the.start.for.alignm
4140 65 6e 74 20 77 69 74 68 20 27 49 6e 20 5b 5c 23 5d 27 29 2e 0a 0a 20 20 20 20 20 20 20 2d 70 72 ent.with.'In.[\#]')..........-pr
4160 6f 6d 70 74 5f 6f 75 74 7c 70 6f 20 3c 73 74 72 69 6e 67 3e 0a 20 20 20 20 20 20 20 20 20 20 20 ompt_out|po.<string>............
4180 20 20 20 53 74 72 69 6e 67 20 20 20 75 73 65 64 20 20 20 66 6f 72 20 20 6f 75 74 70 75 74 20 20 ...String...used...for..output..
41a0 70 72 6f 6d 70 74 73 2c 20 20 61 6c 73 6f 20 20 75 73 65 73 20 20 6e 75 6d 62 65 72 73 20 20 6c prompts,..also..uses..numbers..l
41c0 69 6b 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 72 6f 6d 70 74 5f 69 6e 31 2e 20 20 44 ike...............prompt_in1...D
41e0 65 66 61 75 6c 74 3a 20 27 4f 75 74 5b 5c 23 5d 3a 27 2e 0a 0a 20 20 20 20 20 20 20 2d 71 75 69 efault:.'Out[\#]:'..........-qui
4200 63 6b 20 53 74 61 72 74 20 69 6e 20 62 61 72 65 20 62 6f 6e 65 73 20 6d 6f 64 65 20 28 6e 6f 20 ck.Start.in.bare.bones.mode.(no.
4220 63 6f 6e 66 69 67 20 66 69 6c 65 20 6c 6f 61 64 65 64 29 2e 0a 0a 20 20 20 20 20 20 20 2d 72 63 config.file.loaded)..........-rc
4240 66 69 6c 65 20 3c 6e 61 6d 65 3e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4e 61 6d 65 20 6f file.<name>...............Name.o
4260 66 20 79 6f 75 72 20 20 49 50 79 74 68 6f 6e 20 20 72 65 73 6f 75 72 63 65 20 20 63 6f 6e 66 69 f.your..IPython..resource..confi
4280 67 75 72 61 74 69 6f 6e 20 20 66 69 6c 65 2e 20 20 20 6e 6f 72 6d 61 6c 6c 79 0a 20 20 20 20 20 guration..file....normally......
42a0 20 20 20 20 20 20 20 20 20 49 50 79 74 68 6f 6e 20 20 20 20 6c 6f 61 64 73 20 20 20 69 70 79 74 .........IPython....loads...ipyt
42c0 68 6f 6e 72 63 20 20 20 28 66 72 6f 6d 20 20 20 63 75 72 72 65 6e 74 20 20 20 64 69 72 65 63 74 honrc...(from...current...direct
42e0 6f 72 79 29 20 20 20 6f 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 50 59 54 48 4f 4e 44 ory)...or...............IPYTHOND
4300 49 52 2f 69 70 79 74 68 6f 6e 72 63 2e 20 20 49 66 20 74 68 65 20 6c 6f 61 64 69 6e 67 20 6f 66 IR/ipythonrc...If.the.loading.of
4320 20 79 6f 75 72 20 63 6f 6e 66 69 67 20 66 69 6c 65 20 66 61 69 6c 73 2c 0a 20 20 20 20 20 20 20 .your.config.file.fails,........
4340 20 20 20 20 20 20 20 49 50 79 74 68 6f 6e 20 20 73 74 61 72 74 73 20 20 77 69 74 68 20 20 61 20 .......IPython..starts..with..a.
4360 20 62 61 72 65 20 20 62 6f 6e 65 73 20 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 28 6e 6f 20 .bare..bones..configuration.(no.
4380 6d 6f 64 75 6c 65 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 6f 61 64 65 64 20 61 74 20 modules...............loaded.at.
43a0 61 6c 6c 29 2e 0a 0a 20 20 20 20 20 20 20 2d 5b 6e 6f 5d 72 65 61 64 6c 69 6e 65 0a 20 20 20 20 all)..........-[no]readline.....
43c0 20 20 20 20 20 20 20 20 20 20 55 73 65 20 74 68 65 20 72 65 61 64 6c 69 6e 65 20 6c 69 62 72 61 ..........Use.the.readline.libra
43e0 72 79 2c 20 77 68 69 63 68 20 69 73 20 6e 65 65 64 65 64 20 74 6f 20 73 75 70 70 6f 72 74 20 20 ry,.which.is.needed.to.support..
4400 6e 61 6d 65 20 20 63 6f 6d 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 6c 65 74 69 6f 6e name..com-...............pletion
4420 20 20 61 6e 64 20 20 63 6f 6d 6d 61 6e 64 20 68 69 73 74 6f 72 79 2c 20 61 6d 6f 6e 67 20 6f 74 ..and..command.history,.among.ot
4440 68 65 72 20 74 68 69 6e 67 73 2e 20 49 74 20 69 73 20 65 6e 61 62 6c 65 64 0a 20 20 20 20 20 20 her.things..It.is.enabled.......
4460 20 20 20 20 20 20 20 20 62 79 20 64 65 66 61 75 6c 74 2c 20 62 75 74 20 6d 61 79 20 63 61 75 73 ........by.default,.but.may.caus
4480 65 20 20 70 72 6f 62 6c 65 6d 73 20 20 66 6f 72 20 20 75 73 65 72 73 20 20 6f 66 20 20 58 2f 45 e..problems..for..users..of..X/E
44a0 6d 61 63 73 20 20 69 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 50 79 74 68 6f 6e 20 63 6f macs..in...............Python.co
44c0 6d 69 6e 74 20 6f 72 20 73 68 65 6c 6c 20 62 75 66 66 65 72 73 2e 0a 0a 20 20 20 20 20 20 20 20 mint.or.shell.buffers...........
44e0 20 20 20 20 20 20 4e 6f 74 65 20 20 74 68 61 74 20 20 65 6d 61 63 73 20 27 65 74 65 72 6d 27 20 ......Note..that..emacs.'eterm'.
4500 62 75 66 66 65 72 73 20 28 6f 70 65 6e 65 64 20 77 69 74 68 20 4d 2d 78 20 74 65 72 6d 29 20 73 buffers.(opened.with.M-x.term).s
4520 75 70 70 6f 72 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 49 50 79 74 68 6f 6e 27 73 20 72 upport...............IPython's.r
4540 65 61 64 6c 69 6e 65 20 61 6e 64 20 73 79 6e 74 61 78 20 63 6f 6c 6f 72 69 6e 67 20 66 69 6e 65 eadline.and.syntax.coloring.fine
4560 2c 20 6f 6e 6c 79 20 20 27 65 6d 61 63 73 27 20 20 28 4d 2d 78 0a 20 20 20 20 20 20 20 20 20 20 ,.only..'emacs'..(M-x...........
4580 20 20 20 20 73 68 65 6c 6c 20 61 6e 64 20 43 2d 63 20 21 29 20 20 62 75 66 66 65 72 73 20 64 6f ....shell.and.C-c.!)..buffers.do
45a0 20 6e 6f 74 2e 0a 0a 20 20 20 20 20 20 20 2d 73 63 72 65 65 6e 5f 6c 65 6e 67 74 68 7c 73 6c 20 .not..........-screen_length|sl.
45c0 3c 6e 3e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4e 75 6d 62 65 72 20 20 6f 66 20 6c 69 6e <n>...............Number..of.lin
45e0 65 73 20 6f 66 20 79 6f 75 72 20 73 63 72 65 65 6e 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 64 es.of.your.screen...This.is.used
4600 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 70 72 69 6e 74 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 .to.control.print-..............
4620 20 69 6e 67 20 6f 66 20 76 65 72 79 20 6c 6f 6e 67 20 73 74 72 69 6e 67 73 2e 20 20 53 74 72 69 .ing.of.very.long.strings...Stri
4640 6e 67 73 20 6c 6f 6e 67 65 72 20 74 68 61 6e 20 20 74 68 69 73 20 20 6e 75 6d 62 65 72 20 20 6f ngs.longer.than..this..number..o
4660 66 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 69 6e 65 73 20 20 77 69 6c 6c 20 62 65 20 73 f...............lines..will.be.s
4680 65 6e 74 20 74 68 72 6f 75 67 68 20 61 20 70 61 67 65 72 20 69 6e 73 74 65 61 64 20 6f 66 20 64 ent.through.a.pager.instead.of.d
46a0 69 72 65 63 74 6c 79 20 70 72 69 6e 74 65 64 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 irectly.printed.................
46c0 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 66 6f 72 20 74 68 69 73 20 69 73 20 30 2c The.default.value.for.this.is.0,
46e0 20 77 68 69 63 68 20 6d 65 61 6e 73 20 49 50 79 74 68 6f 6e 20 77 69 6c 6c 20 20 61 75 74 6f 2d .which.means.IPython.will..auto-
4700 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 65 74 65 63 74 20 20 79 6f 75 72 20 20 73 63 72 ...............detect..your..scr
4720 65 65 6e 20 20 73 69 7a 65 20 20 65 76 65 72 79 20 74 69 6d 65 20 69 74 20 6e 65 65 64 73 20 74 een..size..every.time.it.needs.t
4740 6f 20 70 72 69 6e 74 20 63 65 72 74 61 69 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 6f o.print.certain...............po
4760 74 65 6e 74 69 61 6c 6c 79 20 6c 6f 6e 67 20 73 74 72 69 6e 67 73 20 28 74 68 69 73 20 64 6f 65 tentially.long.strings.(this.doe
4780 73 6e 27 74 20 63 68 61 6e 67 65 20 20 74 68 65 20 20 62 65 68 61 76 69 6f 72 20 20 6f 66 0a 20 sn't.change..the..behavior..of..
47a0 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 20 27 70 72 69 6e 74 27 20 20 6b 65 79 77 6f .............the..'print'..keywo
47c0 72 64 2c 20 20 69 74 27 73 20 20 6f 6e 6c 79 20 74 72 69 67 67 65 72 65 64 20 69 6e 74 65 72 6e rd,..it's..only.triggered.intern
47e0 61 6c 6c 79 29 2e 20 49 66 20 66 6f 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 6f 6d 65 ally)..If.for...............some
4800 20 72 65 61 73 6f 6e 20 74 68 69 73 20 69 73 6e 27 74 20 77 6f 72 6b 69 6e 67 20 77 65 6c 6c 20 .reason.this.isn't.working.well.
4820 28 69 74 20 6e 65 65 64 73 20 20 63 75 72 73 65 73 20 20 73 75 70 70 6f 72 74 29 2c 0a 20 20 20 (it.needs..curses..support),....
4840 20 20 20 20 20 20 20 20 20 20 20 73 70 65 63 69 66 79 20 69 74 20 79 6f 75 72 73 65 6c 66 2e 20 ...........specify.it.yourself..
4860 4f 74 68 65 72 77 69 73 65 20 64 6f 6e 27 74 20 63 68 61 6e 67 65 20 74 68 65 20 64 65 66 61 75 Otherwise.don't.change.the.defau
4880 6c 74 2e 0a 0a 20 20 20 20 20 20 20 2d 73 65 70 61 72 61 74 65 5f 69 6e 7c 73 69 20 3c 73 74 72 lt..........-separate_in|si.<str
48a0 69 6e 67 3e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 65 70 61 72 61 74 6f 72 20 62 65 66 ing>...............Separator.bef
48c0 6f 72 65 20 69 6e 70 75 74 20 70 72 6f 6d 70 74 73 2e 20 20 44 65 66 61 75 6c 74 20 27 30 2e 0a ore.input.prompts...Default.'0..
48e0 0a 20 20 20 20 20 20 20 2d 73 65 70 61 72 61 74 65 5f 6f 75 74 7c 73 6f 20 3c 73 74 72 69 6e 67 ........-separate_out|so.<string
4900 3e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 65 70 61 72 61 74 6f 72 20 62 65 66 6f 72 65 >...............Separator.before
4920 20 6f 75 74 70 75 74 20 70 72 6f 6d 70 74 73 2e 20 20 44 65 66 61 75 6c 74 3a 20 30 20 28 6e 6f .output.prompts...Default:.0.(no
4940 74 68 69 6e 67 29 2e 0a 0a 20 20 20 20 20 20 20 2d 73 65 70 61 72 61 74 65 5f 6f 75 74 32 7c 73 thing)..........-separate_out2|s
4960 6f 32 20 3c 73 74 72 69 6e 67 3e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 65 70 61 72 61 o2.<string>...............Separa
4980 74 6f 72 20 61 66 74 65 72 20 6f 75 74 70 75 74 20 70 72 6f 6d 70 74 73 2e 20 20 44 65 66 61 75 tor.after.output.prompts...Defau
49a0 6c 74 3a 20 30 20 28 6e 6f 74 68 69 6e 67 29 2e 0a 0a 20 20 20 20 20 20 20 2d 6e 6f 73 65 70 20 lt:.0.(nothing)..........-nosep.
49c0 53 68 6f 72 74 68 61 6e 64 20 66 6f 72 20 27 2d 73 65 70 61 72 61 74 65 5f 69 6e 20 30 20 2d 73 Shorthand.for.'-separate_in.0.-s
49e0 65 70 61 72 61 74 65 5f 6f 75 74 20 30 20 2d 73 65 70 61 72 61 74 65 5f 6f 75 74 32 20 30 27 2e eparate_out.0.-separate_out2.0'.
4a00 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 69 6d 70 6c 79 20 72 65 6d 6f 76 65 73 20 61 6c ...............Simply.removes.al
4a20 6c 20 69 6e 70 75 74 2f 6f 75 74 70 75 74 20 73 65 70 61 72 61 74 6f 72 73 2e 0a 0a 20 20 20 20 l.input/output.separators.......
4a40 20 20 20 2d 75 70 67 72 61 64 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 41 6c 6c 6f 77 73 ...-upgrade...............Allows
4a60 20 79 6f 75 20 74 6f 20 75 70 67 72 61 64 65 20 79 6f 75 72 20 20 49 50 59 54 48 4f 4e 44 49 52 .you.to.upgrade.your..IPYTHONDIR
4a80 20 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 20 77 68 65 6e 20 20 79 6f 75 0a 20 20 20 20 20 ..configuration..when..you......
4aa0 20 20 20 20 20 20 20 20 20 69 6e 73 74 61 6c 6c 20 20 61 20 20 6e 65 77 20 20 76 65 72 73 69 6f .........install..a..new..versio
4ac0 6e 20 20 6f 66 20 20 49 50 79 74 68 6f 6e 2e 20 20 20 53 69 6e 63 65 20 20 6e 65 77 20 76 65 72 n..of..IPython....Since..new.ver
4ae0 73 69 6f 6e 73 20 6d 61 79 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 63 6c 75 64 65 20 sions.may...............include.
4b00 6e 65 77 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 73 20 6f 70 74 69 6f 6e 73 20 6f 72 20 65 78 61 new.command.lines.options.or.exa
4b20 6d 70 6c 65 20 66 69 6c 65 73 2c 20 74 68 69 73 20 20 63 6f 70 69 65 73 0a 20 20 20 20 20 20 20 mple.files,.this..copies........
4b40 20 20 20 20 20 20 20 75 70 64 61 74 65 64 20 69 70 79 74 68 6f 6e 72 63 2d 74 79 70 65 20 66 69 .......updated.ipythonrc-type.fi
4b60 6c 65 73 2e 20 20 48 6f 77 65 76 65 72 2c 20 69 74 20 62 61 63 6b 73 20 75 70 20 28 77 69 74 68 les...However,.it.backs.up.(with
4b80 20 61 20 2e 6f 6c 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 65 78 74 65 6e 73 69 6f 6e 29 .a..old...............extension)
4ba0 20 61 6c 6c 20 66 69 6c 65 73 20 77 68 69 63 68 20 69 74 20 6f 76 65 72 77 72 69 74 65 73 20 73 .all.files.which.it.overwrites.s
4bc0 6f 20 74 68 61 74 20 79 6f 75 20 20 63 61 6e 20 20 6d 65 72 67 65 0a 20 20 20 20 20 20 20 20 20 o.that.you..can..merge..........
4be0 20 20 20 20 20 62 61 63 6b 20 61 6e 79 20 63 75 73 74 69 6d 69 7a 61 74 69 6f 6e 73 20 79 6f 75 .....back.any.custimizations.you
4c00 20 6d 69 67 68 74 20 68 61 76 65 20 69 6e 20 79 6f 75 72 20 70 65 72 73 6f 6e 61 6c 20 66 69 6c .might.have.in.your.personal.fil
4c20 65 73 2e 0a 0a 20 20 20 20 20 20 20 2d 56 65 72 73 69 6f 6e 0a 20 20 20 20 20 20 20 20 20 20 20 es..........-Version............
4c40 20 20 20 50 72 69 6e 74 20 76 65 72 73 69 6f 6e 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 6e 64 ...Print.version.information.and
4c60 20 65 78 69 74 2e 0a 0a 20 20 20 20 20 20 20 2d 77 78 76 65 72 73 69 6f 6e 20 3c 73 74 72 69 6e .exit..........-wxversion.<strin
4c80 67 3e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 65 6c 65 63 74 20 61 20 73 70 65 63 69 66 g>...............Select.a.specif
4ca0 69 63 20 76 65 72 73 69 6f 6e 20 6f 66 20 77 78 50 79 74 68 6f 6e 20 28 75 73 65 64 20 69 6e 20 ic.version.of.wxPython.(used.in.
4cc0 63 6f 6e 6a 75 6e 63 74 69 6f 6e 20 77 69 74 68 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2d conjunction.with...............-
4ce0 77 74 68 72 65 61 64 29 2e 20 52 65 71 75 69 72 65 73 20 74 68 65 20 77 78 76 65 72 73 69 6f 6e wthread)..Requires.the.wxversion
4d00 20 6d 6f 64 75 6c 65 2c 20 70 61 72 74 20 6f 66 20 72 65 63 65 6e 74 0a 20 20 20 20 20 20 20 20 .module,.part.of.recent.........
4d20 20 20 20 20 20 20 77 78 50 79 74 68 6f 6e 20 64 69 73 74 72 69 62 75 74 69 6f 6e 73 2e 0a 0a 20 ......wxPython.distributions....
4d40 20 20 20 20 20 20 2d 78 6d 6f 64 65 20 3c 6d 6f 64 65 6e 61 6d 65 3e 0a 20 20 20 20 20 20 20 20 ......-xmode.<modename>.........
4d60 20 20 20 20 20 20 4d 6f 64 65 20 20 66 6f 72 20 20 65 78 63 65 70 74 69 6f 6e 20 72 65 70 6f 72 ......Mode..for..exception.repor
4d80 74 69 6e 67 2e 20 20 54 68 65 20 76 61 6c 69 64 20 6d 6f 64 65 73 20 61 72 65 20 50 6c 61 69 6e ting...The.valid.modes.are.Plain
4da0 2c 20 43 6f 6e 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 65 78 74 2c 20 61 6e 64 20 56 ,.Con-...............text,.and.V
4dc0 65 72 62 6f 73 65 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2d 20 50 6c 61 69 6e 3a 20 erbose.................-.Plain:.
4de0 73 69 6d 69 6c 61 72 20 74 6f 20 70 79 74 68 6f 6e 27 73 20 6e 6f 72 6d 61 6c 20 74 72 61 63 65 similar.to.python's.normal.trace
4e00 62 61 63 6b 20 70 72 69 6e 74 69 6e 67 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2d 20 back.printing.................-.
4e20 43 6f 6e 74 65 78 74 3a 20 70 72 69 6e 74 73 20 35 20 6c 69 6e 65 73 20 6f 66 20 63 6f 6e 74 65 Context:.prints.5.lines.of.conte
4e40 78 74 20 20 73 6f 75 72 63 65 20 20 63 6f 64 65 20 20 61 72 6f 75 6e 64 20 20 65 61 63 68 0a 20 xt..source..code..around..each..
4e60 20 20 20 20 20 20 20 20 20 20 20 20 20 6c 69 6e 65 20 69 6e 20 74 68 65 20 74 72 61 63 65 62 61 .............line.in.the.traceba
4e80 63 6b 2e 0a 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2d 20 56 65 72 62 6f 73 65 3a 20 73 69 ck.................-.Verbose:.si
4ea0 6d 69 6c 61 72 20 74 6f 20 43 6f 6e 74 65 78 74 2c 20 62 75 74 20 61 64 64 69 74 69 6f 6e 61 6c milar.to.Context,.but.additional
4ec0 6c 79 20 70 72 69 6e 74 73 20 74 68 65 20 76 61 72 69 2d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ly.prints.the.vari-.............
4ee0 20 20 61 62 6c 65 73 20 63 75 72 72 65 6e 74 6c 79 20 76 69 73 69 62 6c 65 20 77 68 65 72 65 20 ..ables.currently.visible.where.
4f00 74 68 65 20 65 78 63 65 70 74 69 6f 6e 20 68 61 70 70 65 6e 65 64 20 28 73 68 6f 72 74 65 6e 69 the.exception.happened.(shorteni
4f20 6e 67 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 69 72 20 20 73 74 72 69 6e 67 73 20 ng...............their..strings.
4f40 69 66 20 74 6f 6f 20 6c 6f 6e 67 29 2e 20 20 54 68 69 73 20 63 61 6e 20 70 6f 74 65 6e 74 69 61 if.too.long)...This.can.potentia
4f60 6c 6c 79 20 62 65 20 76 65 72 79 20 73 6c 6f 77 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 lly.be.very.slow,...............
4f80 69 66 20 79 6f 75 20 68 61 70 70 65 6e 20 74 6f 20 68 61 76 65 20 61 20 68 75 67 65 20 64 61 74 if.you.happen.to.have.a.huge.dat
4fa0 61 20 73 74 72 75 63 74 75 72 65 20 77 68 6f 73 65 20 73 74 72 69 6e 67 20 20 72 65 70 72 65 2d a.structure.whose.string..repre-
4fc0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 65 6e 74 61 74 69 6f 6e 20 20 69 73 20 20 63 6f ...............sentation..is..co
4fe0 6d 70 6c 65 78 20 20 74 6f 20 63 6f 6d 70 75 74 65 2e 20 20 59 6f 75 72 20 63 6f 6d 70 75 74 65 mplex..to.compute...Your.compute
5000 72 20 6d 61 79 20 61 70 70 65 61 72 20 74 6f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 66 72 r.may.appear.to...............fr
5020 65 65 7a 65 20 66 6f 72 20 61 20 77 68 69 6c 65 20 77 69 74 68 20 63 70 75 20 75 73 61 67 65 20 eeze.for.a.while.with.cpu.usage.
5040 61 74 20 31 30 30 25 2e 20 20 49 66 20 74 68 69 73 20 6f 63 63 75 72 73 2c 20 20 79 6f 75 0a 20 at.100%...If.this.occurs,..you..
5060 20 20 20 20 20 20 20 20 20 20 20 20 20 63 61 6e 20 63 61 6e 63 65 6c 20 74 68 65 20 74 72 61 63 .............can.cancel.the.trac
5080 65 62 61 63 6b 20 77 69 74 68 20 43 74 72 6c 2d 43 20 28 6d 61 79 62 65 20 68 69 74 74 69 6e 67 eback.with.Ctrl-C.(maybe.hitting
50a0 20 69 74 20 6d 6f 72 65 20 74 68 61 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f 6e 63 65 .it.more.than...............once
50c0 29 2e 0a 0a 0a 45 4d 42 45 44 44 49 4e 47 0a 20 20 20 20 20 20 20 49 74 20 69 73 20 70 6f 73 73 )....EMBEDDING........It.is.poss
50e0 69 62 6c 65 20 74 6f 20 73 74 61 72 74 20 61 6e 20 49 50 79 74 68 6f 6e 20 69 6e 73 74 61 6e 63 ible.to.start.an.IPython.instanc
5100 65 20 69 6e 73 69 64 65 20 79 6f 75 72 20 6f 77 6e 20 50 79 74 68 6f 6e 20 70 72 6f 2d 0a 20 20 e.inside.your.own.Python.pro-...
5120 20 20 20 20 20 67 72 61 6d 73 2e 20 20 49 6e 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f .....grams...In.the.documentatio
5140 6e 20 65 78 61 6d 70 6c 65 20 66 69 6c 65 73 20 74 68 65 72 65 20 61 72 65 20 73 6f 6d 65 20 69 n.example.files.there.are.some.i
5160 6c 6c 75 73 74 72 61 74 69 6f 6e 73 0a 20 20 20 20 20 20 20 6f 6e 20 68 6f 77 20 74 6f 20 64 6f llustrations........on.how.to.do
5180 20 74 68 69 73 2e 0a 0a 20 20 20 20 20 20 20 54 68 69 73 20 66 65 61 74 75 72 65 20 61 6c 6c 6f .this..........This.feature.allo
51a0 77 73 20 79 6f 75 20 74 6f 20 65 76 61 6c 75 74 61 74 65 20 20 64 79 6e 61 6d 69 63 61 6c 6c 79 ws.you.to.evalutate..dynamically
51c0 20 20 74 68 65 20 20 73 74 61 74 65 20 20 6f 66 20 20 79 6f 75 72 0a 20 20 20 20 20 20 20 63 6f ..the..state..of..your........co
51e0 64 65 2c 20 20 6f 70 65 72 61 74 65 20 20 77 69 74 68 20 20 79 6f 75 72 20 20 76 61 72 69 61 62 de,..operate..with..your..variab
5200 6c 65 73 2c 20 61 6e 61 6c 79 7a 65 20 74 68 65 6d 2c 20 65 74 63 2e 20 20 4e 6f 74 65 20 68 6f les,.analyze.them,.etc...Note.ho
5220 77 65 76 65 72 0a 20 20 20 20 20 20 20 74 68 61 74 20 61 6e 79 20 63 68 61 6e 67 65 73 20 79 6f wever........that.any.changes.yo
5240 75 20 6d 61 6b 65 20 74 6f 20 76 61 6c 75 65 73 20 77 68 69 6c 65 20 69 6e 20 74 68 65 20 73 68 u.make.to.values.while.in.the.sh
5260 65 6c 6c 20 64 6f 20 4e 4f 54 20 70 72 6f 70 61 67 61 74 65 0a 20 20 20 20 20 20 20 62 61 63 6b ell.do.NOT.propagate........back
5280 20 20 74 6f 20 20 74 68 65 20 72 75 6e 6e 69 6e 67 20 63 6f 64 65 2c 20 73 6f 20 69 74 20 69 73 ..to..the.running.code,.so.it.is
52a0 20 73 61 66 65 20 74 6f 20 6d 6f 64 69 66 79 20 79 6f 75 72 20 76 61 6c 75 65 73 20 62 65 63 61 .safe.to.modify.your.values.beca
52c0 75 73 65 0a 20 20 20 20 20 20 20 79 6f 75 20 77 6f 6e 27 74 20 62 72 65 61 6b 20 79 6f 75 72 20 use........you.won't.break.your.
52e0 63 6f 64 65 20 69 6e 20 62 69 7a 61 72 72 65 20 77 61 79 73 20 62 79 20 64 6f 69 6e 67 20 73 6f code.in.bizarre.ways.by.doing.so
5300 2e 0a 73 6c 1d 00 00 0a 49 50 79 74 68 6f 6e 20 2d 2d 20 41 6e 20 65 6e 68 61 6e 63 65 64 20 49 ..sl....IPython.--.An.enhanced.I
5320 6e 74 65 72 61 63 74 69 76 65 20 50 79 74 68 6f 6e 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d nteractive.Python.==============
5340 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 49 50 79 ===========================..IPy
5360 74 68 6f 6e 20 6f 66 66 65 72 73 20 61 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 6f 66 20 63 6f 6e thon.offers.a.combination.of.con
5380 76 65 6e 69 65 6e 74 20 73 68 65 6c 6c 20 66 65 61 74 75 72 65 73 2c 20 73 70 65 63 69 61 6c 20 venient.shell.features,.special.
53a0 63 6f 6d 6d 61 6e 64 73 0a 61 6e 64 20 61 20 68 69 73 74 6f 72 79 20 6d 65 63 68 61 6e 69 73 6d commands.and.a.history.mechanism
53c0 20 66 6f 72 20 62 6f 74 68 20 69 6e 70 75 74 20 28 63 6f 6d 6d 61 6e 64 20 68 69 73 74 6f 72 79 .for.both.input.(command.history
53e0 29 20 61 6e 64 20 6f 75 74 70 75 74 20 28 72 65 73 75 6c 74 73 0a 63 61 63 68 69 6e 67 2c 20 73 ).and.output.(results.caching,.s
5400 69 6d 69 6c 61 72 20 74 6f 20 4d 61 74 68 65 6d 61 74 69 63 61 29 2e 20 49 74 20 69 73 20 69 6e imilar.to.Mathematica)..It.is.in
5420 74 65 6e 64 65 64 20 74 6f 20 62 65 20 61 20 66 75 6c 6c 79 20 63 6f 6d 70 61 74 69 62 6c 65 0a tended.to.be.a.fully.compatible.
5440 72 65 70 6c 61 63 65 6d 65 6e 74 20 66 6f 72 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 50 79 74 replacement.for.the.standard.Pyt
5460 68 6f 6e 20 69 6e 74 65 72 70 72 65 74 65 72 2c 20 77 68 69 6c 65 20 6f 66 66 65 72 69 6e 67 20 hon.interpreter,.while.offering.
5480 76 61 73 74 6c 79 0a 69 6d 70 72 6f 76 65 64 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 61 6e vastly.improved.functionality.an
54a0 64 20 66 6c 65 78 69 62 69 6c 69 74 79 2e 0a 0a 41 74 20 79 6f 75 72 20 73 79 73 74 65 6d 20 63 d.flexibility...At.your.system.c
54c0 6f 6d 6d 61 6e 64 20 6c 69 6e 65 2c 20 74 79 70 65 20 27 69 70 79 74 68 6f 6e 20 2d 68 65 6c 70 ommand.line,.type.'ipython.-help
54e0 27 20 74 6f 20 73 65 65 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 0a 6f 70 74 69 6f 6e '.to.see.the.command.line.option
5500 73 20 61 76 61 69 6c 61 62 6c 65 2e 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 6f 6e 6c 79 20 s.available..This.document.only.
5520 64 65 73 63 72 69 62 65 73 20 69 6e 74 65 72 61 63 74 69 76 65 20 66 65 61 74 75 72 65 73 2e 0a describes.interactive.features..
5540 0a 57 61 72 6e 69 6e 67 3a 20 49 50 79 74 68 6f 6e 20 72 65 6c 69 65 73 20 6f 6e 20 74 68 65 20 .Warning:.IPython.relies.on.the.
5560 65 78 69 73 74 65 6e 63 65 20 6f 66 20 61 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 63 existence.of.a.global.variable.c
5580 61 6c 6c 65 64 20 5f 5f 49 50 20 77 68 69 63 68 0a 63 6f 6e 74 72 6f 6c 73 20 74 68 65 20 73 68 alled.__IP.which.controls.the.sh
55a0 65 6c 6c 20 69 74 73 65 6c 66 2e 20 49 66 20 79 6f 75 20 72 65 64 65 66 69 6e 65 20 5f 5f 49 50 ell.itself..If.you.redefine.__IP
55c0 20 74 6f 20 61 6e 79 74 68 69 6e 67 2c 20 62 69 7a 61 72 72 65 20 62 65 68 61 76 69 6f 72 0a 77 .to.anything,.bizarre.behavior.w
55e0 69 6c 6c 20 71 75 69 63 6b 6c 79 20 6f 63 63 75 72 2e 0a 0a 4d 41 49 4e 20 46 45 41 54 55 52 45 ill.quickly.occur...MAIN.FEATURE
5600 53 0a 0a 2a 20 41 63 63 65 73 73 20 74 6f 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 50 79 74 68 S..*.Access.to.the.standard.Pyth
5620 6f 6e 20 68 65 6c 70 2e 20 41 73 20 6f 66 20 50 79 74 68 6f 6e 20 32 2e 31 2c 20 61 20 68 65 6c on.help..As.of.Python.2.1,.a.hel
5640 70 20 73 79 73 74 65 6d 20 69 73 0a 20 20 61 76 61 69 6c 61 62 6c 65 20 77 69 74 68 20 61 63 63 p.system.is...available.with.acc
5660 65 73 73 20 74 6f 20 6f 62 6a 65 63 74 20 64 6f 63 73 74 72 69 6e 67 73 20 61 6e 64 20 74 68 65 ess.to.object.docstrings.and.the
5680 20 50 79 74 68 6f 6e 20 6d 61 6e 75 61 6c 73 2e 20 53 69 6d 70 6c 79 0a 20 20 74 79 70 65 20 27 .Python.manuals..Simply...type.'
56a0 68 65 6c 70 27 20 28 6e 6f 20 71 75 6f 74 65 73 29 20 74 6f 20 61 63 63 65 73 73 20 69 74 2e 0a help'.(no.quotes).to.access.it..
56c0 0a 2a 20 4d 61 67 69 63 20 63 6f 6d 6d 61 6e 64 73 3a 20 74 79 70 65 20 25 6d 61 67 69 63 20 66 .*.Magic.commands:.type.%magic.f
56e0 6f 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 6d 61 67 69 63 20 73 75 62 73 or.information.on.the.magic.subs
5700 79 73 74 65 6d 2e 0a 0a 2a 20 53 79 73 74 65 6d 20 63 6f 6d 6d 61 6e 64 20 61 6c 69 61 73 65 73 ystem...*.System.command.aliases
5720 2c 20 76 69 61 20 74 68 65 20 25 61 6c 69 61 73 20 63 6f 6d 6d 61 6e 64 20 6f 72 20 74 68 65 20 ,.via.the.%alias.command.or.the.
5740 69 70 79 74 68 6f 6e 72 63 20 63 6f 6e 66 69 67 20 66 69 6c 65 2e 0a 0a 2a 20 44 79 6e 61 6d 69 ipythonrc.config.file...*.Dynami
5760 63 20 6f 62 6a 65 63 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 3a 0a 0a 20 20 54 79 70 69 6e 67 20 c.object.information:....Typing.
5780 3f 77 6f 72 64 20 6f 72 20 77 6f 72 64 3f 20 70 72 69 6e 74 73 20 64 65 74 61 69 6c 65 64 20 69 ?word.or.word?.prints.detailed.i
57a0 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 61 6e 20 6f 62 6a 65 63 74 2e 20 20 49 66 0a nformation.about.an.object...If.
57c0 20 20 63 65 72 74 61 69 6e 20 73 74 72 69 6e 67 73 20 69 6e 20 74 68 65 20 6f 62 6a 65 63 74 20 ..certain.strings.in.the.object.
57e0 61 72 65 20 74 6f 6f 20 6c 6f 6e 67 20 28 64 6f 63 73 74 72 69 6e 67 73 2c 20 63 6f 64 65 2c 20 are.too.long.(docstrings,.code,.
5800 65 74 63 2e 29 20 74 68 65 79 20 67 65 74 0a 20 20 73 6e 69 70 70 65 64 20 69 6e 20 74 68 65 20 etc.).they.get...snipped.in.the.
5820 63 65 6e 74 65 72 20 66 6f 72 20 62 72 65 76 69 74 79 2e 0a 0a 20 20 54 79 70 69 6e 67 20 3f 3f center.for.brevity.....Typing.??
5840 77 6f 72 64 20 6f 72 20 77 6f 72 64 3f 3f 20 67 69 76 65 73 20 61 63 63 65 73 73 20 74 6f 20 74 word.or.word??.gives.access.to.t
5860 68 65 20 66 75 6c 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 77 69 74 68 6f 75 74 0a 20 20 73 6e he.full.information.without...sn
5880 69 70 70 69 6e 67 20 6c 6f 6e 67 20 73 74 72 69 6e 67 73 2e 20 4c 6f 6e 67 20 73 74 72 69 6e 67 ipping.long.strings..Long.string
58a0 73 20 61 72 65 20 73 65 6e 74 20 74 6f 20 74 68 65 20 73 63 72 65 65 6e 20 74 68 72 6f 75 67 68 s.are.sent.to.the.screen.through
58c0 20 74 68 65 20 6c 65 73 73 0a 20 20 70 61 67 65 72 20 69 66 20 6c 6f 6e 67 65 72 20 74 68 61 6e .the.less...pager.if.longer.than
58e0 20 74 68 65 20 73 63 72 65 65 6e 2c 20 70 72 69 6e 74 65 64 20 6f 74 68 65 72 77 69 73 65 2e 0a .the.screen,.printed.otherwise..
5900 0a 20 20 54 68 65 20 3f 2f 3f 3f 20 73 79 73 74 65 6d 20 67 69 76 65 73 20 61 63 63 65 73 73 20 ...The.?/??.system.gives.access.
5920 74 6f 20 74 68 65 20 66 75 6c 6c 20 73 6f 75 72 63 65 20 63 6f 64 65 20 66 6f 72 20 61 6e 79 20 to.the.full.source.code.for.any.
5940 6f 62 6a 65 63 74 20 28 69 66 0a 20 20 61 76 61 69 6c 61 62 6c 65 29 2c 20 73 68 6f 77 73 20 66 object.(if...available),.shows.f
5960 75 6e 63 74 69 6f 6e 20 70 72 6f 74 6f 74 79 70 65 73 20 61 6e 64 20 6f 74 68 65 72 20 75 73 65 unction.prototypes.and.other.use
5980 66 75 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 0a 20 20 49 66 20 79 6f 75 20 6a 75 73 74 20 ful.information.....If.you.just.
59a0 77 61 6e 74 20 74 6f 20 73 65 65 20 61 6e 20 6f 62 6a 65 63 74 27 73 20 64 6f 63 73 74 72 69 6e want.to.see.an.object's.docstrin
59c0 67 2c 20 74 79 70 65 20 27 25 70 64 6f 63 20 6f 62 6a 65 63 74 27 20 28 77 69 74 68 6f 75 74 0a g,.type.'%pdoc.object'.(without.
59e0 20 20 71 75 6f 74 65 73 2c 20 61 6e 64 20 77 69 74 68 6f 75 74 20 25 20 69 66 20 79 6f 75 20 68 ..quotes,.and.without.%.if.you.h
5a00 61 76 65 20 61 75 74 6f 6d 61 67 69 63 20 6f 6e 29 2e 0a 0a 20 20 42 6f 74 68 20 25 70 64 6f 63 ave.automagic.on).....Both.%pdoc
5a20 20 61 6e 64 20 3f 2f 3f 3f 20 67 69 76 65 20 79 6f 75 20 61 63 63 65 73 73 20 74 6f 20 64 6f 63 .and.?/??.give.you.access.to.doc
5a40 75 6d 65 6e 74 61 74 69 6f 6e 20 65 76 65 6e 20 6f 6e 20 74 68 69 6e 67 73 20 77 68 69 63 68 20 umentation.even.on.things.which.
5a60 61 72 65 0a 20 20 6e 6f 74 20 65 78 70 6c 69 63 69 74 65 6c 79 20 64 65 66 69 6e 65 64 2e 20 54 are...not.explicitely.defined..T
5a80 72 79 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 74 79 70 69 6e 67 20 7b 7d 2e 67 65 74 3f 20 6f 72 ry.for.example.typing.{}.get?.or
5aa0 20 61 66 74 65 72 20 69 6d 70 6f 72 74 20 6f 73 2c 0a 20 20 74 79 70 65 20 6f 73 2e 70 61 74 68 .after.import.os,...type.os.path
5ac0 2e 61 62 73 70 61 74 68 3f 3f 2e 20 54 68 65 20 6d 61 67 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 .abspath??..The.magic.functions.
5ae0 25 70 64 65 66 2c 20 25 73 6f 75 72 63 65 20 61 6e 64 20 25 66 69 6c 65 20 6f 70 65 72 61 74 65 %pdef,.%source.and.%file.operate
5b00 0a 20 20 73 69 6d 69 6c 61 72 6c 79 2e 0a 0a 2a 20 43 6f 6d 70 6c 65 74 69 6f 6e 20 69 6e 20 74 ...similarly...*.Completion.in.t
5b20 68 65 20 6c 6f 63 61 6c 20 6e 61 6d 65 73 70 61 63 65 2c 20 62 79 20 74 79 70 69 6e 67 20 54 41 he.local.namespace,.by.typing.TA
5b40 42 20 61 74 20 74 68 65 20 70 72 6f 6d 70 74 2e 0a 0a 20 20 41 74 20 61 6e 79 20 74 69 6d 65 2c B.at.the.prompt.....At.any.time,
5b60 20 68 69 74 74 69 6e 67 20 74 61 62 20 77 69 6c 6c 20 63 6f 6d 70 6c 65 74 65 20 61 6e 79 20 61 .hitting.tab.will.complete.any.a
5b80 76 61 69 6c 61 62 6c 65 20 70 79 74 68 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 6f 72 0a 20 20 76 61 vailable.python.commands.or...va
5ba0 72 69 61 62 6c 65 20 6e 61 6d 65 73 2c 20 61 6e 64 20 73 68 6f 77 20 79 6f 75 20 61 20 6c 69 73 riable.names,.and.show.you.a.lis
5bc0 74 20 6f 66 20 74 68 65 20 70 6f 73 73 69 62 6c 65 20 63 6f 6d 70 6c 65 74 69 6f 6e 73 20 69 66 t.of.the.possible.completions.if
5be0 20 74 68 65 72 65 27 73 0a 20 20 6e 6f 20 75 6e 61 6d 62 69 67 75 6f 75 73 20 6f 6e 65 2e 20 49 .there's...no.unambiguous.one..I
5c00 74 20 77 69 6c 6c 20 61 6c 73 6f 20 63 6f 6d 70 6c 65 74 65 20 66 69 6c 65 6e 61 6d 65 73 20 69 t.will.also.complete.filenames.i
5c20 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 64 69 72 65 63 74 6f 72 79 2e 0a 0a 20 20 54 68 69 73 n.the.current.directory.....This
5c40 20 66 65 61 74 75 72 65 20 72 65 71 75 69 72 65 73 20 74 68 65 20 72 65 61 64 6c 69 6e 65 20 61 .feature.requires.the.readline.a
5c60 6e 64 20 72 6c 63 6f 6d 70 6c 65 74 65 20 6d 6f 64 75 6c 65 73 2c 20 73 6f 20 69 74 20 77 6f 6e nd.rlcomplete.modules,.so.it.won
5c80 27 74 20 77 6f 72 6b 0a 20 20 69 66 20 79 6f 75 72 20 50 79 74 68 6f 6e 20 6c 61 63 6b 73 20 72 't.work...if.your.Python.lacks.r
5ca0 65 61 64 6c 69 6e 65 20 73 75 70 70 6f 72 74 20 28 73 75 63 68 20 61 73 20 75 6e 64 65 72 20 57 eadline.support.(such.as.under.W
5cc0 69 6e 64 6f 77 73 29 2e 0a 0a 2a 20 53 65 61 72 63 68 20 70 72 65 76 69 6f 75 73 20 63 6f 6d 6d indows)...*.Search.previous.comm
5ce0 61 6e 64 20 68 69 73 74 6f 72 79 20 69 6e 20 74 77 6f 20 77 61 79 73 20 28 61 6c 73 6f 20 72 65 and.history.in.two.ways.(also.re
5d00 71 75 69 72 65 73 20 72 65 61 64 6c 69 6e 65 29 3a 0a 0a 20 20 2d 20 53 74 61 72 74 20 74 79 70 quires.readline):....-.Start.typ
5d20 69 6e 67 2c 20 61 6e 64 20 74 68 65 6e 20 75 73 65 20 43 74 72 6c 2d 70 20 28 70 72 65 76 69 6f ing,.and.then.use.Ctrl-p.(previo
5d40 75 73 2c 75 70 29 20 61 6e 64 20 43 74 72 6c 2d 6e 20 28 6e 65 78 74 2c 64 6f 77 6e 29 20 74 6f us,up).and.Ctrl-n.(next,down).to
5d60 0a 20 20 73 65 61 72 63 68 20 74 68 72 6f 75 67 68 20 6f 6e 6c 79 20 74 68 65 20 68 69 73 74 6f ...search.through.only.the.histo
5d80 72 79 20 69 74 65 6d 73 20 74 68 61 74 20 6d 61 74 63 68 20 77 68 61 74 20 79 6f 75 27 76 65 20 ry.items.that.match.what.you've.
5da0 74 79 70 65 64 20 73 6f 0a 20 20 66 61 72 2e 20 49 66 20 79 6f 75 20 75 73 65 20 43 74 72 6c 2d typed.so...far..If.you.use.Ctrl-
5dc0 70 2f 43 74 72 6c 2d 6e 20 61 74 20 61 20 62 6c 61 6e 6b 20 70 72 6f 6d 70 74 2c 20 74 68 65 79 p/Ctrl-n.at.a.blank.prompt,.they
5de0 20 6a 75 73 74 20 62 65 68 61 76 65 20 6c 69 6b 65 0a 20 20 6e 6f 72 6d 61 6c 20 61 72 72 6f 77 .just.behave.like...normal.arrow
5e00 20 6b 65 79 73 2e 0a 0a 20 20 2d 20 48 69 74 20 43 74 72 6c 2d 72 3a 20 6f 70 65 6e 73 20 61 20 .keys.....-.Hit.Ctrl-r:.opens.a.
5e20 73 65 61 72 63 68 20 70 72 6f 6d 70 74 2e 20 42 65 67 69 6e 20 74 79 70 69 6e 67 20 61 6e 64 20 search.prompt..Begin.typing.and.
5e40 74 68 65 20 73 79 73 74 65 6d 20 73 65 61 72 63 68 65 73 0a 20 20 79 6f 75 72 20 68 69 73 74 6f the.system.searches...your.histo
5e60 72 79 20 66 6f 72 20 6c 69 6e 65 73 20 74 68 61 74 20 6d 61 74 63 68 20 77 68 61 74 20 79 6f 75 ry.for.lines.that.match.what.you
5e80 27 76 65 20 74 79 70 65 64 20 73 6f 20 66 61 72 2c 20 63 6f 6d 70 6c 65 74 69 6e 67 20 61 73 0a 've.typed.so.far,.completing.as.
5ea0 20 20 6d 75 63 68 20 61 73 20 69 74 20 63 61 6e 2e 0a 0a 2a 20 50 65 72 73 69 73 74 65 6e 74 20 ..much.as.it.can...*.Persistent.
5ec0 63 6f 6d 6d 61 6e 64 20 68 69 73 74 6f 72 79 20 61 63 72 6f 73 73 20 73 65 73 73 69 6f 6e 73 20 command.history.across.sessions.
5ee0 28 72 65 61 64 6c 69 6e 65 20 72 65 71 75 69 72 65 64 29 2e 0a 0a 2a 20 4c 6f 67 67 69 6e 67 20 (readline.required)...*.Logging.
5f00 6f 66 20 69 6e 70 75 74 20 77 69 74 68 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f 20 73 61 76 of.input.with.the.ability.to.sav
5f20 65 20 61 6e 64 20 72 65 73 74 6f 72 65 20 61 20 77 6f 72 6b 69 6e 67 20 73 65 73 73 69 6f 6e 2e e.and.restore.a.working.session.
5f40 0a 20 20 0a 2a 20 53 79 73 74 65 6d 20 65 73 63 61 70 65 20 77 69 74 68 20 21 2e 20 54 79 70 69 ....*.System.escape.with.!..Typi
5f60 6e 67 20 21 6c 73 20 77 69 6c 6c 20 72 75 6e 20 27 6c 73 27 20 69 6e 20 74 68 65 20 63 75 72 72 ng.!ls.will.run.'ls'.in.the.curr
5f80 65 6e 74 20 64 69 72 65 63 74 6f 72 79 2e 0a 0a 2a 20 54 68 65 20 72 65 6c 6f 61 64 20 63 6f 6d ent.directory...*.The.reload.com
5fa0 6d 61 6e 64 20 64 6f 65 73 20 61 20 27 64 65 65 70 27 20 72 65 6c 6f 61 64 20 6f 66 20 61 20 6d mand.does.a.'deep'.reload.of.a.m
5fc0 6f 64 75 6c 65 3a 20 63 68 61 6e 67 65 73 20 6d 61 64 65 20 74 6f 20 74 68 65 0a 20 20 6d 6f 64 odule:.changes.made.to.the...mod
5fe0 75 6c 65 20 73 69 6e 63 65 20 79 6f 75 20 69 6d 70 6f 72 74 65 64 20 77 69 6c 6c 20 61 63 74 75 ule.since.you.imported.will.actu
6000 61 6c 6c 79 20 62 65 20 61 76 61 69 6c 61 62 6c 65 20 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 ally.be.available.without.having
6020 20 74 6f 20 65 78 69 74 2e 0a 0a 2a 20 56 65 72 62 6f 73 65 20 61 6e 64 20 63 6f 6c 6f 72 65 64 .to.exit...*.Verbose.and.colored
6040 20 65 78 63 65 70 74 69 6f 6e 20 74 72 61 63 65 62 61 63 6b 20 70 72 69 6e 74 6f 75 74 73 2e 20 .exception.traceback.printouts..
6060 53 65 65 20 74 68 65 20 6d 61 67 69 63 20 78 6d 6f 64 65 20 61 6e 64 0a 20 20 78 63 6f 6c 6f 72 See.the.magic.xmode.and...xcolor
6080 20 66 75 6e 63 74 69 6f 6e 73 20 66 6f 72 20 64 65 74 61 69 6c 73 20 28 6a 75 73 74 20 74 79 70 .functions.for.details.(just.typ
60a0 65 20 25 6d 61 67 69 63 29 2e 0a 0a 2a 20 49 6e 70 75 74 20 63 61 63 68 69 6e 67 20 73 79 73 74 e.%magic)...*.Input.caching.syst
60c0 65 6d 3a 0a 0a 20 20 49 50 79 74 68 6f 6e 20 6f 66 66 65 72 73 20 6e 75 6d 62 65 72 65 64 20 70 em:....IPython.offers.numbered.p
60e0 72 6f 6d 70 74 73 20 28 49 6e 2f 4f 75 74 29 20 77 69 74 68 20 69 6e 70 75 74 20 61 6e 64 20 6f rompts.(In/Out).with.input.and.o
6100 75 74 70 75 74 20 63 61 63 68 69 6e 67 2e 20 41 6c 6c 0a 20 20 69 6e 70 75 74 20 69 73 20 73 61 utput.caching..All...input.is.sa
6120 76 65 64 20 61 6e 64 20 63 61 6e 20 62 65 20 72 65 74 72 69 65 76 65 64 20 61 73 20 76 61 72 69 ved.and.can.be.retrieved.as.vari
6140 61 62 6c 65 73 20 28 62 65 73 69 64 65 73 20 74 68 65 20 75 73 75 61 6c 20 61 72 72 6f 77 0a 20 ables.(besides.the.usual.arrow..
6160 20 6b 65 79 20 72 65 63 61 6c 6c 29 2e 0a 0a 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 47 .key.recall).....The.following.G
6180 4c 4f 42 41 4c 20 76 61 72 69 61 62 6c 65 73 20 61 6c 77 61 79 73 20 65 78 69 73 74 20 28 73 6f LOBAL.variables.always.exist.(so
61a0 20 64 6f 6e 27 74 20 6f 76 65 72 77 72 69 74 65 20 74 68 65 6d 21 29 3a 0a 20 20 5f 69 3a 20 73 .don't.overwrite.them!):..._i:.s
61c0 74 6f 72 65 73 20 70 72 65 76 69 6f 75 73 20 69 6e 70 75 74 2e 0a 20 20 5f 69 69 3a 20 6e 65 78 tores.previous.input...._ii:.nex
61e0 74 20 70 72 65 76 69 6f 75 73 2e 0a 20 20 5f 69 69 69 3a 20 6e 65 78 74 2d 6e 65 78 74 20 70 72 t.previous...._iii:.next-next.pr
6200 65 76 69 6f 75 73 2e 0a 20 20 5f 69 68 20 3a 20 61 20 6c 69 73 74 20 6f 66 20 61 6c 6c 20 69 6e evious...._ih.:.a.list.of.all.in
6220 70 75 74 20 5f 69 68 5b 6e 5d 20 69 73 20 74 68 65 20 69 6e 70 75 74 20 66 72 6f 6d 20 6c 69 6e put._ih[n].is.the.input.from.lin
6240 65 20 6e 2e 0a 0a 20 20 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 67 6c 6f 62 61 6c 20 76 61 72 e.n.....Additionally,.global.var
6260 69 61 62 6c 65 73 20 6e 61 6d 65 64 20 5f 69 3c 6e 3e 20 61 72 65 20 64 79 6e 61 6d 69 63 61 6c iables.named._i<n>.are.dynamical
6280 6c 79 20 63 72 65 61 74 65 64 20 28 3c 6e 3e 0a 20 20 62 65 69 6e 67 20 74 68 65 20 70 72 6f 6d ly.created.(<n>...being.the.prom
62a0 70 74 20 63 6f 75 6e 74 65 72 29 2c 20 73 75 63 68 20 74 68 61 74 20 5f 69 3c 6e 3e 20 3d 3d 20 pt.counter),.such.that._i<n>.==.
62c0 5f 69 68 5b 3c 6e 3e 5d 0a 0a 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 77 68 61 74 20 79 6f _ih[<n>]....For.example,.what.yo
62e0 75 20 74 79 70 65 64 20 61 74 20 70 72 6f 6d 70 74 20 31 34 20 69 73 20 61 76 61 69 6c 61 62 6c u.typed.at.prompt.14.is.availabl
6300 65 20 61 73 20 5f 69 31 34 20 61 6e 64 20 5f 69 68 5b 31 34 5d 2e 0a 0a 20 20 59 6f 75 20 63 61 e.as._i14.and._ih[14].....You.ca
6320 6e 20 63 72 65 61 74 65 20 6d 61 63 72 6f 73 20 77 68 69 63 68 20 63 6f 6e 74 61 69 6e 20 6d 75 n.create.macros.which.contain.mu
6340 6c 74 69 70 6c 65 20 69 6e 70 75 74 20 6c 69 6e 65 73 20 66 72 6f 6d 20 74 68 69 73 20 68 69 73 ltiple.input.lines.from.this.his
6360 74 6f 72 79 2c 0a 20 20 66 6f 72 20 6c 61 74 65 72 20 72 65 2d 65 78 65 63 75 74 69 6f 6e 2c 20 tory,...for.later.re-execution,.
6380 77 69 74 68 20 74 68 65 20 25 6d 61 63 72 6f 20 66 75 6e 63 74 69 6f 6e 2e 0a 0a 20 20 54 68 65 with.the.%macro.function.....The
63a0 20 68 69 73 74 6f 72 79 20 66 75 6e 63 74 69 6f 6e 20 25 68 69 73 74 20 61 6c 6c 6f 77 73 20 79 .history.function.%hist.allows.y
63c0 6f 75 20 74 6f 20 73 65 65 20 61 6e 79 20 70 61 72 74 20 6f 66 20 79 6f 75 72 20 69 6e 70 75 74 ou.to.see.any.part.of.your.input
63e0 20 68 69 73 74 6f 72 79 0a 20 20 62 79 20 70 72 69 6e 74 69 6e 67 20 61 20 72 61 6e 67 65 20 6f .history...by.printing.a.range.o
6400 66 20 74 68 65 20 5f 69 20 76 61 72 69 61 62 6c 65 73 2e 20 4e 6f 74 65 20 74 68 61 74 20 69 6e f.the._i.variables..Note.that.in
6420 70 75 74 73 20 77 68 69 63 68 20 63 6f 6e 74 61 69 6e 0a 20 20 6d 61 67 69 63 20 66 75 6e 63 74 puts.which.contain...magic.funct
6440 69 6f 6e 73 20 28 25 29 20 61 70 70 65 61 72 20 69 6e 20 74 68 65 20 68 69 73 74 6f 72 79 20 77 ions.(%).appear.in.the.history.w
6460 69 74 68 20 61 20 70 72 65 70 65 6e 64 65 64 20 63 6f 6d 6d 65 6e 74 2e 20 54 68 69 73 20 69 73 ith.a.prepended.comment..This.is
6480 0a 20 20 62 65 63 61 75 73 65 20 74 68 65 79 20 61 72 65 6e 27 74 20 72 65 61 6c 6c 79 20 76 61 ...because.they.aren't.really.va
64a0 6c 69 64 20 50 79 74 68 6f 6e 20 63 6f 64 65 2c 20 73 6f 20 79 6f 75 20 63 61 6e 27 74 20 65 78 lid.Python.code,.so.you.can't.ex
64c0 65 63 20 74 68 65 6d 2e 0a 0a 2a 20 4f 75 74 70 75 74 20 63 61 63 68 69 6e 67 20 73 79 73 74 65 ec.them...*.Output.caching.syste
64e0 6d 3a 0a 0a 20 20 46 6f 72 20 6f 75 74 70 75 74 20 74 68 61 74 20 69 73 20 72 65 74 75 72 6e 65 m:....For.output.that.is.returne
6500 64 20 66 72 6f 6d 20 61 63 74 69 6f 6e 73 2c 20 61 20 73 79 73 74 65 6d 20 73 69 6d 69 6c 61 72 d.from.actions,.a.system.similar
6520 20 74 6f 20 74 68 65 20 69 6e 70 75 74 0a 20 20 63 61 63 68 65 20 65 78 69 73 74 73 20 62 75 74 .to.the.input...cache.exists.but
6540 20 75 73 69 6e 67 20 5f 20 69 6e 73 74 65 61 64 20 6f 66 20 5f 69 2e 20 4f 6e 6c 79 20 61 63 74 .using._.instead.of._i..Only.act
6560 69 6f 6e 73 20 74 68 61 74 20 70 72 6f 64 75 63 65 20 61 20 72 65 73 75 6c 74 0a 20 20 28 4e 4f ions.that.produce.a.result...(NO
6580 54 20 61 73 73 69 67 6e 6d 65 6e 74 73 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 29 20 61 72 65 20 T.assignments,.for.example).are.
65a0 63 61 63 68 65 64 2e 20 49 66 20 79 6f 75 20 61 72 65 20 66 61 6d 69 6c 69 61 72 20 77 69 74 68 cached..If.you.are.familiar.with
65c0 0a 20 20 4d 61 74 68 65 6d 61 74 69 63 61 2c 20 49 50 79 74 68 6f 6e 27 73 20 5f 20 76 61 72 69 ...Mathematica,.IPython's._.vari
65e0 61 62 6c 65 73 20 62 65 68 61 76 65 20 65 78 61 63 74 6c 79 20 6c 69 6b 65 20 4d 61 74 68 65 6d ables.behave.exactly.like.Mathem
6600 61 74 69 63 61 27 73 20 25 0a 20 20 76 61 72 69 61 62 6c 65 73 2e 0a 0a 20 20 54 68 65 20 66 6f atica's.%...variables.....The.fo
6620 6c 6c 6f 77 69 6e 67 20 47 4c 4f 42 41 4c 20 76 61 72 69 61 62 6c 65 73 20 61 6c 77 61 79 73 20 llowing.GLOBAL.variables.always.
6640 65 78 69 73 74 20 28 73 6f 20 64 6f 6e 27 74 20 6f 76 65 72 77 72 69 74 65 20 74 68 65 6d 21 29 exist.(so.don't.overwrite.them!)
6660 3a 0a 20 20 5f 20 28 6f 6e 65 20 75 6e 64 65 72 73 63 6f 72 65 29 3a 20 70 72 65 76 69 6f 75 73 :..._.(one.underscore):.previous
6680 20 6f 75 74 70 75 74 2e 0a 20 20 5f 5f 20 28 74 77 6f 20 75 6e 64 65 72 73 63 6f 72 65 73 29 3a .output....__.(two.underscores):
66a0 20 6e 65 78 74 20 70 72 65 76 69 6f 75 73 2e 0a 20 20 5f 5f 5f 20 28 74 68 72 65 65 20 75 6e 64 .next.previous....___.(three.und
66c0 65 72 73 63 6f 72 65 73 29 3a 20 6e 65 78 74 2d 6e 65 78 74 20 70 72 65 76 69 6f 75 73 2e 0a 0a erscores):.next-next.previous...
66e0 20 20 47 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 73 20 6e 61 6d 65 64 20 5f 3c 6e 3e 20 61 72 ..Global.variables.named._<n>.ar
6700 65 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20 63 72 65 61 74 65 64 20 28 3c 6e 3e 20 62 65 69 6e 67 e.dynamically.created.(<n>.being
6720 20 74 68 65 20 70 72 6f 6d 70 74 0a 20 20 63 6f 75 6e 74 65 72 29 2c 20 73 75 63 68 20 74 68 61 .the.prompt...counter),.such.tha
6740 74 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20 6f 75 74 70 75 74 20 3c 6e 3e 20 69 73 20 61 6c t.the.result.of.output.<n>.is.al
6760 77 61 79 73 20 61 76 61 69 6c 61 62 6c 65 20 61 73 20 5f 3c 6e 3e 2e 0a 0a 20 20 46 69 6e 61 6c ways.available.as._<n>.....Final
6780 6c 79 2c 20 61 20 67 6c 6f 62 61 6c 20 64 69 63 74 69 6f 6e 61 72 79 20 6e 61 6d 65 64 20 5f 6f ly,.a.global.dictionary.named._o
67a0 68 20 65 78 69 73 74 73 20 77 69 74 68 20 65 6e 74 72 69 65 73 20 66 6f 72 20 61 6c 6c 20 6c 69 h.exists.with.entries.for.all.li
67c0 6e 65 73 0a 20 20 77 68 69 63 68 20 67 65 6e 65 72 61 74 65 64 20 6f 75 74 70 75 74 2e 0a 0a 2a nes...which.generated.output...*
67e0 20 44 69 72 65 63 74 6f 72 79 20 68 69 73 74 6f 72 79 3a 0a 0a 20 20 59 6f 75 72 20 68 69 73 74 .Directory.history:....Your.hist
6800 6f 72 79 20 6f 66 20 76 69 73 69 74 65 64 20 64 69 72 65 63 74 6f 72 69 65 73 20 69 73 20 6b 65 ory.of.visited.directories.is.ke
6820 70 74 20 69 6e 20 74 68 65 20 67 6c 6f 62 61 6c 20 6c 69 73 74 20 5f 64 68 2c 20 61 6e 64 20 74 pt.in.the.global.list._dh,.and.t
6840 68 65 0a 20 20 6d 61 67 69 63 20 25 63 64 20 63 6f 6d 6d 61 6e 64 20 63 61 6e 20 62 65 20 75 73 he...magic.%cd.command.can.be.us
6860 65 64 20 74 6f 20 67 6f 20 74 6f 20 61 6e 79 20 65 6e 74 72 79 20 69 6e 20 74 68 61 74 20 6c 69 ed.to.go.to.any.entry.in.that.li
6880 73 74 2e 0a 0a 2a 20 41 75 74 6f 2d 70 61 72 65 6e 74 68 65 73 65 73 20 61 6e 64 20 61 75 74 6f st...*.Auto-parentheses.and.auto
68a0 2d 71 75 6f 74 65 73 20 28 61 64 61 70 74 65 64 20 66 72 6f 6d 20 4e 61 74 68 61 6e 20 47 72 61 -quotes.(adapted.from.Nathan.Gra
68c0 79 27 73 20 4c 61 7a 79 50 79 74 68 6f 6e 29 0a 0a 20 20 20 20 31 2e 20 41 75 74 6f 2d 70 61 72 y's.LazyPython)......1..Auto-par
68e0 65 6e 74 68 65 73 65 73 0a 20 20 20 20 20 20 20 20 43 61 6c 6c 61 62 6c 65 20 6f 62 6a 65 63 74 entheses.........Callable.object
6900 73 20 28 69 2e 65 2e 20 66 75 6e 63 74 69 6f 6e 73 2c 20 6d 65 74 68 6f 64 73 2c 20 65 74 63 29 s.(i.e..functions,.methods,.etc)
6920 20 63 61 6e 20 62 65 20 69 6e 76 6f 6b 65 64 20 6c 69 6b 65 0a 20 20 20 20 20 20 20 20 74 68 69 .can.be.invoked.like.........thi
6940 73 20 28 6e 6f 74 69 63 65 20 74 68 65 20 63 6f 6d 6d 61 73 20 62 65 74 77 65 65 6e 20 74 68 65 s.(notice.the.commas.between.the
6960 20 61 72 67 75 6d 65 6e 74 73 29 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 3e 3e 3e 20 63 61 6c .arguments):.............>>>.cal
6980 6c 61 62 6c 65 5f 6f 62 20 61 72 67 31 2c 20 61 72 67 32 2c 20 61 72 67 33 0a 20 20 20 20 20 20 lable_ob.arg1,.arg2,.arg3.......
69a0 20 20 61 6e 64 20 74 68 65 20 69 6e 70 75 74 20 77 69 6c 6c 20 62 65 20 74 72 61 6e 73 6c 61 74 ..and.the.input.will.be.translat
69c0 65 64 20 74 6f 20 74 68 69 73 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 2d 2d 3e 20 63 61 6c 6c ed.to.this:.............-->.call
69e0 61 62 6c 65 5f 6f 62 28 61 72 67 31 2c 20 61 72 67 32 2c 20 61 72 67 33 29 0a 20 20 20 20 20 20 able_ob(arg1,.arg2,.arg3).......
6a00 20 20 59 6f 75 20 63 61 6e 20 66 6f 72 63 65 20 61 75 74 6f 2d 70 61 72 65 6e 74 68 65 73 65 73 ..You.can.force.auto-parentheses
6a20 20 62 79 20 75 73 69 6e 67 20 27 2f 27 20 61 73 20 74 68 65 20 66 69 72 73 74 20 63 68 61 72 61 .by.using.'/'.as.the.first.chara
6a40 63 74 65 72 0a 20 20 20 20 20 20 20 20 6f 66 20 61 20 6c 69 6e 65 2e 20 20 46 6f 72 20 65 78 61 cter.........of.a.line...For.exa
6a60 6d 70 6c 65 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 3e 3e 3e 20 2f 67 6c 6f 62 61 6c 73 20 20 mple:.............>>>./globals..
6a80 20 20 20 20 20 20 20 20 20 20 20 23 20 62 65 63 6f 6d 65 73 20 27 67 6c 6f 62 61 6c 73 28 29 27 ...........#.becomes.'globals()'
6aa0 0a 20 20 20 20 20 20 20 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 27 2f 27 20 4d 55 53 54 20 .........Note.that.the.'/'.MUST.
6ac0 62 65 20 74 68 65 20 66 69 72 73 74 20 63 68 61 72 61 63 74 65 72 20 6f 6e 20 74 68 65 20 6c 69 be.the.first.character.on.the.li
6ae0 6e 65 21 20 20 54 68 69 73 0a 20 20 20 20 20 20 20 20 77 6f 6e 27 74 20 77 6f 72 6b 3a 0a 20 20 ne!..This.........won't.work:...
6b00 20 20 20 20 20 20 20 20 20 20 3e 3e 3e 20 70 72 69 6e 74 20 2f 67 6c 6f 62 61 6c 73 20 20 20 20 ..........>>>.print./globals....
6b20 23 20 73 79 6e 74 61 78 20 65 72 72 6f 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20 #.syntax.error..................
6b40 20 20 20 20 49 6e 20 6d 6f 73 74 20 63 61 73 65 73 20 74 68 65 20 61 75 74 6f 6d 61 74 69 63 20 ....In.most.cases.the.automatic.
6b60 61 6c 67 6f 72 69 74 68 6d 20 73 68 6f 75 6c 64 20 77 6f 72 6b 2c 20 73 6f 20 79 6f 75 20 73 68 algorithm.should.work,.so.you.sh
6b80 6f 75 6c 64 0a 20 20 20 20 20 20 20 20 72 61 72 65 6c 79 20 6e 65 65 64 20 74 6f 20 65 78 70 6c ould.........rarely.need.to.expl
6ba0 69 63 69 74 6c 79 20 69 6e 76 6f 6b 65 20 2f 2e 20 4f 6e 65 20 6e 6f 74 61 62 6c 65 20 65 78 63 icitly.invoke./..One.notable.exc
6bc0 65 70 74 69 6f 6e 20 69 73 20 69 66 20 79 6f 75 0a 20 20 20 20 20 20 20 20 61 72 65 20 74 72 79 eption.is.if.you.........are.try
6be0 69 6e 67 20 74 6f 20 63 61 6c 6c 20 61 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 61 20 6c 69 ing.to.call.a.function.with.a.li
6c00 73 74 20 6f 66 20 74 75 70 6c 65 73 20 61 73 20 61 72 67 75 6d 65 6e 74 73 20 28 74 68 65 0a 20 st.of.tuples.as.arguments.(the..
6c20 20 20 20 20 20 20 20 70 61 72 65 6e 74 68 65 73 69 73 20 77 69 6c 6c 20 63 6f 6e 66 75 73 65 20 .......parenthesis.will.confuse.
6c40 49 50 79 74 68 6f 6e 29 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 20 5b 31 5d 3a 20 7a 69 IPython):.............In.[1]:.zi
6c60 70 20 28 31 2c 32 2c 33 29 2c 28 34 2c 35 2c 36 29 20 20 23 20 77 6f 6e 27 74 20 77 6f 72 6b 0a p.(1,2,3),(4,5,6)..#.won't.work.
6c80 20 20 20 20 20 20 20 20 62 75 74 20 74 68 69 73 20 77 69 6c 6c 20 77 6f 72 6b 3a 0a 20 20 20 20 ........but.this.will.work:.....
6ca0 20 20 20 20 20 20 20 20 49 6e 20 5b 32 5d 3a 20 2f 7a 69 70 20 28 31 2c 32 2c 33 29 2c 28 34 2c ........In.[2]:./zip.(1,2,3),(4,
6cc0 35 2c 36 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 2d 2d 2d 2d 2d 2d 3e 20 7a 69 70 20 28 28 31 5,6).............------>.zip.((1
6ce0 2c 32 2c 33 29 2c 28 34 2c 35 2c 36 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 4f 75 74 5b 32 ,2,3),(4,5,6)).............Out[2
6d00 5d 3d 20 5b 28 31 2c 20 34 29 2c 20 28 32 2c 20 35 29 2c 20 28 33 2c 20 36 29 5d 20 20 20 20 20 ]=.[(1,.4),.(2,.5),.(3,.6)].....
6d20 20 20 20 0a 0a 20 20 20 20 20 20 20 20 49 50 79 74 68 6f 6e 20 74 65 6c 6c 73 20 79 6f 75 20 74 .............IPython.tells.you.t
6d40 68 61 74 20 69 74 20 68 61 73 20 61 6c 74 65 72 65 64 20 79 6f 75 72 20 63 6f 6d 6d 61 6e 64 20 hat.it.has.altered.your.command.
6d60 6c 69 6e 65 20 62 79 0a 20 20 20 20 20 20 20 20 64 69 73 70 6c 61 79 69 6e 67 20 74 68 65 20 6e line.by.........displaying.the.n
6d80 65 77 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 70 72 65 63 65 64 65 64 20 62 79 20 2d 2d 3e 2e ew.command.line.preceded.by.-->.
6da0 20 20 65 2e 67 2e 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 20 5b 31 38 5d 3a 20 63 61 6c ..e.g.:.............In.[18]:.cal
6dc0 6c 61 62 6c 65 20 6c 69 73 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 3e 20 lable.list.............------->.
6de0 63 61 6c 6c 61 62 6c 65 20 28 6c 69 73 74 29 20 0a 0a 20 20 20 20 32 2e 20 41 75 74 6f 2d 51 75 callable.(list).......2..Auto-Qu
6e00 6f 74 69 6e 67 0a 20 20 20 20 20 20 20 20 59 6f 75 20 63 61 6e 20 66 6f 72 63 65 20 61 75 74 6f oting.........You.can.force.auto
6e20 2d 71 75 6f 74 69 6e 67 20 6f 66 20 61 20 66 75 6e 63 74 69 6f 6e 27 73 20 61 72 67 75 6d 65 6e -quoting.of.a.function's.argumen
6e40 74 73 20 62 79 20 75 73 69 6e 67 20 27 2c 27 20 61 73 0a 20 20 20 20 20 20 20 20 74 68 65 20 66 ts.by.using.','.as.........the.f
6e60 69 72 73 74 20 63 68 61 72 61 63 74 65 72 20 6f 66 20 61 20 6c 69 6e 65 2e 20 20 46 6f 72 20 65 irst.character.of.a.line...For.e
6e80 78 61 6d 70 6c 65 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 3e 3e 3e 20 2c 6d 79 5f 66 75 6e 63 xample:.............>>>.,my_func
6ea0 74 69 6f 6e 20 2f 68 6f 6d 65 2f 6d 65 20 20 20 23 20 62 65 63 6f 6d 65 73 20 6d 79 5f 66 75 6e tion./home/me...#.becomes.my_fun
6ec0 63 74 69 6f 6e 28 22 2f 68 6f 6d 65 2f 6d 65 22 29 0a 0a 20 20 20 20 20 20 20 20 49 66 20 79 6f ction("/home/me")..........If.yo
6ee0 75 20 75 73 65 20 27 3b 27 20 69 6e 73 74 65 61 64 2c 20 74 68 65 20 77 68 6f 6c 65 20 61 72 67 u.use.';'.instead,.the.whole.arg
6f00 75 6d 65 6e 74 20 69 73 20 71 75 6f 74 65 64 20 61 73 20 61 20 73 69 6e 67 6c 65 0a 20 20 20 20 ument.is.quoted.as.a.single.....
6f20 20 20 20 20 73 74 72 69 6e 67 20 28 77 68 69 6c 65 20 27 2c 27 20 73 70 6c 69 74 73 20 6f 6e 20 ....string.(while.','.splits.on.
6f40 77 68 69 74 65 73 70 61 63 65 29 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 3e 3e 3e 20 2c 6d 79 whitespace):.............>>>.,my
6f60 5f 66 75 6e 63 74 69 6f 6e 20 61 20 62 20 63 20 20 20 23 20 62 65 63 6f 6d 65 73 20 6d 79 5f 66 _function.a.b.c...#.becomes.my_f
6f80 75 6e 63 74 69 6f 6e 28 22 61 22 2c 22 62 22 2c 22 63 22 29 0a 20 20 20 20 20 20 20 20 20 20 20 unction("a","b","c")............
6fa0 20 3e 3e 3e 20 3b 6d 79 5f 66 75 6e 63 74 69 6f 6e 20 61 20 62 20 63 20 20 20 23 20 62 65 63 6f .>>>.;my_function.a.b.c...#.beco
6fc0 6d 65 73 20 6d 79 5f 66 75 6e 63 74 69 6f 6e 28 22 61 20 62 20 63 22 29 0a 0a 20 20 20 20 20 20 mes.my_function("a.b.c")........
6fe0 20 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 27 2c 27 20 4d 55 53 54 20 62 65 20 74 68 65 20 ..Note.that.the.','.MUST.be.the.
7000 66 69 72 73 74 20 63 68 61 72 61 63 74 65 72 20 6f 6e 20 74 68 65 20 6c 69 6e 65 21 20 20 54 68 first.character.on.the.line!..Th
7020 69 73 0a 20 20 20 20 20 20 20 20 77 6f 6e 27 74 20 77 6f 72 6b 3a 0a 20 20 20 20 20 20 20 20 20 is.........won't.work:..........
7040 20 20 20 3e 3e 3e 20 78 20 3d 20 2c 6d 79 5f 66 75 6e 63 74 69 6f 6e 20 2f 68 6f 6d 65 2f 6d 65 ...>>>.x.=.,my_function./home/me
7060 20 20 20 20 23 20 73 79 6e 74 61 78 20 65 72 72 6f 72 0a 73 58 07 00 00 0a 49 50 79 74 68 6f 6e ....#.syntax.error.sX....IPython
7080 20 2d 2d 20 41 6e 20 65 6e 68 61 6e 63 65 64 20 49 6e 74 65 72 61 63 74 69 76 65 20 50 79 74 68 .--.An.enhanced.Interactive.Pyth
70a0 6f 6e 20 2d 20 51 75 69 63 6b 20 52 65 66 65 72 65 6e 63 65 20 43 61 72 64 0a 3d 3d 3d 3d 3d 3d on.-.Quick.Reference.Card.======
70c0 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================================
70e0 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 6f 62 6a 3f ==========================..obj?
7100 2c 20 6f 62 6a 3f 3f 20 20 20 20 20 20 3a 20 47 65 74 20 68 65 6c 70 2c 20 6f 72 20 6d 6f 72 65 ,.obj??......:.Get.help,.or.more
7120 20 68 65 6c 70 20 66 6f 72 20 6f 62 6a 65 63 74 20 28 61 6c 73 6f 20 77 6f 72 6b 73 20 61 73 0a .help.for.object.(also.works.as.
7140 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3f 6f 62 6a 2c 20 3f 3f 6f 62 6a 29 2e ...................?obj,.??obj).
7160 0a 3f 66 6f 6f 2e 2a 61 62 63 2a 20 20 20 20 20 20 20 3a 20 4c 69 73 74 20 6e 61 6d 65 73 20 69 .?foo.*abc*.......:.List.names.i
7180 6e 20 27 66 6f 6f 27 20 63 6f 6e 74 61 69 6e 69 6e 67 20 27 61 62 63 27 20 69 6e 20 74 68 65 6d n.'foo'.containing.'abc'.in.them
71a0 2e 0a 25 6d 61 67 69 63 20 20 20 20 20 20 20 20 20 20 20 3a 20 49 6e 66 6f 72 6d 61 74 69 6f 6e ..%magic...........:.Information
71c0 20 61 62 6f 75 74 20 49 50 79 74 68 6f 6e 27 73 20 27 6d 61 67 69 63 27 20 25 20 66 75 6e 63 74 .about.IPython's.'magic'.%.funct
71e0 69 6f 6e 73 2e 0a 0a 4d 61 67 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 70 72 65 66 69 ions...Magic.functions.are.prefi
7200 78 65 64 20 62 79 20 25 2c 20 61 6e 64 20 74 79 70 69 63 61 6c 6c 79 20 74 61 6b 65 20 74 68 65 xed.by.%,.and.typically.take.the
7220 69 72 20 61 72 67 75 6d 65 6e 74 73 20 77 69 74 68 6f 75 74 0a 70 61 72 65 6e 74 68 65 73 65 73 ir.arguments.without.parentheses
7240 2c 20 71 75 6f 74 65 73 20 6f 72 20 65 76 65 6e 20 63 6f 6d 6d 61 73 20 66 6f 72 20 63 6f 6e 76 ,.quotes.or.even.commas.for.conv
7260 65 6e 69 65 6e 63 65 2e 0a 20 0a 45 78 61 6d 70 6c 65 20 6d 61 67 69 63 20 66 75 6e 63 74 69 6f enience....Example.magic.functio
7280 6e 20 63 61 6c 6c 73 3a 0a 0a 25 61 6c 69 61 73 20 64 20 6c 73 20 2d 46 20 20 20 3a 20 27 64 27 n.calls:..%alias.d.ls.-F...:.'d'
72a0 20 69 73 20 6e 6f 77 20 61 6e 20 61 6c 69 61 73 20 66 6f 72 20 27 6c 73 20 2d 46 27 0a 61 6c 69 .is.now.an.alias.for.'ls.-F'.ali
72c0 61 73 20 64 20 6c 73 20 2d 46 20 20 20 20 3a 20 57 6f 72 6b 73 20 69 66 20 27 61 6c 69 61 73 27 as.d.ls.-F....:.Works.if.'alias'
72e0 20 6e 6f 74 20 61 20 70 79 74 68 6f 6e 20 6e 61 6d 65 0a 61 6c 69 73 74 20 3d 20 25 61 6c 69 61 .not.a.python.name.alist.=.%alia
7300 73 20 20 20 3a 20 47 65 74 20 6c 69 73 74 20 6f 66 20 61 6c 69 61 73 65 73 20 74 6f 20 27 61 6c s...:.Get.list.of.aliases.to.'al
7320 69 73 74 27 0a 63 64 20 2f 75 73 72 2f 73 68 61 72 65 20 20 20 20 3a 20 4f 62 76 69 6f 75 73 2e ist'.cd./usr/share....:.Obvious.
7340 20 63 64 20 2d 3c 74 61 62 3e 20 74 6f 20 63 68 6f 6f 73 65 20 66 72 6f 6d 20 76 69 73 69 74 65 .cd.-<tab>.to.choose.from.visite
7360 64 20 64 69 72 73 2e 0a 25 63 64 3f 3f 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 53 65 65 20 68 d.dirs..%cd??............:.See.h
7380 65 6c 70 20 41 4e 44 20 73 6f 75 72 63 65 20 66 6f 72 20 6d 61 67 69 63 20 25 63 64 0a 0a 53 79 elp.AND.source.for.magic.%cd..Sy
73a0 73 74 65 6d 20 63 6f 6d 6d 61 6e 64 73 3a 0a 20 20 20 20 0a 21 63 70 20 61 2e 74 78 74 20 62 2f stem.commands:......!cp.a.txt.b/
73c0 20 20 20 20 20 3a 20 53 79 73 74 65 6d 20 63 6f 6d 6d 61 6e 64 20 65 73 63 61 70 65 2c 20 63 61 .....:.System.command.escape,.ca
73e0 6c 6c 73 20 6f 73 2e 73 79 73 74 65 6d 28 29 0a 63 70 20 61 2e 74 78 74 20 62 2f 20 20 20 20 20 lls.os.system().cp.a.txt.b/.....
7400 20 3a 20 61 66 74 65 72 20 25 72 65 68 61 73 68 78 2c 20 6d 6f 73 74 20 73 79 73 74 65 6d 20 63 .:.after.%rehashx,.most.system.c
7420 6f 6d 6d 61 6e 64 73 20 77 6f 72 6b 20 77 69 74 68 6f 75 74 20 21 0a 63 70 20 24 7b 66 7d 2e 74 ommands.work.without.!.cp.${f}.t
7440 78 74 20 24 62 61 72 20 3a 20 56 61 72 69 61 62 6c 65 20 65 78 70 61 6e 73 69 6f 6e 20 69 6e 20 xt.$bar.:.Variable.expansion.in.
7460 6d 61 67 69 63 73 20 61 6e 64 20 73 79 73 74 65 6d 20 63 6f 6d 6d 61 6e 64 73 0a 66 69 6c 65 73 magics.and.system.commands.files
7480 20 3d 20 21 6c 73 20 2f 75 73 72 20 3a 20 43 61 70 74 75 72 65 20 73 79 74 65 6d 20 63 6f 6d 6d .=.!ls./usr.:.Capture.sytem.comm
74a0 61 6e 64 20 6f 75 74 70 75 74 0a 66 69 6c 65 73 2e 73 2c 20 66 69 6c 65 73 2e 6c 2c 20 66 69 6c and.output.files.s,.files.l,.fil
74c0 65 73 2e 6e 3a 20 22 61 20 62 20 63 22 2c 20 5b 27 61 27 2c 27 62 27 2c 27 63 27 5d 2c 20 27 61 es.n:."a.b.c",.['a','b','c'],.'a
74e0 5c 6e 62 5c 6e 63 27 0a 0a 48 69 73 74 6f 72 79 3a 0a 0a 5f 69 2c 20 5f 69 69 2c 20 5f 69 69 69 \nb\nc'..History:.._i,._ii,._iii
7500 20 20 20 20 3a 20 50 72 65 76 69 6f 75 73 2c 20 6e 65 78 74 20 70 72 65 76 69 6f 75 73 2c 20 6e ....:.Previous,.next.previous,.n
7520 65 78 74 20 6e 65 78 74 20 70 72 65 76 69 6f 75 73 20 69 6e 70 75 74 0a 5f 69 34 2c 20 5f 69 68 ext.next.previous.input._i4,._ih
7540 5b 32 3a 35 5d 20 20 20 20 3a 20 49 6e 70 75 74 20 68 69 73 74 6f 72 79 20 6c 69 6e 65 20 34 2c [2:5]....:.Input.history.line.4,
7560 20 6c 69 6e 65 73 20 32 2d 34 0a 65 78 65 63 20 5f 69 38 31 20 20 20 20 20 20 20 20 3a 20 45 78 .lines.2-4.exec._i81........:.Ex
7580 65 63 75 74 65 20 69 6e 70 75 74 20 68 69 73 74 6f 72 79 20 6c 69 6e 65 20 23 38 31 20 61 67 61 ecute.input.history.line.#81.aga
75a0 69 6e 0a 25 72 65 70 20 38 31 20 20 20 20 20 20 20 20 20 20 3a 20 45 64 69 74 20 69 6e 70 75 74 in.%rep.81..........:.Edit.input
75c0 20 68 69 73 74 6f 72 79 20 6c 69 6e 65 20 23 38 31 20 20 20 20 20 20 20 20 0a 5f 2c 20 5f 5f 2c .history.line.#81........._,.__,
75e0 20 5f 5f 5f 20 20 20 20 20 20 20 3a 20 70 72 65 76 69 6f 75 73 2c 20 6e 65 78 74 20 70 72 65 76 .___.......:.previous,.next.prev
7600 69 6f 75 73 2c 20 6e 65 78 74 20 6e 65 78 74 20 70 72 65 76 69 6f 75 73 20 6f 75 74 70 75 74 0a ious,.next.next.previous.output.
7620 5f 64 68 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 44 69 72 65 63 74 6f 72 79 20 68 69 73 _dh..............:.Directory.his
7640 74 6f 72 79 0a 5f 6f 68 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 4f 75 74 70 75 74 20 68 tory._oh..............:.Output.h
7660 69 73 74 6f 72 79 0a 25 68 69 73 74 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 43 6f 6d 6d 61 6e istory.%hist............:.Comman
7680 64 20 68 69 73 74 6f 72 79 2e 20 27 25 68 69 73 74 20 2d 67 20 66 6f 6f 27 20 73 65 61 72 63 68 d.history..'%hist.-g.foo'.search
76a0 20 68 69 73 74 6f 72 79 20 66 6f 72 20 27 66 6f 6f 27 0a 0a 41 75 74 6f 63 61 6c 6c 3a 0a 0a 66 .history.for.'foo'..Autocall:..f
76c0 20 31 2c 32 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 66 28 31 2c 32 29 0a 2f 66 20 31 2c 32 20 .1,2............:.f(1,2)./f.1,2.
76e0 20 20 20 20 20 20 20 20 20 20 3a 20 66 28 31 2c 32 29 20 28 66 6f 72 63 65 64 20 61 75 74 6f 70 ..........:.f(1,2).(forced.autop
7700 61 72 65 6e 29 0a 2c 66 20 31 20 32 20 20 20 20 20 20 20 20 20 20 20 3a 20 66 28 22 31 22 2c 22 aren).,f.1.2...........:.f("1","
7720 32 22 29 0a 3b 66 20 31 20 32 20 20 20 20 20 20 20 20 20 20 20 3a 20 66 28 22 31 20 32 22 29 0a 2").;f.1.2...........:.f("1.2").
7740 0a 52 65 6d 65 6d 62 65 72 3a 20 54 41 42 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 77 6f 72 6b 73 20 .Remember:.TAB.completion.works.
7760 69 6e 20 6d 61 6e 79 20 63 6f 6e 74 65 78 74 73 2c 20 6e 6f 74 20 6a 75 73 74 20 66 69 6c 65 20 in.many.contexts,.not.just.file.
7780 6e 61 6d 65 73 0a 6f 72 20 70 79 74 68 6f 6e 20 6e 61 6d 65 73 2e 0a 0a 54 68 65 20 66 6f 6c 6c names.or.python.names...The.foll
77a0 6f 77 69 6e 67 20 6d 61 67 69 63 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 63 75 72 72 65 6e owing.magic.functions.are.curren
77c0 74 6c 79 20 61 76 61 69 6c 61 62 6c 65 3a 0a 0a 4e 28 04 00 00 00 74 07 00 00 00 5f 5f 64 6f 63 tly.available:..N(....t....__doc
77e0 5f 5f 74 0e 00 00 00 63 6d 64 5f 6c 69 6e 65 5f 75 73 61 67 65 74 11 00 00 00 69 6e 74 65 72 61 __t....cmd_line_usaget....intera
7800 63 74 69 76 65 5f 75 73 61 67 65 74 0f 00 00 00 71 75 69 63 6b 5f 72 65 66 65 72 65 6e 63 65 28 ctive_usaget....quick_reference(
7820 00 00 00 00 28 00 00 00 00 28 00 00 00 00 73 37 00 00 00 2f 68 6f 6d 65 2f 6f 6c 70 63 2f 41 63 ....(....(....s7.../home/olpc/Ac
7840 74 69 76 69 74 69 65 73 2f 50 79 44 65 62 75 67 2e 61 63 74 69 76 69 74 79 2f 49 50 79 74 68 6f tivities/PyDebug.activity/IPytho
7860 6e 2f 75 73 61 67 65 2e 70 79 74 08 00 00 00 3c 6d 6f 64 75 6c 65 3e 9f 01 00 00 73 06 00 00 00 n/usage.pyt....<module>....s....
7880 06 02 06 af 06 35 .....5