From 7c23b7aa4a4e088c54f5e97a93b0e97c6c77b9e2 Mon Sep 17 00:00:00 2001 From: NeimadTL Date: Mon, 17 Mar 2025 19:29:39 -0400 Subject: [PATCH 1/3] Add possible curl issues This new part of documentation has been added in order to provide users a way to identify curl related issues which may or may not be caused by their workstation. --- docs/Common-Issues.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/Common-Issues.md b/docs/Common-Issues.md index 8871db6c5b..7175c50402 100644 --- a/docs/Common-Issues.md +++ b/docs/Common-Issues.md @@ -259,3 +259,10 @@ Help us by [submitting a fix](https://github.com/Homebrew/homebrew-cask/blob/HEA ## Other local issues If your Homebrew installation gets messed up (and fixing the issues found by `brew doctor` doesn't solve the problem), reinstalling Homebrew may help to reset to a normal state. To easily reinstall Homebrew, use [Homebrew Bundle](https://github.com/Homebrew/homebrew-bundle) to automatically restore your installed formulae and casks. To do so, run `brew bundle dump`, [uninstall](https://docs.brew.sh/FAQ#how-do-i-uninstall-homebrew), [reinstall](https://docs.brew.sh/Installation) and run `brew bundle install`. + +## Possible curl issues + +Sometimes, the user's workstation itself may be responsible for issues which therefore are outside Homebrew's control. As brew is making extensive use of `curl`, good configuration as well as good connectivity are required in order to allow brew to function correctly. Here some links that could help you identify cURL issues based on `curl`'s and `libcurl`'s exit codes: + + - https://everything.curl.dev/cmdline/exitcode.html + - https://curl.se/libcurl/c/libcurl-errors.html From e81794c96a8f2ddad263b9a678f971748cb1a14e Mon Sep 17 00:00:00 2001 From: Mike McQuaid Date: Tue, 18 Mar 2025 08:41:25 +0000 Subject: [PATCH 2/3] docs/Common-Issues: tweak wording. --- docs/Common-Issues.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/Common-Issues.md b/docs/Common-Issues.md index 7175c50402..1a7bf83b2c 100644 --- a/docs/Common-Issues.md +++ b/docs/Common-Issues.md @@ -260,9 +260,9 @@ Help us by [submitting a fix](https://github.com/Homebrew/homebrew-cask/blob/HEA If your Homebrew installation gets messed up (and fixing the issues found by `brew doctor` doesn't solve the problem), reinstalling Homebrew may help to reset to a normal state. To easily reinstall Homebrew, use [Homebrew Bundle](https://github.com/Homebrew/homebrew-bundle) to automatically restore your installed formulae and casks. To do so, run `brew bundle dump`, [uninstall](https://docs.brew.sh/FAQ#how-do-i-uninstall-homebrew), [reinstall](https://docs.brew.sh/Installation) and run `brew bundle install`. -## Possible curl issues +## Possible `curl` issues -Sometimes, the user's workstation itself may be responsible for issues which therefore are outside Homebrew's control. As brew is making extensive use of `curl`, good configuration as well as good connectivity are required in order to allow brew to function correctly. Here some links that could help you identify cURL issues based on `curl`'s and `libcurl`'s exit codes: +Sometimes, the user's computer, configuration or network connection may cause issues downloading with `curl` which are outside Homebrew's control. Homebrew requires good internet connectivity and correct configuration to function correctly. Here some links that could help you identify cURL issues based on `curl`'s and `libcurl`'s exit codes: - https://everything.curl.dev/cmdline/exitcode.html - https://curl.se/libcurl/c/libcurl-errors.html From 689fb13299817e2a13a9200ff8e8944bf86ae6b6 Mon Sep 17 00:00:00 2001 From: Mike McQuaid Date: Tue, 18 Mar 2025 08:43:51 +0000 Subject: [PATCH 3/3] docs/Common-Issues: fix style. --- docs/Common-Issues.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/Common-Issues.md b/docs/Common-Issues.md index 1a7bf83b2c..261a9c2b6c 100644 --- a/docs/Common-Issues.md +++ b/docs/Common-Issues.md @@ -264,5 +264,5 @@ If your Homebrew installation gets messed up (and fixing the issues found by `br Sometimes, the user's computer, configuration or network connection may cause issues downloading with `curl` which are outside Homebrew's control. Homebrew requires good internet connectivity and correct configuration to function correctly. Here some links that could help you identify cURL issues based on `curl`'s and `libcurl`'s exit codes: - - https://everything.curl.dev/cmdline/exitcode.html - - https://curl.se/libcurl/c/libcurl-errors.html +* https://everything.curl.dev/cmdline/exitcode.html +* https://curl.se/libcurl/c/libcurl-errors.html