1TXT2REGEX(1)                General Commands Manual               TXT2REGEX(1)
2
3
4

NAME

6       txt2regex - a Regular Expression Wizard, written with bash2 builtins
7
8

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

DETAILS

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

EXAMPLES

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

INTERFACE

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

BUGS

188       Bug reports and contributions are VERY welcome!  Please  send  them  to
189       the author.
190
191

AUTHOR

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)
Impressum