Updates to Help text - mostly layout, inc making it VSCode freindly

AddConditionalFormatting.ps1

@@ -32,14 +32,14 @@
         [Parameter(Mandatory = $true, ParameterSetName = "FourIconSet")]
         [Parameter(Mandatory = $true, ParameterSetName = "FiveIconSet")]
         [OfficeOpenXml.ExcelAddress]$Range ,
-        #One or more row(s), Column(s) and/or block(s) of cells to format
+        #One or more row(s), column(s) and/or block(s) of cells to format
         [Parameter(Mandatory = $true, ParameterSetName = "NamedRuleAddress")]
         [Parameter(Mandatory = $true, ParameterSetName = "DataBarAddress")]
         [Parameter(Mandatory = $true, ParameterSetName = "ThreeIconSetAddress")]
         [Parameter(Mandatory = $true, ParameterSetName = "FourIconSetAddress")]
         [Parameter(Mandatory = $true, ParameterSetName = "FiveIconSetAddress")]
         $Address ,
-        #One of the standard named rules - Top / Bottom / Less than / Greater than / Contains etc
+        #One of the standard named rules - Top / Bottom / Less than / Greater than / Contains etc.
         [Parameter(Mandatory = $true, ParameterSetName = "NamedRule", Position = 3)]
         [Parameter(Mandatory = $true, ParameterSetName = "NamedRuleAddress", Position = 3)]
         [OfficeOpenXml.ConditionalFormatting.eExcelConditionalFormattingRuleType]$RuleType ,
@@ -65,7 +65,7 @@
         [OfficeOpenXml.ConditionalFormatting.eExcelconditionalFormatting5IconsSetType]$FiveIconsSet,
         #A value for the condition (e.g. "2000" if the test is 'lessthan 2000')
         [string]$ConditionValue,
-        #A second value for the conditions like between x and Y
+        #A second value for the conditions like "between x and Y"
         [string]$ConditionValue2,
         #Background colour for matching items
         [System.Drawing.Color]$BackgroundColor,

ConvertFromExcelToSQLInsert.ps1

@@ -2,47 +2,30 @@ function ConvertFrom-ExcelToSQLInsert {
     <#
       .SYNOPSIS
         Generate SQL insert statements from Excel spreadsheet.
-
       .DESCRIPTION
         Generate SQL insert statements from Excel spreadsheet.
-
       .PARAMETER TableName
         Name of the target database table.
-
       .PARAMETER Path
         Path to an existing .XLSX file
-
         This parameter is passed to Import-Excel as is.
-
       .PARAMETER WorkSheetname
         Specifies the name of the worksheet in the Excel workbook to import. By default, if no name is provided, the first worksheet will be imported.
-
         This parameter is passed to Import-Excel as is.
-
       .PARAMETER StartRow
         The row from where we start to import data, all rows above the StartRow are disregarded. By default this is the first row.
-
         When the parameters ‘-NoHeader’ and ‘-HeaderName’ are not provided, this row will contain the column headers that will be used as property names. When one of both parameters are provided, the property names are automatically created and this row will be treated as a regular row containing data.
-
       .PARAMETER Header
         Specifies custom property names to use, instead of the values defined in the column headers of the TopRow.
-
+        If you provide fewr header names than there is data in the worksheet, then only the data with a corresponding header name will be imported and the data without header name will be disregarded.
-        In case you provide less header names than there is data in the worksheet, then only the data with a corresponding header name will be imported and the data without header name will be disregarded.
+        If you provide more header names than there is data in the worksheet, then all data will be imported and all objects will have all the property names you defined in the header names. As such, the last properties will be blank as there is no data for them.
-
-        In case you provide more header names than there is data in the worksheet, then all data will be imported and all objects will have all the property names you defined in the header names. As such, the last properties will be blanc as there is no data for them.
-
       .PARAMETER NoHeader
         Automatically generate property names (P1, P2, P3, ..) instead of the ones defined in the column headers of the TopRow.
-
         This switch is best used when you want to import the complete worksheet ‘as is’ and are not concerned with the property names.
-
       .PARAMETER DataOnly
         Import only rows and columns that contain data, empty rows and empty columns are not imported.
-
-
       .PARAMETER ConvertEmptyStringsToNull
         If specified, cells without any data are replaced with NULL, instead of an empty string.
-
         This is to address behviors in certain DBMS where an empty string is insert as 0 for INT column, instead of a NULL value.
 
       .EXAMPLE
@@ -85,7 +68,6 @@ function ConvertFrom-ExcelToSQLInsert {
         INSERT INTO Movies ('Movie Name', 'Year', 'Rating') Values('Skyfall', '2012', '9');
         INSERT INTO Movies ('Movie Name', 'Year', 'Rating') Values('The Avengers', '2012', NULL);
 
-    .NOTES
     #>
     [CmdletBinding()]
     param(

Export-charts.ps1

@@ -2,7 +2,7 @@
     .Synopsis
         Exports the charts in an Excel spreadSheet 
     .Example
-        Export-Charts .\test,xlsx
+        Export-Charts .\test.xlsx
         Exports the charts in test.xlsx to JPEG files in the current directory.
 
     .Example
@@ -13,7 +13,7 @@
 Param (
     #Path to the Excel file whose chars we will export.  
     $Path          = "C:\Users\public\Documents\stats.xlsx", 
-    #If specified, output file objects representing the image files.  
+    #If specified, output file objects representing the image files  
     [switch]$Passthru, 
     #Format to write - JPG by default 
     [ValidateSet("JPG","PNG","GIF")]

Get-ExcelSheetInfo.ps1

@@ -2,13 +2,10 @@ Function Get-ExcelSheetInfo {
     <#
       .SYNOPSIS
         Get worksheet names and their indices of an Excel workbook.
-
       .DESCRIPTION
         The Get-ExcelSheetInfo cmdlet gets worksheet names and their indices of an Excel workbook.
-
       .PARAMETER Path
         Specifies the path to the Excel file. This parameter is required.
-
       .EXAMPLE
         Get-ExcelSheetInfo .\Test.xlsx
 
@@ -18,7 +15,6 @@ Function Get-ExcelSheetInfo {
 
       .LINK
         https://github.com/dfinke/ImportExcel
-
     #>
 
     [CmdletBinding()]

Get-ExcelWorkbookInfo.ps1

@@ -2,13 +2,10 @@
     <# 
       .SYNOPSIS 
         Retrieve information of an Excel workbook.
- 
       .DESCRIPTION 
         The Get-ExcelWorkbookInfo cmdlet retrieves information (LastModifiedBy, LastPrinted, Created, Modified, ...) fron an Excel workbook. These are the same details that are visible in Windows Explorer when right clicking the Excel file, selecting Properties and check the Details tabpage.
- 
       .PARAMETER Path
         Specifies the path to the Excel file. This parameter is required.
-             
       .EXAMPLE
         Get-ExcelWorkbookInfo .\Test.xlsx
 

Set-Column.ps1

@@ -11,21 +11,22 @@
         C:> Set-Column -Worksheet $ws -Heading "WinsToFastLaps"  -Value {"=E$row/C$row"} -Column 7 -AutoSize -AutoNameRange
         Here $WS already contains a worksheet which contains counts of races won and fastest laps recorded by racing drivers (in columns C and E)
         Set-Column specifies that Column 7 should have a heading of "WinsToFastLaps" and the data cells should contain =E2/C2 , =E3/C3
-        the data celss should become a named range, which will also be "WinsToFastLaps" the column width will be set automatically
+        the data cells should become a named range, which will also be "WinsToFastLaps" the column width will be set automatically
-
     #>
     [cmdletbinding()]
     Param (
         [Parameter(ParameterSetName="Package",Mandatory=$true)]
         [OfficeOpenXml.ExcelPackage]$ExcelPackage,
-        #Sheet to update
+        #The sheet to update can be a given as a name or an Excel Worksheet object - this sets it by name
         [Parameter(ParameterSetName="Package")]
+        #The sheet to update can be a given as a name or an Excel Worksheet object - $workSheet contains the object
         $Worksheetname = "Sheet1",
         [Parameter(ParameterSetName="sheet",Mandatory=$true)]
         [OfficeOpenXml.ExcelWorksheet]
         $Worksheet,
         #Column to fill down - first column is 1. 0 will be interpreted as first unused column
         $Column = 0 ,
+        #First row to fill data in 
         [Int]$StartRow ,
         #value, formula or script block for to fill in. Script block can use $row, $column [number], $ColumnName [letter(s)], $startRow, $startColumn, $endRow, $endColumn
         [parameter(Mandatory=$true)]
@@ -76,8 +77,9 @@
         [Switch]$AutoSize,
         #Set cells to a fixed width, ignored if Autosize is specified
         [float]$Width,
-        #Set the inserted data to be a named range (ignored if header is not specified) d
+        #Set the inserted data to be a named range (ignored if header is not specified)
         [Switch]$AutoNameRange,
+        #If Specified, return an ExcelPackage object to allow further work to be done on the file. 
         [switch]$PassThru
     )
     #if we were passed a package object and a worksheet name , get the worksheet.

Set-Row.ps1

@@ -15,8 +15,6 @@
             =Sum(xx2:xx99)  - where xx is the column name, and 99 is the last row of data.
             Note the use of `2 to Prevent 2 becoming part of the variable "ColumnName"
         The script block can use $row, $column, $ColumnName, $startRow/Column $endRow/Column
-
-
     #>
     [cmdletbinding()]
     Param (
@@ -75,11 +73,12 @@
         [OfficeOpenXml.Style.ExcelHorizontalAlignment]$HorizontalAlignment,
         #Position cell contents to top bottom or centre
         [OfficeOpenXml.Style.ExcelVerticalAlignment]$VerticalAlignment,
-        #Degrees to rotate text. Up to +90 for anti-clockwise ("upwards"), or to -90 for clockwise.
+        #Degrees to rotate text. Up to +90 for anti-clockwise ("upwards"), or to -90 for clockwise
         [ValidateRange(-90, 90)]
         [int]$TextRotation ,
         #Set cells to a fixed hieght
         [float]$Height,
+         #If Specified, return an ExcelPackage object to allow further work to be done on the file
         [switch]$PassThru
     )
 

Update-FirstObjectProperties.ps1

@@ -72,7 +72,8 @@ Function Update-FirstObjectProperties {
 
         .NOTES
             CHANGELOG
-            2017/06/08 Function born #>
+            2017/06/08 Function born
+    #>
 
     Try {
         $Union = @()