From a0df7b9a04fb86fb60adcaf2ae9fae748e8f2524 Mon Sep 17 00:00:00 2001 From: Grace Choi Date: Fri, 26 Apr 2024 13:16:51 -0500 Subject: [PATCH] Removed all mentions of "please" from docs and messages #770 Signed-off-by: Grace Choi Signed-off-by: Pranjal Rai --- .github/ISSUE_TEMPLATE/bug_report.yml | 4 ++-- .github/ISSUE_TEMPLATE/config.yml | 2 +- .github/PULL_REQUEST_TEMPLATE.md | 4 ++-- .github/workflows/validate-pr.yml | 2 +- .gitignore | 2 +- CONTRIBUTING.md | 14 +++++++------- NOTICE | 2 +- README.md | 4 ++-- cli/cobra.go | 2 +- cli/command/cli.go | 2 +- cli/command/context/export.go | 2 +- cli/command/image/trust.go | 2 +- cli/command/registry.go | 2 +- cli/command/stack/config_test.go | 2 +- cli/command/stack/loader/loader.go | 2 +- .../swarm/testdata/init-init-autolock.golden | 2 +- .../testdata/unlockkeys-unlock-key-rotate.golden | 2 +- .../swarm/testdata/unlockkeys-unlock-key.golden | 2 +- .../testdata/update-autolock-unlock-key.golden | 2 +- cli/command/swarm/unlock.go | 2 +- cli/command/swarm/unlock_key.go | 2 +- cli/command/trust/revoke.go | 2 +- cli/command/trust/revoke_test.go | 8 ++++---- cli/command/trust/signer_add.go | 2 +- cli/command/trust/signer_add_test.go | 2 +- .../trust-revoke-prompt-termination.golden | 2 +- cli/connhelper/commandconn/commandconn.go | 2 +- contrib/completion/bash/docker | 2 +- dockerfiles/Dockerfile.authors | 2 +- docs/deprecated.md | 5 +++-- docs/extend/EBS_volume.md | 2 +- docs/reference/commandline/container_cp.md | 2 +- docs/reference/commandline/swarm_unlock-key.md | 4 ++-- docs/reference/commandline/swarm_unlock.md | 2 +- docs/reference/commandline/trust_revoke.md | 2 +- e2e/cli-plugins/flags_test.go | 2 +- e2e/cli-plugins/run_test.go | 2 +- experimental/README.md | 2 +- man/docker.1.md | 2 +- man/dockerd.8.md | 4 ++-- man/src/system/events.md | 2 +- scripts/vendor | 2 +- vendor/dario.cat/mergo/CONTRIBUTING.md | 8 ++++---- vendor/dario.cat/mergo/README.md | 6 +++--- vendor/dario.cat/mergo/SECURITY.md | 2 +- vendor/dario.cat/mergo/doc.go | 4 ++-- vendor/github.com/Microsoft/go-winio/README.md | 4 ++-- vendor/github.com/Microsoft/go-winio/SECURITY.md | 14 +++++++------- vendor/github.com/cenkalti/backoff/v4/README.md | 4 ++-- vendor/github.com/containerd/containerd/NOTICE | 2 +- .../distribution/reference/CODE-OF-CONDUCT.md | 2 +- .../distribution/reference/CONTRIBUTING.md | 10 +++++----- .../distribution/reference/GOVERNANCE.md | 4 ++-- .../github.com/distribution/reference/README.md | 6 +++--- .../distribution/reference/SECURITY.md | 4 ++-- .../github.com/docker/distribution/BUILDING.md | 6 +++--- .../docker/distribution/CONTRIBUTING.md | 14 +++++++------- .../github.com/docker/distribution/MAINTAINERS | 2 +- vendor/github.com/docker/distribution/README.md | 6 +++--- vendor/github.com/docker/distribution/ROADMAP.md | 12 ++++++------ vendor/github.com/docker/distribution/blobs.go | 2 +- .../github.com/docker/distribution/uuid/uuid.go | 2 +- vendor/github.com/docker/docker/NOTICE | 2 +- .../docker/api/types/swarm/runtime/plugin.pb.go | 2 +- .../docker/docker/registry/search_endpoint_v1.go | 2 +- vendor/github.com/docker/go-metrics/NOTICE | 2 +- vendor/github.com/docker/go-metrics/README.md | 2 +- vendor/github.com/go-logr/logr/README.md | 2 +- vendor/github.com/go-logr/logr/SECURITY.md | 4 ++-- vendor/github.com/gogo/protobuf/AUTHORS | 2 +- .../gogo/protobuf/gogoproto/gogo.pb.go | 2 +- .../gogo/protobuf/proto/extensions_gogo.go | 2 +- .../protoc-gen-gogo/descriptor/descriptor.pb.go | 2 +- vendor/github.com/gogo/protobuf/types/any.pb.go | 2 +- vendor/github.com/gogo/protobuf/types/api.pb.go | 2 +- .../gogo/protobuf/types/duration.pb.go | 2 +- .../github.com/gogo/protobuf/types/empty.pb.go | 2 +- .../gogo/protobuf/types/field_mask.pb.go | 2 +- .../gogo/protobuf/types/source_context.pb.go | 2 +- .../github.com/gogo/protobuf/types/struct.pb.go | 2 +- .../gogo/protobuf/types/timestamp.pb.go | 2 +- vendor/github.com/gogo/protobuf/types/type.pb.go | 2 +- .../gogo/protobuf/types/wrappers.pb.go | 2 +- vendor/github.com/klauspost/compress/README.md | 4 ++-- vendor/github.com/klauspost/compress/SECURITY.md | 4 ++-- .../klauspost/compress/huff0/compress.go | 2 +- .../klauspost/compress/zstd/fse_decoder_amd64.go | 4 ++-- .../klauspost/compress/zstd/seqdec_amd64.go | 14 +++++++------- vendor/github.com/miekg/pkcs11/README.md | 3 +-- vendor/github.com/moby/patternmatcher/NOTICE | 2 +- vendor/github.com/moby/swarmkit/v2/api/ca.pb.go | 6 +++--- .../moby/swarmkit/v2/api/control.pb.go | 4 ++-- .../moby/swarmkit/v2/api/dispatcher.pb.go | 4 ++-- .../github.com/moby/swarmkit/v2/api/health.pb.go | 4 ++-- .../moby/swarmkit/v2/api/logbroker.pb.go | 6 +++--- .../moby/swarmkit/v2/api/objects.pb.go | 2 +- .../github.com/moby/swarmkit/v2/api/raft.pb.go | 6 +++--- .../moby/swarmkit/v2/api/resource.pb.go | 4 ++-- .../moby/swarmkit/v2/api/snapshot.pb.go | 2 +- .../github.com/moby/swarmkit/v2/api/specs.pb.go | 2 +- .../github.com/moby/swarmkit/v2/api/types.pb.go | 2 +- .../github.com/moby/swarmkit/v2/api/watch.pb.go | 4 ++-- .../swarmkit/v2/protobuf/plugin/plugin.pb.go | 2 +- vendor/github.com/moby/sys/symlink/README.md | 2 +- .../opencontainers/go-digest/README.md | 6 +++--- .../opencontainers/go-digest/digest.go | 4 ++-- vendor/github.com/pkg/errors/README.md | 2 +- .../github.com/prometheus/procfs/CONTRIBUTING.md | 6 +++--- .../github.com/prometheus/procfs/Makefile.common | 2 +- vendor/github.com/sirupsen/logrus/README.md | 6 +++--- vendor/github.com/spf13/cobra/CONTRIBUTING.md | 10 +++++----- vendor/github.com/spf13/cobra/README.md | 4 ++-- vendor/github.com/spf13/cobra/command.go | 4 ++-- vendor/github.com/spf13/pflag/README.md | 8 ++++---- .../theupdateframework/notary/CHANGELOG.md | 2 +- .../theupdateframework/notary/CONTRIBUTING.md | 16 ++++++++-------- .../notary/passphrase/passphrase.go | 12 ++++++------ .../notary/storage/filestore.go | 6 +++--- .../notary/storage/httpstore.go | 2 +- .../notary/trustmanager/yubikey/yubikeystore.go | 2 +- vendor/go.etcd.io/etcd/raft/v3/raftpb/raft.pb.go | 2 +- .../instrumentation/net/http/otelhttp/client.go | 2 +- vendor/go.opentelemetry.io/otel/CHANGELOG.md | 2 +- vendor/go.opentelemetry.io/otel/CONTRIBUTING.md | 4 ++-- .../otel/sdk/instrumentation/library.go | 2 +- .../otel/sdk/resource/config.go | 2 +- .../go.opentelemetry.io/otel/sdk/trace/span.go | 2 +- .../metrics/v1/metrics_service_grpc.pb.go | 2 +- .../collector/trace/v1/trace_service_grpc.pb.go | 2 +- vendor/golang.org/x/sys/unix/README.md | 2 +- vendor/golang.org/x/term/CONTRIBUTING.md | 2 +- .../golang.org/x/tools/go/packages/packages.go | 12 ++++++------ .../x/tools/internal/gcimporter/iimport.go | 2 +- .../x/tools/internal/gcimporter/ureader_yes.go | 2 +- vendor/google.golang.org/grpc/CONTRIBUTING.md | 6 +++--- vendor/google.golang.org/grpc/MAINTAINERS.md | 2 +- vendor/google.golang.org/grpc/README.md | 2 +- vendor/google.golang.org/grpc/SECURITY.md | 2 +- .../google.golang.org/grpc/balancer/balancer.go | 2 +- vendor/google.golang.org/grpc/codegen.sh | 2 +- .../grpc/credentials/credentials.go | 2 +- vendor/google.golang.org/grpc/dialoptions.go | 8 ++++---- .../grpc/health/grpc_health_v1/health_grpc.pb.go | 2 +- .../google.golang.org/grpc/metadata/metadata.go | 4 ++-- vendor/google.golang.org/grpc/rpc_util.go | 2 +- vendor/google.golang.org/grpc/tap/tap.go | 2 +- vendor/google.golang.org/grpc/vet.sh | 10 +++++----- vendor/gopkg.in/yaml.v2/README.md | 2 +- 148 files changed, 268 insertions(+), 268 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index ffdf4f02dff8..bf01c302f299 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -8,12 +8,12 @@ body: attributes: value: | Thank you for taking the time to report a bug! - If this is a security issue please report it to the [Docker Security team](mailto:security@docker.com). + If this is a security issue report it to the [Docker Security team](mailto:security@docker.com). - type: textarea id: description attributes: label: Description - description: Please give a clear and concise description of the bug + description: Give a clear and concise description of the bug validations: required: true - type: textarea diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index e61d265d7c74..06d63277deb9 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -4,7 +4,7 @@ contact_links: about: "Read guidelines and tips about contributing to Docker." url: "https://github.com/docker/cli/blob/master/CONTRIBUTING.md" - name: "Security and Vulnerabilities" - about: "Please report any security issues or vulnerabilities responsibly to the Docker security team. Please do not use the public issue tracker." + about: "Report any security issues or vulnerabilities responsibly to the Docker security team. Do not use the public issue tracker." url: "https://github.com/moby/moby/security/policy" - name: "General Support" about: "Get the help you need to build, share, and run your Docker applications" diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 51141a5b00be..d27de6e4b24a 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -1,5 +1,5 @@ **- What I did** diff --git a/.github/workflows/validate-pr.yml b/.github/workflows/validate-pr.yml index b39317005c1b..12ab7c076ddd 100644 --- a/.github/workflows/validate-pr.yml +++ b/.github/workflows/validate-pr.yml @@ -32,7 +32,7 @@ jobs: desc=$(echo "$block" | awk NF) if [ -z "$desc" ]; then - echo "::error::Changelog section is empty. Please provide a description for the changelog." + echo "::error::Changelog section is empty. Provide a description for the changelog." exit 1 fi diff --git a/.gitignore b/.gitignore index a7462428a4e9..c9ca65fef03f 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,5 @@ # if you want to ignore files created by your editor/tools, -# please consider a global .gitignore https://help.github.com/articles/ignoring-files +# consider a global .gitignore https://help.github.com/articles/ignoring-files *.exe *.exe~ *.orig diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 91d2dde47a3f..40f155c7e540 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -16,9 +16,9 @@ start participating. ## Reporting security issues The Docker maintainers take security seriously. If you discover a security -issue, please bring it to their attention right away! +issue, bring it to their attention right away! -Please **DO NOT** file a public issue, instead send your report privately to +**DO NOT** file a public issue, instead send your report privately to [security@docker.com](mailto:security@docker.com). Security reports are greatly appreciated and we will publicly thank you for it. @@ -39,7 +39,7 @@ If you find a match, you can use the "subscribe" button to get notified on updates. Do *not* leave random "+1" or "I have this too" comments, as they only clutter the discussion, and don't help resolving it. However, if you have ways to reproduce the issue or have additional information that may help -resolving the issue, please leave a comment. +resolving the issue, leave a comment. When reporting issues, always include: @@ -166,10 +166,10 @@ Include an issue reference like `Closes #XXXX` or `Fixes #XXXX` in the pull requ description that close an issue. Including references automatically closes the issue on a merge. -Please do not add yourself to the `AUTHORS` file, as it is regenerated regularly +Do not add yourself to the `AUTHORS` file, as it is regenerated regularly from the Git history. -Please see the [Coding Style](#coding-style) for further guidelines. +See the [Coding Style](#coding-style) for further guidelines. ### Merge approval @@ -269,8 +269,8 @@ guidelines for the community as a whole: * Stay on topic: Make sure that you are posting to the correct channel and avoid off-topic discussions. Remember when you update an issue or respond - to an email you are potentially sending to a large number of people. Please - consider this before you update. Also remember that nobody likes spam. + to an email you are potentially sending to a large number of people. Consider + this before you update. Also remember that nobody likes spam. * Don't send email to the maintainers: There's no need to send email to the maintainers to ask them to investigate an issue or to take a look at a diff --git a/NOTICE b/NOTICE index 58b19b6d15b9..1c40faaec612 100644 --- a/NOTICE +++ b/NOTICE @@ -14,6 +14,6 @@ United States and other governments. It is your responsibility to ensure that your use and/or transfer does not violate applicable laws. -For more information, please see https://www.bis.doc.gov +For more information, see https://www.bis.doc.gov See also https://www.apache.org/dev/crypto.html and/or seek legal counsel. diff --git a/README.md b/README.md index 232117eb4f79..2e8915f9f47d 100644 --- a/README.md +++ b/README.md @@ -67,7 +67,7 @@ make -f docker.Makefile shell ## Legal *Brought to you courtesy of our legal counsel. For more context, -please see the [NOTICE](https://github.com/docker/cli/blob/master/NOTICE) document in this repo.* +see the [NOTICE](https://github.com/docker/cli/blob/master/NOTICE) document in this repo.* Use and transfer of Docker may be subject to certain restrictions by the United States and other governments. @@ -75,7 +75,7 @@ United States and other governments. It is your responsibility to ensure that your use and/or transfer does not violate applicable laws. -For more information, please see https://www.bis.doc.gov +For more information, see https://www.bis.doc.gov ## Licensing diff --git a/cli/cobra.go b/cli/cobra.go index d07a3b218a22..256a1220e52d 100644 --- a/cli/cobra.go +++ b/cli/cobra.go @@ -54,7 +54,7 @@ func setupCommonRootCommand(rootCmd *cobra.Command) (*cliflags.ClientOptions, *c rootCmd.SetHelpCommand(helpCommand) rootCmd.PersistentFlags().BoolP("help", "h", false, "Print usage") - rootCmd.PersistentFlags().MarkShorthandDeprecated("help", "please use --help") + rootCmd.PersistentFlags().MarkShorthandDeprecated("help", "Use --help") rootCmd.PersistentFlags().Lookup("help").Hidden = true rootCmd.Annotations = map[string]string{ diff --git a/cli/command/cli.go b/cli/command/cli.go index a8b4c88bcad1..777ebbd82a2f 100644 --- a/cli/command/cli.go +++ b/cli/command/cli.go @@ -541,7 +541,7 @@ func getServerHost(hosts []string, tlsOptions *tlsconfig.Options) (string, error case 1: host = hosts[0] default: - return "", errors.New("Please specify only one -H") + return "", errors.New("Specify only one -H") } return dopts.ParseHost(tlsOptions != nil, host) diff --git a/cli/command/context/export.go b/cli/command/context/export.go index 8bccbf0d544b..4594028f9711 100644 --- a/cli/command/context/export.go +++ b/cli/command/context/export.go @@ -42,7 +42,7 @@ func writeTo(dockerCli command.Cli, reader io.Reader, dest string) error { var printDest bool if dest == "-" { if dockerCli.Out().IsTerminal() { - return errors.New("cowardly refusing to export to a terminal, please specify a file path") + return errors.New("cowardly refusing to export to a terminal, specify a file path") } writer = dockerCli.Out() } else { diff --git a/cli/command/image/trust.go b/cli/command/image/trust.go index 59601a254462..6bb21fa556a7 100644 --- a/cli/command/image/trust.go +++ b/cli/command/image/trust.go @@ -100,7 +100,7 @@ func PushTrustedReference(ioStreams command.Streams, repoInfo *registry.Reposito } if target == nil { - return errors.Errorf("no targets found, please provide a specific tag in order to sign it") + return errors.Errorf("no targets found, provide a specific tag in order to sign it") } fmt.Fprintln(ioStreams.Out(), "Signing and pushing trust metadata") diff --git a/cli/command/registry.go b/cli/command/registry.go index a1a499eee46a..3725e10946ba 100644 --- a/cli/command/registry.go +++ b/cli/command/registry.go @@ -28,7 +28,7 @@ const patSuggest = "You can log in with your password or a Personal Access " + // for the given command. func RegistryAuthenticationPrivilegedFunc(cli Cli, index *registrytypes.IndexInfo, cmdName string) types.RequestPrivilegeFunc { return func() (string, error) { - fmt.Fprintf(cli.Out(), "\nPlease login prior to %s:\n", cmdName) + fmt.Fprintf(cli.Out(), "\nLogin prior to %s:\n", cmdName) indexServer := registry.GetAuthConfigKey(index) isDefaultRegistry := indexServer == registry.IndexServer authConfig, err := GetDefaultAuthConfig(cli.ConfigFile(), true, indexServer, isDefaultRegistry) diff --git a/cli/command/stack/config_test.go b/cli/command/stack/config_test.go index b4f50160fd22..4a3f88e46afc 100644 --- a/cli/command/stack/config_test.go +++ b/cli/command/stack/config_test.go @@ -14,7 +14,7 @@ func TestConfigWithEmptyComposeFile(t *testing.T) { cmd := newConfigCommand(test.NewFakeCli(&fakeClient{})) cmd.SetOut(io.Discard) - assert.ErrorContains(t, cmd.Execute(), `Please specify a Compose file`) + assert.ErrorContains(t, cmd.Execute(), `Specify a Compose file`) } func TestConfigMergeInterpolation(t *testing.T) { diff --git a/cli/command/stack/loader/loader.go b/cli/command/stack/loader/loader.go index 782275451dcf..6929b3d34ee8 100644 --- a/cli/command/stack/loader/loader.go +++ b/cli/command/stack/loader/loader.go @@ -76,7 +76,7 @@ func GetConfigDetails(composefiles []string, stdin io.Reader) (composetypes.Conf var details composetypes.ConfigDetails if len(composefiles) == 0 { - return details, errors.New("Please specify a Compose file (with --compose-file)") + return details, errors.New("Specify a Compose file (with --compose-file)") } if composefiles[0] == "-" && len(composefiles) == 1 { diff --git a/cli/command/swarm/testdata/init-init-autolock.golden b/cli/command/swarm/testdata/init-init-autolock.golden index cdd3c666b6ec..7a47a5f2ba7d 100644 --- a/cli/command/swarm/testdata/init-init-autolock.golden +++ b/cli/command/swarm/testdata/init-init-autolock.golden @@ -7,5 +7,5 @@ command and provide the following key: unlock-key -Please remember to store this key in a password manager, since without it you +Remember to store this key in a password manager, since without it you will not be able to restart the manager. diff --git a/cli/command/swarm/testdata/unlockkeys-unlock-key-rotate.golden b/cli/command/swarm/testdata/unlockkeys-unlock-key-rotate.golden index 89152b8643a0..96190e99b53d 100644 --- a/cli/command/swarm/testdata/unlockkeys-unlock-key-rotate.golden +++ b/cli/command/swarm/testdata/unlockkeys-unlock-key-rotate.golden @@ -5,5 +5,5 @@ command and provide the following key: unlock-key -Please remember to store this key in a password manager, since without it you +Remember to store this key in a password manager, since without it you will not be able to restart the manager. diff --git a/cli/command/swarm/testdata/unlockkeys-unlock-key.golden b/cli/command/swarm/testdata/unlockkeys-unlock-key.golden index 8316df478c55..eaa6ca09230f 100644 --- a/cli/command/swarm/testdata/unlockkeys-unlock-key.golden +++ b/cli/command/swarm/testdata/unlockkeys-unlock-key.golden @@ -3,5 +3,5 @@ command and provide the following key: unlock-key -Please remember to store this key in a password manager, since without it you +Remember to store this key in a password manager, since without it you will not be able to restart the manager. diff --git a/cli/command/swarm/testdata/update-autolock-unlock-key.golden b/cli/command/swarm/testdata/update-autolock-unlock-key.golden index a077b9e1676e..e1e16bccade4 100644 --- a/cli/command/swarm/testdata/update-autolock-unlock-key.golden +++ b/cli/command/swarm/testdata/update-autolock-unlock-key.golden @@ -4,5 +4,5 @@ command and provide the following key: unlock-key -Please remember to store this key in a password manager, since without it you +Remember to store this key in a password manager, since without it you will not be able to restart the manager. diff --git a/cli/command/swarm/unlock.go b/cli/command/swarm/unlock.go index ad727e073d2a..66ae6d5371d1 100644 --- a/cli/command/swarm/unlock.go +++ b/cli/command/swarm/unlock.go @@ -54,7 +54,7 @@ func runUnlock(ctx context.Context, dockerCli command.Cli) error { return errors.New("Error: swarm is not locked") } - key, err := readKey(dockerCli.In(), "Please enter unlock key: ") + key, err := readKey(dockerCli.In(), "Enter unlock key: ") if err != nil { return err } diff --git a/cli/command/swarm/unlock_key.go b/cli/command/swarm/unlock_key.go index dfd467eacdda..7caee23728cf 100644 --- a/cli/command/swarm/unlock_key.go +++ b/cli/command/swarm/unlock_key.go @@ -88,7 +88,7 @@ func printUnlockCommand(out io.Writer, unlockKey string) { if len(unlockKey) > 0 { fmt.Fprintf(out, "To unlock a swarm manager after it restarts, "+ "run the `docker swarm unlock`\ncommand and provide the following key:\n\n %s\n\n"+ - "Please remember to store this key in a password manager, since without it you\n"+ + "Remember to store this key in a password manager, since without it you\n"+ "will not be able to restart the manager.\n", unlockKey) } } diff --git a/cli/command/trust/revoke.go b/cli/command/trust/revoke.go index 4a0d6e3af30b..a0723bdaa7a5 100644 --- a/cli/command/trust/revoke.go +++ b/cli/command/trust/revoke.go @@ -44,7 +44,7 @@ func revokeTrust(ctx context.Context, dockerCLI command.Cli, remote string, opti return fmt.Errorf("cannot use a digest reference for IMAGE:TAG") } if imgRefAndAuth.Tag() == "" && !options.forceYes { - deleteRemote, err := command.PromptForConfirmation(ctx, dockerCLI.In(), dockerCLI.Out(), fmt.Sprintf("Please confirm you would like to delete all signature data for %s?", remote)) + deleteRemote, err := command.PromptForConfirmation(ctx, dockerCLI.In(), dockerCLI.Out(), fmt.Sprintf("Confirm you would like to delete all signature data for %s?", remote)) if err != nil { return err } diff --git a/cli/command/trust/revoke_test.go b/cli/command/trust/revoke_test.go index 36f9f8296a4e..26e6ef4d014c 100644 --- a/cli/command/trust/revoke_test.go +++ b/cli/command/trust/revoke_test.go @@ -70,7 +70,7 @@ func TestTrustRevokeCommand(t *testing.T) { doc: "OfflineErrors_Confirm", notaryRepository: notary.GetOfflineNotaryRepository, args: []string{"reg-name.io/image"}, - expectedMessage: "Please confirm you would like to delete all signature data for reg-name.io/image? [y/N] ", + expectedMessage: "Confirm you would like to delete all signature data for reg-name.io/image? [y/N] ", expectedErr: revokeCancelledError, }, { @@ -89,7 +89,7 @@ func TestTrustRevokeCommand(t *testing.T) { doc: "UninitializedErrors_Confirm", notaryRepository: notary.GetUninitializedNotaryRepository, args: []string{"reg-name.io/image"}, - expectedMessage: "Please confirm you would like to delete all signature data for reg-name.io/image? [y/N] ", + expectedMessage: "Confirm you would like to delete all signature data for reg-name.io/image? [y/N] ", expectedErr: revokeCancelledError, }, { @@ -108,7 +108,7 @@ func TestTrustRevokeCommand(t *testing.T) { doc: "EmptyNotaryRepo_Confirm", notaryRepository: notary.GetEmptyTargetsNotaryRepository, args: []string{"reg-name.io/image"}, - expectedMessage: "Please confirm you would like to delete all signature data for reg-name.io/image? [y/N] ", + expectedMessage: "Confirm you would like to delete all signature data for reg-name.io/image? [y/N] ", expectedErr: revokeCancelledError, }, { @@ -127,7 +127,7 @@ func TestTrustRevokeCommand(t *testing.T) { doc: "AllSigConfirmation", notaryRepository: notary.GetEmptyTargetsNotaryRepository, args: []string{"alpine"}, - expectedMessage: "Please confirm you would like to delete all signature data for alpine? [y/N] ", + expectedMessage: "Confirm you would like to delete all signature data for alpine? [y/N] ", expectedErr: revokeCancelledError, }, } diff --git a/cli/command/trust/signer_add.go b/cli/command/trust/signer_add.go index db6bcd7c3480..4a1e061e7aa0 100644 --- a/cli/command/trust/signer_add.go +++ b/cli/command/trust/signer_add.go @@ -53,7 +53,7 @@ func addSigner(ctx context.Context, dockerCLI command.Cli, options signerAddOpti return fmt.Errorf("signer name \"%s\" must start with lowercase alphanumeric characters and can include \"-\" or \"_\" after the first character", signerName) } if signerName == "releases" { - return fmt.Errorf("releases is a reserved keyword, please use a different signer name") + return fmt.Errorf("releases is a reserved keyword, use a different signer name") } if options.keys.Len() == 0 { diff --git a/cli/command/trust/signer_add_test.go b/cli/command/trust/signer_add_test.go index 5452ecb5a930..49e1d11c7c2c 100644 --- a/cli/command/trust/signer_add_test.go +++ b/cli/command/trust/signer_add_test.go @@ -34,7 +34,7 @@ func TestTrustSignerAddErrors(t *testing.T) { { name: "reserved-releases-signer-add", args: []string{"releases", "my-image", "--key", "/path/to/key"}, - expectedError: "releases is a reserved keyword, please use a different signer name", + expectedError: "releases is a reserved keyword, use a different signer name", }, { name: "disallowed-chars", diff --git a/cli/command/trust/testdata/trust-revoke-prompt-termination.golden b/cli/command/trust/testdata/trust-revoke-prompt-termination.golden index cceedd79d493..a7e2aecd4db7 100644 --- a/cli/command/trust/testdata/trust-revoke-prompt-termination.golden +++ b/cli/command/trust/testdata/trust-revoke-prompt-termination.golden @@ -1 +1 @@ -Please confirm you would like to delete all signature data for example/trust-demo? [y/N] +Confirm you would like to delete all signature data for example/trust-demo? [y/N] diff --git a/cli/connhelper/commandconn/commandconn.go b/cli/connhelper/commandconn/commandconn.go index f697370ed972..cfc2b86a25f9 100644 --- a/cli/connhelper/commandconn/commandconn.go +++ b/cli/connhelper/commandconn/commandconn.go @@ -149,7 +149,7 @@ func (c *commandConn) handleEOF(err error) error { c.stderrMu.Lock() stderr := c.stderr.String() c.stderrMu.Unlock() - return errors.Errorf("command %v has exited with %v, please make sure the URL is valid, and Docker 18.09 or later is installed on the remote host: stderr=%s", c.cmd.Args, werr, stderr) + return errors.Errorf("command %v has exited with %v, make sure the URL is valid, and Docker 18.09 or later is installed on the remote host: stderr=%s", c.cmd.Args, werr, stderr) } func ignorableCloseError(err error) bool { diff --git a/contrib/completion/bash/docker b/contrib/completion/bash/docker index d37cf66d3ffb..2d01bafca7da 100644 --- a/contrib/completion/bash/docker +++ b/contrib/completion/bash/docker @@ -63,7 +63,7 @@ # must have access to the socket for the completions to function correctly # # Note for developers: -# Please arrange options sorted alphabetically by long name with the short +# Arrange options sorted alphabetically by long name with the short # options immediately following their corresponding long form. # This order should be applied to lists, alternatives and code blocks. diff --git a/dockerfiles/Dockerfile.authors b/dockerfiles/Dockerfile.authors index 278ad769fea1..4b56b945f55b 100644 --- a/dockerfiles/Dockerfile.authors +++ b/dockerfiles/Dockerfile.authors @@ -18,7 +18,7 @@ git add -A cp -rf /out/* . diff=$(git status --porcelain -- AUTHORS) if [ -n "$diff" ]; then - echo >&2 'ERROR: Authors result differs. Please update with "make -f docker.Makefile authors"' + echo >&2 'ERROR: Authors result differs. Update with "make -f docker.Makefile authors"' echo "$diff" exit 1 fi diff --git a/docs/deprecated.md b/docs/deprecated.md index d89206d2eb86..e8516856118a 100644 --- a/docs/deprecated.md +++ b/docs/deprecated.md @@ -188,7 +188,8 @@ CLI to use API version 1.23, which produces an error: ```console DOCKER_API_VERSION=1.23 docker version -Error response from daemon: client version 1.23 is too old. Minimum supported API version is 1.24, please upgrade your client to a newer version +Error response from daemon: client version 1.23 is too old. Minimum supported API version is 1.24, +upgrade your client to a newer version ``` An environment variable (`DOCKER_MIN_API_VERSION`) is introduced that allows @@ -590,7 +591,7 @@ The `--log-opt fluentd-async-connect` option for the fluentd logging driver is A deprecation message is logged in the daemon logs if the old option is used: ```console -fluent#New: AsyncConnect is now deprecated, please use Async instead +fluent#New: AsyncConnect is now deprecated, use Async instead ``` Users are encouraged to use the `fluentd-async` option going forward, as support diff --git a/docs/extend/EBS_volume.md b/docs/extend/EBS_volume.md index e09df6c543c9..88de970ba20c 100644 --- a/docs/extend/EBS_volume.md +++ b/docs/extend/EBS_volume.md @@ -122,7 +122,7 @@ We have to put the following JSON to `$TMPDIR/config.json`: } ``` -Please note a couple of points: +Note a couple of points: - `PropagatedMount` is needed so that the docker daemon can see mounts done by the rexray plugin from within the container, otherwise the docker daemon is not able to mount a docker volume. diff --git a/docs/reference/commandline/container_cp.md b/docs/reference/commandline/container_cp.md index d69683a390e9..3aebacabdbf3 100644 --- a/docs/reference/commandline/container_cp.md +++ b/docs/reference/commandline/container_cp.md @@ -103,7 +103,7 @@ Copy files from container to local path $ docker cp CONTAINER:/var/logs/ /tmp/app_logs ``` -Copy a file from container to stdout. Please note `cp` command produces a tar stream +Copy a file from container to stdout. Note `cp` command produces a tar stream ```console $ docker cp CONTAINER:/var/logs/app.log - | tar x -O | grep "ERROR" diff --git a/docs/reference/commandline/swarm_unlock-key.md b/docs/reference/commandline/swarm_unlock-key.md index 2f78e0359ec1..a2bbf72f9087 100644 --- a/docs/reference/commandline/swarm_unlock-key.md +++ b/docs/reference/commandline/swarm_unlock-key.md @@ -39,7 +39,7 @@ command and provide the following key: SWMKEY-1-fySn8TY4w5lKcWcJPIpKufejh9hxx5KYwx6XZigx3Q4 -Please remember to store this key in a password manager, since without it you +Remember to store this key in a password manager, since without it you will not be able to restart the manager. ``` @@ -56,7 +56,7 @@ command and provide the following key: SWMKEY-1-7c37Cc8654o6p38HnroywCi19pllOnGtbdZEgtKxZu8 -Please remember to store this key in a password manager, since without it you +Remember to store this key in a password manager, since without it you will not be able to restart the manager. ``` diff --git a/docs/reference/commandline/swarm_unlock.md b/docs/reference/commandline/swarm_unlock.md index 92743392c8ba..dc1296140e70 100644 --- a/docs/reference/commandline/swarm_unlock.md +++ b/docs/reference/commandline/swarm_unlock.md @@ -24,7 +24,7 @@ enabled, and is also available from the `docker swarm unlock-key` command. ```console $ docker swarm unlock -Please enter unlock key: +Enter unlock key: ``` ## Related commands diff --git a/docs/reference/commandline/trust_revoke.md b/docs/reference/commandline/trust_revoke.md index 23a0101e83d7..06a2aa4eddc4 100644 --- a/docs/reference/commandline/trust_revoke.md +++ b/docs/reference/commandline/trust_revoke.md @@ -91,7 +91,7 @@ When `alice`, one of the signers, runs `docker trust revoke`: ```console $ docker trust revoke example/trust-demo -Please confirm you would like to delete all signature data for example/trust-demo? [y/N] y +Confirm you would like to delete all signature data for example/trust-demo? [y/N] y Enter passphrase for delegation key with ID 27d42a8: Successfully deleted signature for example/trust-demo ``` diff --git a/e2e/cli-plugins/flags_test.go b/e2e/cli-plugins/flags_test.go index 2df9849039ba..836af32e2a9e 100644 --- a/e2e/cli-plugins/flags_test.go +++ b/e2e/cli-plugins/flags_test.go @@ -93,7 +93,7 @@ func TestGlobalArgsOnlyParsedOnce(t *testing.T) { args: []string{"-H", dh, "-H", dh, "version", "-f", "{{.Client.Version}}"}, expectedExitCode: 1, expectedOut: icmd.None, - expectedErr: "Please specify only one -H", + expectedErr: "Specify only one -H", }, { name: "builtin", diff --git a/e2e/cli-plugins/run_test.go b/e2e/cli-plugins/run_test.go index d3daa35563e3..c3bd279c996a 100644 --- a/e2e/cli-plugins/run_test.go +++ b/e2e/cli-plugins/run_test.go @@ -9,7 +9,7 @@ import ( "gotest.tools/v3/icmd" ) -const shortHFlagDeprecated = "Flag shorthand -h has been deprecated, please use --help\n" +const shortHFlagDeprecated = "Flag shorthand -h has been deprecated, use --help\n" // TestRunNonexisting ensures correct behaviour when running a nonexistent plugin. func TestRunNonexisting(t *testing.T) { diff --git a/experimental/README.md b/experimental/README.md index 73e0f137a3e1..94fd2c0e01f8 100644 --- a/experimental/README.md +++ b/experimental/README.md @@ -7,7 +7,7 @@ provided for test and evaluation in your sandbox environments. The information below describes each feature and the GitHub pull requests and issues associated with it. If necessary, links are provided to additional documentation on an issue. As an active Docker user and community member, -please feel free to provide any feedback on these features you wish. +feel free to provide any feedback on these features you wish. ## Use Docker experimental diff --git a/man/docker.1.md b/man/docker.1.md index 4ec459b41c18..d6048bd3b39f 100644 --- a/man/docker.1.md +++ b/man/docker.1.md @@ -60,7 +60,7 @@ unix://[/path/to/socket] to use. Use "docker help" or "docker --help" to get an overview of available commands. # EXAMPLES -For specific client examples please see the man page for the specific Docker +For specific client examples see the man page for the specific Docker command. For example: man docker-run diff --git a/man/dockerd.8.md b/man/dockerd.8.md index f0b71b3eee6f..2a769e5671dc 100644 --- a/man/dockerd.8.md +++ b/man/dockerd.8.md @@ -286,7 +286,7 @@ unix://[/path/to/socket] to use. This setting will also enable IPv6 forwarding if you have both **--ip-forward=true** and **--fixed-cidr-v6** set. Note that this may reject Router Advertisements and interfere with the host's existing IPv6 - configuration. For more information, please consult the documentation about + configuration. For more information, consult the documentation about "Advanced Networking - IPv6". **--ip-masq**=**true**|**false** @@ -301,7 +301,7 @@ unix://[/path/to/socket] to use. containers. Use together with **--fixed-cidr-v6** to provide globally routable IPv6 addresses. IPv6 forwarding will be enabled if not used with **--ip-forward=false**. This may collide with your host's current IPv6 - settings. For more information please consult the documentation about + settings. For more information consult the documentation about "Advanced Networking - IPv6". **--isolation**="*default*" diff --git a/man/src/system/events.md b/man/src/system/events.md index d18e175c6f99..e5b1f4dfc9a0 100644 --- a/man/src/system/events.md +++ b/man/src/system/events.md @@ -85,7 +85,7 @@ details of the format. Type=container Status=destroy ID=2ee349dac409e97974ce8d01b70d250b85e0ba8189299c126a87812311951e26 If a format is set to `{{json .}}`, the events are streamed as valid JSON -Lines. For information about JSON Lines, please refer to https://jsonlines.org . +Lines. For information about JSON Lines, refer to https://jsonlines.org . # docker events --format '{{json .}}' {"status":"create","id":"196016a57679bf42424484918746a9474cd905dd993c4d0f4.. diff --git a/scripts/vendor b/scripts/vendor index 793f3fe94fda..eac9f8dea69f 100755 --- a/scripts/vendor +++ b/scripts/vendor @@ -29,7 +29,7 @@ update() { validate() { diff=$(git status --porcelain -- vendor.mod vendor.sum vendor) if [ -n "$diff" ]; then - echo >&2 'ERROR: Vendor result differs. Please vendor your package with "make -f docker.Makefile vendor"' + echo >&2 'ERROR: Vendor result differs. Vendor your package with "make -f docker.Makefile vendor"' echo "$diff" exit 1 fi diff --git a/vendor/dario.cat/mergo/CONTRIBUTING.md b/vendor/dario.cat/mergo/CONTRIBUTING.md index 0a1ff9f94d85..1c36c4c3cef4 100644 --- a/vendor/dario.cat/mergo/CONTRIBUTING.md +++ b/vendor/dario.cat/mergo/CONTRIBUTING.md @@ -3,7 +3,7 @@ First off, thanks for taking the time to contribute! ❤️ -All types of contributions are encouraged and valued. See the [Table of Contents](#table-of-contents) for different ways to help and details about how this project handles them. Please make sure to read the relevant section before making your contribution. It will make it a lot easier for us maintainers and smooth out the experience for all involved. The community looks forward to your contributions. 🎉 +All types of contributions are encouraged and valued. See the [Table of Contents](#table-of-contents) for different ways to help and details about how this project handles them. Make sure to read the relevant section before making your contribution. It will make it a lot easier for us maintainers and smooth out the experience for all involved. The community looks forward to your contributions. 🎉 > And if you like the project, but just don't have time to contribute, that's fine. There are other easy ways to support the project and show your appreciation, which we would also be very happy about: > - Star the project @@ -24,7 +24,7 @@ All types of contributions are encouraged and valued. See the [Table of Contents This project and everyone participating in it is governed by the [mergo Code of Conduct](https://github.com/imdario/mergoblob/master/CODE_OF_CONDUCT.md). -By participating, you are expected to uphold this code. Please report unacceptable behavior +By participating, you are expected to uphold this code. Report unacceptable behavior to <>. @@ -52,7 +52,7 @@ We will then take care of the issue as soon as possible. #### Before Submitting a Bug Report -A good bug report shouldn't leave others needing to chase you up for more information. Therefore, we ask you to investigate carefully, collect information and describe the issue in detail in your report. Please complete the following steps in advance to help us fix any potential bug as fast as possible. +A good bug report shouldn't leave others needing to chase you up for more information. Therefore, we ask you to investigate carefully, collect information and describe the issue in detail in your report. Complete the following steps in advance to help us fix any potential bug as fast as possible. - Make sure that you are using the latest version. - Determine if your bug is really a bug and not an error on your side e.g. using incompatible environment components/versions (Make sure that you have read the [documentation](). If you are looking for support, you might want to check [this section](#i-have-a-question)). @@ -75,7 +75,7 @@ We use GitHub issues to track bugs and errors. If you run into an issue with the - Open an [Issue](https://github.com/imdario/mergo/issues/new). (Since we can't be sure at this point whether it is a bug or not, we ask you not to talk about a bug yet and not to label the issue.) - Explain the behavior you would expect and the actual behavior. -- Please provide as much context as possible and describe the *reproduction steps* that someone else can follow to recreate the issue on their own. This usually includes your code. For good bug reports you should isolate the problem and create a reduced test case. +- Provide as much context as possible and describe the *reproduction steps* that someone else can follow to recreate the issue on their own. This usually includes your code. For good bug reports you should isolate the problem and create a reduced test case. - Provide the information you collected in the previous section. Once it's filed: diff --git a/vendor/dario.cat/mergo/README.md b/vendor/dario.cat/mergo/README.md index 7d0cf9f32afe..78de731aa283 100644 --- a/vendor/dario.cat/mergo/README.md +++ b/vendor/dario.cat/mergo/README.md @@ -54,11 +54,11 @@ In [1.0.0](//github.com/imdario/mergo/releases/tag/1.0.0) Mergo moves to a vanit #### 0.3.9 -Please keep in mind that a problematic PR broke [0.3.9](//github.com/imdario/mergo/releases/tag/0.3.9). I reverted it in [0.3.10](//github.com/imdario/mergo/releases/tag/0.3.10), and I consider it stable but not bug-free. Also, this version adds support for go modules. +Keep in mind that a problematic PR broke [0.3.9](//github.com/imdario/mergo/releases/tag/0.3.9). I reverted it in [0.3.10](//github.com/imdario/mergo/releases/tag/0.3.10), and I consider it stable but not bug-free. Also, this version adds support for go modules. Keep in mind that in [0.3.2](//github.com/imdario/mergo/releases/tag/0.3.2), Mergo changed `Merge()`and `Map()` signatures to support [transformers](#transformers). I added an optional/variadic argument so that it won't break the existing code. -If you were using Mergo before April 6th, 2015, please check your project works as intended after updating your local copy with ```go get -u dario.cat/mergo```. I apologize for any issue caused by its previous behavior and any future bug that Mergo could cause in existing projects after the change (release 0.2.0). +If you were using Mergo before April 6th, 2015, check your project works as intended after updating your local copy with ```go get -u dario.cat/mergo```. I apologize for any issue caused by its previous behavior and any future bug that Mergo could cause in existing projects after the change (release 0.2.0). ### Donations @@ -181,7 +181,7 @@ func main() { } ``` -Note: if test are failing due missing package, please execute: +Note: if test are failing due missing package, execute: go get gopkg.in/yaml.v3 diff --git a/vendor/dario.cat/mergo/SECURITY.md b/vendor/dario.cat/mergo/SECURITY.md index a5de61f77ba7..1df7cf2bc94a 100644 --- a/vendor/dario.cat/mergo/SECURITY.md +++ b/vendor/dario.cat/mergo/SECURITY.md @@ -9,6 +9,6 @@ ## Security contact information -To report a security vulnerability, please use the +To report a security vulnerability, use the [Tidelift security contact](https://tidelift.com/security). Tidelift will coordinate the fix and disclosure. diff --git a/vendor/dario.cat/mergo/doc.go b/vendor/dario.cat/mergo/doc.go index 7d96ec0546d8..a82d82be35f0 100644 --- a/vendor/dario.cat/mergo/doc.go +++ b/vendor/dario.cat/mergo/doc.go @@ -20,11 +20,11 @@ In 1.0.0 Mergo moves to a vanity URL `dario.cat/mergo`. 0.3.9 -Please keep in mind that a problematic PR broke 0.3.9. We reverted it in 0.3.10. We consider 0.3.10 as stable but not bug-free. . Also, this version adds suppot for go modules. +Keep in mind that a problematic PR broke 0.3.9. We reverted it in 0.3.10. We consider 0.3.10 as stable but not bug-free. . Also, this version adds suppot for go modules. Keep in mind that in 0.3.2, Mergo changed Merge() and Map() signatures to support transformers. We added an optional/variadic argument so that it won't break the existing code. -If you were using Mergo before April 6th, 2015, please check your project works as intended after updating your local copy with go get -u dario.cat/mergo. I apologize for any issue caused by its previous behavior and any future bug that Mergo could cause in existing projects after the change (release 0.2.0). +If you were using Mergo before April 6th, 2015, check your project works as intended after updating your local copy with go get -u dario.cat/mergo. I apologize for any issue caused by its previous behavior and any future bug that Mergo could cause in existing projects after the change (release 0.2.0). # Install diff --git a/vendor/github.com/Microsoft/go-winio/README.md b/vendor/github.com/Microsoft/go-winio/README.md index 7474b4f0b653..6fa1eb74968f 100644 --- a/vendor/github.com/Microsoft/go-winio/README.md +++ b/vendor/github.com/Microsoft/go-winio/README.md @@ -9,7 +9,7 @@ to reuse the thread to schedule another goroutine. This limits support to Window newer operating systems. This is similar to the implementation of network sockets in Go's net package. -Please see the LICENSE file for licensing information. +See the LICENSE file for licensing information. ## Contributing @@ -33,7 +33,7 @@ to certify they either authored the work themselves or otherwise have permission A range of commits can be signed off using [`git rebase --signoff`][git-rebase-s]. -Please see [the developer certificate](https://developercertificate.org) for more info, +See [the developer certificate](https://developercertificate.org) for more info, as well as to make sure that you can attest to the rules listed. Our CI uses the DCO Github app to ensure that all commits in a given PR are signed-off. diff --git a/vendor/github.com/Microsoft/go-winio/SECURITY.md b/vendor/github.com/Microsoft/go-winio/SECURITY.md index 869fdfe2b246..7818b7984c27 100644 --- a/vendor/github.com/Microsoft/go-winio/SECURITY.md +++ b/vendor/github.com/Microsoft/go-winio/SECURITY.md @@ -4,19 +4,19 @@ Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/). -If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below. +If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), report it to us as described below. ## Reporting Security Issues -**Please do not report security vulnerabilities through public GitHub issues.** +**Do not report security vulnerabilities through public GitHub issues.** -Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report). +Instead, report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report). -If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com). If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey). +If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com). If possible, encrypt your message with our PGP key; download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey). -You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc). +You should receive a response within 24 hours. If for some reason you do not, follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc). -Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue: +Include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue: * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.) * Full paths of source file(s) related to the manifestation of the issue @@ -28,7 +28,7 @@ Please include the requested information listed below (as much as you can provid This information will help us triage your report more quickly. -If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs. +If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs. ## Preferred Languages diff --git a/vendor/github.com/cenkalti/backoff/v4/README.md b/vendor/github.com/cenkalti/backoff/v4/README.md index 16abdfc084f7..426fa4a4ec0b 100644 --- a/vendor/github.com/cenkalti/backoff/v4/README.md +++ b/vendor/github.com/cenkalti/backoff/v4/README.md @@ -9,14 +9,14 @@ The retries exponentially increase and stop increasing when a certain threshold ## Usage -Import path is `github.com/cenkalti/backoff/v4`. Please note the version part at the end. +Import path is `github.com/cenkalti/backoff/v4`. Note the version part at the end. Use https://pkg.go.dev/github.com/cenkalti/backoff/v4 to view the documentation. ## Contributing * I would like to keep this library as small as possible. -* Please don't send a PR without opening an issue and discussing it first. +* Don't send a PR without opening an issue and discussing it first. * If proposed change is not a common use case, I will probably not accept it. [godoc]: https://pkg.go.dev/github.com/cenkalti/backoff/v4 diff --git a/vendor/github.com/containerd/containerd/NOTICE b/vendor/github.com/containerd/containerd/NOTICE index 8915f02773f5..a8d54ac69c8a 100644 --- a/vendor/github.com/containerd/containerd/NOTICE +++ b/vendor/github.com/containerd/containerd/NOTICE @@ -11,6 +11,6 @@ United States and other governments. It is your responsibility to ensure that your use and/or transfer does not violate applicable laws. -For more information, please see https://www.bis.doc.gov +For more information, see https://www.bis.doc.gov See also https://www.apache.org/dev/crypto.html and/or seek legal counsel. diff --git a/vendor/github.com/distribution/reference/CODE-OF-CONDUCT.md b/vendor/github.com/distribution/reference/CODE-OF-CONDUCT.md index 48f6704c6d35..9f9d725caf09 100644 --- a/vendor/github.com/distribution/reference/CODE-OF-CONDUCT.md +++ b/vendor/github.com/distribution/reference/CODE-OF-CONDUCT.md @@ -2,4 +2,4 @@ We follow the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/main/code-of-conduct.md). -Please contact the [CNCF Code of Conduct Committee](mailto:conduct@cncf.io) in order to report violations of the Code of Conduct. +Contact the [CNCF Code of Conduct Committee](mailto:conduct@cncf.io) in order to report violations of the Code of Conduct. diff --git a/vendor/github.com/distribution/reference/CONTRIBUTING.md b/vendor/github.com/distribution/reference/CONTRIBUTING.md index ab2194665653..d59f95540924 100644 --- a/vendor/github.com/distribution/reference/CONTRIBUTING.md +++ b/vendor/github.com/distribution/reference/CONTRIBUTING.md @@ -2,15 +2,15 @@ ## Community help -If you need help, please ask in the [#distribution](https://cloud-native.slack.com/archives/C01GVR8SY4R) channel on CNCF community slack. +If you need help, ask in the [#distribution](https://cloud-native.slack.com/archives/C01GVR8SY4R) channel on CNCF community slack. [Click here for an invite to the CNCF community slack](https://slack.cncf.io/) ## Reporting security issues The maintainers take security seriously. If you discover a security -issue, please bring it to their attention right away! +issue, bring it to their attention right away! -Please **DO NOT** file a public issue, instead send your report privately to +**DO NOT** file a public issue, instead send your report privately to [cncf-distribution-security@lists.cncf.io](mailto:cncf-distribution-security@lists.cncf.io). ## Reporting an issue properly @@ -21,8 +21,8 @@ By following these simple rules you will get better and faster feedback on your ### If you found an issue that describes your problem: - - please read other user comments first, and confirm this is the same issue: a given error condition might be indicative of different problems - you may also find a workaround in the comments - - please refrain from adding "same thing here" or "+1" comments + - read other user comments first, and confirm this is the same issue: a given error condition might be indicative of different problems - you may also find a workaround in the comments + - refrain from adding "same thing here" or "+1" comments - you don't need to comment on an issue to get notified of updates: just hit the "subscribe" button - comment if you have some new, technical and relevant information to add to the case - __DO NOT__ comment on closed issues or merged PRs. If you think you have a related problem, open up a new issue and reference the PR or issue. diff --git a/vendor/github.com/distribution/reference/GOVERNANCE.md b/vendor/github.com/distribution/reference/GOVERNANCE.md index 200045b05091..1393f3b7655c 100644 --- a/vendor/github.com/distribution/reference/GOVERNANCE.md +++ b/vendor/github.com/distribution/reference/GOVERNANCE.md @@ -2,7 +2,7 @@ Distribution [Code of Conduct](./CODE-OF-CONDUCT.md) can be found here. -For specific guidance on practical contribution steps please +For specific guidance on practical contribution steps see our [CONTRIBUTING.md](./CONTRIBUTING.md) guide. ## Maintainership @@ -128,7 +128,7 @@ add a DCO signature in a pull requests's comment, or a maintainer can simply note that the change is sufficiently trivial that it does not substantially change the existing contribution - i.e., a spelling change. -When you add someone's DCO, please also add your own to keep a log. +When you add someone's DCO, also add your own to keep a log. ## I'm a maintainer. Should I make pull requests too? diff --git a/vendor/github.com/distribution/reference/README.md b/vendor/github.com/distribution/reference/README.md index e2531e49c4f9..d947b6ebd0e1 100644 --- a/vendor/github.com/distribution/reference/README.md +++ b/vendor/github.com/distribution/reference/README.md @@ -10,16 +10,16 @@ Go library to handle references to container images. [![codecov](https://codecov.io/gh/distribution/reference/branch/main/graph/badge.svg)](https://codecov.io/gh/distribution/reference) [![FOSSA Status](https://app.fossa.com/api/projects/custom%2B162%2Fgithub.com%2Fdistribution%2Freference.svg?type=shield)](https://app.fossa.com/projects/custom%2B162%2Fgithub.com%2Fdistribution%2Freference?ref=badge_shield) -This repository contains a library for handling refrences to container images held in container registries. Please see [godoc](https://pkg.go.dev/github.com/distribution/reference) for details. +This repository contains a library for handling refrences to container images held in container registries. See [godoc](https://pkg.go.dev/github.com/distribution/reference) for details. ## Contribution -Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute +See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute issues, fixes, and patches to this project. ## Communication -For async communication and long running discussions please use issues and pull requests on the github repo. +For async communication and long running discussions use issues and pull requests on the github repo. This will be the best place to discuss design and implementation. For sync communication we have a #distribution channel in the [CNCF Slack](https://slack.cncf.io/) diff --git a/vendor/github.com/distribution/reference/SECURITY.md b/vendor/github.com/distribution/reference/SECURITY.md index aaf983c0f054..b43c30095d71 100644 --- a/vendor/github.com/distribution/reference/SECURITY.md +++ b/vendor/github.com/distribution/reference/SECURITY.md @@ -2,6 +2,6 @@ ## Reporting a Vulnerability -The maintainers take security seriously. If you discover a security issue, please bring it to their attention right away! +The maintainers take security seriously. If you discover a security issue, bring it to their attention right away! -Please DO NOT file a public issue, instead send your report privately to cncf-distribution-security@lists.cncf.io. +DO NOT file a public issue, instead send your report privately to cncf-distribution-security@lists.cncf.io. diff --git a/vendor/github.com/docker/distribution/BUILDING.md b/vendor/github.com/docker/distribution/BUILDING.md index 4c43b03cb7a9..25e9e59e5081 100644 --- a/vendor/github.com/docker/distribution/BUILDING.md +++ b/vendor/github.com/docker/distribution/BUILDING.md @@ -22,7 +22,7 @@ If you are a casual user with no development experience, and no preliminary know ## Build the development environment The first prerequisite of properly building distribution targets is to have a Go -development environment setup. Please follow [How to Write Go Code](https://golang.org/doc/code.html) +development environment setup. Follow [How to Write Go Code](https://golang.org/doc/code.html) for proper setup. If done correctly, you should have a GOROOT and GOPATH set in the environment. @@ -65,11 +65,11 @@ If it is working, one should see the above log messages. For the full development experience, one should `cd` into `$GOPATH/src/github.com/docker/distribution`. From there, the regular `go` -commands, such as `go test`, should work per package (please see +commands, such as `go test`, should work per package (see [Developing](#developing) if they don't work). A `Makefile` has been provided as a convenience to support repeatable builds. -Please install the following into `GOPATH` for it to work: +Install the following into `GOPATH` for it to work: go get github.com/golang/lint/golint diff --git a/vendor/github.com/docker/distribution/CONTRIBUTING.md b/vendor/github.com/docker/distribution/CONTRIBUTING.md index 4c067d9e7ece..837f9ed58eb6 100644 --- a/vendor/github.com/docker/distribution/CONTRIBUTING.md +++ b/vendor/github.com/docker/distribution/CONTRIBUTING.md @@ -8,7 +8,7 @@ - your account on the [Docker Hub](https://hub.docker.com/) - any other [Docker Hub](https://hub.docker.com/) issue -Then please do not report your issue here - you should instead report it to [https://support.docker.com](https://support.docker.com) +Then do not report your issue here - you should instead report it to [https://support.docker.com](https://support.docker.com) ### If you... @@ -16,7 +16,7 @@ Then please do not report your issue here - you should instead report it to [htt - can't figure out something - are not sure what's going on or what your problem is -Then please do not open an issue here yet - you should first try one of the following support forums: +Then do not open an issue here yet - you should first try one of the following support forums: - irc: #docker-distribution on freenode - mailing-list: or https://groups.google.com/a/dockerproject.org/forum/#!forum/distribution @@ -24,9 +24,9 @@ Then please do not open an issue here yet - you should first try one of the foll ### Reporting security issues The Docker maintainers take security seriously. If you discover a security -issue, please bring it to their attention right away! +issue, bring it to their attention right away! -Please **DO NOT** file a public issue, instead send your report privately to +**DO NOT** file a public issue, instead send your report privately to [security@docker.com](mailto:security@docker.com). ## Reporting an issue properly @@ -37,8 +37,8 @@ By following these simple rules you will get better and faster feedback on your ### If you found an issue that describes your problem: - - please read other user comments first, and confirm this is the same issue: a given error condition might be indicative of different problems - you may also find a workaround in the comments - - please refrain from adding "same thing here" or "+1" comments + - read other user comments first, and confirm this is the same issue: a given error condition might be indicative of different problems - you may also find a workaround in the comments + - refrain from adding "same thing here" or "+1" comments - you don't need to comment on an issue to get notified of updates: just hit the "subscribe" button - comment if you have some new, technical and relevant information to add to the case - __DO NOT__ comment on closed issues or merged PRs. If you think you have a related problem, open up a new issue and reference the PR or issue. @@ -77,7 +77,7 @@ Some simple rules to ensure quick merge: - clearly point to the issue(s) you want to fix in your PR comment (e.g., `closes #12345`) - prefer multiple (smaller) PRs addressing individual issues over a big one trying to address multiple issues at once - - if you need to amend your PR following comments, please squash instead of adding more commits + - if you need to amend your PR following comments, squash instead of adding more commits ## Contributing new features diff --git a/vendor/github.com/docker/distribution/MAINTAINERS b/vendor/github.com/docker/distribution/MAINTAINERS index 3183620c57b9..19db547fd704 100644 --- a/vendor/github.com/docker/distribution/MAINTAINERS +++ b/vendor/github.com/docker/distribution/MAINTAINERS @@ -156,7 +156,7 @@ add a DCO signature in a pull requests's comment, or a maintainer can simply note that the change is sufficiently trivial that it does not substantially change the existing contribution - i.e., a spelling change. -When you add someone's DCO, please also add your own to keep a log. +When you add someone's DCO, also add your own to keep a log. """ [Rules."no direct push"] diff --git a/vendor/github.com/docker/distribution/README.md b/vendor/github.com/docker/distribution/README.md index e513c18e969c..ee7036eb2fcf 100644 --- a/vendor/github.com/docker/distribution/README.md +++ b/vendor/github.com/docker/distribution/README.md @@ -17,7 +17,7 @@ This repository contains the following components: |**Component** |Description | |--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **registry** | An implementation of the [Docker Registry HTTP API V2](docs/spec/api.md) for use with docker 1.6+. | -| **libraries** | A rich set of libraries for interacting with distribution components. Please see [godoc](https://godoc.org/github.com/docker/distribution) for details. **Note**: These libraries are **unstable**. | +| **libraries** | A rich set of libraries for interacting with distribution components. See [godoc](https://godoc.org/github.com/docker/distribution) for details. **Note**: These libraries are **unstable**. | | **specifications** | _Distribution_ related specifications are available in [docs/spec](docs/spec) | | **documentation** | Docker's full documentation set is available at [docs.docker.com](https://docs.docker.com). This repository [contains the subset](docs/) related just to the registry. | @@ -53,7 +53,7 @@ The new registry implementation provides the following benefits: - pluggable storage backend - webhook notifications -For information on upcoming functionality, please see [ROADMAP.md](ROADMAP.md). +For information on upcoming functionality, see [ROADMAP.md](ROADMAP.md). ### Who needs to deploy a registry? @@ -80,7 +80,7 @@ created. For more information see [docker/migrator](https://github.com/docker/mi ## Contribute -Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute +See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute issues, fixes, and patches to this project. If you are contributing code, see the instructions for [building a development environment](BUILDING.md). diff --git a/vendor/github.com/docker/distribution/ROADMAP.md b/vendor/github.com/docker/distribution/ROADMAP.md index 701127afec6e..735d5cae54e6 100644 --- a/vendor/github.com/docker/distribution/ROADMAP.md +++ b/vendor/github.com/docker/distribution/ROADMAP.md @@ -143,7 +143,7 @@ We expect that someone attempts to address the problem with the existing tools and propose it as a standard search API or uses it to inform a standardization process. Once this has been explored, we integrate with the docker client. -Please see the following for more detail: +See the following for more detail: - https://github.com/docker/distribution/issues/206 @@ -228,11 +228,11 @@ operation. The following approaches are being considered: registry metadata. However, metadata is generally not the main bottleneck when serving images. -Please let us know if other solutions exist that we have yet to enumerate. +Let us know if other solutions exist that we have yet to enumerate. Note that for any approach, implementation is a massive consideration. For example, a mark-sweep based solution may seem simple but the amount of work in coordination offset the extra work it might take to build a _Centralized -Oracle_. We'll accept proposals for any solution but please coordinate with us +Oracle_. We'll accept proposals for any solution but coordinate with us before dropping code. At this time, we have traded off simplicity and ease of deployment for disk @@ -241,7 +241,7 @@ which is currently the most expensive resource in software engineering. Taking on any solution for deletes will greatly effect these factors, trading off very cheap disk space for a complex deployment and operational story. -Please see the following issues for more detail: +See the following issues for more detail: - https://github.com/docker/distribution/issues/422 - https://github.com/docker/distribution/issues/461 @@ -253,9 +253,9 @@ At its core, the Distribution Project is a set of Go packages that make up Distribution Components. At this time, most of these packages make up the Registry implementation. -The package itself is considered unstable. If you're using it, please take care to vendor the dependent version. +The package itself is considered unstable. If you're using it, take care to vendor the dependent version. -For feature additions, please see the Registry section. In the future, we may break out a +For feature additions, see the Registry section. In the future, we may break out a separate Roadmap for distribution-specific features that apply to more than just the registry. diff --git a/vendor/github.com/docker/distribution/blobs.go b/vendor/github.com/docker/distribution/blobs.go index 671372abf4ee..6688f26ae0dd 100644 --- a/vendor/github.com/docker/distribution/blobs.go +++ b/vendor/github.com/docker/distribution/blobs.go @@ -80,7 +80,7 @@ type Descriptor struct { // This should only be used when referring to a manifest. Platform *v1.Platform `json:"platform,omitempty"` - // NOTE: Before adding a field here, please ensure that all + // NOTE: Before adding a field here, ensure that all // other options have been exhausted. Much of the type relationships // depend on the simplicity of this type. } diff --git a/vendor/github.com/docker/distribution/uuid/uuid.go b/vendor/github.com/docker/distribution/uuid/uuid.go index d433ccaf512d..8e4720128e8b 100644 --- a/vendor/github.com/docker/distribution/uuid/uuid.go +++ b/vendor/github.com/docker/distribution/uuid/uuid.go @@ -1,7 +1,7 @@ // Package uuid provides simple UUID generation. Only version 4 style UUIDs // can be generated. // -// Please see http://tools.ietf.org/html/rfc4122 for details on UUIDs. +// See http://tools.ietf.org/html/rfc4122 for details on UUIDs. package uuid import ( diff --git a/vendor/github.com/docker/docker/NOTICE b/vendor/github.com/docker/docker/NOTICE index 58b19b6d15b9..1c40faaec612 100644 --- a/vendor/github.com/docker/docker/NOTICE +++ b/vendor/github.com/docker/docker/NOTICE @@ -14,6 +14,6 @@ United States and other governments. It is your responsibility to ensure that your use and/or transfer does not violate applicable laws. -For more information, please see https://www.bis.doc.gov +For more information, see https://www.bis.doc.gov See also https://www.apache.org/dev/crypto.html and/or seek legal counsel. diff --git a/vendor/github.com/docker/docker/api/types/swarm/runtime/plugin.pb.go b/vendor/github.com/docker/docker/api/types/swarm/runtime/plugin.pb.go index 32aaf0d51990..19384bc1e4a1 100644 --- a/vendor/github.com/docker/docker/api/types/swarm/runtime/plugin.pb.go +++ b/vendor/github.com/docker/docker/api/types/swarm/runtime/plugin.pb.go @@ -20,7 +20,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // PluginSpec defines the base payload which clients can specify for creating // a service with the plugin runtime. diff --git a/vendor/github.com/docker/docker/registry/search_endpoint_v1.go b/vendor/github.com/docker/docker/registry/search_endpoint_v1.go index f6c369a93bbf..0afc41b1ffb5 100644 --- a/vendor/github.com/docker/docker/registry/search_endpoint_v1.go +++ b/vendor/github.com/docker/docker/registry/search_endpoint_v1.go @@ -54,7 +54,7 @@ func newV1Endpoint(index *registry.IndexInfo, headers http.Header) (*v1Endpoint, if endpoint.IsSecure { // If registry is secure and HTTPS failed, show user the error and tell them about `--insecure-registry` // in case that's what they need. DO NOT accept unknown CA certificates, and DO NOT fall back to HTTP. - return nil, invalidParamf("invalid registry endpoint %s: %v. If this private registry supports only HTTP or HTTPS with an unknown CA certificate, please add `--insecure-registry %s` to the daemon's arguments. In the case of HTTPS, if you have access to the registry's CA certificate, no need for the flag; simply place the CA certificate at /etc/docker/certs.d/%s/ca.crt", endpoint, err, endpoint.URL.Host, endpoint.URL.Host) + return nil, invalidParamf("invalid registry endpoint %s: %v. If this private registry supports only HTTP or HTTPS with an unknown CA certificate, add `--insecure-registry %s` to the daemon's arguments. In the case of HTTPS, if you have access to the registry's CA certificate, no need for the flag; simply place the CA certificate at /etc/docker/certs.d/%s/ca.crt", endpoint, err, endpoint.URL.Host, endpoint.URL.Host) } // registry is insecure and HTTPS failed, fallback to HTTP. diff --git a/vendor/github.com/docker/go-metrics/NOTICE b/vendor/github.com/docker/go-metrics/NOTICE index 8915f02773f5..a8d54ac69c8a 100644 --- a/vendor/github.com/docker/go-metrics/NOTICE +++ b/vendor/github.com/docker/go-metrics/NOTICE @@ -11,6 +11,6 @@ United States and other governments. It is your responsibility to ensure that your use and/or transfer does not violate applicable laws. -For more information, please see https://www.bis.doc.gov +For more information, see https://www.bis.doc.gov See also https://www.apache.org/dev/crypto.html and/or seek legal counsel. diff --git a/vendor/github.com/docker/go-metrics/README.md b/vendor/github.com/docker/go-metrics/README.md index a9e947cb566b..0e7c5cc5d62b 100644 --- a/vendor/github.com/docker/go-metrics/README.md +++ b/vendor/github.com/docker/go-metrics/README.md @@ -62,7 +62,7 @@ Bytes Unit = "bytes" Total Unit = "total" ``` -If you need to use a unit but it is not defined in the package please open a PR to add it but first try to see if one of the already created units will work for your metric, i.e. seconds or nanoseconds vs adding milliseconds. +If you need to use a unit but it is not defined in the package, open a PR to add it but first try to see if one of the already created units will work for your metric, i.e. seconds or nanoseconds vs adding milliseconds. ## Docs diff --git a/vendor/github.com/go-logr/logr/README.md b/vendor/github.com/go-logr/logr/README.md index 8969526a6e5d..6f5983a6daa8 100644 --- a/vendor/github.com/go-logr/logr/README.md +++ b/vendor/github.com/go-logr/logr/README.md @@ -100,7 +100,7 @@ some conversion functions. ### Inspiration -Before you consider this package, please read [this blog post by the +Before you consider this package, read [this blog post by the inimitable Dave Cheney][warning-makes-no-sense]. We really appreciate what he has to say, and it largely aligns with our own experiences. diff --git a/vendor/github.com/go-logr/logr/SECURITY.md b/vendor/github.com/go-logr/logr/SECURITY.md index 1ca756fc7b36..f3a2d305b3d2 100644 --- a/vendor/github.com/go-logr/logr/SECURITY.md +++ b/vendor/github.com/go-logr/logr/SECURITY.md @@ -1,6 +1,6 @@ # Security Policy -If you have discovered a security vulnerability in this project, please report it +If you have discovered a security vulnerability in this project, report it privately. **Do not disclose it as a public issue.** This gives us time to work with you to fix the issue before public exposure, reducing the chance that the exploit will be used before a patch is released. @@ -10,7 +10,7 @@ You may submit the report in the following ways: - send an email to go-logr-security@googlegroups.com - send us a [private vulnerability report](https://github.com/go-logr/logr/security/advisories/new) -Please provide the following information in your report: +Provide the following information in your report: - A description of the vulnerability and its impact - How to reproduce the issue diff --git a/vendor/github.com/gogo/protobuf/AUTHORS b/vendor/github.com/gogo/protobuf/AUTHORS index 3d97fc7a29f8..944da00b06f5 100644 --- a/vendor/github.com/gogo/protobuf/AUTHORS +++ b/vendor/github.com/gogo/protobuf/AUTHORS @@ -8,7 +8,7 @@ # Individual's name # Individual's name -# Please keep the list sorted. +# Keep the list sorted. Sendgrid, Inc Vastech SA (PTY) LTD diff --git a/vendor/github.com/gogo/protobuf/gogoproto/gogo.pb.go b/vendor/github.com/gogo/protobuf/gogoproto/gogo.pb.go index 1e91766aeeae..bd45a8e2dba1 100644 --- a/vendor/github.com/gogo/protobuf/gogoproto/gogo.pb.go +++ b/vendor/github.com/gogo/protobuf/gogoproto/gogo.pb.go @@ -19,7 +19,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package var E_GoprotoEnumPrefix = &proto.ExtensionDesc{ ExtendedType: (*descriptor.EnumOptions)(nil), diff --git a/vendor/github.com/gogo/protobuf/proto/extensions_gogo.go b/vendor/github.com/gogo/protobuf/proto/extensions_gogo.go index 6f1ae120ece5..e6a1e63a4717 100644 --- a/vendor/github.com/gogo/protobuf/proto/extensions_gogo.go +++ b/vendor/github.com/gogo/protobuf/proto/extensions_gogo.go @@ -50,7 +50,7 @@ type slowExtensionAdapter struct { } func (s slowExtensionAdapter) extensionsWrite() map[int32]Extension { - panic("Please report a bug to github.com/gogo/protobuf if you see this message: Writing extensions is not supported for extensions stored in a byte slice field.") + panic("Report a bug to github.com/gogo/protobuf if you see this message: Writing extensions is not supported for extensions stored in a byte slice field.") } func (s slowExtensionAdapter) extensionsRead() (map[int32]Extension, sync.Locker) { diff --git a/vendor/github.com/gogo/protobuf/protoc-gen-gogo/descriptor/descriptor.pb.go b/vendor/github.com/gogo/protobuf/protoc-gen-gogo/descriptor/descriptor.pb.go index 18b2a3318a57..7fa534bd7eb9 100644 --- a/vendor/github.com/gogo/protobuf/protoc-gen-gogo/descriptor/descriptor.pb.go +++ b/vendor/github.com/gogo/protobuf/protoc-gen-gogo/descriptor/descriptor.pb.go @@ -18,7 +18,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package type FieldDescriptorProto_Type int32 diff --git a/vendor/github.com/gogo/protobuf/types/any.pb.go b/vendor/github.com/gogo/protobuf/types/any.pb.go index e3d4d9490f5e..71a9b3fd06fe 100644 --- a/vendor/github.com/gogo/protobuf/types/any.pb.go +++ b/vendor/github.com/gogo/protobuf/types/any.pb.go @@ -23,7 +23,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // `Any` contains an arbitrary serialized protocol buffer message along with a // URL that describes the type of the serialized message. diff --git a/vendor/github.com/gogo/protobuf/types/api.pb.go b/vendor/github.com/gogo/protobuf/types/api.pb.go index 83e8869206fe..9940aa07980e 100644 --- a/vendor/github.com/gogo/protobuf/types/api.pb.go +++ b/vendor/github.com/gogo/protobuf/types/api.pb.go @@ -23,7 +23,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // Api is a light-weight descriptor for an API Interface. // diff --git a/vendor/github.com/gogo/protobuf/types/duration.pb.go b/vendor/github.com/gogo/protobuf/types/duration.pb.go index 4deafcb1ce95..7025f2f3c91d 100644 --- a/vendor/github.com/gogo/protobuf/types/duration.pb.go +++ b/vendor/github.com/gogo/protobuf/types/duration.pb.go @@ -23,7 +23,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // A Duration represents a signed, fixed-length span of time represented // as a count of seconds and fractions of seconds at nanosecond diff --git a/vendor/github.com/gogo/protobuf/types/empty.pb.go b/vendor/github.com/gogo/protobuf/types/empty.pb.go index 9e94748b3a33..68510a369429 100644 --- a/vendor/github.com/gogo/protobuf/types/empty.pb.go +++ b/vendor/github.com/gogo/protobuf/types/empty.pb.go @@ -23,7 +23,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // A generic empty message that you can re-use to avoid defining duplicated // empty messages in your APIs. A typical example is to use it as the request diff --git a/vendor/github.com/gogo/protobuf/types/field_mask.pb.go b/vendor/github.com/gogo/protobuf/types/field_mask.pb.go index 6ae346d92527..12af9ff162e2 100644 --- a/vendor/github.com/gogo/protobuf/types/field_mask.pb.go +++ b/vendor/github.com/gogo/protobuf/types/field_mask.pb.go @@ -23,7 +23,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // `FieldMask` represents a set of symbolic field paths, for example: // diff --git a/vendor/github.com/gogo/protobuf/types/source_context.pb.go b/vendor/github.com/gogo/protobuf/types/source_context.pb.go index 8e6ce71b275e..b5b3c11637c3 100644 --- a/vendor/github.com/gogo/protobuf/types/source_context.pb.go +++ b/vendor/github.com/gogo/protobuf/types/source_context.pb.go @@ -23,7 +23,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // `SourceContext` represents information about the source of a // protobuf element, like the file in which it is defined. diff --git a/vendor/github.com/gogo/protobuf/types/struct.pb.go b/vendor/github.com/gogo/protobuf/types/struct.pb.go index c0457312e67f..b3f2661046bd 100644 --- a/vendor/github.com/gogo/protobuf/types/struct.pb.go +++ b/vendor/github.com/gogo/protobuf/types/struct.pb.go @@ -26,7 +26,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // `NullValue` is a singleton enumeration to represent the null value for the // `Value` type union. diff --git a/vendor/github.com/gogo/protobuf/types/timestamp.pb.go b/vendor/github.com/gogo/protobuf/types/timestamp.pb.go index 45db7b3bb1c8..5d31c97f614f 100644 --- a/vendor/github.com/gogo/protobuf/types/timestamp.pb.go +++ b/vendor/github.com/gogo/protobuf/types/timestamp.pb.go @@ -23,7 +23,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // A Timestamp represents a point in time independent of any time zone or local // calendar, encoded as a count of seconds and fractions of seconds at diff --git a/vendor/github.com/gogo/protobuf/types/type.pb.go b/vendor/github.com/gogo/protobuf/types/type.pb.go index 791427bb228a..c60c271a3f03 100644 --- a/vendor/github.com/gogo/protobuf/types/type.pb.go +++ b/vendor/github.com/gogo/protobuf/types/type.pb.go @@ -24,7 +24,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // The syntax in which a protocol buffer element is defined. type Syntax int32 diff --git a/vendor/github.com/gogo/protobuf/types/wrappers.pb.go b/vendor/github.com/gogo/protobuf/types/wrappers.pb.go index 8d415420a74d..d09c4cd6466b 100644 --- a/vendor/github.com/gogo/protobuf/types/wrappers.pb.go +++ b/vendor/github.com/gogo/protobuf/types/wrappers.pb.go @@ -24,7 +24,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // Wrapper message for `double`. // diff --git a/vendor/github.com/klauspost/compress/README.md b/vendor/github.com/klauspost/compress/README.md index 7e83f583c00a..2385bdfabcf3 100644 --- a/vendor/github.com/klauspost/compress/README.md +++ b/vendor/github.com/klauspost/compress/README.md @@ -482,7 +482,7 @@ While the release has been extensively tested, it is recommended to testing when * Apr 02, 2017: Change back to official crc32, since changes were merged in Go 1.7. * Jan 14, 2017: Reduce stack pressure due to array copies. See [Issue #18625](https://github.com/golang/go/issues/18625). * Oct 25, 2016: Level 2-4 have been rewritten and now offers significantly better performance than before. -* Oct 20, 2016: Port zlib changes from Go 1.7 to fix zlib writer issue. Please update. +* Oct 20, 2016: Port zlib changes from Go 1.7 to fix zlib writer issue. Update. * Oct 16, 2016: Go 1.7 changes merged. Apples to apples this package is a few percent faster, but has a significantly better balance between speed and compression per level. * Mar 24, 2016: Always attempt Huffman encoding on level 4-7. This improves base 64 encoded data compression. * Mar 24, 2016: Small speedup for level 1-3. @@ -501,7 +501,7 @@ While the release has been extensively tested, it is recommended to testing when * Jan 8 2016: Merge [CL 18317](https://go-review.googlesource.com/#/c/18317): fix reading, writing of zip64 archives. * Dec 8 2015: Make level 1 and -2 deterministic even if write size differs. * Dec 8 2015: Split encoding functions, so hashing and matching can potentially be inlined. 1-3% faster on AMD64. 5% faster on other platforms. -* Dec 8 2015: Fixed rare [one byte out-of bounds read](https://github.com/klauspost/compress/issues/20). Please update! +* Dec 8 2015: Fixed rare [one byte out-of bounds read](https://github.com/klauspost/compress/issues/20). Update! * Nov 23 2015: Optimization on token writer. ~2-4% faster. Contributed by [@dsnet](https://github.com/dsnet). * Nov 20 2015: Small optimization to bit writer on 64 bit systems. * Nov 17 2015: Fixed out-of-bound errors if the underlying Writer returned an error. See [#15](https://github.com/klauspost/compress/issues/15). diff --git a/vendor/github.com/klauspost/compress/SECURITY.md b/vendor/github.com/klauspost/compress/SECURITY.md index ca6685e2b72d..765b4d4b9045 100644 --- a/vendor/github.com/klauspost/compress/SECURITY.md +++ b/vendor/github.com/klauspost/compress/SECURITY.md @@ -18,8 +18,8 @@ Vulnerabilities resulting from compiler/assembler errors should be reported upst ## Reporting a Vulnerability -If you have discovered a security vulnerability in this project, please report it privately. **Do not disclose it as a public issue.** This gives us time to work with you to fix the issue before public exposure, reducing the chance that the exploit will be used before a patch is released. +If you have discovered a security vulnerability in this project, report it privately. **Do not disclose it as a public issue.** This gives us time to work with you to fix the issue before public exposure, reducing the chance that the exploit will be used before a patch is released. -Please disclose it at [security advisory](https://github.com/klauspost/compress/security/advisories/new). If possible please provide a minimal reproducer. If the issue only applies to a single platform, it would be helpful to provide access to that. +Disclose it at [security advisory](https://github.com/klauspost/compress/security/advisories/new). If possible provide a minimal reproducer. If the issue only applies to a single platform, it would be helpful to provide access to that. This project is maintained by a team of volunteers on a reasonable-effort basis. As such, vulnerabilities will be disclosed in a best effort base. diff --git a/vendor/github.com/klauspost/compress/huff0/compress.go b/vendor/github.com/klauspost/compress/huff0/compress.go index 84aa3d12f004..759bbfabaa5e 100644 --- a/vendor/github.com/klauspost/compress/huff0/compress.go +++ b/vendor/github.com/klauspost/compress/huff0/compress.go @@ -676,7 +676,7 @@ func (s *Scratch) setMaxHeight(lastNonNull int) uint8 { } } // only triggered when no more rank 1 symbol left => find closest one (note : there is necessarily at least one !) - // HUF_MAX_TABLELOG test just to please gcc 5+; but it should not be necessary + // HUF_MAX_TABLELOG test just to gcc 5+; but it should not be necessary // FIXME: try to remove for (nBitsToDecrease <= tableLogMax) && (rankLast[nBitsToDecrease] == noSymbol) { nBitsToDecrease++ diff --git a/vendor/github.com/klauspost/compress/zstd/fse_decoder_amd64.go b/vendor/github.com/klauspost/compress/zstd/fse_decoder_amd64.go index d04a829b0a0e..ded7f40a330e 100644 --- a/vendor/github.com/klauspost/compress/zstd/fse_decoder_amd64.go +++ b/vendor/github.com/klauspost/compress/zstd/fse_decoder_amd64.go @@ -14,7 +14,7 @@ type buildDtableAsmContext struct { dt *uint64 // outputs --- set by the procedure in the case of error; - // for interpretation please see the error handling part below + // for interpretation see the error handling part below errParam1 uint64 errParam2 uint64 } @@ -25,7 +25,7 @@ type buildDtableAsmContext struct { //go:noescape func buildDtable_asm(s *fseDecoder, ctx *buildDtableAsmContext) int -// please keep in sync with _generate/gen_fse.go +// keep in sync with _generate/gen_fse.go const ( errorCorruptedNormalizedCounter = 1 errorNewStateTooBig = 2 diff --git a/vendor/github.com/klauspost/compress/zstd/seqdec_amd64.go b/vendor/github.com/klauspost/compress/zstd/seqdec_amd64.go index 8adabd828777..d8fd5c0acabe 100644 --- a/vendor/github.com/klauspost/compress/zstd/seqdec_amd64.go +++ b/vendor/github.com/klauspost/compress/zstd/seqdec_amd64.go @@ -25,14 +25,14 @@ type decodeSyncAsmContext struct { litPosition int history []byte windowSize int - ll int // set on error (not for all errors, please refer to _generate/gen.go) - ml int // set on error (not for all errors, please refer to _generate/gen.go) - mo int // set on error (not for all errors, please refer to _generate/gen.go) + ll int // set on error (not for all errors, refer to _generate/gen.go) + ml int // set on error (not for all errors, refer to _generate/gen.go) + mo int // set on error (not for all errors, refer to _generate/gen.go) } // sequenceDecs_decodeSync_amd64 implements the main loop of sequenceDecs.decodeSync in x86 asm. // -// Please refer to seqdec_generic.go for the reference implementation. +// Refer to seqdec_generic.go for the reference implementation. // //go:noescape func sequenceDecs_decodeSync_amd64(s *sequenceDecs, br *bitReader, ctx *decodeSyncAsmContext) int @@ -211,14 +211,14 @@ const errorOverread = 6 // sequenceDecs_decode implements the main loop of sequenceDecs in x86 asm. // -// Please refer to seqdec_generic.go for the reference implementation. +// Refer to seqdec_generic.go for the reference implementation. // //go:noescape func sequenceDecs_decode_amd64(s *sequenceDecs, br *bitReader, ctx *decodeAsmContext) int // sequenceDecs_decode implements the main loop of sequenceDecs in x86 asm. // -// Please refer to seqdec_generic.go for the reference implementation. +// Refer to seqdec_generic.go for the reference implementation. // //go:noescape func sequenceDecs_decode_56_amd64(s *sequenceDecs, br *bitReader, ctx *decodeAsmContext) int @@ -331,7 +331,7 @@ type executeAsmContext struct { // // Returns false if a match offset is too big. // -// Please refer to seqdec_generic.go for the reference implementation. +// Refer to seqdec_generic.go for the reference implementation. // //go:noescape func sequenceDecs_executeSimple_amd64(ctx *executeAsmContext) bool diff --git a/vendor/github.com/miekg/pkcs11/README.md b/vendor/github.com/miekg/pkcs11/README.md index 18a361a99032..df13a40516f0 100644 --- a/vendor/github.com/miekg/pkcs11/README.md +++ b/vendor/github.com/miekg/pkcs11/README.md @@ -64,5 +64,4 @@ fmt.Println() Further examples are included in the tests. -To expose PKCS#11 keys using the [crypto.Signer interface](https://golang.org/pkg/crypto/#Signer), -please see [github.com/thalesignite/crypto11](https://github.com/thalesignite/crypto11). +To expose PKCS#11 keys using the [crypto.Signer interface](https://golang.org/pkg/crypto/#Signer), see [github.com/thalesignite/crypto11](https://github.com/thalesignite/crypto11). diff --git a/vendor/github.com/moby/patternmatcher/NOTICE b/vendor/github.com/moby/patternmatcher/NOTICE index e5154640fe02..4c465c85900e 100644 --- a/vendor/github.com/moby/patternmatcher/NOTICE +++ b/vendor/github.com/moby/patternmatcher/NOTICE @@ -11,6 +11,6 @@ United States and other governments. It is your responsibility to ensure that your use and/or transfer does not violate applicable laws. -For more information, please see https://www.bis.doc.gov +For more information, see https://www.bis.doc.gov See also https://www.apache.org/dev/crypto.html and/or seek legal counsel. diff --git a/vendor/github.com/moby/swarmkit/v2/api/ca.pb.go b/vendor/github.com/moby/swarmkit/v2/api/ca.pb.go index 42e77d893d00..bfdb104f05f5 100644 --- a/vendor/github.com/moby/swarmkit/v2/api/ca.pb.go +++ b/vendor/github.com/moby/swarmkit/v2/api/ca.pb.go @@ -33,7 +33,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package type NodeCertificateStatusRequest struct { NodeID string `protobuf:"bytes,1,opt,name=node_id,json=nodeId,proto3" json:"node_id,omitempty"` @@ -580,7 +580,7 @@ const _ = grpc.SupportPackageIsVersion4 // CAClient is the client API for CA service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type CAClient interface { GetRootCACertificate(ctx context.Context, in *GetRootCACertificateRequest, opts ...grpc.CallOption) (*GetRootCACertificateResponse, error) // GetUnlockKey returns the current unlock key for the cluster for the role of the client @@ -692,7 +692,7 @@ var _CA_serviceDesc = grpc.ServiceDesc{ // NodeCAClient is the client API for NodeCA service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type NodeCAClient interface { IssueNodeCertificate(ctx context.Context, in *IssueNodeCertificateRequest, opts ...grpc.CallOption) (*IssueNodeCertificateResponse, error) NodeCertificateStatus(ctx context.Context, in *NodeCertificateStatusRequest, opts ...grpc.CallOption) (*NodeCertificateStatusResponse, error) diff --git a/vendor/github.com/moby/swarmkit/v2/api/control.pb.go b/vendor/github.com/moby/swarmkit/v2/api/control.pb.go index a040b9c1fca8..416584fbceaa 100644 --- a/vendor/github.com/moby/swarmkit/v2/api/control.pb.go +++ b/vendor/github.com/moby/swarmkit/v2/api/control.pb.go @@ -35,7 +35,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package type UpdateServiceRequest_Rollback int32 @@ -6387,7 +6387,7 @@ const _ = grpc.SupportPackageIsVersion4 // ControlClient is the client API for Control service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type ControlClient interface { GetNode(ctx context.Context, in *GetNodeRequest, opts ...grpc.CallOption) (*GetNodeResponse, error) ListNodes(ctx context.Context, in *ListNodesRequest, opts ...grpc.CallOption) (*ListNodesResponse, error) diff --git a/vendor/github.com/moby/swarmkit/v2/api/dispatcher.pb.go b/vendor/github.com/moby/swarmkit/v2/api/dispatcher.pb.go index 00542edd9d8b..a0d929f7f037 100644 --- a/vendor/github.com/moby/swarmkit/v2/api/dispatcher.pb.go +++ b/vendor/github.com/moby/swarmkit/v2/api/dispatcher.pb.go @@ -37,7 +37,7 @@ var _ = time.Kitchen // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package type AssignmentChange_AssignmentAction int32 @@ -1336,7 +1336,7 @@ const _ = grpc.SupportPackageIsVersion4 // DispatcherClient is the client API for Dispatcher service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type DispatcherClient interface { // Session starts an agent session with the dispatcher. The session is // started after the first SessionMessage is received. diff --git a/vendor/github.com/moby/swarmkit/v2/api/health.pb.go b/vendor/github.com/moby/swarmkit/v2/api/health.pb.go index b5795d4da078..d4c253ee825c 100644 --- a/vendor/github.com/moby/swarmkit/v2/api/health.pb.go +++ b/vendor/github.com/moby/swarmkit/v2/api/health.pb.go @@ -32,7 +32,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package type HealthCheckResponse_ServingStatus int32 @@ -229,7 +229,7 @@ const _ = grpc.SupportPackageIsVersion4 // HealthClient is the client API for Health service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type HealthClient interface { Check(ctx context.Context, in *HealthCheckRequest, opts ...grpc.CallOption) (*HealthCheckResponse, error) } diff --git a/vendor/github.com/moby/swarmkit/v2/api/logbroker.pb.go b/vendor/github.com/moby/swarmkit/v2/api/logbroker.pb.go index 05cacafd78b9..924b1339f654 100644 --- a/vendor/github.com/moby/swarmkit/v2/api/logbroker.pb.go +++ b/vendor/github.com/moby/swarmkit/v2/api/logbroker.pb.go @@ -34,7 +34,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // LogStream defines the stream from which the log message came. type LogStream int32 @@ -902,7 +902,7 @@ const _ = grpc.SupportPackageIsVersion4 // LogsClient is the client API for Logs service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type LogsClient interface { // SubscribeLogs starts a subscription with the specified selector and options. // @@ -1013,7 +1013,7 @@ var _Logs_serviceDesc = grpc.ServiceDesc{ // LogBrokerClient is the client API for LogBroker service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type LogBrokerClient interface { // ListenSubscriptions starts a subscription stream for the node. For each // message received, the node should attempt to satisfy the subscription. diff --git a/vendor/github.com/moby/swarmkit/v2/api/objects.pb.go b/vendor/github.com/moby/swarmkit/v2/api/objects.pb.go index cbd14db42fa0..877ac121e68c 100644 --- a/vendor/github.com/moby/swarmkit/v2/api/objects.pb.go +++ b/vendor/github.com/moby/swarmkit/v2/api/objects.pb.go @@ -28,7 +28,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // Meta contains metadata about objects. Every object contains a meta field. type Meta struct { diff --git a/vendor/github.com/moby/swarmkit/v2/api/raft.pb.go b/vendor/github.com/moby/swarmkit/v2/api/raft.pb.go index 96fa8550771a..9ca60d7ba8b6 100644 --- a/vendor/github.com/moby/swarmkit/v2/api/raft.pb.go +++ b/vendor/github.com/moby/swarmkit/v2/api/raft.pb.go @@ -32,7 +32,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // StoreActionKind defines the operation to take on the store for the target of // a storage action. @@ -1114,7 +1114,7 @@ const _ = grpc.SupportPackageIsVersion4 // RaftClient is the client API for Raft service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type RaftClient interface { // ProcessRaftMessage sends a raft message to be processed on a raft member, it is // called from the RaftMember willing to send a message to its destination ('To' field) @@ -1309,7 +1309,7 @@ var _Raft_serviceDesc = grpc.ServiceDesc{ // RaftMembershipClient is the client API for RaftMembership service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type RaftMembershipClient interface { // Join adds a RaftMember to the raft cluster. Join(ctx context.Context, in *JoinRequest, opts ...grpc.CallOption) (*JoinResponse, error) diff --git a/vendor/github.com/moby/swarmkit/v2/api/resource.pb.go b/vendor/github.com/moby/swarmkit/v2/api/resource.pb.go index 3466e440736c..9724182d3afe 100644 --- a/vendor/github.com/moby/swarmkit/v2/api/resource.pb.go +++ b/vendor/github.com/moby/swarmkit/v2/api/resource.pb.go @@ -33,7 +33,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package type AttachNetworkRequest struct { Config *NetworkAttachmentConfig `protobuf:"bytes,1,opt,name=config,proto3" json:"config,omitempty"` @@ -318,7 +318,7 @@ const _ = grpc.SupportPackageIsVersion4 // ResourceAllocatorClient is the client API for ResourceAllocator service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type ResourceAllocatorClient interface { AttachNetwork(ctx context.Context, in *AttachNetworkRequest, opts ...grpc.CallOption) (*AttachNetworkResponse, error) DetachNetwork(ctx context.Context, in *DetachNetworkRequest, opts ...grpc.CallOption) (*DetachNetworkResponse, error) diff --git a/vendor/github.com/moby/swarmkit/v2/api/snapshot.pb.go b/vendor/github.com/moby/swarmkit/v2/api/snapshot.pb.go index 7ab5d978d050..021f09ab4dc7 100644 --- a/vendor/github.com/moby/swarmkit/v2/api/snapshot.pb.go +++ b/vendor/github.com/moby/swarmkit/v2/api/snapshot.pb.go @@ -23,7 +23,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package type Snapshot_Version int32 diff --git a/vendor/github.com/moby/swarmkit/v2/api/specs.pb.go b/vendor/github.com/moby/swarmkit/v2/api/specs.pb.go index a789d5a95eab..a5dd5416b610 100644 --- a/vendor/github.com/moby/swarmkit/v2/api/specs.pb.go +++ b/vendor/github.com/moby/swarmkit/v2/api/specs.pb.go @@ -26,7 +26,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package type NodeSpec_Membership int32 diff --git a/vendor/github.com/moby/swarmkit/v2/api/types.pb.go b/vendor/github.com/moby/swarmkit/v2/api/types.pb.go index 61a544a6b7b6..ca8cc838c0ed 100644 --- a/vendor/github.com/moby/swarmkit/v2/api/types.pb.go +++ b/vendor/github.com/moby/swarmkit/v2/api/types.pb.go @@ -31,7 +31,7 @@ var _ = time.Kitchen // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package type ResourceType int32 diff --git a/vendor/github.com/moby/swarmkit/v2/api/watch.pb.go b/vendor/github.com/moby/swarmkit/v2/api/watch.pb.go index 9203d58db1d4..50a5a2d27931 100644 --- a/vendor/github.com/moby/swarmkit/v2/api/watch.pb.go +++ b/vendor/github.com/moby/swarmkit/v2/api/watch.pb.go @@ -33,7 +33,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package // WatchActionKind distinguishes between creations, updates, and removals. It // is structured as a bitmap so multiple kinds of events can be requested with @@ -1224,7 +1224,7 @@ const _ = grpc.SupportPackageIsVersion4 // WatchClient is the client API for Watch service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream. type WatchClient interface { // Watch starts a stream that returns any changes to objects that match // the specified selectors. When the stream begins, it immediately sends diff --git a/vendor/github.com/moby/swarmkit/v2/protobuf/plugin/plugin.pb.go b/vendor/github.com/moby/swarmkit/v2/protobuf/plugin/plugin.pb.go index d947c8b530ec..43f0a2e54055 100644 --- a/vendor/github.com/moby/swarmkit/v2/protobuf/plugin/plugin.pb.go +++ b/vendor/github.com/moby/swarmkit/v2/protobuf/plugin/plugin.pb.go @@ -25,7 +25,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.GoGoProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.GoGoProtoPackageIsVersion3 // upgrade the proto package type WatchSelectors struct { // supported by all object types diff --git a/vendor/github.com/moby/sys/symlink/README.md b/vendor/github.com/moby/sys/symlink/README.md index 8dba54fd089d..d34a2ca9bd4b 100644 --- a/vendor/github.com/moby/sys/symlink/README.md +++ b/vendor/github.com/moby/sys/symlink/README.md @@ -3,4 +3,4 @@ as well as a Windows long-path aware version of filepath.EvalSymlinks from the [Go standard library](https://golang.org/pkg/path/filepath). The code from filepath.EvalSymlinks has been adapted in fs.go. -Please read the LICENSE.BSD file that governs fs.go and LICENSE.APACHE for fs_test.go. +Read the LICENSE.BSD file that governs fs.go and LICENSE.APACHE for fs_test.go. diff --git a/vendor/github.com/opencontainers/go-digest/README.md b/vendor/github.com/opencontainers/go-digest/README.md index a11287207edc..1844b82c080b 100644 --- a/vendor/github.com/opencontainers/go-digest/README.md +++ b/vendor/github.com/opencontainers/go-digest/README.md @@ -4,7 +4,7 @@ Common digest package used across the container ecosystem. -Please see the [godoc](https://godoc.org/github.com/opencontainers/go-digest) for more information. +See the [godoc](https://godoc.org/github.com/opencontainers/go-digest) for more information. # What is a digest? @@ -73,7 +73,7 @@ As always, before using a package export, read the [godoc](https://godoc.org/git This package is considered fairly complete. It has been in production in thousands (millions?) of deployments and is fairly battle-hardened. New additions will be met with skepticism. -If you think there is a missing feature, please file a bug clearly describing the problem and the alternatives you tried before submitting a PR. +If you think there is a missing feature, file a bug clearly describing the problem and the alternatives you tried before submitting a PR. ## Code of Conduct @@ -81,7 +81,7 @@ Participation in the OpenContainers community is governed by [OpenContainer's Co ## Security -If you find an issue, please follow the [security][security] protocol to report it. +If you find an issue, follow the [security][security] protocol to report it. # Copyright and license diff --git a/vendor/github.com/opencontainers/go-digest/digest.go b/vendor/github.com/opencontainers/go-digest/digest.go index 518b5e715456..db82f348a92b 100644 --- a/vendor/github.com/opencontainers/go-digest/digest.go +++ b/vendor/github.com/opencontainers/go-digest/digest.go @@ -49,7 +49,7 @@ func NewDigestFromBytes(alg Algorithm, p []byte) Digest { return NewDigestFromEncoded(alg, alg.Encode(p)) } -// NewDigestFromHex is deprecated. Please use NewDigestFromEncoded. +// NewDigestFromHex is deprecated. Use NewDigestFromEncoded. func NewDigestFromHex(alg, hex string) Digest { return NewDigestFromEncoded(Algorithm(alg), hex) } @@ -137,7 +137,7 @@ func (d Digest) Encoded() string { return string(d[d.sepIndex()+1:]) } -// Hex is deprecated. Please use Digest.Encoded. +// Hex is deprecated. Use Digest.Encoded. func (d Digest) Hex() string { return d.Encoded() } diff --git a/vendor/github.com/pkg/errors/README.md b/vendor/github.com/pkg/errors/README.md index 54dfdcb12ea1..2c4d08190d26 100644 --- a/vendor/github.com/pkg/errors/README.md +++ b/vendor/github.com/pkg/errors/README.md @@ -52,7 +52,7 @@ With the upcoming [Go2 error proposals](https://go.googlesource.com/proposal/+/m Because of the Go2 errors changes, this package is not accepting proposals for new functionality. With that said, we welcome pull requests, bug fixes and issue reports. -Before sending a PR, please discuss your change by raising an issue. +Before sending a PR, discuss your change by raising an issue. ## License diff --git a/vendor/github.com/prometheus/procfs/CONTRIBUTING.md b/vendor/github.com/prometheus/procfs/CONTRIBUTING.md index 853eb9d49b8b..f1197b0c49cc 100644 --- a/vendor/github.com/prometheus/procfs/CONTRIBUTING.md +++ b/vendor/github.com/prometheus/procfs/CONTRIBUTING.md @@ -11,7 +11,7 @@ Prometheus uses GitHub to manage reviews of pull requests. * If you plan to do something more involved, first discuss your ideas on our [mailing list](https://groups.google.com/forum/?fromgroups#!forum/prometheus-developers). This will avoid unnecessary work and surely give you and us a good deal - of inspiration. Also please see our [non-goals issue](https://github.com/prometheus/docs/issues/149) on areas that the Prometheus community doesn't plan to work on. + of inspiration. Also see our [non-goals issue](https://github.com/prometheus/docs/issues/149) on areas that the Prometheus community doesn't plan to work on. * Relevant coding style guidelines are the [Go Code Review Comments](https://code.google.com/p/go-wiki/wiki/CodeReviewComments) @@ -23,9 +23,9 @@ Prometheus uses GitHub to manage reviews of pull requests. ## Steps to Contribute -Should you wish to work on an issue, please claim it first by commenting on the GitHub issue that you want to work on it. This is to prevent duplicated efforts from contributors on the same issue. +Should you wish to work on an issue, claim it first by commenting on the GitHub issue that you want to work on it. This is to prevent duplicated efforts from contributors on the same issue. -Please check the [`help-wanted`](https://github.com/prometheus/procfs/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) label to find issues that are good for getting started. If you have questions about one of the issues, with or without the tag, please comment on them and one of the maintainers will clarify it. For a quicker response, contact us over [IRC](https://prometheus.io/community). +Check the [`help-wanted`](https://github.com/prometheus/procfs/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) label to find issues that are good for getting started. If you have questions about one of the issues, with or without the tag, comment on them and one of the maintainers will clarify it. For a quicker response, contact us over [IRC](https://prometheus.io/community). For quickly compiling and testing your changes do: ``` diff --git a/vendor/github.com/prometheus/procfs/Makefile.common b/vendor/github.com/prometheus/procfs/Makefile.common index 062a28185637..8bf347295279 100644 --- a/vendor/github.com/prometheus/procfs/Makefile.common +++ b/vendor/github.com/prometheus/procfs/Makefile.common @@ -114,7 +114,7 @@ common-style: @fmtRes=$$($(GOFMT) -d $$(find . -path ./vendor -prune -o -name '*.go' -print)); \ if [ -n "$${fmtRes}" ]; then \ echo "gofmt checking failed!"; echo "$${fmtRes}"; echo; \ - echo "Please ensure you are using $$($(GO) version) for formatting code."; \ + echo "Ensure you are using $$($(GO) version) for formatting code."; \ exit 1; \ fi diff --git a/vendor/github.com/sirupsen/logrus/README.md b/vendor/github.com/sirupsen/logrus/README.md index d1d4a85fd752..dcfb28853ae5 100644 --- a/vendor/github.com/sirupsen/logrus/README.md +++ b/vendor/github.com/sirupsen/logrus/README.md @@ -108,7 +108,7 @@ go test -bench=.*CallerTracing #### Case-sensitivity The organization's name was changed to lower-case--and this will not be changed -back. If you are getting import conflicts due to case sensitivity, please use +back. If you are getting import conflicts due to case sensitivity, use the lower-case import: `github.com/sirupsen/logrus`. #### Example @@ -285,7 +285,7 @@ func init() { } } ``` -Note: Syslog hook also support connecting to local syslog (Ex. "/dev/log" or "/var/run/syslog" or "/var/run/log"). For the detail, please check the [syslog hook README](hooks/syslog/README.md). +Note: Syslog hook also support connecting to local syslog (Ex. "/dev/log" or "/var/run/syslog" or "/var/run/log"). For the detail, check the [syslog hook README](hooks/syslog/README.md). A list of currently known service hooks can be found in this wiki [page](https://github.com/sirupsen/logrus/wiki/Hooks) @@ -317,7 +317,7 @@ log.SetLevel(log.InfoLevel) It may be useful to set `log.Level = logrus.DebugLevel` in a debug or verbose environment if your application has that. -Note: If you want different log levels for global (`log.SetLevel(...)`) and syslog logging, please check the [syslog hook README](hooks/syslog/README.md#different-log-levels-for-local-and-remote-logging). +Note: If you want different log levels for global (`log.SetLevel(...)`) and syslog logging, Check the [syslog hook README](hooks/syslog/README.md#different-log-levels-for-local-and-remote-logging). #### Entries diff --git a/vendor/github.com/spf13/cobra/CONTRIBUTING.md b/vendor/github.com/spf13/cobra/CONTRIBUTING.md index 6f356e6a82f6..847f01aac99d 100644 --- a/vendor/github.com/spf13/cobra/CONTRIBUTING.md +++ b/vendor/github.com/spf13/cobra/CONTRIBUTING.md @@ -15,22 +15,22 @@ If you have questions regarding Cobra, feel free to ask it in the community ## Filing a bug or feature -1. Before filing an issue, please check the existing issues to see if a +1. Before filing an issue, check the existing issues to see if a similar one was already opened. If there is one already opened, feel free to comment on it. -1. If you believe you've found a bug, please provide detailed steps of +1. If you believe you've found a bug, provide detailed steps of reproduction, the version of Cobra and anything else you believe will be useful to help troubleshoot it (e.g. OS environment, environment variables, etc...). Also state the current behavior vs. the expected behavior. -1. If you'd like to see a feature or an enhancement please open an issue with +1. If you'd like to see a feature or an enhancement open an issue with a clear title and description of what the feature is and why it would be beneficial to the project and its users. ## Submitting changes 1. CLA: Upon submitting a Pull Request (PR), contributors will be prompted to - sign a CLA. Please sign the CLA :slightly_smiling_face: -1. Tests: If you are submitting code, please ensure you have adequate tests + sign a CLA. Sign the CLA :slightly_smiling_face: +1. Tests: If you are submitting code, Ensure you have adequate tests for the feature. Tests can be run via `go test ./...` or `make test`. 1. Since this is golang project, ensure the new code is properly formatted to ensure code consistency. Run `make all`. diff --git a/vendor/github.com/spf13/cobra/README.md b/vendor/github.com/spf13/cobra/README.md index 6444f4b7f6f3..90858be980e4 100644 --- a/vendor/github.com/spf13/cobra/README.md +++ b/vendor/github.com/spf13/cobra/README.md @@ -103,9 +103,9 @@ It can be installed by running: go install github.com/spf13/cobra-cli@latest ``` -For complete details on using the Cobra-CLI generator, please read [The Cobra Generator README](https://github.com/spf13/cobra-cli/blob/main/README.md) +For complete details on using the Cobra-CLI generator, read [The Cobra Generator README](https://github.com/spf13/cobra-cli/blob/main/README.md) -For complete details on using the Cobra library, please read the [The Cobra User Guide](site/content/user_guide.md). +For complete details on using the Cobra library, read the [The Cobra User Guide](site/content/user_guide.md). # License diff --git a/vendor/github.com/spf13/cobra/command.go b/vendor/github.com/spf13/cobra/command.go index 2fbe6c131a7f..cb4c1285a9f6 100644 --- a/vendor/github.com/spf13/cobra/command.go +++ b/vendor/github.com/spf13/cobra/command.go @@ -896,7 +896,7 @@ func (c *Command) execute(a []string) (err error) { if err != nil { // should be impossible to get here as we always declare a help // flag in InitDefaultHelpFlag() - c.Println("\"help\" flag declared as non-bool. Please correct your code") + c.Println("\"help\" flag declared as non-bool. Correct your code") return err } @@ -908,7 +908,7 @@ func (c *Command) execute(a []string) (err error) { if c.Version != "" { versionVal, err := c.Flags().GetBool("version") if err != nil { - c.Println("\"version\" flag declared as non-bool. Please correct your code") + c.Println("\"version\" flag declared as non-bool. Correct your code") return err } if versionVal { diff --git a/vendor/github.com/spf13/pflag/README.md b/vendor/github.com/spf13/pflag/README.md index 7eacc5bdbe5f..5e736f7e1207 100644 --- a/vendor/github.com/spf13/pflag/README.md +++ b/vendor/github.com/spf13/pflag/README.md @@ -224,16 +224,16 @@ It is possible to deprecate a flag, or just its shorthand. Deprecating a flag/sh **Example #1**: You want to deprecate a flag named "badflag" as well as inform the users what flag they should use instead. ```go // deprecate a flag by specifying its name and a usage message -flags.MarkDeprecated("badflag", "please use --good-flag instead") +flags.MarkDeprecated("badflag", "use --good-flag instead") ``` -This hides "badflag" from help text, and prints `Flag --badflag has been deprecated, please use --good-flag instead` when "badflag" is used. +This hides "badflag" from help text, and prints `Flag --badflag has been deprecated, use --good-flag instead` when "badflag" is used. **Example #2**: You want to keep a flag name "noshorthandflag" but deprecate its shortname "n". ```go // deprecate a flag shorthand by specifying its flag name and a usage message -flags.MarkShorthandDeprecated("noshorthandflag", "please use --noshorthandflag only") +flags.MarkShorthandDeprecated("noshorthandflag", "use --noshorthandflag only") ``` -This hides the shortname "n" from help text, and prints `Flag shorthand -n has been deprecated, please use --noshorthandflag only` when the shorthand "n" is used. +This hides the shortname "n" from help text, and prints `Flag shorthand -n has been deprecated, use --noshorthandflag only` when the shorthand "n" is used. Note that usage message is essential here, and it should not be empty. diff --git a/vendor/github.com/theupdateframework/notary/CHANGELOG.md b/vendor/github.com/theupdateframework/notary/CHANGELOG.md index 70fd6eaa9e59..edf669260394 100644 --- a/vendor/github.com/theupdateframework/notary/CHANGELOG.md +++ b/vendor/github.com/theupdateframework/notary/CHANGELOG.md @@ -34,7 +34,7 @@ + Custom metadata can now be provided and read on a target when using the notary client as a library (not yet exposed on the CLI). [#1146](https://github.com/theupdateframework/notary/pull/1146) + `notary init` now accepts a `--root-cert` and `--root-key` flag for use with privately generated certificates and keys. [#1144](https://github.com/theupdateframework/notary/pull/1144) + `notary key generate` now accepts a `--role` flag as well as a `--output` flag. This means it can generate new targets or delegation keys, and it can also output keys to a file instead of storing it in the default notary key store. [#1134](https://github.com/theupdateframework/notary/pull/1134) -+ Newly generated keys are now stored encrypted and encoded in PKCS#8 format. **This is not forwards-compatible against notary<0.6.0 and docker<17.12.x. Also please note that docker>=17.12.x is not forwards compatible with notary<0.6.0.**. [#1130](https://github.com/theupdateframework/notary/pull/1130) [#1201](https://github.com/theupdateframework/notary/pull/1201) ++ Newly generated keys are now stored encrypted and encoded in PKCS#8 format. **This is not forwards-compatible against notary<0.6.0 and docker<17.12.x. Also note that docker>=17.12.x is not forwards compatible with notary<0.6.0.**. [#1130](https://github.com/theupdateframework/notary/pull/1130) [#1201](https://github.com/theupdateframework/notary/pull/1201) + Added support for wildcarded certificate IDs in the trustpinning configuration [#1126](https://github.com/theupdateframework/notary/pull/1126) + Added support using the client against notary servers which are hosted as subpath under another server (e.g. https://domain.com/notary instead of https://notary.com) [#1108](https://github.com/theupdateframework/notary/pull/1108) + If no changes were made to the targets file, you are no longer required to sign the target [#1104](https://github.com/theupdateframework/notary/pull/1104) diff --git a/vendor/github.com/theupdateframework/notary/CONTRIBUTING.md b/vendor/github.com/theupdateframework/notary/CONTRIBUTING.md index 64d2326f9b5a..e9ad6e8fa91c 100644 --- a/vendor/github.com/theupdateframework/notary/CONTRIBUTING.md +++ b/vendor/github.com/theupdateframework/notary/CONTRIBUTING.md @@ -8,7 +8,7 @@ - your account on the [Docker Hub](https://hub.docker.com/) - any other [Docker Hub](https://hub.docker.com/) issue -Then please do not report your issue here - you should instead report it to [https://support.docker.com](https://support.docker.com) +Then do not report your issue here - you should instead report it to [https://support.docker.com](https://support.docker.com) ### If you... @@ -16,7 +16,7 @@ Then please do not report your issue here - you should instead report it to [htt - can't figure out something - are not sure what's going on or what your problem is -Then please do not open an issue here yet - you should first try one of the following support forums: +Then do not open an issue here yet - you should first try one of the following support forums: - irc: #docker-trust on freenode @@ -28,8 +28,8 @@ By following these simple rules you will get better and faster feedback on your ### If you found an issue that describes your problem: - - please read other user comments first, and confirm this is the same issue: a given error condition might be indicative of different problems - you may also find a workaround in the comments - - please refrain from adding "same thing here" or "+1" comments + - read other user comments first, and confirm this is the same issue: a given error condition might be indicative of different problems - you may also find a workaround in the comments + - refrain from adding "same thing here" or "+1" comments - you don't need to comment on an issue to get notified of updates: just hit the "subscribe" button - comment if you have some new, technical and relevant information to add to the case @@ -40,7 +40,7 @@ By following these simple rules you will get better and faster feedback on your - good title: "Publish fail: 400 error with E_INVALID_DIGEST" 2. copy the output of: - `notary version` or `docker version` - 3. Run `notary` or `docker` with the `-D` option for debug output, and please include a copy of the command and the output. + 3. Run `notary` or `docker` with the `-D` option for debug output, and include a copy of the command and the output. 4. If relevant, copy your `notaryserver` and `notarysigner` logs that show the error (this is likely the output from running `docker-compose up`) ## Contributing a patch for a known bug, or a small correction @@ -61,8 +61,8 @@ Some simple rules to ensure quick merge: - clearly point to the issue(s) you want to fix in your PR comment (e.g., `closes #12345`) - prefer multiple (smaller) PRs addressing individual issues over a big one trying to address multiple issues at once - - if you need to amend your PR following comments, please squash instead of adding more commits - - if fixing a bug or adding a feature, please add or update the relevant `CHANGELOG.md` entry with your pull request number + - if you need to amend your PR following comments, squash instead of adding more commits + - if fixing a bug or adding a feature, add or update the relevant `CHANGELOG.md` entry with your pull request number and a description of the change ## Contributing new features @@ -91,5 +91,5 @@ Complying to these simple rules will greatly accelerate the review process, and ## Vendoring new dependency versions -We use [VNDR](https://github.com/LK4D4/vndr); please update `vendor.conf` with the new dependency or the new version, and run +We use [VNDR](https://github.com/LK4D4/vndr); update `vendor.conf` with the new dependency or the new version, and run `vndr `. \ No newline at end of file diff --git a/vendor/github.com/theupdateframework/notary/passphrase/passphrase.go b/vendor/github.com/theupdateframework/notary/passphrase/passphrase.go index 38bc568c6a0e..209032250a7d 100644 --- a/vendor/github.com/theupdateframework/notary/passphrase/passphrase.go +++ b/vendor/github.com/theupdateframework/notary/passphrase/passphrase.go @@ -19,8 +19,8 @@ const ( idBytesToDisplay = 7 tufRootAlias = "root" tufRootKeyGenerationWarning = `You are about to create a new root signing key passphrase. This passphrase -will be used to protect the most sensitive key in your signing system. Please -choose a long, complex passphrase and be careful to keep the password and the +will be used to protect the most sensitive key in your signing system. Choose +a long, complex passphrase and be careful to keep the password and the key file itself secure and backed up. It is highly recommended that you use a password manager to generate the passphrase and keep it safe. There will be no way to recover this key. You can find the key in your config directory.` @@ -40,7 +40,7 @@ var ( ErrTooManyAttempts = errors.New("Too many attempts") // ErrNoInput is returned if we do not have a valid input method for passphrases - ErrNoInput = errors.New("Please either use environment variables or STDIN with a terminal to provide key passphrases") + ErrNoInput = errors.New("Either use environment variables or STDIN with a terminal to provide key passphrases") ) // PromptRetriever returns a new Retriever which will provide a prompt on stdin @@ -77,7 +77,7 @@ func (br *boundRetriever) getPassphrase(keyName, alias string, createNew bool, n if numAttempts > 3 { return "", true, ErrTooManyAttempts } - fmt.Fprintln(br.out, "Passphrase incorrect. Please retry.") + fmt.Fprintln(br.out, "Passphrase incorrect. Retry.") } // passphrase not cached and we're not aborting, get passphrase from user! @@ -144,7 +144,7 @@ func (br *boundRetriever) requestPassphrase(keyName, alias string, createNew boo func (br *boundRetriever) verifyAndConfirmPassword(stdin *bufio.Reader, retPass, displayAlias, withID string) error { if len(retPass) < 8 { - fmt.Fprintln(br.out, "Passphrase is too short. Please use a password manager to generate and store a good random passphrase.") + fmt.Fprintln(br.out, "Passphrase is too short. Use a password manager to generate and store a good random passphrase.") return ErrTooShort } @@ -158,7 +158,7 @@ func (br *boundRetriever) verifyAndConfirmPassword(stdin *bufio.Reader, retPass, confirmationStr := strings.TrimSpace(string(confirmation)) if retPass != confirmationStr { - fmt.Fprintln(br.out, "Passphrases do not match. Please retry.") + fmt.Fprintln(br.out, "Passphrases do not match. Retry.") return ErrDontMatch } return nil diff --git a/vendor/github.com/theupdateframework/notary/storage/filestore.go b/vendor/github.com/theupdateframework/notary/storage/filestore.go index fb91b3ea9310..b2f94e21bef8 100644 --- a/vendor/github.com/theupdateframework/notary/storage/filestore.go +++ b/vendor/github.com/theupdateframework/notary/storage/filestore.go @@ -82,7 +82,7 @@ func (f *FilesystemStore) migrateTo0Dot4() { if _, err := os.Stat(rootKeysSubDir); !os.IsNotExist(err) && f.Location() != rootKeysSubDir { if rootKeysSubDir == "" || rootKeysSubDir == "/" { // making sure we don't remove a user's homedir - logrus.Warn("The directory for root keys is an unsafe value, we are not going to delete the directory. Please delete it manually") + logrus.Warn("The directory for root keys is an unsafe value, we are not going to delete the directory. Delete it manually") } else { // root_keys exists, migrate things from it listOnlyRootKeysDirStore, _ := NewFileStore(rootKeysSubDir, f.ext) @@ -97,7 +97,7 @@ func (f *FilesystemStore) migrateTo0Dot4() { if _, err := os.Stat(nonRootKeysSubDir); !os.IsNotExist(err) && f.Location() != nonRootKeysSubDir { if nonRootKeysSubDir == "" || nonRootKeysSubDir == "/" { // making sure we don't remove a user's homedir - logrus.Warn("The directory for non root keys is an unsafe value, we are not going to delete the directory. Please delete it manually") + logrus.Warn("The directory for non root keys is an unsafe value, we are not going to delete the directory. Delete it manually") } else { // tuf_keys exists, migrate things from it listOnlyNonRootKeysDirStore, _ := NewFileStore(nonRootKeysSubDir, f.ext) @@ -112,7 +112,7 @@ func (f *FilesystemStore) migrateTo0Dot4() { // if we have a trusted_certificates folder, let's delete for a complete migration since it is unused by new clients certsSubDir := filepath.Join(f.Location(), "trusted_certificates") if certsSubDir == "" || certsSubDir == "/" { - logrus.Warn("The directory for trusted certificate is an unsafe value, we are not going to delete the directory. Please delete it manually") + logrus.Warn("The directory for trusted certificate is an unsafe value, we are not going to delete the directory. Delete it manually") } else { os.RemoveAll(certsSubDir) } diff --git a/vendor/github.com/theupdateframework/notary/storage/httpstore.go b/vendor/github.com/theupdateframework/notary/storage/httpstore.go index 3f81f0ab36ea..5cfc32401e18 100644 --- a/vendor/github.com/theupdateframework/notary/storage/httpstore.go +++ b/vendor/github.com/theupdateframework/notary/storage/httpstore.go @@ -5,7 +5,7 @@ // else validation error details, etc. will be unparsable. The errors // should have a github.com/theupdateframework/notary/tuf/validation/SerializableError // in the Details field. -// If writing your own server, please have a look at +// If writing your own server, have a look at // github.com/docker/distribution/registry/api/errcode package storage diff --git a/vendor/github.com/theupdateframework/notary/trustmanager/yubikey/yubikeystore.go b/vendor/github.com/theupdateframework/notary/trustmanager/yubikey/yubikeystore.go index 1fd71eea95c9..1560d1b69579 100644 --- a/vendor/github.com/theupdateframework/notary/trustmanager/yubikey/yubikeystore.go +++ b/vendor/github.com/theupdateframework/notary/trustmanager/yubikey/yubikeystore.go @@ -82,7 +82,7 @@ func SetTouchToSignUI(notifier func(), callback func()) { } var touchToSignUI = func() { - fmt.Println("Please touch the attached Yubikey to perform signing.") + fmt.Println("Touch the attached Yubikey to perform signing.") } var touchDoneCallback = func() { diff --git a/vendor/go.etcd.io/etcd/raft/v3/raftpb/raft.pb.go b/vendor/go.etcd.io/etcd/raft/v3/raftpb/raft.pb.go index 1ee77a9a4576..00700d100417 100644 --- a/vendor/go.etcd.io/etcd/raft/v3/raftpb/raft.pb.go +++ b/vendor/go.etcd.io/etcd/raft/v3/raftpb/raft.pb.go @@ -22,7 +22,7 @@ var _ = math.Inf // is compatible with the proto package it is being compiled against. // A compilation error at this line likely means your copy of the // proto package needs to be updated. -const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package +const _ = proto.ProtoPackageIsVersion3 // upgrade the proto package type EntryType int32 diff --git a/vendor/go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp/client.go b/vendor/go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp/client.go index 92b8cf73c975..e3bdbab6f831 100644 --- a/vendor/go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp/client.go +++ b/vendor/go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp/client.go @@ -23,7 +23,7 @@ import ( ) // DefaultClient is the default Client and is used by Get, Head, Post and PostForm. -// Please be careful of intitialization order - for example, if you change +// Be careful of intitialization order - for example, if you change // the global propagator, the DefaultClient might still be using the old one. var DefaultClient = &http.Client{Transport: NewTransport(http.DefaultTransport)} diff --git a/vendor/go.opentelemetry.io/otel/CHANGELOG.md b/vendor/go.opentelemetry.io/otel/CHANGELOG.md index 24874f856e35..d7dab583be44 100644 --- a/vendor/go.opentelemetry.io/otel/CHANGELOG.md +++ b/vendor/go.opentelemetry.io/otel/CHANGELOG.md @@ -804,7 +804,7 @@ The next release will require at least [Go 1.19]. ### Changed - The metric SDK in `go.opentelemetry.io/otel/sdk/metric` is completely refactored to comply with the OpenTelemetry specification. - Please see the package documentation for how the new SDK is initialized and configured. (#3175) + See the package documentation for how the new SDK is initialized and configured. (#3175) - Update the minimum supported go version to go1.18. Removes support for go1.17 (#3179) ### Removed diff --git a/vendor/go.opentelemetry.io/otel/CONTRIBUTING.md b/vendor/go.opentelemetry.io/otel/CONTRIBUTING.md index 850606ae6924..48bf32a5b2fe 100644 --- a/vendor/go.opentelemetry.io/otel/CONTRIBUTING.md +++ b/vendor/go.opentelemetry.io/otel/CONTRIBUTING.md @@ -96,7 +96,7 @@ All pull requests are squashed to a single commit upon merge to `main`. ### How to Receive Comments -* If the PR is not ready for review, please put `[WIP]` in the title, +* If the PR is not ready for review, put `[WIP]` in the title, tag it as `work-in-progress`, or mark it as [`draft`](https://github.blog/2019-02-14-introducing-draft-pull-requests/). * Make sure CLA is signed and CI is clear. @@ -245,7 +245,7 @@ type config struct { In general the `config` type will not need to be used externally to the package and should be unexported. If, however, it is expected that the user will likely want to build custom options for the configuration, the `config` -should be exported. Please, include in the documentation for the `config` +should be exported. Include in the documentation for the `config` how the user can extend the configuration. It is important that internal `config` are not shared across package boundaries. diff --git a/vendor/go.opentelemetry.io/otel/sdk/instrumentation/library.go b/vendor/go.opentelemetry.io/otel/sdk/instrumentation/library.go index 39f025a1715b..205f6d2bf3ad 100644 --- a/vendor/go.opentelemetry.io/otel/sdk/instrumentation/library.go +++ b/vendor/go.opentelemetry.io/otel/sdk/instrumentation/library.go @@ -15,5 +15,5 @@ package instrumentation // import "go.opentelemetry.io/otel/sdk/instrumentation" // Library represents the instrumentation library. -// Deprecated: please use Scope instead. +// Deprecated: use Scope instead. type Library = Scope diff --git a/vendor/go.opentelemetry.io/otel/sdk/resource/config.go b/vendor/go.opentelemetry.io/otel/sdk/resource/config.go index f263919f6ec0..337fc25f8d4a 100644 --- a/vendor/go.opentelemetry.io/otel/sdk/resource/config.go +++ b/vendor/go.opentelemetry.io/otel/sdk/resource/config.go @@ -200,7 +200,7 @@ func WithContainer() Option { // WithContainerID adds an attribute with the id of the container to the configured Resource. // Note: WithContainerID will not extract the correct container ID in an ECS environment. -// Please use the ECS resource detector instead (https://pkg.go.dev/go.opentelemetry.io/contrib/detectors/aws/ecs). +// Use the ECS resource detector instead (https://pkg.go.dev/go.opentelemetry.io/contrib/detectors/aws/ecs). func WithContainerID() Option { return WithDetectors(cgroupContainerIDDetector{}) } diff --git a/vendor/go.opentelemetry.io/otel/sdk/trace/span.go b/vendor/go.opentelemetry.io/otel/sdk/trace/span.go index 36dbf67764b9..4e7cb70ce1b3 100644 --- a/vendor/go.opentelemetry.io/otel/sdk/trace/span.go +++ b/vendor/go.opentelemetry.io/otel/sdk/trace/span.go @@ -71,7 +71,7 @@ type ReadOnlySpan interface { InstrumentationScope() instrumentation.Scope // InstrumentationLibrary returns information about the instrumentation // library that created the span. - // Deprecated: please use InstrumentationScope instead. + // Deprecated: use InstrumentationScope instead. InstrumentationLibrary() instrumentation.Library // Resource returns information about the entity that produced the span. Resource() *resource.Resource diff --git a/vendor/go.opentelemetry.io/proto/otlp/collector/metrics/v1/metrics_service_grpc.pb.go b/vendor/go.opentelemetry.io/proto/otlp/collector/metrics/v1/metrics_service_grpc.pb.go index 31d25fc15ac6..f389109a32a8 100644 --- a/vendor/go.opentelemetry.io/proto/otlp/collector/metrics/v1/metrics_service_grpc.pb.go +++ b/vendor/go.opentelemetry.io/proto/otlp/collector/metrics/v1/metrics_service_grpc.pb.go @@ -20,7 +20,7 @@ const _ = grpc.SupportPackageIsVersion7 // MetricsServiceClient is the client API for MetricsService service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream. type MetricsServiceClient interface { // For performance reasons, it is recommended to keep this RPC // alive for the entire life of the application. diff --git a/vendor/go.opentelemetry.io/proto/otlp/collector/trace/v1/trace_service_grpc.pb.go b/vendor/go.opentelemetry.io/proto/otlp/collector/trace/v1/trace_service_grpc.pb.go index dd1b73f1e997..b26fe6ee5479 100644 --- a/vendor/go.opentelemetry.io/proto/otlp/collector/trace/v1/trace_service_grpc.pb.go +++ b/vendor/go.opentelemetry.io/proto/otlp/collector/trace/v1/trace_service_grpc.pb.go @@ -20,7 +20,7 @@ const _ = grpc.SupportPackageIsVersion7 // TraceServiceClient is the client API for TraceService service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream. type TraceServiceClient interface { // For performance reasons, it is recommended to keep this RPC // alive for the entire life of the application. diff --git a/vendor/golang.org/x/sys/unix/README.md b/vendor/golang.org/x/sys/unix/README.md index 7d3c060e1221..0b06ea04ef8e 100644 --- a/vendor/golang.org/x/sys/unix/README.md +++ b/vendor/golang.org/x/sys/unix/README.md @@ -11,7 +11,7 @@ however, there are tools that automate much of the process. There are currently two ways we generate the necessary files. We are currently migrating the build system to use containers so the builds are reproducible. -This is being done on an OS-by-OS basis. Please update this documentation as +This is being done on an OS-by-OS basis. Update this documentation as components of the build system change. ### Old Build System (currently for `GOOS != "linux"`) diff --git a/vendor/golang.org/x/term/CONTRIBUTING.md b/vendor/golang.org/x/term/CONTRIBUTING.md index d0485e887a2b..429e03c8af7c 100644 --- a/vendor/golang.org/x/term/CONTRIBUTING.md +++ b/vendor/golang.org/x/term/CONTRIBUTING.md @@ -19,7 +19,7 @@ The gophers there will answer or ask you to file an issue if you've tripped over ## Contributing code -Please read the [Contribution Guidelines](https://golang.org/doc/contribute.html) +Read the [Contribution Guidelines](https://golang.org/doc/contribute.html) before sending patches. Unless otherwise noted, the Go source files are distributed under diff --git a/vendor/golang.org/x/tools/go/packages/packages.go b/vendor/golang.org/x/tools/go/packages/packages.go index bd79efc1aaf0..b0c6efa4cff5 100644 --- a/vendor/golang.org/x/tools/go/packages/packages.go +++ b/vendor/golang.org/x/tools/go/packages/packages.go @@ -96,23 +96,23 @@ const ( const ( // Deprecated: LoadFiles exists for historical compatibility - // and should not be used. Please directly specify the needed fields using the Need values. + // and should not be used. Directly specify the needed fields using the Need values. LoadFiles = NeedName | NeedFiles | NeedCompiledGoFiles // Deprecated: LoadImports exists for historical compatibility - // and should not be used. Please directly specify the needed fields using the Need values. + // and should not be used. Directly specify the needed fields using the Need values. LoadImports = LoadFiles | NeedImports // Deprecated: LoadTypes exists for historical compatibility - // and should not be used. Please directly specify the needed fields using the Need values. + // and should not be used. Directly specify the needed fields using the Need values. LoadTypes = LoadImports | NeedTypes | NeedTypesSizes // Deprecated: LoadSyntax exists for historical compatibility - // and should not be used. Please directly specify the needed fields using the Need values. + // and should not be used. Directly specify the needed fields using the Need values. LoadSyntax = LoadTypes | NeedSyntax | NeedTypesInfo // Deprecated: LoadAllSyntax exists for historical compatibility - // and should not be used. Please directly specify the needed fields using the Need values. + // and should not be used. Directly specify the needed fields using the Need values. LoadAllSyntax = LoadSyntax | NeedDeps // Deprecated: NeedExportsFile is a historical misspelling of NeedExportFile. @@ -955,7 +955,7 @@ func (ld *loader) loadPackage(lpkg *loaderPackage) { Kind: UnknownError, }) - // If you see this error message, please file a bug. + // If you see this error message, file a bug. log.Printf("internal error: error %q (%T) without position", err, err) } diff --git a/vendor/golang.org/x/tools/internal/gcimporter/iimport.go b/vendor/golang.org/x/tools/internal/gcimporter/iimport.go index 8e64cf644fce..6aafc61d0248 100644 --- a/vendor/golang.org/x/tools/internal/gcimporter/iimport.go +++ b/vendor/golang.org/x/tools/internal/gcimporter/iimport.go @@ -148,7 +148,7 @@ func iimportCommon(fset *token.FileSet, getPackages GetPackagesFunc, data []byte } else if version > currentVersion { err = fmt.Errorf("cannot import %q (%v), export data is newer version - update tool", path, e) } else { - err = fmt.Errorf("internal error while importing %q (%v); please report an issue", path, e) + err = fmt.Errorf("internal error while importing %q (%v); report an issue", path, e) } } }() diff --git a/vendor/golang.org/x/tools/internal/gcimporter/ureader_yes.go b/vendor/golang.org/x/tools/internal/gcimporter/ureader_yes.go index b977435f626d..6de6c90ed89f 100644 --- a/vendor/golang.org/x/tools/internal/gcimporter/ureader_yes.go +++ b/vendor/golang.org/x/tools/internal/gcimporter/ureader_yes.go @@ -67,7 +67,7 @@ func UImportData(fset *token.FileSet, imports map[string]*types.Package, data [] if !debug { defer func() { if x := recover(); x != nil { - err = fmt.Errorf("internal error in importing %q (%v); please report an issue", path, x) + err = fmt.Errorf("internal error in importing %q (%v); report an issue", path, x) } }() } diff --git a/vendor/google.golang.org/grpc/CONTRIBUTING.md b/vendor/google.golang.org/grpc/CONTRIBUTING.md index 608aa6e1ac5e..ffb1b17ba25a 100644 --- a/vendor/google.golang.org/grpc/CONTRIBUTING.md +++ b/vendor/google.golang.org/grpc/CONTRIBUTING.md @@ -1,10 +1,10 @@ # How to contribute -We definitely welcome your patches and contributions to gRPC! Please read the gRPC +We definitely welcome your patches and contributions to gRPC! Read the gRPC organization's [governance rules](https://github.com/grpc/grpc-community/blob/master/governance.md) and [contribution guidelines](https://github.com/grpc/grpc-community/blob/master/CONTRIBUTING.md) before proceeding. -If you are new to github, please start by reading [Pull Request howto](https://help.github.com/articles/about-pull-requests/) +If you are new to github, start by reading [Pull Request howto](https://help.github.com/articles/about-pull-requests/) ## Legal requirements @@ -44,7 +44,7 @@ How to get your contributions merged smoothly and quickly. - If you want to fix formatting or style, consider whether your changes are an obvious improvement or might be considered a personal preference. If a style change is based on preference, it likely will not be accepted. If it corrects - widely agreed-upon anti-patterns, then please do create a PR and explain the + widely agreed-upon anti-patterns, then do create a PR and explain the benefits of the change. - Unless your PR is trivial, you should expect there will be reviewer comments diff --git a/vendor/google.golang.org/grpc/MAINTAINERS.md b/vendor/google.golang.org/grpc/MAINTAINERS.md index c6672c0a3efe..9dc535c6753c 100644 --- a/vendor/google.golang.org/grpc/MAINTAINERS.md +++ b/vendor/google.golang.org/grpc/MAINTAINERS.md @@ -1,5 +1,5 @@ This page lists all active maintainers of this repository. If you were a -maintainer and would like to add your name to the Emeritus list, please send us a +maintainer and would like to add your name to the Emeritus list, send us a PR. See [GOVERNANCE.md](https://github.com/grpc/grpc-community/blob/master/governance.md) diff --git a/vendor/google.golang.org/grpc/README.md b/vendor/google.golang.org/grpc/README.md index ab0fbb79b863..29a1d4317eed 100644 --- a/vendor/google.golang.org/grpc/README.md +++ b/vendor/google.golang.org/grpc/README.md @@ -65,7 +65,7 @@ To build Go code, there are several options: ### Compiling error, undefined: grpc.SupportPackageIsVersion -Please update to the latest version of gRPC-Go using +Update to the latest version of gRPC-Go using `go get google.golang.org/grpc`. ### How to turn on logging diff --git a/vendor/google.golang.org/grpc/SECURITY.md b/vendor/google.golang.org/grpc/SECURITY.md index be6e108705c4..260bf64195ef 100644 --- a/vendor/google.golang.org/grpc/SECURITY.md +++ b/vendor/google.golang.org/grpc/SECURITY.md @@ -1,3 +1,3 @@ # Security Policy -For information on gRPC Security Policy and reporting potentional security issues, please see [gRPC CVE Process](https://github.com/grpc/proposal/blob/master/P4-grpc-cve-process.md). +For information on gRPC Security Policy and reporting potentional security issues, see [gRPC CVE Process](https://github.com/grpc/proposal/blob/master/P4-grpc-cve-process.md). diff --git a/vendor/google.golang.org/grpc/balancer/balancer.go b/vendor/google.golang.org/grpc/balancer/balancer.go index d79560a2e268..a3c0943753f9 100644 --- a/vendor/google.golang.org/grpc/balancer/balancer.go +++ b/vendor/google.golang.org/grpc/balancer/balancer.go @@ -178,7 +178,7 @@ type ClientConn interface { // It doesn't block and wait for the connections to be established. // Behaviors of the SubConn can be controlled by options. // - // Deprecated: please be aware that in a future version, SubConns will only + // Deprecated: be aware that in a future version, SubConns will only // support one address per SubConn. NewSubConn([]resolver.Address, NewSubConnOptions) (SubConn, error) // RemoveSubConn removes the SubConn from ClientConn. diff --git a/vendor/google.golang.org/grpc/codegen.sh b/vendor/google.golang.org/grpc/codegen.sh index 4cdc6ba7c090..be362fae005b 100644 --- a/vendor/google.golang.org/grpc/codegen.sh +++ b/vendor/google.golang.org/grpc/codegen.sh @@ -6,7 +6,7 @@ # It assumes the installation of i) Google proto buffer compiler at # https://github.com/google/protobuf (after v2.6.1) and ii) the Go codegen # plugin at https://github.com/golang/protobuf (after 2015-02-20). If you have -# not, please install them first. +# not, install them first. # # We recommend running this script at $GOPATH/src. # diff --git a/vendor/google.golang.org/grpc/credentials/credentials.go b/vendor/google.golang.org/grpc/credentials/credentials.go index 5feac3aa0e41..c480224d81de 100644 --- a/vendor/google.golang.org/grpc/credentials/credentials.go +++ b/vendor/google.golang.org/grpc/credentials/credentials.go @@ -107,7 +107,7 @@ type ProtocolInfo struct { // credentials, not a value that reflects per-connection protocol negotiation. To retrieve // details about the credentials used for a connection, use the Peer's AuthInfo field instead. // - // Deprecated: please use Peer.AuthInfo. + // Deprecated: use Peer.AuthInfo. SecurityVersion string // ServerName is the user-configured server name. ServerName string diff --git a/vendor/google.golang.org/grpc/dialoptions.go b/vendor/google.golang.org/grpc/dialoptions.go index ba2426180402..6febd22966fc 100644 --- a/vendor/google.golang.org/grpc/dialoptions.go +++ b/vendor/google.golang.org/grpc/dialoptions.go @@ -299,7 +299,7 @@ func withBackoff(bs internalbackoff.Strategy) DialOption { // underlying connection is up. Without this, Dial returns immediately and // connecting the server happens in background. // -// Use of this feature is not recommended. For more information, please see: +// Use of this feature is not recommended. For more information, see: // https://github.com/grpc/grpc-go/blob/master/Documentation/anti-patterns.md func WithBlock() DialOption { return newFuncDialOption(func(o *dialOptions) { @@ -312,7 +312,7 @@ func WithBlock() DialOption { // the context.DeadlineExceeded error. // Implies WithBlock() // -// Use of this feature is not recommended. For more information, please see: +// Use of this feature is not recommended. For more information, see: // https://github.com/grpc/grpc-go/blob/master/Documentation/anti-patterns.md // // # Experimental @@ -408,7 +408,7 @@ func WithTimeout(d time.Duration) DialOption { // option to true from the Control field. For a concrete example of how to do // this, see internal.NetDialerWithTCPKeepalive(). // -// For more information, please see [issue 23459] in the Go github repo. +// For more information, see [issue 23459] in the Go github repo. // // [issue 23459]: https://github.com/golang/go/issues/23459 func WithContextDialer(f func(context.Context, string) (net.Conn, error)) DialOption { @@ -468,7 +468,7 @@ func withBinaryLogger(bl binarylog.Logger) DialOption { // FailOnNonTempDialError only affects the initial dial, and does not do // anything useful unless you are also using WithBlock(). // -// Use of this feature is not recommended. For more information, please see: +// Use of this feature is not recommended. For more information, see: // https://github.com/grpc/grpc-go/blob/master/Documentation/anti-patterns.md // // # Experimental diff --git a/vendor/google.golang.org/grpc/health/grpc_health_v1/health_grpc.pb.go b/vendor/google.golang.org/grpc/health/grpc_health_v1/health_grpc.pb.go index 4439cda0f3cb..dd260ffa89c3 100644 --- a/vendor/google.golang.org/grpc/health/grpc_health_v1/health_grpc.pb.go +++ b/vendor/google.golang.org/grpc/health/grpc_health_v1/health_grpc.pb.go @@ -42,7 +42,7 @@ const ( // HealthClient is the client API for Health service. // -// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream. +// For semantics around ctx use and closing/ending streaming RPCs, refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream. type HealthClient interface { // Check gets the health of the specified service. If the requested service // is unknown, the call will fail with status NOT_FOUND. If the caller does diff --git a/vendor/google.golang.org/grpc/metadata/metadata.go b/vendor/google.golang.org/grpc/metadata/metadata.go index 49446825763b..852eae47931c 100644 --- a/vendor/google.golang.org/grpc/metadata/metadata.go +++ b/vendor/google.golang.org/grpc/metadata/metadata.go @@ -17,7 +17,7 @@ */ // Package metadata define the structure of the metadata supported by gRPC library. -// Please refer to https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md +// refer to https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md // for more information about custom-metadata. package metadata // import "google.golang.org/grpc/metadata" @@ -168,7 +168,7 @@ func NewOutgoingContext(ctx context.Context, md MD) context.Context { } // AppendToOutgoingContext returns a new context with the provided kv merged -// with any existing metadata in the context. Please refer to the documentation +// with any existing metadata in the context. refer to the documentation // of Pairs for a description of kv. func AppendToOutgoingContext(ctx context.Context, kv ...string) context.Context { if len(kv)%2 == 1 { diff --git a/vendor/google.golang.org/grpc/rpc_util.go b/vendor/google.golang.org/grpc/rpc_util.go index b7723aa09cbb..266c5cb7060e 100644 --- a/vendor/google.golang.org/grpc/rpc_util.go +++ b/vendor/google.golang.org/grpc/rpc_util.go @@ -264,7 +264,7 @@ func (o PeerCallOption) after(c *callInfo, attempt *csAttempt) { // connection is available (or the call is canceled or times out) and will // retry the call if it fails due to a transient error. gRPC will not retry if // data was written to the wire unless the server indicates it did not process -// the data. Please refer to +// the data. Rrefer to // https://github.com/grpc/grpc/blob/master/doc/wait-for-ready.md. // // By default, RPCs don't "wait for ready". diff --git a/vendor/google.golang.org/grpc/tap/tap.go b/vendor/google.golang.org/grpc/tap/tap.go index 07f012576880..07f3febb314f 100644 --- a/vendor/google.golang.org/grpc/tap/tap.go +++ b/vendor/google.golang.org/grpc/tap/tap.go @@ -52,7 +52,7 @@ type Info struct { // // It's intended to be used in situations where you don't want to waste the // resources to accept the new stream (e.g. rate-limiting). For other general -// usages, please use interceptors. +// usages, use interceptors. // // Note that it is executed in the per-connection I/O goroutine(s) instead of // per-RPC goroutine. Therefore, users should NOT have any diff --git a/vendor/google.golang.org/grpc/vet.sh b/vendor/google.golang.org/grpc/vet.sh index 896dc38f5063..0c9dbd0b983f 100644 --- a/vendor/google.golang.org/grpc/vet.sh +++ b/vendor/google.golang.org/grpc/vet.sh @@ -49,7 +49,7 @@ if [[ "$1" = "-install" ]]; then bin/protoc --version popd elif not which protoc > /dev/null; then - die "Please install protoc into your path" + die "install protoc into your path" fi fi exit 0 @@ -130,7 +130,7 @@ grep -v "(ST1000)" "${SC_OUT}" | grep -v "(SA1019)" | grep -v "(ST1003)" | not g grep "(ST1003)" "${SC_OUT}" | not grep -v '\(.pb.go:\)\|\(code_string_test.go:\)' # Error for duplicate imports not including grpc protos. -grep "(ST1019)\|\(other import of\)" "${SC_OUT}" | not grep -Fv 'XXXXX PleaseIgnoreUnused +grep "(ST1019)\|\(other import of\)" "${SC_OUT}" | not grep -Fv 'XXXXX IgnoreUnused channelz/grpc_channelz_v1" go-control-plane/envoy grpclb/grpc_lb_v1" @@ -141,14 +141,14 @@ proto/grpc_gcp" proto/grpc_lookup_v1" reflection/grpc_reflection_v1" reflection/grpc_reflection_v1alpha" -XXXXX PleaseIgnoreUnused' +XXXXX IgnoreUnused' # Error for any package comments not in generated code. grep "(ST1000)" "${SC_OUT}" | not grep -v "\.pb\.go:" # Only ignore the following deprecated types/fields/functions and exclude # generated code. -grep "(SA1019)" "${SC_OUT}" | not grep -Fv 'XXXXX PleaseIgnoreUnused +grep "(SA1019)" "${SC_OUT}" | not grep -Fv 'XXXXX IgnoreUnused XXXXX Protobuf related deprecation errors: "github.com/golang/protobuf .pb.go: @@ -187,6 +187,6 @@ GetValidationContextCertificateProviderInstance XXXXX TODO: Remove the below deprecation usages: CloseNotifier Roots.Subjects -XXXXX PleaseIgnoreUnused' +XXXXX IgnoreUnused' echo SUCCESS diff --git a/vendor/gopkg.in/yaml.v2/README.md b/vendor/gopkg.in/yaml.v2/README.md index b50c6e877559..d795f98d6328 100644 --- a/vendor/gopkg.in/yaml.v2/README.md +++ b/vendor/gopkg.in/yaml.v2/README.md @@ -42,7 +42,7 @@ The package API for yaml v2 will remain stable as described in [gopkg.in](https: License ------- -The yaml package is licensed under the Apache License 2.0. Please see the LICENSE file for details. +The yaml package is licensed under the Apache License 2.0. see the LICENSE file for details. Example