Eskil

src/TAGS: $(SRCFILES)
	etags -o src/TAGS --regex="/proc[ \t]+\([^ \t]+\)/\1/" $(SRCFILES) \
	eskil.vfs/lib/*/*.tcl

setup: links src/TAGS

# Use this to rebuild the docs when command line changes or
# new wiki files are added.
docs:
	echo "<title>Usage</title>\n" > htdocs/usage.wiki
	echo "<h1>Command Line Usage</h1>\n" >> htdocs/usage.wiki
	echo "<verbatim>" >> htdocs/usage.wiki
	$(TCLKIT_LINUX) eskil.vfs/main.tcl -help >> htdocs/usage.wiki
	echo "</verbatim>" >> htdocs/usage.wiki
	echo "<title>Documentation</title>\n" > htdocs/toc.wiki
	grep title htdocs/*.wiki | grep -v Documentation | \
	sed -e 's/htdocs/[./' -e 's/:<title>/|/' -e 's,</title>,],' | \
	awk '{print $0; print ""};' >> htdocs/toc.wiki
#----------------------------------------------------------------
# Testing
#----------------------------------------------------------------

The status bar show basic info about the selected difference. A conflict
is marked with ***. Hover over the status line to get more info.

When saving, if no output file has been previously been selected, you get the
choise to overwrite either side or browse for another file.

The following command line parameters are merge related:

  -a <file> : Ancestor file for threeway merge.

  -o <file> : Output file for merge result.

  -fine     : Use fine grained chunks. Left/right choice is made per line instead of per chunk.

  -conflict : Treat input file as a file with merge conflict markers.

See also [./editmode.wiki|Edit Mode], and [./revision.wiki|Revision Control Support].

[./revision.wiki|Revision Control Support]

[./starkit.wiki|Starkit compare]

[./starpack.wiki|Starpack generation]

[./table.wiki|Table diff]

[./usage.wiki|Usage]

<title>Usage</title>

<h1>Command Line Usage</h1>

<verbatim>
Usage: eskil [options] [files...]
  [options]  See below.
  [files...] Files to be compared

  If no files are given, the program is started anyway and you can select
  files from within. If only one file is given, the program looks for version
  control of the file, and if found, runs in version control mode.
  If directories are given, Eskil starts in directory diff.

  To list all options matching a prefix, run 'eskil --query prefix'.
  In tcsh use this line to get option completion:
  complete eskil 'C/-/`eskil --query -`/'

  Options:
-          : Read patch file from standard input, to allow pipes
-a <v>     : Give ancestor file for three way merge
-b         : Ignore space changes (default)
-block     : Full block analysis. This can be slow if there are large change
             blocks
-browse    : Automatically bring up file dialog after starting
-char      : Character based change view (default)
-clip      : Start in clip diff mode. Ignores other args
-close     : Close windows with no changes
-conflict  : Treat file as a merge conflict file and enter merge mode
-context <v> : Show only differences, with <n> lines of context
-cvs       : Detect CVS first, if multiple version systems are used
-debug     : Start in debug mode
-dir       : Start in directory diff mode. Ignores other args
-excludedir <v> : Exclude from directory diff
-excludefile <v> : Exclude from directory diff
-fine      : Use fine grained chunks. Useful for merging
-foreach   : Open one diff window per file listed
-fourway   : Start in fourway diff mode. Ignores other args
-gz        : Uncompress input files with gunzip
-i         : Ignore case changes
-limit <v> : Do not process more than <lines> lines
-line      : Line based block analysis
-maxwidth <v> : Limit column width in table mode
-nocase    : Ignore case changes
-nocdiff   : Disable C version of DiffUtil. For debug
-nodiff    : Do not run diff after startup
-nodigit   : Ignore digit changes
-noempty   : Ignore empty lines initially for matching
-noignore  : Don't ignore any whitespace
-nokeyword : In directory diff, ignore $ Keywords: $
-nonewline : Try to ignore newline changes
-nonewline+ : Try to ignore newline changes, and don't display
-noparse   : No block analysis
-o <v>     : Specify merge result output file
-patch     : View patch file
-pivot <v> : Pivot setting for diff algorithm (10)
-plugin <v> : Preprocess files using plugin
-pluginallow : Allow full access privilege for plugin
-plugindump <v> : Dump plugin source to stdout
-plugininfo <v> : Pass info to plugin (plugin specific)
-pluginlist : List known plugins
-prefix <v> : Care mainly about words starting with "str"
-preprocess <v> : TBW <pair>
-preprocessleft <v> : TBW <pair>
-preprocessright <v> : TBW <pair>
-print <v> : Generate PDF and exit.
-printCharsPerLine <v> : Adapt font size for this line length and wrap (80)
-printColorChange <v> : Color for change (1.0 0.7 0.7)
-printColorNew <v> : Color for new text (0.8 0.8 1.0)
-printColorOld <v> : Color for old text (0.7 1.0 0.7)
-printFont <v> : Select font to use in PDF, afm or ttf. If <fontfile> is given
                 as "Courier", PDF built in font is used
-printHeaderSize <v> : Font size for page header (10)
-printPaper <v> : Select paper size (a4)
-r <v>     : Version info for version control mode
-review    : View revision control tree as a patch.
-sep <v>   : See char <c> as separator between columns in files
-server    : Set up Eskil to be controllable from the outside
-smallblock : Do block analysis on small blocks (default)
-svn       : Detect SVN first, if multiple version systems are used
-table     : Run in table mode
-w         : Ignore all spaces
-word      : Word based change view
</verbatim>