From cb26c6b2242a5aef3df0c5511f58cf30b7a4787a Mon Sep 17 00:00:00 2001 From: Lucas Bremgartner Date: Thu, 25 Jan 2018 22:43:28 +0100 Subject: [PATCH 1/3] Fix broken link to Gopkg.toml.md --- docs/daily-dep.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/daily-dep.md b/docs/daily-dep.md index faf22617cd..6108050f20 100644 --- a/docs/daily-dep.md +++ b/docs/daily-dep.md @@ -101,7 +101,7 @@ Only if it is the first/last import of a project being added/removed - cases 3 a ### Rule changes in `Gopkg.toml` -`Gopkg.toml` files contain five basic types of rules. The [`Gopkg.toml` docs](#gopkg.toml.md) explain them in detail, but here's an overview: +`Gopkg.toml` files contain five basic types of rules. The [`Gopkg.toml` docs](gopkg.toml.md) explain them in detail, but here's an overview: * `required`, which are mostly equivalent to `import` statements in `.go` files, except that it's OK to list a `main` package here * `ignored`, which causes dep to black hole an import path (and any imports it uniquely introduces) From 453affdba296268230e35d796d3fd8fa6d948dec Mon Sep 17 00:00:00 2001 From: sam boyer Date: Thu, 25 Jan 2018 23:00:14 -0500 Subject: [PATCH 2/3] docs: Add missing link to hang failure docs --- docs/failure-modes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/failure-modes.md b/docs/failure-modes.md index f06acca0a7..16abc942f2 100644 --- a/docs/failure-modes.md +++ b/docs/failure-modes.md @@ -55,7 +55,7 @@ The exact error text will vary depending on which of the operations is running, Almost any case where a dep command, run with `-v`, hangs for more than ten minutes will ultimately be a bug. However, the most common explanation for an apparent dep hangs is actually normal behavior: because dep's operation requires that it keep its own copies of upstream sources hidden away in the [local cache](glossary.md#local-cache), the first run of dep against a project, especially large projects, can take a long time while it populates the cache. -The only known case where dep may hang indefinitely is if one of the underlying VCS binaries it calls is prompting for some kind of input. Typically this means credentials (though not always - make sure to accept remote hosts' SSH keys into your known hosts!), and dep's normal assumption is that necessary credentials have been provided via environmental mechanisms - [configuration files or daemons](FAQ.md#how-do-i-get-dep-to-authenticate-to-a-git-repo), SSH agents, etc. This assumption is necessary for dep's concurrent network activity to work. If your use case absolutely cannot support the use of any such environmental caching mechanism, [please weigh in on this issue](). +The only known case where dep may hang indefinitely is if one of the underlying VCS binaries it calls is prompting for some kind of input. Typically this means credentials (though not always - make sure to accept remote hosts' SSH keys into your known hosts!), and dep's normal assumption is that necessary credentials have been provided via environmental mechanisms - [configuration files or daemons](FAQ.md#how-do-i-get-dep-to-authenticate-to-a-git-repo), SSH agents, etc. This assumption is necessary for dep's concurrent network activity to work. If your use case absolutely cannot support the use of any such environmental caching mechanism, [please weigh in on this issue](https://github.com/golang/dep/issues/1476). Unfortunately, until dep [improves the observability of its ongoing I/O operations](), it cannot accurately report to the user which operations are actually underway at any given moment. This can make it difficult to differentiate from other hangs - credentials prompts, long network timeouts induced by firewalls, sluggish TCP when faced with packet loss, etc. From 2eb24b72e8ef0b39ce48bd91289227ec1693dc15 Mon Sep 17 00:00:00 2001 From: Kashav Madan Date: Thu, 25 Jan 2018 23:43:07 -0500 Subject: [PATCH 3/3] Fix formatting of issue references in v0.4.0 notes --- CHANGELOG.md | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3b4e61b0d6..2b741b3bab 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -16,34 +16,34 @@ BUG FIXES: NEW FEATURES: * Absorb `dep prune` into `dep ensure`. ([#944](https://github.com/golang/dep/issues/944)) -* Add support for importing from [glock](https://github.com/robfig/glock) based projects. ([#1422](https://github.com/golang/dep/pull/1422) -* Add support for importing from [govendor](https://github.com/kardianos/govendor) based projects. ([#815](https://github.com/golang/dep/pull/815) +* Add support for importing from [glock](https://github.com/robfig/glock) based projects. ([#1422](https://github.com/golang/dep/pull/1422)) +* Add support for importing from [govendor](https://github.com/kardianos/govendor) based projects. ([#815](https://github.com/golang/dep/pull/815)) * Allow override of cache directory location using environment variable `DEPCACHEDIR`. ([#1234](https://github.com/golang/dep/pull/1234)) -* Add support for template output in `dep status`. ([#1389](https://github.com/golang/dep/pull/1389) -* Each element in a multi-item TOML array is output on its own line. ([#1461](https://github.com/golang/dep/pull/1461) +* Add support for template output in `dep status`. ([#1389](https://github.com/golang/dep/pull/1389)) +* Each element in a multi-item TOML array is output on its own line. ([#1461](https://github.com/golang/dep/pull/1461)) BUG FIXES: -* Releases targeting Windows now have a `.exe` suffix. ([#1291](https://github.com/golang/dep/pull/1291) -* Adaptively recover from dirty and corrupted git repositories in cache. ([#1279](https://github.com/golang/dep/pull/1279) -* Suppress git password prompts in more places. ([#1357](https://github.com/golang/dep/pull/1357) -* Fix `-no-vendor` flag for `ensure -update`. ([#1361](https://github.com/golang/dep/pull/1361) -* Validate `git ls-remote` output and ignore all malformed lines. ([#1379](https://github.com/golang/dep/pull/1379) -* Support [gopkg.in version zero](http://labix.org/gopkg.in#VersionZero). ([#1243](https://github.com/golang/dep/pull/1243) -* Fix how dep status print revision constraints. ([#1421](https://github.com/golang/dep/pull/1421) -* Add optional `-v` flag to ensure sub command's syntax. ([#1458](https://github.com/golang/dep/pull/1458) -* Allow URLs containing ports in `Gopkg.toml` `source` fields. ([#1509](https://github.com/golang/dep/pull/1509) +* Releases targeting Windows now have a `.exe` suffix. ([#1291](https://github.com/golang/dep/pull/1291)) +* Adaptively recover from dirty and corrupted git repositories in cache. ([#1279](https://github.com/golang/dep/pull/1279)) +* Suppress git password prompts in more places. ([#1357](https://github.com/golang/dep/pull/1357)) +* Fix `-no-vendor` flag for `ensure -update`. ([#1361](https://github.com/golang/dep/pull/1361)) +* Validate `git ls-remote` output and ignore all malformed lines. ([#1379](https://github.com/golang/dep/pull/1379)) +* Support [gopkg.in version zero](http://labix.org/gopkg.in#VersionZero). ([#1243](https://github.com/golang/dep/pull/1243)) +* Fix how dep status print revision constraints. ([#1421](https://github.com/golang/dep/pull/1421)) +* Add optional `-v` flag to ensure sub command's syntax. ([#1458](https://github.com/golang/dep/pull/1458)) +* Allow URLs containing ports in `Gopkg.toml` `source` fields. ([#1509](https://github.com/golang/dep/pull/1509)) IMPROVEMENTS: * Log as dependencies are pre-fetched during dep init. ([#1176](https://github.com/golang/dep/pull/1176)) * Make the gps package importable. ([#1349](https://github.com/golang/dep/pull/1349)) -* Improve file copy performance by not forcing a file sync. ([#1408](https://github.com/golang/dep/pull/1408) +* Improve file copy performance by not forcing a file sync. ([#1408](https://github.com/golang/dep/pull/1408)) * Skip empty constraints during import. ([#1414](https://github.com/golang/dep/pull/1349)) * Handle errors when writing status output. ([#1420](https://github.com/golang/dep/pull/1420)) -* Add constraint for locked projects in `dep status`. ([#962](https://github.com/golang/dep/pull/962) +* Add constraint for locked projects in `dep status`. ([#962](https://github.com/golang/dep/pull/962)) * Make external config importers error tolerant. ([#1315](https://github.com/golang/dep/pull/1315)) -* Show LATEST and VERSION as the same type in status. ([#1515](https://github.com/golang/dep/pull/1515) +* Show LATEST and VERSION as the same type in status. ([#1515](https://github.com/golang/dep/pull/1515)) * Warn when [[constraint]] rules that will have no effect. ([#1534](https://github.com/golang/dep/pull/1534)) # v0.3.2