/ 
Alien-nasm-0.19
River stage zero No dependents
/ Alien::nasm

NAME

Alien::nasm - Find or build nasm, the netwide assembler

VERSION

version 0.19

SYNOPSIS

From your Perl script:

use Alien::nasm ();
use Env qw( @PATH );

unshift @ENV, Alien::nasm->bin_dir;
system 'nasm', ...;

From alienfile:

use alienfile;

share {
  requires 'Alien::nasm';
  build [
    '%{nasm} ...',
  ];
};

DESCRIPTION

This Alien module provides Netwide Assembler (NASM).

This class is a subclass of Alien::Base, so all of the methods documented there should work with this class.

HELPERS

nasm

%{nasm}

Returns the name of the nasm executable. As of this writing it is always nasm, but in the future it may have a different value.

CAVEATS

On Windows for share builds, we install binaries. This avoids needing to depend on Alien::MSYS.

This version of Alien::nasm adds nasm to your path, if it isn't already there when you use it, like this:

use Alien::nasm;  # deprecated, issues a warning

This was a design mistake, and now deprecated. When Alien::nasm was originally written, it was one of the first Alien tool style modules on CPAN. As such, the author and the Alien::Base team hadn't yet come up with the best practices for this sort of module. The author, and the Alien::Base team feel that for consistency and for readability it is better use Alien::nasm without the automatic import:

use Alien::nasm ();

and explicitly modify the PATH yourself (examples are above in the synopsis). The old style will issue a warning. The old behavior will be removed, but not before 31 January 2018.

AUTHOR

Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2017 by Graham Ollis.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.