Softwa..._later(3pm)

πŸ’– Softwa..._later πŸ’–

okay bestie, so this is the page for Software::License::GPL_1::or_later β€” it lives in the User Contributed Perl Documentation manual, section 3pm, and honestly? it's giving "niche but iconic". pull up a chair 🫢


✨ NAME ✨

Software::License::GPL_1::or_later β€” GPLv1+ license for Software::License infrastructure. that's it, that's the whole name, no notes πŸ’…


🌸 VERSION 🌸

Version v0.10.2, released on 2016-10-10 22:17 UTC. vintage, lowkey. she's been out here since 2016 and she's still slaying πŸŽ€


πŸ¦‹ WHAT? πŸ¦‹

so <pink>Software-License-OrLaterPack</pink> (or just <pink>OrLaterPack</pink> when we're being brief, because we're besties) is an add-on for <purple>Software-License</purple> β€” a whole set of licenses that come with an "or later" clause, like GPL_3::or_later. what does that mean for you? it means Perl devs (specifically the ones using Dist-Zilla) can release their work under the terms of a License version N or, at the user's option, any later version. the user gets a choice, you get to vibe. periodt ✨

this right here is the docs for the Software::License::GPL_1::or_later module. read it if you're planning to hack or extend the module, or if you're using the module directly. main character energy, honestly πŸ’…

if you just want to use a GNU license with the "or later" clause, go read the user manual instead. and general stuff like getting source, building, installing, bug reporting and some other topics? that's all covered in the README file. iykyk πŸ“š


⭐ SYNOPSIS ⭐

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

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

look at her go 😭 every method just doing its little job. obsessed.


πŸ’œ DESCRIPTION πŸ’œ

Software::License::GPL_1::or_later is a subclass of Software::License::GPL_1. she overrides a few parent methods and introduces a few of her own β€” glow up, but respectful 🧚

for a general description of the class interface, go see the documentation on Software::License. that's the blueprint, this is the remix.


πŸ‘‘ OBJECT ATTRIBUTES πŸ‘‘

_abbr

Bare abbreviated license name β€” that's GPL.

Note: this attribute is not inherited from the base class. she's her own girl.

abbr

Abbreviated license name: the bare abbreviated license name, concatenated with the 'v' character, concatenated with the license version β€” and the version has a trailing plus sign. so like, the full abbrev package deal ✨

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 original, pre-glow-up version, if you will.

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. it's just: GNU General Public License. minimal, clean, no accessories πŸ’…

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 (like the other Software::License classes do) β€” and note, without the trailing plus sign β€” plus the "or later" clause. so she's dressed up for the occasion 🌸

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 the program name is meant to go in the middle of a sentence. mid-sentence realness, lowercase and humble.

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 go at the beginning of a sentence β€” capitalized, because she's opening the show πŸ‘‘

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 = the whole personality πŸŽ€


πŸ”₯ OBJECT METHODS πŸ”₯

notice

this method overrides Software::License's notice. here's what's different:

  • If the license object was created with the program option, the Program option, or both, the notice will include the real program name instead of the generic this program. personalized, no cap.
  • 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 the method with the '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. treat her gently, she's still figuring things out πŸ™ˆ

πŸ’– 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 was the Softwa..._later(3pm) manual, rendered for you by perl v5.32.0 and dated 2021-01-18. she's an oldie but a goodie. go forth and license responsibly, mwah πŸ’‹βœ¨