update for the expected next version 4.20

Author: smdn

doc/workflows/instructions-generate-artifacts.md

@@ -18,15 +18,15 @@ git push github main
 When actually executing, replace the remote name with `origin` and so on as appropriate.
 
 ## Notes for the version used in this document
-The instructions in this document generates artifacts for Highlight version **4.19**, and references **4.18** as the previous version.
+The instructions in this document generates artifacts for Highlight version **4.20**, and references **4.19** as the previous version.
 
 Replace the version number with the desired version.
 
 # Instruction steps for generating artifacts targeting specific versions of Highlight
 
 ## Create a working branch for generating artifacts
 ```
-git switch -c artifact-highlight-4.19
+git switch -c artifact-highlight-4.20
 ```
 
 From then on, work on this branch.
@@ -35,9 +35,9 @@ From then on, work on this branch.
 Change the value of `Highlight_SourceVersionMajorMinor` property in the file [src/Highlight.Build.props](../../src/Highlight.Build.props).
 
 ```
-sed -i -e 's/Highlight_SourceVersionMajorMinor>4\.18/Highlight_SourceVersionMajorMinor>4\.19/g' src/Highlight.Build.props
+sed -i -e 's/Highlight_SourceVersionMajorMinor>4\.19/Highlight_SourceVersionMajorMinor>4\.20/g' src/Highlight.Build.props
 
-git commit -m "bump build target version up to highlight-4.18" -- src/Highlight.Build.props
+git commit -m "bump build target version up to highlight-4.20" -- src/Highlight.Build.props
 ```
 
 Commit this change as it will be used in subsequent GitHub workflows.
@@ -54,20 +54,20 @@ Check for differences in generated source files of the bindings.
 
 ```
 cd src/Smdn.LibHighlightSharp.Bindings/Smdn.LibHighlightSharp.Bindings/
-diff highlight-4.18/ highlight-4.19/
+diff highlight-4.19/ highlight-4.20/
 cd -
 ```
 
 Then, commit the generated source files.
 
 ```
-git add src/Smdn.LibHighlightSharp.Bindings/Smdn.LibHighlightSharp.Bindings/highlight-4.19/
-git commit -m "add bindings for highlight-4.19" -- src/Smdn.LibHighlightSharp.Bindings/Smdn.LibHighlightSharp.Bindings/highlight-4.19/
+git add src/Smdn.LibHighlightSharp.Bindings/Smdn.LibHighlightSharp.Bindings/highlight-4.20/
+git commit -m "add bindings for highlight-4.20" -- src/Smdn.LibHighlightSharp.Bindings/Smdn.LibHighlightSharp.Bindings/highlight-4.20/
 ```
 
 ### Push the working branch
 ```
-git push github artifact-highlight-4.19
+git push github artifact-highlight-4.20
 ```
 
 ### Generate native binaries
@@ -85,13 +85,13 @@ These PRs merge the created artifacts into a working branch. Changes to `SHA1SUM
 Fetch the changes up to this point.
 
 ```
-git pull github artifact-highlight-4.19
+git pull github artifact-highlight-4.20
 ```
 
 Create a PR to merge the changes up to this point into the `main` branch.
 
 ```
-gh pr create --base main --head artifact-highlight-4.19 --assignee @me --title "Add artifact highlight-4.19" --fill
+gh pr create --base main --head artifact-highlight-4.20 --assignee @me --title "Add artifact highlight-4.20" --fill
 ```
 
 Then, merge a PR created by this command, after testing and other checks have been completed.
@@ -101,15 +101,15 @@ Then, merge a PR created by this command, after testing and other checks have be
 git fetch github --prune
 git switch main
 git pull github main
-git branch -d artifact-highlight-4.19
+git branch -d artifact-highlight-4.20
 ```
 
 ## Prepare for packaging and release
 
 ### Run tests with newly generated artifacts
 ```
-dotnet test tests/Smdn.LibHighlightSharp.Bindings/
-dotnet test tests/Smdn.LibHighlightSharp/
+dotnet test --project tests/Smdn.LibHighlightSharp.Bindings/Smdn.LibHighlightSharp.Bindings.Tests.csproj
+dotnet test --project tests/Smdn.LibHighlightSharp/Smdn.LibHighlightSharp.Tests.csproj
 ```
 
 ### Update `CompatibilitySuppressions.xml`
@@ -123,7 +123,7 @@ git diff src/Smdn.LibHighlightSharp.Bindings/CompatibilitySuppressions.xml
 Commit if there are any changes.
 
 ```
-git commit -m "add CompatibilitySuppressions entries for highlight >=4.19" -- src/Smdn.LibHighlightSharp.Bindings/CompatibilitySuppressions.xml
+git commit -m "add CompatibilitySuppressions entries for highlight >=4.20" -- src/Smdn.LibHighlightSharp.Bindings/CompatibilitySuppressions.xml
 ```
 
 ### Push changes made up to this point
@@ -140,19 +140,19 @@ If necessary, also run a test workflow.
 Set the tag and trigger the release workflow. When trigger the workflow, ensure that the Actions secrets are properly updated and not expired.
 
 ```
-git tag -m "new release" new-release/main/Smdn.LibHighlightSharp.LangDefs-4.19.0
-git tag -m "new release" new-release/main/Smdn.LibHighlightSharp.Themes-4.19.0
-git tag -m "new release" new-release/main/Smdn.LibHighlightSharp.Bindings-4.19.0
+git tag -m "new release" new-release/main/Smdn.LibHighlightSharp.LangDefs-4.20.0
+git tag -m "new release" new-release/main/Smdn.LibHighlightSharp.Themes-4.20.0
+git tag -m "new release" new-release/main/Smdn.LibHighlightSharp.Bindings-4.20.0
 
 git push github \
-  new-release/main/Smdn.LibHighlightSharp.LangDefs-4.19.0 \
-  new-release/main/Smdn.LibHighlightSharp.Themes-4.19.0 \
-  new-release/main/Smdn.LibHighlightSharp.Bindings-4.19.0
+  new-release/main/Smdn.LibHighlightSharp.LangDefs-4.20.0 \
+  new-release/main/Smdn.LibHighlightSharp.Themes-4.20.0 \
+  new-release/main/Smdn.LibHighlightSharp.Bindings-4.20.0
 
 git tag -d \
-  new-release/main/Smdn.LibHighlightSharp.LangDefs-4.19.0 \
-  new-release/main/Smdn.LibHighlightSharp.Themes-4.19.0 \
-  new-release/main/Smdn.LibHighlightSharp.Bindings-4.19.0
+  new-release/main/Smdn.LibHighlightSharp.LangDefs-4.20.0 \
+  new-release/main/Smdn.LibHighlightSharp.Themes-4.20.0 \
+  new-release/main/Smdn.LibHighlightSharp.Bindings-4.20.0
 ```
 
 ### Pull changes in the release