Checkin generated manpage (PowerShell#24423)

TravisEz13 · adityapatwardhan · commit 89a2d83be0f7 · 2024-10-30T23:15:10.000-07:00
* checkin generataed manpage

* move ronn file into new folder

* update build and release to use new asset

* add a minimal macos packaging test

* add correct dependency for the macos packaging stage

* fix packaging error

* remove removing files
diff --git a/.vsts-ci/mac.yml b/.vsts-ci/mac.yml
@@ -96,3 +96,20 @@ stages:
     parameters:
       pool: macOS-latest
 
+- stage: PackageMac
+  dependsOn: ['BuildMac']
+  displayName: Package macOS (bootstrap only)
+  jobs:
+    - job: macos_packaging
+      pool:
+        vmImage: macOS-latest
+
+      displayName: macOS packaging (bootstrap only)
+      steps:
+        - checkout: self
+          clean: true
+        - pwsh: |
+            import-module ./build.psm1
+            start-psbootstrap -package
+          displayName: Bootstrap packaging
+          condition: succeededOrFailed()
diff --git a/assets/manpage/pwsh.1 b/assets/manpage/pwsh.1
@@ -0,0 +1,10 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "PWSH" "1" "October 2023" "" ""
+.
+.SH "NAME"
+\fBpwsh\fR \- PowerShell command\-line shell and \.NET REPL
+.
+.SH "SYNOPSIS"
+\fBpwsh\fR [\fB\-Login\fR] [ [\fB\-File\fR] \fIfilePath\fR [args] ] [\fB\-Command\fR { \- | \fIscript\-block\fR [\fB\-args\fR \fIarg\-array\fR] | \fIstring\fR [\fICommandParameters\fR] } ] [\fB\-ConfigurationFile\fR \fIfilePath\fR] [\fB\-ConfigurationName\fR \fIstring\fR] [\fB\-CustomPipeName\fR \fIstring\fR] [\fB\-EncodedArguments\fR \fIBase64EncodedArguments\fR] [\fB\-EncodedCommand\fR \fIBase64EncodedCommand\fR] [\fB\-ExecutionPolicy\fR \fIExecutionPolicy\fR] [\fB\-Help\fR] [\fB\-InputFormat\fR {Text | XML}] [\fB\-Interactive\fR] [\fB\-MTA\fR] [\fB\-NoExit\fR] [\fB\-NoLogo\fR] [\fB\-NonInteractive\fR] [\fB\-NoProfile\fR] [\fB\-NoProfileLoadTime\fR] [\fB\-OutputFormat\fR {Text | XML}] [\fB\-SettingsFile\fR \fIfilePath\fR] [\fB\-SSHServerMode\fR] [\fB\-STA\fR] [\fB\-Version\fR] [\fB\-WindowStyle\fR
diff --git a/assets/manpage/pwsh.1.ronn b/assets/manpage/pwsh.1.ronn
diff --git a/build.psm1 b/build.psm1
@@ -2333,12 +2333,11 @@ function Start-PSBootstrap {
                 }
             }
 
-            # Install [fpm](https://github.com/jordansissel/fpm) and [ronn](https://github.com/rtomayko/ronn)
+            # Install [fpm](https://github.com/jordansissel/fpm)
             if ($Package) {
                 Install-GlobalGem -Sudo $sudo -GemName "dotenv" -GemVersion "2.8.1"
                 Install-GlobalGem -Sudo $sudo -GemName "ffi" -GemVersion "1.16.3"
                 Install-GlobalGem -Sudo $sudo -GemName "fpm" -GemVersion "1.15.1"
-                Install-GlobalGem -Sudo $sudo -GemName "ronn" -GemVersion "0.7.3"
                 Install-GlobalGem -Sudo $sudo -GemName "rexml" -GemVersion "3.2.5"
             }
         }
diff --git a/tools/packaging/packaging.psm1 b/tools/packaging/packaging.psm1
@@ -1636,7 +1636,7 @@ function Get-PackageDependencies
 
 function Test-Dependencies
 {
-    foreach ($Dependency in "fpm", "ronn") {
+    foreach ($Dependency in "fpm") {
         if (!(precheck $Dependency "Package dependency '$Dependency' not found. Run Start-PSBootstrap -Package")) {
             # These tools are not added to the path automatically on OpenSUSE 13.2
             # try adding them to the path and re-tesing first
@@ -1714,26 +1714,15 @@ function New-ManGzip
     )
 
     Write-Log "Creating man gz..."
-    # run ronn to convert man page to roff
-    $RonnFile = "$RepoRoot/assets/pwsh.1.ronn"
 
-    if ($IsPreview.IsPresent -or $IsLTS.IsPresent)
-    {
-        $prodName = if ($IsLTS) { 'pwsh-lts' } else { 'pwsh-preview' }
-        $newRonnFile = $RonnFile -replace 'pwsh', $prodName
-        Copy-Item -Path $RonnFile -Destination $newRonnFile -Force
-        $RonnFile = $newRonnFile
-    }
-
-    $RoffFile = $RonnFile -replace "\.ronn$"
+    # run roff to convert man page to roff
+    $RoffFile = "$RepoRoot/assets/manpage/pwsh.1"
 
-    # Run ronn on assets file
-    Write-Log "Creating man gz - running ronn..."
-    Start-NativeExecution { ronn --roff $RonnFile }
-
-    if ($IsPreview.IsPresent)
-    {
-        Remove-Item $RonnFile
+    if ($IsPreview.IsPresent -or $IsLTS.IsPresent) {
+        $prodName = if ($IsLTS) { 'pwsh-lts' } else { 'pwsh-preview' }
+        $newRoffFile = $RoffFile -replace 'pwsh', $prodName
+        Copy-Item -Path $RoffFile -Destination $newRoffFile -Force -Verbose
+        $RoffFile = $newRoffFile
     }
 
     # gzip in assets directory

Original file line number	Diff line number	Diff line change
`@@ -2333,12 +2333,11 @@ function Start-PSBootstrap {`
`2333`	`2333`	`}`
`2334`	`2334`	`}`
`2335`	`2335`
`2336`		`- # Install [fpm](https://github.com/jordansissel/fpm) and [ronn](https://github.com/rtomayko/ronn)`
	`2336`	`+ # Install [fpm](https://github.com/jordansissel/fpm)`
`2337`	`2337`	`if ($Package) {`
`2338`	`2338`	`Install-GlobalGem -Sudo $sudo -GemName "dotenv" -GemVersion "2.8.1"`
`2339`	`2339`	`Install-GlobalGem -Sudo $sudo -GemName "ffi" -GemVersion "1.16.3"`
`2340`	`2340`	`Install-GlobalGem -Sudo $sudo -GemName "fpm" -GemVersion "1.15.1"`
`2341`		`- Install-GlobalGem -Sudo $sudo -GemName "ronn" -GemVersion "0.7.3"`
`2342`	`2341`	`Install-GlobalGem -Sudo $sudo -GemName "rexml" -GemVersion "3.2.5"`
`2343`	`2342`	`}`
`2344`	`2343`	`}`