lcfgdiff - compare profiles (or other files)
lcfgdiff [options] file file ...
This command is used by the LCFG test procedures to compare generated files with previous (known good) copies. It can compare XML, XHTML, text and DBM files.
Unless the strict option is used, strings are preprocessed before comparison by removing any text between the delimiters \[%% and %%\]. The LCFG buildtools defines the symbols _dl and _dr to be these delimiters at test time, and to be null when generating production releases. This means that test programs can enclose insignificant output inside these delimiters and it will be ignored when testing.
Individual applications can also define instances of the LCFG::Utils::Diff::Modules class. This allows additional type-specific preprocessing to be performed before comparisons. It allows other options to be controllde - for example ignoring the order of the tags at ceratin nodes in an XML document.
Debug.
The current domain. This is made available to type-specific modules.
Set file format. This is normally detected automatically and may be xml, text, dbm, or html.
Interactive mode. If the files are diferent, then a GUI interface is presented showing the differences and allowing several options.
Ignore differences in XML/XHTML element order.
Quiet mode - report difference by exit status only.
Strict string comparisons. Do not process delimiters.
The file type. The module LCFG::Utils::Diff::type is used to control comparisons. This must be a subclass of LCFG::Utils::Diff::Module.
Window title for interactive mode.
Force the destination file to be updated to match the source file withoout prompting. This can be used to update the "known" good copies of the test files when a tested change has been made.
Verbose.
Print usage mesage and exit.
Ignore differences in whitespace.
An X-aware editor to be used when the Edit button is pressed in interactive mode.
An X-aware diff program to be used when the Diff button is pressed in interactive mode.
An X-aware browser program to be used when the View button is pressed for HTML files.
This is the list of platforms on which we have tested this software. We expect this software to work on any Unix-like platform which is supported by Perl.
ScientificLinux6, EnterpriseLinux7, Debian
Please report any bugs or problems (or praise!) to bugs@lcfg.org, feedback and patches are also always very welcome.
Stephen Quinney <squinney@inf.ed.ac.uk>
Copyright (C) 2009-2019 University of Edinburgh. All rights reserved.
This library is free software; you can redistribute it and/or modify it under the terms of the GPL, version 2 or later.
To install LCFG::DB, copy and paste the appropriate command in to your terminal.
cpanm
cpanm LCFG::DB
CPAN shell
perl -MCPAN -e shell install LCFG::DB
For more information on module installation, please visit the detailed CPAN module installation guide.