Differences between revisions 1 and 10 (spanning 9 versions)
Revision 1 as of 2011-12-14 08:39:46
Size: 151
Editor: KaiJaeger
Comment:
Revision 10 as of 2012-03-15 21:00:04
Size: 3042
Editor: KaiJaeger
Comment:
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:

<<TableOfContents>>
Line 5: Line 7:
'''''Fire''''' stands for for FInd and REplace. It's designed to... '''''Fire''''' stands for for FInd and REplace. It's designed to search and replace strings in the workspace.
Line 7: Line 9:
(Currently this is just a placeholder) == Features ==

Fire's main feature is the "Replace" command which allows you in an easy yet powerful way to replace certain strings in all or selected objects.

Other features are:

 * You can restrict the search to one or more of these object classes:
    * traditional functions & operators
    * direct functions & operators
    * Classes
    * Interfaces
    * Scripted namespaces
    * Variables
 * You can search...
    * the full source code
    * the full source code but comments
    * comments only
    * text only
 * Use regular expression in your search string (`⎕S, ⎕R`)
 * Negate a search ("every object that does '''not''' contain...)
 * Search only the hits of the last search

== Difference between Dyalog's build-in Search tool and Fire ==

 * Fire handles circular references correctly (thanks to PhilLast)

== Fire's GUI ==

=== Main Window ===

{{attachment:Fire_01.png}}

Specifying anything in the "Start looking here" control is supported by autocomplete: this box offers all ordinary namespaces matching the characters in "Start looking here".

{{attachment:Fire_02.png}}

=== The "Replace" feature ===

The Replace feature allows you to change the workspace on a global level:

{{attachment:Replace.png}}

There are two modes available:

 * In batch mode you can check all changes in one go and then either accept or discard them.
 * "One-by-one" allows you to compare and edit one object after the other.

==== Batch mode ====

This is the first of three steps in Batch mode:

{{attachment:Replace2.png}}

It's a reminder that for "Replace" it's always the whole hit list that is processed, not only the selection.

This is the second step in Batch mode:

{{attachment:Batch_02.png}}

It allows you to check whether everything is okay or not. Here we see a "compressed" report: it contains only the potentially changed lines plus the object names plus the headers for all traditional functions and operators in order to make checking local variables easy. The full report would show all lines of all objects involved. You cannot change anything at this stage.

This is the third and last step:

{{attachment:Batch_03.png}}

This allows you to either fix all objects or discard all changes.

==== One by one ====

In one-by-one mode you can check and edit a single object:

{{attachment:OneByOne_01.png}}

In the next step you can either fix the changes are skip this object and carry on with the next one or cancel the rest of the Replace operation:

{{attachment:OneByOne_02.png}}

== Project Page ==

For bug reports, future enhancements and a full version history see [[Fire/ProjectPage]]

== Version Information ==
||Original author: ||KaiJaeger ||
||Responsible: ||KaiJaeger ||
||Email: || kai@aplteam.com ||

<<Include(APLTreeDownloads)>>

Fire

/!\ Under construction

Fire stands for for FInd and REplace. It's designed to search and replace strings in the workspace.

Features

Fire's main feature is the "Replace" command which allows you in an easy yet powerful way to replace certain strings in all or selected objects.

Other features are:

  • You can restrict the search to one or more of these object classes:
    • traditional functions & operators

    • direct functions & operators

    • Classes
    • Interfaces
    • Scripted namespaces
    • Variables
  • You can search...
    • the full source code
    • the full source code but comments
    • comments only
    • text only
  • Use regular expression in your search string (⎕S, ⎕R)

  • Negate a search ("every object that does not contain...)

  • Search only the hits of the last search

Difference between Dyalog's build-in Search tool and Fire

  • Fire handles circular references correctly (thanks to PhilLast)

Fire's GUI

Main Window

Fire_01.png

Specifying anything in the "Start looking here" control is supported by autocomplete: this box offers all ordinary namespaces matching the characters in "Start looking here".

Fire_02.png

The "Replace" feature

The Replace feature allows you to change the workspace on a global level:

Replace.png

There are two modes available:

  • In batch mode you can check all changes in one go and then either accept or discard them.
  • "One-by-one" allows you to compare and edit one object after the other.

Batch mode

This is the first of three steps in Batch mode:

It's a reminder that for "Replace" it's always the whole hit list that is processed, not only the selection.

This is the second step in Batch mode:

Batch_02.png

It allows you to check whether everything is okay or not. Here we see a "compressed" report: it contains only the potentially changed lines plus the object names plus the headers for all traditional functions and operators in order to make checking local variables easy. The full report would show all lines of all objects involved. You cannot change anything at this stage.

This is the third and last step:

Batch_03.png

This allows you to either fix all objects or discard all changes.

One by one

In one-by-one mode you can check and edit a single object:

OneByOne_01.png

In the next step you can either fix the changes are skip this object and carry on with the next one or cancel the rest of the Replace operation:

OneByOne_02.png

Project Page

For bug reports, future enhancements and a full version history see Fire/ProjectPage

Version Information

Original author:

KaiJaeger

Responsible:

KaiJaeger

Email:

kai@aplteam.com

Fire (last edited 2018-03-03 11:50:12 by KaiJaeger)