Jira (BOLT-612) Some docs only list unix paths, not Windows

Glenn Sarti (JIRA)

unread,

Jun 20, 2018, 1:58:03 AM6/20/18

to puppe...@googlegroups.com

Glenn Sarti created an issue

Puppet Task Runner /

BOLT-612

Some docs only list unix paths, not Windows

Issue Type:	Improvement
Assignee:	Unassigned
Created:	2018/06/19 10:57 PM
Priority:	Normal
Reporter:	Glenn Sarti

Some parts of the documentation only list Unix style paths, missing out it's equivalent in Windows. This is confusing for Windows users attempting to A) read the docs and B) use Bolt on Windows;

https://puppet.com/docs/bolt/0.x/new_features.html#local-default-configuration-directory-boltdir-0-21-0

https://puppet.com/docs/bolt/0.x/new_features.html#analytics-data-collection-0-20-6

https://puppet.com/docs/bolt/0.x/new_features.html#bolt-config-file-for-common-options-0-10-0

https://puppet.com/docs/bolt/0.x/bolt_options.html#concept-9325

https://puppet.com/docs/bolt/0.x/inventory_file_generating.html#usage

No Windows help here
https://puppet.com/docs/bolt/0.x/bolt_connect_puppetdb.html

$HOME is a unix-ism, in windows it's %HOME% or $ENV:HOME for cmd.exe or powershell respectively
https://puppet.com/docs/bolt/0.x/configuring_bolt.html

Possible infractions
https://puppet.com/docs/bolt/0.x/new_features.html#kereberos-support-added-0-7-0

Does this example actually work on Windows?
https://puppet.com/docs/bolt/0.x/bolt_configuration_options.html#sample-bolt-config-file

Add Comment

This message was sent by Atlassian JIRA (v7.7.1#77002-sha1:e75ca93)

Michael Smith (JIRA)

unread,

Jun 20, 2018, 12:59:04 PM6/20/18

to puppe...@googlegroups.com

Michael Smith commented on

BOLT-612

Re: Some docs only list unix paths, not Windows

~/modules is a valid path in Windows PowerShell.

Add Comment

Michael Smith (JIRA)

unread,

Jun 20, 2018, 1:03:02 PM6/20/18

to puppe...@googlegroups.com

Michael Smith updated an issue

Puppet Task Runner /

BOLT-612

Some docs only list unix paths, not Windows

Change By:	Michael Smith
Sprint:	Bolt Ready for Grooming

Add Comment

Glenn Sarti (JIRA)

unread,

Jun 20, 2018, 9:10:03 PM6/20/18

to puppe...@googlegroups.com

Glenn Sarti commented on

BOLT-612

Re: Some docs only list unix paths, not Windows

"~" is only valid in the filesystem provider (at least in our case)

e.g.

C:\Source> dir ~

Directory: C:\Users\glenn.sarti

Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 3/02/2018 9:18 PM .bundle
d----- 7/02/2018 4:28 PM .cache
~~~
a--- 20/06/2018 8:21 PM 224256 .wakatime.db
a--- 20/06/2018 8:21 PM 18493628 .wakatime.log

C:\Source> get-psdrive

Name Used (GB) Free (GB) Provider Root CurrentLocation ---- --------- --------- -------- ---- --------------- Alias Alias
C 331.15 145.19 FileSystem C:\ Source Cert Certificate \
Env Environment
Function Function
HKCU Registry HKEY_CURRENT_USER
HKLM Registry HKEY_LOCAL_MACHINE
Variable Variable
WSMan WSMan

C:\Source> cd alias:
Alias:\> dir ~
Get-ChildItem : Cannot retrieve the dynamic parameters for the cmdlet. Home location for this provider is not set. To set the home location, call "(get-psprovider 'Alias').Home = 'path'".