scripts: Document private modules as such in a CHANGES section

This is to try to make sure, that even if documented, people will not
accidentally rely on private modules, that have not API stability
guarantees.

5 files changed, 32 insertions, 0 deletions

diff --git a/scripts/Dpkg/BuildEnv.pm b/scripts/Dpkg/BuildEnv.pm
index 2615d5d8e..6d41419f1 100644
--- a/scripts/Dpkg/BuildEnv.pm
+++ b/scripts/Dpkg/BuildEnv.pm
@@ -102,6 +102,12 @@ sub list_modified {
 
 =back
 
+=head1 CHANGES
+
+=head2 Version 0.xx
+
+This is a private module.
+
 =cut
 
 1;
diff --git a/scripts/Dpkg/Control/Types.pm b/scripts/Dpkg/Control/Types.pm
index d8bc0b387..bdcdd239a 100644
--- a/scripts/Dpkg/Control/Types.pm
+++ b/scripts/Dpkg/Control/Types.pm
@@ -53,6 +53,12 @@ use constant {
     CTRL_CHANGELOG => 512,   # Output of dpkg-parsechangelog
 };
 
+=head1 CHANGES
+
+=head2 Version 0.xx
+
+This is a private module.
+
 =head1 AUTHOR
 
 Raphaël Hertzog <hertzog@debian.org>.
diff --git a/scripts/Dpkg/Vendor/Debian.pm b/scripts/Dpkg/Vendor/Debian.pm
index f998c94a5..34bf28134 100644
--- a/scripts/Dpkg/Vendor/Debian.pm
+++ b/scripts/Dpkg/Vendor/Debian.pm
@@ -293,4 +293,12 @@ sub _add_hardening_flags {
     }
 }
 
+=head1 CHANGES
+
+=head2 Version 0.xx
+
+This is a private module.
+
+=cut
+
 1;
diff --git a/scripts/Dpkg/Vendor/Default.pm b/scripts/Dpkg/Vendor/Default.pm
index f2d8affc1..9cb082ab4 100644
--- a/scripts/Dpkg/Vendor/Default.pm
+++ b/scripts/Dpkg/Vendor/Default.pm
@@ -131,6 +131,12 @@ sub run_hook {
 
 =back
 
+=head1 CHANGES
+
+=head2 Version 0.xx
+
+This is a private module.
+
 =cut
 
 1;
diff --git a/scripts/Dpkg/Vendor/Ubuntu.pm b/scripts/Dpkg/Vendor/Ubuntu.pm
index c305e43e2..e83147e77 100644
--- a/scripts/Dpkg/Vendor/Ubuntu.pm
+++ b/scripts/Dpkg/Vendor/Ubuntu.pm
@@ -181,6 +181,12 @@ sub find_launchpad_closes {
 
 =back
 
+=head1 CHANGES
+
+=head2 Version 0.xx
+
+This is a semi-private module. Only documented functions are public.
+
 =cut
 
 1;