public GenerateDocCommand(
GenerateDocCommandLineOptions options,
DocumentationDepth depth,
RootDocumentationParts ignoredRootParts,
NamespaceDocumentationParts ignoredNamespaceParts,
TypeDocumentationParts ignoredTypeParts,
MemberDocumentationParts ignoredMemberParts,
OmitContainingNamespaceParts omitContainingNamespaceParts,
Visibility visibility,
in ProjectFilter projectFilter) : base(projectFilter)
public static bool TryParseOmitContainingNamespaceParts(IEnumerable <string> values, out OmitContainingNamespaceParts parts)
{
if (!values.Any())
{
parts = DocumentationOptions.Default.OmitContainingNamespaceParts;
return(true);
}
parts = OmitContainingNamespaceParts.None;
foreach (string value in values)
{
if (Enum.TryParse(value.Replace("-", ""), ignoreCase: true, out OmitContainingNamespaceParts result))
{
parts |= result;
}
else
{
WriteLine($"Unknown omit containing namespace part '{value}'.", Verbosity.Quiet);
return(false);
}
}
return(true);
}
internal bool IncludeContainingNamespace(OmitContainingNamespaceParts parts)
{
return((OmitContainingNamespaceParts & parts) == 0);
}
public DocumentationOptions(
IEnumerable <string> ignoredNames = null,
string preferredCultureName = null,
string rootDirectoryUrl = null,
int maxDerivedTypes = DefaultValues.MaxDerivedTypes,
bool includeClassHierarchy = DefaultValues.IncludeClassHierarchy,
bool placeSystemNamespaceFirst = DefaultValues.PlaceSystemNamespaceFirst,
bool formatDeclarationBaseList = DefaultValues.FormatDeclarationBaseList,
bool formatDeclarationConstraints = DefaultValues.FormatDeclarationConstraints,
bool markObsolete = DefaultValues.MarkObsolete,
bool includeMemberInheritedFrom = DefaultValues.IncludeMemberInheritedFrom,
bool includeMemberOverrides = DefaultValues.IncludeMemberOverrides,
bool includeMemberImplements = DefaultValues.IncludeMemberImplements,
bool includeMemberConstantValue = DefaultValues.IncludeMemberConstantValue,
bool includeInheritedInterfaceMembers = DefaultValues.IncludeInheritedInterfaceMembers,
bool includeAllDerivedTypes = DefaultValues.IncludeInheritedInterfaceMembers,
bool includeAttributeArguments = DefaultValues.IncludeAttributeArguments,
bool includeInheritedAttributes = DefaultValues.IncludeInheritedAttributes,
bool omitIEnumerable = DefaultValues.OmitIEnumerable,
DocumentationDepth depth = DefaultValues.Depth,
InheritanceStyle inheritanceStyle = DefaultValues.InheritanceStyle,
RootDocumentationParts ignoredRootParts = RootDocumentationParts.None,
NamespaceDocumentationParts ignoredNamespaceParts = NamespaceDocumentationParts.None,
TypeDocumentationParts ignoredTypeParts = TypeDocumentationParts.None,
MemberDocumentationParts ignoredMemberParts = MemberDocumentationParts.None,
OmitContainingNamespaceParts omitContainingNamespaceParts = OmitContainingNamespaceParts.None,
bool scrollToContent = DefaultValues.ScrollToContent)
{
if (maxDerivedTypes < 0)
{
throw new ArgumentOutOfRangeException(nameof(maxDerivedTypes), maxDerivedTypes, "Maximum number of derived items must be greater than or equal to 0.");
}
_ignoredMetadataNames = ignoredNames?.Select(name => MetadataName.Parse(name)).ToImmutableArray() ?? default;
IgnoredNames = ignoredNames?.ToImmutableArray() ?? ImmutableArray <string> .Empty;
PreferredCultureName = preferredCultureName;
RootDirectoryUrl = rootDirectoryUrl;
MaxDerivedTypes = maxDerivedTypes;
IncludeClassHierarchy = includeClassHierarchy;
PlaceSystemNamespaceFirst = placeSystemNamespaceFirst;
FormatDeclarationBaseList = formatDeclarationBaseList;
FormatDeclarationConstraints = formatDeclarationConstraints;
MarkObsolete = markObsolete;
IncludeMemberInheritedFrom = includeMemberInheritedFrom;
IncludeMemberOverrides = includeMemberOverrides;
IncludeMemberImplements = includeMemberImplements;
IncludeMemberConstantValue = includeMemberConstantValue;
IncludeInheritedInterfaceMembers = includeInheritedInterfaceMembers;
IncludeAllDerivedTypes = includeAllDerivedTypes;
IncludeAttributeArguments = includeAttributeArguments;
IncludeInheritedAttributes = includeInheritedAttributes;
OmitIEnumerable = omitIEnumerable;
Depth = depth;
InheritanceStyle = inheritanceStyle;
IgnoredRootParts = ignoredRootParts;
IgnoredNamespaceParts = ignoredNamespaceParts;
IgnoredTypeParts = ignoredTypeParts;
IgnoredMemberParts = ignoredMemberParts;
OmitContainingNamespaceParts = omitContainingNamespaceParts;
ScrollToContent = scrollToContent;
}
