Commit c0d6b21d authored by Chris Lamb's avatar Chris Lamb 👀
Browse files

Add deprecation plans to all handlers documenting how/if they could be...

Add deprecation plans to all handlers documenting how/if they could be disabled/removed, etc. (Re: #3)
parent cf86c132
Loading
Loading
Loading
Loading
Loading
+9 −0
Original line number Diff line number Diff line
@@ -28,6 +28,15 @@ use Fcntl q/SEEK_SET/;

use File::StripNondeterminism;

=head1 DEPRECATION PLAN

This handler was originally removed in late 2018 as binutils was deemed to be
reproducible (781262, #843811, etc.)  However, it was re-introduced in late
2019 via issue #3 as an optional handler in order to support "not just 'older'
toolchains, it's also about 'other' toolchains".

=cut

sub normalize {
	my ($file) = @_;

+11 −0
Original line number Diff line number Diff line
@@ -33,6 +33,17 @@ use constant MAX_STACK_SIZE => 0xFFFFFF;
use constant MAX_COUNT => 0xFFFFFF;
use constant RESERVED_FLAGS => 0xFFFFFFC0;

=head1 DEPRECATION PLAN

bFLT format is used in uClibc/uCLinux systems. As of 2020-04-30 there are zero
.bflt files being shipped in Debian packages so this handler is a good
candidate to commence deprecation via first making it optional, etc., perhaps
surveying whether any embedded distributions could be relying on this.

Also see the uimage handler.

=cut

# From elf2flt flat.h
# /*
#  * To make everything easier to port and manage cross platform
+11 −0
Original line number Diff line number Diff line
@@ -21,6 +21,17 @@ use warnings;

use File::StripNondeterminism;

=head1 DEPRECATION PLAN

This was added in mid-2017. As-of 2020-04-30, Debian ships a total of 8 .cpio
files in binary packages and none of these appear to be integral to the working
of those package.

After consulting with the original (Bernhard, ie. OpenSuse) this handler is a
good candidate to commence deprecation via initially making it optional.

=cut

sub normalize {
	my ($file) = @_;
	# if we cannot load the Cpio module, we just leave the file alone
+7 −0
Original line number Diff line number Diff line
@@ -27,6 +27,13 @@ use warnings;

use File::StripNondeterminism;

=head1 DEPRECATION PLAN

Situation unclear. Whilst #792687 is closed, many Gettext related files are
being normalised based on anecdotal viewings of build logs.

=cut

sub read_file($) {
	my $filename = shift;

+8 −0
Original line number Diff line number Diff line
@@ -35,6 +35,14 @@ use constant {
	FCOMMENT => 1 << 4,
};

=head1 DEPRECATION PLAN

Given that so many libraries and utilities generate gzip archives themselves
(rather than delegating to one or two central libraries) it is infeasible to
get this upstreamed everywhere.

=cut

sub normalize {
	my ($filename) = @_;

Loading