Skip to content

Commit da5add6

Browse files
committed
Update docs
Signed-off-by: Sora Morimoto <sora@morimoto.io>
1 parent d6b7a6c commit da5add6

File tree

6 files changed

+71
-156
lines changed

6 files changed

+71
-156
lines changed

CHANGELOG.md

+43-96
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,7 @@
22

33
All notable changes to this project will be documented in this file.
44

5-
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0),
6-
and this project adheres to
7-
[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
5+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
86

97
## [unreleased]
108

@@ -51,8 +49,7 @@ and this project adheres to
5149
### Fixed
5250

5351
- Add the repositories hash to the opam cache key for stronger reproducibility.
54-
- If the ocamlformat config does not exist, continue lint-fmt without
55-
installing it.
52+
- If the ocamlformat config does not exist, continue lint-fmt without installing it.
5653

5754
## [3.0.0]
5855

@@ -87,8 +84,7 @@ and this project adheres to
8784
### Changed
8885

8986
- Do not explicitly call the depext subcommand unless required.
90-
- Do not set `HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK` to `1` while installing
91-
OCaml.
87+
- Do not set `HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK` to `1` while installing OCaml.
9288
- Update runtime dependencies.
9389

9490
## [2.2.8]
@@ -125,8 +121,7 @@ and this project adheres to
125121

126122
### Changed
127123

128-
- Adopt native ESM for runtime environment for `ocaml/setup-ocaml/analysis`
129-
again.
124+
- Adopt native ESM for runtime environment for `ocaml/setup-ocaml/analysis` again.
130125

131126
## [2.2.2]
132127

@@ -146,13 +141,11 @@ and this project adheres to
146141
### Added
147142

148143
- Add opam support for the Dependency submission API.
149-
- Set `HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK` to `1` on the runner while
150-
installing OCaml.
144+
- Set `HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK` to `1` on the runner while installing OCaml.
151145

152146
### Removed
153147

154-
- Since decent official support is now available to deploy natively to GitHub
155-
Pages, `deploy-doc` has been deprecated and removed.
148+
- Since decent official support is now available to deploy natively to GitHub Pages, `deploy-doc` has been deprecated and removed.
156149

157150
## [2.1.8]
158151

@@ -318,8 +311,7 @@ and this project adheres to
318311

319312
### Fixed
320313

321-
- Make the retry handling around unix system package installation more
322-
stringent.
314+
- Make the retry handling around unix system package installation more stringent.
323315

324316
## [2.0.6]
325317

@@ -347,8 +339,7 @@ and this project adheres to
347339

348340
### Added
349341

350-
- Expose the `enable-jekyll` alias to the `enable_jekyll` input for deploy-doc
351-
action.
342+
- Expose the `enable-jekyll` alias to the `enable_jekyll` input for deploy-doc action.
352343

353344
### Fixed
354345

@@ -386,18 +377,14 @@ and this project adheres to
386377

387378
### Fixed
388379

389-
- Fallback to the version in which the assets exist if no assets exist in the
390-
latest opam release.
391-
- Instruct Cygwin setup to use "sys" symlinks during setup (partial workaround
392-
for bug with native symlinks in Cygwin setup - some depexts may still be
393-
affected)
380+
- Fallback to the version in which the assets exist if no assets exist in the latest opam release.
381+
- Instruct Cygwin setup to use "sys" symlinks during setup (partial workaround for bug with native symlinks in Cygwin setup - some depexts may still be affected)
394382

395383
## [2.0.0-beta11]
396384

397385
### Fixed
398386

399-
- Add support for more styles for the ocamlformat configuration in lint-fmt
400-
action.
387+
- Add support for more styles for the ocamlformat configuration in lint-fmt action.
401388

402389
## [2.0.0-beta10]
403390

@@ -407,8 +394,7 @@ and this project adheres to
407394

408395
### Changed
409396

410-
- Remove some hacks as `--no-depexts` is now used in CLI 2.0 mode from opam
411-
2.1.2.
397+
- Remove some hacks as `--no-depexts` is now used in CLI 2.0 mode from opam 2.1.2.
412398

413399
## [2.0.0-beta9]
414400

@@ -426,8 +412,7 @@ and this project adheres to
426412

427413
### Fixed
428414

429-
- Return an empty array to avoid depext failure when depext flags are not
430-
passed.
415+
- Return an empty array to avoid depext failure when depext flags are not passed.
431416

432417
## [2.0.0-beta6]
433418

@@ -443,17 +428,14 @@ and this project adheres to
443428

444429
### Fixed
445430

446-
- If no user-input version is found in the opam-repository, explicitly raise an
447-
error instead of implicitly breaking the workflow.
448-
- Retrieve the base compiler version from opam-repository to use the live
449-
released compiler version.
431+
- If no user-input version is found in the opam-repository, explicitly raise an error instead of implicitly breaking the workflow.
432+
- Retrieve the base compiler version from opam-repository to use the live released compiler version.
450433

451434
## [2.0.0-beta4]
452435

453436
### Changed
454437

455-
- Set `OPAMSOLVERTIMEOUT` to `1000` to avoid a timeout even if the opam solver
456-
is slow.
438+
- Set `OPAMSOLVERTIMEOUT` to `1000` to avoid a timeout even if the opam solver is slow.
457439
- Increase cache hit ratio by loosening restore keys of opam cache.
458440

459441
## [2.0.0-beta3]
@@ -465,8 +447,7 @@ and this project adheres to
465447
### Fixed
466448

467449
- Set repository priorities correctly for multiple repositories feature.
468-
- Lock the version of opam to be installed only to < 2.1 releases until opam 2.2
469-
is released.
450+
- Lock the version of opam to be installed only to < 2.1 releases until opam 2.2 is released.
470451

471452
## [2.0.0-beta2]
472453

@@ -486,73 +467,49 @@ and this project adheres to
486467

487468
### Removed
488469

489-
- The `opam-repository` input has been removed in order to add the
490-
`opam-repositories` input.
470+
- The `opam-repository` input has been removed in order to add the `opam-repositories` input.
491471

492472
## [2.0.0-alpha]
493473

494474
### Added
495475

496476
- Added support for 32 bits compiler variants.
497477
- Added semver-style version matching support.
498-
- Cache opam root (`~/.opam` on Unix, `D:\.opam` on Windows), opam
499-
download-cache (`~/.opam/download-cache` on Unix, `D:\.opam\download-cache` on
500-
Windows), and opam local switch (`_opam`).
501-
- If `dune-cache` enabled, install dune, automatically configure the dune cache
502-
for the most efficient use in CI (exports `DUNE_CACHE=enabled`,
503-
`DUNE_CACHE_TRANSPORT=direct`. TRANSPORT must be `direct`, not `daemon`, to
504-
speed up the opam install process and to support Windows:
505-
<https://github.com/ocaml/dune/issues/4166>,
506-
<https://github.com/ocaml/dune/issues/4167>), and share the dune cache
507-
directory for each run.
508-
- If `opam-pin` is enabled, pin the local packages specified by
509-
`opam-local-packages`.
510-
- If `opam-depext` is enabled, install the system dependencies specified by
511-
`opam-local-packages` via depext
512-
- If `opam-disable-sandboxing` is enabled, sandboxing is disabled for all
513-
platforms except Windows. (Sandboxing is always disabled on the Windows
514-
runners due to limitations of opam.)
515-
- The profiling functionality allows us to check the duration of each group if
516-
debug mode is enabled.
517-
(<https://docs.github.com/en/actions/managing-workflow-runs/enabling-debug-logging>)
518-
519-
### Changed
520-
521-
- The Windows runners install `mingw64-i686-gcc-core` and `mingw64-i686-gcc-g++`
522-
for 32 bit compiler variant support.
478+
- Cache opam root (`~/.opam` on Unix, `D:\.opam` on Windows), opam download-cache (`~/.opam/download-cache` on Unix, `D:\.opam\download-cache` on Windows), and opam local switch (`_opam`).
479+
- If `dune-cache` enabled, install dune, automatically configure the dune cache for the most efficient use in CI (exports `DUNE_CACHE=enabled`, `DUNE_CACHE_TRANSPORT=direct`. TRANSPORT must be `direct`, not `daemon`, to speed up the opam install process and to support Windows: <https://github.com/ocaml/dune/issues/4166>, <https://github.com/ocaml/dune/issues/4167>), and share the dune cache directory for each run.
480+
- If `opam-pin` is enabled, pin the local packages specified by `opam-local-packages`.
481+
- If `opam-depext` is enabled, install the system dependencies specified by `opam-local-packages` via depext
482+
- If `opam-disable-sandboxing` is enabled, sandboxing is disabled for all platforms except Windows. (Sandboxing is always disabled on the Windows runners due to limitations of opam.)
483+
- The profiling functionality allows us to check the duration of each group if debug mode is enabled. (<https://docs.github.com/en/actions/managing-workflow-runs/enabling-debug-logging>)
484+
485+
### Changed
486+
487+
- The Windows runners install `mingw64-i686-gcc-core` and `mingw64-i686-gcc-g++` for 32 bit compiler variant support.
523488
- Clean the log output by grouping some operations.
524-
- The compiler will be initialised in all platforms with an opam local switch to
525-
eliminate differences between platforms and prepare for full dependency
526-
caching in the future.
527-
- The macOS and Ubuntu runners install and cache opam from the GitHub release
528-
directly without the system package manager.
489+
- The compiler will be initialised in all platforms with an opam local switch to eliminate differences between platforms and prepare for full dependency caching in the future.
490+
- The macOS and Ubuntu runners install and cache opam from the GitHub release directly without the system package manager.
529491
- The macOS and Ubuntu runners install `darcs` and `mercurial`.
530492
- The Windows runners install `mercurial`.
531493
- Export `OPAMCOLOR=always`.
532494
- Export `OPAMERRLOGLEN=0`.
533495
- Export `OPAMPRECISETRACKING=1`.
534496
- Export `OPAMSOLVERTIMEOUT=500`.
535497
- Export `OPAMROOT=D:\.opam` on the Windows runners.
536-
- Export `OPAMVERBOSE=true` if the actions debug mode is enabled.
537-
(<https://docs.github.com/en/actions/managing-workflow-runs/enabling-debug-logging>)
498+
- Export `OPAMVERBOSE=true` if the actions debug mode is enabled. (<https://docs.github.com/en/actions/managing-workflow-runs/enabling-debug-logging>)
538499
- Export `MSYS=winsymlinks:native` for `@actions/cache` on the Windows runners.
539500
- Export `HOME=%USERPROFILE%` for opam on the Windows runners.
540501

541502
### Removed
542503

543504
- The `ocaml-version` input has been removed. Use the `ocaml-compiler` instead.
544-
- The simplified version specifying scheme (e.g. `4.12.0`) support has been
545-
removed.
505+
- The simplified version specifying scheme (e.g. `4.12.0`) support has been removed.
546506

547507
### Fixed
548508

549-
- Use the appropriate file system behavior parameters on the Windows runners.
550-
(`R2L:1`, `R2R:1`)
509+
- Use the appropriate file system behavior parameters on the Windows runners. (`R2L:1`, `R2R:1`)
551510
- Add `ppa: avsm/musl` on 18.04 and older Ubuntu runners.
552-
- Pass `--enable-shell-hook` to `opam init` fixes a bug that must be run via
553-
opam exec in subsequent steps.
554-
- The Ubuntu runners install `gcc-multilib`, `g++-multilib` for
555-
`ocaml-option-32bit`.
511+
- Pass `--enable-shell-hook` to `opam init` fixes a bug that must be run via opam exec in subsequent steps.
512+
- The Ubuntu runners install `gcc-multilib`, `g++-multilib` for `ocaml-option-32bit`.
556513

557514
## [1.1.11]
558515

@@ -564,8 +521,7 @@ and this project adheres to
564521

565522
### Changed
566523

567-
- Run `brew update` before set up to avoid an issue with Bintray transition
568-
period.
524+
- Run `brew update` before set up to avoid an issue with Bintray transition period.
569525

570526
## [1.1.9]
571527

@@ -577,11 +533,8 @@ and this project adheres to
577533

578534
### Changed
579535

580-
- The Windows opam wrapper is fractionally less-archaically named opam.cmd, with
581-
no loss in arcaneness.
582-
- Export `CYGWIN_ROOT` on the Windows runners, allowing bash to be invoked as
583-
`%CYGWIN_ROOT%\bin\bash`/`$env:CYGWIN_ROOT\bin\bash` (and similarly for Cygwin
584-
`setup-x86_64.exe`).
536+
- The Windows opam wrapper is fractionally less-archaically named opam.cmd, with no loss in arcaneness.
537+
- Export `CYGWIN_ROOT` on the Windows runners, allowing bash to be invoked as `%CYGWIN_ROOT%\bin\bash`/`$env:CYGWIN_ROOT\bin\bash` (and similarly for Cygwin `setup-x86_64.exe`).
585538
- The Windows runner no longer prepends `%CYGWIN_ROOT%\bin` to `PATH`.
586539

587540
### Fixed
@@ -592,8 +545,7 @@ and this project adheres to
592545

593546
### Changed
594547

595-
- Ubuntu and macOS runners no longer display "No switch is currently installed."
596-
before building the compiler.
548+
- Ubuntu and macOS runners no longer display "No switch is currently installed." before building the compiler.
597549
- Ubuntu no longer installs the system ocaml packages.
598550
- macOS no longer builds two compilers on every run.
599551
- Upgrade opam to 2.0.8 for Linux VMs.
@@ -614,15 +566,13 @@ Reduce build time by exporting modified `OPAMJOBS` environment variable.
614566

615567
### Changed
616568

617-
Windows installs `mingw64-x86_64-gcc-g++` so GitHub Action can build libraries
618-
that require it.
569+
Windows installs `mingw64-x86_64-gcc-g++` so GitHub Action can build libraries that require it.
619570

620571
## [1.1.3] - 2020-10-23 [YANKED]
621572

622573
### Security
623574

624-
- Update the `@actions/core` package to address
625-
[CVE-2020-15228](https://github.com/advisories/GHSA-mfwh-5m23-j46w).
575+
- Update the `@actions/core` package to address [CVE-2020-15228](https://github.com/advisories/GHSA-mfwh-5m23-j46w).
626576

627577
## [1.1.2] - 2020-09-10
628578

@@ -656,12 +606,9 @@ that require it.
656606

657607
- `node_modules` are not exported anymore which reduces the size of the action
658608

659-
- The repository is initialised directly from the opam-repository git source, so
660-
that there is no lag in packages being available for CI
609+
- The repository is initialised directly from the opam-repository git source, so that there is no lag in packages being available for CI
661610

662-
- Ubuntu installs `musl-tools` so that the GitHub Action can generate statically
663-
linked Linux binaries in conjunction with the
664-
`ocaml-variants.4.x.y+musl+flambda` switch
611+
- Ubuntu installs `musl-tools` so that the GitHub Action can generate statically linked Linux binaries in conjunction with the `ocaml-variants.4.x.y+musl+flambda` switch
665612

666613
## [1.0] - 2019-11-21
667614

CODE_OF_CONDUCT.md

+2-4
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,7 @@
11
# Code of Conduct
22

3-
This project has adopted the
4-
[OCaml Code of Conduct](https://github.com/ocaml/code-of-conduct/blob/main/CODE_OF_CONDUCT.md).
3+
This project has adopted the [OCaml Code of Conduct](https://github.com/ocaml/code-of-conduct/blob/main/CODE_OF_CONDUCT.md).
54

65
# Enforcement
76

8-
This project follows the OCaml Code of Conduct
9-
[enforcement policy](https://github.com/ocaml/code-of-conduct/blob/main/CODE_OF_CONDUCT.md#enforcement).
7+
This project follows the OCaml Code of Conduct [enforcement policy](https://github.com/ocaml/code-of-conduct/blob/main/CODE_OF_CONDUCT.md#enforcement).

EXAMPLES.md

+1-3
Original file line numberDiff line numberDiff line change
@@ -61,9 +61,7 @@ jobs:
6161
6262
## Using glob patterns to filter local packages
6363
64-
Consult the
65-
[`@actions/glob`](https://github.com/actions/toolkit/tree/main/packages/glob)
66-
package for supported patterns.
64+
Consult the [`@actions/glob`](https://github.com/actions/toolkit/tree/main/packages/glob) package for supported patterns.
6765

6866
```yml
6967
steps:

0 commit comments

Comments
 (0)