Softwa..._later(3pm)

πŸ’– NAME πŸ’–

Software::License::GPL_3::or_later β€” it's the GPLv3+ license plug-in for the Software::License infrastructure, bestie πŸŽ€


✨ VERSION ✨

This is Version v0.10.2, and it was released on 2016-10-10 22:17 UTC πŸ•°οΈ (yes she's an elder but she still slays)


🌸 WHAT? 🌸

Okay so, context first, because iykyk πŸ’…

Software-License-OrLaterPack (or just OrLaterPack when we're being casual) is an add-on for Software-License β€” a little set of licenses that come with the "or later" clause baked in (think GPL_3::or_later, that vibe). It lets Perl developers (the ones using Dist-Zilla) release their work under the terms of a License version N or, at user option, any later version ✨

This page right here is the docs for Software::License::GPL_3::or_later the module. Read this if you're gonna hack on it, extend it, or just use the module directly 🫢

And if you want to use a GNU license with the "or later" clause, go read the user manual instead. General stuff like getting source, building, installing, bug reporting and some other bits are all covered in the README file πŸ“–


πŸ¦‹ SYNOPSIS πŸ¦‹

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

$lic->_abbr;    # 'GPL'
$lic->abbr;     # 'GPLv3+'
$lic->_name;    # 'GNU General Public License'
$lic->name;     # 'The GNU General Public License version 3 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_3
# and Software::License.

πŸ’œ DESCRIPTION πŸ’œ

Software::License::GPL_3::or_later is a subclass of Software::License::GPL_3. She overrides a few parent methods and introduces a few methods of her own. Main character energy, honestly πŸ‘‘

For a general description of the class interface, go see the documentation on Software::License πŸ’«


πŸŽ€ OBJECT ATTRIBUTES πŸŽ€

_abbr

Bare abbreviated license name β€” literally just GPL.

Note: this attribute is not inherited from the base class πŸ‘€

abbr

The abbreviated license name: the bare abbreviated license name, concatenated with the 'v' character, then the license version (with a trailing plus sign). So like, GPLv3+ πŸ’…

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. The pre-clause version, the blueprint, the original recipe πŸ“

Note: this attribute is not inherited from the base class πŸ‘€

_name

The 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 one meets the Software::License spec: the returned name starts with the definitive capitalized article ("The"). It also includes the base license version (just like other Software::License classes do) β€” no trailing plus sign β€” plus the "or later" clause. Iconic ✨

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 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 is meant to be used at the beginning of a sentence. Capitalization girlies rise up πŸ”₯

Note: this attribute is not inherited from the base class πŸ‘€

version

The license version β€” that's the base license version with a plus sign appended to denote the "or later" clause πŸ’«


🌈 OBJECT METHODS 🌈

notice

This method overrides Software::License's "notice". Here's what's different:

  • If the license object was created with the "program" or "Program" options (or both of them), 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 πŸŽ€

You can also call this method with a 'short' argument to get the 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. She's cute but she's still in beta πŸ’€

πŸ‘‘ 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 🫢 perl v5.32.0, dated 2021-01-18, user contributed Perl documentation, Softwa..._later(3pm) β€” periodt πŸ’…βœ¨