tools.linux.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH 1/2] man: Update man page to mention HTTPS_PROXY
@ 2022-01-18 21:08 David Vernet
  2022-01-18 21:08 ` [PATCH 2/2] man: Update man page to use bold where appropriate David Vernet
  2022-02-18 15:31 ` [PATCH 1/2] man: Update man page to mention HTTPS_PROXY David Vernet
  0 siblings, 2 replies; 4+ messages in thread
From: David Vernet @ 2022-01-18 21:08 UTC (permalink / raw)
  To: konstantin; +Cc: users, tools, void, kernel-team

Certain b4 commands may send requests to https://lore.kernel.org, such
as to fetch a thread of patches as an mbox file. b4 internally uses the
python-requests library to perform these requests, and thus the requests
may be proxied by setting the HTTPS_PROXY environment variable.

The fact that b4 uses the python-requests library is an implementation
detail, so this diff adds a small 'PROXYING REQUESTS' section to the man
page that informs the user that they may use the HTTPS_PROXY environment
variable to enable proxying.

Link: https://lore.kernel.org/all/20220118174144.2445150-1-void@manifault.com/
Signed-off-by: David Vernet <void@manifault.com>
---
 man/b4.5.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/man/b4.5.rst b/man/b4.5.rst
index 19e96af..ab12804 100644
--- a/man/b4.5.rst
+++ b/man/b4.5.rst
@@ -321,6 +321,12 @@ Default configuration, with explanations::
       # Used when preparing merge messages from cover letters. See shazam-merge-template.example
       shazam-merge-template = None
 
+PROXYING REQUESTS
+-----------------
+Commands making requests to lore may be configured to proxy those requests
+by setting the **HTTPS_PROXY** environment variable, as described in
+https://docs.python-requests.org/en/latest/user/advanced/#proxies.
+
 SUPPORT
 -------
 Please email tools@linux.kernel.org with support requests,
-- 
2.30.2


^ permalink raw reply related	[flat|nested] 4+ messages in thread

* [PATCH 2/2] man: Update man page to use bold where appropriate
  2022-01-18 21:08 [PATCH 1/2] man: Update man page to mention HTTPS_PROXY David Vernet
@ 2022-01-18 21:08 ` David Vernet
  2022-02-18 15:31 ` [PATCH 1/2] man: Update man page to mention HTTPS_PROXY David Vernet
  1 sibling, 0 replies; 4+ messages in thread
From: David Vernet @ 2022-01-18 21:08 UTC (permalink / raw)
  To: konstantin; +Cc: users, tools, void, kernel-team

According to https://man7.org/linux/man-pages/man1/man.1.html, when writing
a man page for a program, anything that should be typed exactly as shown
should use bolded text. The b4 man page has a SUBCOMMANDS section where
subcommands are listed as 'b4 <subcommand>', in italics. So as to match the
guidance for man pages (as well as to match the examples provided at the
link above), this diff updates the 'b4' portion of the aforementioned
subcommand section to be bolded.

Signed-off-by: David Vernet <void@manifault.com>
---
 man/b4.5.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/man/b4.5.rst b/man/b4.5.rst
index ab12804..b45909a 100644
--- a/man/b4.5.rst
+++ b/man/b4.5.rst
@@ -27,14 +27,14 @@ precursor to Lore and Data in the Star Trek universe.
 
 SUBCOMMANDS
 -----------
-* *b4 mbox*: Download a thread as an mbox file
-* *b4 am*: Create an mbox file that is ready to git-am
-* *b4 shazam*: Similar to *am*, but lets you apply patches directly
-* *b4 pr*: Work with pull requests
-* *b4 diff*: Show range-diff style diffs between patch versions
-* *b4 ty*: Create templated replies for processed patches and pull requests
-* *b4 attest*: (EXPERIMENTAL) Add cryptographic attestation to patches
-* *b4 kr* (EXPERIMENTAL) Operate on patatt-compatible keyrings
+* **b4** *mbox*: Download a thread as an mbox file
+* **b4** *am*: Create an mbox file that is ready to git-am
+* **b4** *shazam*: Similar to *am*, but lets you apply patches directly
+* **b4** *pr*: Work with pull requests
+* **b4** *diff*: Show range-diff style diffs between patch versions
+* **b4** *ty*: Create templated replies for processed patches and pull requests
+* **b4** *attest*: (EXPERIMENTAL) Add cryptographic attestation to patches
+* **b4** *kr* (EXPERIMENTAL) Operate on patatt-compatible keyrings
 
 OPTIONS
 -------
-- 
2.30.2


^ permalink raw reply related	[flat|nested] 4+ messages in thread

* [PATCH 1/2] man: Update man page to mention HTTPS_PROXY
  2022-01-18 21:08 [PATCH 1/2] man: Update man page to mention HTTPS_PROXY David Vernet
  2022-01-18 21:08 ` [PATCH 2/2] man: Update man page to use bold where appropriate David Vernet
@ 2022-02-18 15:31 ` David Vernet
  2022-02-18 15:31   ` [PATCH 2/2] man: Update man page to use bold where appropriate David Vernet
  1 sibling, 1 reply; 4+ messages in thread
From: David Vernet @ 2022-02-18 15:31 UTC (permalink / raw)
  To: konstantin; +Cc: users, tools, void, kernel-team

Certain b4 commands may send requests to https://lore.kernel.org, such
as to fetch a thread of patches as an mbox file. b4 internally uses the
python-requests library to perform these requests, and thus the requests
may be proxied by setting the HTTPS_PROXY environment variable.

The fact that b4 uses the python-requests library is an implementation
detail, so this diff adds a small 'PROXYING REQUESTS' section to the man
page that informs the user that they may use the HTTPS_PROXY environment
variable to enable proxying.

Link: https://lore.kernel.org/all/20220118174144.2445150-1-void@manifault.com/
Signed-off-by: David Vernet <void@manifault.com>
---
 man/b4.5.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/man/b4.5.rst b/man/b4.5.rst
index 19e96af..ab12804 100644
--- a/man/b4.5.rst
+++ b/man/b4.5.rst
@@ -321,6 +321,12 @@ Default configuration, with explanations::
       # Used when preparing merge messages from cover letters. See shazam-merge-template.example
       shazam-merge-template = None
 
+PROXYING REQUESTS
+-----------------
+Commands making requests to lore may be configured to proxy those requests
+by setting the **HTTPS_PROXY** environment variable, as described in
+https://docs.python-requests.org/en/latest/user/advanced/#proxies.
+
 SUPPORT
 -------
 Please email tools@linux.kernel.org with support requests,
-- 
2.30.2


^ permalink raw reply related	[flat|nested] 4+ messages in thread

* [PATCH 2/2] man: Update man page to use bold where appropriate
  2022-02-18 15:31 ` [PATCH 1/2] man: Update man page to mention HTTPS_PROXY David Vernet
@ 2022-02-18 15:31   ` David Vernet
  0 siblings, 0 replies; 4+ messages in thread
From: David Vernet @ 2022-02-18 15:31 UTC (permalink / raw)
  To: konstantin; +Cc: users, tools, void, kernel-team

According to https://man7.org/linux/man-pages/man1/man.1.html, when writing
a man page for a program, anything that should be typed exactly as shown
should use bolded text. The b4 man page has a SUBCOMMANDS section where
subcommands are listed as 'b4 <subcommand>', in italics. So as to match the
guidance for man pages (as well as to match the examples provided at the
link above), this diff updates the 'b4' portion of the aforementioned
subcommand section to be bolded.

Signed-off-by: David Vernet <void@manifault.com>
---
 man/b4.5.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/man/b4.5.rst b/man/b4.5.rst
index ab12804..b45909a 100644
--- a/man/b4.5.rst
+++ b/man/b4.5.rst
@@ -27,14 +27,14 @@ precursor to Lore and Data in the Star Trek universe.
 
 SUBCOMMANDS
 -----------
-* *b4 mbox*: Download a thread as an mbox file
-* *b4 am*: Create an mbox file that is ready to git-am
-* *b4 shazam*: Similar to *am*, but lets you apply patches directly
-* *b4 pr*: Work with pull requests
-* *b4 diff*: Show range-diff style diffs between patch versions
-* *b4 ty*: Create templated replies for processed patches and pull requests
-* *b4 attest*: (EXPERIMENTAL) Add cryptographic attestation to patches
-* *b4 kr* (EXPERIMENTAL) Operate on patatt-compatible keyrings
+* **b4** *mbox*: Download a thread as an mbox file
+* **b4** *am*: Create an mbox file that is ready to git-am
+* **b4** *shazam*: Similar to *am*, but lets you apply patches directly
+* **b4** *pr*: Work with pull requests
+* **b4** *diff*: Show range-diff style diffs between patch versions
+* **b4** *ty*: Create templated replies for processed patches and pull requests
+* **b4** *attest*: (EXPERIMENTAL) Add cryptographic attestation to patches
+* **b4** *kr* (EXPERIMENTAL) Operate on patatt-compatible keyrings
 
 OPTIONS
 -------
-- 
2.30.2


^ permalink raw reply related	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2022-02-18 15:31 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-01-18 21:08 [PATCH 1/2] man: Update man page to mention HTTPS_PROXY David Vernet
2022-01-18 21:08 ` [PATCH 2/2] man: Update man page to use bold where appropriate David Vernet
2022-02-18 15:31 ` [PATCH 1/2] man: Update man page to mention HTTPS_PROXY David Vernet
2022-02-18 15:31   ` [PATCH 2/2] man: Update man page to use bold where appropriate David Vernet

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).