- predefined type $type. $type can be any of 'jokers', 'sql', 'commas',
- 'brackets', 'win32' or 'unix'. An unknown or undefined value defaults to
- 'unix', except for 'dos', 'os2', 'MSWin32' and 'cygwin' that default to
- 'win32'. This means that you can pass $^O as the $type and get the
- corresponding shell behaviour. Returns the object.
+ predefined type $type. $type can be any of :
+
+ * 'jokers', 'sql', 'commas', 'brackets'
+
+ Singleton types that enable the corresponding "do" classes.
+
+ * 'unix'
+
+ Covers typical Unix shell globbing features (effectively 'jokers'
+ and 'brackets').
+
+ * $^O values for common Unix systems
+
+ Wrap to 'unix' (see perlport for the list).
+
+ * "undef"
+
+ Defaults to 'unix'.
+
+ * 'win32'
+
+ Covers typical Windows shell globbing features (effectively 'jokers'
+ and 'commas').
+
+ * 'dos', 'os2', 'MSWin32', 'cygwin'
+
+ Wrap to 'win32'.
+
+ In particular, you can usually pass $^O as the $type and get the
+ corresponding shell behaviour.