[mapguide-commits] r10198 - in branches/4.0/MgDev: Bindings/src/IMake Common/MapGuideCommon/MapLayer Common/MapGuideCommon/Services

svn_mapguide at osgeo.org svn_mapguide at osgeo.org
Fri Oct 3 09:21:16 PDT 2025


Author: jng
Date: 2025-10-03 09:21:15 -0700 (Fri, 03 Oct 2025)
New Revision: 10198

Modified:
   branches/4.0/MgDev/Bindings/src/IMake/IMake.cpp
   branches/4.0/MgDev/Common/MapGuideCommon/MapLayer/Layer.h
   branches/4.0/MgDev/Common/MapGuideCommon/MapLayer/Map.h
   branches/4.0/MgDev/Common/MapGuideCommon/Services/RenderingService.h
   branches/4.0/MgDev/Common/MapGuideCommon/Services/TileService.h
Log:
IMake: Fix up <exception> doc generation so that it emits MgException with code MgExceptionCodes.code_name format

Also fix up invalid parameter references in various docs.

Modified: branches/4.0/MgDev/Bindings/src/IMake/IMake.cpp
===================================================================
--- branches/4.0/MgDev/Bindings/src/IMake/IMake.cpp	2025-09-28 15:44:55 UTC (rev 10197)
+++ branches/4.0/MgDev/Bindings/src/IMake/IMake.cpp	2025-10-03 16:21:15 UTC (rev 10198)
@@ -702,7 +702,7 @@
                 output.append(".MgException");
                 output.append("\" /> with code <see cref=\"");
                 output.append(nspace);
-                output.append("MgExceptionCodes.");
+                output.append(".MgExceptionCodes.");
                 output.append(mgClassName);
                 output.append("\" />");
             }
@@ -1216,22 +1216,12 @@
                             csharpDoc.append("///<exception cref=\"");
                             csharpDoc.append(nspace);
                             csharpDoc.append(".MgException\">");
-                            if (eelems.size() > 1) {
-                                csharpDoc.append("with code (<see cref=\"");
-                                csharpDoc.append(nspace);
-                                csharpDoc.append(".MgExceptionCodes.");
-                                csharpDoc.append(eelems[0]);
-                                csharpDoc.append("\" />) ");
-                                for (size_t j = 1; j < eelems.size(); j++) {
-                                    csharpDoc.append(" ");
-                                    csharpDoc.append(eelems[j]);
-                                }
-                                csharpDoc.append("</exception>\n");
-                            }
-                            else {
-                                csharpDoc.append(eelems[0]);
-                                csharpDoc.append("\"></exception>\n");
-                            }
+                            csharpDoc.append("with code (<see cref=\"");
+                            csharpDoc.append(nspace);
+                            csharpDoc.append(".MgExceptionCodes.");
+                            csharpDoc.append(eelems[0]);
+                            csharpDoc.append("\" />) ");
+                            csharpDoc.append("</exception>\n");
                         }
                     }
                 }

Modified: branches/4.0/MgDev/Common/MapGuideCommon/MapLayer/Layer.h
===================================================================
--- branches/4.0/MgDev/Common/MapGuideCommon/MapLayer/Layer.h	2025-09-28 15:44:55 UTC (rev 10197)
+++ branches/4.0/MgDev/Common/MapGuideCommon/MapLayer/Layer.h	2025-10-03 16:21:15 UTC (rev 10198)
@@ -583,12 +583,6 @@
     /// virtual MgByteReader GenerateLegendImage(int width, int height, string format, int geomType, int themeCategory);
     /// \htmlinclude SyntaxBottom.html
     ///
-    /// \param resource (MgResourceIdentifier)
-    /// Input
-    /// MgResourceIdentifier object identifying the layer definition resource.
-    /// \param scale (double)
-    /// Input
-    /// The scale at which the symbolization is requested.
     /// \param width (int)
     /// Input
     /// The requested image width in pixels.
@@ -722,9 +716,6 @@
     /// virtual MgByteReader GenerateLegendImage(double scale, int width, int height, string format, int geomType, int themeCategory);
     /// \htmlinclude SyntaxBottom.html
     ///
-    /// \param resource (MgResourceIdentifier)
-    /// Input
-    /// MgResourceIdentifier object identifying the layer definition resource.
     /// \param scale (double)
     /// Input
     /// The scale at which the symbolization is requested.

Modified: branches/4.0/MgDev/Common/MapGuideCommon/MapLayer/Map.h
===================================================================
--- branches/4.0/MgDev/Common/MapGuideCommon/MapLayer/Map.h	2025-09-28 15:44:55 UTC (rev 10197)
+++ branches/4.0/MgDev/Common/MapGuideCommon/MapLayer/Map.h	2025-10-03 16:21:15 UTC (rev 10198)
@@ -404,7 +404,7 @@
     /// \endcode
     /// \htmlinclude ExampleBottom.html
     ///
-    virtual void Create(MgResourceIdentifier* resource, CREFSTRING mapName, INT32 displayWidth, INT32 displayheight, double x, double y, double scale, INT32 dpi);
+    virtual void Create(MgResourceIdentifier* resource, CREFSTRING mapName, INT32 displayWidth, INT32 displayHeight, double x, double y, double scale, INT32 dpi);
 
     //////////////////////////////////////////////////////////////////
     /// \brief

Modified: branches/4.0/MgDev/Common/MapGuideCommon/Services/RenderingService.h
===================================================================
--- branches/4.0/MgDev/Common/MapGuideCommon/Services/RenderingService.h	2025-09-28 15:44:55 UTC (rev 10197)
+++ branches/4.0/MgDev/Common/MapGuideCommon/Services/RenderingService.h	2025-10-03 16:21:15 UTC (rev 10198)
@@ -320,9 +320,6 @@
     /// \param dpi
     /// Input
     /// Specifies the dpi of the tile to return.
-    /// \param tileImageFormat
-    /// Input
-    /// Specifies the image format of the tile to return.
     ///
     /// \return
     /// A byte reader containing the rendered tile image.
@@ -513,6 +510,9 @@
     /// \param bClip
     /// Input
     /// true if you want to clip feature geometry
+    /// \param selectionColor
+    /// Input
+    /// The color to use for rendered selections
     ///
     /// \return
     /// A byte reader containing the rendered image

Modified: branches/4.0/MgDev/Common/MapGuideCommon/Services/TileService.h
===================================================================
--- branches/4.0/MgDev/Common/MapGuideCommon/Services/TileService.h	2025-09-28 15:44:55 UTC (rev 10197)
+++ branches/4.0/MgDev/Common/MapGuideCommon/Services/TileService.h	2025-10-03 16:21:15 UTC (rev 10198)
@@ -112,9 +112,9 @@
     /// Clears the entire tile cache for the given tile set.  Tiles for all base
     /// map layer groups and finite scales will be removed.
     ///
-    /// \param map
+    /// \param tileSet
     /// Input
-    /// Specifies the map whose tile cache will be cleared.
+    /// Specifies the tile set whose tile cache will be cleared.
     ///
     /// \since 3.0
     virtual void ClearCache(MgResourceIdentifier* tileSet) = 0;



More information about the mapguide-commits mailing list