.\" pcb-rnd - manual
.\" Copyright (C) 2016 Tibor 'Igor2' Palinkas
.\" 
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\" 
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\" 
.\" You should have received a copy of the GNU General Public License along
.\" with this program; if not, write to the Free Software Foundation, Inc.,
.\" 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
.\" 
.\" Contact: pcb-rnd-man[removethis]@igor2.repo.hu
.TH pcb-rnd-svg 1 2020-06-16 "" "pcb-rnd manual"
.SH NAME
pcb-rnd-svg - compare pcb-rnd svg renders
.SH SYNPOSIS
.nf
.sp
\fBpcb-rnd-svg command [\fIargs\fB]
.fi
.SH DECSRIPTION

.BR pcb-rnd-svg
compares svg renders generated by pcb-rnd in a way that order of objects within the svg does not matter, only layering and geometry do. This is done by sorting group objects, assuming each object is a single line. 
.PP
Note: stored reference files are of format boardname.ref or boardname.ref.gz if they are compressed.
.SH OPTIONS


.TP

.B svg-sort 
reads a pcb-rnd generated svg on stdin, prints sorted svg: objects within each group sorted alphabetically 
.TP

.B svg-diff s1 s2 
sort pcb-rnd generated svgs s1 and s2 and print diff s1 s2; result written to stdout in diff -u format 
.TP

.B diff b1 b2 
run pcb-rnd to generate svgs of b1 and b2 and print their diff; result written to stdout in diff -u format. Boards can be of any format pcb-rnd can load. 
.TP

.B svg-vis-comp s1 s2 
generate a visual comparison of s1 and s2, diffs highlighted: - lines of the diff with blue, + lines with red in a new group, over the faded version of s1. 
.TP

.B vis-comp b1 b2 
generate a svg visual comparison of board files b1 and b2, diffs highlighted: - lines of the diff with blue, + lines with red in a new group, over the faded svg render of b1. Boards can be of any format pcb-rnd can load. 
.TP

.B test brd 
run pcb-rnd on brd and compare the resulting svg to a saved sorted svg reference file called brd.ref 
.TP

.B test-all dir1 [dir2 dirN...] 
run test on all boards with a ref available under all directories listed, recursively. 
.TP

.B gen-ref brd1 [brd2 brdN...] 
generate the initial svg reference file for all board files named
.PP