lepton-schdiff(1)

NAME
lepton-schdiff - Graphical diff tool for schematics

SYNOPSIS
lepton-schdiff [-d VIEWER] infile1.sch infile2.sch

DESCRIPTION

The lepton-schdiff program will use ImageMagick(1) to display a graphical diff of two schematic files. It's most useful when combined with a revision control system so it can compare two revisions of the same file, review changes, etc. However, it is limited in that it can only compare two files at a time; it cannot diff entire directories nor can it diff an entire revision (unless that revision affected only one file).

VIEWER command, if specified, will be used to display the result. By default, it's display program from the ImageMagick package.

lepton-schdiff can easily be configured to work with most revision control systems. Here are instructions for three:

git: Use the difftool command exactly as you would use diff , but supply the -x lepton-schdiff option.

mercurial: Use the lepton-schdiff command exactly as you would use diff , but add the following lines to your .hgrc:

      [extensions]
      hgext.extdiff =
      [extdiff]
      cmd.schdiff = lepton-schdiff

subversion: Use the diff command like normal, but supply the --diff-cmd lepton-schdiff option.

Note: To make lepton-schdiff work properly, all page contents should be enclosed in some form of bounding box (e.g. a title block), otherwise the symbols in exported images could have different relative positions and/or sizes, resulting in a difference image that is rather hard to comprehend.

EXAMPLES

Use git to view the changes to a file between two revisions
    git difftool -x lepton-schdiff 182110f 039e012 cpu.sch

Use mercurial to see all the changes since a specific revision
    hg schdiff -r 8442880f9835 cpld.sch

Use subversion to review a specific revision
    svn diff --diff-cmd lepton-schdiff -c 49 power.sch

BUGS

If you find one, please report it at https://github.com/lepton-eda/lepton-eda/issues

AUTHOR

Alan Somers

SEE ALSO

composite(1), display(1), git(1), lepton-schematic(1), hg(1), svn(1)

COPYRIGHT
Copyright © 2011-2014 gEDA Contributors.
Copyright © 2018-2022 Lepton EDA Contributors.
License GPLv2+: GNU GPL version 2 or later. Please see the `COPYING'
file included with this program for full details.

This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.