From 06afe168b20654ae55d880b2860455d814cb44dd Mon Sep 17 00:00:00 2001 From: "daewon.lee@interdigital.com" Date: Mon, 15 Dec 2025 11:57:21 -0500 Subject: [PATCH] Minor updates to align formatting with MS Wrod. Including perl scripts that allow diff view. --- 38202-j00.docx | Bin 1068306 -> 1069263 bytes 38202.tex | 46 +- 3gpp.sty | 20 +- scripts/latexdiff-fast.pl | 6031 +++++++++++++++++++++++++++++++++++++ scripts/latexdiff-so.pl | 5927 ++++++++++++++++++++++++++++++++++++ scripts/latexdiff-vc.pl | 913 ++++++ scripts/latexdiff.pl | 5470 +++++++++++++++++++++++++++++++++ scripts/latexrevise.pl | 584 ++++ 8 files changed, 18959 insertions(+), 32 deletions(-) create mode 100644 scripts/latexdiff-fast.pl create mode 100644 scripts/latexdiff-so.pl create mode 100644 scripts/latexdiff-vc.pl create mode 100644 scripts/latexdiff.pl create mode 100644 scripts/latexrevise.pl diff --git a/38202-j00.docx b/38202-j00.docx index be8ca8bdf709572a6da0756e31339e6b0c47ae18..4073387e810cc2b9e8279ea590b4188447f76129 100644 GIT binary patch delta 59717 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ⅆF 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. +# +# Detailed usage information at the end of the file +# +# +# Note references to issue numbers are for the github repository of latexdiff: https://github.com/ftilmann/latexdiff +# +# Version 1.3.4: +# New features: +# - Option to use lua-ul instead of ulem (for use with LuaLaTeX) (fix #17, #60, #188, #255, #270) +# Enhancement +# - If amsmath is detected as one of the included (based on idea in PR #263 contributed by github user xlucn +# Bug fix +# - sometimes the introduction of aux commands to show deleted lists or descriptions leaves in place empty auxiliary +# list environments, which would cause error messages (though skipping messages would result in a correct output pdf). +# These are now removed. +# - add more mboxsafecmd and safecmd commands for SIunitx to stay compatible with newer versionsof SIunitx (PR #283, fixing issue #282, contributed by github user joe6302413) +# - File added via --preamble option is no longer assumed to be ASCII, but read either with encoding as defined by --encoding option or using the encoding of the LOCALE (fixes issue #285 ) +# - multicolumn argument is now treated as text +# - when tikz-dependency package is used, \& is no longer a safe command as it has special meaning inside dependency environment. The fix is a little of a hack as really it should only be considered unsafe within dependency environment (fixes (mostly) issue #303 ) +# - listings package had trouble with non-ASCII chars. The encoding is now set (thanks to github user anka-213 for finding this). Fixes #304 +# +# Version 1.3.3: +# New features: +# - Option --no-del to remove all deleted text (merge contributed by github user tdegeus PR #252, fixing issue #66 +# +# Bug fixes: +# - Abbreviations involving punctuations within them. They need special treatment because otherwise in some +# circumstances the gnoring of white space differences in conjunction with merging according to MINWORDSBLOCK rule +# could turn 'i.e.' into 'i.\PAR e.' (see https://github.com/ftilmann/latexdiff/issues/269). A few abbreviations +# are now hard-coded and treated as atomic: +# English: i.e., e.g. Deutsch: z.B. +# (fixes issue #269) +# - In WHOLE and COARSE math modes, now properly treat math environments with arguments such as \alignat. Fixes #251 +# - For FINE math mode, multiple improvments to the processing work flow yield more robust outcomes. In particular, changes +# to the equation type, e.g. \begin{displaymath} -> \begin{equation} without modifications now usually no longer result +# in errors. (Partially) fixes issues #235 and #244. +# - When encountering deleted math array environments such as align or eqnarray, rather than replacing them with a +# fixed replacement environment (e.g. align* or eqnarray*), an asterisk is now added to the original command, which +# in amsmath (and with eqnarray) will result in the same environment but without line numbers. Config variable MATHARRREPL +# is therefore (nearly) redundant, and a depracation warning is given when it is set. Reference to MATHARRREPL are have +# been removed from the manual (there is one exception, when it's still being used: sometimes latexdiff can figure out +# that there is a deleted array environment, but does not know which one. In this case, MATHARRREPL is still being used +# to encapsulate these parts of the source, and therefore it is still set internally. But this is a quite rare situation). +# Fixes issue #216 +# - Unlike 'array' environment, 'split' (amsmath) does not work in argument of \DIFadd or \DIFdl in UNDERLINE modes; therefore remove it from ARRENV configuration variable. +# Exclude \begin and \end in math environments in COARSE and WHOLE modes. Fixes #258. Fixes #109 +# - --flatten now works for empty files. Fixes issue #242 +# - improved processing of Chinese and Japanese texts in that splitting is done based on characters. Thanks to LuXu (Oliver Lew) in git for working this out. Fixes #229, fixes #145 + + + +# Version 1.3.2 +# API adaptions: +# - latexdiff now completes with exit code 0 after --help or --version command (see issue #248) +# New features / feature extensions +# - extend CUSTOMDIFCMD related postprocessing to deal properly with multiline commands, or a sequence of several commands in the same line (see github issue #204) +# - Support for additional macros from import package (\import, \inputfrom, \includefrom, \subimport,\subinputfrom, \subincludefrom). Provided by janniklasrose in PR #243 (fixes #239) +# - replace default driver dvips->pdftex +# Bug fixes: +# - fix issue #206 affecting proper markup of text commands which are not also safe cmd's and have multiple arguments +# - fix issue #210 by adding \eqref (amsmath package) to the list of safe commands +# - fix bug reported in issue #168 mangled verbatim line environment +# - fix bug reported in issue #218 by replacing \hspace{0pt} after \mbox{..} auxiliary commands with \hskip0pt. +# - more ways to process \frac correctly with atomic arguments (committed by julianuu PR #246 +# - fix a bug in biblatex mode, which prevented proper processing of modified \textcite (see: https://tex.stackexchange.com/questions/555157/latexdiff-and-biblatex-citation-commands) +# - -h string fix: add -driver option +# +# Version 1.3.1.1 +# - remove spurious \n to fix error: Unknown regexp modifier "/n" at .../latexdiff line 1974, near "=~ " (see github issue #201) +# +# Version 1.3.1 +# Bug fixes: +# - remove some uninitialised variable $2 warnings in string substitution in flatten function in case included file is not found +# - add minimal postprocessing to diff processing of preamble commands (replace \RIGHTBRACE by \} ) +# - pre-processing: replace (contributed) routine take_comments_and_enter_from_frac() with take_comments_and_newline_from_frac(), which does the same thing +# (remove whitespace characters and comments between the argument of \frac commands) in an easier and more robust way. In addition, it +# will replace commands like \frac12 with \frac{1}{2} as pre-processing step. Fixes issue #184 +# - add "intertext" to list of unsafe math commands @UNSAFEMATHCMD . Fixes issue #179 +# - provide citation command patterns for biblatex and protect them with mbox'es. Fixes issue #199 +# - hardcode number of parameters for \href and \url commands to allow spaces between commands and arguments even if --allow-spaces option is not used (this +# is needed because some bibliography styles add such in-command-sequence spaces) Fixes issues: #178 #198 +# - bibitem is now kept even in deleted blocks such that deleted references show up properly (this implies that the actual numbers in numerical referencing schemes will change) +# (this is implemented by introducing a new class of commands KEEPCMD , which are kept as is in deleted environments (no effect in added environments). Currently +# \bibitem is hardwired to be the only member of this class (fixes issue #194, #174) +# Features: +# - add some special processing for revtex bibliography commands, so that the spaces between bibliography commands \bibfield and \bibinfo and their arguments are ignored. +# (fixes issue #194, should fix #174) +# +# Version 1.3.0 (7 October 2018): +# - treat options to \documentclass as potential package names (some packages allow implicit loading of or imply selected packages +# - improved pattern matching: now allows nested angular brackets, and is no longer confused by escaped curly braces +# - improved pattern matching in COARSE mode: occasionally, the closing bracket or some other elements would be matched in an 'unnatural' way due to another sequence being more minimal in the computational sense, sometimes even causing errors due to tokens moving in or out of the scope of math environments. This is now discouraged by adding internal \DIFANCHOR commands (which are removed again in post-processing) (fixes issues reported via email by li_ruomeng . +# - verbatim and lstlisting environments are marked-up with line-by-line in a similar style to non-verbatim text (requires the listing package to be installed) +# (see new configuration variable VERBATIMLINEENV) (several issues and pull requests by jprotze) +# - --flatten: now supports \verbatiminput and \lstlistinput +# - --flatten: if file is not found, do not fail, simply warn and leave command unexpanded (inspired by issue #112). Don't warn if file name contains #[0-9] as it is then most likely an argument within a command definition rather than an actual file (applies to \input, \subfile, \include commands) +# - added to textcmds: \intertext +# - new config variable CUSTOMDIFCMD to allow defining special versions of commands in added or deleted blocks (Pull request by github user jprotze) +# - added option -no-links (mostly for use by latexdiff-vc in only-changes modes) (Pull request by github user jprotze) +# - new option --filter-script to run both input through a pre-processing script (PR jasonmccsmith #167) +# new option --no-filter-stderr to hide stderr output from filter-script (potentially dangerous, as this might hide malfunctioning of filter scripts) +# - --flatten now can deal with imports made using the import package {PR jasonmccsmith #173) +# Bug fixes: +# - pattern matching of \verb and \lstinline commands had an error which meant they would trigger on commands beginning with \verb. +# - In description environments, mark up item descriptions by effectively reating the insides of item commannds as text commands (fixes #161) +# +# +# Version 1.2.1 (22 June 2017) +# - add "DeclareOldFontCommand" to styles using \bf or \sf old style font commands (fixies issue #92 ) +# - improved markup: process lstinline commands in listings package correctly +# for styles using colour, \verb and \lstinline arguments are marked up with colour (blue for added, red for deleted) +# - bug fix: protecting inline math expressions for mbox did not work as intended (see stack exchange question: http://tex.stackexchange.com/questions/359412/compiling-the-latexdiff-when-adding-a-subscript-before-a-pmatrix-environment-cau) +# - bug fix: when deleted \item commands are followed immediately by unsafe commands, they were not restored properly +# (thanks to J. Protze for pull request) (pull request #89) +# - treat lstlisting and comment as equivalent to verbatim environment +# make environments that are treated like verbatim environments configurable (config variable VERBATIMENV) +# treat lstinlne as equivalent to verb command +# partially addresses issue #38 +# - refactoring: set default configuration variables in a hash, and those that correspond to lists +# - feature: option --add-to-config used to amend configuration variables, which are regex pattern lists +# - bug fix: deleted figures when endfloat package is activated +# - bug fix: alignat environment now always processed correctly (fix issues #65) +# - bug fix: avoid processing of commands as potential files in routine init_regex_arr (fix issue #70 ) +# - minimal feature enhancement: treat '@' as allowed character in commands (strictly speaking requires prior \makeatletter statement, but always assuming it to be +# @ a letter if it is part of a command name will usually lead to the correct behaviour (see http://tex.stackexchange.com/questions/346651/latexdiff-and-let) +# - new feature/bug fix: --flatten option \endinput in included files now respected but only if \endinput stands right at the beginning of the line (issue #77) +# - bug fix: flatten would incorrectly attempt to process commented out \include commands (from discussion in issue #77 ) +# - introduce an invisible space (\hspace{0pt} after \mbox{..} auxiliary commands (not in math mode), to allow line breaks between added and deleted citations (change should not cause adverse behaviour otherwise) +# +# Version 1.2.0: +# - highlight new and deleted figures +# - bug fix in title mark-up. Previously deleted commands in title (such as \title, \author or \date) were marked up erroneously +# - (minor) bug fixes in new 1.1.1 features: disabled label was commented out twice, additional spaces were introduced before list environment begin and end commands +# - depracation fix: left brace in RegEx now needs to be escaped +# - add type PDFCOMMENT based on issue #49 submitted by github user peci1 (Martin Pecka) +# - make utf8 the default encoding +# +# Version 1.1.1 +# - patch mhchem: allow ce in equations +# - flatten now also expands \input etc. in the preamble (but not \usepackage!) +# - Better support for Japanese ( contributed by github user kshramt ) +# - prevent duplicated verbatim hashes (patch contributed by github user therussianjig, issue #36) +# - disable deleted label commands (fixes issue #31) +# - introduce post-processing to reinstate most deleted environments and all needed item commands (fixes issue #1) +# +# Version 1.1.0 +# - treat diacritics (\",\', etc) as safe commands +# - treat \_ and \& correctly as safe commands, even if used without spacing to the next word +# - Add a BOLD markup type that sets added text in bold face (Contribution by Victor Zabalza via pull request ) +# - add append-mboxsafecmd list option to be able to specify special safe commands which need to be surrounded by mbox to avoid breaking (mostly this is needed with ulem package) +# - support for siunitx and cleveref packages: protect \SI command in siunitx package and \cref,\Cref{range}{*} in cleveref packages (thanks to Stefan Pinnow for testing) +# - experimental support for chemformula, mhchem packages: define \ch and \ce in packages as safe (but not \ch,\cee in equation array environments) - these unfortunately will not be marked up (thanks to Stefan Pinnow for testing) +# - bug fix: packages identified correctly even if \usepackage command options extend over several lines (previously \usepackage command needed to be fully contained in one line) +# - new subtype ONLYCHANGEDPAGE outputs only changed pages (might not work well for floating material) +# - new subtype ZLABEL operates similarly to LABEL but uses absolute page numbers (needs zref package) +# - undocumented option --debug/--nodebug to override default setting for debug mode (Default: 0 for release version, 1: for development version +# +# Version 1.0.4 +# - introduce list UNSAFEMATHCMD, which holds list of commands which cannot be marked up with \DIFadd or \DIFdel commands (only relevant for WHOLE and COARSE math markup modes) +# - new subtype LABEL which gives each change a label. This can later be used to only display pages where changes +# have been made (instructions for that are put as comments into the diff'ed file) inspired by answer on http://tex.stackexchange.com/questions/166049/invisible-markers-in-pdfs-using-pdflatex +# - Configuration variables take into accout some commands from additional packages: +# tikzpicture environment now treated as PICTUREENV, and \smallmatrix in ARRENV (amsmath) +# - --flatten: support for \subfile command (subfiles package) (in response to http://tex.stackexchange.com/questions/167620/latexdiff-with-subfiles ) +# - --flatten: \bibliography commands expand if corresponding bbl file present +# - angled bracket optional commands now parsed correctly (patch #3570) submitted by Dave Kleinschmidt (thanks) +# - \RequirePackage now treated as synonym of \usepackage with respect to setting packages +# - special rules for apacite package (redefine citation commands) +# - recognise /dev/null as 'file-like' arguments for --preamble and --config options +# - fix units package incompatibility with ulem for text maths statements $ ..$ (thanks to Stuart Prescott for reporting this) +# - amsmath environment cases treated correctly (Bug fix #19029) (thanks to Jalar) +# - {,} in comments no longer confuse latexdiff (Bug fix #19146) +# - \% in one-letter sub/Superscripts was not converted correctly +# +# Version 1.0.3 +# - fix bug in add_safe_commands that made latexdiff hang on DeclareMathOperator +# command in preamble +# - \(..\) inline math expressions were not parsed correctly, if they contained a linebreak +# - applied patch contributed by tomflannaghan via Berlios: [ Patch #3431 ] Adds correct handling of \left< and \right> +# - \$ is treated correctly as a literal dollar sign (thanks to Reed Cartwright and Joshua Miller for reporting this bug +# and sketching out the solution) +# - \^ and \_ are correctly interpreted as accent and underlined space, respectively, not as superscript of subscript +# (thanks to Wail Yahyaoui for pointing out this bug) +# +# Version 1.0.1 - treat \big,\bigg etc. equivalently to \left and +# \right - include starred version in MATHENV - apply +# - flatten recursively and --flatten expansion is now +# aware of comments (thanks to Tim Connors for patch) +# - Change to post-processing for more reliability for +# deleted math environments +# - On linux systems, recognise and remove DOS style newlines +# - Provide markup for some special preamble commands (\title, +# \author,\date, +# - configurable by setting context2cmd +# - for styles using ulem package, remove \emph and \text.. from list of +# safe commands in order to allow linebreaks within the +# highlighted sections. +# - for ulem style, now show citations by enclosing them in \mbox commands. +# This unfortunately implies linebreaks within citations no longer function, +# so this functionality can be turned off (Option --disable-citation-markup). +# With --enable-citation-markup, the mbox markup is forced for other styles) +# - new substyle COLOR. This is particularly useful for marking up citations +# and some special post-processing is implemented to retain cite +# commands in deleted blocks. +# - four different levels of math-markup +# - Option --driver for choosing driver for modes employing changebar package +# - accept \\* as valid command (and other commands of form \.*). Also accept +# \ (backslashed newline) +# - some typo fixes, include commands defined in preamble as safe commands +# (Sebastian Gouezel) +# - include compared filenames as comments as line 2 and 3 of +# the preamble (can be modified with option --label, and suppressed with +# --no-label), option --visible-label to show files in generated pdf or dvi +# at the beginning of main document +# +# Version 0.5 A number of minor improvements based on feedback +# Deleted blocks are now shown before added blocks +# Package specific processing +# +# Version 0.43 unreleased typo in list of styles at the end +# Add protect to all \cbstart, \cbend commands +# More robust substitution of deleted math commands +# +# Version 0.42 November 06 Bug fixes only +# +# Version 0.4 March 06 option for fast differencing using UNIX diff command, several minor bug fixes (\par bug, improved highlighting of textcmds) +# +# Version 0.3 August 05 improved parsing of displayed math, --allow-spaces +# option, several minor bug fixes +# +# Version 0.25 October 04 Fix bug with deleted equations, add math mode commands to safecmd, add | to allowed interpunctuation signs +# Version 0.2 September 04 extension to utf-8 and variable encodings +# Version 0.1 August 04 First public release + +# Inserted block for differenceing +# use Algorithm::Diff qw(traverse_sequences); +# in standard version +# The following BEGIN block contains a verbatim copy of +# Ned Konz' Algorithm::Diff package version 1.15 except +# that subroutine _longestCommonSubsequence has been replace by +# a routine which internally uses the UNIX diff command for +# the differencing rather than the Perl routines if the +# length of the sequences exceeds some threshold. +# Also, all POD documentation has been stripped out. +# +# (the distribution on which this modification is based is available +# from http://search.cpan.org/~nedkonz/Algorithm-Diff-1.15 +# the most recent version can be found via http://search.cpan.org/search?module=Algorithm::Diff ) +# Please note the LICENCE for Algorithm::Diff : +# "Copyright (c) 2000-2002 Ned Konz. All rights reserved. +# This program is free software; +# you can redistribute it and/or modify it under the same terms +# as Perl itself." +# The fast-differencing version of latexdiff is provided as a convenience +# for latex users under Unix-like systems which have a 'diff' command. +# If you believe +# the inlining of Algorithm::Diff violates its license please contact +# me and I will modify the latexdiff distribution accordingly. +# Frederik Tilmann (tilmann@esc.cam.ac.uk) +# Jonathan Paisley is acknowledged for the idea of using the system diff +# command to achieve shorter running times +BEGIN { +package Algorithm::Diff; +use strict; +use vars qw($VERSION @EXPORT_OK @ISA @EXPORT); +use integer; # see below in _replaceNextLargerWith() for mod to make + # if you don't use this +require Exporter; +@ISA = qw(Exporter); +@EXPORT = qw(); +@EXPORT_OK = qw(LCS diff traverse_sequences traverse_balanced sdiff); +$VERSION = sprintf('%d.%02d fast', (q$Revision: 1.15 $ =~ /\d+/g)); + +# Global parameters + +use File::Temp qw/tempfile/; +# if larger number of elements in longestCommonSubsequence smaller than +# this number, then use internal algorithm, otherwise use UNIX diff +use constant THRESHOLD => 100 ; +# Detect whether diff --minimal option is available +# if yes we use it +use constant MINIMAL => ( system('diff','--minimal','/dev/null','/dev/null') >> 8 ==0 ? "--minimal" : "" ) ; + + + +# McIlroy-Hunt diff algorithm +# Adapted from the Smalltalk code of Mario I. Wolczko, +# by Ned Konz, perl@bike-nomad.com + + +# Create a hash that maps each element of $aCollection to the set of positions +# it occupies in $aCollection, restricted to the elements within the range of +# indexes specified by $start and $end. +# The fourth parameter is a subroutine reference that will be called to +# generate a string to use as a key. +# Additional parameters, if any, will be passed to this subroutine. +# +# my $hashRef = _withPositionsOfInInterval( \@array, $start, $end, $keyGen ); + +sub _withPositionsOfInInterval +{ + my $aCollection = shift; # array ref + my $start = shift; + my $end = shift; + my $keyGen = shift; + my %d; + my $index; + for ( $index = $start ; $index <= $end ; $index++ ) + { + my $element = $aCollection->[$index]; + my $key = &$keyGen( $element, @_ ); + if ( exists( $d{$key} ) ) + { + unshift ( @{ $d{$key} }, $index ); + } + else + { + $d{$key} = [$index]; + } + } + return wantarray ? %d : \%d; +} + +# Find the place at which aValue would normally be inserted into the array. If +# that place is already occupied by aValue, do nothing, and return undef. If +# the place does not exist (i.e., it is off the end of the array), add it to +# the end, otherwise replace the element at that point with aValue. +# It is assumed that the array's values are numeric. +# This is where the bulk (75%) of the time is spent in this module, so try to +# make it fast! + +sub _replaceNextLargerWith +{ + my ( $array, $aValue, $high ) = @_; + $high ||= $#$array; + + # off the end? + if ( $high == -1 || $aValue > $array->[-1] ) + { + push ( @$array, $aValue ); + return $high + 1; + } + + # binary search for insertion point... + my $low = 0; + my $index; + my $found; + while ( $low <= $high ) + { + $index = ( $high + $low ) / 2; + + # $index = int(( $high + $low ) / 2); # without 'use integer' + $found = $array->[$index]; + + if ( $aValue == $found ) + { + return undef; + } + elsif ( $aValue > $found ) + { + $low = $index + 1; + } + else + { + $high = $index - 1; + } + } + + # now insertion point is in $low. + $array->[$low] = $aValue; # overwrite next larger + return $low; +} + +# This method computes the longest common subsequence in $a and $b. + +# Result is array or ref, whose contents is such that +# $a->[ $i ] == $b->[ $result[ $i ] ] +# foreach $i in ( 0 .. $#result ) if $result[ $i ] is defined. + +# An additional argument may be passed; this is a hash or key generating +# function that should return a string that uniquely identifies the given +# element. It should be the case that if the key is the same, the elements +# will compare the same. If this parameter is undef or missing, the key +# will be the element as a string. + +# By default, comparisons will use "eq" and elements will be turned into keys +# using the default stringizing operator '""'. + +# Additional parameters, if any, will be passed to the key generation routine. + +sub _longestCommonSubsequence +{ + my $a = shift; # array ref + my $b = shift; # array ref + my $keyGen = shift; # code ref + my $compare; # code ref + + # set up code refs + # Note that these are optimized. + if ( !defined($keyGen) ) # optimize for strings + { + $keyGen = sub { $_[0] }; + $compare = sub { my ( $a, $b ) = @_; $a eq $b }; + } + else + { + $compare = sub { + my $a = shift; + my $b = shift; + &$keyGen( $a, @_ ) eq &$keyGen( $b, @_ ); + }; + } + + my ( $aStart, $aFinish, $bStart, $bFinish, $matchVector ) = + ( 0, $#$a, 0, $#$b, [] ); + + # Check whether to use internal routine (small number of elements) + # or use it as a wrapper for UNIX diff + if ( ( $#$a > $#$b ? $#$a : $#$b) < THRESHOLD ) { + ### print STDERR "DEBUG: regular longestCommonSubsequence\n"; + # First we prune off any common elements at the beginning + while ( $aStart <= $aFinish + and $bStart <= $bFinish + and &$compare( $a->[$aStart], $b->[$bStart], @_ ) ) + { + $matchVector->[ $aStart++ ] = $bStart++; + } + + # now the end + while ( $aStart <= $aFinish + and $bStart <= $bFinish + and &$compare( $a->[$aFinish], $b->[$bFinish], @_ ) ) + { + $matchVector->[ $aFinish-- ] = $bFinish--; + } + + # Now compute the equivalence classes of positions of elements + my $bMatches = + _withPositionsOfInInterval( $b, $bStart, $bFinish, $keyGen, @_ ); + my $thresh = []; + my $links = []; + + my ( $i, $ai, $j, $k ); + for ( $i = $aStart ; $i <= $aFinish ; $i++ ) + { + $ai = &$keyGen( $a->[$i], @_ ); + if ( exists( $bMatches->{$ai} ) ) + { + $k = 0; + for $j ( @{ $bMatches->{$ai} } ) + { + + # optimization: most of the time this will be true + if ( $k and $thresh->[$k] > $j and $thresh->[ $k - 1 ] < $j ) + { + $thresh->[$k] = $j; + } + else + { + $k = _replaceNextLargerWith( $thresh, $j, $k ); + } + + # oddly, it's faster to always test this (CPU cache?). + if ( defined($k) ) + { + $links->[$k] = + [ ( $k ? $links->[ $k - 1 ] : undef ), $i, $j ]; + } + } + } + } + + if (@$thresh) + { + for ( my $link = $links->[$#$thresh] ; $link ; $link = $link->[0] ) + { + $matchVector->[ $link->[1] ] = $link->[2]; + } + } + } + else { + my ($fha,$fhb,$fna,$fnb,$ele,$key); + my ($alines,$blines,$alb,$alf,$blb,$blf); + my ($minimal)=MINIMAL; + # large number of elements, use system diff + ### print STDERR "DEBUG: fast (diff) longestCommonSubsequence\n"; + + ($fha,$fna)=tempfile("DiffA-XXXX") or die "_longestCommonSubsequence: Cannot open tempfile for sequence A"; + ($fhb,$fnb)=tempfile("DiffB-XXXX") or die "_longestCommonSubsequence: Cannot open tempfile for sequence B"; + # prepare sequence A + foreach $ele ( @$a ) { + $key=&$keyGen( $ele, @_ ); + $key =~ s/\\/\\\\/g ; + $key =~ s/\n/\\n/sg ; + print $fha "$key\n" ; + } + close($fha); + # prepare sequence B + foreach $ele ( @$b ) { + $key=&$keyGen( $ele, @_ ); + $key =~ s/\\/\\\\/g ; + $key =~ s/\n/\\n/sg ; + print $fhb "$key\n" ; + } + close($fhb); + + open(DIFFPIPE, "diff $minimal $fna $fnb |") or die "_longestCommonSubsequence: Cannot launch diff process. $!" ; + # The diff line numbering begins with 1, but Perl subscripts start with 0 + # We follow the diff numbering but substract 1 when assigning to matchVector + $aStart++; $bStart++ ; $aFinish++ ; $bFinish++ ; + while( ) { + if ( ($alines,$blines) = ( m/^(\d*(?:,\d*)?)?c(\d*(?:,\d*)?)?$/ ) ) { + ($alb,$alf)=split(/,/,$alines); + ($blb,$blf)=split(/,/,$blines); + $alf=$alb unless defined($alf); + $blf=$blb unless defined($blf); + while($aStart < $alb ) { + $matchVector->[ -1 + $aStart++ ] = -1 + $bStart++ ; + } + # check for consistency + $bStart==$blb or die "_longestCommonSubsequence: Fatal error in interpreting diff output: Inconsistency in changed sequence"; + $aStart=$alf+1; + $bStart=$blf+1; + } + elsif ( ($alb,$blines) = ( m/^(\d*)a(\d*(?:,\d*)?)$/ ) ) { + ($blb,$blf)=split(/,/,$blines); + $blf=$blb unless defined($blf); + while ( $bStart < $blb ) { + $matchVector->[ -1 + $aStart++ ] = -1 + $bStart++ ; + } + $aStart==$alb+1 or die "_longestCommonSubsequence: Fatal error in interpreting diff output: Inconsistency in appended sequence near elements $aStart and $bStart"; + $bStart=$blf+1; + } + elsif ( ($alines,$blb) = ( m/^(\d*(?:,\d*)?)d(\d*)$/ ) ) { + ($alb,$alf)=split(/,/,$alines); + $alf=$alb unless defined($alf); + while ( $aStart < $alb ) { + $matchVector->[ -1 + $aStart++ ] = -1 + $bStart++ ; + } + $bStart==$blb+1 or die "_longestCommonSubsequence: Fatal error in interpreting diff output: Inconsistency in deleted sequence near elements $aStart and $bStart"; + $aStart=$alf+1; + } + elsif ( m/^Binary files/ ) { + # if diff reports it is a binary file force --text mode. I do not like + # to always use this option because it is probably only available in GNU diff + open(DIFFPIPE, "diff --text $fna $fnb |") or die "Cannot launch diff process. $!" ; + } + # Default: just skip line + } + while ($aStart <= $aFinish ) { + $matchVector->[ -1 + $aStart++ ] = -1 + $bStart++ ; + } + $bStart==$bFinish+1 or die "_longestCommonSubsequence: Fatal error in interpreting diff output: Inconsistency at end"; + close DIFFPIPE; + # check whether a system error has occurred or return status is greater than or equal to 5 + if ( $! || ($? >> 8) > 5) { + print STDERR "diff process failed with exit code ", ($? >> 8), " $!\n"; + die; + } + unlink $fna,$fnb ; + } + return wantarray ? @$matchVector : $matchVector; +} + +sub traverse_sequences +{ + my $a = shift; # array ref + my $b = shift; # array ref + my $callbacks = shift || {}; + my $keyGen = shift; + my $matchCallback = $callbacks->{'MATCH'} || sub { }; + my $discardACallback = $callbacks->{'DISCARD_A'} || sub { }; + my $finishedACallback = $callbacks->{'A_FINISHED'}; + my $discardBCallback = $callbacks->{'DISCARD_B'} || sub { }; + my $finishedBCallback = $callbacks->{'B_FINISHED'}; + my $matchVector = _longestCommonSubsequence( $a, $b, $keyGen, @_ ); + + # Process all the lines in @$matchVector + my $lastA = $#$a; + my $lastB = $#$b; + my $bi = 0; + my $ai; + + for ( $ai = 0 ; $ai <= $#$matchVector ; $ai++ ) + { + my $bLine = $matchVector->[$ai]; + if ( defined($bLine) ) # matched + { + &$discardBCallback( $ai, $bi++, @_ ) while $bi < $bLine; + &$matchCallback( $ai, $bi++, @_ ); + } + else + { + &$discardACallback( $ai, $bi, @_ ); + } + } + + # The last entry (if any) processed was a match. + # $ai and $bi point just past the last matching lines in their sequences. + + while ( $ai <= $lastA or $bi <= $lastB ) + { + + # last A? + if ( $ai == $lastA + 1 and $bi <= $lastB ) + { + if ( defined($finishedACallback) ) + { + &$finishedACallback( $lastA, @_ ); + $finishedACallback = undef; + } + else + { + &$discardBCallback( $ai, $bi++, @_ ) while $bi <= $lastB; + } + } + + # last B? + if ( $bi == $lastB + 1 and $ai <= $lastA ) + { + if ( defined($finishedBCallback) ) + { + &$finishedBCallback( $lastB, @_ ); + $finishedBCallback = undef; + } + else + { + &$discardACallback( $ai++, $bi, @_ ) while $ai <= $lastA; + } + } + + &$discardACallback( $ai++, $bi, @_ ) if $ai <= $lastA; + &$discardBCallback( $ai, $bi++, @_ ) if $bi <= $lastB; + } + + return 1; +} + +sub traverse_balanced +{ + my $a = shift; # array ref + my $b = shift; # array ref + my $callbacks = shift || {}; + my $keyGen = shift; + my $matchCallback = $callbacks->{'MATCH'} || sub { }; + my $discardACallback = $callbacks->{'DISCARD_A'} || sub { }; + my $discardBCallback = $callbacks->{'DISCARD_B'} || sub { }; + my $changeCallback = $callbacks->{'CHANGE'}; + my $matchVector = _longestCommonSubsequence( $a, $b, $keyGen, @_ ); + + # Process all the lines in match vector + my $lastA = $#$a; + my $lastB = $#$b; + my $bi = 0; + my $ai = 0; + my $ma = -1; + my $mb; + + while (1) + { + + # Find next match indices $ma and $mb + do { $ma++ } while ( $ma <= $#$matchVector && !defined $matchVector->[$ma] ); + + last if $ma > $#$matchVector; # end of matchVector? + $mb = $matchVector->[$ma]; + + # Proceed with discard a/b or change events until + # next match + while ( $ai < $ma || $bi < $mb ) + { + + if ( $ai < $ma && $bi < $mb ) + { + + # Change + if ( defined $changeCallback ) + { + &$changeCallback( $ai++, $bi++, @_ ); + } + else + { + &$discardACallback( $ai++, $bi, @_ ); + &$discardBCallback( $ai, $bi++, @_ ); + } + } + elsif ( $ai < $ma ) + { + &$discardACallback( $ai++, $bi, @_ ); + } + else + { + + # $bi < $mb + &$discardBCallback( $ai, $bi++, @_ ); + } + } + + # Match + &$matchCallback( $ai++, $bi++, @_ ); + } + + while ( $ai <= $lastA || $bi <= $lastB ) + { + if ( $ai <= $lastA && $bi <= $lastB ) + { + + # Change + if ( defined $changeCallback ) + { + &$changeCallback( $ai++, $bi++, @_ ); + } + else + { + &$discardACallback( $ai++, $bi, @_ ); + &$discardBCallback( $ai, $bi++, @_ ); + } + } + elsif ( $ai <= $lastA ) + { + &$discardACallback( $ai++, $bi, @_ ); + } + else + { + + # $bi <= $lastB + &$discardBCallback( $ai, $bi++, @_ ); + } + } + + return 1; +} + +sub LCS +{ + my $a = shift; # array ref + my $matchVector = _longestCommonSubsequence( $a, @_ ); + my @retval; + my $i; + for ( $i = 0 ; $i <= $#$matchVector ; $i++ ) + { + if ( defined( $matchVector->[$i] ) ) + { + push ( @retval, $a->[$i] ); + } + } + return wantarray ? @retval : \@retval; +} + +sub diff +{ + my $a = shift; # array ref + my $b = shift; # array ref + my $retval = []; + my $hunk = []; + my $discard = sub { push ( @$hunk, [ '-', $_[0], $a->[ $_[0] ] ] ) }; + my $add = sub { push ( @$hunk, [ '+', $_[1], $b->[ $_[1] ] ] ) }; + my $match = sub { push ( @$retval, $hunk ) if scalar(@$hunk); $hunk = [] }; + traverse_sequences( $a, $b, + { MATCH => $match, DISCARD_A => $discard, DISCARD_B => $add }, @_ ); + &$match(); + return wantarray ? @$retval : $retval; +} + +sub sdiff +{ + my $a = shift; # array ref + my $b = shift; # array ref + my $retval = []; + my $discard = sub { push ( @$retval, [ '-', $a->[ $_[0] ], "" ] ) }; + my $add = sub { push ( @$retval, [ '+', "", $b->[ $_[1] ] ] ) }; + my $change = sub { + push ( @$retval, [ 'c', $a->[ $_[0] ], $b->[ $_[1] ] ] ); + }; + my $match = sub { + push ( @$retval, [ 'u', $a->[ $_[0] ], $b->[ $_[1] ] ] ); + }; + traverse_balanced( + $a, + $b, + { + MATCH => $match, + DISCARD_A => $discard, + DISCARD_B => $add, + CHANGE => $change, + }, + @_ + ); + return wantarray ? @$retval : $retval; +} + +1; +} +import Algorithm::Diff qw(traverse_sequences); +# End of inserted block for stand-alone version + + +use Getopt::Long ; +use strict ; +use warnings; +use utf8 ; + +use File::Spec ; + + +my ($algodiffversion)=split(/ /,$Algorithm::Diff::VERSION); + + +my ($versionstring)=< 3, # minimum number of tokens to form an independent block + # shorter identical blocks will be merged to the previous word + SCALEDELGRAPHICS => 0.5, # factor with which deleted figures will be scaled down (i.e. 0.5 implies they are shown at half linear size) + # this is only used for --dgraphics-markup=BOTH option + FLOATENV => undef , # Environments in which FL variants of defined commands are used + PICTUREENV => undef , # Environments in which all change markup is removed + MATHENV => undef , # Environments turning on display math mode (code also knows about \[ and \]) + MATHREPL => 'displaymath', # Environment introducing deleted maths blocks + MATHARRENV => undef , # Environments turning on eqnarray math mode + MATHARRREPL => 'eqnarray*', # Environment introducing deleted maths blocks (note that now the starred varieties are being used, so this is only used to replace MATHMODE environments (where original environment is unknown) + ARRENV => undef , # Environments making arrays in math mode. The underlining style does not cope well with those - as a result in-text math environments are surrounded by \mbox{ } if any of these commands is used in an inline math block + COUNTERCMD => undef, + # COUNTERCMD textcmds which are associated with a counter + # If any of these commands occur in a deleted block + # they will be followed by an \addtocounter{...}{-1} + # for the associated counter such that the overall numbers + # should be the same as in the new file + LISTENV => undef , # list making environments - they will generally be kept + VERBATIMENV => undef, # Environments whose content should be treated as verbatim text and not be touched + VERBATIMLINEENV => undef, # Environments whose content should be treated as verbatim text and processed in line diff mode + CUSTOMDIFCMD => undef,# Custom dif command. Is defined in the document as a \DELcommand and \ADDcommand version to be replaced by the diff + ITEMCMD => 'item' # command marking item in a list environment +); +# Configuration variables: these have to be visible from the subroutines +my ($ARRENV, + $COUNTERCMD, + $FLOATENV, + $ITEMCMD, + $LISTENV, + $MATHARRENV, + $MATHARRREPL, + $MATHENV, + $MATHREPL, + $MINWORDSBLOCK, + $PICTUREENV, + $SCALEDELGRAPHICS, + $VERBATIMENV, + $VERBATIMLINEENV, + $CUSTOMDIFCMD + ); + +# my $MINWORDSBLOCK=3; # minimum number of tokens to form an independent block +# # shorter identical blocks will be merged to the previous word +# my $SCALEDELGRAPHICS=0.5; # factor with which deleted figures will be scaled down (i.e. 0.5 implies they are shown at half linear size) +# # this is only used for --graphics-markup=BOTH option +# my $FLOATENV='(?:figure|table|plate)[\w\d*@]*' ; # Environments in which FL variants of defined commands are used +# my $PICTUREENV='(?:picture|tikzpicture|DIFnomarkup)[\w\d*@]*' ; # Environments in which all change markup is removed +# my $MATHENV='(?:equation[*]?|displaymath|DOLLARDOLLAR)[*]?' ; # Environments turning on display math mode (code also knows about \[ and \]) +# my $MATHREPL='displaymath'; # Environment introducing deleted maths blocks +# my $MATHARRENV='(?:eqnarray|align|alignat|gather|multline|flalign)[*]?' ; # Environments turning on eqnarray math mode +# my $MATHARRREPL='eqnarray*'; # Environment introducing deleted maths blocks +# my $ARRENV='(?:aligned|gathered|multlined|array|[pbvBV]?matrix|smallmatrix|cases|split)'; # Environments making arrays in math mode. The underlining style does not cope well with those - as a result in-text math environments are surrounded by \mbox{ } if any of these commands is used in an inline math block +# my $COUNTERCMD='(?:footnote|part|chapter|section|subsection|subsubsection|paragraph|subparagraph)'; # textcmds which are associated with a counter +# # If any of these commands occur in a deleted block +# # they will be succeeded by an \addtocounter{...}{-1} +# # for the associated counter such that the overall numbers +# # should be the same as in the new file +# my $LISTENV='(?:itemize|description|enumerate)'; # list making environments - they will generally be kept +# my $ITEMCMD='item'; # command marking item in a list environment + + + +my $LABELCMD='(?:label)'; # matching commands are disabled within deleted blocks - mostly useful for maths mode, as otherwise it would be fine to just not add those to SAFECMDLIST +my @UNSAFEMATHCMD=('qedhere','intertext','begin','end'); # Commands which are definitely unsafe for marking up in math mode (amsmath qedhere only tested to not work with UNDERLINE markup) (only affects WHOLE and COARSE math markup modes). Note that unlike text mode (or FINE math mode0 deleted unsafe commands are not deleted but simply taken outside \DIFdel +my $MBOXINLINEMATH=0; # if set to 1 then surround marked-up inline maths expression with \mbox ( to get around compatibility + # problems between some maths packages and ulem package + + +# Markup strings +# If at all possible, do not change these as parts of the program +# depend on the actual name (particularly post-processing) +# At the very least adapt subroutine postprocess to new tokens. +my $ADDMARKOPEN='\DIFaddbegin '; # Token to mark begin of appended text +my $ADDMARKCLOSE='\DIFaddend '; # Token to mark end of appended text +my $ADDOPEN='\DIFadd{'; # To mark begin of added text passage +my $ADDCLOSE='}'; # To mark end of added text passage +my $ADDCOMMENT='DIF > '; # To mark added comment line +my $DELMARKOPEN='\DIFdelbegin '; # Token to mark begin of deleted text +my $DELMARKCLOSE='\DIFdelend '; # Token to mark end of deleted text +my $DELOPEN='\DIFdel{'; # To mark begin of deleted text passage +my $DELCLOSE='}'; # To mark end of deleted text passage +my $DELCMDOPEN='%DIFDELCMD < '; # To mark begin of deleted commands (must begin with %, i.e., be a comment +my $DELCMDCLOSE="%%%\n"; # To mark end of deleted commands (must end with a new line) +my $AUXCMD='%DIFAUXCMD' ; # follows auxiliary commands put in by latexdiff to make difference file legal + # auxiliary commands must be on a line of their own + # Note that for verbatim environment openings the %DIFAUXCMD cannot be placed in + # the same line as this would mean they are shown + # so the special form "%DIFAUXCMD NEXT" is used to indicate that the next line + # is an auxiliary command + # Similarly "%DIFAUXCMD LAST" would indicate the auxiliary command is in previous line (not currently used) +my $DELCOMMENT='DIF < '; # To mark deleted comment line +my $VERBCOMMENT='DIFVRB '; # to mark lines which are within a verbatim environment + +# main local variables: +my @TEXTCMDLIST=(); # array containing patterns of commands with text arguments +my @TEXTCMDEXCL=(); # array containing patterns of commands without text arguments (if a pattern + # matches both TEXTCMDLIST and TEXTCMDEXCL it is excluded) +my @CONTEXT1CMDLIST=(); # array containing patterns of commands with text arguments (subset of text commands), + # but which cause confusion if used out of context (e.g. \caption). + # In deleted passages, the command will be disabled but its argument is marked up + # Otherwise they behave exactly like TEXTCMD's +my @CONTEXT1CMDEXCL=(); # exclude list for above, but always empty +my @CONTEXT2CMDLIST=(); # array containing patterns of commands with text arguments, but which fail or cause confusion + # if used out of context (e.g. \title). They and their arguments will be disabled in deleted + # passages +my @CONTEXT2CMDEXCL=(); # exclude list for above, but always empty +my @MATHTEXTCMDLIST=(); # treat like textcmd. If a textcmd is in deleted or added block, just wrap the + # whole content with \DIFadd or \DIFdel irrespective of content. This functionality + # is useful for pseudo commands \MATHBLOCK.. into which math environments are being + # transformed +my @MATHTEXTCMDEXCL=(); # + +# Note I need to declare this with "our" instead of "my" because later in the code I have to "local"ise these +our @SAFECMDLIST=(); # array containing patterns of safe commands (which do not break when in the argument of DIFadd or DIFDEL) +our @SAFECMDEXCL=(); +my @MBOXCMDLIST=(); # patterns for commands which are in principle safe but which need to be surrounded by an \mbox +my @MBOXCMDEXCL=(); # all the patterns in MBOXCMDLIST will be appended to SAFECMDLIST + +my @KEEPCMDLIST=( qr/^bibitem$/ ); # patterns for commands which should not be deleted in nominally delete text passages +my @KEEPCMDEXCL=(); + +my ($i,$j,$l); +my ($old,$new); +my ($line,$key); +my (@dumlist); +my ($newpreamble,$oldpreamble); +my (@newpreamble,@oldpreamble,@diffpreamble,@diffbody); +my ($latexdiffpreamble); +my ($oldbody, $newbody, $diffbo); +my ($oldpost, $newpost); +my ($diffall); +# Option names +my ($type,$subtype,$floattype,$config,$preamblefile,$encoding,$nolabel,$visiblelabel, + $filterscript,$ignorefilterstderr, + $showpreamble,$showsafe,$showtext,$showconfig,$showall, + $replacesafe,$appendsafe,$excludesafe, + $replacetext,$appendtext,$excludetext, + $replacecontext1,$appendcontext1, + $replacecontext2,$appendcontext2, + $help,$verbose,$driver,$version,$ignorewarnings, + $onlyadditions, + $enablecitmark,$disablecitmark,$allowspaces,$flatten,$nolinks,$debug,$earlylatexdiffpreamble); ###$disablemathmark, +my ($mboxsafe); +# MNEMNONICS for mathmarkup +my $mathmarkup; +use constant { + OFF => 0, + WHOLE => 1, + COARSE => 2, + FINE => 3 +}; +# MNEMNONICS for graphicsmarkup +my $graphicsmarkup; +use constant { + NONE => 0, + NEWONLY => 1, + BOTH => 2 +}; + +my ($mboxcmd); + +my (@configlist,@addtoconfiglist,@labels, + @appendsafelist,@excludesafelist, + @appendmboxsafelist,@excludemboxsafelist, + @appendtextlist,@excludetextlist, + @appendcontext1list,@appendcontext2list, + @packagelist); +my ($assign,@config); +# Hash where keys corresponds to the names of all included packages (including the documentclass as another package +# the optional arguments to the package are the values of the hash elements +my ($pkg,%packages); + +# Defaults +$mathmarkup=COARSE; +$verbose=0; +$onlyadditions=0; +# output debug and intermediate files, set to 0 in final distribution +$debug=0; +# insert preamble directly after documentclass - experimental feature, set to 0 in final distribution +# Note that this failed with mini example (or other files, where packages used in latexdiff preamble +# are called again with incompatible options in preamble of resulting file) +$earlylatexdiffpreamble=0; + + +# define character properties +sub IsNonAsciiPunct { return <<'END' # Unicode punctuation but excluding ASCII punctuation ++utf8::IsPunct +-utf8::IsASCII +END +} +sub IsNonAsciiS { return <<'END' # Unicode symbol but excluding ASCII ++utf8::IsS +-utf8::IsASCII +END +} + + +my %verbhash; + +Getopt::Long::Configure('bundling'); +GetOptions('type|t=s' => \$type, + 'subtype|s=s' => \$subtype, + 'floattype|f=s' => \$floattype, + 'config|c=s' => \@configlist, + 'add-to-config=s' => \@addtoconfiglist, + 'preamble|p=s' => \$preamblefile, + 'encoding|e=s' => \$encoding, + 'label|L=s' => \@labels, + 'no-label' => \$nolabel, + 'visible-label' => \$visiblelabel, + 'exclude-safecmd|A=s' => \@excludesafelist, + 'replace-safecmd=s' => \$replacesafe, + 'append-safecmd|a=s' => \@appendsafelist, + 'exclude-textcmd|X=s' => \@excludetextlist, + 'replace-textcmd=s' => \$replacetext, + 'append-textcmd|x=s' => \@appendtextlist, + 'replace-context1cmd=s' => \$replacecontext1, + 'append-context1cmd=s' => \@appendcontext1list, + 'replace-context2cmd=s' => \$replacecontext2, + 'append-context2cmd=s' => \@appendcontext2list, + 'exclude-mboxsafecmd=s' => \@excludemboxsafelist, + 'append-mboxsafecmd=s' => \@appendmboxsafelist, + 'show-preamble' => \$showpreamble, + 'show-safecmd' => \$showsafe, + 'show-textcmd' => \$showtext, + 'show-config' => \$showconfig, + 'show-all' => \$showall, + 'packages=s' => \@packagelist, + 'allow-spaces' => \$allowspaces, + 'math-markup=s' => \$mathmarkup, + 'graphics-markup=s' => \$graphicsmarkup, + 'enable-citation-markup|enforce-auto-mbox' => \$enablecitmark, + 'disable-citation-markup|disable-auto-mbox' => \$disablecitmark, + 'verbose|V' => \$verbose, + 'ignore-warnings' => \$ignorewarnings, + 'driver=s'=> \$driver, + 'flatten' => \$flatten, + 'filter-script=s' => \$filterscript, + 'ignore-filter-stderr' => \$ignorefilterstderr, + 'no-links' => \$nolinks, + 'no-del' => \$onlyadditions, + 'version' => \$version, + 'help|h' => \$help, + 'debug!' => \$debug ) or die "Use latexdiff -h to get help.\n" ; + +if ( $help ) { + usage() ; +} + + +if ( $version ) { + print STDERR $versionstring ; + exit 0; +} + +print STDERR $versionstring if $verbose; + +if (defined($showall)){ + $showpreamble=$showsafe=$showtext=$showconfig=1; +} +# Default types +$type='UNDERLINE' unless defined($type); +$subtype='SAFE' unless defined($subtype); +# set floattype to IDENTICAL for LABEL and ONLYCHANGEDPAGE subtype, unless it has been set explicitly on the command line +$floattype=($subtype eq 'LABEL' || $subtype eq 'ONLYCHANGEDPAGE') ? 'IDENTICAL' : 'FLOATSAFE' unless defined($floattype); +if ( $subtype eq 'LABEL' ) { + print STDERR "Note that LABEL subtype is deprecated. If possible, use ZLABEL instead (requires zref package)"; +} + +if (defined($mathmarkup)) { + $mathmarkup=~tr/a-z/A-Z/; + if ( $mathmarkup eq 'OFF' ){ + $mathmarkup=OFF; + } elsif ( $mathmarkup eq 'WHOLE' ){ + $mathmarkup=WHOLE; + } elsif ( $mathmarkup eq 'COARSE' ){ + $mathmarkup=COARSE; + } elsif ( $mathmarkup eq 'FINE' ){ + $mathmarkup=FINE; + } elsif ( $mathmarkup !~ m/^[0123]$/ ) { + die "latexdiff Illegal value: ($mathmarkup) for option--math-markup. Possible values: OFF,WHOLE,COARSE,FINE,0-3\n"; + } + # else use numerical value +} + +# Give filterscript a default empty string +$filterscript="" unless defined($filterscript); + +# setting extra preamble commands +if (defined($preamblefile)) { + $latexdiffpreamble=join "\n",(extrapream($preamblefile),""); +} else { + $latexdiffpreamble=join "\n",(extrapream($type,$subtype,$floattype),""); +} + +if ( defined($driver) ) { + # for changebar only + $latexdiffpreamble=~s/\[pdftex\]/[$driver]/sg; +} +# setting up @SAFECMDLIST and @SAFECMDEXCL +if (defined($replacesafe)) { + init_regex_arr_ext(\@SAFECMDLIST,$replacesafe); +} else { + init_regex_arr_data(\@SAFECMDLIST, "SAFE COMMANDS"); +} +foreach $appendsafe ( @appendsafelist ) { + init_regex_arr_ext(\@SAFECMDLIST, $appendsafe); +} +foreach $excludesafe ( @excludesafelist ) { + init_regex_arr_ext(\@SAFECMDEXCL, $excludesafe); +} +# setting up @MBOXCMDLIST and @MBOXCMDEXCL +foreach $mboxsafe ( @appendmboxsafelist ) { + init_regex_arr_ext(\@MBOXCMDLIST, $mboxsafe); +} +foreach $mboxsafe ( @excludemboxsafelist ) { + init_regex_arr_ext(\@MBOXCMDEXCL, $mboxsafe); +} + + + +# setting up @TEXTCMDLIST and @TEXTCMDEXCL +if (defined($replacetext)) { + init_regex_arr_ext(\@TEXTCMDLIST,$replacetext); +} else { + init_regex_arr_data(\@TEXTCMDLIST, "TEXT COMMANDS"); +} +foreach $appendtext ( @appendtextlist ) { + init_regex_arr_ext(\@TEXTCMDLIST, $appendtext); +} +foreach $excludetext ( @excludetextlist ) { + init_regex_arr_ext(\@TEXTCMDEXCL, $excludetext); +} + + +# setting up @CONTEXT1CMDLIST ( @CONTEXT1CMDEXCL exist but is always empty ) +if (defined($replacecontext1)) { + init_regex_arr_ext(\@CONTEXT1CMDLIST,$replacecontext1); +} else { + init_regex_arr_data(\@CONTEXT1CMDLIST, "CONTEXT1 COMMANDS"); +} +foreach $appendcontext1 ( @appendcontext1list ) { + init_regex_arr_ext(\@CONTEXT1CMDLIST, $appendcontext1); +} + + +# setting up @CONTEXT2CMDLIST ( @CONTEXT2CMDEXCL exist but is always empty ) +if (defined($replacecontext2)) { + init_regex_arr_ext(\@CONTEXT2CMDLIST,$replacecontext2); +} else { + init_regex_arr_data(\@CONTEXT2CMDLIST, "CONTEXT2 COMMANDS"); +} +foreach $appendcontext2 ( @appendcontext2list ) { + init_regex_arr_ext(\@CONTEXT2CMDLIST, $appendcontext2); +} + +# setting configuration variables +@config=(); +foreach $config ( @configlist ) { + if (-f $config || lc $config eq '/dev/null' ) { + open(FILE,$config) or die ("Couldn't open configuration file $config: $!"); + while () { + chomp; + next if /^\s*#/ || /^\s*%/ || /^\s*$/ ; + push (@config,$_); + } + close(FILE); + } + else { +# foreach ( split(",",$config) ) { +# push @config,$_; +# } + push @config,split(",",$config) + } +} +foreach $assign ( @config ) { + $assign=~ m/\s*(\w*)\s*=\s*(\S*)\s*$/ or die "Illegal assignment $assign in configuration list (must be variable=value)"; + exists $CONFIG{$1} or die "Unknown configuration variable $1."; + $CONFIG{$1}=$2; +} + +my @addtoconfig=(); +foreach $config ( @addtoconfiglist ) { + if (-f $config || lc $config eq '/dev/null' ) { + open(FILE,$config) or die ("Couldn't open addd-to-config file $config: $!"); + while () { + chomp; + next if /^\s*#/ || /^\s*%/ || /^\s*$/ ; + push (@addtoconfig,$_); + } + close(FILE); + } + else { +# foreach ( split(",",$config) ) { +# push @addtoconfig,$_; +# } + push @addtoconfig,split(",",$config) + } +} + +# initialise default lists from DATA +# for those configuration variables, which have not been set explicitly, initiate from list in document +foreach $key ( keys(%CONFIG) ) { + if (!defined $CONFIG{$key}) { + @dumlist=(); + init_regex_arr_data(\@dumlist,"$key CONFIG"); + $CONFIG{$key}=join(";",@dumlist) + } +} + + +foreach $assign ( @addtoconfig ) { + ###print STDERR "assign:|$assign|\n"; + $assign=~ m/\s*(\w*)\s*=\s*(\S*)\s*$/ or die "Illegal assignment $assign in configuration list (must be variable=value)"; + exists $CONFIG{$1} or die "Unknown configuration variable $1."; + $CONFIG{$1}.=";$2"; +} + +# Map from hash to variables (we do this to have more concise code later, change from comma-separated list) +foreach ( keys(%CONFIG) ) { + if ( $_ eq "MINWORDSBLOCK" ) { $MINWORDSBLOCK = $CONFIG{$_}; } + elsif ( $_ eq "FLOATENV" ) { $FLOATENV = liststringtoregex($CONFIG{$_}) ; } + elsif ( $_ eq "ITEMCMD" ) { $ITEMCMD = $CONFIG{$_} ; } + elsif ( $_ eq "LISTENV" ) { $LISTENV = liststringtoregex($CONFIG{$_}) ; } + elsif ( $_ eq "PICTUREENV" ) { $PICTUREENV = liststringtoregex($CONFIG{$_}) ; } + elsif ( $_ eq "MATHENV" ) { $MATHENV = liststringtoregex($CONFIG{$_}) ; } + elsif ( $_ eq "MATHREPL" ) { $MATHREPL = $CONFIG{$_} ; } + elsif ( $_ eq "MATHARRENV" ) { $MATHARRENV = liststringtoregex($CONFIG{$_}) ; } + elsif ( $_ eq "MATHARRREPL" ) { $MATHARRREPL = $CONFIG{$_} ; + print STDERR "WARNING: Setting MATHARRREPL is depracated. Generally deleted math array environments will be set to their starred varieties and the setting of MATHARREPL is ignored.\n\n" unless $MATHARRREPL =~ /eqnarray\*/ ; + } + elsif ( $_ eq "ARRENV" ) { $ARRENV = liststringtoregex($CONFIG{$_}) ; } + elsif ( $_ eq "VERBATIMENV" ) { $VERBATIMENV = liststringtoregex($CONFIG{$_}) ; } + elsif ( $_ eq "VERBATIMLINEENV" ) { $VERBATIMLINEENV = liststringtoregex($CONFIG{$_}) ; } + elsif ( $_ eq "CUSTOMDIFCMD" ) { $CUSTOMDIFCMD = liststringtoregex($CONFIG{$_}) ; } + elsif ( $_ eq "COUNTERCMD" ) { $COUNTERCMD = liststringtoregex($CONFIG{$_}) ; } + elsif ( $_ eq "SCALEDELGRAPHICS" ) { $SCALEDELGRAPHICS = $CONFIG{$_} ; } + else { die "Unknown configuration variable $_.";} +} + +if ( $mathmarkup == COARSE || $mathmarkup == WHOLE ) { + push(@MATHTEXTCMDLIST,qr/^MATHBLOCK(?:$MATHENV|$MATHARRENV|SQUAREBRACKET)$/); +} + + + + + +foreach $pkg ( @packagelist ) { + map { $packages{$_}="" } split(/,/,$pkg) ; +} + + +if ($showconfig || $showtext || $showsafe || $showpreamble) { + + show_configuration(); + exit 0; +} + + +if ( @ARGV != 2 ) { + print STDERR "2 and only 2 non-option arguments required. Write latexdiff -h to get help\n"; + exit(2); +} + +# Are extra spaces between command arguments permissible? +my $extraspace; +if ($allowspaces) { + $extraspace='\s*'; +} else { + $extraspace=''; +} + +# append context lists to text lists (as text property is implied) +push @TEXTCMDLIST, @CONTEXT1CMDLIST; +push @TEXTCMDLIST, @CONTEXT2CMDLIST; + +push @TEXTCMDLIST, @MATHTEXTCMDLIST if $mathmarkup==COARSE; + +# internal additions to SAFECMDLIST +push(@SAFECMDLIST, qr/^QLEFTBRACE$/, qr/^QRIGHTBRACE$/); + + +# Patterns. These are used by some of the subroutines, too +# I can only define them down here because value of extraspace depends on an option + + my $pat0 = '(?:[^{}])*'; + my $pat_n = $pat0; +# if you get "undefined control sequence MATHBLOCKmath" error, increase the maximum value in this loop + for (my $i_pat = 0; $i_pat < 20; ++$i_pat){ + $pat_n = '(?:[^{}]|\{'.$pat_n.'\}|\\\\\{|\\\\\})*'; + # Actually within the text body, quoted braces are replaced in pre-processing. The only place where + # the last part of the pattern matters is when processing the arguments of context2cmds in the preamble + # and these contain a \{ or \} combination, probably rare. + # It should thus be fine to use the simpler version below. + ### $pat_n = '(?:[^{}]|\{'.$pat_n.'\})*'; + } + + my $brat0 = '(?:[^\[\]]|\\\[|\\\])*'; + my $brat_n = $brat0; + for (my $i_pat = 0; $i_pat < 4; ++$i_pat){ + $brat_n = '(?:[^\[\]]|\['.$brat_n.'\]|\\\[|\\\])*'; + ### $brat_n = '(?:[^\[\]]|\['.$brat_n.'\])*'; # Version not taking into account escaped \[ and \] + } + my $abrat0 = '(?:[^<>])*'; + + +# variable definitions are in order that they are matched + my $and = '&'; + my $quotemarks = '(?:\'\')|(?:\`\`)'; + # some common abbreviations involving punctuations within them. They need special treatment because otherwise in some + # circumstances the gnoring of white space differences in conjunction with merging according to MINWORDSBLOCK rule + # could turn 'i.e.' into 'i.\PAR e.' (see https://github.com/ftilmann/latexdiff/issues/269) + # English: i.e., e.g. Deutsch: z.B. + my $abbreviation='(?:i\. ?e\.|e\. ?g\.|z\. ?B\.)' ; + my $number='-?\d*\.\d*'; + + # word: sequence of letters or accents followed by letter + my $word_cj='\p{Han}|\p{InHiragana}|\p{InKatakana}'; + my $word='(?:' . $word_cj . '|(?:(?:[-\w\d*]|\\\\[\"\'\`~^][A-Za-z\*])(?!(?:' . $word_cj . ')))+)'; + + # quoted underscore - this needs special treatment as perl treats _ as a letter (\w) but latex does not + # such that a\_b would otherwise be interpreted as a{\_}b by latex but a{\_b} by latexdiff + my $quotedunderscore='\\\\_'; + # Handle tex \def macro: \def\MAKRONAME#1[#2]#3{DEFINITION} + my $defseq='\\\\def\\\\[\w\d@\*]+(?:#\d+|\[#\d+\])+(?:\{'. $pat_n . '\})?'; + my $cmdleftright='\\\\(?:left|right|[Bb]igg?[lrm]?|middle)\s*(?:[<>()\[\]|\.]|\\\\(?:[|{}]|\w+))'; + + # for selected commands, the number of arguments is known, and we can therefore allow spaces between command and its argument + # Note that it is still expected that the arguments are blocks marked by parentheses rather than single characters, and that intervening comments will inhibit the association + my $predefinedcmdoptseq12='\\\\(?:href|bibfield|bibinfo)\s*(?:\['.$brat_n.'\])?\s*(?:\{'. $pat_n . '\}\s*){2}'; # Commands with one optional and two non-optional arguments + my $predefinedcmdoptseq01='\\\\(?:url|BibitemShut)\s*\s*(?:\{'. $pat_n . '\}\s*){1}'; # Commands with one non-optional argument + # \bibitem in revtex styles appears to be always followed by \BibItemOpen. We bind \BibItemOpen to the bibitem (if present) in order to prevent the comparison algorithm to interpret the \BibItemOpen as an identical part of the sequence; this interpretation can lead to added and removed entries to the reference list to become mixed. + my $predefinedbibitem='\\\\(?:bibitem)\s*(?:\['.$brat_n.'\])?\s*(?:\{'. $pat_n . '\})(?:%?\s*\\\\BibitemOpen)?'; # Commands with one optional and one non-optional arguments + my $predefinedcmdoptseq='(?:'.$predefinedcmdoptseq12.'|'.$predefinedcmdoptseq01.'|'.$predefinedbibitem.')'; + + # standard $cmdoptseq (default: no intrevening spaces, controlled by extraspcae) - a final open parentheses is merged to the commend if it exists to deal properly with multi-argument text command + my $coords= '[\-.,\s\d]*'; + my $cmdoptseq='\\\\[\w\d@\*]+'.$extraspace.'(?:(?:<'.$abrat0.'>|\['.$brat_n.'\]|\{'. $pat_n . '\}|\(' . $coords .'\))'.$extraspace.')*\{?'; + + # inline math $....$ or \(..\) + ### the commented out version is simpler but for some reason cannot cope with newline (in spite of s option) - need to include \newline explicitly + ### my $math='\$(?:[^$]|\\\$)*?\$|\\\\[(].*?\\\\[)]'; + my $math='\$(?:[^$]|\\\$)*?\$|\\\\[(](?:.|\n)*?\\\\[)]'; + ### test version (this seems to give the same results as version above) + ## the current maths command cannot cope with newline within the math expression + ### my $math='\$(?:[^$]|\\\$)*?\$|\\[(].*?\\[)]'; + ### my $math='\$(?:[^$]|\\\$)*\$'; + + my $backslashnl='\\\\\n'; + my $oneletcmd='\\\\.\*?(?:\['.$brat_n.'\]|\{'. $pat_n . '\})*'; + my $comment='%[^\n]*\n'; + my $punct='[0.,\/\'\`:;\"\?\(\)\[\]!~\p{IsNonAsciiPunct}\p{IsNonAsciiS}]'; + my $mathpunct='[+=<>\-\|]'; + + # Assembled pattern + my $pat=qr/(?:\A\s*)?(?:${abbreviation}|${and}|${quotemarks}|${number}|${word}|$quotedunderscore|${defseq}|$cmdleftright|${predefinedcmdoptseq}|${cmdoptseq}|${math}|${backslashnl}|${oneletcmd}|${comment}|${punct}|${mathpunct}|\{|\})\s*/ ; + + + + +# now we are done setting up and can start working +my ($oldfile, $newfile) = @ARGV; +# check for existence of input files +if ( ! -e $oldfile ) { + die "Input file $oldfile does not exist"; +} +if ( ! -e $newfile ) { + die "Input file $newfile does not exist"; +} + + +# set the labels to be included into the file +# first find out which file name is longer for correct alignment +my ($diff,$oldlabel_n_spaces,$newlabel_n_spaces); +$oldlabel_n_spaces = 0; +$newlabel_n_spaces = 0; +$diff = length($newfile) - length($oldfile); +if ($diff > 0) { + $oldlabel_n_spaces = $diff; +} +if ($diff < 0) { + $newlabel_n_spaces = abs($diff); +} + +my ($oldtime,$newtime,$oldlabel,$newlabel); +if (defined($labels[0])) { + $oldlabel=$labels[0] ; +} else { + $oldtime=localtime((stat($oldfile))[9]); + $oldlabel="$oldfile " . " "x($oldlabel_n_spaces) . $oldtime; +} +if (defined($labels[1])) { + $newlabel=$labels[1] ; +} else { + $newtime=localtime((stat($newfile))[9]); + $newlabel="$newfile " . " "x($newlabel_n_spaces) . $newtime; +} + +$encoding=guess_encoding($newfile) unless defined($encoding); + +$encoding = "utf8" if $encoding =~ m/^utf8/i ; +print STDERR "Encoding $encoding\n" if $verbose; +if (lc($encoding) eq "utf8" ) { + binmode(STDOUT, ":utf8"); + binmode(STDERR, ":utf8"); +} + +# filter($text) +# Runs $text through the script provided in $filterscript argument, if set +# If not set, just returns $text unchanged. +# If flatten was set, defer filtering to flatten. flatten will run the filter +# on all incoming text prior to its own processing. +# If flatten was not set, filter each of old and new once (see just below this def) +sub filter { + my ($text)=@_; + my ($textout,$pid); + if ($filterscript ne "") { + print STDERR "Passing " . length($text) . " chars to filter script " . $filterscript . "\n" if $verbose; + + if ($ignorefilterstderr) { + # If we need to capture and bury STDERR, use the Open3 version, and close CHLD_ERR below. + use IPC::Open3; + # We consume STDERR from the process, and hide it + $pid = open3(\*CHLD_IN, \*CHLD_OUT, \*CHLD_ERR, $filterscript) or die "open3() failed $!"; + } + else { + # Capture STDOUT and use as our new $text. Allow STDERR to go to console. + use IPC::Open2; + $pid = open2(\*CHLD_OUT, \*CHLD_IN, $filterscript) or die "open2() failed $!"; + } + # Send in $text + print CHLD_IN $text."\n"; # Adding a newline just to make sure there is one. + close CHLD_IN; + # Wait for output and gather it up + while () { + $textout = $textout.$_; + } + if ($ignorefilterstderr) { + close CHLD_ERR; # Enable only if Open3 used above + } + # On the off chance a very long running and/or frequently called script is used. + waitpid( $pid, 0 ); + $text = $textout; + print STDERR "Received " . length($text) . " chars after filtering\n" if $verbose; + print STDERR $text if $verbose; + } + return $text; +} + +$old=read_file_with_encoding($oldfile,$encoding); +$new=read_file_with_encoding($newfile,$encoding); + +if (not defined($flatten)) { + $old=filter($old); + $new=filter($new); +} + + + + +# reset time +exetime(1); +($oldpreamble,$oldbody,$oldpost)=splitdoc($old,'\\\\begin\{document\}','\\\\end\{document\}'); + +($newpreamble,$newbody,$newpost)=splitdoc($new,'\\\\begin\{document\}','\\\\end\{document\}'); + + +if ($flatten) { + $oldbody=flatten($oldbody,$oldpreamble,File::Spec->rel2abs($oldfile),$encoding); + $newbody=flatten($newbody,$newpreamble,File::Spec->rel2abs($newfile),$encoding); + # flatten preamble + $oldpreamble=flatten($oldpreamble,$oldpreamble,File::Spec->rel2abs($oldfile),$encoding); + $newpreamble=flatten($newpreamble,$newpreamble,File::Spec->rel2abs($newfile),$encoding); + +} + + + + +my @auxlines; + +# boolean variab +my ($ulem)=0; + +if ( length $oldpreamble && length $newpreamble ) { + # pre-process preamble by looking for commands used in \maketitle (title, author, date etc commands) + # and marking up content with latexdiff markup + @auxlines=preprocess_preamble($oldpreamble,$newpreamble); + + @oldpreamble = split /\n/, $oldpreamble; + @newpreamble = split /\n/, $newpreamble; + + # If a command is defined in the preamble of the new file, and only uses safe commands, then it can be considered to be safe) (contribution S. Gouezel) + # Base this assessment on the new preamble + add_safe_commands($newpreamble); + + # get a list of packages from preamble if not predefined + %packages=list_packages($newpreamble) unless %packages; + if ( %packages && $debug ) { my $key ; foreach $key (keys %packages) { print STDERR "DEBUG \\usepackage[",$packages{$key},"]{",$key,"}\n" ;} } +} + +# have to return to all processing to properly add preamble additions based on packages found +if (defined($graphicsmarkup)) { + $graphicsmarkup=~tr/a-z/A-Z/; + if ( $graphicsmarkup eq 'OFF' or $graphicsmarkup eq 'NONE' ) { + $graphicsmarkup=NONE; + } elsif ( $graphicsmarkup eq 'NEWONLY' or $graphicsmarkup eq 'NEW-ONLY' ) { + $graphicsmarkup=NEWONLY; + } elsif ( $graphicsmarkup eq 'BOTH' ) { + $graphicsmarkup=BOTH; + } elsif ( $graphicsmarkup !~ m/^[012]$/ ) { + die "latexdiff Illegal value: ($graphicsmarkup) for option --highlight-graphics. Possible values: OFF,WHOLE,COARSE,FINE,0-2\n"; + } + # else use numerical value +} else { + # Default: no explicit setting in menu + if ( defined $packages{"graphicx"} or defined $packages{"graphics"} ) { + $graphicsmarkup=NEWONLY; + } else { + $graphicsmarkup=NONE; + } +} + +if (defined $packages{"hyperref"} ) { + # deleted lines should not generate or appear in link names: + print STDERR "hyperref package detected.\n" if $verbose ; + $latexdiffpreamble =~ s/\{\\DIFadd\}/{\\DIFaddtex}/g; + $latexdiffpreamble =~ s/\{\\DIFdel\}/{\\DIFdeltex}/g; + $latexdiffpreamble .= join "\n",(extrapream("HYPERREF"),""); + if($nolinks){ + $latexdiffpreamble .= "\n\\hypersetup{bookmarks=false}"; + } + ### $latexdiffpreamble .= '%DIF PREAMBLE EXTENSION ADDED BY LATEXDIFF FOR HYPERREF PACKAGE' . "\n"; + ### $latexdiffpreamble .= '\providecommand{\DIFadd}[1]{\texorpdfstring{\DIFaddtex{#1}}{#1}}' . "\n"; + ### $latexdiffpreamble .= '\providecommand{\DIFdel}[1]{\texorpdfstring{\DIFdeltex{#1}}{}}' . "\n"; + ### $latexdiffpreamble .= '%DIF END PREAMBLE EXTENSION ADDED BY LATEXDIFF FOR HYPERREF PACKAGE' . "\n"; +} + +# add commands for figure highlighting to preamble +if ($graphicsmarkup != NONE ) { + my @matches; + # Check if \DIFaddbeginFL definition calls \DIFaddbegin - if so we will issue an error message that graphics highlighting is + # is not compatible with this. + # (A more elegant solution would be to suppress the redefinitions of the \DIFaddbeginFL etc commands, but for this narrow use case + # I currently don't see this as an efficient use of time) + ### The foreach loop does not make sense here. I don't know why I put this in - (F Tilmann) + ###foreach my $cmd ( "DIFaddbegin","DIFaddend","DIFdelbegin","DIFdelend" ) { + @matches=( $latexdiffpreamble =~ m/command\{\\DIFaddbeginFL}\{($pat_n)}/sg ) ; + # we look at the last one of the list to take into account possible redefinition but almost always matches should have exactly one element + if ( $matches[$#matches] =~ m/\\DIFaddbegin/ ) { + die "Cannot combine graphics markup with float styles defining \\DIFaddbeginFL in terms of \\DIFaddbegin. Use --graphics-markup=none option or choose a different float style."; + exit 10; + } + ###} + $latexdiffpreamble .= join "\n",("\\newcommand{\\DIFscaledelfig}{$SCALEDELGRAPHICS}",extrapream("HIGHLIGHTGRAPHICS"),""); + + # only change required for highlighting both is to declare \includegraphics safe, as preamble already contains commands for deleted environment + if ( $graphicsmarkup == BOTH ) { + init_regex_arr_list(\@SAFECMDLIST,'includegraphics'); + } +} + +$ulem = ($latexdiffpreamble =~ /\\RequirePackage(?:\[$brat_n\])?\{ulem\}/ || defined $packages{"ulem"}); + +# If amsmath is defined and $ulem is used for markup, redefine the \sout command to also work (mostly) in math mode +# See stack exchange https://tex.stackexchange.com/questions/20609/strikeout-in-math-mode/308647#308647 based on comment by Taylor Raine +if ( defined($packages{'amsmath'}) and $ulem ) { + $latexdiffpreamble .= join "\n",(extrapream('AMSMATHULEM'),""); +} + +# If listings is being used or can be found in the latexdiff search path, add to the preamble auxiliary code to enable line-by-line markup +if ( defined($packages{"listings"}) or `kpsewhich listings.sty` ne "" ) { + my @listingpreamble=extrapream("LISTINGS"); + if ($latexdiffpreamble =~ /\\RequirePackage(?:\[$brat_n\])?\{color\}/ ) { + @listingpreamble=extrapream("COLORLISTINGS"); + } + my @listingDIFcode=(); + my $replaced; + # note that in case user supplies preamblefile the type might not reflect well the actual markup style + @listingDIFcode=extrapream("-nofail","DIFCODE_" . $type) unless defined($preamblefile); + if (!(@listingDIFcode)) { + # if listingDIFcode is empty try to guess a suitable one from the preamble + if ($latexdiffpreamble =~ /\\RequirePackage(?:\[$brat_n\])?\{color\}/ and $ulem ) { + @listingDIFcode=extrapream("DIFCODE_UNDERLINE"); + } elsif ( $latexdiffpreamble =~ /\\RequirePackage(?:\[$brat_n\])?\{color\}/ ) { + # only colour used + @listingDIFcode=extrapream("DIFCODE_CFONT"); + } else { + # fall-back solution + @listingDIFcode=extrapream("DIFCODE_BOLD"); + } + } + # add configuration so that listings work with utf-8 + push @listingpreamble, '\lstset{extendedchars=\true,inputencoding='.$encoding."}\n"; + + + # now splice it in + $replaced=0; + ###print STDERR "DEBUG: listingDIFcode: ",join("\n",@listingDIFcode),"|||\n" if $debug; + + @listingpreamble=grep { + # only replace if this has not been done already (use short-circuit property of and) + if (!$replaced and $_ =~ s/^.*%DIFCODE TEMPLATE.*$/join("\n",@listingDIFcode)/e ) { + ###print STDERR "DEBUG: Replaced text $_\n" if $debug; + $replaced=1; + 1; + } else { + # return false for those lines matching %DIFCODE TEMPLATE (so that they are not included in output) + not m/%DIFCODE TEMPLATE/; + } + } @listingpreamble; + ### print STDERR "DEBUG: listingpreamble @listingpreamble\n"; + $latexdiffpreamble .= join "\n",(@listingpreamble,""); +} else { + print STDERR "WARNING: listings package not detected. Disabling mark-up in verbatim environments \n" ; + # if listings does not exist disable line-by-line markup and treat all verbatim environments as opaque + $VERBATIMENV = liststringtoregex($CONFIG{VERBATIMENV}.";".$CONFIG{VERBATIMLINEENV}); + $VERBATIMLINEENV = ""; +} + +# adding begin and end marker lines to preamble +$latexdiffpreamble = "%DIF PREAMBLE EXTENSION ADDED BY LATEXDIFF\n" . $ latexdiffpreamble . "%DIF END PREAMBLE EXTENSION ADDED BY LATEXDIFF\n"; + +# and return to preamble specific processing +if ( length $oldpreamble && length $newpreamble ) { + print STDERR "Differencing preamble.\n" if $verbose; + + # insert dummy first line such that line count begins with line 1 (rather than perl's line 0) - just so that line numbers inserted by linediff are correct + unshift @newpreamble,''; + unshift @oldpreamble,''; + @diffpreamble = linediff(\@oldpreamble, \@newpreamble); + # remove dummy line again + shift @diffpreamble; + # add filenames, modification time and latexdiff mark + defined($nolabel) or splice @diffpreamble,1,0, + "%DIF LATEXDIFF DIFFERENCE FILE", + ,"%DIF DEL $oldlabel", + "%DIF ADD $newlabel"; + if ( @auxlines ) { + push @diffpreamble,"%DIF DELETED TITLE COMMANDS FOR MARKUP"; + push @diffpreamble,join("\n",@auxlines); + } + if ( $earlylatexdiffpreamble) { + # insert latexdiff command directly after documentclass at beginning of preamble + # note that grep is only run for its side effect + ( grep { s/^([^%]*\\documentclass.*)$/$1$latexdiffpreamble/ } @diffpreamble )==1 or die "Could not find documentclass statement in preamble"; + } else { + # insert latexdiff commands at the end of preamble (default behaviour) + push @diffpreamble,$latexdiffpreamble; + } + push @diffpreamble,'\begin{document}'; + if (defined $packages{"hyperref"} && $nolinks) { + push @diffpreamble, '\begin{NoHyper}'; + } +} +elsif ( !length $oldpreamble && !length $newpreamble ) { + @diffpreamble=(); +} else { + print STDERR "Either both texts must have preamble or neither text must have the preamble.\n"; + exit(2); +} + +# Special: treat all cite commands as safe except in UNDERLINE and FONTSTRIKE mode +# (there is a conflict between citation and ulem package, see +# package documentation) +# Use post-processing +# and $packages{"apacite"}!~/natbibpapa/ + + +if (defined $packages{"units"} && $ulem ) { + # protect inlined maths environments by surrounding with an \mbox + # this is done to get around an incompatibility between the ulem and units package + # where spaces in the argument to underlined or crossed-out \unit commands cause an error message + print STDERR "units package detected at the same time as style using ulem.\n" if $verbose ; + $MBOXINLINEMATH=1; +} + +if (defined $packages{"siunitx"} ) { + # protect SI command by surrounding them with an \mbox + # this is done to get around an incompatibility between the ulem and siunitx package + print STDERR "siunitx package detected.\n" if $verbose ; + my $mboxcmds='SI,ang,numlist,numrange,SIlist,SIrange,qty,qtylist,qtyproduct,qtyrange,complexqty'; + init_regex_arr_list(\@SAFECMDLIST,'num,si,numproduct,unit,complexnum'); + if ( $enablecitmark || ( $ulem && ! $disablecitmark )) { + init_regex_arr_list(\@MBOXCMDLIST,$mboxcmds); + } else { + init_regex_arr_list(\@SAFECMDLIST,$mboxcmds); + } +} + +if (defined $packages{"cleveref"} ) { + # protect selected command by surrounding them with an \mbox + # this is done to get around an incompatibility between ulem and cleveref package + print STDERR "cleveref package detected.\n" if $verbose ; + my $mboxcmds='[Cc]ref(?:range)?\*?,labelcref,(?:lc)?name[cC]refs?' ; + if ( $enablecitmark || ( $ulem && ! $disablecitmark )) { + init_regex_arr_list(\@MBOXCMDLIST,$mboxcmds); + } else { + init_regex_arr_list(\@SAFECMDLIST,$mboxcmds); + } +} + +if (defined $packages{"glossaries"} ) { + # protect selected command by surrounding them with an \mbox + # this is done to get around an incompatibility between ulem and glossaries package + print STDERR "glossaries package detected.\n" if $verbose ; + my $mboxcmds='[gG][lL][sS](?:|pl|disp|link|first|firstplural|desc|user[iv][iv]?[iv]?),[aA][cC][rR](?:long|longpl|full|fullpl),[aA][cC][lfp]?[lfp]?'; + init_regex_arr_list(\@SAFECMDLIST,'[gG][lL][sS](?:(?:entry)?(?:text|plural|name|symbol)|displaynumberlist|entryfirst|entryfirstplural|entrydesc|entrydescplural|entrysymbolplural|entryuser[iv][iv]?[iv]?|entrynumberlist|entrydisplaynumberlist|entrylong|entrylongpl|entryshort|entryshortpl|entryfull|entryfullpl),[gG]lossentry(?:name|desc|symbol),[aA][cC][rR](?:short|shortpl),[aA]csp?'); + if ( $enablecitmark || ( $ulem && ! $disablecitmark )) { + init_regex_arr_list(\@MBOXCMDLIST,$mboxcmds); + } else { + init_regex_arr_list(\@SAFECMDLIST,$mboxcmds); + } +} + +if (defined $packages{"chemformula"} or defined $packages{"chemmacros"} ) { + print STDERR "chemformula package detected.\n" if $verbose ; + init_regex_arr_list(\@SAFECMDLIST,'ch'); + push(@UNSAFEMATHCMD,'ch'); + # The next command would be needed to allow highlighting the interior of \ch commands in math environments + # but the redefinitions in chemformula are too deep to make this viable + # push(@MATHTEXTCMDLIST,'ch'); +} + +if (defined $packages{"mhchem"} ) { + print STDERR "mhchem package detected.\n" if $verbose ; + init_regex_arr_list(\@SAFECMDLIST,'ce'); + push(@UNSAFEMATHCMD,'ce','cee'); + # The next command would be needed to allow highlighting the interior of \cee commands in math environments + # but the redefinitions in chemformula are too deep to make this viable + # push(@MATHTEXTCMDLIST,'cee'); +} + +if ( defined $packages{"tikz-dependency"} ) { + init_regex_arr_ext(\@SAFECMDEXCL, 'AMPERSAND'); +} + + +my ( $citpat); + +if ( defined $packages{"apacite"} ) { + print STDERR "apacite package detected.\n" if $verbose ; + $citpat='(?:mask)?(?:full|short|no)?cite(?:A|author|year|meta)?(?:NP)?'; +} elsif (defined $packages{"biblatex"}) { + print STDERR "biblatex package detected.\n" if $verbose ; + $citpat='(?:[cC]ites?|(?:[pP]aren|foot|[Tt]ext|[sS]mart|super)cites?\*?|footnotecitetex)'; + push(@TEXTCMDEXCL, qr/^textcite$/); +} else { + # citation command pattern for all other citation schemes + $citpat='(?:cite\w*|nocite)'; +}; + +if ( ! $ulem ) { + # modes not using ulem: citation is safe + push (@SAFECMDLIST, $citpat); +} else { + ### Experimental: disable text and emph commands + push(@SAFECMDEXCL, qr/^emph$/, qr/^text..$/); + # replace \cite{..} by \mbox{\cite{..}} in added or deleted blocks in post-processing + push(@MBOXCMDLIST,$citpat) unless $disablecitmark; + if ( uc($subtype) eq "COLOR" or uc($subtype) eq "DVIPSCOL" ) { + # remove \cite command again from list of safe commands + pop @MBOXCMDLIST; + # deleted cite commands + } +} +push(@MBOXCMDLIST,$citpat) if $enablecitmark ; + + +if (defined $packages{"amsmath"} or defined $packages{"amsart"} or defined $packages{"amsbook"} ) { + print STDERR "amsmath package detected.\n" if $verbose ; + $MATHARRREPL='align*'; +} + +# add commands in MBOXCMDLIST to SAFECMDLIST +foreach $mboxcmd ( @MBOXCMDLIST ) { + init_regex_arr_list(\@SAFECMDLIST, $mboxcmd); +} + +# check if \label is in SAFECMDLIST, and if yes replace "label" in $LABELCMD by something that never matches (we hope!) +if ( iscmd("label",\@SAFECMDLIST,\@SAFECMDEXCL) ) { + $LABELCMD=~ s/label/NEVERMATCHLABEL/; +} + + + +print STDERR "Preprocessing body. " if $verbose; +preprocess($oldbody,$newbody); +writedebugfile($oldbody,'old-preprocess'); +writedebugfile($newbody,'new-preprocess'); + +# run difference algorithm +@diffbody=bodydiff($oldbody, $newbody); +$diffbo=join("",@diffbody); +writedebugfile($diffbo,"bodydiff"); + +print STDERR "(",exetime()," s)\n","Postprocessing body. \n" if $verbose; +postprocess($diffbo); +$diffall =join("\n",@diffpreamble) ; +# add visible labels +if (defined($visiblelabel)) { + # Give information right after \begin{document} (or at the beginning of the text for files without preamble + ### if \date command is used, add information to \date argument, otherwise give right after \begin{document} + ### $diffall=~s/(\\date$extraspace(?:\[$brat0\])?$extraspace)\{($pat_n)\}/$1\{$2 \\ LATEXDIFF comparison \\ Old: $oldlabel \\ New: $newlabel \}/ or + $diffbo = "\\begin{verbatim}LATEXDIFF comparison\nOld: $oldlabel\nNew: $newlabel\\end{verbatim}\n$diffbo" ; +} + +$diffall .= "$diffbo" ; +if (defined $packages{"hyperref"} && $nolinks) { + $diffall .= "\\end{NoHyper}\n"; +} +$diffall .= "\\end{document}$newpost" if length $newpreamble ; +if ( lc($encoding) ne "utf8" && lc($encoding) ne "ascii" ) { + print STDERR "Encoding output file to $encoding\n" if $verbose; + $diffall=Encode::encode($encoding,$diffall); + binmode STDOUT; +} +print $diffall; + + +print STDERR "(",exetime()," s)\n","Done.\n" if $verbose; + + +# liststringtoregex(liststring) +# expands string with semi-colon separated list into a regular expression corresponding +# matching any of the elements +sub liststringtoregex { + my ($liststring)=@_; + my @elements=grep /\S/,split(";",$liststring); + if ( @elements) { + return('(?:(?:' . join(')|(?:',@elements) .'))'); + } else { + return ""; + } +} + +# show_configuration +# note that this is not encapsulated but uses variables from the main program +# It is provided for convenience because in the future it is planned to allow output +# to be modified based on what packages are read etc - this works only if the input files are actually read +# whether or not additional files are provided +sub show_configuration { + if ($showpreamble) { + print "\nPreamble commands:\n"; + print $latexdiffpreamble ; + } + + if ($showsafe) { + print "\nsafecmd: Commands safe within scope of $ADDOPEN $ADDCLOSE and $DELOPEN $DELCLOSE (unless excluded):\n"; + print_regex_arr(@SAFECMDLIST); + print "\nsafecmd-exlude: Commands not safe within scope of $ADDOPEN $ADDCLOSE and $DELOPEN $DELCLOSE :\n"; + print_regex_arr(@SAFECMDEXCL); + print "\nmboxsafecmd: Commands safe only if they are surrounded by \\mbox command:\n"; + print_regex_arr(@MBOXCMDLIST); + print "\nnmboxsafecmd: Commands not safe:\n"; + print_regex_arr(@MBOXCMDEXCL); + } + + if ($showtext) { + print "\nCommands with last argument textual (unless excluded) and safe in every context:\n"; + print_regex_arr(@TEXTCMDLIST); + print "\nContext1 commands (last argument textual, command will be disabled in deleted passages, last argument will be shown as plain text):\n"; + print_regex_arr(@CONTEXT1CMDLIST); + print "\nContext2 commands (last argument textual, command and its argument will be disabled in deleted passages):\n"; + print_regex_arr(@CONTEXT2CMDLIST); + print "\nExclude list of Commands with last argument not textual (overrides patterns above):\n"; + print_regex_arr(@TEXTCMDEXCL); + } + + + if ($showconfig) { + print "Configuration variables:\n"; + print "ARRENV=$ARRENV\n"; + print "COUNTERCMD=$COUNTERCMD\n"; + print "FLOATENV=$FLOATENV\n"; + print "ITEMCMD=$ITEMCMD\n"; + print "LISTENV=$LISTENV\n"; + print "MATHARRENV=$MATHARRENV\n"; +# print "MATHARRREPL=$MATHARRREPL\n"; # this is not deprecated and thus no longer shown + print "MATHENV=$MATHENV\n"; + print "MATHREPL=$MATHREPL\n"; + print "MINWORDSBLOCK=$MINWORDSBLOCK\n"; + print "PICTUREENV=$PICTUREENV\n"; + print "SCALEDELGRAPHICS=$SCALEDELGRAPHICS\n"; + print "VERBATIMENV=$VERBATIMENV\n"; + print "VERBATIMLINEENV=$VERBATIMLINEENV\n"; + print "CUSTOMDIFCMD=$CUSTOMDIFCMD\n"; + } +} + + + +## guess_encoding(filename) +## reads the first 20 lines of filename and looks for call of inputenc package +## if found, return the option of this package (encoding), otherwise return utf8 +sub guess_encoding { + my ($filename)=@_; + my ($i,$enc); + open (FH, $filename) or die("Couldn't open $filename: $!"); + $i=0; + while () { + next if /^\s*%/; # skip comment lines + if (m/\\usepackage\[(\w*?)\]\{inputenc\}/) { + close(FH); + return($1); + } + last if (++$i > 20 ); # scan at most 20 non-comment lines + } + close(FH); + ### return("ascii"); + return("utf8"); +} + + +sub read_file_with_encoding { + my ($output); + my ($filename, $encoding) = @_; + + if (lc($encoding) eq "utf8" ) { + open (FILE, "<:utf8",$filename) or die("Couldn't open $filename: $!"); + local $/ ; # locally set record operator to undefined, ie. enable whole-file mode + $output=; + } elsif ( lc($encoding) eq "ascii") { + open (FILE, $filename) or die("Couldn't open $filename: $!"); + local $/ ; # locally set record operator to undefined, ie. enable whole-file mode + $output=; + } else { + require Encode; + open (FILE, "<",$filename) or die("Couldn't open $filename: $!"); + local $/ ; # locally set record operator to undefined, ie. enable whole-file mode + $output=; + print STDERR "Converting $filename from $encoding to utf8\n" if $verbose; + $output=Encode::decode($encoding,$output); + } + close FILE; + if ($^O eq "linux" ) { + $output =~ s/\r\n/\n/g ; + } + return $output; +} + +## %packages=list_packages(@preamble) +## scans the arguments for \documentclass,\RequirePackage and \usepackage statements and constructs a hash +## whose keys are the included packages, and whose values are the associated optional arguments +#sub list_packages { +# my (@preamble)=@_; +# my %packages=(); +# foreach $line ( @preamble ) { +# # get rid of comments +# $line=~s/(?rel2abs( $filename ) ; + ($ignore, $dirname, $fileonly) = File::Spec->splitpath($filename) ; + $bblfile = $filename; + $bblfile=~s/\.tex$//; + $bblfile.=".bbl"; + + if ( ($includeonly) = ($preamble =~ m/\\includeonly\{(.*?)\}/ ) ) { + $includeonly =~ s/,/|/g; + } else { + $includeonly = '.*?'; + } + + print STDERR "DEBUG: includeonly $includeonly\n" if $debug; + + + # Run through filter, to let filterscript have a pass if it was set + $text = filter($text); + + # Recursively replace \\import, \\subimport, and related import commands + $text =~ s/(^(?:[^%\n]|\\%)*)(\\(sub)?(?:import|inputfrom|includefrom))\{(.*?)\}(?:[\s]*)\{(.*?)\}/{ + # (--------1-------)(--(=3=)-------------2-------------------) (-4-) (-5-) + # $1 is begline + # $2 is the import macro name + # $3 is (optional) prefix "sub" + # $4 is directory + # $5 is filename + $begline = (defined($1)? $1 : ""); + $subdir = $4; + $fname = $5; + $fname .= ".tex" unless $fname =~ m|\.\w{3,4}$|; + print STDERR "DEBUG begline:", $begline, "\n" if $debug; + print STDERR "DEBUG", (defined($3)? "subimport_file:" : "import_file:"), $subdir, "\n" if $debug; + print STDERR "DEBUG file:", $fname, "\n" if $debug; + + # subimport appends $subdir to the current $dirname. import replaces it with an absolute path. + $subdirfull = (defined($3) ? File::Spec->catdir($dirname,$subdir) : $subdir); + + $importfilepath = File::Spec->catfile($subdirfull, $fname); + + print STDERR "importing importfilepath:", $importfilepath,"\n" if $verbose; + if ( -f $importfilepath ) { + # If file exists, replace input or include command with expanded input + #TODO: need remove_endinput & newpage similar to other replacements inside flatten + $replacement=flatten(read_file_with_encoding($importfilepath, $encoding), $preamble,$importfilepath,$encoding); + } else { + # if file does not exist, do not expand include or input command (do not warn if fname contains #[0-9] as it is then likely part of a command definition + # and is not meant to be expanded directly + print STDERR "WARNING: Could not find included file ",$importfilepath,". I will continue but not expand |$2|\n"; + $replacement = $2; + $replacement .= "{$subdir}{$fname} % Processed"; + } + "$begline$replacement"; + }/exgm; + + # recursively replace \\input and \\include files + $text =~ s/(^(?:[^%\n]|\\%)*)(\\input\{(.*?)\}|\\include\{(${includeonly}(?:\.tex)?)\})/{ + $begline=(defined($1)? $1 : "") ; + $inputcmd=$2; + $fname = $3 if defined($3) ; + $fname = $4 if defined($4) ; + $newpage=(defined($4)? " \\newpage " : "") ; + # # add tex extension unless there is a three or four letter extension already + $fname .= ".tex" unless $fname =~ m|\.\w{3,4}$|; + $fullfile = File::Spec->catfile($dirname,$fname); + print STDERR "DEBUG Beg of line match |$1|\n" if defined($1) && $debug ; + print STDERR "Include file $fname\n" if $verbose; + print STDERR "DEBUG looking for file ",$fullfile, "\n" if $debug; + # content of file becomes replacement value (use recursion), add \newpage if the command was include + if ( -f $fullfile ) { + # If file exists, replace input or include command with expanded input + $replacement=flatten(read_file_with_encoding($fullfile, $encoding), $preamble,$filename,$encoding); + $replacement = remove_endinput($replacement); + # \include always starts a new page; use explicit \newpage command to simulate this + } else { + # if file does not exist, do not expand include or input command (do not warn if fname contains #[0-9] as it is then likely part of a command definition + # and is not meant to be expanded directly + print STDERR "WARNING: Could not find included file ",$fullfile,". I will continue but not expand |$inputcmd|\n" unless $fname =~ m(#[0-9]) ; + $replacement = $inputcmd ; # i.e. just the original command again -> make no change file does not exist + $newpage=""; + } + "$begline$newpage$replacement$newpage"; + }/exgm; + + # replace bibliography with bbl file if it exists + $text=~s/(^(?:[^%\n]|\\%)*)\\bibliography\{(.*?)\}/{ + if ( -f $bblfile ){ + $replacement=read_file_with_encoding(File::Spec->catfile($bblfile), $encoding); + } else { + warn "Bibliography file $bblfile cannot be found. No flattening of \\bibliography done. Run bibtex on old and new files first"; + $replacement="\\bibliography{$2}"; + } + $begline=(defined($1)? $1 : "") ; + "$begline$replacement"; + }/exgm; + + # replace subfile with contents (subfile package) + $text=~s/(^(?:[^%\n]|\\%)*)\\subfile\{(.*?)\}/{ + $begline=(defined($1)? $1 : "") ; + $fname = $2; + # # add tex extension unless there is a three or four letter extension already + $fname .= ".tex" unless $fname =~ m|\.\w{3,4}|; + print STDERR "Include file as subfile $fname\n" if $verbose; + # content of file becomes replacement value (use recursion) + # now strip away everything outside and including \begin{document} and \end{document} pair# + # # note: no checking for comments is made + $fullfile=File::Spec->catfile($dirname,$fname); + if ( -f $fullfile) { + # if file exists, expand \subfile command by contents of file + $subfile=read_file_with_encoding($fullfile,$encoding) or die "Could not open included subfile ",$fullfile,": $!"; + ($subpreamble,$subbody,$subpost)=splitdoc($subfile,'\\\\begin\{document\}','\\\\end\{document\}'); + ### $subfile=~s|^.*\\begin{document}||s; + ### $subfile=~s|\\end{document}.*$||s; + $replacement=flatten($subbody, $preamble,$fullfile,$encoding); + ### $replacement = remove_endinput($replacement); + } else { + # if file does not exist, do not expand subfile + print STDERR "WARNING: Could not find subfile ",$fullfile,". I will continue but not expand |$2|\n" unless $fname =~ m(#[0-9]) ; + $replacement = "\\subfile\{$2\}" ; # i.e. just the original command again -> make no change file does not exist + } + + "$begline$replacement"; + }/exgm; + + # replace \verbatiminput and \lstlistinginput + $text=~s/(^(?:[^%\n]|\\%)*)\\(verbatiminput\*?|lstinputlisting)$extraspace(\[$brat_n\])?$extraspace\{(.*?)\}/{ + $begline=(defined($1)? $1 : "") ; + $command = $2 ; + $fname = $4 ; + $verboptions = defined($3)? $3 : "" ; + if ($command eq 'verbatiminput' ) { + $verbenv = "verbatim" ; + } elsif ($command eq 'verbatiminput*' ) { + $verbenv = "verbatim*" ; + } elsif ($command eq 'lstinputlisting' ) { + $verbenv = "lstlisting" ; + } else { + die "Internal errorL Unexpected verbatim input type $command.\n"; + } + print STDERR "DEBUG Beg of line match |$begline|\n" if $debug ; + print STDERR "Include file $fname verbatim\n" if $verbose; + print STDERR "DEBUG looking for file ",File::Spec->catfile($dirname,$fname), "\n" if $debug; + # content of file becomes replacement value (do not use recursion), add \newpage if the command was include + ###$replacement=read_file_with_encoding(File::Spec->catfile($dirname,$fname), $encoding) or die "Couldn't find file ",File::Spec->catfile($dirname,$fname),": $!"; + $replacement=read_file_with_encoding(File::Spec->catfile($dirname,$fname), $encoding); # (cannot on apparent failure as this triggers for empty fie. Original: or die "Couldn't find file ",File::Spec->catfile($dirname,$fname),": $!"; + # Add a new line if it not already there (note that the matching operator needs to use different delimiters, as we are still inside an outer scope that takes precedence + $replacement .= "\n" unless $replacement =~ m(\n$) ; + "$begline\\begin{$verbenv}$verboptions\n$replacement\\end{$verbenv}\n"; + }/exgm; + + return($text); +} + + +# print_regex_arr(@arr) +# prints regex array without x-ism expansion put in by pearl to stdout +sub print_regex_arr { + my $dumstring; + $dumstring = join(" ",@_); # PERL generates string (?-xism:^ref$) for quoted refex ^ref$ + $dumstring =~ s/\(\?-xism:\^(.*?)\$\)/$1/g; # remove string and ^,$ marks before output + print $dumstring,"\n"; +} + + +# @lines=extrapream($type,...) +# reads line from appendix or external file +# (end of file after __END__ token) +# if $type is a filename, it will read the file instead of reading from the appendix +# otherwise it will screen appendix for line "%DIF $TYPE" and copy everything up to line +# '%DIF END $TYPE' (where $TYPE is upcased version of $type) +# extrapream('-nofail',$type) will---instead of failing---simply return nothing if +# it does not find the matching line in appendix (do not use -nofail option with multiple types!) +sub extrapream { + my @types=@_; + my ($type,$arg); + my $nofail=0; + ###my @retval=("%DIF PREAMBLE EXTENSION ADDED BY LATEXDIFF") ; + my @retval=(); + my ($copy); + + foreach $arg ( @types ) { + if ( $arg eq '-nofail' ) { + $nofail=1; + next; + } + $type=$arg; + $copy=0; + if ( -f $type || lc $type eq '/dev/null' ) { + print STDERR "Reading preamble file $type\n" if $verbose ; + open (FILE,$type) or die "Cannot open preamble file $type: $!"; + if (defined($encoding)) { + binmode(FILE,":encoding($encoding)"); + } else { + require Encode::Locale; + binmode(FILE,":encoding(locale)"); + } + while () { + chomp ; + if ( $_ =~ m/%DIF PREAMBLE/ ) { + push (@retval,"$_"); + } else { + push (@retval,"$_ %DIF PREAMBLE"); + } + } + } else { # not (-f $type) + $type=uc($type); # upcase argument + print STDERR "Preamble Internal Type $type\n" if $verbose; + # save filehandle position (before first read this points to line after __END__) + # but seek DATA,0,0 resets it to the beginning of the file + # see https://stackoverflow.com/questions/4459601/how-can-i-use-data-twice + my $data_start = tell DATA; + while () { + if ( m/^%DIF $type/ ) { + $copy=1; + } elsif ( m/^%DIF END $type/ ) { + last; + } + chomp; + push (@retval,"$_ %DIF PREAMBLE") if $copy; + } + if ( $copy == 0 ) { + unless ($nofail) { + print STDERR "\nPreamble style $type not implemented.\n"; + print STDERR "Write latexdiff -h to get help with available styles\n"; + exit(2); + } + } + seek DATA,$data_start,0; # rewind DATA handle to beginning of data record + } + } + ###push (@retval,"%DIF END PREAMBLE EXTENSION ADDED BY LATEXDIFF") ; + return @retval; +} + + +# ($part1,$part2,$part3)=splitdoc($text,$word1,$word2) +# splits $text into 3 parts at $word1 and $word2. +# if neither $word1 nor $word2 exist, $part1 and $part3 are empty, $part2 is $text +# If only $word1 or $word2 exist but not the other, output an error message. + +# NB this version avoids $` and $' for performance reason although it only makes a tiny difference +# (in one test gain a tenth of a second for a 30s run) +sub splitdoc { + my ($text,$word1,$word2)=@_; + my ($part1,$part2,$part3)=("","",""); + my ($rest,$pos); + + if ( $text =~ m/(^[^%]*)($word1)/mg ) { + $pos=pos $text; + $part1=substr($text,0,$pos-length($2)); + $rest=substr($text,$pos); + if ( $rest =~ m/(^[^%]*)($word2)/mg ) { + $pos=pos $rest; + $part2=substr($rest,0,$pos-length($2)); + $part3=substr($rest,$pos); + } + else { + die "$word1 and $word2 not in the correct order or not present as a pair." ; + } + } else { + $part2=$text; + die "$word2 present but not $word1." if ( $text =~ m/(^[^%]*)$word2/ms ); + } + return ($part1,$part2,$part3); +} + + + + + +# bodydiff($old,$new) +sub bodydiff { + my ($oldwords, $newwords) = @_; + my @retwords; + + print STDERR "(",exetime()," s)\n","Splitting into latex tokens \n" if $verbose; + print STDERR "Parsing $oldfile \n" if $verbose; + my @oldwords = splitlatex($oldwords); + print STDERR "Parsing $newfile \n" if $verbose; + my @newwords = splitlatex($newwords); + + if ( $debug ) { + open(TOKENOLD,">","latexdiff.debug.tokenold"); + print TOKENOLD join("***\n",@oldwords); + close(TOKENOLD); + open(TOKENNEW,">","latexdiff.debug.tokennew"); + print TOKENNEW join("***\n",@newwords); + close(TOKENNEW); + } + + print STDERR "(",exetime()," s)\n","Pass 1: Expanding text commands and merging isolated identities with changed blocks " if $verbose; + pass1(\@oldwords, \@newwords); + + + print STDERR "(",exetime()," s)\n","Pass 2: inserting DIF tokens and mark up. " if $verbose; + if ( $debug ) { + open(TOKENOLD,">","latexdiff.debug.tokenold2"); + print TOKENOLD join("***\n",@oldwords); + close(TOKENOLD); + open(TOKENNEW,">","latexdiff.debug.tokennew2"); + print TOKENNEW join("***\n",@newwords); + close(TOKENNEW); + } + + @retwords=pass2(\@oldwords, \@newwords); + + return(@retwords); +} + + + + +# @words=splitlatex($string) +# split string according to latex rules +# Each element of words is either +# a word (including trailing spaces and punctuation) +# a latex command +# if there is white space in the beginning return that as first token +sub splitlatex { + my ($inputstring) = @_ ; + my $string=$inputstring ; + # if input is empty, return empty list + length($string)>0 or return (); + $string=~s/^(\s*)//s; + my $leadin=$1; + length($string)>0 or return ($leadin); + + my @retval=($string =~ m/$pat/osg); + + if (length($string) != length(join("",@retval))) { + print STDERR "\nWARNING: Inconsistency in length of input string and parsed string:\n This often indicates faulty or non-standard latex code.\n In many cases you can ignore this and the following warning messages.\n Note that character numbers in the following are counted beginning after \\begin{document} and are only approximate." unless $ignorewarnings; + print STDERR "DEBUG Original length ",length($string)," Parsed length ",length(join("",@retval)),"\n" if $debug; + print STDERR "DEBUG Input string: |$string|\n" if (length($string)<500) && $debug; + print STDERR "DEBUG Token parsing: |",join("+",@retval),"|\n" if (length($string)<500) && $debug ; + @retval=(); + # slow way only do this if other m//sg method fails + my $last = 0; + while ( $string =~ m/$pat/osg ) { + my $match=$&; + if ($last + length $& != pos $string ) { + my $pos=pos($string); + my $offset=30<$last ? 30 : $last; + my $dum=substr($string,$last-$offset,$pos-$last+2*$offset); + my $dum1=$dum; + my $cnt=$#retval; + my $i; + $dum1 =~ s/\n/ /g; + unless ($ignorewarnings) { + print STDERR "\n$dum1\n"; + print STDERR " " x 30,"^" x ($pos-$last)," " x 30,"\n"; + print STDERR "Missing characters near word " . (scalar @retval) . " character index: " . $last . "-" . pos($string) . " Length: " . length($match) . " Match: |$match| (expected match marked above).\n"; + } + # put in missing characters `by hand' + push (@retval, substr($dum,$offset,$pos-$last-length($match))); +# Note: there seems to be a bug in substr with utf8 that made the following line output substr which were too long, +# using dum instead appears to work +# push (@retval, substr($string,$last, pos($string)-$last-length($match))); + } + push (@retval, $match); + $last=pos $string; + } + + } + + unshift(@retval,$leadin) if (length($leadin)>0); + return @retval; +} + + +# pass1( \@seq1,\@seq2) +# Look for differences between seq1 and seq2. +# Where an common-subsequence block is flanked by deleted or appended blocks, +# and is shorter than $MINWORDSBLOCK words it is appended +# to the last deleted or appended word. If the block contains tokens other than words +# or punctuation it is not merged. +# Deleted or appended block consisting of words and safe commands only are +# also merged, to prevent break-up in pass2 (after previous isolated words have been removed) +# If there are commands with textual arguments (e.g. \caption) both in corresponding +# appended and deleted blocks split them such that the command and opening bracket +# are one token, then the rest is split up following standard rules, and the closing +# bracket is a separate token, ie. turn +# "\caption{This is a textual argument}" into +# ("\caption{","This ","is ","a ","textual ","argument","}") +# No return value. Destructively changes sequences +sub pass1 { + my $seq1 = shift ; + my $seq2 = shift ; + + my $len1 = scalar @$seq1; + my $len2 = scalar @$seq2; + my $wpat=qr/^(?:[a-zA-Z.,'`:;?()!]*)[\s~]*$/; #' + + my ($last1,$last2)=(-1,-1) ; + my $cnt=0; + my $block=[]; + my $addblock=[]; + my $delblock=[]; + my $todo=[]; + my $instruction=[]; + my $i; + my (@delmid,@addmid,@dummy); + + my ($addcmds,$delcmds,$matchindex); + my ($addtextblocks,$deltextblocks); + my ($addtokcnt,$deltokcnt,$mattokcnt)=(0,0,0); + my ($addblkcnt,$delblkcnt,$matblkcnt)=(0,0,0); + + my $adddiscard = sub { + if ($cnt > 0 ) { + $matblkcnt++; + # just after an unchanged block +# print STDERR "Unchanged block $cnt, $last1,$last2 \n"; + if ($cnt < $MINWORDSBLOCK + && $cnt==scalar ( + grep { /^$wpat/ || ( /^\\((?:[`'^"~=.]|[\w\d@*]+))((?:\[$brat_n\]|\{$pat_n\})*)/o + && iscmd($1,\@SAFECMDLIST,\@SAFECMDEXCL) + && scalar(@dummy=split(" ",$2))<3 ) } + @$block) ) { + # merge identical blocks shorter than $MINWORDSBLOCK + # and only containing ordinary words + # with preceding different word + # We cannot carry out this merging immediately as this + # would change the index numbers of seq1 and seq2 and confuse + # the algorithm, instead we store in @$todo where we have to merge + push(@$todo, [ $last1,$last2,$cnt,@$block ]); + } + $block = []; + $cnt=0; $last1=-1; $last2=-1; + } + }; + my $discard=sub { $deltokcnt++; + &$adddiscard; #($_[0],$_[1]); + push(@$delblock,[ $seq1->[$_[0]],$_[0] ]); + $last1=$_[0] }; + + my $add = sub { $addtokcnt++; + &$adddiscard; #($_[0],$_[1]); + push(@$addblock,[ $seq2->[$_[1]],$_[1] ]); + $last2=$_[1] }; + + my $match = sub { $mattokcnt++; + if ($cnt==0) { # first word of matching sequence after changed sequence or at beginning of word sequence + $deltextblocks = extracttextblocks($delblock); + $delblkcnt++ if scalar @$delblock; + $addtextblocks = extracttextblocks($addblock); + $addblkcnt++ if scalar @$addblock; + + # make a list of all TEXTCMDLIST commands in deleted and added blocks + $delcmds = extractcommands($delblock); + $addcmds = extractcommands($addblock); + # now find those text commands, which are found in both deleted and added blocks, and expand them + # keygen(third argument of _longestCommonSubsequence) implies to sort on command (0th elements of $addcmd elements) + # the calling format for longestCommonSubsequence has changed between versions of + # Algorithm::Diff so we need to check which one we are using + if ( $algodiffversion > 1.15 ) { + ### Algorithm::Diff 1.19 + $matchindex=Algorithm::Diff::_longestCommonSubsequence($delcmds,$addcmds, 0, sub { $_[0]->[0] } ); + } else { + ### Algorithm::Diff 1.15 + $matchindex=Algorithm::Diff::_longestCommonSubsequence($delcmds,$addcmds, sub { $_[0]->[0] } ); + } + + for ($i=0 ; $i<=$#$matchindex ; $i++) { + if (defined($matchindex->[$i])){ + $j=$matchindex->[$i]; + @delmid=splitlatex($delcmds->[$i][3]); + @addmid=splitlatex($addcmds->[$j][3]); + while (scalar(@$deltextblocks) && $deltextblocks->[0][0]<$delcmds->[$i][1]) { + my ($index,$block,$cnt)=@{ shift(@$deltextblocks) }; + push(@$todo, [$index,-1,$cnt,@$block]); + } + push(@$todo, [ $delcmds->[$i][1],-1,-1,$delcmds->[$i][2],@delmid,$delcmds->[$i][4]]); + + while (scalar(@$addtextblocks) && $addtextblocks->[0][0]<$addcmds->[$j][1]) { + my ($index,$block,$cnt)=@{ shift(@$addtextblocks) }; + push(@$todo, [-1,$index,$cnt,@$block]); + } + push(@$todo, [ -1,$addcmds->[$j][1],-1,$addcmds->[$j][2],@addmid,$addcmds->[$j][4]]); + } + } + # mop up remaining textblocks + while (scalar(@$deltextblocks)) { + my ($index,$block,$cnt)=@{ shift(@$deltextblocks) } ; + push(@$todo, [$index,-1,$cnt,@$block]); + } + while (scalar(@$addtextblocks)) { + my ($index,$block,$cnt)=@{ shift(@$addtextblocks) }; + push(@$todo, [-1,$index,$cnt,@$block]); + } + + $addblock=[]; + $delblock=[]; + } + push(@$block,$seq2->[$_[1]]); + $cnt++ }; + + my $keyfunc = sub { join(" ",split(" ",shift())) }; + + traverse_sequences($seq1,$seq2, { MATCH=>$match, DISCARD_A=>$discard, DISCARD_B=>$add }, $keyfunc ); + + + # now carry out the merging/splitting. Refer to elements relative from + # the end (with negative indices) as these offsets don't change before the instruction is executed + # cnt>0: merged small unchanged groups with previous changed blocks + # cnt==-1: split textual commands into components + foreach $instruction ( @$todo) { + ($last1,$last2,$cnt,@$block)=@$instruction ; + if ($cnt>=0) { + splice(@$seq1,$last1-$len1,1+$cnt,join("",$seq1->[$last1-$len1],@$block)) if $last1>=0; + splice(@$seq2,$last2-$len2,1+$cnt,join("",$seq2->[$last2-$len2],@$block)) if $last2>=0; + } else { + splice(@$seq1,$last1-$len1,1,@$block) if $last1>=0; + splice(@$seq2,$last2-$len2,1,@$block) if $last2>=0; + } + } + + if ($verbose) { + print STDERR "\n"; + print STDERR " $mattokcnt matching tokens in $matblkcnt blocks.\n"; + print STDERR " $deltokcnt discarded tokens in $delblkcnt blocks.\n"; + print STDERR " $addtokcnt appended tokens in $addblkcnt blocks.\n"; + } +} + + +# extracttextblocks(\@blockindex) +# $blockindex has the following format +# [ [ token1, index1 ], [token2, index2],.. ] +# where index refers to the index in the original old or new word sequence +# Returns: reference to an array of the form +# [[ $index, $textblock, $cnt ], .. +# where $index index of block to be merged +# $textblock contains all the words to be merged with the word at $index (but does not contain this word) +# $cnt is length of block +# +# requires: iscmd +# +sub extracttextblocks { + my $block=shift; + my ($i,$token,$index); + my $textblock=[]; + my $last=-1; + my $wpat=qr/^(?:[a-zA-Z.,'`:;?()!]*)[\s~]*$/; #' + my $retval=[]; + + # we redefine locally $extraspace (shadowing the global definition) to capture command sequences with intervening spaces no matter what the global setting + # this is done so we can capture those commands with a predefined number of arguments without having to introduce them again explicitly here + my $extraspace='\s*'; + + for ($i=0;$i< scalar @$block;$i++) { + ($token,$index)=@{ $block->[$i] }; + # store pure text blocks + if ($token =~ /$wpat/ || ( $token =~/^\\((?:[`'^"~=.]|[\w\d@\*]+))((?:${extraspace}\[$brat_n\]${extraspace}|${extraspace}\{$pat_n\})*)/ + && iscmd($1,\@SAFECMDLIST,\@SAFECMDEXCL) + && !iscmd($1,\@TEXTCMDLIST,\@TEXTCMDEXCL))) { + # we have text or a command which can be treated as text + if ($last<0) { + # new pure-text block + $last=$index; + } else { + # add to pure-text block + push(@$textblock, $token); + } + } else { + # it is not text + if (scalar(@$textblock)) { + push(@$retval,[ $last, $textblock, scalar(@$textblock) ]); + } + $textblock=[]; + $last=-1; + } + } + # finish processing a possibly unfinished block before returning + if (scalar(@$textblock)) { + push(@$retval,[ $last, $textblock, scalar(@$textblock) ]); + } + return($retval) +} + + + +# extractcommands( \@blockindex ) +# $blockindex has the following format +# [ [ token1, index1 ], [token2, index2],.. ] +# where index refers to the index in the original old or new word sequence +# Returns: reference to an array of the form +# [ [ "\cmd1", index, "\cmd1[optarg]{arg1}{", "arg2" ,"} " ],.. +# where index is just taken from input array +# command must have a textual argument as last argument +# +# requires: iscmd +# +sub extractcommands { + my $block=shift; + my ($i,$token,$index,$cmd,$open,$mid,$closing); + my $retval=[]; + + # we redefine locally $extraspace (shadowing the global definition) to capture command sequences with intervening spaces no matter what the global setting + # this is done so we can capture those commands with a predefined number of arguments without having to introduce them again explicitly here + my $extraspace='\s*'; + + for ($i=0;$i< scalar @$block;$i++) { + ($token,$index)=@{ $block->[$i] }; + # check if token is an alphanumeric command sequence with at least one non-optional argument + # \cmd[...]{...}{last argument} + # Capturing in the following results in these associations + # $1: \cmd[...]{...}{ + # $2: \cmd + # $3: last argument + # $4: } + trailing spaces + if ( ( $token =~ m/^(\\([\w\d\*]+)(?:${extraspace}\[$brat_n\]|${extraspace}\{$pat_n\})*${extraspace}\{)($pat_n)(\}\s*)$/so ) + && iscmd($2,\@TEXTCMDLIST,\@TEXTCMDEXCL) ) { + print STDERR "DEBUG EXTRACTCOMMANDS Match |$1|$2|$3|$4|$index \n" if $debug; + # push(@$retval,[ $2,$index,$1,$3,$4 ]); + ($cmd,$open,$mid,$closing) = ($2,$1,$3,$4) ; + $closing =~ s/\}/\\RIGHTBRACE/ ; + push(@$retval,[ $cmd,$index,$open,$mid,$closing ]); + } + } + return $retval; +} + +# iscmd($cmd,\@regexarray,\@regexexcl) checks +# return 1 if $cmd matches any of the patterns in the +# array $@regexarray, and none of the patterns in \@regexexcl, otherwise return 0 +sub iscmd { + my ($cmd,$regexar,$regexexcl)=@_; + my ($ret)=0; + ### print STDERR "DEBUG: iscmd($cmd)=" if $debug; + foreach $pat ( @$regexar ) { + if ( $cmd =~ m/^${pat}$/ ) { + $ret=1 ; + last; + } + } + ### print STDERR "0\n" if ($debug && !$ret) ; + return 0 unless $ret; + foreach $pat ( @$regexexcl ) { + ### print STDERR "0\n" if ( $debug && $cmd =~ m/^${pat}$/) ; + return 0 if ( $cmd =~ m/^${pat}$/ ); + } + ### print STDERR "1\n" if $debug; + return 1; +} + + +# pass2( \@seq1,\@seq2) +# Look for differences between seq1 and seq2. +# Mark begin and end of deleted and appended sequences with tags $DELOPEN and $DELCLOSE +# and $ADDOPEN and $ADDCLOSE, respectively, however exclude { } & and all comands, unless +# they match an element of the whitelist (SAFECMD) +# For words in TEXTCMD but not in SAFECMD, enclose interior with $ADDOPEN and $ADDCLOSE brackets +# Deleted comment lines are marked with %DIF < +# Added comment lines are marked with %DIF > +sub pass2 { + my $seq1 = shift ; + my $seq2 = shift ; + + my ($addtokcnt,$deltokcnt,$mattokcnt)=(0,0,0); + my ($addblkcnt,$delblkcnt,$matblkcnt)=(0,0,0); + + my $retval = []; + my $delhunk = []; + my $addhunk = []; + + my $discard = sub { $deltokcnt++; + push ( @$delhunk, $seq1->[$_[0]]) }; + + my $add = sub { $addtokcnt++; + push ( @$addhunk, $seq2->[$_[1]]) }; + + my $match = sub { $mattokcnt++; + if ( scalar @$delhunk ) { + $delblkcnt++; + # mark up changes, but comment out commands + push @$retval,marktags($DELMARKOPEN,$DELMARKCLOSE,$DELOPEN,$DELCLOSE,$DELCMDOPEN,$DELCMDCLOSE,$DELCOMMENT,$delhunk); + $delhunk = []; + } + if ( scalar @$addhunk ) { + $addblkcnt++; + # we mark up changes, but simply quote commands + push @$retval,marktags($ADDMARKOPEN,$ADDMARKCLOSE,$ADDOPEN,$ADDCLOSE,"","",$ADDCOMMENT,$addhunk); + $addhunk = []; + } + push(@$retval,$seq2->[$_[1]]) }; + + my $keyfunc = sub { join(" ",split(" ",shift())) }; + + traverse_sequences($seq1,$seq2, { MATCH=>$match, DISCARD_A=>$discard, DISCARD_B=>$add }, $keyfunc ); + # clear up unprocessed hunks + push @$retval,marktags($DELMARKOPEN,$DELMARKCLOSE,$DELOPEN,$DELCLOSE,$DELCMDOPEN,$DELCMDCLOSE,$DELCOMMENT,$delhunk) if scalar @$delhunk; + push @$retval,marktags($ADDMARKOPEN,$ADDMARKCLOSE,$ADDOPEN,$ADDCLOSE,"","",$ADDCOMMENT,$addhunk) if scalar @$addhunk; + + + if ($verbose) { + print STDERR "\n"; + print STDERR " $mattokcnt matching tokens. \n"; + print STDERR " $deltokcnt discarded tokens in $delblkcnt blocks.\n"; + print STDERR " $addtokcnt appended tokens in $addblkcnt blocks.\n"; + } + return(@$retval); +} + +# marktags($openmark,$closemark,$open,$close,$opencmd,$closecmd,$comment,\@block) +# returns ($openmark,$open,$block,$close,$closemark) if @block contains no commands (except white-listed ones), +# braces, ampersands, or comments +# mark comments with $comment +# exclude all other exceptions from scope of open, close like this +# ($openmark, $open,...,$close, $opencmd,command, command,$closecmd, $open, ..., $close, $closemark) +# If $opencmd begins with "%" marktags assumes it is operating on a deleted block, otherwise on an added block +sub marktags { + my ($openmark,$closemark,$open,$close,$opencmd,$closecmd,$comment,$block)=@_; + my $word; + my (@argtext); + my $retval=[]; + my $noncomment=0; + my $cmd=-1; # -1 at beginning 0: last token written is a ordinary word + # 1: last token written is a command + # for keeping track whether we are just in a command sequence or in a word sequence + my $cmdcomment= ($opencmd =~ m/^%/); # Flag to indicate whether opencmd is a comment (i.e. if we intend to simply comment out changed commands) + my ($command,$commandword,$closingbracket) ; # temporary variables needed below to remember sub-pattern matches + + + +# split this block to split sequences joined in pass1 + ### print STDERR "DEBUG: marktags before splitlatex blocksplit ",join("|",@$block),"\n" if $debug; + @$block=splitlatex(join "",@$block); + ### print STDERR "DEBUG: marktags $openmark,$closemark,$open,$close,$opencmd,$closecmd,$comment\n" if $debug; + print STDERR "DEBUG: after splitlatex ",join("|",@$block),"\n" if $debug; + + # we redefine locally $extraspace (shadowing the global definition) to capture command sequences with intervening spaces no matter what the global setting + # this is done so we can capture those commands with a predefined number of arguments without having to introduce them again explicitly here + my $extraspace_mt='\s*'; + + + foreach (@$block) { + $word=$_; + if ( $word =~ s/^%/%$comment/ ) { + # a comment + if ($cmd==1) { + push (@$retval,$closecmd) ; + $cmd=-1; + } + push (@$retval,$word); + next; + } + if ( $word =~ m/^\s*$/ ) { + ### print STDERR "DEBUG MARKTAGS: whitespace detected |$word| cmdcom |$cmdcomment| |$opencmd|\n" if $debug; + # a sequence of white-space characters - this should only ever happen for the first element of block. + # in deleted block, omit, otherwise just copy it in + if ( ! $cmdcomment) { # ignore in deleted blocks + push(@$retval,$word); + } + next; + } + if (! $noncomment) { + push (@$retval,$openmark); + $noncomment=1; + } + # negative lookahead pattern (?!) in second clause is put in to avoid matching \( .. \) patterns + # also note that second pattern will match \\ + if ( $word =~ /^[&{}\[\]]/ || ( $word =~ /^\\(?!\()(\\|[`'^"~=.]|[\w*@]+)/ && !iscmd($1,\@SAFECMDLIST,\@SAFECMDEXCL)) ) { + ### if ( $word =~ /^[&{}\[\]]/ || ( $word =~ /^\\([\w*@\\% ]+)/ && !iscmd($1,\@SAFECMDLIST,\@SAFECMDEXCL)) ) { + # word is a command or other significant token (not in SAFECMDLIST) + ## same conditions as in subroutine extractcommand: + # check if token is an alphanumeric command sequence with at least one non-optional argument + # \cmd[...]{...}{last argument} + # Capturing in the following results in these associations + # $1: \cmd[...]{...}{ + # $2: cmd + # $3: last argument + # $4: } + trailing spaces + ### pre-0.3 if ( ( $token =~ m/^(\\([\w\d\*]+)(?:\[$brat0\]|\{$pat_n\})*\{)($pat_n)(\}\s*)$/so ) + if ( ( $word =~ m/^(\\([\w\d\*]+)(?:${extraspace_mt}\[$brat_n\]|${extraspace_mt}\{$pat_n\})*${extraspace_mt}\{)($pat_n)(\}\s*)$/so ) + && (iscmd($2,\@TEXTCMDLIST,\@TEXTCMDEXCL)|| iscmd($2,\@MATHTEXTCMDLIST,\@MATHTEXTCMDEXCL)) + && ( !$cmdcomment || !iscmd($2,\@CONTEXT2CMDLIST, \@CONTEXT2CMDEXCL) ) ) { + # Condition 1: word is a command? - if yes, $1,$2,.. will be set as above + # Condition 2: word is a text command - we mark up the interior of the word. There is a separate check for MATHTEXTCMDLIST + # because for $mathmarkup=WHOLE, the commands should not be split in pass1 (ie. math mode commands are not in + # TEXTCMDLIST, but the interior of MATHTEXT commnds should be highlighted in both deleted and added blocks + # Condition 3: But if we are in a deleted block ($cmdcomment=1) and + # $2 (the command) is in context2, just treat it as an ordinary command (i.e. comment it open with $opencmd) + # Because we do not want to disable this command + # here we do not use $opencmd and $closecmd($opencmd is empty) + print STDERR "DEBUG: Detected text |$word| but not safe command \$2: $2 \$3: $3\n." if $debug; + if ($cmd==1) { + push (@$retval,$closecmd) ; + } elsif ($cmd==0) { + push (@$retval,$close) ; + } + $command=$1; $commandword=$2; $closingbracket=$4; + @argtext=splitlatex($3); # split textual argument into tokens + # and mark it up (but we do not need openmark and closemark) + # insert command with initial arguments, marked-up final argument, and closing bracket + if ( $cmdcomment && iscmd($commandword,\@CONTEXT1CMDLIST, \@CONTEXT1CMDEXCL) ) { + # context1cmd in a deleted environment; delete command itself but keep last argument, marked up + push (@$retval,$opencmd); + $command =~ s/\n/\n${opencmd}/sg ; # repeat opencmd at the beginning of each line + # argument, note that the additional comment character is included + # to suppress linebreak after opening parentheses, which is important + # for latexrevise + push (@$retval,$command,"%\n{$AUXCMD\n",marktags("","",$open,$close,$opencmd,$closecmd,$comment,\@argtext),$closingbracket); + } elsif ( iscmd($commandword,,\@MATHTEXTCMDLIST, \@MATHTEXTCMDEXCL) ) { + # MATHBLOCK pseudo command: consider all commands safe, except & and \\, \begin and \end and a few package sprcific one (look at UNSAFEMATHCMD definition) + # Keep these commands even in deleted blocks, hence set $opencmd and $closecmd (5th and 6th argument of marktags) to + # "" + local @SAFECMDLIST=(".*"); + local @SAFECMDEXCL=('\\','\\\\',@UNSAFEMATHCMD); + push(@$retval,$command,marktags("","",$open,$close,"","",$comment,\@argtext)#@argtext + ,$closingbracket); + } else { + # normal textcmd or context1cmd in an added block + push (@$retval,$command,marktags("","",$open,$close,$opencmd,$closecmd,$comment,\@argtext),$closingbracket); + } + push (@$retval,$AUXCMD,"\n") if $cmdcomment ; + $cmd=-1 ; + } elsif ( $cmdcomment && + ( $word =~ m/^(\\([\w\d\*]+)(?:${extraspace_mt}\[$brat_n\]|${extraspace_mt}\{$pat_n\})*${extraspace_mt}\{)($pat_n)(\}\s*)/so ) + && iscmd($2,\@KEEPCMDLIST, \@KEEPCMDEXCL) ) { + # 'keepcmd' in a deleted environment: keep the command as is + push (@$retval,$close) if $cmd==0 ; + push (@$retval,$word); + $cmd=-1; # pretend we are at the beginning of a sequence because we do not want to add an additional $closecmd or $close before the next token, no matter what it is + } else { + # ordinary command + push (@$retval,$opencmd) if $cmd==-1 ; + push (@$retval,$close,$opencmd) if $cmd==0 ; + $word =~ s/\n/\n${opencmd}/sg if $cmdcomment ; # if opencmd is a comment, repeat this at the beginning of every line + ### print STDERR "MARKTAGS: Add command |$word|\n"; + push (@$retval,$word); + $cmd=1; + } + } else { + ###print STDERR "DEBUG MARKTAGS is an ordinary word or SAFECMD command \n" if $debug; + # just an ordinary word or command in SAFECMD + push (@$retval,$open) if $cmd==-1 ; + push (@$retval,$closecmd,$open) if $cmd==1 ; + ###TODO: check here if it is a command in MBOXCMD list, and surround it with \mbox{...} + ### $word =~ /^\\(?!\()(\\|[`'^"~=.]|[\w*@]+)/ && iscmd($1,\@MBOXCMDLIST,\@MBOXCMDEXCL)) + ### but actually this check has been carried out already so can simply check if word begins with backslash + if ( $word =~ /^\\(?!\()(\\|[`'^"~=.]|[\w*@]+)(.*?)(\s*)$/s && iscmd($1,\@MBOXCMDLIST,\@MBOXCMDEXCL)) { + # $word is a safe command in MBOXCMDLIST + ###print STDERR "DEBUG Mboxsafecmd detected:$word:\n" if $debug ; + push(@$retval,"\\mbox{$AUXCMD\n\\" . $1 . $2 . $3 ."}\\hskip0pt$AUXCMD\n" ); + } else { + # $word is a normal word or a safe command (not in MBOXCMDLIST) + push (@$retval,$word); + } + $cmd=0; + } + } + push (@$retval,$close) if $cmd==0; + push (@$retval,$closecmd) if $cmd==1; + + push (@$retval,$closemark) if ($noncomment); + return @$retval; +} + +#used in preprocess +sub take_comments_and_newline_from_frac() { + # some special magic for common usage of frac, which does not conform to the latexdiff requirements but can be made to fit + # note that this is a rare exception to the general rule that the new tex can be reconstructed from the diff file + + # regex that matches space and comment characters + my $space = qr/\s|%[^\n]*?/; + # \frac {abc} -> \frac{abc} + # \frac1 -> \frac{1} + # \frac a -> \frac{a} + # \frac \lambda -> \frac{\lambda} + s/\\frac(?|${space}+\{($pat_n)\}|${space}*(\d)|${space}+(\w)|${space}*(\\[a-zA-Z]+))/\\frac\{$1\}/g; + # same as above for the second argument of frac + s/\\frac(\{$pat_n\})(?|${space}*\{($pat_n)\}|${space}*(\d)|${space}+(\w)|${space}*(\\[a-zA-Z]+))/\\frac$1\{$2\}/g; +} + +# preprocess($string, ..) +# carry out the following pre-processing steps for all arguments: +# 1. Remove leading white-space +# Change \{ to \QLEFTBRACE and \} to \QRIGHTBRACE and \& to \AMPERSAND +# #. Change {,},\frac in comments to \CLEFTBRACE, \CRIGHTBRACE, \CFRAC +# 2. mark all first empty line (in block of several) with \PAR tokens +# 3. Convert all '\%' into '\PERCENTAGE ' and all '\$' into \DOLLAR to make parsing regular expressions easier +# 4. Convert all \verb|some verbatim text| commands (where | can be an arbitrary character) +# into \verb{hash} (also lstinline) +# 5. Convert \begin{verbatim} some verbatim text \end{verbatim} into \verbatim{hash} (not only verbatim, all patterns matching VERBATIMENV) +# 6. Convert _n into \SUBSCRIPTNB{n} and _{nnn} into \SUBSCRIPT{nn} +# 7. Convert ^n into \SUPERSCRIPTNB{n} and ^{nnn} into \SUPERSCRIPT{nn} +# 8. a. Convert $$ $$ into \begin{DOLLARDOLLAR} \end{DOLLARDOLLAR} +# b. Convert \[ \] into \begin{SQUAREBRACKET} \end{SQUAREBRACKET} +# 9. Convert all picture environmentent (\begin{PICTUREENV} .. \end{PICTUREENV} \PICTUREBLOCKenv +# For math-mode COARSE,WHOLE or NONE option -convert all \begin{MATH} .. \end{MATH} +# into \MATHBLOCKmath{...} commands, where MATH/math is any valid math environment + +# 10. Add final token STOP to the very end. This is put in because the algorithm works better if the last token is identical. This is removed again in postprocessing. +# +# NB: step 6 and 7 is likely to convert some "_" inappropriately, e.g. in file +# names or labels but it does not matter because they are converted back in the postprocessing step +# Returns: leading white space removed in step 1 +sub preprocess { + for (@_) { + + + # change in \verb and similar commands - note that I introduce an extra space here so that the + # already hashed variants do not trigger again + # transform \lstinline{...} +# s/\\lstinline(\[$brat0\])?(\{(?:.*?)\})/"\\DIFlstinline". $1 ."{". tohash(\%verbhash,"$2") ."}"/esg; +# s/\\lstinline(\[$brat0\])?((\S).*?\2)/"\\DIFlstinline". $1 ."{". tohash(\%verbhash,"$2") ."}"/esg; + s/\\lstinline((?:\[$brat_n\])?)(\{(?:.*?)\})/"\\DIFlstinline". $1 ."{". tohash(\%verbhash,"$2") ."}"/esg; + s/\\lstinline((?:\[$brat_n\])?)(([^\s\w]).*?\3)/"\\DIFlstinline". $1 ."{". tohash(\%verbhash,"$2") ."}"/esg; + s/\\(verb\*?|lstinline)([^\s\w])(.*?)\2/"\\DIF${1}{". tohash(\%verbhash,"${2}${3}${2}") ."}"/esg; + + # Change \{ to \QLEFTBRACE, \} to \QRIGHTBRACE, and \& to \AMPERSAND + s/(? brackets + # Example: \begin{alignat}{3} ... \end{alignat} will turn into \MATHBLOCKalignat[{3}]{ ... } + + if ( $mathmarkup != FINE ) { + # DIFANCHORARRB and DIFANCHORARRE, DIFANCHORMATHB and DIFANCHORMATHE markers are inserted here to encourage the matching algorithm + # to always match up the closing brace. Otherwise sometimes one ends up with a situation where + # the closing brace is deleted and added at another point. The deleted closing brace is then + # prevented by a %DIFDELCMD, leading to material leaking in or out of the math environment. + # The anchors are removed in post-processing again. (note that they are simple text to cause least amount of complications + # Admittedly, this is something of a hack and will not always work. If it does not, then one needs to + # resort to WHOLE or FINE, or NONE math mode processing. + s/\\begin\{($ARRENV)}(.*?)\\end\{\1}/\\ARRAYBLOCK$1\{$2\\DIFANCHORARRB \}\\DIFANCHORARRE /sg; + + take_comments_and_newline_from_frac(); + + # Convert Math environments with arguments + s/\\begin\{($MATHENV|$MATHARRENV|SQUAREBRACKET)\}((?:\[$brat_n\])|(?:\{$pat_n\}))+(.*?)\\end\{\1\}/\\MATHBLOCK$1\[$2\]\{$3\\DIFANCHORMATHB \}\\DIFANCHORMATHE /sg; + # Convert Math environments without arguments + s/\\begin\{($MATHENV|$MATHARRENV|SQUAREBRACKET)\}(.*?)\\end\{\1\}/\\MATHBLOCK$1\{$2\\DIFANCHORMATHB \}\\DIFANCHORMATHE /sg; + } + + # add final token " STOP" + $_ .= " STOP" + } +} + + +# $expanded=linecomment($string) +#preface all lines with verbatim marker (usually DIFVRB) +sub linecomment { + my @verbatimlines=split("\n",$_[0]); + # the first line needs special treatment - we do want to retain optional arguments as is but wrap the remainder also with VERBCOMMENT + ### print STDERR "DEBUG: before verbatimlines[0] = ",$verbatimlines[0],"\n"; + $verbatimlines[0]=~s/^((?:\s*\[$brat_n\])?\s*)([^\s\[].*)/ defined($2) ? ( "$1\%$VERBCOMMENT$2" ) : ( $1 )/e; + ### print STDERR "DEBUG: after verbatimlines[0] = ",$verbatimlines[0],"\n"; + return(join("\n%$VERBCOMMENT",@verbatimlines)."\n"); +} + +# $simple=reverselinecomment($env $string) +# remove DIFVRB comments but leave changed lines marked +sub reverselinecomment { + my ($environment, $verbatimtext)=@_; + ### print STDERR "DEBUG REVERSELINECOMMENT input: $environment,|$verbatimtext|\n" if $debug; + # remove markup added by latexdiff + # (this should occur only if the type of verbatim environment was changed) + # (note that this destroys some information in old file) + # in theory I could save it by moving it out of the verbatim environment + # but this requires more bookkeeping and is probably not necessary) + $verbatimtext =~ s/\\DIFaddbegin //g; + $verbatimtext =~ s/\\DIFaddend //g; + $verbatimtext =~ s/\\DIFdelbegin //g; + $verbatimtext =~ s/\\DIFdelend //g; + $verbatimtext =~ s/$DELCMDOPEN.*//g; + + # remove DIFVRB mark + $verbatimtext=~ s/%$VERBCOMMENT//g; + + # remove part of the markup in changed lines + # if any of these substitution was made, then there was at least + # one changed line, and we have to extend the style + if ( $verbatimtext=~ s/$VERBCOMMENT//g ) { + # in the next line we add ~alsolanguage~ modifier, but also deletes the rest of the line after the optional argument, as lstlisting commands gets sometimes + # very confused by what is there (and othertimes seems to ignore this anyway) + unless ( $verbatimtext =~ s/^(\s*)\[($brat_n)\](.*)\n/$1\[$2,alsolanguage=DIFcode\]\n/ ) { + if ( $verbatimtext =~ m/^\s*\n/ ) { + $verbatimtext = "[alsolanguage=DIFcode]" . $verbatimtext; + } else { + $verbatimtext = "[alsolanguage=DIFcode]\n" . $verbatimtext; + } + } + # There is a bug in listings package (at least v1.5b) for empty comments where the actual comment command is not made invisible + # I therefore have to introduce an artificial '-' character at the end of empty added or deleted lines + $verbatimtext =~ s/($DELCOMMENT\s*)$/$1-/mg; + $verbatimtext = "\\DIFmodbegin\n\\begin{${environment}}${verbatimtext}\\end{${environment}}\n\\DIFmodend" + } else { + $verbatimtext = "\\begin{${environment}}${verbatimtext}\\end{${environment}}" + } + ### print STDERR "DEBUG REVERSELINECOMMENT output: |$verbatimtext|\n" if $debug; + return($verbatimtext); +} + + +#hashstring=tohash(\%hash,$string) +# creates a hash value based on string and stores in %hash +sub tohash { + my ($hash,$string)=@_; + my (@arr,$val); + my ($sum,$i)=(0,1); + my ($hstr); + + @arr=unpack('c*',$string); + + while (1) { + foreach $val (@arr) { + $sum += $i*$val; + $i++; + } + $hstr= "$sum"; + last unless (defined($hash->{$hstr}) && $string ne $hash->{$hstr}); + # else found a duplicate HASH need to repeat for a higher hash value + } + $hash->{$hstr}=$string; + ### print STDERR "Hash:$hstr: Content:$string:\n"; + return($hstr); +} + +#string=fromhash(\%hash,$fromstring) +# restores string value stored in hash +#string=fromhash(\%hash,$fromstring,$prependstring) +# additionally begins each line with prependstring +sub fromhash { + my ($hash,$hstr)=($_[0],$_[1]); + my $retstr=$hash->{$hstr}; + if ( $#_ >= 2) { + $retstr =~ s/^/$_[2]/mg; + } + return $retstr; +} + +# stripdelcmpopen(string) +# return string with $DELCMDOPEN removed +sub stripdelcmdopen { + my ($str) = $_[0]; + $str =~ s/${DELCMDOPEN}//mg; + return $str; +} + +# writedebugfile(string, label) +# if $debug set writes to file latexdiff.debug.