From 362aa36d0956f8bb68f49e7b85523d26b0da7834 Mon Sep 17 00:00:00 2001
From: James Hawkins <truiken@gmail.com>
Date: Wed, 11 Jan 2006 12:12:54 +0100
Subject: [PATCH] cabinet: Add documentation for FDITruncateCabinet.

---
 dlls/cabinet/fdi.c | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/dlls/cabinet/fdi.c b/dlls/cabinet/fdi.c
index 20d00fd9ae9..136cf27d58c 100644
--- a/dlls/cabinet/fdi.c
+++ b/dlls/cabinet/fdi.c
@@ -2819,7 +2819,21 @@ BOOL __cdecl FDIDestroy(HFDI hfdi)
 /***********************************************************************
  *		FDITruncateCabinet (CABINET.24)
  *
- * Undocumented and unimplemented.
+ * Removes all folders of a cabinet file after and including the
+ * specified folder number.
+ * 
+ * PARAMS
+ *   hfdi            [I] Handle to the FDI context.
+ *   pszCabinetName  [I] Filename of the cabinet.
+ *   iFolderToDelete [I] Index of the first folder to delete.
+ * 
+ * RETURNS
+ *   Success: TRUE.
+ *   Failure: FALSE.
+ * 
+ * NOTES
+ *   The PFNWRITE function supplied to FDICreate must truncate the
+ *   file at the current position if the number of bytes to write is 0.
  */
 BOOL __cdecl FDITruncateCabinet(
 	HFDI    hfdi,