1 files changed, 45 insertions, 0 deletions
diff --git a/doc/en/occupied-space.docbook b/doc/en/occupied-space.docbook
new file mode 100644
index 0000000..6d80921
--- /dev/null
+++ b/doc/en/occupied-space.docbook
@@ -0,0 +1,45 @@
+<sect1 id="calculate">
+  <title>Calculate Occupied Space</title>
+  <indexterm>
+    <primary>Occupied Space</primary>
+  </indexterm>
+  <!-- Thanks to Heiner Eichmann -->
+  <para>There are two ways to calculate the occupied space of
+  files/directories. 
+  <itemizedlist>
+    <listitem>
+      <para>Pressing the 
+      <keycap>SPACE</keycap> on a directory under the cursor
+      instantly calculates the occupied size. Pressing 
+      <keycap>SPACE</keycap> a second time will toggle the selection
+      of the directory without affecting the selection status of
+      other files/directories.</para>
+    </listitem>
+    <listitem>
+      <para>To calculate how much disk space is occupied by the
+      selected files and directories in the active panel select 
+      <emphasis role="bold">
+        <menuchoice>
+          <guimenu>File</guimenu>
+          <guimenuitem>Calculate Occupied Space</guimenuitem>
+        </menuchoice>
+      </emphasis>. After a small delay, a dialog box will be
+      displayed with total occupied space and the number of files
+      and directories you selected. The space occupied by every
+      selected directory will be shown as if the user just pressed 
+      <keycap>SPACE</keycap> on those directories. If the active
+      panel is browsing an archive, the numbers will apply to the
+      unpacked size of the selected files and directories, not
+      their compressed size. After the calculation the selection
+      state will be toggled and the cursor will move one step
+      downwards.</para>
+    </listitem>
+  </itemizedlist>Calculating the occupied space on remote
+  file systems is supported. 
+  <note>
+    <para>Performing this operation on a very large file system
+    (thousands of files) may be time-consuming. You can cancel the
+    calculation process at any time by clicking the 
+    <guibutton>Cancel</guibutton> button.</para>
+  </note></para>
+</sect1>