Make XFA public more closely match master.

public/fpdf_edit.h

 // Copyright 2014 PDFium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com
 
 #ifndef PUBLIC_FPDF_EDIT_H_
 #define PUBLIC_FPDF_EDIT_H_
 
 #include <stdint.h>
@@ skipping 22 matching lines @@
 // Document functions
 //
 //////////////////////////////////////////////////////////////////////
 
 // Function: FPDF_CreateNewDocument
 //          Create a new PDF document.
 // Parameters:
 //          None.
 // Return value:
 //          A handle to a document. If failed, NULL is returned.
-//
 DLLEXPORT FPDF_DOCUMENT STDCALL FPDF_CreateNewDocument();
 
 //////////////////////////////////////////////////////////////////////
 //
 // Page functions
 //
 //////////////////////////////////////////////////////////////////////
 
 // Function: FPDFPage_New
 //          Construct an empty page.
 // Parameters:
 //          document    -   Handle to document. Returned by FPDF_LoadDocument
 //          and FPDF_CreateNewDocument.
 //          page_index  -   The index of a page.
 //          width       -   The page width.
 //          height      -   The page height.
 // Return value:
 //          The handle to the page.
 // Comments:
 //          Loaded page can be deleted by FPDFPage_Delete.
-// Notes:
-//          The method can not support to create a new page for the document
-//          consists of dynamic XFA fields.
-//
 DLLEXPORT FPDF_PAGE STDCALL FPDFPage_New(FPDF_DOCUMENT document,
                                          int page_index,
                                          double width,
                                          double height);
 
 // Function: FPDFPage_Delete
 //          Delete a PDF page.
 // Parameters:
 //          document    -   Handle to document. Returned by FPDF_LoadDocument
 //          and FPDF_CreateNewDocument.
 //          page_index  -   The index of a page.
 // Return value:
 //          None.
-// Notes:
-//          The method can not support to delete page for the document consists
-//          of dynamic XFA fields.
-//
 DLLEXPORT void STDCALL FPDFPage_Delete(FPDF_DOCUMENT document, int page_index);
 
 // Function: FPDFPage_GetRotation
 //          Get the page rotation. One of following values will be returned:
 //          0(0), 1(90), 2(180), 3(270).
 // Parameters:
 //          page        -   Handle to a page. Returned by FPDFPage_New or
 //          FPDF_LoadPage.
 // Return value:
 //          The PDF page rotation.
 // Comment:
 //          The PDF page rotation is rotated clockwise.
-// Notes:
-//          The method can not support to get the page rotate for the document
-//          consists of dynamic XFA fields.
-//
 DLLEXPORT int STDCALL FPDFPage_GetRotation(FPDF_PAGE page);
 
 // Function: FPDFPage_SetRotation
 //          Set page rotation. One of following values will be set: 0(0), 1(90),
 //          2(180), 3(270).
 // Parameters:
 //          page        -   Handle to a page. Returned by FPDFPage_New or
 //          FPDF_LoadPage.
 //          rotate      -   The value of the PDF page rotation.
 // Return value:
 //          None.
 // Comment:
 //          The PDF page rotation is rotated clockwise.
-// Notes:
-//          The method can not support to set this feature for the document
-//          consists of dynamic XFA fields.
 //
 DLLEXPORT void STDCALL FPDFPage_SetRotation(FPDF_PAGE page, int rotate);
 
 // Function: FPDFPage_InsertObject
 //          Insert an object to the page. The page object is automatically
 //          freed.
 // Parameters:
 //          page        -   Handle to a page. Returned by FPDFPage_New or
 //          FPDF_LoadPage.
 //          page_obj    -   Handle to a page object. Returned by
 //          FPDFPageObj_NewTextObj,FPDFPageObj_NewTextObjEx and
 //                          FPDFPageObj_NewPathObj.
 // Return value:
 //          None.
-// Notes:
-//          The method can not support this feature for the document consists of
-//          dynamic XFA fields.
-//
 DLLEXPORT void STDCALL FPDFPage_InsertObject(FPDF_PAGE page,
                                              FPDF_PAGEOBJECT page_obj);
 
 // Function: FPDFPage_CountObject
 //          Get number of page objects inside the page.
 // Parameters:
 //          page        -   Handle to a page. Returned by FPDFPage_New or
 //          FPDF_LoadPage.
 // Return value:
 //          The number of the page object.
-// Notes:
-//          The method can not support this feature for the document consists of
-//          dynamic XFA fields.
-//
 DLLEXPORT int STDCALL FPDFPage_CountObject(FPDF_PAGE page);
 
 // Function: FPDFPage_GetObject
 //          Get page object by index.
 // Parameters:
 //          page        -   Handle to a page. Returned by FPDFPage_New or
 //          FPDF_LoadPage.
 //          index       -   The index of a page object.
 // Return value:
 //          The handle of the page object. Null for failed.
-// Notes:
-//          The method can not support this feature for the document consists of
-//          dynamic XFA fields.
-//
 DLLEXPORT FPDF_PAGEOBJECT STDCALL FPDFPage_GetObject(FPDF_PAGE page, int index);
 
 // Function: FPDFPage_HasTransparency
 //          Check that whether the content of specified PDF page contains
 //          transparency.
 // Parameters:
 //          page        -   Handle to a page. Returned by FPDFPage_New or
 //          FPDF_LoadPage.
 // Return value:
 //          TRUE means that the PDF page does contains transparency.
 //          Otherwise, returns FALSE.
-// Notes:
-//          The method can not support this feature for the document consists of
-//          dynamic XFA fields.
-//
 DLLEXPORT FPDF_BOOL STDCALL FPDFPage_HasTransparency(FPDF_PAGE page);
 
 // Function: FPDFPage_GenerateContent
 //          Generate PDF Page content.
 // Parameters:
 //          page        -   Handle to a page. Returned by FPDFPage_New or
 //          FPDF_LoadPage.
 // Return value:
 //          True if successful, false otherwise.
 // Comment:
 //          Before you save the page to a file, or reload the page, you must
 //          call the FPDFPage_GenerateContent function.
 //          Or the changed information will be lost.
-// Notes:
-//          The method can not support this feature for the document consists of
-//          dynamic XFA fields.
-//
 DLLEXPORT FPDF_BOOL STDCALL FPDFPage_GenerateContent(FPDF_PAGE page);
 
 //////////////////////////////////////////////////////////////////////
 //
 // Page Object functions
 //
 //////////////////////////////////////////////////////////////////////
 
 // Function: FPDFPageObj_HasTransparency
 //          Check that whether the specified PDF page object contains
@@ skipping 32 matching lines @@
 // Parameters:
 //          page        -   Handle to a page.
 //          a           -   The coefficient "a" of the matrix.
 //          b           -   The coefficient "b" of the matrix.
 //          c           -   The coefficient "c" of the matrix.
 //          d           -   The coefficient "d" of the matrix.
 //          e           -   The coefficient "e" of the matrix.
 //          f           -   The coefficient "f" of the matrix.
 // Return value:
 //          None.
-// Notes:
-//          The method can not support this feature for the document consists of
-//          dynamic XFA fields.
 DLLEXPORT void STDCALL FPDFPage_TransformAnnots(FPDF_PAGE page,
                                                 double a,
                                                 double b,
                                                 double c,
                                                 double d,
                                                 double e,
                                                 double f);
 
 // The page object constants.
 #define FPDF_PAGEOBJ_TEXT 1
@@ skipping 29 matching lines @@
 //          FPDFPageObj_NewImgeObj.
 //          fileAccess      -   The custom file access handler, which specifies
 //          the JPEG image file.
 //  Return Value:
 //          TRUE if successful, FALSE otherwise.
 //  Note:
 //          The image object might already has an associated image, which is
 //          shared and cached by the loaded pages, In this case, we need to
 //          clear the cache of image for all the loaded pages.
 //          Pass pages and count to this API to clear the image cache.
-//          The method can not support this feature for the document consists of
-//          dynamic XFA fields.
-//
 DLLEXPORT FPDF_BOOL STDCALL
 FPDFImageObj_LoadJpegFile(FPDF_PAGE* pages,
                           int nCount,
                           FPDF_PAGEOBJECT image_object,
                           FPDF_FILEACCESS* fileAccess);
 
 // Function: FPDFImageObj_SetMatrix
 //          Set the matrix of an image object.
 // Parameters:
 //          image_object    -   Handle of image object returned by
@@ skipping 18 matching lines @@
 //          Set the bitmap to an image object.
 // Parameters:
 //          pages           -   Pointer's to the start of all loaded pages.
 //          nCount          -   Number of pages.
 //          image_object    -   Handle of image object returned by
 //          FPDFPageObj_NewImgeObj.
 //          bitmap          -   The handle of the bitmap which you want to set
 //          it to the image object.
 // Return value:
 //          TRUE if successful, FALSE otherwise.
-// Notes;
-//          The method can not support this feature for the document consists of
-//          dynamic XFA fields.
-//
 DLLEXPORT FPDF_BOOL STDCALL FPDFImageObj_SetBitmap(FPDF_PAGE* pages,
                                                    int nCount,
                                                    FPDF_PAGEOBJECT image_object,
                                                    FPDF_BITMAP bitmap);
 
 #ifdef __cplusplus
 }
 #endif
 
 #endif  // PUBLIC_FPDF_EDIT_H_