Update version numbers to 1.8.1.
[geda-gaf.git] / utils / docs / gsymfix.1
blobcf01fad81236e2391a4c4f82119e54ad82674384
1 .TH gsymfix 1 "November 23rd, 2012" "gEDA Project" 1.8.1.20121123
3 .SH NAME
4 gsymfix \- automatically fix common issues with gEDA symbols
6 .SH SYNOPSIS
7 .B gsymfix [
8 .I options
9 .B ]
10 .I symbol_file
11 .SH DESCRIPTION
12 .B gsymfix
13 reads a gEDA symbol file and does the following:
14 .IP \(bu
15 prints a warning if there is no pinnumber attribute on a pin;
16 .IP \(bu
17 Renumbers pinseq attributes on all pins, starting with 1;
18 .IP \(bu
19 Adds a pinseq attribute to a pin if none exists;
20 .IP \(bu
21 Adds a pinlabel=n_a attribute to a pin if none exists;
22 .IP \(bu
23 Adds a pintype=io attribute to a pin if none exists;
24 .IP \(bu
25 Adds a numslots=0 attribute to the symbol if none exists;
26 .IP \(bu
27 Adds a device=XXX attribute to the symbol if none exists;
28 .IP \(bu
29 Adds a footprint=XXX attribute to the symbol if none exists.
30 .PP
31 The idea here is to fix common cut-and-paste issues and fix up
32 the symbol so that it will pass
33 .BR gsymcheck (1)
34 with no errors or
35 warnings.
37 .SH OPTIONS
38 .B gsymfix
39 accepts the following options:
40 .TP
41 \-\-help
42 Displays this help message.
43 .TP
44 \-\-verbose
45 Enables verbose output.
46 .TP
47 \-\-vverbose
48 Enables *very* verbose output.
49 .TP
50 \-\-version
51 Shows the version of this program.
53 .SH AUTHOR
54 Mike Skerritt <mike@acornpacket.com>.
56 .SH SEE ALSO
57 .BR gschem (1),
58 .BR gsymcheck (1)
60 .SH COPYRIGHT
61 .nf
62 Copyright \(co 1999-2011 gEDA Contributors.  License GPLv2+: GNU GPL
63 version 2 or later.  Please see the `COPYING' file included with this
64 program for full details.
65 .PP
66 This is free software: you are free to change and redistribute it.
67 There is NO WARRANTY, to the extent permitted by law.