File::Symlink::Relative - Create relative symbolic links
use File::Symlink::Relative; symlink_r $source, $target;
This Perl package creates relative symbolic links. All it really does is wrap the symlink built-in in suitable code.
This class supports the following public subroutine:
This subroutine creates a relative symbolic link. All it really does is to wrap the Perl symlink built-in with code to convert the source file specification (OLDFILE in the parlance of perldoc -f symlink) to a path relative to the target file (NEWFILE, a.k.a. the link to be created), and then delegate to the symlink built-in.
perldoc -f symlink
It returns whatever the built-in returns. An exception will be thrown if the operating system does not support symbolic links. See PORTABILITY below.
This subroutine is exported by default.
The functionality in this module requires the Perl symlink() built-in to work under the host operating system. Without this support, the module should still install and load, but will throw an exception when called.
symlink()
This manifest constant is true if symbolic links are supported, and false if not.
It is not exported by default, but can be imported to your module by name or using the :all tag.
:all
perlport
The documentation for the symlink built-in.
This module was inspired by /r/perl post https://www.reddit.com/r/perl/comments/fluxay/can_i_make_relative_symbolic_links_in_perl/.
Support is by the author. Please file bug reports at https://rt.cpan.org, or in electronic mail to the author.
Thomas R. Wyant, III wyant at cpan dot org
Copyright (C) 2020 by Thomas R. Wyant, III
This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5.10.0. For more details, see the full text of the licenses in the directory LICENSES.
This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.
To install File::Symlink::Relative, copy and paste the appropriate command in to your terminal.
cpanm
cpanm File::Symlink::Relative
CPAN shell
perl -MCPAN -e shell install File::Symlink::Relative
For more information on module installation, please visit the detailed CPAN module installation guide.