From 4acf63fd9adbca56e6431bc1d317db2e110f179a Mon Sep 17 00:00:00 2001
From: Adriaan de Groot <groot@kde.org>
Date: Tue, 8 Oct 2019 17:31:51 +0200
Subject: [PATCH] [unpackfs] Document fields of the UnpackEntry

 - Document fields
 - While here, remove code for special-casing single-file copies.
   Those already work, based on rsync.
---
 src/modules/unpackfs/main.py | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/src/modules/unpackfs/main.py b/src/modules/unpackfs/main.py
index 0c511b959..3a64c6284 100644
--- a/src/modules/unpackfs/main.py
+++ b/src/modules/unpackfs/main.py
@@ -52,6 +52,17 @@ class UnpackEntry:
     __slots__ = ['source', 'sourcefs', 'destination', 'copied', 'total']
 
     def __init__(self, source, sourcefs, destination):
+        """
+        @p source is the source file name (might be an image file, or
+            a directory, too)
+        @p sourcefs is a type indication; "file" is special, as is
+            "squashfs".
+        @p destination is where the files from the source go. This is
+            **already** prefixed by rootMountPoint, so should be a 
+            valid absolute path within the host system.
+            
+        The members copied and total are filled in by the copying process.
+        """
         self.source = source
         self.sourcefs = sourcefs
         self.destination = destination
@@ -85,7 +96,6 @@ def list_excludes(destination):
 
     return lst
 
-
 def file_copy(source, dest, progress_cb):
     """
     Extract given image using rsync.
@@ -303,10 +313,6 @@ class UnpackOperation:
         try:
             if entry.is_file():
                 source = entry.source
-                if entry.total <= 1:
-                    # If there is one file, *and* the target does not exist (as a file or dir)
-                    # but the dirname of the target does, we should copy just one file and rename.
-                    pass
             else:
                 source = imgmountdir