-
Notifications
You must be signed in to change notification settings - Fork 2
Expand file tree
/
Copy pathGenerateDocIGLibAll.ps1
More file actions
39 lines (34 loc) · 1.57 KB
/
GenerateDocIGLibAll.ps1
File metadata and controls
39 lines (34 loc) · 1.57 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
<#
.SYNOPSIS
Script for generating code documentation (configuration ID "DocIGLibAll";
file DocIGLibAll.dox - the modern IGLib with EXTENDED code, and NO
sources included.
Except ConfigurationId and IsSourcesIncluded, which are fixed, this script
has the same parameters as GenerateCodeDoc.ps1, which it calls to do the
work. Overriding their default values changes the behavior of code
generation, but in many use cases this is not necessary and the script can
be called without parameters.
The LaunchDoc parameter should be set to false wheen this script is called
in CI/CD pipelines. If newer binaries are provided in the codedoc_resources
repository, call this script with ForceUpdates set to true once, or just
execute the UpdateRepo_codedoc_resources.ps1 script.
#>
# Parameters for GenerateCodeDoc.ps1 that can be modified:
param (
[bool]$ForceUpdates = $false,
[bool]$LaunchDoc = $true
)
# Fixed parameters for calling GenerateCodeDoc.ps1: # this block must come after param(...)
$ConfigurationId = "DocIGLibAll"
$IsSourcesIncluded = $false
########################### Fixed part of the script:
# Get the script path to determine the path of the documentation generating
# script:
$scriptPath = $MyInvocation.MyCommand.Path
$scriptDir = Split-Path $scriptPath -Parent
$generationScript = (Join-Path $scriptDir "GenerateCodeDoc.ps1")
# Call GenerateCodeDoc.ps1 to do the job:
& $generationScript -ConfigurationId $ConfigurationId `
-IsSourcesIncluded $IsSourcesIncluded `
-LaunchDoc $LaunchDoc `
$ForceUpdates $ForceUpdates