author | Tony Garnock-Jones <tonygarnockjones@gmail.com> |
Wed, 16 Jan 2019 17:15:58 +0000 | |
changeset 438 | 1fe179d53161 |
parent 11 | 089a57807585 |
permissions | -rw-r--r-- |
11
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
1 |
INSTALL |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
2 |
pregexp |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
3 |
Dorai Sitaram |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
4 |
last change: 2003-06-04 |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
5 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
6 |
- |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
7 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
8 |
The easiest way to use the pregexp code is to simply |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
9 |
load the file pregexp.scm into your Scheme. (If you |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
10 |
use Common Lisp, load pregexp.cl .) |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
11 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
12 |
Alternatively, if your Scheme dialect is either PLT |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
13 |
Scheme, Gauche, Guile, or Scsh, you can exploit |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
14 |
your dialect's module facility. A module-ized pregexp |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
15 |
has two advantages: (a) It makes the interface to the |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
16 |
pregexp code cleaner, as the module hides |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
17 |
implementation details and avoids polluting the global |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
18 |
namespace. (b) Portions of the pregexp code are |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
19 |
rewritten to take advantage of the dialect's |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
20 |
extensions. |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
21 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
22 |
Use the scmxlate package to |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
23 |
configure pregexp for these dialects. scmxlate is |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
24 |
available from |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
25 |
http://www.ccs.neu.edu/~dorai/scmxlate/scmxlate.html |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
26 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
27 |
Start Scheme in the pregexp directory, and load the |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
28 |
file scmxlate/scmxlate.scm , using the correct relative |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
29 |
or full pathname. You will be asked your Scheme |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
30 |
dialect name: answer plt, gauche, guile, or scsh |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
31 |
as appropriate. |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
32 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
33 |
- |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
34 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
35 |
SECTION 1. |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
36 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
37 |
For PLT, the generated file is pregexp.ss , |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
38 |
which can be loaded using the require syntax. If you |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
39 |
place pregexp.ss in a standard PLT library location, |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
40 |
you can load it with |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
41 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
42 |
(require (lib "pregexp.ss")) |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
43 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
44 |
without worrying about its pathname. |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
45 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
46 |
- |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
47 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
48 |
SECTION 2. |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
49 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
50 |
For Gauche, the generated file is |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
51 |
gauchelib/pregexp.scm. If you place it |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
52 |
in one of the directories in *load-path*, you can |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
53 |
do |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
54 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
55 |
(use pregexp) |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
56 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
57 |
without worrying about its pathname. |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
58 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
59 |
SECTION 3. |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
60 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
61 |
For Guile, the generated file is ice-9/pregexp.scm |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
62 |
(ie, the file pregexp.scm in the subdirectory ice-9 ). |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
63 |
If you place pregexp.scm in an ice-9 |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
64 |
subdirectory in your |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
65 |
%load-path, you can load it with |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
66 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
67 |
(use-modules (ice-9 pregexp)) |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
68 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
69 |
- |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
70 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
71 |
SECTION 4. |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
72 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
73 |
For Scsh, the generated file is |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
74 |
scsh/pregexp.scm . Move it to an appropriate |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
75 |
library location. To load the pregexp module in |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
76 |
Scsh, you need to do the following (with |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
77 |
the correct pathname for pregexp.scm). |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
78 |
|
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
79 |
,config ,load pregexp.scm |
089a57807585
Dorai Sitaram's Portable Regular Expression matcher
Tony Garnock-Jones <tonyg@kcbbs.gen.nz>
parents:
diff
changeset
|
80 |
,open pregexp |