Settings Help
CTAN
Comprehensive TeX Archive Network
Home Upload Browse

Direc­tory tex-archive/support/latexdiff

INTRODUCTION

latexdiff is a Perl script, which compares two latex files and marks
up significant differences between them (i.e. a diff for latex files).
  Various options are available for visual markup using standard latex 
packages such as "color.sty". Changes not directly affecting visible 
text, for example in formatting commands, are still marked in 
the latex source.
 
A rudimentary revision facilility is provided by another Perl script,
latexrevise, which accepts or rejects all changes.  Manual
editing of the difference file can be used to override this default
behaviour and accept or reject selected changes only.  

The author is F Tilmann (ftilmann@users.berlios.de). 

Project webpage:   http://latexdiff.berlios.de/
CTAN page:          http://www.ctan.org/tex-archive/support/latexdiff


REQUIREMENTS

Perl 5.8 or higher must be installed.
  The latexdiff script makes use of the Perl package Algorithm::Diff (available 
from www.cpan.org, current version 1.19). You can either install this package, or
use the standalone version of latexdiff, latexdiff-so, which has version 1.15 of 
this package inlined and does not require external installation of
the package. Because latexdiff uses internal functions of Algorithm:Diff whose 
calling format or availability can change without notice, the preferred method is
now to use the standalone version.

As an alternative, latexdiff-fast has a modified version of Algorithm::Diff inlined,
which internally uses the UNIX diff command.  This version is much faster but is dependent
on an external "diff" command.  Subtle differences in the algorithm of Algorithm::Diff and 
UNIX-diff mean that the resulting set of differences will generally not be the same as
for the standard latexdiff.  In most practical cases, these differences are minor, though.

INSTALLATION UNIX/LINUX

The basic installation procedure is almost trivial:

1. Copy latexdiff, latexrevise and latexdiff-vc into a directory which
   is in the search path and make them executable.  If the Algorithm::Diff
   package is not installed, use latexdiff-so instead of latexdiff. 

2. Copy latexdiff.1 and latexrevise.1 into the correct man directory

3. Optionally create soft links latexdiff-cvs latexdiff-rcs, and
   latexdiff-svn for latexdiff-vc.

The attached Makefile contains example commands to carry out above 
steps as root for a typical UNIX installation. Type 

  make install          (for the stand alone version)
or
  make install-ext      (for the version using the external Algorithm::Diff)
or
  make install-fast     (for the version using the UNIX 'diff' function for fast differencing)

to get it rolling.  You can type

  make test
or
  make test-ext
or
  make test-fast

to test the respective versions on a brief example before installation


DOCUMENTATION:

Usage instructions are in the manual latexdiff-man.pdf as well as the 
man pages.

CHANGELOGS:

Check out the comment lines at the beginning of the perl scripts (latexdiff, latexdiff-vc, latexrevise)

CONTRIBUTIONS

The directory contrib contains code written by others relating to latexdiff.  
Currently this directory contains:

latexdiff-wrap (Author: V. Kuhlmann) An alternative wrapper script which can be used
  instead of latexdiff-vc.  Its main use is as a template for customised wrapper scripts.

latexdiff.spec (Author: T. Doerges) spec file for RPM generation

latexchanges (Author: Jan-Ake Larsson) Wrapper script for applying latexdiff with numbered documen version 
(see contrib/README.latexchanges for a more detailed description)

Cntributions by the following authors were incorporated into the latexdiff code, or inspired me to 
extend latexdiff in a similar way: J. Paisley, N. Becker, K. Huebner

LICENSE (also see file COPYING)

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License Version 3 as published by
the Free Software Foundation.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details (file LICENSE in the
distribution).

Direc­to­ries

Name Notes
doc
example

Files

Name Size Date Notes
COPYING 32474 2013-06-10 10:50:05
README 4212 2013-06-10 10:50:05
latexdiff 132035 2013-06-10 10:50:04
latexdiff-fast 148240 2013-06-10 10:50:04
latexdiff-so 143851 2013-06-10 10:50:04
latexdiff-vc 15540 2013-06-10 10:50:04
latexdiff-vc.1 9261 2013-06-10 10:50:04
latexdiff.1 37467 2013-06-10 10:50:04
latexrevise 19895 2013-06-10 10:50:04
latexrevise.1 9230 2013-06-10 10:50:04

Down­load the com­plete con­tents of this di­rec­tory in one zip archive (424.1k).

la­texd­iff – Deter­mine and mark up sig­nif­i­cant dif­fer­ences be­tween la­tex files

La­texd­iff is a Perl script for vi­sual mark up and re­vi­sion of sig­nif­i­cant dif­fer­ences be­tween two la­tex files. Var­i­ous op­tions are avail­able for vi­sual markup us­ing stan­dard la­tex pack­ages such as color. Changes not di­rectly af­fect­ing vis­i­ble text, for ex­am­ple in for­mat­ting com­mands, are still marked in the la­tex source. A rudi­men­tary re­vi­sion fa­cilil­ity is pro­vided by an­other Perl script, la­texre­vise, which ac­cepts or re­jects all changes. Man­ual edit­ing of the dif­fer­ence file can be used to over­ride this de­fault be­haviour and ac­cept or re­ject se­lected changes only.

Doc­u­men­ta­tion
Home pagehttp://la­texd­iff.berlios.de
Ver­sion1.0.3
Li­censeGNU Gen­eral Public Li­cense
Copy­right2004-2012 F J Til­mann
Main­tainerFred­erik Til­mann
Con­tained inTeXLive as la­texd­iff
MiKTeX as la­texd­iff
Topics sup­port for keep­ing track of doc­u­ment de­vel­op­ment
Guest Book Sitemap Contact 2014-04-20 10:21 CEST