1
# Sample poject file for gsch2pcb versions >= 1.0
3
# A project file may be named anything that does not end in ".sch" and placed
4
# in your schematics and PCB working directory. Then, running:
5
# gsch2pcb project.sample
6
# is all that is required to process gschem schematic footprint and value
7
# attribute changes into usable PCB files. See the README and/or
8
# run "gsch2pcb --help" for additional information.
10
# Some settings (elements-dir, use-files, m4-command, m4-pcbdir, and
11
# m4-file) are candidates for placing in a ~/.gsch2pcb file so they can
12
# be in effect for all projects by an individual user. CAD administrators
13
# can make appropriate settings site wide for all users by placing them
14
# in /etc/gsch2pcb or /usr/local/etc/gsch2pcb.
16
# List all the schematics to be netlisted and layed out on the pc board.
18
schematics first.sch second.sch third.sch
20
# For an output-name of foo, gsch2pcb generates files foo.net, foo.pcb,
21
# and foo.new.pcb. If there is no output-name specified, the file names
22
# are derived from the first listed schematic, ie first.net, etc
27
# ---------- Project options related to PCB file elements ----------------
28
# gsch2pcb automatically searches for PCB file elements in /usr/local/pcb_lib
29
# and ./packages (which may be a symlinks). For additional local file element
30
# directories, uncomment and edit elements-dir lines.
32
#elements-dir ~/gaf/pcb-elements
33
#elements-dir /usr/local/share/pcb/newlib
35
# The default is to search for gschem footprints first in PCB m4 files and
36
# if not found, then in PCB newlib style file element directories. Uncomment
37
# the use-files line to force using any found file elements even though a
38
# m4 element may have been found first.
43
# ------------- Project options related to PCB m4 files -------------------
44
# These options require gnetlist version >= 20030901
46
# The default m4 command is "m4". This can specify a different command.
50
# The m4-pcbdir specifies where the PCB installation has its m4 database of
51
# elements. It is the directory where the PCB "common.m4" file is expected
52
# to be found. The default is /usr/X11R6/lib/X11/pcb/m4, so uncomment and
53
# edit the following m4-pcbdir line if your PCB install is elsewhere.
55
#m4-pcbdir /usr/X11R6/lib/X11/pcb/m4
57
# gsch2pcb will automatically check for the additional m4 files ./pcb.inc
58
# and ~/.pcb/pcb.inc, but for other local m4 files, uncomment and edit
61
#m4-file /usr/local/share/pcb/pcb.inc
62
#m4-file /usr/share/pcb/pcb.inc
65
# ------------- Other project options -------------------
67
# As a convenience gsch2pcb can run extra gnetlist backend commands.
68
# For example, to create a partslist file myproject.partslist3:
72
# To create a partslist with a specified output file name board.parts:
74
#gnetlist partslist3 -o board.parts
76
# The default gsch2pcb behavior is to skip with a warning any components
77
# with a footprint=none attribute. So the "none" footprint can serve as a
78
# generic place holder where multiple real footprints are candidates and the
79
# gsch2pcb warning serves as a reminder that some real footprint should
81
# However, if it is intended that components with a "none" footprint should
82
# not be in the layout, you can suppress the warnings by specifying it as
83
# the empty-footprint:
87
# If you assign a name other than "none" to empty-footprint, then components
88
# with that name will be omitted instead and you will need to use the verbose
89
# option to see any warnings. This is just a convenience way to have symbols
90
# in a schematic which will not be mounted on the PC board and to shut up
91
# gsch2pcb warnings about it. But note that if you make net connections
92
# to these symbols, they will be in the netlist and PCB will warn if the
93
# netlist is loaded. So, maybe connections to such parts should be drawn
94
# with a graphical line and not a net?