1TXT2REGEX(1) General Commands Manual TXT2REGEX(1)
2
3
4
6 txt2regex - a Regular Expression Wizard, written with bash2 builtins
7
8
10 txt2regex
11
12
13 txt2regex --nocolor|--whitebg
14
15
16 txt2regex --all|--prog <p1,p2,...,pN>
17
18
19 txt2regex --showmeta|--showinfo <program>
20
21
22 txt2regex --make <target>
23
24
25 txt2regex --history <value>
26
27
29 txt2regex is a Regular Expression "wizard", all written with bash2
30 builtins, that converts human sentences to regexes.
31
32
33 With a simple interactive interface, you just answer to questions and
34 build your own regex for a large variety of programs, like awk, emacs,
35 grep, perl, php, procmail, python, sed and vim. There are more than 20
36 supported programs.
37
38
39 It's bash so download and run, no compilation needed.
40
41
42 Please visit the program homepage at http://txt2regex.sf.net.
43
44
46 --all works with all registered programs
47
48
49 --help prints the help message and quit
50
51
52 --history <value>
53 prints to STDOUT a regex from a history data
54
55
56 --make <target>
57 prints a ready regex for a common pattern
58
59
60 --nocolor
61 self-explanatory
62
63
64 --prog <p1,p2,...>
65 choose which programs to use (separated by commas)
66
67
68 --showinfo <program>
69 prints regex info about the program
70
71
72 --showmeta
73 prints a complete metachar table for all programs
74
75
76 --version
77 prints the program version and quit
78
79
80 --whitebg
81 colors adjusted to white background terminals
82
83
84 By default, all options are turned OFF. Just call it with no options to
85 launch the default interactive interface.
86
87
89 --all is cool but requires lots of lines (~35)
90
91
92 --nocolor is strong, so it kills --whitebg
93
94
95 --showmeta rules, try it
96
97
98 --showinfo uses reverse video output, --nocolor turns it off
99
100
101 --history is getting useful, stay tunned
102
103
104 --make is a remedy for headaches
105
106
107 --prog is nice to use your favorite programs, mix it with --make and
108 --history
109
110
112 Calling the program on the default interactive interface
113 $ txt2regex
114
115
116
117 Calling the program on a white terminal
118 $ xterm -fg black -bg white ; txt2regex --whitebg
119
120
121
122 Getting information
123 $ txt2regex --showmeta
124
125
126
127 Getting specific information
128 $ txt2regex --showinfo sed
129
130
131
132 Calling it for specific programs
133 $ txt2regex --prog vim,sed,grep,python
134
135
136
137 Applying a history data
138 $ txt2regex --history '16421¤:01¤:'
139
140
141
142 Getting ready regexes!
143 $ txt2regex --make hour
144 $ txt2regex --make number3 --prog perl
145 $ txt2regex --make date2 --all
146
147
148
150 The program interface is simple and easy to use. This is its contents:
151
152 +---------------------------------------+
153 | -> Top menu |
154 | -> Group menu |
155 | |
156 | -> Regexes of the programs selected |
157 | ... |
158 | ... |
159 | |
160 | -> History |
161 | -> Your prompt |
162 | |
163 | -> The question |
164 | -> The answers |
165 | ... |
166 | ... |
167 +---------------------------------------+
168
169
170
171 All the basic commands can be used on the numeric pad on the keyboard,
172 but remember to turn ON the NumLock key.
173
174
175 Command Description
176 . Quit the program (with confirmation)
177 0 Reset the Regular Expression
178 1-9 Answers the questions
179 * Toggles color ON/OFF
180 / Add/remove programs on/from the list
181 | Insert an alternation (where allowed)
182 ( Open a new group (where allowed)
183 ) Close the opened group (if any)
184
185
186
188 Bug reports and contributions are VERY welcome! Please send them to
189 the author.
190
191
193 Written and maintained by Aurelio Marinho Jargas <verde@aurelio.net>
194
195
197 Copyright © 2000, 2001, 2002, 2003, 2004 Aurelio Marinho Jargas
198
199
200 This is free software; see the source for copying conditions. There is
201 NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
202 PURPOSE.
203
204
205
206
207
208
209 September, 28th - 2004 TXT2REGEX(1)