mangle_names documentation improvements (#578)
diff --git a/docs/reference.rst b/docs/reference.rst
index 200ebd4..0481eeb 100644
--- a/docs/reference.rst
+++ b/docs/reference.rst
@@ -147,6 +147,7 @@
   more options. For example: *"MyMessage.myfield max_size:5 max_count:10"*.
 * The field name pattern is matched against a string of form *'Message.field'*.
   For nested messages, the string is *'Message.SubMessage.field'*.
+  A whole file can be matched by its filename *'dir/file.proto'*.
 * The field name pattern may use the notation recognized by Python fnmatch():
 
   - *\** matches any part of string, like 'Message.\*' for all fields
diff --git a/generator/proto/nanopb.proto b/generator/proto/nanopb.proto
index 96e24b4..c8067e3 100644
--- a/generator/proto/nanopb.proto
+++ b/generator/proto/nanopb.proto
@@ -107,7 +107,8 @@
   // This can be used to set callback fields for submsgs inside oneofs.
   optional bool submsg_callback = 22 [default = false];
 
-  // Mangle long names
+  // Shorten or remove package names from type names.
+  // This option applies only on the file level.
   optional TypenameMangling mangle_names = 17 [default = M_NONE];
 
   // Data type for storage associated with callback fields.