LoxSmoke.mddox 0.14.2

.NET 8.0

dotnet tool install --global LoxSmoke.mddox --version 0.14.2

This package contains a .NET tool you can call from the shell/command line.

dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local LoxSmoke.mddox --version 0.14.2

This package contains a .NET tool you can call from the shell/command line.

#tool dotnet:?package=LoxSmoke.mddox&version=0.14.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

nuke :add-package LoxSmoke.mddox --version 0.14.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

mddox

Global tool that creates markdown documentation using reflection and XML comments extracted from the source code by the compiler.

Sample documentation generated by the tool

Command line command used to generate the docxml.dll assembly documentation:

mddox DocXml.dll -s latest

Sample documentation with method details

Command line command used to generate the docxml.dll assembly documentation with method details:

mddox DocXml.dll -s latest -d

Sample documentation generated by the tool in zh-CN locale Command line command used to generate the docxml.dll assembly documentation:

mddox DocXml.dll -s latest --language zh-cn

MSDN page on XML documentation comments

Installation

dotnet tool install -g loxsmoke.mddox

Uninstallation

dotnet tool uninstall -g loxsmoke.mddox

Usage

mddox
Usage: mddox <assembly> [optional-parameters]

<assembly>   - The name of the assembly to document.

Optional parameters:

Short format	Long format	Comment
-o output_md	--output output_md	The name of the markdown output file.
-f format	--format format	The markdown file format. Valid values: github,bitbucket,azure.
	--all-recursive	Step into all referenced assemblies recursively.
-r assembly	--recursive assembly	Step into specified referenced assemblies recursively.<br>Specify one or more assembly names separated by spaces.
	--include stuff	The list of space-separated filters of things to include in documentation.<br>Filter by access: subject.visibility<br>Subject is one of: [all, type, method, field, property]<br>Visibility is one of: [all, public, protected, private]<br>Example: all.public<br><br>Filter by attribute: subject.attribute.attribute_name<br>Subject is one of: [all, type, method, field, property]<br>attribute_name is the name of the attribute.<br>Example: field.attribute.JsonIgnoreAttribute<br><br>Filter by name: subject.name.wildcard<br>Subject is one of: [all, type, method, field, property]<br>wildcard is a simple wildcard matching the name.<br>Example: type.name.Hidden*<br>
	--exclude stuff	The list of space-separated filters of things to exclude from documentation.<br>Syntax is the same as for include filters
-m	--ignore-methods	Deprecated. Replaced with --exclude method.all. Do not generate documentation for methods and constructors.<br>Useful for POCO documentation.
-d	--method-details	Generate detailed documentation for methods and constructors.<br>Setting has no effect if --ignore-methods is specified.
-a name	--ignore-attribute name	Deprecated. Replaced with --exclude all.attribute.name. Do not generate documentation for properties with specified custom attribute(s).<br>For example JsonIgnoreAttribute<br>More than one space-separate attribute can be specified.
-t name	--type name	Document only the specified type and all types referenced by it.
-s view	--msdn view	Generate links to the MSDN documentation for System.* and Microsoft.* types.<br>The documentation pages are located at this site https://docs.microsoft.com<br>View specifies what version of the type to show.<br>Examples: latest, netcore-3.1, net-8.0, netstandard-2.1
-i "title"	--title "title"	Document title. Use {assembly} and {version} in the format string to insert the name of the assembly and assembly version.
-n	--no-title	Do not write the "created by mddox at date" in the markdown file.
-v	--verbose	Print some debug info when generating documentation. It may help troubleshooting some issues such as missing type information of referenced assemblies.
-l	--language "language-code"	Generate output using specified language. Available languages: en-us, zh-cn

For best results enable XML documentation build switch in your project and use publish build to get all referenced assemblies in one folder.

Documenting all types of one assembly

mddox MyAssembly.dll

Documenting only fields and properties of all types in assembly

mddox MyAssembly.dll --exclude method.all

Documenting types that do not have specified custom attributes

mddox MyAssembly.dll --exclude all.attribute.JsonIgnoreAttribute --exclude all.attribute.XmlIgnore

Document one type and all referenced types from different assemblies

mddox MyAssembly.dll --type ClassToDocument --recursive ReferencedAssembly1.dll --recursive ReferencedAssembly2.dll

Solutions

There are two solutions in this repository. The mddox.sln solution includes DocXml nuget package. The mddox-dev.sln is development solution that includes full source of DocXml as git sub-module. Sub-module can be updated to the latest version by running git pull origin master in the DocXml folder.

Product	Compatible and additional computed target framework versions.
.NET	net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version	Downloads	Last updated
0.14.2	119	10/19/2024
0.14.1	117	10/19/2024
0.14.0	121	10/18/2024
0.13.1	157	8/19/2024
0.13.0	108	8/18/2024
0.12.0	274	1/23/2024
0.11.0	228	12/21/2023
0.10.0	310	11/24/2023
0.9.1	800	6/24/2021
0.9.0	404	3/19/2021
0.8.0	458	3/14/2021
0.7.3	445	2/12/2021
0.7.2	516	12/14/2020
0.7.1	461	10/18/2020
0.7.0	633	9/26/2020
0.6.0	540	9/1/2020
0.5.9	517	8/31/2020
0.5.8	589	6/3/2020
0.5.7	509	6/1/2020
0.5.7-beta	394	5/28/2020
0.5.6-beta	447	5/25/2020
0.5.5-beta	457	5/18/2020
0.5.4-beta	395	5/12/2020
0.5.3	544	5/10/2020
0.5.2	523	5/2/2020
0.5.1	927	3/5/2020
0.5.0	512	3/2/2020
0.4.2-beta	513	2/24/2020
0.4.0	720	1/25/2020
0.3.0	1,066	7/31/2019
0.2.0	600	7/29/2019
0.1.0	586	7/23/2019