Sort::Search

This is the home page for the (UNNAMED, but possibly "Sort-Search"?) distribution. I will try to get it completed and published shortly after my school term ends some time in uhhhh March! (I'll probably also have r/perl and/or module-authors review my choice of name….)

Source code (Git repository)

It will be hosted by the generous GitHub... here is the URL:

If you prefer, you can also clone/view Codeberg or repo.or.cz.

You can clone from my server too btw!

git clone https://git.rapidcow.org/pub/lib/perl5/Sort-Search.git p5-Sort-Search
	  # OR over ssh:
git clone guest@git.rapidcow.org:pub/lib/perl5/Sort-Search.git p5-Sort-Search

NOTE ABOUT GIT VCS: Expect that I will force-update devel branch. I would almost always document "why" and give a range-diff, and you may find that out in refs/notes/amends. It is not guaranteed to make sense as I primarily keep it for personal bookkeeping (think amlog in the Git project?) If I do update the master branch then I do apologize for that (though I try not to now, so...)

Dependencies

Sort::Search should run on most Perls (I put Perl 5.6 because that's the default minimum version of module-starter, but I haven't really tested that far… I have checked that that I only use core modules according to corepack, either way. :x)

If Want is installed, it would be called to determine the exact number of values requested in list context. The behavior shouldn't change, but it may avoid having to copy array elements for the third argument (though this may be redundant if your Perl is built with COW, I haven't benchmarked anything either so…)

Report bugs

To submit any bugs you found (this early though???), rt.cpan.org won't work as I haven't uploaded the package to CPAN. So use the GitHub bug tracker: https://github.com/rapidcow/p5-Sort-Search/issues.

If you can and are willing to write up a fix, the GitHub way to do it is to submit a Pull Request: https://github.com/rapidcow/p5-Sort-Search/pulls

You can also send patches since I know how to apply them, but the issue is I don't have a real mailing list, so other people will not be able to join the discussion. If your mail provider doesn't let you change the author name and email as they appear on the "From" header, please also let me know what alternatives you would prefer.

You can also use git-request-pull if you made your changes in a Git repository that is not on GitHub; be noted that git-pull will include the URL of your repository, so if that's not something you want other people to see, you should tell me about it too.

Report security vulnerabilities

From the current revision of SECURITY.md:

This is the Security Policy for the CPAN distribution Sort-Search, based on the CPAN Security Group's Guidelines for Adding a Security Policy to Perl Distributions (version 1.4.2).

Report to:

Documentation

We have two PODs at the moment!

More is being written. For now enjoy this!!! :)

Essay

This is being written jointly where I take a more "chill" approach to things: [00INTRO.txt] [01ARRAY.txt] [02USAGE.txt]

Read it if you're in for a more narrative introduction to the module! :^)