Update relevant files to UTF8 with BOM

[dtgm]

The notes at https://github.com/chocolatey/choco/wiki/CreatePackages#character-encoding regarding BOMs is inaccurate. The wiki needs to get updated.

• Do not save your *.nuspec files with a Byte Order Mark (BOM). A BOM is neither required nor recommended for UTF-8, because it can lead to several issues.

This is largely FUD; while it is possible to have issues with older programs, there are more benefits than not to contain a BOM.

• PowerShell scripts need to be saved in UTF-8 with BOM. PowerShell is ignoring the standards and needs a BOM in order to recognize scripts as UTF-8. Otherwise it processes non ASCII characters incorrectly.

I realized many of by PS1 files do not have a BOM.

[dtgm]

$path = "C:\dev\choco\chocolatey-packages\automatic\[a-zA-Z0-9]*"
$include = @(
  "*.ahk",
  "*.md",
  "*.nuspec",
  "*.ps1",
  "*.psm1",
  "*.py",
  "*.txt",
  "*.xml"
)
$files = get-childitem -Path $path -Include $include -Recurse
# Find files that contain BOM by only reading first 3 bytes of file
#http://superuser.com/a/418520/64039
Function ContainsBOM
{
    return $input | where {
        $contents = new-object byte[] 3
        $stream = [System.IO.File]::OpenRead($_.FullName)
        $stream.Read($contents, 0, 3) | Out-Null
        $stream.Close()
        $contents[0] -eq 0xEF -and $contents[1] -eq 0xBB -and $contents[2] -eq 0xBF }
}
$filesBomTrue = New-Object System.Collections.ArrayList($null)
$filesBomFalse = New-Object System.Collections.ArrayList($null)
foreach ($f in $files) {
  if ($f | ContainsBOM) {[void]$filesBomTrue.Add($f)}
  else {[void]$filesBomFalse.Add($f)}
}
foreach ($f in $filesBomFalse) {
  $text = Get-Content -Raw -Encoding UTF8 -Path $f.PSPath
  [io.file]::WriteAllText($f.FullName, $text, [text.encoding]::UTF8)
}

This repo will now require files be encoded as UTF8-BOM