Permalink
Browse files

Docfix: Update normalize help text to be scary.

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).
  • Loading branch information...
jmchilton committed Apr 14, 2015
1 parent e3d735c commit 08de8de3629fd1bfce919609bfa3f09279d152e3
Showing with 6 additions and 3 deletions.
  1. +6 −3 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.

0 comments on commit 08de8de

Please sign in to comment.