-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
140 lines (104 loc) · 4.45 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
Created on: Thu 10 Dec 2009 10:32:58 PM
Last saved: Tue 09 Jul 2013 08:51:39 AM
+-----------------------------------------------------------+
| OS/Platforms supported: ALL |
+-----------------------------------------------------------+
This directory contains development efforts for a new and
improved perldl shell (Perldl2).
You need to install the version 1.003011 of Devel::REPL
and have installed either Term::ReadLine::Perl or
Term::ReadLine::Gnu in order to use the new Perldl2 shell
capabilities.
+-----------------------------------------------------------+
| CONTENTS |
+-----------------------------------------------------------+
README
This file
TODO
Development list for Perldl2 shell
Makefile.PL
Perl configuration/build script for Perldl2
Plugin/
Profile/
Script.pm
Perl modules and directories with modules for Perldl2
pdl2
A perl script for starting the Perldl2 shell.
(Falls back to the original perldl if either Devel::REPL
or neither Term::ReadLine::Gnu nor Term::ReadLine::Perl
are installed.)
+-----------------------------------------------------------+
| INSTALLATION |
+-----------------------------------------------------------+
By default, the Perldl2 shell is always built and the
pdl2 script installed.
You will need to install Devel::REPL version 1.003011
or greater and either of Term::ReadLine::Gnu or
Term::ReadLine::Perl to access the new pdl2 capabilities.
+-----------------------------------------------------------+
| USE |
+-----------------------------------------------------------+
To use the Perldl2 shell, from the PDL build directory
run the following:
perl -Mblib Perldl2/pdl2
If you have installed the just built PDL, you should
be able to run:
pdl2
To exit the Perldl2 shell from the 'pdl> ' prompt, type
Ctrl-D or quit, (q, x, and exit shortcuts are also
available). If Devel::REPL is not installed (or you
don't have either TR::Gnu or TR::Perl), pdl2 will use
perldl instead but the new Perldl2 features will not
be available.
The idea is that one just uses pdl2 where you used to
use perldl. At some point, the development will be
complete and there will be only one PDL shell.
+-----------------------------------------------------------+
| NOTES |
+-----------------------------------------------------------+
Supported functionality from Devel::REPL and PDL:
* DDS (pretty prints output using Data::Dump::Streamer)
* History (redo commands with !-1 and !<num> syntax)
* Interrupt (interrupt with Ctrl-C; not on MSWin32)
* LexEnv (e.g., my $x = zeros(10) works)
* MultiLine::PPI (handles multiline input like perldl)
* NiceSlice (PDL::NiceSlice works too!)
* Packages (keeps track of current user package)
* PDLCommands (perldl shell v1 convenience routines)
* ReadLineHistory
* Save and restore command history to file
* CompletionDrivers
* Globals (completion for globals)
* INC (completion for use module::name)
* Keywords (completion for perl keywords)
* LexEnv (completion for lexical vars)
* Methods (completion of method names)
Default PDL modules loaded:
* PDL
* PDL::Dbg
* PDL::Doc::Perldl
* PDL::IO::Dumper
* PDL::IO::FlexRaw
* PDL::IO::Pic
* PDL::Image2D
* PDL::AutoLoader
? and ?? are aliases for help and apropos
Arguments to help|usage|apropos|sig|badinfo|demo are autoquoted
Shell escapes start with $PERLDL::ESCAPE as the first character
of a line ('#' by default).
l <num> prints the last <num> lines of history, default 20.
p prints the following args separated by space (i.e., $,=' ')
demo as a command by itself lists the possible demos available.
Otherwise it runs the specified demo.
By default, leading patterns matching the pdl2 shell
prompt ('pdl> ' with possible surrounding white space)
are stripped from the input. That allows for easy
cut-and-paste of pdl2 sessions from examples, demos,
or docs.
The Perldl2 shell, pdl2, loads/saves from the same history
file as perldl.
The Perldl2 shell, pdl2, loads your .perldlrc file
from the same location as the perldl shell does. It also
accepts .pdlrc as the name---looking forward to the new
naming scheme for the interactive shell. A local.pdlrc
or local.perldlrc are run if present as well.