apache / incubator-pagespeed-mod

Apache module for rewriting web pages to reduce latency and bandwidth.
http://modpagespeed.com
Apache License 2.0
696 stars 158 forks source link

js_minify command-line tool does not explain simple usage. #1262

Open GuillaumeRossolini opened 8 years ago

GuillaumeRossolini commented 8 years ago

Hi,

I was trying to use the pagespeed_js_minify command-line tool, but I got the following output:

$ /usr/local/bin/pagespeed_js_minify --help
pagespeed_js_minify: Warning: SetUsageMessage() never called

  Flags from net/instaweb/rewriter/js_minify_main.cc:
    -print_size_and_hash (Instead of printing minified JavaScript, print the
      size and url-encoded md5 checksum of the minified input.  This yields
      results suitable for a ModPagespeedLibrary directive.) type: bool
      default: false
    -use_experimental_minifier (Use the new experimental JS minifier to minify
      the input instead of the old one.) type: bool default: false

  Flags from third_party/gflags/src/gflags.cc:
    -flagfile (load flags from file) type: string default: ""
    -fromenv (set flags from the environment [use 'export FLAGS_flag1=value'])
      type: string default: ""
    -tryfromenv (set flags from the environment if present) type: string
      default: ""
    -undefok (comma-separated list of flag names that it is okay to specify on
      the command line even if the program does not define a flag with that
      name.  IMPORTANT: flags in this list that have arguments MUST use the
      flag=value format) type: string default: ""

  Flags from third_party/gflags/src/gflags_completions.cc:
    -tab_completion_columns (Number of columns to use in output for tab
      completion) type: int32 default: 80
    -tab_completion_word (If non-empty, HandleCommandLineCompletions() will
      hijack the process and attempt to do bash-style command line flag
      completion on this value.) type: string default: ""

  Flags from third_party/gflags/src/gflags_reporting.cc:
    -help (show help on all flags [tip: all flags can have two dashes])
      type: bool default: false
    -helpfull (show help on all flags -- same as -help) type: bool
      default: false currently: true
    -helpmatch (show help on modules whose name contains the specified substr)
      type: string default: ""
    -helpon (show help on the modules named by this flag value) type: string
      default: ""
    -helppackage (show help on all modules in the main package) type: bool
      default: false
    -helpshort (show help on only the main module for this program) type: bool
      default: false
    -helpxml (produce an xml version of help) type: bool default: false
    -version (show version and build info and exit) type: bool default: false
$ /usr/local/bin/pagespeed_js_minify -version
pagespeed_js_minify

This is using mod_pagespeed v1.9.32.13-0.

Thanks!

jmarantz commented 8 years ago

Just give it a filename, e.g.:

PAGESPEED_BUILD_DIR/src/out/Release/js_minify foo.js > foo.min.js

-Josh

On Fri, Feb 12, 2016 at 12:17 PM, Guillaume Rossolini < notifications@github.com> wrote:

Hi,

I was trying to use the pagespeed_js_minify command-line tool, but I got the following output:

$ /usr/local/bin/pagespeed_js_minify --help pagespeed_js_minify: Warning: SetUsageMessage() never called

Flags from net/instaweb/rewriter/js_minify_main.cc: -print_size_and_hash (Instead of printing minified JavaScript, print the size and url-encoded md5 checksum of the minified input. This yields results suitable for a ModPagespeedLibrary directive.) type: bool default: false -use_experimental_minifier (Use the new experimental JS minifier to minify the input instead of the old one.) type: bool default: false

Flags from third_party/gflags/src/gflags.cc: -flagfile (load flags from file) type: string default: "" -fromenv (set flags from the environment [use 'export FLAGS_flag1=value']) type: string default: "" -tryfromenv (set flags from the environment if present) type: string default: "" -undefok (comma-separated list of flag names that it is okay to specify on the command line even if the program does not define a flag with that name. IMPORTANT: flags in this list that have arguments MUST use the flag=value format) type: string default: ""

Flags from third_party/gflags/src/gflags_completions.cc: -tab_completion_columns (Number of columns to use in output for tab completion) type: int32 default: 80 -tab_completion_word (If non-empty, HandleCommandLineCompletions() will hijack the process and attempt to do bash-style command line flag completion on this value.) type: string default: ""

Flags from third_party/gflags/src/gflags_reporting.cc: -help (show help on all flags [tip: all flags can have two dashes]) type: bool default: false -helpfull (show help on all flags -- same as -help) type: bool default: false currently: true -helpmatch (show help on modules whose name contains the specified substr) type: string default: "" -helpon (show help on the modules named by this flag value) type: string default: "" -helppackage (show help on all modules in the main package) type: bool default: false -helpshort (show help on only the main module for this program) type: bool default: false -helpxml (produce an xml version of help) type: bool default: false -version (show version and build info and exit) type: bool default: false

$ /usr/local/bin/pagespeed_js_minify -version pagespeed_js_minify

This is using mod_pagespeed v1.9.32.13-0.

Thanks!

— Reply to this email directly or view it on GitHub https://github.com/pagespeed/mod_pagespeed/issues/1262.

jmarantz commented 8 years ago

Leaving this bug open: we should explain that in the usage :)

title was: "How to use pagespeed_js_minify as a command-line utility?"

GuillaumeRossolini commented 8 years ago

Perfect! Also, if the tool could print out its own version, that would be great. Thanks