Differences between revisions 1 and 30 (spanning 29 versions)
Revision 1 as of 2010-12-22 10:41:36
Size: 1224
Editor: KaiJaeger
Comment:
Revision 30 as of 2013-12-09 19:09:05
Size: 2996
Editor: KaiJaeger
Comment: New features in "These"
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Compare = = CompareSimple =
Line 6: Line 6:
`Compare` is part of the CategoryAplApl project. `CompareSimple` is part of the CategoryAplTree project.
Line 9: Line 9:
...
Line 11: Line 10:
== Details ==
...
`CompareSimple` offers a couple of methods designed to compare functions, operators, scripts and files. It is also able to deal with SALTed files as well as `acre` component files.
Line 14: Line 12:
== Methods ==
Line 15: Line 14:
== Examples ==
...
There are just two main functions:
Line 18: Line 16:
== History ==
For a full version history: [[Compare/History|History]]
=== Match ===

`Match` takes names of functions or operators or scripts and compares the source code. Note that taking the source code with `⎕CR` or `⎕SRC` and then `≡` them is not always going to work: white spaces as well as formatting problems might result in a 0 when the source code is in fact identicall. `Match` deals with these problems properly.

=== These ===

`These` accepts a variety of arguments listed underneath. According to its arguments it tries to figure out what your intention is and carries out the appropriate action.

Note that whenever the word "function" is used here it can also be a defined operator (which is in Dyalog APL a derived function anyway).

==== Script / script ====
Compare the two scripts. Note that you can specify name(s) as well as reference(s).

==== Script / name of a *.dyalog file ====
Compare the workspace script with the file.

==== Script ====
This syntax requires "Script" to be managed either by SALT or by acre.
 
 * If it is managed by acre then a dialog pops up with the number of all versions saved by acre.
 * If it is managed by SALT the workspace script is compared with its SALTed source file.

Note however that for acre this requires the script in question to be a member of an opened acre project at the time the comparison is carried out.

==== Name of a native file / name of a native file ====
Compare the two files.

==== Function name / function name ====
Compare two functions in the workspace.

==== Function name / name of a native file ====
Compare the function in the workspace with the file.

==== Function name / name of an acre component file ====
Compare the function in the workspace with the `acre` component file.

==== Function name ====
If it is managed by acre then a dialog pops up with the number of all versions saved by acre.

Note that the function in question must be a member of an opened acre project at the time the comparison is carried out.

==== Namespace / namespace ====
Note that this works only with named namespaces, although the argument might be either references or names pointing to the two namespaces.

== Project Page ==

For bug reports, future enhancements and a full version history see [[CompareSimple/ProjectPage]]
Line 25: Line 68:
||Current state: ||1.0.0 ||
Line 27: Line 69:
== Download ==
You have two options: you can either download the script for usage:
<<Include(APLTreeDownloads)>>
Line 30: Line 71:
[[http://aplwiki.com/Compare?action=AttachFile&do=get&target=Compare.ZIP|Download Compare script right now]]

or get the whole thing from the AplWikiRepository, including the development workspace and the script and maybe more for any development or for running the test cases:

/* You might want to exchange "dyalog" here: */
{{{
svn list svn://aplteam.com/os/dyalog/Compare/tags
}}}
If you plan to contribute please note that all stuff published as part of the APLAPL project must follow certain [[AplAplStandards|APLAPL-specific standards]].
Line 40: Line 72:
CategoryAplApl CategoryAplTree

CompareSimple

(Hide table-of-contents)

CompareSimple is part of the CategoryAplTree project.

Overview

CompareSimple offers a couple of methods designed to compare functions, operators, scripts and files. It is also able to deal with SALTed files as well as acre component files.

Methods

There are just two main functions:

Match

Match takes names of functions or operators or scripts and compares the source code. Note that taking the source code with ⎕CR or ⎕SRC and then them is not always going to work: white spaces as well as formatting problems might result in a 0 when the source code is in fact identicall. Match deals with these problems properly.

These

These accepts a variety of arguments listed underneath. According to its arguments it tries to figure out what your intention is and carries out the appropriate action.

Note that whenever the word "function" is used here it can also be a defined operator (which is in Dyalog APL a derived function anyway).

Script / script

Compare the two scripts. Note that you can specify name(s) as well as reference(s).

Script / name of a *.dyalog file

Compare the workspace script with the file.

Script

This syntax requires "Script" to be managed either by SALT or by acre.

  • If it is managed by acre then a dialog pops up with the number of all versions saved by acre.
  • If it is managed by SALT the workspace script is compared with its SALTed source file.

Note however that for acre this requires the script in question to be a member of an opened acre project at the time the comparison is carried out.

Name of a native file / name of a native file

Compare the two files.

Function name / function name

Compare two functions in the workspace.

Function name / name of a native file

Compare the function in the workspace with the file.

Function name / name of an acre component file

Compare the function in the workspace with the acre component file.

Function name

If it is managed by acre then a dialog pops up with the number of all versions saved by acre.

Note that the function in question must be a member of an opened acre project at the time the comparison is carried out.

Namespace / namespace

Note that this works only with named namespaces, although the argument might be either references or names pointing to the two namespaces.

Project Page

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

Version Information

Original author:

KaiJaeger

Responsible:

KaiJaeger

Email:

kai@aplteam.com


CategoryAplTree

CompareSimple (last edited 2018-03-03 11:51:12 by KaiJaeger)