<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE refentry 
  PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="cut-diff">
<refmeta>
  <refentrytitle role="top_of_page" id="cut-diff.top_of_page">cut-diff</refentrytitle>
  <refmiscinfo>CUTTER Library</refmiscinfo>
</refmeta>
<refnamediv>
  <refname>cut-diff</refname>
  <refpurpose>show difference between 2 files with color</refpurpose>
</refnamediv>
<refsect1>
  <title>NAME</title>
  <para>cut-diff - show difference between 2 files with color</para>
</refsect1>

<refsect1>
  <title>SYNOPSIS</title>
  <para>
  <code>cut-diff</code>
   [
  <emphasis>option ...</emphasis>
  ] 
  <emphasis>file1</emphasis>
   
  <emphasis>file2</emphasis>
  
</para>
</refsect1>

<refsect1>
  <title>DESCRIPTION</title>
  <para>cut-diff is a diff command that uses diff feature in Cutter. It shows difference with color.</para>
  <para>It's recommended that you use a normal diff(1) when you want to use with patch(1) or you don't need color.</para>
</refsect1>

<refsect1>
  <title>OPTIONS</title>
  <variablelist>
  <varlistentry>
  <term id="cut-diff.--version">--version</term>
  <listitem>
  <para>cut-diff shows its own version and exits.</para>
</listitem>
</varlistentry>
  <varlistentry>
  <term id="cut-diff.-c">-c [yes|true|no|false|auto], --color=[yes|true|no|false|auto]</term>
  <listitem>
  <para>If 'yes' or 'true' is specified, cut-diff uses colorized output by escape sequence. If 'no' or 'false' is specified, cut-diff never use colorized output. If 'auto' or the option is omitted, cut-diff uses colorized output if available.</para>
  <para>The default is auto.</para>
</listitem>
</varlistentry>
  <varlistentry>
  <term id="cut-diff.-u">-u, --unified</term>
  <listitem>
  <para>cut-diff uses unified diff format.</para>
</listitem>
</varlistentry>
  <varlistentry>
  <term id="cut-diff.--context-lines">--context-lines=LINES</term>
  <listitem>
  <para>
  Shows diff context around 
  <code>LINES</code>
  .
</para>
  <para>All lines are shown by default. When unified diff format is used, 3 lines are shown by default.</para>
</listitem>
</varlistentry>
  <varlistentry>
  <term id="cut-diff.--label">--label=LABEL, -L=LABEL</term>
  <listitem>
  <para>
  Uses 
  <code>LABEL</code>
   as a header label. The first
  <emphasis>--label</emphasis>
   option value is used as 
  <emphasis>file1</emphasis>
  's label and the second 
  <emphasis>--label</emphasis>
   option value is used as
  <emphasis>file2</emphasis>
  's label.
</para>
  <para>Labels are the same as file names by default.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
  <title>EXIT STATUS</title>
  <para>The exit status is 0 for success, non-0 otherwise.</para>
  <para>TODO: 0 for non-difference, 1 for difference and non-0 for errors.</para>
</refsect1>

<refsect1>
  <title>EXAMPLE</title>
  <para>
  In the following example, cut-diff shows difference between 
  <code>file1</code>
   and 
  <code>file2</code>
  :
</para>
  <programlisting>% cut-diff file1 file2</programlisting>
  <para>
  In the following example, cut-diff shows difference between 
  <code>file1</code>
   and 
  <code>file2</code>
   with unified diff format:
</para>
  <programlisting>% cut-diff -u file1 file2</programlisting>
</refsect1>

<refsect1>
  <title>SEE ALSO</title>
  <para>diff(1)</para>
</refsect1>
</refentry>
