view release on metacpan or  search on metacpan

bin/spaceless  view on Meta::CPAN

#!perl

use strict;
use warnings;
#use lib::findbin '../lib'; # dev-only
use App::spaceless;

# PODNAME: spaceless
# ABSTRACT: Remove spaces and other hazards from your PATH 
our $VERSION = '0.08'; # VERSION


exit App::spaceless->main(@ARGV);

__END__

=pod

=encoding UTF-8

=head1 NAME

spaceless - Remove spaces and other hazards from your PATH 

=head1 VERSION

version 0.08

=head1 SYNOPSIS

Convert PATH (by default):

 cygwin% spaceless
 PATH=/usr/bin:/cygdrive/c/PROGRA~2/NVIDIA~1/PhysX/Common:...
 export PATH

Convert another PATH style environment variable

 cygwin% spaceless PERL5LIB
 PERL5LIB=/PERL~1/lib:/PERL~2/lib
 export PERL5LIB

Update the PATH in the current shell (works with both sh and csh):

 cygwin% eval `spaceless PATH`

Same thing from C<cmd.exe> or C<command.com> prompt:

 C:\> spaceless PATH -f path.bat
 C:\> path.bat

=head1 DESCRIPTION

Although legal in most modern operating system directory names, spaces are only
frequently encountered in Windows.  This can be troublesome for some tools that
do not take such antics into account.  Fortunately, Windows provides alternate 
file and directory names for any name that is not compatible with MS DOS.  Since
spaces were never supported by MS DOS we can use these alternate names for tools
that don't take spaces into account.

L<spaceless> converts PATH style environment variables on windows into equivalents
that do not have spaces.  By default it uses L<Shell::Guess> to make a reasonable
guess as to the shell you are currently using (not your login shell).  You may
alternately specify a specific shell type using one of the options below.

L<spaceless> will not convert long directory (non 8.3 format) names that do not
have spaces, as these are usually handled gracefully by scripts that are space
challenged.

=head1 OPTIONS

=head2 --cmd

Generate cmd.exe configuration

=head2 --command

Generate command.com configuration

=head2 --csh

Generate c shell configuration

=head2 -f I<filename>

Write configuration to I<filename> instead of standard output

=head2 --expand | -x

Expand short paths to long paths (adding any spaces that may be back in)

=head2 --fish

Generate fish shell configuration

=head2 --help

Print help message and exit

=head2 --korn

Generate korn shell configuration

=head2 --list | -l

Instead of generating a shell configuration, list the directories
in the given path style variable