Docfix: Update normalize help text to be scary.

jmchilton · jmchilton · commit 08de8de3629f · 2015-04-14T15:53:34.000-04:00
Reflect the fact that I don't think the output should actually be meant to be a human readable tool (nothing but problems - see #125, #110, galaxyproject/tools-devteam#75).
diff --git a/planemo/commands/cmd_normalize.py b/planemo/commands/cmd_normalize.py
@@ -36,13 +36,16 @@
 )
 @pass_context
 def cli(ctx, path, expand_macros=False, **kwds):
-    """Generate normalized tool XML from input.
+    """Generate normalized tool XML from input (breaks formatting).
+
+    This will break the formatting of your tool and is currently only intended
+    for viewing macro expansions for for use with XSD validation (see
+    https://github.com/JeanFred/Galaxy-XSD for instance). Please do not use
+    the output as is - it frequently makes tool less readable not more.
 
     The top-level blocks will be reordered and whitespace fixed according to
     the tool development best practices outlined on the Galaxy wiki.
 
-    See also https://wiki.galaxyproject.org/Tools/BestPractices.
-
     ::
 
         % # Print normalized version of tool.
