Re: A feasible method to add examples to man pages?

2021-06-23 Thread Richard Owlett
On 06/22/2021 02:21 AM, Curt wrote: On 2021-06-22, Greg Wooledge wrote: On Mon, Jun 21, 2021 at 11:50:22PM +0100, Brian wrote: On Mon 21 Jun 2021 at 15:25:53 -0500, Richard Owlett wrote: On 06/21/2021 02:36 PM, Curt wrote: curl https://cht.sh/:cht.sh > ~/bin/cht.sh chmod +x

Re: A feasible method to add examples to man pages?

2021-06-23 Thread rhkramer
st all > situations. They don't need to contain all the info you'll ever want to > know, but I usually welcome a few examples in there ;-) Eventually those extra examples for the man pages could become a local, automatically installed thing, similiar to the man pages -- there might be a c

Re: A feasible method to add examples to man pages?

2021-06-22 Thread Stefan Monnier
> That's what I get for blindly copying and pasting the "directions" from > Github. I should've have just told Monnier that the whole shebang > can be installed locally, which renders inoperative his nitpick about > not having the Net when he needs to cheat the most (or most often). The

Re: A feasible method to add examples to man pages?

2021-06-22 Thread Brian
On Tue 22 Jun 2021 at 05:54:19 -0500, Richard Owlett wrote: > On 06/22/2021 02:21 AM, Curt wrote: > > On 2021-06-22, Greg Wooledge wrote: > > > On Mon, Jun 21, 2021 at 11:50:22PM +0100, Brian wrote: > > > > On Mon 21 Jun 2021 at 15:25:53 -0500, Richard Owlett wrote: > > > > > > > > > On

Re: A feasible method to add examples to man pages?

2021-06-22 Thread Curt
On 2021-06-22, Richard Owlett wrote: > Unfortunately it outputs light gray text on white background which is > near impossible for me to read. I Can't figure out how to COERCE MATE > Terminal to render everything as black on white. That is a showstopper > for me. Yeah, maybe you're trying to

Re: A feasible method to add examples to man pages?

2021-06-22 Thread Andrei POPESCU
On Ma, 22 iun 21, 05:54:19, Richard Owlett wrote: > > If ~/bin needs to be created, will logging out then in _guarantee_ it gets > added to my path? That doesn't sound normal. There is no guarantee :) On buster /etc/skel/.profile includes the following snippets # set PATH so it includes

Re: A feasible method to add examples to man pages?

2021-06-22 Thread Richard Owlett
On 06/22/2021 07:59 AM, Curt wrote: On 2021-06-22, Richard Owlett wrote: I got multiple warning messages including a missing dependency and warning that my Python was too old. I'm in process of installing Debian 10.7 on another machine. I'll try again this afternoon or tomorrow. Thanks. Too

Re: A feasible method to add examples to man pages?

2021-06-22 Thread Curt
On 2021-06-22, Richard Owlett wrote: > > I got multiple warning messages including a missing dependency and > warning that my Python was too old. I'm in process of installing > Debian 10.7 on another machine. I'll try again this afternoon or tomorrow. > Thanks. Too old is surprising because it

Re: A feasible method to add examples to man pages?

2021-06-22 Thread Richard Owlett
On 06/22/2021 06:43 AM, Curt wrote: On 2021-06-22, Richard Owlett wrote: On 06/22/2021 02:21 AM, Curt wrote: On 2021-06-22, Greg Wooledge wrote: On Mon, Jun 21, 2021 at 11:50:22PM +0100, Brian wrote: On Mon 21 Jun 2021 at 15:25:53 -0500, Richard Owlett wrote: On 06/21/2021 02:36 PM, Curt

Re: A feasible method to add examples to man pages?

2021-06-22 Thread Curt
On 2021-06-22, Richard Owlett wrote: > On 06/22/2021 02:21 AM, Curt wrote: >> On 2021-06-22, Greg Wooledge wrote: >>> On Mon, Jun 21, 2021 at 11:50:22PM +0100, Brian wrote: On Mon 21 Jun 2021 at 15:25:53 -0500, Richard Owlett wrote: > On 06/21/2021 02:36 PM, Curt wrote: >>

Re: A feasible method to add examples to man pages?

2021-06-22 Thread Richard Owlett
On 06/22/2021 02:21 AM, Curt wrote: On 2021-06-22, Greg Wooledge wrote: On Mon, Jun 21, 2021 at 11:50:22PM +0100, Brian wrote: On Mon 21 Jun 2021 at 15:25:53 -0500, Richard Owlett wrote: On 06/21/2021 02:36 PM, Curt wrote: curl https://cht.sh/:cht.sh > ~/bin/cht.sh

Re: A feasible method to add examples to man pages?

2021-06-22 Thread Curt
On 2021-06-22, Greg Wooledge wrote: > On Mon, Jun 21, 2021 at 11:50:22PM +0100, Brian wrote: >> On Mon 21 Jun 2021 at 15:25:53 -0500, Richard Owlett wrote: >> >> > On 06/21/2021 02:36 PM, Curt wrote: >> > > curl https://cht.sh/:cht.sh > ~/bin/cht.sh >> > > chmod +x ~/bin/cht.sh >> > >

Re: A feasible method to add examples to man pages?

2021-06-21 Thread Greg Wooledge
On Mon, Jun 21, 2021 at 11:50:22PM +0100, Brian wrote: > On Mon 21 Jun 2021 at 15:25:53 -0500, Richard Owlett wrote: > > > On 06/21/2021 02:36 PM, Curt wrote: > > > curl https://cht.sh/:cht.sh > ~/bin/cht.sh > > > chmod +x ~/bin/cht.sh > > > cht.sh --standalone-install > > > > I don't

Re: A feasible method to add examples to man pages?

2021-06-21 Thread Brian
On Mon 21 Jun 2021 at 15:25:53 -0500, Richard Owlett wrote: > On 06/21/2021 02:36 PM, Curt wrote: > > On 2021-06-21, Stefan Monnier wrote: > > > > Many see the need for examples to be associated with man pages. > > > [...] > > > > Would it be proper/reasonable/practical/??? to add an entry of

Re: A feasible method to add examples to man pages?

2021-06-21 Thread Richard Owlett
On 06/21/2021 02:36 PM, Curt wrote: On 2021-06-21, Stefan Monnier wrote: Many see the need for examples to be associated with man pages. [...] Would it be proper/reasonable/practical/??? to add an entry of the form https://cht.sh/XXX ? I think it can make sense for manpages to include a

Re: A feasible method to add examples to man pages?

2021-06-21 Thread Stefan Monnier
> Many see the need for examples to be associated with man pages. [...] > Would it be proper/reasonable/practical/??? to add an entry of the form > https://cht.sh/XXX ? I think it can make sense for manpages to include a link to some further doc in the form of a wiki or some other webpage, but I

Re: A feasible method to add examples to man pages?

2021-06-21 Thread Curt
On 2021-06-21, Stefan Monnier wrote: >> Many see the need for examples to be associated with man pages. > [...] >> Would it be proper/reasonable/practical/??? to add an entry of the form >> https://cht.sh/XXX ? > > I think it can make sense for manpages to include a link to some further > doc in

Re: A feasible method to add examples to man pages?

2021-06-21 Thread Marco Möller
nformation from the tldr examples collection, like this one: https://tldr.ostera.io/ The project invites to participate by adding examples to its collection. Following for years the upcoming discussions about the wish to enhance man pages by adding examples to it but confronting the situation that

Re: A feasible method to add examples to man pages?

2021-06-21 Thread Richard Owlett
command line options. Manual pages that focus on library API calls have yet another challenge for providing examples. The Linux Man Pages Project seems to do a good job in sections 2 (system calls) and 3 (C library calls) with concise and useful examples and should probably serve as an example

Re: A feasible method to add examples to man pages?

2021-06-21 Thread Nate Bargmann
cus on library API calls have yet another challenge for providing examples. The Linux Man Pages Project seems to do a good job in sections 2 (system calls) and 3 (C library calls) with concise and useful examples and should probably serve as an example for other authors to follow, IMO. > Sometim

Re: A feasible method to add examples to man pages?

2021-06-21 Thread Richard Owlett
On 06/21/2021 10:29 AM, Richard Owlett wrote: Many see the need for examples to be associated with man pages. Sometime back a post mentioned a web page that could return examples for most(all??) Linux commands. I failed to bookmark it and have not rediscovered it since. In another forum I

A feasible method to add examples to man pages?

2021-06-21 Thread Richard Owlett
Many see the need for examples to be associated with man pages. Sometime back a post mentioned a web page that could return examples for most(all??) Linux commands. I failed to bookmark it and have not rediscovered it since. In another forum I was pointed to https://cht.sh/ . Going to

Re: examples for man pages

2021-05-31 Thread Curt
On 2021-05-31, Dan Ritter wrote: >> > >> > '\?T' for text only, no ANSI sequences >> > >> > curl cht.sh/cp\?T >> > >> > curl cheat.sh/:help >> >> Thank you. That addresses the immediate *SYMPTOM*. >> >> I'll repeat my statement from my original post: >> > I'll have to reconfigure something

Re: examples for man pages

2021-05-31 Thread Dan Ritter
Richard Owlett wrote: > On 05/30/2021 03:02 PM, Curt wrote: > > On 2021-05-29, Richard Owlett wrote: > > > > > > I'll have to reconfigure something on my system. Executing 'curl > > > cheat.sh/cp' resulted in light grey text on white background ;/ > > > > > > > '\?T' for text only, no ANSI

Re: examples for man pages

2021-05-31 Thread Richard Owlett
On 05/30/2021 03:02 PM, Curt wrote: On 2021-05-29, Richard Owlett wrote: I'll have to reconfigure something on my system. Executing 'curl cheat.sh/cp' resulted in light grey text on white background ;/ '\?T' for text only, no ANSI sequences curl cht.sh/cp\?T curl cheat.sh/:help

Re: examples for man pages

2021-05-30 Thread Curt
On 2021-05-29, Richard Owlett wrote: > > I'll have to reconfigure something on my system. Executing 'curl > cheat.sh/cp' resulted in light grey text on white background ;/ > '\?T' for text only, no ANSI sequences curl cht.sh/cp\?T curl cheat.sh/:help

Re: examples for man pages

2021-05-30 Thread Richard Owlett
On 05/29/2021 03:20 PM, Jeremy Nicoll wrote: On Sat, 29 May 2021, at 21:03, Richard Owlett wrote: The man page is, putting *mildly*, overwhelming. Is there a recommended introduction to curl. curl is a big subject. While it's very useful to people who write scripts etc, on many platforms,

Re: examples for man pages

2021-05-29 Thread Nate Bargmann
* On 2021 29 May 15:04 -0500, Richard Owlett wrote: > On 05/29/2021 12:55 PM, Nate Bargmann wrote: > > This may not be exactly what you're thinking of, but I saw this > > referenced on Reddit recently: > > > > curl cheat.sh/ > > > > I just did it for 'curl cheat.sh/cp' which gives some

Re: examples for man pages

2021-05-29 Thread Jeremy Nicoll
On Sat, 29 May 2021, at 21:03, Richard Owlett wrote: > The man page is, putting *mildly*, overwhelming. Is there a recommended > introduction to curl. curl is a big subject. While it's very useful to people who write scripts etc, on many platforms, the whole manual is aimed at programmers

Re: examples for man pages

2021-05-29 Thread Richard Owlett
On 05/29/2021 12:55 PM, Nate Bargmann wrote: This may not be exactly what you're thinking of, but I saw this referenced on Reddit recently: curl cheat.sh/ I just did it for 'curl cheat.sh/cp' which gives some examples including from tldr. - Nate I'll have to reconfigure something

Re: examples for man pages

2021-05-29 Thread Richard Owlett
On 05/29/2021 11:47 AM, Marco Möller wrote: On 29.05.21 15:41, Richard Owlett wrote: A couple of months ago there was a discussion of practical problems with adding examples to all man pages. Someone pointed to a website of examples indexed by man page name. Unfortunately I didn't bookmark

Re: examples for man pages

2021-05-29 Thread Richard Owlett
On 05/29/2021 10:57 AM, Andrew M.A. Cater wrote: On Sat, May 29, 2021 at 08:41:02AM -0500, Richard Owlett wrote: A couple of months ago there was a discussion of practical problems with adding examples to all man pages. Someone pointed to a website of examples indexed by man page name

Re: examples for man pages

2021-05-29 Thread Nate Bargmann
This may not be exactly what you're thinking of, but I saw this referenced on Reddit recently: curl cheat.sh/ I just did it for 'curl cheat.sh/cp' which gives some examples including from tldr. - Nate -- "The optimist proclaims that we live in the best of all possible worlds. The

Re: examples for man pages

2021-05-29 Thread Marco Möller
On 29.05.21 15:41, Richard Owlett wrote: A couple of months ago there was a discussion of practical problems with adding examples to all man pages. Someone pointed to a website of examples indexed by man page name. Unfortunately I didn't bookmark it and my attempts to do a web search failed

Re: examples for man pages

2021-05-29 Thread Andrew M.A. Cater
On Sat, May 29, 2021 at 08:41:02AM -0500, Richard Owlett wrote: > A couple of months ago there was a discussion of practical problems with > adding examples to all man pages. > > Someone pointed to a website of examples indexed by man page name. > Unfortunately I didn't boo

examples for man pages

2021-05-29 Thread Richard Owlett
A couple of months ago there was a discussion of practical problems with adding examples to all man pages. Someone pointed to a website of examples indexed by man page name. Unfortunately I didn't bookmark it and my attempts to do a web search failed. Does anyone recall the URL? TIA