Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.debian.user > #235647 > unrolled thread

examples for man pages

Started byRichard Owlett <rowlett@cloud85.net>
First post2021-05-29 15:50 +0200
Last post2021-05-31 18:10 +0200
Articles 14 — 7 participants

Back to article view | Back to linux.debian.user


Contents

  examples for man pages Richard Owlett <rowlett@cloud85.net> - 2021-05-29 15:50 +0200
    Re: examples for man pages "Andrew M.A. Cater" <amacater@einval.com> - 2021-05-29 18:00 +0200
      Re: examples for man pages Richard Owlett <rowlett@cloud85.net> - 2021-05-29 21:30 +0200
    Re: examples for man pages Marco Möller <talby@debianlists.mobilxpress.net> - 2021-05-29 19:00 +0200
      Re: examples for man pages Richard Owlett <rowlett@cloud85.net> - 2021-05-29 21:40 +0200
    Re: examples for man pages Nate Bargmann <n0nb@n0nb.us> - 2021-05-29 20:00 +0200
      Re: examples for man pages Richard Owlett <rowlett@cloud85.net> - 2021-05-29 22:10 +0200
        Re: examples for man pages "Jeremy Nicoll" <jn.ml.dbn.25@letterboxes.org> - 2021-05-29 22:30 +0200
          Re: examples for man pages Richard Owlett <rowlett@cloud85.net> - 2021-05-30 15:50 +0200
        Re: examples for man pages Nate Bargmann <n0nb@n0nb.us> - 2021-05-30 03:20 +0200
        Re: examples for man pages Curt <curty@free.fr> - 2021-05-30 22:30 +0200
          Re: examples for man pages Richard Owlett <rowlett@cloud85.net> - 2021-05-31 14:40 +0200
            Re: examples for man pages Dan Ritter <dsr@randomstring.org> - 2021-05-31 16:50 +0200
              Re: examples for man pages Curt <curty@free.fr> - 2021-05-31 18:10 +0200

#235647 — examples for man pages

FromRichard Owlett <rowlett@cloud85.net>
Date2021-05-29 15:50 +0200
Subjectexamples for man pages
Message-ID<Ck7vI-1WR-11@gated-at.bofh.it>
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

[toc] | [next] | [standalone]


#235650

From"Andrew M.A. Cater" <amacater@einval.com>
Date2021-05-29 18:00 +0200
Message-ID<Ck9xv-36g-1@gated-at.bofh.it>
In reply to#235647
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 bookmark it and my attempts to do a web search
> failed.
> 
> Does anyone recall the URL?
> TIA
> 
> 
Richard,

The thread appears to start here:

https://lists.debian.org/debian-user/2021/03/msg01358.html

You can, if you wish, search the archives of this list quite well at 
https://lists.debian.org/debian-user/ at any point.

All the very best, as ever,

Andy C.

[toc] | [prev] | [next] | [standalone]


#235657

FromRichard Owlett <rowlett@cloud85.net>
Date2021-05-29 21:30 +0200
Message-ID<CkcOK-58k-3@gated-at.bofh.it>
In reply to#235650
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.
>> Unfortunately I didn't bookmark it and my attempts to do a web search
>> failed.
>>
>> Does anyone recall the URL?
>> TIA
>>
>>
> Richard,
> 
> The thread appears to start here:
> 
> https://lists.debian.org/debian-user/2021/03/msg01358.html
> 
> You can, if you wish, search the archives of this list quite well at
> https://lists.debian.org/debian-user/ at any point.
> 
> All the very best, as ever,
> 
> Andy C.
> 
> 
> 

Not in that thread. I have a local copy of that thread.
The web page I'm looking for was mentioned in more narrowly focused 
thread in the same time frame.

[toc] | [prev] | [next] | [standalone]


#235651

FromMarco Möller <talby@debianlists.mobilxpress.net>
Date2021-05-29 19:00 +0200
Message-ID<CkatA-3Eb-3@gated-at.bofh.it>
In reply to#235647
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.
> 
> Does anyone recall the URL?
> TIA
> 
> 

I didn't follow that discussion, but I know this:
https://github.com/tldr-pages/tldr/tree/master
At the bottom of that page you will find in category "Web clients" a 
list of Websites of interest, which can show you the tldr ouptut.
https://tldr.dendron.so/
At the command prompt, without having to use a browser, I much liked the 
node.js based client with its colorful (helpful) output:
https://github.com/tldr-pages/tldr-node-client
Simply because of the ease of installation with "apt install tldr" I am 
also happy with the tldr client in the Debian repository.
I am not sure if this is what you have been asking for. However, I hope 
that also this information could be useful for you.
Good Luck!
Marco.

[toc] | [prev] | [next] | [standalone]


#235658

FromRichard Owlett <rowlett@cloud85.net>
Date2021-05-29 21:40 +0200
Message-ID<CkcYp-5bh-3@gated-at.bofh.it>
In reply to#235651
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 it and my attempts to do a web search 
>> failed.
>>
>> Does anyone recall the URL?
>> TIA
>>
>>
> 
> I didn't follow that discussion, but I know this:
> https://github.com/tldr-pages/tldr/tree/master
> At the bottom of that page you will find in category "Web clients" a 
> list of Websites of interest, which can show you the tldr ouptut.
> https://tldr.dendron.so/
> At the command prompt, without having to use a browser, I much liked the 
> node.js based client with its colorful (helpful) output:
> https://github.com/tldr-pages/tldr-node-client
> Simply because of the ease of installation with "apt install tldr" I am 
> also happy with the tldr client in the Debian repository.
> I am not sure if this is what you have been asking for. However, I hope 
> that also this information could be useful for you.
> Good Luck!
> Marco.

I came across that in my current search. It attacks the underlying with 
a different set of goals/constraints.

I'm specifically looking for a HTML web page as I have my browser 
configured to address some visual problems.

[toc] | [prev] | [next] | [standalone]


#235654

FromNate Bargmann <n0nb@n0nb.us>
Date2021-05-29 20:00 +0200
Message-ID<CkbpE-4bz-3@gated-at.bofh.it>
In reply to#235647

[Multipart message — attachments visible in raw view] — view raw

This may not be exactly what you're thinking of, but I saw this
referenced on Reddit recently:

	curl cheat.sh/<command>

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 pessimist fears this is true."

Web: https://www.n0nb.us
Projects: https://github.com/N0NB
GPG fingerprint: 82D6 4F6B 0E67 CD41 F689 BBA6 FB2C 5130 D55A 8819

[toc] | [prev] | [next] | [standalone]


#235659

FromRichard Owlett <rowlett@cloud85.net>
Date2021-05-29 22:10 +0200
Message-ID<Ckdrr-5A0-3@gated-at.bofh.it>
In reply to#235654
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/<command>
> 
> I just did it for 'curl cheat.sh/cp' which gives some examples including
> from tldr.
> 
> - Nate
> 

I'll have to reconfigure something on my system. Executing  'curl 
cheat.sh/cp' resulted in light grey text on white background ;/

However, on [ https://github.com/chubin/cheat.sh ] I saw:
> If you don't know the name of the command you need, you can search for it
> using the ~KEYWORD notation. For example, to see how you can make snapshots
> of a filesystem/volume/something else ...

That has interesting possibilities for addressing a different set of 
problems. Exploring that site and the curl command [which I've never 
used] should keep me indoors for a chilly &/or wet coming week.

The man page is, putting *mildly*, overwhelming. Is there a recommended 
introduction to curl.

[toc] | [prev] | [next] | [standalone]


#235662

From"Jeremy Nicoll" <jn.ml.dbn.25@letterboxes.org>
Date2021-05-29 22:30 +0200
Message-ID<CkdKN-5Gt-7@gated-at.bofh.it>
In reply to#235659
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 using it.
Inevitably a lot of the information is quite detailed.   

If you're looking to learn more about one subject, getting distracted into 
learning about curl is possibly not a great idea!

For a quick summary of some basic uses of curl, see

  https://curl.se/docs/manual.html

For an longer, but much more educational read, try

  https://everything.curl.dev/

which was written by curl's author.

-- 
Jeremy Nicoll - my opinions are my own.

[toc] | [prev] | [next] | [standalone]


#235676

FromRichard Owlett <rowlett@cloud85.net>
Date2021-05-30 15:50 +0200
Message-ID<CktZg-6OK-9@gated-at.bofh.it>
In reply to#235662
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, the whole manual is aimed at programmers using it.
> Inevitably a lot of the information is quite detailed.
> 
> If you're looking to learn more about one subject, getting distracted into
> learning about curl is possibly not a great idea!
> 
> For a quick summary of some basic uses of curl, see
> 
>    https://curl.se/docs/manual.html
> 
> For an longer, but much more educational read, try
> 
>    https://everything.curl.dev/
> 
> which was written by curl's author.
> 

Both suffer from the same "feature" as the man page - abundance of fine 
detail. The second appears to to have a very good index so that if you 
need a particular detail, it should be quickly found.

After browsing both I did:
   https://html.duckduckgo.com/html?q=what%20is%20linux%20curl

The first hits each gave few examples, but they hit a wide range of 
topics. Thus answering an underlying question, "Why would I want to use 
curl?"

[toc] | [prev] | [next] | [standalone]


#235666

FromNate Bargmann <n0nb@n0nb.us>
Date2021-05-30 03:20 +0200
Message-ID<Ckihs-8nW-1@gated-at.bofh.it>
In reply to#235659

[Multipart message — attachments visible in raw view] — view raw

* 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/<command>
> > 
> > I just did it for 'curl cheat.sh/cp' which gives some examples including
> > from tldr.
> > 
> > - Nate
> > 
> 
> I'll have to reconfigure something on my system. Executing  'curl
> cheat.sh/cp' resulted in light grey text on white background ;/

Might have to take that up with the author of cheat.sh.  I use Linux
console colors in my terminals so gray text on a nearly black background
thus everything looks fine "here".

> The man page is, putting *mildly*, overwhelming. Is there a recommended
> introduction to curl.

Well, 'curl cheat.sh/curl' gives me several screens full of seemingly
useful examples.  I've not used curl much either, it's mostly installed
for some other tool on my system, as I recall.  I do use wget on
occasion.

- Nate

-- 

"The optimist proclaims that we live in the best of all
possible worlds.  The pessimist fears this is true."

Web: https://www.n0nb.us
Projects: https://github.com/N0NB
GPG fingerprint: 82D6 4F6B 0E67 CD41 F689 BBA6 FB2C 5130 D55A 8819

[toc] | [prev] | [next] | [standalone]


#235683

FromCurt <curty@free.fr>
Date2021-05-30 22:30 +0200
Message-ID<CkAel-28U-1@gated-at.bofh.it>
In reply to#235659
On 2021-05-29, Richard Owlett <rowlett@cloud85.net> 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

[toc] | [prev] | [next] | [standalone]


#235735

FromRichard Owlett <rowlett@cloud85.net>
Date2021-05-31 14:40 +0200
Message-ID<CkPn4-2Ui-3@gated-at.bofh.it>
In reply to#235683
On 05/30/2021 03:02 PM, Curt wrote:
> On 2021-05-29, Richard Owlett <rowlett@cloud85.net> 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
>

Thank you. That addresses the immediate *SYMPTOM*.

I'll repeat my statement from my original post:
> I'll have to reconfigure something on my system.

I require my terminal emulator [MATE terminal] to NOT display colors.
Its "Help" claims supports for VT102 emulation, BUT gives no information 
on how to obtain it.
It may be a half-century since I worked at DEC, but IIRC all VT100 
series were physically B&W only.

[toc] | [prev] | [next] | [standalone]


#235747

FromDan Ritter <dsr@randomstring.org>
Date2021-05-31 16:50 +0200
Message-ID<CkRoR-43S-1@gated-at.bofh.it>
In reply to#235735
Richard Owlett wrote: 
> On 05/30/2021 03:02 PM, Curt wrote:
> > On 2021-05-29, Richard Owlett <rowlett@cloud85.net> 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
> > 
> 
> Thank you. That addresses the immediate *SYMPTOM*.
> 
> I'll repeat my statement from my original post:
> > I'll have to reconfigure something on my system.
> 
> I require my terminal emulator [MATE terminal] to NOT display colors.
> Its "Help" claims supports for VT102 emulation, BUT gives no information on
> how to obtain it.
> It may be a half-century since I worked at DEC, but IIRC all VT100 series
> were physically B&W only.
> 

Then solve that in the terminal emulator.

MATE terminal has "profiles". Edit your default profile. Make
all the colors either black or white. Save.

-dsr-

[toc] | [prev] | [next] | [standalone]


#235751

FromCurt <curty@free.fr>
Date2021-05-31 18:10 +0200
Message-ID<CkSEi-4Y4-7@gated-at.bofh.it>
In reply to#235747
On 2021-05-31, Dan Ritter <dsr@randomstring.org> 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 on my system.
>> 
>> I require my terminal emulator [MATE terminal] to NOT display colors.
>> Its "Help" claims supports for VT102 emulation, BUT gives no information on
>> how to obtain it.
>> It may be a half-century since I worked at DEC, but IIRC all VT100 series
>> were physically B&W only.
>> 
>
> Then solve that in the terminal emulator.
>
> MATE terminal has "profiles". Edit your default profile. Make
> all the colors either black or white. Save.

You can't win with this guy. It's turtles all the way down.

:-)

> -dsr-

[toc] | [prev] | [standalone]


Back to top | Article view | linux.debian.user


csiph-web