TWDIFF

Section: TextWrangler Command Line Reference (1)
Updated: Bare Bones Software
Index Return to Main Contents
 

NAME

twdiff - find file differences with TextWrangler.  

SYNOPSIS

twdiff [ --<options> ] [ FILE1 FILE2 | FOLDER1 FOLDER2 ]  

DESCRIPTION

The twdiff tool is a simple utility that allows you to specify two files, or folders, for comparison via TextWrangler's Find Differences command. Type 'twdiff' followed by two file or folder names to invoke Find Differences on those items.

TextWrangler is a freeware text editor from Bare Bones Software.  

OPTIONS

The twdiff tool accepts only long form switches (options preceded by two dashes). The options offered by the twdiff tool mirror the settings available in the Find Differences dialog.

Use ``--'' to end switch parsing. For example, to find differences between a file named ``-a'' and a file named ``-z'', use:

        twdiff -- -a -z

--case-sensitive
Equivalent to the ``Case Sensitive'' option in the dialog. If you use this option, the comparison will be performed with case sensitivity on.
--flatten-folders
Equivalent to the ``Flatten Hierarchies'' option in the dialog. If you use this option, TextWrangler considers the files in the folders as a single flat list, allowing a file in one folder to match a file of the same name in the other folder, regardless of whether they are in the same subfolder in both hierarchies.
--help
Display a basic help line with a summary of the available options.
--ignore-curly-quotes
Equivalent to the ``Ignore Curly Quotes'' option in the dialog. If you use this option, straight quotes and curly (typographer's) quotes will be considered identical for purposes of comparison.
--ignore-extra-spaces
Equivalent to the ``Ignore Spaces: Runs'' option in the dialog. If you use this option, whitespace runs of any length will be considered identical for purposes of comparison.
--ignore-leading-spaces
Equivalent to the ``Ignore Spaces: Leading'' option in the dialog. If you use this option, whitespace runs of any length at the beginning of a line will be considered identical for purposes of comparison.
--ignore-trailing-spaces
Equivalent to the ``Ignore Spaces: Leading'' option in the dialog. If you use this option, whitespace runs of any length at the end of a line will be considered identical for purposes of comparison.
--resume
Used in combination with --wait, this switch will cause the application which was frontmost when the twdiff tool was invoked to be made frontmost again once you close the files specified on the command line.
--short-version
Display the short-form version number of the twdiff command line tool.
--show-identical-files
Equivalent to the ``List Identical Files'' option in the dialog (for folder comparisons). If you use this option, TextWrangler will list all common files in the compared folders regardless of their differences state. Otherwise, TextWrangler will list only files for which there are changes (paired files having differences) in the set of items that appear in both folders.
--skip-shielded-folders
Equivalent to the ``Skip (...) Folders'' option in the dialog (for folder comparisons). If you use this option, TextWrangler will ignore all files contained in folders whose names are enclosed in parentheses when performing the comparison.
--text-files-only
Equivalent to the ``Only List Text Files'' option in the dialog (for folder comparisons). If you use this option, TextWrangler will compare only files which it considers to be text files when performing the comparison. Otherwise, TextWrangler will compare all files present in the chosen folders.

TextWrangler will consider a file to be a text file if it has a type of ``TEXT'' (or other well-known text type), or, if the file is typeless, according to the option chosen for ``If a File's Type is Unknown'' in the Text Files: Opening panel of the Preferences window.

--version
Display the current version number of the twdiff command line tool and the TextWrangler application.
--wait
Wait until the file is closed in TextWrangler. Normally, the twdiff tool exits immediately after the specified files or folders are opened in TextWrangler. The --wait switch allows the twdiff tool to be used as an external differences engine for Unix tools that support such an option, by not returning back to the calling tool in the Terminal until the editing session is over.
 

AUTHORS

 Bare Bones Software, Inc.
 Web site: http://www.barebones.com/
 Email: support@barebones.com


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
AUTHORS

This document was created by man2html, using the manual pages.
Time: 13:02:05 GMT, February 10, 2023