Make XFA public more closely match master.

public/fpdfview.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
 
 // NOTE: External docs refer to this file as "fpdfview.h", so do not rename
 // despite lack of consitency with other public files.
 
 #ifndef PUBLIC_FPDFVIEW_H_
@@ skipping 162 matching lines @@
 
 // Function: FPDF_InitLibraryWithConfig
 //          Initialize the FPDFSDK library
 // Parameters:
 //          config - configuration information as above.
 // Return value:
 //          None.
 // Comments:
 //          You have to call this function before you can call any PDF
 //          processing functions.
-DLLEXPORT void STDCALL
-FPDF_InitLibraryWithConfig(const FPDF_LIBRARY_CONFIG* config);
+DLLEXPORT void STDCALL FPDF_InitLibraryWithConfig(
+    const FPDF_LIBRARY_CONFIG* config);
 
 // Function: FPDF_DestroyLibary
 //          Release all resources allocated by the FPDFSDK library.
 // Parameters:
 //          None.
 // Return value:
 //          None.
 // Comments:
 //          You can call this function to release all memory blocks allocated by
 //          the library.
@@ skipping 20 matching lines @@
 // Parameters:
 //          file_path -  Path to the PDF file (including extension).
 //          password  -  A string used as the password for the PDF file.
 //                       If no password is needed, empty or NULL can be used.
 // Return value:
 //          A handle to the loaded document, or NULL on failure.
 // Comments:
 //          Loaded document can be closed by FPDF_CloseDocument().
 //          If this function fails, you can use FPDF_GetLastError() to retrieve
 //          the reason why it failed.
-//          The application should call ::FPDF_LoadXFA function after PDF
-//          document loaded
-//          to support XFA fields in fpdfformfill.h file.
+// Notes:
+//          The application should call FPDF_LoadXFA function after PDF
+//          document loaded to support XFA fields in fpdfformfill.h file.
 DLLEXPORT FPDF_DOCUMENT STDCALL FPDF_LoadDocument(FPDF_STRING file_path,
                                                   FPDF_BYTESTRING password);
 
 // Function: FPDF_LoadMemDocument
 //          Open and load a PDF document from memory.
 // Parameters:
 //          data_buf    -   Pointer to a buffer containing the PDF document.
 //          size        -   Number of bytes in the PDF document.
 //          password    -   A string used as the password for the PDF file.
 //                          If no password is needed, empty or NULL can be used.
@@ skipping 136 matching lines @@
 //          fileVersion -   The PDF file version. File version: 14 for 1.4, 15
 //                          for 1.5, ...
 // Return value:
 //          True if succeeds, false otherwise.
 // Comments:
 //          If the document was created by FPDF_CreateNewDocument,
 //          then this function will always fail.
 DLLEXPORT FPDF_BOOL STDCALL FPDF_GetFileVersion(FPDF_DOCUMENT doc,
                                                 int* fileVersion);
 
-#define FPDF_ERR_SUCCESS 0    // No error.

[Lei Zhang, 2015/11/20 01:57:43]

This is better, we prefer 2 spaces

-#define FPDF_ERR_UNKNOWN 1    // Unknown error.
-#define FPDF_ERR_FILE 2       // File not found or could not be opened.
-#define FPDF_ERR_FORMAT 3     // File not in PDF format or corrupted.
-#define FPDF_ERR_PASSWORD 4   // Password required or incorrect password.
-#define FPDF_ERR_SECURITY 5   // Unsupported security scheme.
-#define FPDF_ERR_PAGE 6       // Page not found or content error.
-#define FPDF_ERR_XFALOAD 7    // Load XFA error.
-#define FPDF_ERR_XFALAYOUT 8  // Layout XFA error.
+#define FPDF_ERR_SUCCESS 0   // No error.
+#define FPDF_ERR_UNKNOWN 1   // Unknown error.
+#define FPDF_ERR_FILE 2      // File not found or could not be opened.
+#define FPDF_ERR_FORMAT 3    // File not in PDF format or corrupted.
+#define FPDF_ERR_PASSWORD 4  // Password required or incorrect password.
+#define FPDF_ERR_SECURITY 5  // Unsupported security scheme.
+#define FPDF_ERR_PAGE 6      // Page not found or content error.
+#define FPDF_ERR_XFALOAD 7   // Load XFA error.
+#define FPDF_ERR_XFALAYOUT 8 // Layout XFA error.
 
 // Function: FPDF_GetLastError
 //          Get last error code when a function fails.
 // Parameters:
 //          None.
 // Return value:
 //          A 32-bit integer indicating error code as defined above.
 // Comments:
 //          If the previous SDK call succeeded, the return value of this
 //          function is not defined.
@@ skipping 119 matching lines @@
 //          size_y      -   Vertical size (in pixels) for displaying the page.
 //          rotate      -   Page orientation:
 //                            0 (normal)
 //                            1 (rotated 90 degrees clockwise)
 //                            2 (rotated 180 degrees)
 //                            3 (rotated 90 degrees counter-clockwise)
 //          flags       -   0 for normal display, or combination of flags
 //                          defined above.
 // Return value:
 //          None.
-// Notes:
-//          FPDF_RenderPage can not be used if the document contains dynamic
-//          form fields.
 DLLEXPORT void STDCALL FPDF_RenderPage(HDC dc,
                                        FPDF_PAGE page,
                                        int start_x,
                                        int start_y,
                                        int size_x,
                                        int size_y,
                                        int rotate,
                                        int flags);
 #endif
 
@@ skipping 12 matching lines @@
 //          size_y      -   Vertical size (in pixels) for displaying the page.
 //          rotate      -   Page orientation:
 //                            0 (normal)
 //                            1 (rotated 90 degrees clockwise)
 //                            2 (rotated 180 degrees)
 //                            3 (rotated 90 degrees counter-clockwise)
 //          flags       -   0 for normal display, or combination of flags
 //                          defined above.
 // Return value:
 //          None.
-// Notes:
-//          FPDF_RenderPageBitmap can not be used if the document contains
-//          dynamic form fields.
 DLLEXPORT void STDCALL FPDF_RenderPageBitmap(FPDF_BITMAP bitmap,
                                              FPDF_PAGE page,
                                              int start_x,
                                              int start_y,
                                              int size_x,
                                              int size_y,
                                              int rotate,
                                              int flags);
 
 // Function: FPDF_ClosePage
@@ skipping 350 matching lines @@
 
 // Function: FPDF_BStr_Clear
 //          Helper function to clear a byte string.
 DLLEXPORT FPDF_RESULT STDCALL FPDF_BStr_Clear(FPDF_BSTR* str);
 
 #ifdef __cplusplus
 }
 #endif
 
 #endif  // PUBLIC_FPDFVIEW_H_