Fix formatting in pyqgis documentation (#9396)

* Fix API documentation

* Fix sip doc

Author: DelazJ

python/gui/auto_generated/qgisinterface.sip.in

@@ -615,8 +615,9 @@ status bar (do not use the native Qt statusBar() method).
     virtual void takeAppScreenShots( const QString &saveDirectory, const int categories = 0 );
 %Docstring
 Take screenshots for user documentation
-@param saveDirectory path where the screenshots will be saved
-@param categories an int as a flag value of QgsAppScreenShots.Categories
+
+:param saveDirectory: path where the screenshots will be saved
+:param categories: an int as a flag value of QgsAppScreenShots.Categories
 
 .. versionadded:: 3.4
 %End

src/gui/qgisinterface.h

@@ -543,8 +543,9 @@ class GUI_EXPORT QgisInterface : public QObject
 
     /**
      * Take screenshots for user documentation
-     * @param saveDirectory path where the screenshots will be saved
-     * @param categories an int as a flag value of QgsAppScreenShots::Categories
+     *
+     * \param saveDirectory path where the screenshots will be saved
+     * \param categories an int as a flag value of QgsAppScreenShots::Categories
      * \since QGIS 3.4
      */
     virtual void takeAppScreenShots( const QString &saveDirectory, const int categories = 0 ) {Q_UNUSED( saveDirectory ); Q_UNUSED( categories );}