Skip to content

Commit 00a6dae

Browse files
committed
Cleanup for next release.
1 parent 42b354f commit 00a6dae

3 files changed

Lines changed: 34 additions & 3 deletions

File tree

CHANGELOG.md

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,26 @@ IMPROVEMENTS:
77
BUG FIXES:
88

99

10+
## 2.0.02 (January 5, 2016)
11+
12+
IMPROVEMENTS:
13+
- Report missing cmdlet documentation (proxied by missing Description section).
14+
- Add support for build systems/continuous integration with -EnableExit.
15+
16+
17+
BUG FIXES:
18+
- Corrected link resolver to treat single words as plain text rather than a cmdlet name.
19+
- Correct rendering of HTML-special characters in syntax section.
20+
- Resynced link to DocTreeGenerator in template to new GitHub location.
21+
- Resynced template path after file reorganization.
22+
23+
24+
1025
## 2.0.01 (December 21, 2015)
1126

1227
Migrated from http://cleancode.sourceforge.net/
1328

14-
IMPROVEMENTS TO Convert-HelpToHtmlTree
29+
IMPROVEMENTS:
1530
- Add support for documenting binary cmdlets (those written in C#)
1631
- Stylize syntax section (embolden cmdlet name, italicize parameter types)
1732
- Improve support for text layout:

Convert-HelpToHtmlTree.html

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ <h2>SYNOPSIS</h2>
3535
<div class='PowerShellDoc'>
3636
<h2>SYNTAX</h2>
3737
<div>
38-
<b>Convert-HelpToHtmlTree</b> [-Namespaces] <i>&lt;String[]&gt;</i> [[-TargetDir] <i>&lt;String&gt;</i>] [[-TemplateName] <i>&lt;String&gt;</i>] [[-DocTitle] <i>&lt;String&gt;</i>] [[-Copyright] <i>&lt;String&gt;</i>] [[-RevisionDate] <i>&lt;String&gt;</i>] [-WhatIf] [-Confirm] [<i>&lt;CommonParameters&gt;</i>]
38+
<b>Convert-HelpToHtmlTree</b> [-Namespaces] <i>&lt;String[]&gt;</i> [[-TargetDir] <i>&lt;String&gt;</i>] [[-TemplateName] <i>&lt;String&gt;</i>] [[-DocTitle] <i>&lt;String&gt;</i>] [[-Copyright] <i>&lt;String&gt;</i>] [[-RevisionDate] <i>&lt;String&gt;</i>] [-EnableExit] [-WhatIf] [-Confirm] [<i>&lt;CommonParameters&gt;</i>]
3939
<br/>
4040
<br/></div>
4141
</div>
@@ -330,6 +330,20 @@ <h2>PARAMETERS</h2>
330330
<pre> Default value </pre>
331331
<pre> Accept pipeline input? false</pre>
332332
<pre> Accept wildcard characters? false</pre>
333+
<br/>
334+
-<strong>EnableExit [&lt;SwitchParameter&gt;]</strong>
335+
<br/>
336+
Causes Convert-HelpToHtmlTree to exit with an exit code equal to the number of errors detected.
337+
Use this to "fail" a build when there are documentation errors.
338+
Note that this switch causes the invoking shell to exit upon completion of the cmdlet as well!
339+
Thus, typically you do *not* want to use this switch interactively.
340+
<br/>
341+
<br/>
342+
<pre> Required? false</pre>
343+
<pre> Position? named</pre>
344+
<pre> Default value False</pre>
345+
<pre> Accept pipeline input? false</pre>
346+
<pre> Accept wildcard characters? false</pre>
333347
<br/>
334348
-<strong>WhatIf [&lt;SwitchParameter&gt;]</strong>
335349
<br/>
@@ -424,7 +438,7 @@ <h2>RELATED LINKS</h2>
424438

425439

426440
<p><i>
427-
This documentation set was created with CleanCode's
441+
This documentation set was created with
428442
<a target="_blank" href="https://github.com/msorens/DocTreeGenerator">DocTreeGenerator</a>.
429443
</i></p>
430444

Source/Convert-HelpToHtmlTree.ps1

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -216,6 +216,8 @@ to remove the rest of the revision date phrase.
216216
.PARAMETER EnableExit
217217
Causes Convert-HelpToHtmlTree to exit with an exit code equal to the number of errors detected.
218218
Use this to "fail" a build when there are documentation errors.
219+
Note that this switch causes the invoking shell to exit upon completion of the cmdlet as well!
220+
Thus, typically you do *not* want to use this switch interactively.
219221
220222
.INPUTS
221223
None. You cannot pipe objects to Convert-HelpToHtmlTree.

0 commit comments

Comments
 (0)