lepton-schdiff(1)

🌸 lepton-schdiff — the manual page, but make it make sense 💅

okay bestie, so this is the manual for lepton-schdiff, which is a graphical diff tool for schematics ✨ — and yes, this is the one from Lepton EDA. Sit down, grab a boba, we're doing this 🧋

---

✨ NAME ✨

lepton-schdiff — Graphical diff tool for schematics 🎀

---

✨ SYNOPSIS ✨

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

---

✨ DESCRIPTION ✨

So here's the vibe: lepton-schdiff uses ImageMagick(1) to show you a graphical diff of two schematic files. 🦋

It's most useful when you pair it with a revision control system, because then it can compare two revisions of the same file, let you review changes, etc. 💖 But — and this is the catch — it's limited: it can only compare two files at a time. It cannot diff entire directories, and it cannot diff an entire revision (unless that revision happened to touch only one file). 🙈

If you pass a VIEWER command, that command is what gets used to display the result. By default it's the display program from the ImageMagick package. 👑

And the best part? lepton-schdiff can easily be configured to work with most revision control systems. Here's the tea for three of them:

🐙 git

Use the difftool command exactly like you'd use diff, but supply the -x lepton-schdiff option. periodt.

🧜 mercurial

Use the lepton-schdiff command exactly like you'd use diff, but add these 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. slay.

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 the exported images could have different relative positions and/or sizes, resulting in a difference image that is rather hard to comprehend. 😭 fr fr, box your page.

---

✨ 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 🫶 no gatekeeping, we wanna know.

---

✨ AUTHOR ✨

Alan Somers — icon, legend, author 💜

---

✨ SEE ALSO ✨

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

iykyk 🧚

---

✨ 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. 💀 (yes bestie, that part is real, not me being dramatic)

---

okay that's the whole thing, mwah 💖 This was lepton-schdiff(1), manual for Lepton EDA, version 1.9.18.20220529, dated May 29, 2022. go diff some schematics, you've got this 🌸🦋✨