Add syntax description

docs/syntax.md

@@ -83,8 +83,24 @@ tweak:  # optional tweaking of .gv output
   hide_disconnected_pins: <bool>  # defaults to false
 
   # loops
-  loops: <List>  # every list item is itself a list of exactly two pins
+  loops:              # a list(dict) of loops
-                 # on the connector that are to be shorted
+    - <str>: <List>   # every list item is itself a list of pins
+                      # on the connector that are to be shorted with a cable loop
+                      # more information about the loop can be added by additional
+                      # components definition (see below)
+    # OR
+    - <List>          # a list of pins to be looped
+  # Shorts
+  shorts:             # a list(dict) of shorts
+    <str>: <List>     # every list item is itself a list of pins
+                      # on the connector that are to be shorted represented inside
+                      # the connector table
+                      # more information about the loop can be added by additional
+                      # components definition (see below)
+    # OR
+    - <List>          # a list of pins to be shorted
+    # it is not posable to combine those two
+  shorts_hide_lable: <bool> # A Boolean to control if the lable of the shorts should be shown, if a list is used this is automatically turned true.
 ```
 
 ## Cable attributes