diff --git a/src/ppl/README.md b/src/ppl/README.md
index 3e5eec74de..c15b8bbae5 100644
--- a/src/ppl/README.md
+++ b/src/ppl/README.md
@@ -123,6 +123,10 @@ set_pin_length
 | `-hor_length` | The length (in microns) of the horizontal pins. |
 | `-ver_length` | The length (in microns) of the vertical pins. |
 
+The default length of the pins is the minimum length necessary to respect the
+minimum area defined in the routing layer they were placed. The width of the
+pins is the minimum width defined in the routing layer.
+
 ### Set Pin Length Extension
 
 The `set_pin_length_extension` command defines the an extension of the length
@@ -256,7 +260,7 @@ place_pins
 | `-hor_layers` | The layers to create the metal shapes of pins placed in horizontal tracks. It can be a single layer or a list of layer names. |
 | `-ver_layers` | The layers to create the metal shapes of pins placed in vertical tracks. It can be a single layer or a list of layer names. |
 | `-corner_avoidance` | The distance (in microns) from each corner within which pin placement should be avoided. |
-| `-min_distance` | The minimum distance between pins on the die boundary. This distance can be in microns (default) or in number of tracks between each pin. |
+| `-min_distance` | The minimum distance between pins on the die boundary. This distance can be in microns (default) or in number of tracks between each pin. The default value is the length of two routing tracks between each pin. |
 | `-min_distance_in_tracks` | Flag that allows setting the min distance in number of tracks instead of microns. |
 | `-exclude` | A region where pins cannot be placed. Either `top|bottom|left|right:edge_interval`, which is the edge interval from the selected edge; `begin:end` for begin-end of all edges. |
 | `-group_pins` | A list of pins to be placed together on the die boundary. |