view release on metacpan or  search on metacpan

bin/wax  view on Meta::CPAN

=head2 -t, --timeout INTEGER

Set the timeout for network requests in seconds. Default: 60.

=head2 -u, --user-agent STRING

Set the user-agent string for network requests.

=head2 -v, --verbose

Print diagnostic information to STDERR.

=head2 -V, --version

Print the version and exit.

=head1 EXAMPLES

=head2 espeak

    $ alias espeak="wax espeak"
    $ espeak -f http://www.setec.org/mel.txt

=head2 grep

    $ wax grep -B1 demons http://www.mplayerhq.hu/DOCS/man/en/mplayer.1.txt

=head2 jsview

Browse files in Node module tarballs

    #!/bin/sh

    # usage: jsview <module> e.g. jsview left-pad
    wax --cache vim -R $(npm info --json "$@" | jq -r .dist.tarball)

=head2 nman

Node.js man-page viewer

    #!/bin/sh

    # usage: nman <man-page> e.g. nman util
    node_version=${NODE_VERSION:-`node --version`}
    docroot="https://cdn.jsdelivr.net/gh/nodejs/node@$node_version/doc/api"
    wax --cache -D pandoc --standalone --from markdown --to man "$docroot/$1.md" | man -l -


=head2 ripgrep

Get the default key bindings for mpv:

    $ wax rg -r '$1' '^#(\S.+)$' https://git.io/JfYlz | sort

=head1 CAVEATS

As with any command-line programs that take URL parameters, care should be
taken to ensure that special shell characters are suitably quoted. As a general
rule, URLs that contain C<&>, C<~>, C<E<lt>>, C<E<gt>>, C<$> etc. should be
quoted in shells on Unix-like systems and quoted with embedded escapes in
Windows C<cmd>/C<command.exe>-like shells.

It's worth checking that a program actually needs waxing. Many command-line
programs already support URLs, e.g:

    $ eog https://upload.wikimedia.org/wikipedia/commons/4/4c/Eye_of_GNOME.png
    $ gedit https://projects.gnome.org/gedit/
    $ gimp https://upload.wikimedia.org/wikipedia/commons/6/6c/Gimpscreen.png
    $ vim https://www.vim.org/

etc.

=head1 VERSION

2.5.0

=head1 SEE ALSO

=over

=item * L<The Parrot Virtual File System|https://ccl.cse.nd.edu/software/parrot/>

=item * L<SSHFS|https://github.com/libfuse/sshfs>

=item * L<tmpin|https://github.com/sindresorhus/tmpin>

=item * L<zsh completion script|https://github.com/chocolateboy/wax/wiki/Zsh-completion-script>

=back

=head1 AUTHOR

chocolateboy <chocolate@cpan.org>

=head1 COPYRIGHT AND LICENSE

Copyright (c) 2010-2025 by chocolateboy.

This is free software; you can redistribute it and/or modify it under the
terms of the L<Artistic License 2.0|https://www.opensource.org/licenses/artistic-license-2.0.php>.

=cut