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
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
|
$Id: README,v 1.12 1998-09-28 01:09:18+09 hayashi Exp $
Term::ReadLine::Gnu --- GNU Readline Library Wrapper Module
Copyright (c) 1996,1997,1998 Hiroo Hayashi. All rights reserved.
This program is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
Description:
This is an implementation of the interface to the GNU Readline
Library. This module gives you input line editing facility,
input history management facility, word completion facility,
etc. It uses the real GNU Readline Library. And this module
has the interface with the almost all variables and functions
which are documented in the GNU Readline/History Library. So
you can program your custom editing function, your custom
completion function, and so on with Perl. This may be useful
for prototyping before programming with C.
Ilya Zakharevich distributes his implementation, which bases
on Jeffrey Friedl's readline.pl. His module works very well,
and is easy to install because it is written by only Perl. I
am trying to make my module compatible with his. He gives
useful advises for me.
Unfortunately readline.pl simulates old GNU Readline library.
For example, it is not 8 bit clean and it warns to the
variables in ~/.inputrc which it does not know yet. We
Japanese usually use 8 bit characters, so this is bad feature
for me. And I had interest with C interface facility and
dynamic loading facility of Perl, so I thought it was a good
chance for me to study them. I made this module instead of
fixing his module.
Prerequisites:
You must have GNU Readline Library Version 2.1 or later. See
INSTALL for more detail.
How to build/install:
See INSTALL.
Bugs:
If you use Solaris 2.5 and dynamic loading, "make test" causes
core dump. The only fix I know now is to link this module
statically. See INSTALL for more details.
The GNU Readline Library is very stable. But this is my first
XS programming, my first Perl module programming, and my first
object oriented programming, and... There must be many bugs
in both programs and documents (especially in English
grammar). Comments and bug reports are very welcome.
Author:
Hiroo Hayashi <hiroo.hayashi@computer.org>
Revision History:
1.03 1998-09-27
- fix a bug when prompt string includes non-printing
characters and an input line is longer than terminal width.
Constants, RL_PROMPT_START_IGNORE and RL_PROMPT_END_IGNORE,
are incorporated from the GNU Readline Library to support
this feature.
- now works on a system which does not have /etc/termcap and
has termcap compatible library, libncurses or libcurses.
1.02 1998-08-14
- fix a bug in Makefile.PL, which quoted a variable, $increadlinedir,
with a pair of single quotes
- this is an internal revision
1.01 1998-05-13
- support readline-2.2
add rl_unbind_function_in_map() and rl_unbind_command_in_map()
Makefile.PL checks the version of the GNU Readline Library
- define rl_save_prompt() and rl_restore_prompt()
- document fix
'Changes' file is removed. It is merged into README file.
fix a bug in a sample program of rl_completion_entry_function
1.00 1998-04-15
- the 1st major release
- ornaments feature is now on by default as recent
Term::ReadLine and Term::ReadLine::Perl
- document fix
remove description related to mymalloc
- add ornaments-change function to t/readline.t which
demonstrates rl_message().
0.10 1998-03-31
- new functions/variables
ornaments support
newTTY() (not tested)
max_input_history
read_history() (an aliase of read_history_range())
unstifle_history()
history_search_pos()
history_list()
history_tokenize() (Thank you, Tim Thomas)
history_arg_extract()
get_history_event()
- new sample/test programs
eg/fileman
t/history.t
- bug fix
dynamic loading works on Solaris2.x (define xfree() locally)
readline() calls add_history() only when MinLength > 0
Feature `addhistory' is renamed to `addHistory' since
Term/ReadLine.pm is fixed.
add NULL check for all sv_setpv()
remove arguments 'pos' from history_search()
- misc
change my E-mail address
0.09 Mon Aug 25 00:33:29 1997
- add documentation about readline-2.1.tar.gz
- add documentation about Solaris 2.5 with dynamic loading
- bug fix
fix for Digital Unix C compiler
- add two sample programs
eg/pftp An ftp client with the GNU Readline support
eg/ptksh+ Simple perl/Tk shell which demonstrates
the callback functions
0.08 Sun Apr 13 23:24:52 1997
- bug fix: AddHistory() accepts list again.
- move perlsh into eg/.
- add eg/ptksh+ which demonstrates the callback functions.
Thank you Achim.
- add eg/pftp: an ftp client which has much the GNU Readline support.
- Author's Email address is changed.
- internal functions, fetch_var() and store_var(), are removed.
0.07 Wed Mar 19 02:26:06 1997
- interface to internal function and variables are changed.
New interface is compatible with new Term::ReadLine.pm which
is distributed with Perl 5.003_92 and later. But it is not
compatible with previous release.
- add method interface to all internal function
- add Attribs method to access internal variables
- EXPORT_OK contains only some constant definitions
- tkRunning support (new ReadLine.pm is required)
- add document
- bug fixes
- XS bugs correspond to callback interface
- fix _rl_store_function() and _rl_fetch_function()
- fix prototype of append_history
- use new _rl_store_rl_line_buffer() instead of
reallocate rl_line_buffer.
- etc.
0.06 Wed Feb 5 01:26:27 1997
- the first revision on CPAN
- support for non ANSI C compiler
- rename addhistory to AddHistory
- checked by gcc -Wall
- fix void_arg_func_wrapper()
- add hook for rl_startup_hook in readline()
- update documents
0.05 Sat Jan 25 00:06:56 1997
- Fix for Perl 5.002 and 5.003
escape from an strange Exporter's behavior
remove white spaces in prototype
add argument explicitly
0.04 Thu Jan 23 00:25:45 1997
- This revision supports readline-2.1 or later. readline-2.0
is not supported.
- implement almost all GNU Readline/History Library variables
and functions
- use filehandle directly to access rl_instream and rl_outstream
- define operate_and_get_next and bind to "\C-o" by default
0.03 Sun Nov 24 23:34:27 1996
- OS/2 support by Ilya Zakharevich <ilya@math.ohio-state.edu>
- implement $rl_completer_word_break_characters
- define HAVE_STRING_H by checking $Config{strings}
- remove verbose prototypes on methods
0.02 Thu Nov 21 00:22:11 1996
- fix to install on
SunOS 4.1.3, Solaris 2.3, AIX 4.1.3
0.01 Wed Nov 20 01:14:09 1996
- The 1st alpha release revision (tested on Linux 1.2.13)
|
