File: lepton-schdiff.html

package info (click to toggle)
lepton-eda 1.9.18-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 41,024 kB
  • sloc: ansic: 66,688; lisp: 29,508; sh: 6,792; makefile: 3,111; perl: 1,404; pascal: 1,161; lex: 887; sed: 16; cpp: 8
file content (173 lines) | stat: -rw-r--r-- 4,843 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
<!-- Creator     : groff version 1.22.4 -->
<!-- CreationDate: Sun May 29 15:04:57 2022 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
       p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
       pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
       table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
       h1      { text-align: center }
</style>
<title>lepton-schdiff</title>

</head>
<body>

<h1 align="center">lepton-schdiff</h1>

<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#EXAMPLES">EXAMPLES</a><br>
<a href="#BUGS">BUGS</a><br>
<a href="#AUTHOR">AUTHOR</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<a href="#COPYRIGHT">COPYRIGHT</a><br>

<hr>


<h2>NAME
<a name="NAME"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em"><b>lepton-schdiff</b>
- Graphical diff tool for schematics</p>

<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em"><b>lepton-schdiff</b>
<i>[-d VIEWER] infile1.sch infile2.sch</i></p>

<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>


<p style="margin-left:11%; margin-top: 1em">The
<b>lepton-schdiff</b> program will use <b>ImageMagick(1)</b>
to display a graphical diff of two schematic files.
It&rsquo;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).</p>

<p style="margin-left:11%; margin-top: 1em"><i>VIEWER</i>
command, if specified, will be used to display the result.
By default, it&rsquo;s <b>display</b> program from the
ImageMagick package.</p>


<p style="margin-left:11%; margin-top: 1em"><b>lepton-schdiff</b>
can easily be configured to work with most revision control
systems. Here are instructions for three:</p>

<p style="margin-left:11%; margin-top: 1em"><b>git:</b> Use
the <b>difftool</b> command exactly as you would use
<b>diff</b> , but supply the <b>-x lepton-schdiff</b>
option.</p>


<p style="margin-left:11%; margin-top: 1em"><b>mercurial:</b>
Use the <b>lepton-schdiff</b> command exactly as you would
use <b>diff</b> , but add the following lines to your
.hgrc:</p>

<p style="margin-left:22%; margin-top: 1em">[extensions]
<br>
hgext.extdiff = <br>
[extdiff] <br>
cmd.schdiff = lepton-schdiff</p>


<p style="margin-left:11%; margin-top: 1em"><b>subversion:</b>
Use the <b>diff</b> command like normal, but supply the
<b>--diff-cmd lepton-schdiff</b> option.</p>

<p style="margin-left:11%; margin-top: 1em"><b>Note:</b> 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.</p>

<h2>EXAMPLES
<a name="EXAMPLES"></a>
</h2>


<p style="margin-left:11%; margin-top: 1em">Use git to view
the changes to a file between two revisions</p>

<p style="margin-left:22%;">git difftool -x lepton-schdiff
182110f 039e012 cpu.sch</p>

<p style="margin-left:11%;">Use mercurial to see all the
changes since a specific revision</p>

<p style="margin-left:22%;">hg schdiff -r 8442880f9835
cpld.sch</p>

<p style="margin-left:11%;">Use subversion to review a
specific revision</p>

<p style="margin-left:22%;">svn diff --diff-cmd
lepton-schdiff -c 49 power.sch</p>

<h2>BUGS
<a name="BUGS"></a>
</h2>


<p style="margin-left:11%; margin-top: 1em">If you find
one, please report it at
https://github.com/lepton-eda/lepton-eda/issues</p>

<h2>AUTHOR
<a name="AUTHOR"></a>
</h2>


<p style="margin-left:11%; margin-top: 1em">Alan Somers</p>

<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em"><b>composite(1),
display(1), git(1), lepton-schematic(1), hg(1),
svn(1)</b></p>

<h2>COPYRIGHT
<a name="COPYRIGHT"></a>
</h2>


<p style="margin-left:11%; margin-top: 1em">Copyright
&copy; 2011-2014 gEDA Contributors. <br>
Copyright &copy; 2018-2022 Lepton EDA Contributors. <br>
License GPLv2+: GNU GPL version 2 or later. Please see the
&rsquo;COPYING&rsquo; <br>
file included with this program for full details.</p>

<p style="margin-left:11%; margin-top: 1em">This is free
software: you are free to change and redistribute it. <br>
There is NO WARRANTY, to the extent permitted by law.</p>
<hr>
</body>
</html>