File: redet.1

package info (click to toggle)
redet 8.26-1.3
  • links: PTS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 8,088 kB
  • sloc: tcl: 38,887; makefile: 106; sh: 23
file content (126 lines) | stat: -rw-r--r-- 4,177 bytes parent folder | download | duplicates (2)
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
.TH REDET "1" "May 2007" "redet " "User Commands" 
.SH NAME
redet \- regular expression development and execution tool
.SH SYNOPSIS
.B redet
<options> [<input file>]
.SH DESCRIPTION
.PP
.I redet
allows the user to construct regular expressions and test them against input
data by executing any of a variety of search programs, editors, and programming languages
that make use of regular expressions. When a suitable regular expression has been constructed
it may be saved to a file.
.PP
Redet currently supports over fifty different programs and regular expression
libraries. These include multiple versions of grep,
several editors (Ed, Emacs, Sed, Vim),
all the popular scripting languages (Awk, Perl, Python, Ruby, Tcl)
and some less popular ones (Lua, Pike, Rebol),
most shells (Bash, Ksh, Tcsh, Zsh)
and various other languages, including Guile, Icon and Java.
.PP
For each program, a palette showing the
available regular expression syntax is provided. Selections from the palette may be copied
to the regular expression window with a mouse click. Users may add their own definitions
to the palette via their initialization file.
.I Redet
also keeps a list of the regular expressions executed, from which entries may be copied back
into the regular expression under construction. The history list is saved to a file and restored
on startup, so it persists across sessions.
.PP
.I Redet
provides both regular expression matching and substitution so long as
the underlying program does.
.PP
Although
.I Redet
is primarily an interface for other programs, it adds some features of its own.
It is possible to define named character classes within
.I Redet
\, and to intersect them. This allows provides a means of searching on feature matrices.
.PP
So long as the underlying program
supports Unicode,
.I redet
allows UTF-8 Unicode in both test data and regular expressions. Several tools provide additional
support for Unicode use. These include popup lists of Unicode ranges and general character
properties, a widget for entering characters by their numerical code, and widgets for entering
International Phonetic Alphabet characters, widgets for entering letters with a variety of
accents and other diacritics. Although internal operations are entirely in Unicode,
test data, comparison data, and results may be read and written in any encoding
supported by Tcl/Tk.
.I Redet
is fully internationalized. If a suitable message catalogue is provided, the interface
may be made available in any language and writing system supported by Unicode for which
the necessary fonts are available.
.PP
For usage information, execute
.I redet
with the command line flag -h.
.PP
Full information about
.B redet
is available from the reference manual, which consists of a set
of web pages. The master copy is located at:
http://www.cis.upenn.edu/~wjposer/RedetManual/Manual.html.
The entry
.I Illustrated Web Manual
on the
.I Help
menu will take you to the master manual page.
The manual pages are packaged with every copy of Redet.
.sp 1
.SH OPTIONS
.TP
\fB\-c\fR <file name>
read character class definitions from the named file
.TP
\fB\-d\fR
set the debug flag.
This causes additional information to be printed during program execution.
It is mostly useful for developers.
.TP
\fB\-F <filename>\fR
read a feature list from <filename>
.TP
\fB\-f\fR
act as a filter. This means that input is read from the standard input
and output written to the standard output.
.TP
\fB\-H\fR
do not read the history file
.TP
\fB\-h\fR
print this help information
.TP
\fB\-I\fR <file>
read <file> as the initialization file
.TP
\fB\-i\fR
do not read the initialization file
.TP
\fB\-n\fR
do not execute feature tests on startup
.TP
\fB\-P\fR
list the programs supported and indicate which are available
.TP
\fB\-p\fR <program>
use the named program
.TP
\fB\-s\fR
start up in substitution mode
.TP
\fB\-t\fR
show the results of feature tests
.TP
\fB\-v\fR
print the program name and version, then exit
.SH "SEE ALSO"
awk (1), ed (1),grep (1), perl (1), sed (1) 
.sp 1
.SH AUTHOR
Bill Poser (billposer@alum.mit.edu)
.SH LICENSE
GNU General Public License (http://www.gnu.org/licenses/gpl.txt), version 2.