Merge pull request #28010 from asmorkalov:as/solve_pnp_iterative

Solve PnP iterative documentation update

modules/calib3d/include/opencv2/calib3d.hpp

@@ -1059,7 +1059,8 @@ More information about Perspective-n-Points is described in @ref calib3d_solvePn
        of the P3P problem, the last one is used to retain the best solution that minimizes the reprojection error).
    -   With @ref SOLVEPNP_ITERATIVE method and `useExtrinsicGuess=true`, the minimum number of points is 3 (3 points
        are sufficient to compute a pose but there are up to 4 solutions). The initial solution should be close to the
-       global solution to converge.
+       global solution to converge. The function returns true if some solution is found. User code is responsible for
+       solution quality assessment.
    -   With @ref SOLVEPNP_IPPE input points must be >= 4 and object points must be coplanar.
    -   With @ref SOLVEPNP_IPPE_SQUARE this is a special case suitable for marker pose estimation.
        Number of input points must be 4. Object points must be defined in the following order:
@@ -4331,7 +4332,7 @@ optimization. It is the \f$max(width,height)/\pi\f$ or the provided \f$f_x\f$, \
                                   TermCriteria criteria = TermCriteria(TermCriteria::COUNT + TermCriteria::EPS, 100, DBL_EPSILON));
 
     /**
-    @brief Finds an object pose from 3D-2D point correspondences for fisheye camera moodel.
+    @brief Finds an object pose from 3D-2D point correspondences for fisheye camera model.
 
     @param objectPoints Array of object points in the object coordinate space, Nx3 1-channel or
     1xN/Nx1 3-channel, where N is the number of points. vector\<Point3d\> can also be passed here.
@@ -4347,7 +4348,7 @@ optimization. It is the \f$max(width,height)/\pi\f$ or the provided \f$f_x\f$, \
     vectors, respectively, and further optimizes them.
     @param flags Method for solving a PnP problem: see @ref calib3d_solvePnP_flags
     @param criteria Termination criteria for internal undistortPoints call.
-    The function interally undistorts points with @ref undistortPoints and call @ref cv::solvePnP,
+    The function internally undistorts points with @ref undistortPoints and call @ref cv::solvePnP,
     thus the input are very similar. More information about Perspective-n-Points is described in @ref calib3d_solvePnP
     for more information.
     */