Guiffy Command Line

Guiffy's command line interface allows you to specify the files to be compared. Or, you can specify two folders to compare. Also, options are provided for performing merges automatically with file pairs and running the SureMerge(3-Way) with a specified parent file. On Merge or SureMerge commands, the Merge result file(optional) is accepted as the last file name argument. All file name arguments may be specified as relative (to the current working directory) or absolute paths. Automation options are also available for automatically saving compare or merge results.
NOTES:
To specify filenames including blanks, encapsulate the filename with double quotes.
To specify a UNC for a filename, use \\\\servername for the usual \\servername.
The guiffy command line interface executable on Windows is the installed file guiffy.exe
The guiffy command line interface executable on MacOS X is the installed shell script guiffy
The guiffy command line interface executable on Linux and Unix is the installed shell script guiffy

Usage:
Just starts Guiffy:
guiffy [-options]
To compare files:
guiffy [-options] <1st file> <2nd file>
To compare folders:
guiffy [-options] <1st folder> <2nd folder> [parent folder] [result folder]
Note: optional parent and result folder used when launching 3-way merge from folder compare.
To Merge(2-way):
guiffy -m [-options] <1st file> <2nd file> [result file]
To SureMerge(3-way):
guiffy -s [-options] <1st file> <2nd file> <parent file> [result file]
To Automatically Save a compare as HTML:
guiffy -ahfileset.html [-options] <1st file> <2nd file>

To begin a merge with a CVS "conflict" file:
guiffy -mocvsD:\filename.typ [-options] [result file]

Where options include:
-ad -autod fn Automatically Save the Difference and Exit
For example: -adC:\build\About.dif automatically saves the difference to "C:\build\About.dif"
-ah -autoh fn Automatically Save the Difference as HTML and Exit
For example: -ahC:\build\w3\About.html automatically saves the difference as HTML to the "C:\build\w3\About.html" file set
-am -automAutomatically Save the Merge Result(from either 2-way or 3-way) and Exit
Note: -am with -gs will only Save the Merge Result if there are no Attentions
-bsf verify subfolder matches, (folder compares)
-b bxb verify file matches, byte-by-byte (folder compares)
-bxt verify file matches, Text compare (folder compares)
-c -case ignore upper/lower Case differences
-d -diffs only show the Differences
-dalign Show Align similar lines
-dinline Show InLine Diffs OFF
-dinpct pp Show InLine Diffs when < pct of line length
pp defaults to 50, ie. -dinpct75 or -dincpt33
-dinchroff Show InLine Diffs Char-by-Char OFF
-dinchr Show InLine Diffs Char-by-Char
-eauto EOLs written Auto Mode
-ed EOLs written for DOS
-em EOLs written for MacOS
-eu EOLs written for Unix
-enauto Encoding Auto Mode
-enf spec Encoding for files(1st, 2nd, and Parent)
For Example: -enfUnicodeLittle
-en1 spec Encoding for 1st files
For Example: -en1UnicodeLittle
-en2 spec Encoding for 2nd files
For Example: -en2UnicodeLittle
-enp spec Encoding for Parent files
For Example: -enpUnicodeLittle
-ens spec Encoding for Saved files(Dif, RCS, MergeResult, and HTML)
For Example: -ensUnicodeLittle
-fxxx,yyy ignore Field in columns xxx through yyy
For Example: -f73,80 ignores columns 73 through 80
May be specified twice for 2 fields
-fd DO NOT Show Folder Compare Details (Size and Date)
-ff Show Folder Compare using default Tree Font
-gc Forbid(Grayout) File Compares (during Merges)
-ge1 Forbid 1st file view Editing (during Compares)
-ge2 Forbid 2nd file view Editing (during Compares)
-gf Forbid(Grayout) Folder Compares (during Merges)
-gm Forbid(Grayout) Merges (during Compares)
-gs Forbid(Grayout) Save Merge until complete (during Merges)
Note: -am with -gs will only Save the Merge Result if there are no Attentions
-hm hdr Header for Merge file
-h1 hdr Header for 1st file
-h2 jdr Header for 2nd file
For example: -hmMerge_Result sets the header up as "Merge_Result"
-h -help display this Help message
-is subs ignore SubFolders(separated by ";"s) (* Wildcard supported)
For Example: -isclasses;images;.*
-isd Show Ignored Differences
-isyml ignore Symbolic Links
-if fils ignore Files(separated by ";"s) (* Wildcard supported)
For Example: -ifGuiffy.jar;.#*
-iafe fils ignore All Files Except (separated by ";"s) (* Wildcard supported)
For Example: -iafeGuiffy*;Jiff*
-it typs ignore FileTypes(separated by ";"s)
For Example: -it.jar;.zip
-iate typs ignore All FileTypes Except(separated by ";"s)
For Example: -iate.java;.html
-id ignore modified Date and time (folder compares)
-iz ignore file Size (folder compares)
-j -jiffy minimize blocks changed diff
-k ignore blanK lines(inserted or deleted)
-l -linenos don't show Line Numbers
-m -merge Merge
-moc -mocvs fn Merge, Open CVS "conflict" file
For example: -mocD:\build\About.java
-mos -mosmf fn Merge, Open Saved Merge file
For example: -mosD:\build\About.java
-nom -nomats FolderCompare Show NO matching files
-noa -noadds FolderCompare Show NO files added
-nod -nodels FolderCompare Show NO files deleted
-noc -nochgs FolderCompare Show NO files changed
-of -off Auto Save Settings Off
-op -onprompt Auto Save Settings On with Prompt
-oq -onquiet Auto Save Settings On Quietly(no Prompt)
-pr Promote merge
-pm pre Prefix for Merge Filename header
-p1 pre Prefix for 1st Filename header
-p2 pre Prefix for 2nd Filename header
For example: -pmMerge sets the header up as "[Merge]filename"
-q RE -ql RE Quietly ignore changed, inserted, or deleted lines matching regular expression RE
ie. -ql^[:blank:]*//.*$
-qp RE Quietly ignore parts of lines matching regular expression RE
ie. -qp//.*$
-qb RE Quietly ignore blocks of lines matching regular expression RE
ie. -qb/\*.*?\*/
Upto 6 -q options are accumulated
-r -recursive Show SubFolders (Recursively)
-ra -rarchive Show Archive Filetypes (Recursively)
-rep Replace files without confirm or backup
-repcon Replace files with confirm dialog
-repbak Replace files with backup saved
-repjou Replace files with journal backup saved
-s -sure SureMerge(3-Way)
-shr Merge AutoShift to [R]
-shn Merge AutoShift to [N]
-t -text yy show differences within yy lines of conText
yy defaults to 10, ie. -t8 or -text12
-tw -textwhen kkkk show differences within conText
When files are > kkkkKB in size, defaults to 400
-tw200 or -textwhen800
-u ignore User's SavedSettings
Note: should be first option
-use fn Use Saved Settings from the file specified
Note: should be first option
For example: -useC:\build\MySettings.wwr Loads the Saved Settings from "C:\build\MySettings.wwr"
-vt View compare Together
-vv View compare split Vertical
-vh View compare split Horizontal
-vb View display toolBar OFF
-vd View display eDit Bar OFF
-vo View display Options Bar OFF
-vy View display stYle Bar OFF
-vw View display vieWs Bar OFF
-ve View display ComparEdit Bar OFF
-vn View display Navigation Bar OFF
-vm View display Memory Meter ON
-vr View display meRge Bar OFF
Ignored beginning in 11.0 release,
Merge toolbar removed
-w -white ignore all White space differences
-wl ignore Leading White space differences
-we ignore Embedded White space differences
-wt ignore Trailing White space differences
-wn ignore EOL White space differences
-x nn eXpand attention focus by nn lines
For Example: -x2 eXpands attention focus by 2 lines

Exit codes (When command line file/folder names specified):
0 OK, Successful
1 Can't find 1st file/folder
2 Can't find 2nd file/folder
3 Can't find Parent file
4 Can't read 1st file/folder
5 Can't read 2nd file/folder
6 Can't read Parent file
7 Can't write Merge Result file
8 1st file is a folder, with 2nd file
9 2nd file is a folder, with 1st file
10 Parent file is a folder
11 Result file is a folder
12 Can't write Auto file
13 Auto file is a folder
14 Can't find CVS file
15 Can't find Saved Merge file
16 Can't read CVS file
17 Can't read Saved Merge file
18 CVS file is a folder
19 Saved Merge file is a folder
20 Encoding not available
21 Unexpected Exception
22 Evaluation period expired
23 Not allowed, requires eXpert license
24 Invalid option
25 Missing file parameter
100 One or more unresolved Attentions in Merge result
101 Merge result not saved

Documentation by Guiffy Software, Inc. 2024