[ < < < Home ] [ < < Reference Start ] [ < Reference Contents ]
[ < Previous=FGREPPE 3.13 ] [ Next=NLX 3.13 > ]
FGREPPE 3.13 Options

FGREPPE has option Menu sections for:

	File, View, Search, Replace, Misc and Help.

All these menus have options.  Many are shared by other IS Text
Tools and PDGREPPE.

Search and Replace Menu options are detailed in GREPPES Options
and many of them are shared with PDGREPPE and the newline
translation Text Tool named NLX.

Some FGREPPE Search Options are unique to FGREPPE and affect
pattern interpretation, case sensitivity and important search
criteria such as finding words only or using the entire contents
of a file as the search pattern.

As well, a standard HELP menu gives options on options as shown
in COMMON Options.

For BEGINNERS the options most useful are listed in the
Greppes Options section.

In FGREPPE a very useful option is:

	-w	  search for pattern as entire Word.

The following FGREPPE options are listed in the same order as
they would be shown with option "-tS" that shows options by
sequence.

COMMON OPTIONS:
-$	  show contact information.
-?	  show program information.
-C:f<d>	  string for File insert for -C options. ([F])
-C:i	  when option -C<d> Ignore ERROR LEVEL.
-C:n	  when option -C<d> No filter.
-C<d>	  pre-filter input data by Command <d> with sub [F].
-N	  No process of data.
-O	  turn Off all options.
-R<d>	  Register this program with supplied key <d> and .KEY file.
-X<d>	  eXclude files list.++
-a	  show All of Many options by Menu.
-f	  show File name at front of each line.
-h	  select Hidden files too.
-jA       options with Attached list data (++) can Accumulate.
-ja	  just examine All-ASCII files.
-je	  expand Environment %VARIABLES% in program parameters.
-jn	  wait for Network access.
-jp	  do data Prompt.
-jq<d>    command quote sequence. (")
-jt	  just examine all Text files.
-kB	  show edit Backup:<InputFile>-><BackUpFile> when -ke -ko and -kb.
-kF	  edit Files as NOT having DOS 8.3 file names.
-o	  Omit single file name at start of output.
-tA	  append All output if option -to<d>.
-tC	  open all files as Compatible for sharing.
-tF<d>	  default directories for option -jF<d> command File(s).++ (.;:HOME:)
-tI	  show all options by Input/Output.
-tK	  allow Key buffer for typeahead.
-tO	  append Output if option -to<d>.
-tS	  show all options by Sequence.
-tT<d>    Temporary files directory. (%TEMP%)
-tV<d>	  display message <d> on Video screen.
-tW	  append Warnings and error messages if option -tw<d>.
-ta<d>	  save All output to file <d>.
-tb	  disable VGA Blink.
-tc<d>	  column to wrap data display.
-td	  show screen space or tab as Dot or diamond.
-te	  Eliminate screen status line.
-tf	  try old standard DOS 8.3 File names first.
-ti	  use Input by pipe | or redirect < for Keys Input.
-tk	  press Key to continue.
-to<d>	  save Output to file <d>.
-tw<d>	  save Warnings and error messages to file <d>.
-tx	  use eXplicit *: and / in file paths.

See Common Options.

OPTION:

-1	  process only 1 match per line.


See Greppes Options.

OPTION:

-A<d>	  show up to <d> lines After match line.


See Greppes Options.

OPTION:

-B	  Blink in match to screen.


See Greppes Options.

OPTION:

-E	  permit Escape sequences \0 to \255 and \N.


Enables searching for special characters or new line characters
"\N" or any character specified by its decimal numeric value
"\0" to "\255".

Escape sequences can also be used in replacement patterns.


	fgreppe -Hjc -E \N file_id.diz


..."-E" helps find ends of lines by pattern "\N".


	fgreppe -Hjc -E \80 file_id.diz


..."-E" helps find P's (ASCII 80) by pattern "\80".

OPTION:

-G	  show data in match area Gap only.


See Greppes Options.

OPTION:

-H	  High intensity in match to screen.


See Greppes Options.

OPTION:

-I	  show pattern Information.


See Greppes Options.

OPTION:

-P<d>	  show up to <d> lines Previous to match line.


See Greppes Options.

OPTION:

-Q	  Quit program on first match.


See Greppes Options.

OPTION:

-S	  show Summary for group of files.


See Greppes Options.

OPTION:

-V        strict program return Value.


See Greppes Options.

OPTION:

-b	  show file match Byte position with prefix FP.


See Greppes Options.

OPTION:

-d	  show output Data length with prefix DL.


See Greppes Options.

OPTION:

-e<d>	  Exchange for different search pattern <d>.


See Greppes Options.

OPTION:

-f	  show File name at front of each line.


See Greppes Options.

OPTION:

-g	  show match Gap length with prefix ML.


See Greppes Options.

OPTION:

-i	  letters in pattern are case Insensitive.


See Greppes Options.

OPTION:

-jE<d>	  <d> is string to show match End. (>)


See Greppes Options.

OPTION:

-jF<d>	  take options and specs from File name <d>.


The best way to get long lines of LITERAL pattern data into
FGREPPE is to use the "-jl<d>" and "-kl<d>"
literal-pattern-from-file options.

See Common Options.
See Greppes Options.

OPTION:

-jR	  Rescan data continuously.


See Greppes Options.

OPTION:

-jS<d>	  <d> is string to show match Start. (<)


See Greppes Options.

OPTION:

-jT<d>	  Text characters range is <d>. ([\9\10\13\32-\126])


This range can only have simple values.

See Common Options.

OPTION:

-jc	  show match area in <Closure>.


See Greppes Options.

OPTION:

-jd	  omit Data print.


See Greppes Options.

OPTION:

-jf	  Filter output to Text characters.


Display any non-text character sequence as high-lighted '@'.

See Common Options.

OPTION:

-jl<d>	  use entire contents of file <d> as Literal search data.


See Greppes Options.

OPTION:

-jr	  Rescan data until matches detected.


See Greppes Options.

OPTION:

-jw<d>	  Word character range is [<d>]. ([0-9A-Za-z])


This range can only have simple values.

See Greppes Options.

OPTION:

-kR	  Rescan if edit original file, got matches and reduced result size.


See Greppes Options.

OPTION:

-kb	  backup original edit file.


See Greppes Options.

OPTION:

-ke	  Edit matches - Use this to switch ON editing.


See Greppes Options.

OPTION:

-kf	  Force edit changes to file if write protected.


See Greppes Options.

OPTION:

-ki	  Interactive edit mode.


See Greppes Options.

OPTION:

-kl<d>	  use entire contents of file <d> as Literal replace edit data.


See Greppes Options.

OPTION:

-ko	  modify Original file by edit.


See Greppes Options.

OPTION:

-kr<d>	  <d> is edit Replace pattern.


See Greppes Options.

OPTION:

-kt	  if modify original file (-ko) keep previous Time and date.


See Greppes Options.

OPTION:

-kv	  Verbose edit mode.


See Greppes Options.

OPTION:

-kw	  omit edit Warnings.


See Greppes Options.

OPTION:

-l	  show only one Line with file name if meets criteria.


See Greppes Options.

OPTION:

-m	  show Match number with prefix MN.


See Greppes Options.

OPTION:

-n	  show line Number.


See Greppes Options.

OPTION:

-p	  show line match Position with prefix LP.


See Greppes Options.

OPTION:

-q	  Quit each file on first match.

See Greppes Options.

OPTION:

-r	  Recursive search for file(s), dir\files(s) or dir\.


See Common Options.
See Greppes Options.

OPTION:

-s	  show Summary of Pattern, File and Results per file.


If the User Search or Replace patterns are different than the
final patterns due to option -E, then Final patterns are shown
in addition to the User patterns.

See Greppes Options.

OPTION:

-tB	  use minimum length for search Buffer.


See Greppes Options.

OPTION:

-tD	  show screen match/replace space or tab as Dot or diamond.


See Greppes Options.

OPTION:

-ts	  show technical Summary.


See Greppes Options.

OPTION:

-v	  inVert search to lines missing pattern.


See Greppes Options.

OPTION:

-w	  search for pattern as entire Word.


A sequence of characters can be a word if they are all in the
Word Character Range.

This option helps to select a word rather than a syllable or
part of an entire word that is larger.

For example to find the word

"one"

the option -w will only find the word

"one"

and NOT "one" in

"bones"

and NOT "one" in

"ones"

and NOT "one" in

"tone".

Or this option will find phrases that have definite word stops
at both start and end like

	"old bones"

in

	"I found some old bones"

rather than "old bones" in

	"Gold bones"

Or for a pattern "final word" it will find

	"final word"

by itself rather than the phrase "final word" in

	"final words".


	fgreppe -Hjc "pattern" file_id.diz


...any "pattern", even as "pattern" of "patterns".


	fgreppe -Hjc -w "pattern" file_id.diz


..."-w" only finds "pattern" as a complete word, not "patterns".

If either end of the pattern contains characters that are not
Word characters, then the match of the pattern end is always
made like usual.
[ < < < Home ] [ < < Reference Start ] [ < Reference Contents ]
[ < Previous=FGREPPE 3.13 ] [ Next=NLX 3.13 > ]