update to internal commit e5bdfab1

Author: DMGithubPublisher

_includes/dcvNav.html

@@ -11,6 +11,11 @@
     }
   }
 </style>
+
+{%- assign docHomePage = site.docHomePage -%}
+{%- if page.docHomePage -%}
+    {%- assign docHomePage = page.docHomePage -%}
+{%- endif -%}
 
   <div id="CaptureVision" class="main">
       <div id="CaptureVisionMenu" class="productMenu">
@@ -19,10 +24,10 @@
                   <div class="col-xs-12">
                       <ul class="menuList">
                           <!---->
-                          <li class="title"><a class="orangeLink" href="{{site.overview}}">Dynamsoft Capture Vision</a></li>
+                          <li class="title"><a class="orangeLink" href="/capture-vision/docs/core/">Dynamsoft Capture Vision</a></li>
                           <li class="item overview">
                               <!---->
-                              <a class="textUpperCase" href="{{site.docHomePage}}">Documentation</a>
+                              <a class="textUpperCase" href="{{docHomePage}}">Documentation</a>
                           </li>
                       </ul>
                   </div>
@@ -42,10 +47,10 @@
                       <div class="col-xs-12">
                           <ul class="menuList">
                               <!---->
-                              <li class="title"><a class="orangeLink" href="{{site.overview}}">Dynamsoft Capture Vision</a></li>
+                              <li class="title"><a class="orangeLink" href="/capture-vision/docs/core/">Dynamsoft Capture Vision</a></li>
                               <li class="item overview">
                                   <!---->
-                                  <a class="textUpperCase" href="{{site.docHomePage}}">Documentation</a>
+                                  <a class="textUpperCase" href="{{docHomePage}}">Documentation</a>
                               </li>
                           </ul>
                       </div>

programming/cplusplus/api-reference/license/license-manager.md

@@ -50,22 +50,6 @@ static int InitLicense(const char* pLicense, char errorMsgBuffer[] = NULL, const
 
 Returns 0 if the license is initialized successfully, a negative value indicating an error otherwise.
 
-**Code Snippet**
-
-```cpp
-int errorCode = 0;
-char szErrorMsg[256];
-errorCode = CLicenseManager::InitLicense("YOUR-LICENSE-KEY", szErrorMsg, 256);
-if (errorCode != ErrorCode::EC_OK && errorCode != ErrorCode::EC_LICENSE_CACHE_USED)
-{
-    cout << "License initialization failed: ErrorCode: " << errorCode << ", ErrorString: " << szErrorMsg << endl;
-}
-else
-{
-    // other codes...
-}
-```
-
 ### SetDeviceFriendlyName
 
 It is used to set the friendly name of the device.
@@ -82,6 +66,10 @@ static int SetDeviceFriendlyName(const char* name)
 
 Returns 0 if the friendly name is set successfully, a negative value indicating an error otherwise.
 
+**Remarks**
+
+This function must be called before function `InitLicense` to ensure correct functionality.
+
 ### SetMaxConcurrentInstanceCount
 
 It is used to set the maximum number of allowed instances for the given device.
@@ -98,6 +86,10 @@ static int SetMaxConcurrentInstanceCount(int countForThisDevice)
 
 Returns error code (returns 0 if the function operates successfully). 
 
+**Remarks**
+
+This function must be called before function `InitLicense` to ensure correct functionality.
+
 ### GetDeviceUUID
 
 It is used to get the unique identifier of the device.
@@ -121,6 +113,10 @@ static int GetDeviceUUID(int uuidGenerationMethod, char uuidBuffer[] , const int
 
 Returns 0 if the UUID is generated successfully, a negative value indicating an error otherwise.
 
+**Remarks**
+
+This function must be called before function `InitLicense` to ensure correct functionality.
+
 ### SetLicenseCachePath
 
 It is used to set the directory path for the license cache.
@@ -137,3 +133,26 @@ static int SetLicenseCachePath(const char* directoryPath)
 
 Returns 0 if the directory path is set successfully, a negative value indicating an error otherwise.
 
+**Remarks**
+
+This function must be called before function `InitLicense` to ensure correct functionality.
+
+## Code Snippet
+
+```cpp
+int errorCode = 0;
+char szErrorMsg[256];
+char szUUID[256];
+CLicenseManager::SetLicenseCachePath("DIRECTORY-PATH-FOR-LICENSE-CACHE");
+CLicenseManager::GetDeviceUUID(1, szUUID, 256);
+CLicenseManager::SetDeviceFriendlyName("FRIENDLY-NAME");
+errorCode = CLicenseManager::InitLicense("YOUR-LICENSE-KEY", szErrorMsg, 256);
+if (errorCode != ErrorCode::EC_OK && errorCode != ErrorCode::EC_LICENSE_CACHE_USED)
+{
+    cout << "License initialization failed: ErrorCode: " << errorCode << ", ErrorString: " << szErrorMsg << endl;
+}
+else
+{
+    // other codes...
+}
+```

programming/cplusplus/index.md

@@ -45,7 +45,7 @@ The best way to begin with Dynamsoft Capture Vision C++ Edition is to follow the
   - Minimum GLIBC Version: GLIBC_2.18 or higher
   - Compiler: G++ 5.4 or higher
 
-- MacOS (not included in the trial package, contact us to get the SDK)
+- macOS (not included in the trial package, contact us to get the SDK)
   - Supported Versions: 10.15+
   - Architecture: x64 and ARM 64-bit
 

programming/cplusplus/release-notes/cpp-2.md

@@ -13,7 +13,7 @@ needGenerateH3Content: false
 ### Highlights
 
 - Added to-the-latest overlapping feature.
-- Added ARM64 and MacOS components back to the SDK.
+- Added ARM64 and macOS components back to the SDK.
 - Improved the error handling logic of methods `Capture`, `StartCapturing` and `InitLicense` to clearly report a licensing issue.
 
 ### Changelogs

programming/dotnet/api-reference/license/license-manager.md

@@ -68,6 +68,10 @@ static int SetDeviceFriendlyName(string name)
 
 Returns 0 if the friendly name is set successfully, a negative value indicating an error otherwise.
 
+**Remarks**
+
+This function must be called before function `InitLicense` to ensure correct functionality.
+
 **See Also**
 
 [EnumErrorCode]({{ site.dcvb_enumerations }}core/error-code.html?lang=dotnet)
@@ -88,6 +92,10 @@ static int SetMaxConcurrentInstanceCount(int countForThisDevice)
 
 Returns error code (returns 0 if the function operates successfully). 
 
+**Remarks**
+
+This function must be called before function `InitLicense` to ensure correct functionality.
+
 **See Also**
 
 [EnumErrorCode]({{ site.dcvb_enumerations }}core/error-code.html?lang=dotnet)
@@ -113,6 +121,10 @@ static int GetDeviceUUID(int uuidGenerationMethod, out string uuidBuffer)
 
 Returns 0 if the UUID is generated successfully, a negative value indicating an error otherwise.
 
+**Remarks**
+
+This function must be called before function `InitLicense` to ensure correct functionality.
+
 ### SetLicenseCachePath
 
 Sets the directory path for the license cache.
@@ -129,6 +141,10 @@ static int SetLicenseCachePath(string directoryPath)
 
 Returns 0 if the directory path is set successfully, a negative value indicating an error otherwise.
 
+**Remarks**
+
+This function must be called before function `InitLicense` to ensure correct functionality.
+
 **See Also**
 
 [EnumErrorCode]({{ site.dcvb_enumerations }}core/error-code.html?lang=dotnet)

programming/python/api-reference/license/license-manager.md

@@ -70,6 +70,10 @@ Returns a tuple containing following elements:
 - `error_code` <*int*>: The error code indicating the status of the operation.
 - `error_message` <*str*>: A descriptive message explaining the error.
 
+**Remarks**
+
+This function must be called before function `init_license` to ensure correct functionality.
+
 **See Also**
 
 [EnumErrorCode]({{ site.dcvb_enumerations }}core/error-code.html?lang=python)
@@ -93,6 +97,10 @@ Returns a tuple containing following elements:
 - `error_code` <*int*>: The error code indicating the status of the operation.
 - `error_message` <*str*>: A descriptive message explaining the error.
 
+**Remarks**
+
+This function must be called before function `init_license` to ensure correct functionality.
+
 **See Also**
 
 [EnumErrorCode]({{ site.dcvb_enumerations }}core/error-code.html?lang=python)
@@ -120,6 +128,10 @@ Returns a tuple containing following elements:
 - `error_message` <*str*>: A descriptive message explaining the error.
 - `uuid` <*str*>: The unique identifier of the device.
 
+**Remarks**
+
+This function must be called before function `init_license` to ensure correct functionality.
+
 ### set_license_cache_path
 
 Sets the directory path for the license cache.
@@ -139,6 +151,10 @@ Returns a tuple containing following elements:
 - `error_code` <*int*>: The error code indicating the status of the operation.
 - `error_message` <*str*>: A descriptive message explaining the error.
 
+**Remarks**
+
+This function must be called before function `init_license` to ensure correct functionality.
+
 **See Also**
 
 [EnumErrorCode]({{ site.dcvb_enumerations }}core/error-code.html?lang=python)