From 24658b4d6a62c78a2b009c8903027d1198ad3508 Mon Sep 17 00:00:00 2001
From: Thierry Vignaud <thierry.vignaud@gmail.com>
Date: Mon, 12 May 2014 19:03:07 +0200
Subject: document pack_header()

---
 NEWS    |  2 ++
 URPM.pm | 12 ++++++++++++
 2 files changed, 14 insertions(+)

diff --git a/NEWS b/NEWS
index 24d9fc7..2e86491 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,5 @@
+- enhanced doc
+
 Version 4.30 - 1 May 2014
 
 - fix 64k size limit on provides size that break installing 32 bit kernel for
diff --git a/URPM.pm b/URPM.pm
index a84c0ce..e308c9d 100644
--- a/URPM.pm
+++ b/URPM.pm
@@ -733,6 +733,18 @@ Just the obsoleted package name.
 
 =item $package->pack_header()
 
+If a header is associated with the package, fill the package fields from
+the header's tags (NEVRA,
+requires/suggests/obsoletes/conflicts/provides/summary)
+then free the header
+
+It's useful when traversing the rpm DB, if one wants to keep around a
+package from the DB
+else the info would not be available outside the traverse_*() function.
+
+It's also useful when creating a URPM_Package from a package file in
+order to shrink memory footprint.
+
 =item $package->packager()
 
 =item $package->payload_format()
-- 
cgit v1.2.1