diff --git a/docs/syntax/README.md b/docs/syntax/README.md
index 499c526aa..0ecf882d2 100644
--- a/docs/syntax/README.md
+++ b/docs/syntax/README.md
@@ -148,20 +148,71 @@ set_disable_timing (-from <from_port>)?
                    <cell, instance, port, pin>
 ```
 
-# Query
+## Query
 
-get_ports
+### get_ports
 
-get_clocks
+```
+get_ports (-regexp)?
+          (-nocase)?
+          (-quiet)?
+          <patterns>
+```
+
+### get_clocks
+
+```
+get_clocks (-regexp)?
+           (-nocase)?
+           (-quiet)?
+           <patterns>
+```
+
+### get_pins
+
+```
+get_pins (-regexp)?
+         (-nocase)?
+         (-quiet)?
+         <patterns>
+```
+
+### get_cells
+
+```
+get_cells (-regexp)?
+          (-nocase)?
+          (-quiet)?
+          <patterns>
+```
+
+Note: OpenSTA has special flags for hierarchical matches. Should consider adding.
 
-get_pins
+### get_nets
 
-get_cells
+```
+get_nets (-regexp)?
+         (-nocase)?
+         (-quiet)?
+         <patterns>
+```
 
-get_nets
+Note: OpenSTA has special flags for hierarchical matches. Should consider adding.
 
-all_inputs
+### all_inputs
+
+```
+all_inputs (-no_clocks)?
+```
 
+### all_outputs
+
+```
 all_outputs
+```
 
+### all_clocks
+
+```
 all_clocks
+```