ArgumentsUnion

PackageFsLiveDocs
Defines the supported command-line arguments for the livedocs tool.

Specification

Kind
Union
Members
68
Examples
0
IsIgnoreSignature
this.IsIgnore
IsBuildSignature
this.IsBuild
IsAuditSignature
this.IsAudit
IsGenerate_CISignature
this.IsGenerate_CI
IsCapsuleSignature
this.IsCapsule

Summary

NameSignatureSynopsis
IsIgnorethis.IsIgnoreNo description available.
IsBuildthis.IsBuildNo description available.
IsAuditthis.IsAuditNo description available.
IsGenerate_CIthis.IsGenerate_CINo description available.
IsCapsulethis.IsCapsuleNo description available.
IsThemethis.IsThemeNo description available.
IsBannerthis.IsBannerNo description available.
IsDry_Runthis.IsDry_RunNo description available.
IsUrlthis.IsUrlNo description available.
IsRetrythis.IsRetryNo description available.
IsDiscover_Projectsthis.IsDiscover_ProjectsNo description available.
IsInitthis.IsInitNo description available.
IsHostthis.IsHostNo description available.
IsPortthis.IsPortNo description available.
IsOutputthis.IsOutputNo description available.
IsHistory_Syncthis.IsHistory_SyncNo description available.
IsCapturethis.IsCaptureNo description available.
IsGenerate_Teststhis.IsGenerate_TestsNo description available.
IsWarn_As_Errorthis.IsWarn_As_ErrorNo description available.
IsWatchthis.IsWatchNo description available.
IsVerify_Outputthis.IsVerify_OutputNo description available.
IsFromthis.IsFromNo description available.
IsInteractivethis.IsInteractiveNo description available.
IsHistory_Addthis.IsHistory_AddNo description available.
IsTestthis.IsTestNo description available.
IsVerbositythis.IsVerbosityNo description available.
IsHistory_Checkthis.IsHistory_CheckNo description available.
IsSha256this.IsSha256No description available.
IsVersionthis.IsVersionNo description available.
IsExtractthis.IsExtractNo description available.
IsProviderthis.IsProviderNo description available.
IsBuild_Historythis.IsBuild_HistoryNo description available.
IsInspectthis.IsInspectNo description available.
IsSha256_Filethis.IsSha256_FileNo description available.
InitInitAdds FsLiveDocs configuration and starter documentation to a repository.
Generate_CIGenerate_CIGenerates a GitHub Actions workflow for documentation verification and releases.
Generate_TestsGenerate_Tests projectPathsGenerates a test project for documentation examples.
ExtractExtract projectPathsExtracts symbol metadata from projects into JSON snapshots.
CaptureCapture projectPathsCaptures a self-contained, renderer-neutral documentation release.
InspectInspect capsulePathVerifies and describes a release capsule.
History_AddHistory_Add versionAdds an immutable capsule reference to a release history index.
History_CheckHistory_CheckRenders and verifies the release history, optionally with a local candidate capsule.
History_SyncHistory_Sync repositoryOne-way: discovers published capsules and merges them into the local history index.
Verify_OutputVerify_Output manifestPathVerifies generated history entry points, version ordering, and local links.
TestTest projectPathsRuns verified code examples found in docstrings.
AuditAudit projectPathsAudits coverage and compiler-checks every expanded F# documentation block.
BuildBuild projectPathsBuilds the full static documentation site.
Build_HistoryBuild_History manifestPathBuilds every version in a verified local history manifest.
WatchWatch projectPathsBuilds, serves, and rebuilds a local documentation preview.
ThemeTheme stringSets the generated site's visual theme.
VersionVersion stringSets the documentation version for build, extraction, or capture.
OutputOutput stringSets the output path for commands that write an artifact or history index.
CapsuleCapsule stringSets a local capsule path for history-add.
UrlUrl stringSets an HTTPS capsule URL for history-add.
Sha256Sha256 stringSets the expected capsule SHA-256 for history operations.
Sha256_FileSha256_File stringReads the expected capsule SHA-256 from a file written by capture.
FromFrom stringSets a shell command that lists published capsules for history-sync.
ProviderProvider stringSelects the CI host for generate-ci.
RetryRetry intSets the number of transient download attempts for build-history.
HostHost stringSets the network interface used by the preview server.
PortPort intSets the TCP port used by the preview server.
IgnoreIgnore stringAdds directory names the preview watcher must not watch or rebuild for.
Warn_As_ErrorWarn_As_ErrorFails the run when the documented API produces quality warnings.
VerbosityVerbosity stringSets console verbosity to warnings, info, or debug.
InteractiveInteractive boolEnables or disables interactive terminal rendering.
BannerBanner boolEnables or disables the LiveDocs banner.
Discover_ProjectsDiscover_ProjectsDiscovers documentable projects and records them in .livedocs/config.json during init.
Dry_RunDry_RunValidates capture and reports its expected result without writing a capsule.

IsIgnore

this.IsIgnore
Member

Returns

bool

IsBuild

this.IsBuild
Member

Returns

bool

IsAudit

this.IsAudit
Member

Returns

bool

IsGenerate_CI

this.IsGenerate_CI
Member

Returns

bool

IsCapsule

this.IsCapsule
Member

Returns

bool

IsTheme

this.IsTheme
Member

Returns

bool

IsBanner

this.IsBanner
Member

Returns

bool

IsDry_Run

this.IsDry_Run
Member

Returns

bool

IsUrl

this.IsUrl
Member

Returns

bool

IsRetry

this.IsRetry
Member

Returns

bool

IsDiscover_Projects

this.IsDiscover_Projects
Member

Returns

bool

IsInit

this.IsInit
Member

Returns

bool

IsHost

this.IsHost
Member

Returns

bool

IsPort

this.IsPort
Member

Returns

bool

IsOutput

this.IsOutput
Member

Returns

bool

IsHistory_Sync

this.IsHistory_Sync
Member

Returns

bool

IsCapture

this.IsCapture
Member

Returns

bool

IsGenerate_Tests

this.IsGenerate_Tests
Member

Returns

bool

IsWarn_As_Error

this.IsWarn_As_Error
Member

Returns

bool

IsWatch

this.IsWatch
Member

Returns

bool

IsVerify_Output

this.IsVerify_Output
Member

Returns

bool

IsFrom

this.IsFrom
Member

Returns

bool

IsInteractive

this.IsInteractive
Member

Returns

bool

IsHistory_Add

this.IsHistory_Add
Member

Returns

bool

IsTest

this.IsTest
Member

Returns

bool

IsVerbosity

this.IsVerbosity
Member

Returns

bool

IsHistory_Check

this.IsHistory_Check
Member

Returns

bool

IsSha256

this.IsSha256
Member

Returns

bool

IsVersion

this.IsVersion
Member

Returns

bool

IsExtract

this.IsExtract
Member

Returns

bool

IsProvider

this.IsProvider
Member

Returns

bool

IsBuild_History

this.IsBuild_History
Member

Returns

bool

IsInspect

this.IsInspect
Member

Returns

bool

IsSha256_File

this.IsSha256_File
Member

Returns

bool

Init

Init
Member
Adds FsLiveDocs configuration and starter documentation to a repository.

Returns

unit

Generate_CI

Generate_CI
Member
Generates a GitHub Actions workflow for documentation verification and releases.

Returns

unit

Generate_Tests

Generate_Tests projectPaths
Member
Generates a test project for documentation examples.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Extract

Extract projectPaths
Member
Extracts symbol metadata from projects into JSON snapshots.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Capture

Capture projectPaths
Member
Captures a self-contained, renderer-neutral documentation release.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Inspect

Inspect capsulePath
Member
Verifies and describes a release capsule.

Parameters

NameTypeDescription
capsulePathstring

Returns

unit

History_Add

History_Add version
Member
Adds an immutable capsule reference to a release history index.

Parameters

NameTypeDescription
versionstring list

Returns

unit

History_Check

History_Check
Member
Renders and verifies the release history, optionally with a local candidate capsule.

Returns

unit

History_Sync

History_Sync repository
Member
One-way: discovers published capsules and merges them into the local history index. Never changes releases.

Parameters

NameTypeDescription
repositorystring list

Returns

unit

Verify_Output

Verify_Output manifestPath
Member
Verifies generated history entry points, version ordering, and local links.

Parameters

NameTypeDescription
manifestPathstring

Returns

unit

Test

Test projectPaths
Member
Runs verified code examples found in docstrings.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Audit

Audit projectPaths
Member
Audits coverage and compiler-checks every expanded F# documentation block.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Build

Build projectPaths
Member
Builds the full static documentation site.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Build_History

Build_History manifestPath
Member
Builds every version in a verified local history manifest.

Parameters

NameTypeDescription
manifestPathstring

Returns

unit

Watch

Watch projectPaths
Member
Builds, serves, and rebuilds a local documentation preview.

Parameters

NameTypeDescription
projectPathsstring list

Returns

unit

Theme

Theme string
Member
Sets the generated site's visual theme.

Parameters

NameTypeDescription
Itemstring

Returns

unit

Version

Version string
Member
Sets the documentation version for build, extraction, or capture.

Parameters

NameTypeDescription
Itemstring

Returns

unit

Output

Output string
Member
Sets the output path for commands that write an artifact or history index.

Parameters

NameTypeDescription
Itemstring

Returns

unit

Capsule

Capsule string
Member
Sets a local capsule path for history-add.

Parameters

NameTypeDescription
Itemstring

Returns

unit

Url

Url string
Member
Sets an HTTPS capsule URL for history-add.

Parameters

NameTypeDescription
Itemstring

Returns

unit

Sha256

Sha256 string
Member
Sets the expected capsule SHA-256 for history operations.

Parameters

NameTypeDescription
Itemstring

Returns

unit

Sha256_File

Sha256_File string
Member
Reads the expected capsule SHA-256 from a file written by capture.

Parameters

NameTypeDescription
Itemstring

Returns

unit

From

From string
Member
Sets a shell command that lists published capsules for history-sync.

Parameters

NameTypeDescription
Itemstring

Returns

unit

Provider

Provider string
Member
Selects the CI host for generate-ci.

Parameters

NameTypeDescription
Itemstring

Returns

unit

Retry

Retry int
Member
Sets the number of transient download attempts for build-history.

Parameters

NameTypeDescription
Itemint

Returns

unit

Host

Host string
Member
Sets the network interface used by the preview server.

Parameters

NameTypeDescription
Itemstring

Returns

unit

Port

Port int
Member
Sets the TCP port used by the preview server.

Parameters

NameTypeDescription
Itemint

Returns

unit

Ignore

Ignore string
Member
Adds directory names the preview watcher must not watch or rebuild for.

Parameters

NameTypeDescription
Itemstring

Returns

unit

Warn_As_Error

Warn_As_Error
Member
Fails the run when the documented API produces quality warnings.

Returns

unit

Verbosity

Verbosity string
Member
Sets console verbosity to warnings, info, or debug.

Parameters

NameTypeDescription
Itemstring

Returns

unit

Interactive

Interactive bool
Member
Enables or disables interactive terminal rendering.

Parameters

NameTypeDescription
Itembool

Returns

unit

Banner

Banner bool
Member
Enables or disables the LiveDocs banner.

Parameters

NameTypeDescription
Itembool

Returns

unit

Discover_Projects

Discover_Projects
Member
Discovers documentable projects and records them in .livedocs/config.json during init.

Returns

unit

Dry_Run

Dry_Run
Member
Validates capture and reports its expected result without writing a capsule.

Returns

unit