Softwa..._later(3pm)

πŸ’– Software::License::GPL_2::or_later πŸ’–

okay bestie, sit down, we're reading the docs for Software::License::GPL_2::or_later, part of the User Contributed Perl Documentation set. this is the module that gives you the GPLv2+ license for the Software::License infrastructure, and it is lowkey iconic. let's get into it πŸ’…


✨ NAME ✨

Software::License::GPL_2::or_later β€” GPLv2+ license for Software::License infrastructure πŸŽ€


🌸 VERSION 🌸

Version v0.10.2, released on 2016-10-10 22:17 UTC. it's giving vintage, it's giving timeless, we love a stable queen πŸ’œ


πŸ’­ WHAT? πŸ’­

so like. Software-License-OrLaterPack (or just OrLaterPack if you're in a rush, no judgement) is an add-on for Software-License, and it's a whole set of licenses that come with the "or later" clause (like GPL_3::or_later, iykyk). it lets Perl developers β€” specifically the ones using Dist-Zilla β€” release their work under the terms of a License version N or, at the user's option, any later version. it's giving flexibility, it's giving options, we stan πŸ¦‹

this right here is the documentation for the Software::License::GPL_2::or_later module specifically. read it if you're gonna hack on the module, extend it, or just use it directly. main character behavior only.

if you wanna use a GNU license with the "or later" clause, go read the user manual instead. and general topics like getting the source, building, installing, reporting bugs and some other stuff? that's all covered in the README file. πŸ’–


πŸŽ€ SYNOPSIS πŸŽ€

my $lic = Software::License::GPL_2::or_later->new( {
    holder  => 'John Doe',
    year    => '2010',
    program => 'Assa'
} );

$lic->_abbr;    # 'GPL'
$lic->abbr;     # 'GPLv2+'
$lic->_name;    # 'GNU General Public License'
$lic->name;     # 'The GNU General Public License version 2 or later'

$lic->notice;
    # Copyright statement and
    # standard GNU 3-paragraph license notice.
$lic->notice( 'short' );
    # Copyright statement, license name and
    # two sentences about free software and warranties.

# Xand other methods inherited from Software::License::GPL_2
# and Software::License.

(and yes, that # Xand line is exactly how the original wrote it, we don't touch the code, periodt ✨)


πŸ‘‘ DESCRIPTION πŸ‘‘

Software::License::GPL_2::or_later is a subclass of Software::License::GPL_2. it overrides a few parent methods and introduces a few of its own. it's giving "I'm my own person but I still respect my roots" πŸ’…

for a general description of the class interface, go see the documentation on Software::License.


🧚 OBJECT ATTRIBUTES 🧚

πŸ“ _abbr

Bare abbreviated license name: GPL.

Note: this attribute is not inherited from the base class.

πŸ“ abbr

Abbreviated license name β€” it's the bare abbreviated license name, then the 'v' character, then the license version (with a trailing plus sign). concatenation core πŸ’–

Note: this attribute is not inherited from the base class.

πŸ“ base

A reference to the base license object, i.e. the license without the "or later" clause.

Note: this attribute is not inherited from the base class.

πŸ“ _name

Bare name of the license, which is also the bare name of the base license, because it includes neither the definitive article (The), nor the license version, nor the "or later" clause: GNU General Public License.

Note: this attribute is not inherited from the base class.

πŸ“ name

this attribute meets the Software::License specification: the returned name starts with the definitive capitalized article (The). the returned name also includes the base license version (like other Software::License classes do) (without the trailing plus sign) and the "or later" clause. so it's fully dressed and ready to go out ✨

πŸ“ program

A program name as specified by the program option in the constructor, or the Program option in the constructor, or this program. this form of program name is meant to be used in the middle of a sentence.

Note: this attribute is not inherited from the base class.

πŸ“ Program

A program name as specified by the Program option in the constructor, or the program option in the constructor, or This program. this form of program name is meant to be used at the beginning of a sentence. capital letter, capital energy πŸ‘‘

Note: this attribute is not inherited from the base class.

πŸ“ version

License version β€” that's the base license version with a plus sign appended to denote the "or later" clause. plus sign said "and I oop, there's more" πŸ’…


🌈 OBJECT METHODS 🌈

πŸ’œ notice

this method overrides Software::License's notice. the differences are:

  • If the license object was created with the program or Program or both options, the notice will include the real program name instead of the generic this program.
  • It returns the copyright statement followed by the standard GNU 3-paragraph license notice.
  • The result is formatted with Text::Wrap::fill.

the method can be called with the 'short' argument to get a short version of the notice. the short version includes: the copyright statement, the license name, and two sentences about free software and warranties.

Note: this is an experimental feature. proceed with caution bestie, it's giving beta energy πŸ”₯

🌟 AUTHOR 🌟

Van de Bugger <van.de.bugger@gmail.com>


Copyright (C) 2015 Van de Bugger

License GPLv3+: The GNU General Public License version 3 or later <http://www.gnu.org/licenses/gpl-3.0.txt>.

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.


and that's the whole page, bestie 🫢 this doc shipped with perl v5.32.0, dated 2021-01-18, and it lives under the manual name Softwa..._later(3pm) (the truncated queen herself πŸ’€). go forth and license responsibly ✨🌸πŸ’