[mapguide-commits] r10061 - in branches/4.0/MgDev: . BuildTools Doc Doc/dotnet_api Doc/dotnet_api/docs

svn_mapguide at osgeo.org svn_mapguide at osgeo.org
Fri Nov 10 08:16:28 PST 2023


Author: jng
Date: 2023-11-10 08:16:27 -0800 (Fri, 10 Nov 2023)
New Revision: 10061

Added:
   branches/4.0/MgDev/Doc/dotnet_api/
   branches/4.0/MgDev/Doc/dotnet_api/docfx.json
   branches/4.0/MgDev/Doc/dotnet_api/docs/
   branches/4.0/MgDev/Doc/dotnet_api/docs/getting-started.md
   branches/4.0/MgDev/Doc/dotnet_api/docs/introduction.md
   branches/4.0/MgDev/Doc/dotnet_api/docs/toc.yml
   branches/4.0/MgDev/Doc/dotnet_api/index.md
   branches/4.0/MgDev/Doc/dotnet_api/toc.yml
   branches/4.0/MgDev/acquire-doctools.ps1
Removed:
   branches/4.0/MgDev/Doc/MgDesktop_Doxyfile
   branches/4.0/MgDev/Doc/MgDesktop_run_doxygen.bat
   branches/4.0/MgDev/Doc/MgOpenSource_Doxyfile
   branches/4.0/MgDev/Doc/MgOpenSource_run_doxygen.bat
   branches/4.0/MgDev/Doc/MgOpenSource_run_doxygen.sh
Modified:
   branches/4.0/MgDev/BuildTools/
   branches/4.0/MgDev/build.bat
   branches/4.0/MgDev/setenvironment64.bat
Log:
#2877:

 - Add new top-level acquire-doctools.ps1 powershell script that ensures docfx is installed and doctum.phar is downloaded
 - Remove top-level doxygen build files and remove doxygen references from our top-level scripts
 - Add initial docfx project

Index: branches/4.0/MgDev/BuildTools
===================================================================
--- branches/4.0/MgDev/BuildTools	2023-11-10 15:08:48 UTC (rev 10060)
+++ branches/4.0/MgDev/BuildTools	2023-11-10 16:16:27 UTC (rev 10061)

Property changes on: branches/4.0/MgDev/BuildTools
___________________________________________________________________
Added: svn:ignore
## -0,0 +1 ##
+doctum.phar
Deleted: branches/4.0/MgDev/Doc/MgDesktop_Doxyfile
===================================================================
--- branches/4.0/MgDev/Doc/MgDesktop_Doxyfile	2023-11-10 15:08:48 UTC (rev 10060)
+++ branches/4.0/MgDev/Doc/MgDesktop_Doxyfile	2023-11-10 16:16:27 UTC (rev 10061)
@@ -1,360 +0,0 @@
-# Doxyfile 1.8.0
-
-#---------------------------------------------------------------------------
-# Project related configuration options
-#---------------------------------------------------------------------------
-DOXYFILE_ENCODING      = UTF-8
-PROJECT_NAME           = "mg-desktop" "API" "Reference"
-PROJECT_NUMBER         = 
-PROJECT_BRIEF          =
-PROJECT_LOGO           = 
-OUTPUT_DIRECTORY       =
-CREATE_SUBDIRS         = YES
-OUTPUT_LANGUAGE        = English
-BRIEF_MEMBER_DESC      = YES
-REPEAT_BRIEF           = YES
-ABBREVIATE_BRIEF       =
-ALWAYS_DETAILED_SEC    = NO
-INLINE_INHERITED_MEMB  = NO
-FULL_PATH_NAMES        = NO
-STRIP_FROM_PATH        =
-STRIP_FROM_INC_PATH    =
-SHORT_NAMES            = NO
-JAVADOC_AUTOBRIEF      = NO
-QT_AUTOBRIEF           = NO
-MULTILINE_CPP_IS_BRIEF = NO
-INHERIT_DOCS           = YES
-SEPARATE_MEMBER_PAGES  = YES
-TAB_SIZE               = 4
-ALIASES                = ProdName="mg-desktop"
-ALIASES               += DevGuide="<em>MapGuide Open Source Developer's Guide</em>"
-ALIASES               += note1=""
-ALIASES               += note2=""
-TCL_SUBST              =
-OPTIMIZE_OUTPUT_FOR_C  = NO
-OPTIMIZE_OUTPUT_JAVA   = NO
-OPTIMIZE_FOR_FORTRAN   = NO
-OPTIMIZE_OUTPUT_VHDL   = NO
-EXTENSION_MAPPING      =
-MARKDOWN_SUPPORT       = YES
-BUILTIN_STL_SUPPORT    = NO
-CPP_CLI_SUPPORT        = NO
-SIP_SUPPORT            = NO
-IDL_PROPERTY_SUPPORT   = NO
-DISTRIBUTE_GROUP_DOC   = NO
-SUBGROUPING            = YES
-INLINE_GROUPED_CLASSES = NO
-INLINE_SIMPLE_STRUCTS  = NO
-TYPEDEF_HIDES_STRUCT   = NO
-SYMBOL_CACHE_SIZE      = 0
-LOOKUP_CACHE_SIZE      = 0
-#---------------------------------------------------------------------------
-# Build related configuration options
-#---------------------------------------------------------------------------
-EXTRACT_ALL            = YES
-EXTRACT_PRIVATE        = NO
-EXTRACT_PACKAGE        = NO
-EXTRACT_STATIC         = YES
-EXTRACT_LOCAL_CLASSES  = YES
-EXTRACT_LOCAL_METHODS  = NO
-EXTRACT_ANON_NSPACES   = NO
-HIDE_UNDOC_MEMBERS     = NO
-HIDE_UNDOC_CLASSES     = NO
-HIDE_FRIEND_COMPOUNDS  = NO
-HIDE_IN_BODY_DOCS      = NO
-INTERNAL_DOCS          = NO
-CASE_SENSE_NAMES       = NO
-HIDE_SCOPE_NAMES       = NO
-SHOW_INCLUDE_FILES     = NO
-FORCE_LOCAL_INCLUDES   = NO
-INLINE_INFO            = YES
-SORT_MEMBER_DOCS       = YES
-SORT_BRIEF_DOCS        = YES
-SORT_MEMBERS_CTORS_1ST = NO
-SORT_GROUP_NAMES       = NO
-SORT_BY_SCOPE_NAME     = NO
-STRICT_PROTO_MATCHING  = NO
-GENERATE_TODOLIST      = NO
-GENERATE_TESTLIST      = NO
-GENERATE_BUGLIST       = NO
-GENERATE_DEPRECATEDLIST= YES
-ENABLED_SECTIONS       = DESKTOPAPI
-MAX_INITIALIZER_LINES  = 30
-SHOW_USED_FILES        = NO
-SHOW_DIRECTORIES       = NO
-SHOW_FILES             = NO
-SHOW_NAMESPACES        = NO
-FILE_VERSION_FILTER    =
-LAYOUT_FILE            =
-CITE_BIB_FILES         =
-#---------------------------------------------------------------------------
-# configuration options related to warning and progress messages
-#---------------------------------------------------------------------------
-QUIET                  = NO
-WARNINGS               = YES
-WARN_IF_UNDOCUMENTED   = YES
-WARN_IF_DOC_ERROR      = YES
-WARN_NO_PARAMDOC       = YES
-WARN_FORMAT            = "$file:$line: $text"
-WARN_LOGFILE           = MgDesktop_warn_log.txt
-#---------------------------------------------------------------------------
-# configuration options related to the input files
-#---------------------------------------------------------------------------
-INPUT                  = external_topics \
-                         group_and_page_definitions \
-                         ../Common/Foundation \
-                         ../Common/Geometry \
-                         ../Common/PlatformBase \
-                         ../Desktop/MgDesktop 
-INPUT_ENCODING         = UTF-8
-FILE_PATTERNS          = *.h
-RECURSIVE              = YES
-EXCLUDE                = 
-EXCLUDE_SYMLINKS       = NO
-EXCLUDE_PATTERNS       = */Buffer/BorderWalker.h \
-                         */Buffer/buffer.h \
-                         */Buffer/bufraloc.h \
-                         */Buffer/bufrsort.h \
-                         */Buffer/bufrutil.h \
-                         */Buffer/DumpFFGF.h \
-                         */Buffer/eventarr.h \
-                         */Buffer/eventint.h \
-                         */Buffer/FloatTransform.h \
-                         */Buffer/GreatCircleBufferUtil.h \
-                         */Buffer/interlst.h \
-                         */Buffer/interprc.h \
-                         */Buffer/LatLonBorderWalker.h \
-                         */Buffer/oarray.h \
-                         */Buffer/oextent.h \
-                         */Buffer/ogeomtry.h \
-                         */Buffer/olinep.h \
-                         */Buffer/oobject.h \
-                         */Buffer/opline.h \
-                         */Buffer/opoint.h \
-                         */Buffer/opolygnp.h \
-                         */Buffer/opolygon.h \
-                         */Buffer/oppolygn.h \
-                         */Buffer/oppolyln.h \
-                         */Buffer/opsprimitive.h \
-                         */Buffer/orpplygn.h \
-                         */Buffer/ortree.h \
-                         */Buffer/planeswp.h \
-                         */Buffer/plgnbufr.h \
-                         */Buffer/plinbufr.h \
-                         */Buffer/pobjbufr.h \
-                         */Buffer/ppgunion.h \
-                         */Buffer/progcbck.h \
-                         */Buffer/sedgaloc.h \
-                         */Buffer/sweepedg.h \
-                         */Buffer/tuplearr.h \
-                         */Buffer/vertaloc.h \
-                         */Buffer/wedgaloc.h \
-                         */Buffer/wedgearr.h \
-                         */Buffer/wingedge.h \
-                         */Buffer/worklist.h \
-                         */Buffer/xordtree.h \
-                         */Geometry/Parse/LexAwkt.h \
-                         */Geometry/Parse/yyAwkt.h \
-                         */Geometry/Parse/Array.h \
-                         */Geometry/Parse/ParseAwkt.h \
-                         */Geometry/GeometryConsoleTest/* \
-                         */Geometry/Spatial/* \
-                         */MapLayer/Watermark.h \
-                         */System/CommonDefs.h \
-                         */System/Ptr.h \
-                         */System/FileUtil.h \
-                         */System/Util.h \
-                         */System/CryptographyManager.h \
-                         */PrintLayoutService/* \
-                         */Data/Point3D.h \
-                         */Data/Size2D.h \
-                         */Data/Vector3D.h \
-                         */Data/Margin.h \
-                         */Data/SerializableCollection.h \
-                         */.svn
-EXCLUDE_SYMBOLS        =
-EXAMPLE_PATH           = headers_and_footers
-EXAMPLE_PATTERNS       = *
-EXAMPLE_RECURSIVE      = YES
-IMAGE_PATH             = other_graphics
-INPUT_FILTER           =
-FILTER_PATTERNS        =
-FILTER_SOURCE_FILES    = NO
-FILTER_SOURCE_PATTERNS =
-#---------------------------------------------------------------------------
-# configuration options related to source browsing
-#---------------------------------------------------------------------------
-SOURCE_BROWSER         = NO
-INLINE_SOURCES         = NO
-STRIP_CODE_COMMENTS    = NO
-REFERENCED_BY_RELATION = YES
-REFERENCES_RELATION    = YES
-REFERENCES_LINK_SOURCE = YES
-USE_HTAGS              = NO
-VERBATIM_HEADERS       = NO
-#---------------------------------------------------------------------------
-# configuration options related to the alphabetical class index
-#---------------------------------------------------------------------------
-ALPHABETICAL_INDEX     = YES
-COLS_IN_ALPHA_INDEX    = 5
-IGNORE_PREFIX          =
-#---------------------------------------------------------------------------
-# configuration options related to the HTML output
-#---------------------------------------------------------------------------
-GENERATE_HTML          = YES
-HTML_OUTPUT            = MgDesktop_WebAPIReference
-HTML_FILE_EXTENSION    = .htm
-HTML_HEADER            = headers_and_footers/header.html
-HTML_FOOTER            = headers_and_footers/footer.html
-HTML_STYLESHEET        = css/mg_open_source.css
-#HTML_HEADER            =
-#HTML_FOOTER            =
-#HTML_STYLESHEET        =
-HTML_EXTRA_FILES       =
-HTML_COLORSTYLE_HUE    = 220
-HTML_COLORSTYLE_SAT    = 100
-HTML_COLORSTYLE_GAMMA  = 80
-HTML_TIMESTAMP         = YES
-HTML_ALIGN_MEMBERS     = YES
-HTML_DYNAMIC_SECTIONS  = YES
-GENERATE_DOCSET        = NO
-GENERATE_HTMLHELP      = NO
-CHM_FILE               =
-HHC_LOCATION           =
-GENERATE_CHI           = NO
-CHM_INDEX_ENCODING     =
-BINARY_TOC             = NO
-TOC_EXPAND             = NO
-GENERATE_QHP           = NO
-QCH_FILE               =
-QHP_NAMESPACE          = org.doxygen.Project
-QHP_VIRTUAL_FOLDER     = doc
-QHP_CUST_FILTER_NAME   =
-QHP_CUST_FILTER_ATTRS  =
-QHP_SECT_FILTER_ATTRS  =
-QHG_LOCATION           =
-GENERATE_ECLIPSEHELP   = NO
-ECLIPSE_DOC_ID         = org.doxygen.Project
-DISABLE_INDEX          = NO
-GENERATE_TREEVIEW      = YES
-ENUM_VALUES_PER_LINE   = 4
-USE_INLINE_TREES       = NO
-TREEVIEW_WIDTH         = 250
-EXT_LINKS_IN_WINDOW    = NO
-FORMULA_FONTSIZE       = 10
-FORMULA_TRANSPARENT    = YES
-USE_MATHJAX            = NO
-MATHJAX_RELPATH        = http://cdn.mathjax.org/mathjax/latest
-MATHJAX_EXTENSIONS     =
-SEARCHENGINE           = YES
-SERVER_BASED_SEARCH    = NO
-#---------------------------------------------------------------------------
-# configuration options related to the LaTeX output
-#---------------------------------------------------------------------------
-GENERATE_LATEX         = NO
-LATEX_OUTPUT           = latex
-LATEX_CMD_NAME         = latex
-MAKEINDEX_CMD_NAME     = makeindex
-COMPACT_LATEX          = NO
-PAPER_TYPE             = a4
-EXTRA_PACKAGES         =
-LATEX_HEADER           =
-LATEX_FOOTER           =
-PDF_HYPERLINKS         = YES
-USE_PDFLATEX           = YES
-LATEX_BATCHMODE        = NO
-LATEX_HIDE_INDICES     = NO
-LATEX_SOURCE_CODE      = NO
-LATEX_BIB_STYLE        = plain
-#---------------------------------------------------------------------------
-# configuration options related to the RTF output
-#---------------------------------------------------------------------------
-GENERATE_RTF           = NO
-RTF_OUTPUT             = rtf
-COMPACT_RTF            = NO
-RTF_HYPERLINKS         = NO
-RTF_STYLESHEET_FILE    =
-RTF_EXTENSIONS_FILE    =
-#---------------------------------------------------------------------------
-# configuration options related to the man page output
-#---------------------------------------------------------------------------
-GENERATE_MAN           = NO
-MAN_OUTPUT             = man
-MAN_EXTENSION          = .3
-MAN_LINKS              = NO
-#---------------------------------------------------------------------------
-# configuration options related to the XML output
-#---------------------------------------------------------------------------
-GENERATE_XML           = YES
-XML_OUTPUT             = mgdesktop_xml
-XML_SCHEMA             =
-XML_DTD                =
-XML_PROGRAMLISTING     = YES
-#---------------------------------------------------------------------------
-# configuration options for the AutoGen Definitions output
-#---------------------------------------------------------------------------
-GENERATE_AUTOGEN_DEF   = NO
-#---------------------------------------------------------------------------
-# configuration options related to the Perl module output
-#---------------------------------------------------------------------------
-GENERATE_PERLMOD       = NO
-PERLMOD_LATEX          = NO
-PERLMOD_PRETTY         = YES
-PERLMOD_MAKEVAR_PREFIX =
-#---------------------------------------------------------------------------
-# Configuration options related to the preprocessor
-#---------------------------------------------------------------------------
-ENABLE_PREPROCESSING   = YES
-MACRO_EXPANSION        = YES
-EXPAND_ONLY_PREDEF     = NO
-SEARCH_INCLUDES        = YES
-INCLUDE_PATH           =
-INCLUDE_FILE_PATTERNS  =
-PREDEFINED             = INTERNAL_API=private \
-                         EXTERNAL_API=private \
-                         PUBLISHED_API=public \
-                         protected=private
-EXPAND_AS_DEFINED      =
-SKIP_FUNCTION_MACROS   = YES
-#---------------------------------------------------------------------------
-# Configuration::additions related to external references
-#---------------------------------------------------------------------------
-TAGFILES               =
-GENERATE_TAGFILE       =
-ALLEXTERNALS           = NO
-EXTERNAL_GROUPS        = NO
-PERL_PATH              = /usr/bin/perl
-#---------------------------------------------------------------------------
-# Configuration options related to the dot tool
-#---------------------------------------------------------------------------
-CLASS_DIAGRAMS         = NO
-MSCGEN_PATH            =
-HIDE_UNDOC_RELATIONS   = YES
-HAVE_DOT               = YES
-DOT_NUM_THREADS        = 0
-DOT_FONTNAME           = Helvetica
-DOT_FONTSIZE           = 10
-DOT_FONTPATH           =
-CLASS_GRAPH            = YES
-COLLABORATION_GRAPH    = NO
-GROUP_GRAPHS           = NO
-UML_LOOK               = NO
-UML_LIMIT_NUM_FIELDS   = 10
-TEMPLATE_RELATIONS     = NO
-INCLUDE_GRAPH          = YES
-INCLUDED_BY_GRAPH      = YES
-CALL_GRAPH             = NO
-CALLER_GRAPH           = NO
-GRAPHICAL_HIERARCHY    = YES
-DIRECTORY_GRAPH        = YES
-DOT_IMAGE_FORMAT       = png
-INTERACTIVE_SVG        = NO
-DOT_PATH               = 
-DOTFILE_DIRS           =
-MSCFILE_DIRS           =
-DOT_GRAPH_MAX_NODES    = 50
-MAX_DOT_GRAPH_DEPTH    = 1000
-DOT_TRANSPARENT        = NO
-DOT_MULTI_TARGETS      = NO
-GENERATE_LEGEND        = YES
-DOT_CLEANUP            = YES

Deleted: branches/4.0/MgDev/Doc/MgDesktop_run_doxygen.bat
===================================================================
--- branches/4.0/MgDev/Doc/MgDesktop_run_doxygen.bat	2023-11-10 15:08:48 UTC (rev 10060)
+++ branches/4.0/MgDev/Doc/MgDesktop_run_doxygen.bat	2023-11-10 16:16:27 UTC (rev 10061)
@@ -1,32 +0,0 @@
- at echo off
-
-::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 
-:: Copy the doxygen.css file
-
-echo Copying doxygen.css ...
-
-if not exist MgDesktop_WebAPIReference\		mkdir MgDesktop_WebAPIReference\
-copy css\doxygen.css 							MgDesktop_WebAPIReference
-
-::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 
-:: Copy the XML schemas
-
-if not exist MgDesktop_WebAPIReference\xml_schemas 	mkdir MgDesktop_WebAPIReference\xml_schemas\
-xcopy /s /y "xml_schemas\*"								MgDesktop_WebAPIReference\xml_schemas\
-
-::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 
-:: Run Doxygen
-
-echo Running Doxygen ...
-doxygen MgDesktop_Doxyfile > MgDesktop_run_log.txt
-echo Doxygen generation is complete. The error log is in 'MgDesktop_warn_log.txt'.
-
-::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 
-;: Post Process 
-
-echo Running the post processor ...
-perl -w PostProcessor/post_process.MgDesktop.pl
-
-::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 
-echo All done.
-

Deleted: branches/4.0/MgDev/Doc/MgOpenSource_Doxyfile
===================================================================
--- branches/4.0/MgDev/Doc/MgOpenSource_Doxyfile	2023-11-10 15:08:48 UTC (rev 10060)
+++ branches/4.0/MgDev/Doc/MgOpenSource_Doxyfile	2023-11-10 16:16:27 UTC (rev 10061)
@@ -1,362 +0,0 @@
-# Doxyfile 1.8.0
-
-#---------------------------------------------------------------------------
-# Project related configuration options
-#---------------------------------------------------------------------------
-DOXYFILE_ENCODING      = UTF-8
-PROJECT_NAME           = "MapGuide" "API" "Reference"
-PROJECT_NUMBER         = 
-PROJECT_BRIEF          =
-PROJECT_LOGO           = 
-OUTPUT_DIRECTORY       =
-CREATE_SUBDIRS         = YES
-OUTPUT_LANGUAGE        = English
-BRIEF_MEMBER_DESC      = YES
-REPEAT_BRIEF           = YES
-ABBREVIATE_BRIEF       =
-ALWAYS_DETAILED_SEC    = NO
-INLINE_INHERITED_MEMB  = NO
-FULL_PATH_NAMES        = NO
-STRIP_FROM_PATH        =
-STRIP_FROM_INC_PATH    =
-SHORT_NAMES            = NO
-JAVADOC_AUTOBRIEF      = NO
-QT_AUTOBRIEF           = NO
-MULTILINE_CPP_IS_BRIEF = NO
-INHERIT_DOCS           = YES
-SEPARATE_MEMBER_PAGES  = YES
-TAB_SIZE               = 4
-ALIASES                = ProdName="MapGuide Open Source"
-ALIASES               += DevGuide="<em>MapGuide Open Source Developer's Guide</em>"
-ALIASES               += note1=""
-ALIASES               += note2=""
-TCL_SUBST              =
-OPTIMIZE_OUTPUT_FOR_C  = NO
-OPTIMIZE_OUTPUT_JAVA   = NO
-OPTIMIZE_FOR_FORTRAN   = NO
-OPTIMIZE_OUTPUT_VHDL   = NO
-EXTENSION_MAPPING      =
-MARKDOWN_SUPPORT       = YES
-BUILTIN_STL_SUPPORT    = NO
-CPP_CLI_SUPPORT        = NO
-SIP_SUPPORT            = NO
-IDL_PROPERTY_SUPPORT   = NO
-DISTRIBUTE_GROUP_DOC   = NO
-SUBGROUPING            = YES
-INLINE_GROUPED_CLASSES = NO
-INLINE_SIMPLE_STRUCTS  = NO
-TYPEDEF_HIDES_STRUCT   = NO
-SYMBOL_CACHE_SIZE      = 0
-LOOKUP_CACHE_SIZE      = 0
-#---------------------------------------------------------------------------
-# Build related configuration options
-#---------------------------------------------------------------------------
-EXTRACT_ALL            = YES
-EXTRACT_PRIVATE        = NO
-EXTRACT_PACKAGE        = NO
-EXTRACT_STATIC         = YES
-EXTRACT_LOCAL_CLASSES  = YES
-EXTRACT_LOCAL_METHODS  = NO
-EXTRACT_ANON_NSPACES   = NO
-HIDE_UNDOC_MEMBERS     = NO
-HIDE_UNDOC_CLASSES     = NO
-HIDE_FRIEND_COMPOUNDS  = NO
-HIDE_IN_BODY_DOCS      = NO
-INTERNAL_DOCS          = NO
-CASE_SENSE_NAMES       = NO
-HIDE_SCOPE_NAMES       = NO
-SHOW_INCLUDE_FILES     = NO
-FORCE_LOCAL_INCLUDES   = NO
-INLINE_INFO            = YES
-SORT_MEMBER_DOCS       = YES
-SORT_BRIEF_DOCS        = YES
-SORT_MEMBERS_CTORS_1ST = NO
-SORT_GROUP_NAMES       = NO
-SORT_BY_SCOPE_NAME     = NO
-STRICT_PROTO_MATCHING  = NO
-GENERATE_TODOLIST      = NO
-GENERATE_TESTLIST      = NO
-GENERATE_BUGLIST       = NO
-GENERATE_DEPRECATEDLIST= YES
-#This is to toggle MapGuide API-specific content
-ENABLED_SECTIONS       = MAPGUIDEAPI
-MAX_INITIALIZER_LINES  = 30
-SHOW_USED_FILES        = NO
-SHOW_DIRECTORIES       = NO
-SHOW_FILES             = NO
-SHOW_NAMESPACES        = NO
-FILE_VERSION_FILTER    =
-LAYOUT_FILE            =
-CITE_BIB_FILES         =
-#---------------------------------------------------------------------------
-# configuration options related to warning and progress messages
-#---------------------------------------------------------------------------
-QUIET                  = NO
-WARNINGS               = YES
-WARN_IF_UNDOCUMENTED   = YES
-WARN_IF_DOC_ERROR      = YES
-WARN_NO_PARAMDOC       = YES
-WARN_FORMAT            = "$file:$line: $text"
-WARN_LOGFILE           = MgOpensource_warn_log.txt
-#---------------------------------------------------------------------------
-# configuration options related to the input files
-#---------------------------------------------------------------------------
-INPUT                  = external_topics \
-                         group_and_page_definitions \
-                         ../Common/Foundation \
-                         ../Common/Geometry \
-                         ../Common/PlatformBase \
-                         ../Common/MapGuideCommon \
-                         ../Web/src/WebApp
-INPUT_ENCODING         = UTF-8
-FILE_PATTERNS          = *.h
-RECURSIVE              = YES
-EXCLUDE                = 
-EXCLUDE_SYMLINKS       = NO
-EXCLUDE_PATTERNS       = */Buffer/BorderWalker.h \
-                         */Buffer/buffer.h \
-                         */Buffer/bufraloc.h \
-                         */Buffer/bufrsort.h \
-                         */Buffer/bufrutil.h \
-                         */Buffer/DumpFFGF.h \
-                         */Buffer/eventarr.h \
-                         */Buffer/eventint.h \
-                         */Buffer/FloatTransform.h \
-                         */Buffer/GreatCircleBufferUtil.h \
-                         */Buffer/interlst.h \
-                         */Buffer/interprc.h \
-                         */Buffer/LatLonBorderWalker.h \
-                         */Buffer/oarray.h \
-                         */Buffer/oextent.h \
-                         */Buffer/ogeomtry.h \
-                         */Buffer/olinep.h \
-                         */Buffer/oobject.h \
-                         */Buffer/opline.h \
-                         */Buffer/opoint.h \
-                         */Buffer/opolygnp.h \
-                         */Buffer/opolygon.h \
-                         */Buffer/oppolygn.h \
-                         */Buffer/oppolyln.h \
-                         */Buffer/opsprimitive.h \
-                         */Buffer/orpplygn.h \
-                         */Buffer/ortree.h \
-                         */Buffer/planeswp.h \
-                         */Buffer/plgnbufr.h \
-                         */Buffer/plinbufr.h \
-                         */Buffer/pobjbufr.h \
-                         */Buffer/ppgunion.h \
-                         */Buffer/progcbck.h \
-                         */Buffer/sedgaloc.h \
-                         */Buffer/sweepedg.h \
-                         */Buffer/tuplearr.h \
-                         */Buffer/vertaloc.h \
-                         */Buffer/wedgaloc.h \
-                         */Buffer/wedgearr.h \
-                         */Buffer/wingedge.h \
-                         */Buffer/worklist.h \
-                         */Buffer/xordtree.h \
-                         */Geometry/Parse/LexAwkt.h \
-                         */Geometry/Parse/yyAwkt.h \
-                         */Geometry/Parse/Array.h \
-                         */Geometry/Parse/ParseAwkt.h \
-                         */Geometry/GeometryConsoleTest/* \
-                         */Geometry/Spatial/* \
-                         */MapLayer/Watermark.h \
-                         */System/CommonDefs.h \
-                         */System/Ptr.h \
-                         */System/FileUtil.h \
-                         */System/Util.h \
-                         */System/CryptographyManager.h \
-                         */PrintLayoutService/* \
-                         */Data/Point3D.h \
-                         */Data/Size2D.h \
-                         */Data/Vector3D.h \
-                         */Data/Margin.h \
-                         */Data/SerializableCollection.h \
-                         */.svn
-EXCLUDE_SYMBOLS        =
-EXAMPLE_PATH           = headers_and_footers
-EXAMPLE_PATTERNS       = *
-EXAMPLE_RECURSIVE      = YES
-IMAGE_PATH             = other_graphics
-INPUT_FILTER           =
-FILTER_PATTERNS        =
-FILTER_SOURCE_FILES    = NO
-FILTER_SOURCE_PATTERNS =
-#---------------------------------------------------------------------------
-# configuration options related to source browsing
-#---------------------------------------------------------------------------
-SOURCE_BROWSER         = NO
-INLINE_SOURCES         = NO
-STRIP_CODE_COMMENTS    = NO
-REFERENCED_BY_RELATION = YES
-REFERENCES_RELATION    = YES
-REFERENCES_LINK_SOURCE = YES
-USE_HTAGS              = NO
-VERBATIM_HEADERS       = NO
-#---------------------------------------------------------------------------
-# configuration options related to the alphabetical class index
-#---------------------------------------------------------------------------
-ALPHABETICAL_INDEX     = YES
-COLS_IN_ALPHA_INDEX    = 5
-IGNORE_PREFIX          =
-#---------------------------------------------------------------------------
-# configuration options related to the HTML output
-#---------------------------------------------------------------------------
-GENERATE_HTML          = YES
-HTML_OUTPUT            = MgOpensource_WebAPIReference
-HTML_FILE_EXTENSION    = .htm
-HTML_HEADER            = headers_and_footers/header.html
-HTML_FOOTER            = headers_and_footers/footer.html
-HTML_STYLESHEET        = css/mg_open_source.css
-#HTML_HEADER            =
-#HTML_FOOTER            =
-#HTML_STYLESHEET        =
-HTML_EXTRA_FILES       =
-HTML_COLORSTYLE_HUE    = 220
-HTML_COLORSTYLE_SAT    = 100
-HTML_COLORSTYLE_GAMMA  = 80
-HTML_TIMESTAMP         = YES
-HTML_ALIGN_MEMBERS     = YES
-HTML_DYNAMIC_SECTIONS  = YES
-GENERATE_DOCSET        = NO
-GENERATE_HTMLHELP      = NO
-CHM_FILE               =
-HHC_LOCATION           =
-GENERATE_CHI           = NO
-CHM_INDEX_ENCODING     =
-BINARY_TOC             = NO
-TOC_EXPAND             = NO
-GENERATE_QHP           = NO
-QCH_FILE               =
-QHP_NAMESPACE          = org.doxygen.Project
-QHP_VIRTUAL_FOLDER     = doc
-QHP_CUST_FILTER_NAME   =
-QHP_CUST_FILTER_ATTRS  =
-QHP_SECT_FILTER_ATTRS  =
-QHG_LOCATION           =
-GENERATE_ECLIPSEHELP   = NO
-ECLIPSE_DOC_ID         = org.doxygen.Project
-DISABLE_INDEX          = NO
-GENERATE_TREEVIEW      = YES
-ENUM_VALUES_PER_LINE   = 4
-USE_INLINE_TREES       = NO
-TREEVIEW_WIDTH         = 250
-EXT_LINKS_IN_WINDOW    = NO
-FORMULA_FONTSIZE       = 10
-FORMULA_TRANSPARENT    = YES
-USE_MATHJAX            = NO
-MATHJAX_RELPATH        = http://cdn.mathjax.org/mathjax/latest
-MATHJAX_EXTENSIONS     =
-SEARCHENGINE           = YES
-SERVER_BASED_SEARCH    = NO
-#---------------------------------------------------------------------------
-# configuration options related to the LaTeX output
-#---------------------------------------------------------------------------
-GENERATE_LATEX         = NO
-LATEX_OUTPUT           = latex
-LATEX_CMD_NAME         = latex
-MAKEINDEX_CMD_NAME     = makeindex
-COMPACT_LATEX          = NO
-PAPER_TYPE             = a4
-EXTRA_PACKAGES         =
-LATEX_HEADER           =
-LATEX_FOOTER           =
-PDF_HYPERLINKS         = YES
-USE_PDFLATEX           = YES
-LATEX_BATCHMODE        = NO
-LATEX_HIDE_INDICES     = NO
-LATEX_SOURCE_CODE      = NO
-LATEX_BIB_STYLE        = plain
-#---------------------------------------------------------------------------
-# configuration options related to the RTF output
-#---------------------------------------------------------------------------
-GENERATE_RTF           = NO
-RTF_OUTPUT             = rtf
-COMPACT_RTF            = NO
-RTF_HYPERLINKS         = NO
-RTF_STYLESHEET_FILE    =
-RTF_EXTENSIONS_FILE    =
-#---------------------------------------------------------------------------
-# configuration options related to the man page output
-#---------------------------------------------------------------------------
-GENERATE_MAN           = NO
-MAN_OUTPUT             = man
-MAN_EXTENSION          = .3
-MAN_LINKS              = NO
-#---------------------------------------------------------------------------
-# configuration options related to the XML output
-#---------------------------------------------------------------------------
-GENERATE_XML           = NO
-XML_OUTPUT             = xml
-XML_SCHEMA             =
-XML_DTD                =
-XML_PROGRAMLISTING     = YES
-#---------------------------------------------------------------------------
-# configuration options for the AutoGen Definitions output
-#---------------------------------------------------------------------------
-GENERATE_AUTOGEN_DEF   = NO
-#---------------------------------------------------------------------------
-# configuration options related to the Perl module output
-#---------------------------------------------------------------------------
-GENERATE_PERLMOD       = NO
-PERLMOD_LATEX          = NO
-PERLMOD_PRETTY         = YES
-PERLMOD_MAKEVAR_PREFIX =
-#---------------------------------------------------------------------------
-# Configuration options related to the preprocessor
-#---------------------------------------------------------------------------
-ENABLE_PREPROCESSING   = YES
-MACRO_EXPANSION        = YES
-EXPAND_ONLY_PREDEF     = NO
-SEARCH_INCLUDES        = YES
-INCLUDE_PATH           =
-INCLUDE_FILE_PATTERNS  =
-PREDEFINED             = INTERNAL_API=private \
-                         EXTERNAL_API=private \
-                         PUBLISHED_API=public \
-                         protected=private
-EXPAND_AS_DEFINED      =
-SKIP_FUNCTION_MACROS   = YES
-#---------------------------------------------------------------------------
-# Configuration::additions related to external references
-#---------------------------------------------------------------------------
-TAGFILES               =
-GENERATE_TAGFILE       =
-ALLEXTERNALS           = NO
-EXTERNAL_GROUPS        = YES
-PERL_PATH              = /usr/bin/perl
-#---------------------------------------------------------------------------
-# Configuration options related to the dot tool
-#---------------------------------------------------------------------------
-CLASS_DIAGRAMS         = NO
-MSCGEN_PATH            =
-HIDE_UNDOC_RELATIONS   = YES
-HAVE_DOT               = YES
-DOT_NUM_THREADS        = 0
-DOT_FONTNAME           = Helvetica
-DOT_FONTSIZE           = 10
-DOT_FONTPATH           =
-CLASS_GRAPH            = YES
-COLLABORATION_GRAPH    = NO
-GROUP_GRAPHS           = NO
-UML_LOOK               = NO
-UML_LIMIT_NUM_FIELDS   = 10
-TEMPLATE_RELATIONS     = NO
-INCLUDE_GRAPH          = YES
-INCLUDED_BY_GRAPH      = YES
-CALL_GRAPH             = NO
-CALLER_GRAPH           = NO
-GRAPHICAL_HIERARCHY    = YES
-DIRECTORY_GRAPH        = YES
-DOT_IMAGE_FORMAT       = png
-INTERACTIVE_SVG        = NO
-DOT_PATH               = 
-DOTFILE_DIRS           =
-MSCFILE_DIRS           =
-DOT_GRAPH_MAX_NODES    = 50
-MAX_DOT_GRAPH_DEPTH    = 1000
-DOT_TRANSPARENT        = NO
-DOT_MULTI_TARGETS      = NO
-GENERATE_LEGEND        = YES
-DOT_CLEANUP            = YES

Deleted: branches/4.0/MgDev/Doc/MgOpenSource_run_doxygen.bat
===================================================================
--- branches/4.0/MgDev/Doc/MgOpenSource_run_doxygen.bat	2023-11-10 15:08:48 UTC (rev 10060)
+++ branches/4.0/MgDev/Doc/MgOpenSource_run_doxygen.bat	2023-11-10 16:16:27 UTC (rev 10061)
@@ -1,32 +0,0 @@
- at echo off
-
-::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 
-:: Copy the doxygen.css file
-
-echo Copying doxygen.css ...
-
-if not exist MgOpensource_WebAPIReference\		mkdir MgOpensource_WebAPIReference\
-copy css\doxygen.css 							MgOpensource_WebAPIReference
-
-::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 
-:: Copy the XML schemas
-
-if not exist MgOpensource_WebAPIReference\xml_schemas 	mkdir MgOpensource_WebAPIReference\xml_schemas\
-xcopy /s /y "xml_schemas\*"								MgOpensource_WebAPIReference\xml_schemas\
-
-::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 
-:: Run Doxygen
-
-echo Running Doxygen ...
-doxygen MgOpenSource_Doxyfile > MGOpenSource_run_log.txt
-echo Doxygen generation is complete. The error log is in 'MgOpenSource_warn_log.txt'.
-
-::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 
-;: Post Process 
-
-echo Running the post processor ...
-perl -w PostProcessor/post_process.MgOpenSource.pl
-
-::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 
-echo All done.
-

Deleted: branches/4.0/MgDev/Doc/MgOpenSource_run_doxygen.sh
===================================================================
--- branches/4.0/MgDev/Doc/MgOpenSource_run_doxygen.sh	2023-11-10 15:08:48 UTC (rev 10060)
+++ branches/4.0/MgDev/Doc/MgOpenSource_run_doxygen.sh	2023-11-10 16:16:27 UTC (rev 10061)
@@ -1,40 +0,0 @@
-############################################################################# 
-## Delete the old files
-echo Deleting old files ...
-
-rm --recursive --verbose --force MgOpensource_WebAPIReference/*.*
-rm --recursive --verbose --force MgOpensource_WebAPIReference/*
-
-############################################################################# 
-## Copy the CSS file
-echo Copying doxygen.css ...
-
-if [ ! -d MgOpensource_WebAPIReference/ ]; then
- 	mkdir MgOpensource_WebAPIReference
-fi
-
-cp -f css/doxygen.css 	MgOpensource_WebAPIReference/
-
-############################################################################# 
-## Copy the XML schemas
-echo Copying XML schemas ...
-
-if [ ! -d MgOpensource_WebAPIReference/xml_schemas ]; then
- 	mkdir MgOpensource_WebAPIReference/xml_schemas
-fi
-
-cp --recursive  xml_schemas/*		MgOpensource_WebAPIReference/xml_schemas/
-
-############################################################################# 
-## Run Doxygen
-
-doxygen MgOpenSource_Doxyfile_Linux
-echo Doxygen generation is complete. See 'MgOpenSource_warn_log.txt'.
-
-#############################################################################
-## Run the Perl post processor
-
-perl -w PostProcessor/post_process.MgOpenSource.pl
-
-################################################################### 
-echo All done.
\ No newline at end of file

Index: branches/4.0/MgDev/Doc/dotnet_api
===================================================================
--- branches/4.0/MgDev/Doc/dotnet_api	2023-11-10 15:08:48 UTC (rev 10060)
+++ branches/4.0/MgDev/Doc/dotnet_api	2023-11-10 16:16:27 UTC (rev 10061)

Property changes on: branches/4.0/MgDev/Doc/dotnet_api
___________________________________________________________________
Added: svn:ignore
## -0,0 +1,2 ##
+_site
+api
Added: branches/4.0/MgDev/Doc/dotnet_api/docfx.json
===================================================================
--- branches/4.0/MgDev/Doc/dotnet_api/docfx.json	                        (rev 0)
+++ branches/4.0/MgDev/Doc/dotnet_api/docfx.json	2023-11-10 16:16:27 UTC (rev 10061)
@@ -0,0 +1,45 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "src": "../../Bindings/src/Managed/DotNet",
+          "files": [
+            "OSGeo.MapGuide.*/**.csproj"
+          ]
+        }
+      ],
+      "dest": "api"
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": [
+          "**/*.{md,yml}"
+        ],
+        "exclude": [
+          "_site/**"
+        ]
+      }
+    ],
+    "resources": [
+      {
+        "files": [
+          "images/**"
+        ]
+      }
+    ],
+    "output": "_site",
+    "template": [
+      "default",
+      "modern"
+    ],
+    "globalMetadata": {
+      "_appName": "MapGuide .net API reference",
+      "_appTitle": "MapGuide .net API reference",
+      "_enableSearch": true,
+      "pdf": false
+    }
+  }
+}
\ No newline at end of file

Added: branches/4.0/MgDev/Doc/dotnet_api/docs/getting-started.md
===================================================================
--- branches/4.0/MgDev/Doc/dotnet_api/docs/getting-started.md	                        (rev 0)
+++ branches/4.0/MgDev/Doc/dotnet_api/docs/getting-started.md	2023-11-10 16:16:27 UTC (rev 10061)
@@ -0,0 +1 @@
+# Getting Started
\ No newline at end of file

Added: branches/4.0/MgDev/Doc/dotnet_api/docs/introduction.md
===================================================================
--- branches/4.0/MgDev/Doc/dotnet_api/docs/introduction.md	                        (rev 0)
+++ branches/4.0/MgDev/Doc/dotnet_api/docs/introduction.md	2023-11-10 16:16:27 UTC (rev 10061)
@@ -0,0 +1 @@
+# Introduction
\ No newline at end of file

Added: branches/4.0/MgDev/Doc/dotnet_api/docs/toc.yml
===================================================================
--- branches/4.0/MgDev/Doc/dotnet_api/docs/toc.yml	                        (rev 0)
+++ branches/4.0/MgDev/Doc/dotnet_api/docs/toc.yml	2023-11-10 16:16:27 UTC (rev 10061)
@@ -0,0 +1,4 @@
+- name: Introduction
+  href: introduction.md
+- name: Getting Started
+  href: getting-started.md
\ No newline at end of file

Added: branches/4.0/MgDev/Doc/dotnet_api/index.md
===================================================================
--- branches/4.0/MgDev/Doc/dotnet_api/index.md	                        (rev 0)
+++ branches/4.0/MgDev/Doc/dotnet_api/index.md	2023-11-10 16:16:27 UTC (rev 10061)
@@ -0,0 +1,11 @@
+---
+_layout: landing
+---
+
+# This is the **HOMEPAGE**.
+
+Refer to [Markdown](http://daringfireball.net/projects/markdown/) for how to write markdown files.
+
+## Quick Start Notes:
+
+1. Add images to the *images* folder if the file is referencing an image.
\ No newline at end of file

Added: branches/4.0/MgDev/Doc/dotnet_api/toc.yml
===================================================================
--- branches/4.0/MgDev/Doc/dotnet_api/toc.yml	                        (rev 0)
+++ branches/4.0/MgDev/Doc/dotnet_api/toc.yml	2023-11-10 16:16:27 UTC (rev 10061)
@@ -0,0 +1,4 @@
+- name: Docs
+  href: docs/
+- name: API
+  href: api/
\ No newline at end of file

Added: branches/4.0/MgDev/acquire-doctools.ps1
===================================================================
--- branches/4.0/MgDev/acquire-doctools.ps1	                        (rev 0)
+++ branches/4.0/MgDev/acquire-doctools.ps1	2023-11-10 16:16:27 UTC (rev 10061)
@@ -0,0 +1,9 @@
+Write-Host "Ensuring docfx is installed"
+dotnet tool update -g docfx
+Write-Host "Ensuring doctum is installed"
+if (Test-Path ./BuildTools/doctum.phar) {
+    Write-Host "doctum.phar is installed in the expected path"
+} else {
+    Write-Host "doctum.phar not found. Downloading it"
+    Invoke-WebRequest https://doctum.long-term.support/releases/latest/doctum.phar -OutFile ./BuildTools/doctum.phar
+}
\ No newline at end of file

Modified: branches/4.0/MgDev/build.bat
===================================================================
--- branches/4.0/MgDev/build.bat	2023-11-10 15:08:48 UTC (rev 10060)
+++ branches/4.0/MgDev/build.bat	2023-11-10 16:16:27 UTC (rev 10061)
@@ -19,9 +19,11 @@
 rem 2) Download and install the following:
 rem     - Java SDK (http://java.sun.com)
 rem     - ant (http://ant.apache.org)
-rem     - doxygen (http://www.doxygen.org)
 rem
-rem 3) Call setenvironment.bat or setenvironment64.bat depending on whether you're building 32-bit or 64-bit MapGuide. Adjust any paths in those two files as appropriate so that it points to your specific JDK, ANT and Doxygen directories
+rem 3) Call acquire-doctools.ps1 to ensure the language-specifc API doc generation tools are installed/downloaded
+rem     NOTE: You may have to change execution policy in order to run powershell scripts
+rem
+rem 4) Call setenvironment.bat or setenvironment64.bat depending on whether you're building 32-bit or 64-bit MapGuide. Adjust any paths in those two files as appropriate so that it points to your specific JDK and ANT directories
 rem     
 rem For a "cleaner" build experience, run this script from an exported copy of the
 rem MapGuide source code (ie. without subversion folders). 
@@ -256,8 +258,8 @@
 
 :build_doc
 echo [build]: Building Doc
-pushd %MG_DOC%
-call MgOpenSource_run_doxygen.bat
+pushd %CD%\Bindings
+call build_doc.bat
 popd
 echo [build]: MapGuide Developer's Guide
 pushd %MG_DOC%\devguide

Modified: branches/4.0/MgDev/setenvironment64.bat
===================================================================
--- branches/4.0/MgDev/setenvironment64.bat	2023-11-10 15:08:48 UTC (rev 10060)
+++ branches/4.0/MgDev/setenvironment64.bat	2023-11-10 16:16:27 UTC (rev 10061)
@@ -89,13 +89,12 @@
 rem ==================================================
 
 IF "%JAVA_HOME%" == "" SET JAVA_HOME=C:\Program Files\Java\jdk1.7.0_80
-IF "%DOXYGEN%" == "" SET DOXYGEN=C:\Program Files\doxygen\bin
 IF "%GNUWIN32%" == "" SET GNUWIN32=C:\Program Files (x86)\GnuWin32\bin
 IF "%SEVENZ%" == "" SET SEVENZ=%MG_DEV%\BuildTools\WebTools\7-Zip
 IF "%ANT_HOME%" == "" SET ANT_HOME=C:\apache-ant
 IF "%SWIG_DIR%" == "" SET SWIG_DIR=C:\swigwin-4.1.1
 
-SET PATH=%PATH%;%DOXYGEN%;%GNUWIN32%;%SEVENZ%;%ANT_HOME%\bin
+SET PATH=%PATH%;%GNUWIN32%;%SEVENZ%;%ANT_HOME%\bin
 rem ==================================================
 rem PHP/httpd env vars for Visual Studio
 rem ==================================================



More information about the mapguide-commits mailing list