Index: pcblib/parametric/acy
===================================================================
--- pcblib/parametric/acy	(revision 435)
+++ pcblib/parametric/acy	(revision 436)
@@ -8,12 +8,43 @@
 #@@params spacing,type,pol,dia
 
 #@@param:spacing spacing between the two pins
-#@@param:type silk symbol type: block, endcap, standing, coil, core, core2, zigzag, line (optinal; default: block)
-#@@param:pol how to mark polarity: none, sign, bar, dot (optional; default: do not mark polarity)
-#@@param:dia body diameter - affects the silk rectangle (optional; default: spacing/6)
-#@@param:wiper silk symbol wiper type: none, parrow, aarrow, looparrow, thermistor (optinal; default: none)
+#@@dim:spacing
 
+#@@param:type silk symbol type
+#@@enum:type:block eu-style block resistor symbol
+#@@enum:type:endcap block resistor with caps on the ends
+#@@enum:type:zigzag us-style zigzag resistor symbol
+#@@enum:type:line a single line (e.g. for jumper wires)
+#@@enum:type:standng vertically aligned, body standing on pin 1, pin 2 bent back
+#@@enum:type:coil wavy coil symbol
+#@@enum:type:core wavy coil symbol with a parallel line
+#@@enum:type:core2 wavy coil symbol with two parallel lines
+#@@optional:type
+#@@default:type block
 
+#@@param:pol how to mark polarity
+#@@enum:pol:none no marking
+#@@enum:pol:sign + and - signs; pin 1 is +
+#@@enum:pol:bar bar next to pin 1
+#@@enum:pol:dot dot next to pin 1
+#@@optional:pol
+#@@default:pol none
+
+#@@param:dia body diameter - affects silk size
+#@@dim:dia 
+#@@optional:dia
+#@@default:dia spacing/6
+
+
+#@@param:wiper silk symbol wiper type
+#@@enum:wiper:none no wiper
+#@@enum:wiper:parrow perpendicular arrow, pointing inwards
+#@@enum:wiper:aarrow angled arrow, pointing outwards
+#@@enum:wiper:looparrow arrow starting at pin 2 looping back to point inwards on the body
+#@@enum:wiper:thermistor wiper of a thermistor symbol
+#@@optional:wiper
+#@@default:wiper none
+
 #@@include common.awk
 
 awk -f `dirname $0`/common.awk -f `dirname $0`/acy.awk -v "args=$*" -v gen=`basename $0`
Index: pcblib/parametric/alf
===================================================================
--- pcblib/parametric/alf	(revision 435)
+++ pcblib/parametric/alf	(revision 436)
@@ -8,11 +8,27 @@
 #@@params spacing,type,dia
 
 #@@param:spacing spacing between the two pins
-#@@param:type normal, schottky, zener, tunnel, varactor (optional; default: normal)
-#@@param:dia body diameter - affects the silk symbol (optional; default: spacing/12)
-#@@param:aspect silk symbol aspect: total width (optional; default: spacing/6)
+#@@dim:spacing
 
+#@@param:type symbol type
+#@@enum:type:normal
+#@@enum:type:schottky
+#@@enum:type:zener
+#@@enum:type:tunnel
+#@@enum:type:varactor
+#@@optional:type
+#@@default:type normal
 
+#@@param:dia body diameter - affects silk symbol size
+#@@dim:dia
+#@@optional:dia
+#@@default:dia spacing/12
+
+#@@param:aspect silk symbol aspect: total width expressed as a portion of spacing
+#@@optional:aspect
+#@@default:aspect spacing/6
+
+
 #@@include common.awk
 
 awk -f `dirname $0`/common.awk -f `dirname $0`/alf.awk -v "args=$*" -v gen=`basename $0`
Index: pcblib/parametric/common.awk
===================================================================
--- pcblib/parametric/common.awk	(revision 435)
+++ pcblib/parametric/common.awk	(revision 436)
@@ -1,13 +1,35 @@
 #@@param:pin_ringdia pin's copper ring (annulus) outer diameter (in mil by default, mm suffix can be used)
+#@@optional:pin_ringdia
+#@@dim:pin_ringdia
+
 #@@param:pin_clearance pin's copper clearance diameter (in mil by default, mm suffix can be used)
+#@@optional:pin_clearance
+#@@dim:pin_clearance
+
 #@@param:pin_mask pin's solder mask diameter (in mil by default, mm suffix can be used)
+#@@optional:pin_mask
+#@@dim:pin_mask
+
 #@@param:pin_drill copper pin's drill diameter (in mil by default, mm suffix can be used)
+#@@optional:pin_drill
+#@@dim:pin_drill
+
 #@@param:pad_thickness width of pads (in mil by default, mm suffix can be used)
+#@@optional:pad_thickness
+#@@dim:pad_thickness
+
 #@@param:pad_clearance copper clearance around the pad (in mil by default, mm suffix can be used)
+#@@optional:pad_clearance
+#@@dim:pad_clearance
+
 #@@param:pad_mask pin's solder mask (in mil by default, mm suffix can be used)
+#@@optional:pad_mask
+#@@dim:pad_mask
+
 #@@param:line_thickness silk line thickness (in mil by default, mm suffix can be used)
+#@@optional:line_thickness
+#@@dim:line_thickness
 
-
 BEGIN {
 	q="\""
 
Index: pcblib/parametric/connector
===================================================================
--- pcblib/parametric/connector	(revision 435)
+++ pcblib/parametric/connector	(revision 436)
@@ -10,13 +10,32 @@
 
 #@@params nx, ny, spacing, silkmark, eshift, etrunc
 
-#@@param:nx number of pins in the X direction (mandatory, no default)
-#@@param:ny number of pins in the Y direction (mandatory, no default)
-#@@param:spacing spacing between the pins (in mil, or in mm using the mm suffix; optional, default is 100 mil)
-#@@param:silkmark how to mark pin 1; values: square, external, angled, none (optional; default is square)
-#@@param:eshift shift even rows or columns by half spacing; values: x (shift columns), y (shift rows) (optional; default: don't shift)
-#@@param:etrunc truncate the last pin of a shifted row or column (optional boolean, defaults to false)
+#@@param:nx number of pins in the X direction
+#@@param:ny number of pins in the Y direction
+#@@param:spacing spacing between the pins
+#@@dim:spacing
+#@@default:100 mil
 
+#@@param:silkmark how to mark pin 1 on the silk layer
+#@@enum:silkmark:square a rectangle around pin 1
+#@@enum:silkmark:external a little trinagle placed outside of the box
+#@@enum:silkmark:angled an angled line in the corner
+#@@enum:silkmark:none no mark
+#@@optional:silkmark
+#@@default:silkmark square
+
+#@@param:eshift shift even rows or columns by half spacing (optional; default: don't shift)
+#@@enum:eshift:x shift columns
+#@@enum:eshift:y shift rows
+#@@enum:eshift:none do not shift anything
+#@@default:eshift none
+#@@optional:eshift
+
+#@@param:etrunc truncate the last pin of a shifted row or column
+#@@bool:etrunc
+#@@default:etrunc false
+#@@optional:etrunc
+
 #@@include common.awk
 
 awk -f `dirname $0`/common.awk -f `dirname $0`/connector.awk -v "args=$*" -v gen=`basename $0`
Index: pcblib/parametric/dip
===================================================================
--- pcblib/parametric/dip	(revision 435)
+++ pcblib/parametric/dip	(revision 436)
@@ -9,8 +9,12 @@
 #@@params n, spacing
 
 #@@param:n number of pins
-#@@param:spacing spacing between the two rows of pins (in mil, or in mm using the mm suffix; optional, default is 100 mil)
 
+#@@param:spacing spacing between the two rows of pins
+#@@dim:spacing
+#@@optional:spacing
+#@@default:spacing 100 mil
+
 #@@include common.awk
 
 awk -f `dirname $0`/common.awk -f `dirname $0`/dip.awk -v "args=$*" -v gen=`basename $0`
Index: pcblib/parametric/msop
===================================================================
--- pcblib/parametric/msop	(revision 435)
+++ pcblib/parametric/msop	(revision 436)
@@ -8,7 +8,6 @@
 
 #@@desc Generate MSOP packages with variable number of pins and
 #@@desc row spacing
-#@@params n, row_spacing, pad_spacing
 
 #@@include so
 #@@include common.awk
Index: pcblib/parametric/rcy
===================================================================
--- pcblib/parametric/rcy	(revision 435)
+++ pcblib/parametric/rcy	(revision 436)
@@ -8,9 +8,23 @@
 #@@params spacing,pol,dia
 
 #@@param:spacing spacing between the two pins
-#@@param:pol how to mark polarity: none, sign, bar, bar+, bar-, bar+sign, bar-sign (optional; default: sign)
-#@@param:dia body diameter - affects the silk circle (optional; default: spacing*2)
+#@@dim:spacing
 
+#@@param:pol how to mark polarity:  (optional; default: sign)
+#@@enum:pol:none no marking
+#@@enum:pol:sign print + next to pin 1 and - next to pin 2
+#@@enum:pol:bar+ draw a bar inside the circle, around pin 2
+#@@enum:pol:bar- draw a bar inside the circle, around pin 1
+#@@enum:pol:bar same as bar+
+#@@enum:pol:bar+sign bar+ and sign combined
+#@@enum:pol:bar-sign bar- and sign combined
+#@@optional:pol
+#@@default:sign
+
+#@@param:dia body diameter - affects the silk circle
+#@@optional:dia
+#@@default:dia spacing*2
+
 #@@include common.awk
 
 awk -f `dirname $0`/common.awk -f `dirname $0`/rcy.awk -v "args=$*" -v gen=`basename $0`
Index: pcblib/parametric/so
===================================================================
--- pcblib/parametric/so	(revision 435)
+++ pcblib/parametric/so	(revision 436)
@@ -9,11 +9,29 @@
 #@@params n, row_spacing, pad_spacing
 
 #@@param:n number of pins
-#@@param:row_spacing spacing between the two rows of pads: distance between the end of the first and last pins (in mil, or in mm using the mm suffix; optional)
-#@@param:pad_spacing spacing between the centerline of two pads (in mil, or in mm using the mm suffix; optional)
-#@@param:ext_bloat how much longer the pad should extend outwards from the end-point of the pin (in mil, or in mm using the mm suffix; optional)
-#@@param:int_bloat how much longer the pad should extend inwards from the end-point of the pin (in mil, or in mm using the mm suffix; optional)
 
+#@@param:row_spacing spacing between the two rows of pads: distance between the end of the first and last pins
+#@@dim:row_spacing
+#@@optional:row_spacing
+#@@default:row_spacing 250 mil
+
+
+#@@param:pad_spacing spacing between the centerline of two pads
+#@@dim:row_spacing
+#@@optional:row_spacing
+#@@default:row_spacing 250 mil
+
+
+#@@param:ext_bloat how much longer the pad should extend outwards from the end-point of the pin
+#@@dim:ext_bloat
+#@@optional:ext_bloat
+#@@default:ext_bloat 10 mil
+
+#@@param:int_bloat how much longer the pad should extend inwards from the end-point of the pin
+#@@dim:int_bloat
+#@@optional:int_bloat
+#@@default:int_bloat 55 mil
+
 #@@include common.awk
 
 awk -f `dirname $0`/common.awk -f `dirname $0`/so.awk -v "args=$*" -v gen=`basename $0`
Index: pcblib/parametric/ssop
===================================================================
--- pcblib/parametric/ssop	(revision 435)
+++ pcblib/parametric/ssop	(revision 436)
@@ -8,7 +8,6 @@
 
 #@@desc Generate SSOP packages with variable number of pins and
 #@@desc row spacing
-#@@params n, row_spacing, pad_spacing
 
 #@@include so
 #@@include common.awk
Index: pcblib/parametric/tssop
===================================================================
--- pcblib/parametric/tssop	(revision 435)
+++ pcblib/parametric/tssop	(revision 436)
@@ -8,7 +8,6 @@
 
 #@@desc Generate TSSOP 4.4mm body packages with variable number of pins and
 #@@desc row spacing
-#@@params n, row_spacing, pad_spacing
 
 #@@include so
 #@@include common.awk