Re: A feasible method to add examples to man pages?
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 ~/bin/cht.sh
cht.sh --standalone-install
I don't understand what those 3 lines are attempting to do.
What should I be reading?
curl(1)
bash(1) (Redirection)
chmod(1)
less ~/bin/cht.sh
Just for the record, there should be a mkdir -p ~/bin in there as
well. And one might need to log out and back in to get ~/bin into
one's PATH, depending on how one's dot files are set up. (Manual
modification of PATH is also acceptable.)
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).
FYI
It may be "operator error", but I get a "Could not install python
dependencies into the virtual environment" ERROR when trying to install
on Debian 10.7. The install.log is 6.6kB of messages I don't have the
background to interpret. A side effect is destruction of the ability to
consistently edit Profile Preferences. {perhaps also operator error}.
I'll not pursue further.
Re: A feasible method to add examples to man pages?
On Tuesday, June 22, 2021 12:16:19 PM Stefan Monnier wrote: > > 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 difference is that the manpages get installed automatically along > with the software, so they're always there, always uptodate, without me > having to think about it beforehand, without having to choose where to > install them, nor remember where I installed them. > > Don't get me wrong: all it means is that I think we want to keep *some* > examples in the manpages. IOW, I was just pointing out that the main > benefit of manpages is that they're local and work in almost 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 command analogous to man, but instead exam[ple] (or similar, or wiki), invoked like: exam ls exam tar etc.
Re: A feasible method to add examples to man pages?
> 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 difference is that the manpages get installed automatically along with the software, so they're always there, always uptodate, without me having to think about it beforehand, without having to choose where to install them, nor remember where I installed them. Don't get me wrong: all it means is that I think we want to keep *some* examples in the manpages. IOW, I was just pointing out that the main benefit of manpages is that they're local and work in almost 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 ;-) Stefan
Re: A feasible method to add examples to man pages?
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 06/21/2021 02:36 PM, Curt wrote: > > > > > >curl https://cht.sh/:cht.sh > ~/bin/cht.sh > ^ > | > +-- I don't understand that use of : A search with "url with colon" is suggested. Conclusions are welcomed. It hasn't anything to do with curl. -- Brian.
Re: A feasible method to add examples to man pages?
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 coerce the wrong thingamajig. 'curl cht.sh/ls?style=bw' works for me. Then again 'curl cht.sh/ls\?T' works equally well. Other styles here: curl cht.sh/:styles
Re: A feasible method to add examples to man pages?
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 user's private bin if it exists if [ -d "$HOME/bin" ] ; then PATH="$HOME/bin:$PATH" fi # set PATH so it includes user's private bin if it exists if [ -d "$HOME/.local/bin" ] ; then PATH="$HOME/.local/bin:$PATH" fi /etc/skel/.profile should be copied to the home directory of every new user (at least if created by the installer or with adduser). Whether your shell and/or login method actually leads to sourcing ~/.profile is a completely different question and depends on: 1. Login method (Linux console, ssh, display manager, etc.) 2. How you start your X session (if applicable and not taken care of by a display manager) 3. Terminal emulator (if in a graphical environment) 4. Shell in use and its configuration > Is there a Debian specific article on when to use which ...\bin directory in > $PATH and when/how to permanently add an additional directory. Not that I'm aware of. On the other hand the ~/.local/bin snippet was added recently (buster?) and makes sense for those who prefer the XDG directories over traditional dotfiles in $HOME. Kind regards, Andrei -- http://wiki.debian.org/FAQsFromDebianUser signature.asc Description: PGP signature
Re: A feasible method to add examples to man pages?
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 old is surprising because it uses python 2 by default, but also will
work with python 3 after a tiny, documented modification of the script
("curl cheat.sh/:cht.sh | less" told me all about it). I also read that
1G of local disk space is required. Good luck.
The warning said that Python 3.5 was no longer being supported.
I fortunately have lots of disk room and it apparently runs correctly.
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.
Re: A feasible method to add examples to man pages?
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 uses python 2 by default, but also will
work with python 3 after a tiny, documented modification of the script
("curl cheat.sh/:cht.sh | less" told me all about it). I also read that
1G of local disk space is required. Good luck.
Re: A feasible method to add examples to man pages?
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 wrote: curl https://cht.sh/:cht.sh > ~/bin/cht.sh ^ | +-- I don't understand that use of : It's the syntax for "special pages." Regular usage: curl cheat.sh/TOPIC show cheat sheet on the TOPIC Special pages: :help help page :list list all cheat sheets :post how to post new cheat sheet :cht.sh shell client (cht.sh) etc. So curl cheat.sh/:help I have Debian 9.13 installed As root I did curl https://cht.sh/:cht.sh > /usr/bin/cht.sh chmod +x /usr/bin/cht.sh Then as normal user did cht.sh --standalone-install 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.
Re: A feasible method to add examples to man pages?
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: >>curl https://cht.sh/:cht.sh > ~/bin/cht.sh > ^ > | > +-- I don't understand that use of : > It's the syntax for "special pages." Regular usage: curl cheat.sh/TOPIC show cheat sheet on the TOPIC Special pages: :help help page :list list all cheat sheets :post how to post new cheat sheet :cht.sh shell client (cht.sh) etc. So curl cheat.sh/:help
Re: A feasible method to add examples to man pages?
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 ^ | +-- I don't understand that use of : chmod +x ~/bin/cht.sh cht.sh --standalone-install q.v. https://github.com/chubin/cheat.sh/blob/master/doc/standalone.md I don't understand what those 3 lines are attempting to do. What should I be reading? curl(1) bash(1) (Redirection) chmod(1) less ~/bin/cht.sh Just for the record, there should be a mkdir -p ~/bin in there as well. That was part of what threw me. I didn't think to check if ~/bin existed. And one might need to log out and back in to get ~/bin into one's PATH, depending on how one's dot files are set up. (Manual modification of PATH is also acceptable.) If ~/bin needs to be created, will logging out then in _guarantee_ it gets added to my path? That doesn't sound normal. Is there a Debian specific article on when to use which ...\bin directory in $PATH and when/how to permanently add an additional directory. 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).
Re: A feasible method to add examples to man pages?
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 >> > > cht.sh --standalone-install >> > >> > I don't understand what those 3 lines are attempting to do. >> > What should I be reading? >> >> curl(1) >> bash(1) (Redirection) >> chmod(1) >> less ~/bin/cht.sh > > Just for the record, there should be a mkdir -p ~/bin in there as > well. And one might need to log out and back in to get ~/bin into > one's PATH, depending on how one's dot files are set up. (Manual > modification of PATH is also acceptable.) 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).
Re: A feasible method to add examples to man pages?
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 understand what those 3 lines are attempting to do. > > What should I be reading? > > curl(1) > bash(1) (Redirection) > chmod(1) > less ~/bin/cht.sh Just for the record, there should be a mkdir -p ~/bin in there as well. And one might need to log out and back in to get ~/bin into one's PATH, depending on how one's dot files are set up. (Manual modification of PATH is also acceptable.)
Re: A feasible method to add examples to man pages?
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 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 often enough find > > > myself using `man` while trying to fix a system's network or X11/Wayland > > > config, which makes it either impossible to access the Internet at that > > > moment, or painful to browse a webpage. > > > > curl https://cht.sh/:cht.sh > ~/bin/cht.sh > > chmod +x ~/bin/cht.sh > > cht.sh --standalone-install > > > > I don't understand what those 3 lines are attempting to do. > What should I be reading? curl(1) bash(1) (Redirection) chmod(1) less ~/bin/cht.sh -- Brian.
Re: A feasible method to add examples to man pages?
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 link to some further doc in the form of a wiki or some other webpage, but I often enough find myself using `man` while trying to fix a system's network or X11/Wayland config, which makes it either impossible to access the Internet at that moment, or painful to browse a webpage. curl https://cht.sh/:cht.sh > ~/bin/cht.sh chmod +x ~/bin/cht.sh cht.sh --standalone-install I don't understand what those 3 lines are attempting to do. What should I be reading? TIA
Re: A feasible method to add examples to man pages?
> 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 often enough find myself using `man` while trying to fix a system's network or X11/Wayland config, which makes it either impossible to access the Internet at that moment, or painful to browse a webpage. Stefan
Re: A feasible method to add examples to man pages?
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 the form of a wiki or some other webpage, but I often enough find > myself using `man` while trying to fix a system's network or X11/Wayland > config, which makes it either impossible to access the Internet at that > moment, or painful to browse a webpage. curl https://cht.sh/:cht.sh > ~/bin/cht.sh chmod +x ~/bin/cht.sh cht.sh --standalone-install > > Stefan
Re: A feasible method to add examples to man pages?
On 21.06.21 17:29, 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 was pointed to https://cht.sh/ . Going to https://cht.sh/XXX will return a list of examples for XXX. Along the right side of each page of /manpages.debian.org/... there is a list of links to various topics. Would it be proper/reasonable/practical/??? to add an entry of the form https://cht.sh/XXX ? Comments? TIA For displaying examples I am using the tldr command provided by package "tldr". This client's web page is here: https://github.com/psibi/tldr-hs#readme The general tldr site is here: https://tldr.sh/ There are also several web pages which search and display the information 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 man pages are usually maintained by the package maintainers and not all of them are in favor of adding examples to the man pages, I think that the normal users are best served by supporting as a community an examples collection like the above mentioned tldr project. Just my view as a user. Marco.
Re: A feasible method to add examples to man pages?
On 06/21/2021 11:49 AM, Nate Bargmann wrote: * On 2021 21 Jun 10:30 -0500, Richard Owlett wrote: Many see the need for examples to be associated with man pages. My name is among the authors of a few man pages found in the Debian archive with regard to some software used primarily by radio amateurs. Part of the issue is how many examples are enough and how many are too much. I landed at the point of providing enough for the curious to get a sense of the options and how to provide them for programs. Mostly this was aimed at those more familiar with GUI programs not programs that take 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 for other authors to follow, IMO. 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. That may have been me. Here is an example: $ curl cheat.sh/curl The cheat.sh site is not mine and I have no relation to it. In another forum I was pointed to https://cht.sh/ . Going to https://cht.sh/XXX will return a list of examples for XXX. It is the same site only through the Web interface. IIRC the page I saw was neither chat.sh nor cht.sh . Right now both seem to have long response times. I may have local hardware issues as some purely local operations have strange delays. Along the right side of each page of /manpages.debian.org/... there is a list of links to various topics. Would it be proper/reasonable/practical/??? to add an entry of the form https://cht.sh/XXX ? That question would be better posed to the Debian Web site team than here. I asked here as the subject had been raised here and I wanted feed back from people had raised the issue. As to discussing its implementation I was leaning to raising it on debian-doc rather than debian-www.
Re: A feasible method to add examples to man pages?
* On 2021 21 Jun 10:30 -0500, Richard Owlett wrote: > Many see the need for examples to be associated with man pages. My name is among the authors of a few man pages found in the Debian archive with regard to some software used primarily by radio amateurs. Part of the issue is how many examples are enough and how many are too much. I landed at the point of providing enough for the curious to get a sense of the options and how to provide them for programs. Mostly this was aimed at those more familiar with GUI programs not programs that take 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 for other authors to follow, IMO. > 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. That may have been me. Here is an example: $ curl cheat.sh/curl The cheat.sh site is not mine and I have no relation to it. > In another forum I was pointed to https://cht.sh/ . > Going to https://cht.sh/XXX will return a list of examples for XXX. It is the same site only through the Web interface. > Along the right side of each page of /manpages.debian.org/... there is a > list of links to various topics. > > Would it be proper/reasonable/practical/??? to add an entry of the form > https://cht.sh/XXX ? That question would be better posed to the Debian Web site team than here. - 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 signature.asc Description: PGP signature
Re: A feasible method to add examples to man pages?
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 was pointed to https://cht.sh/ . Going to https://cht.sh/XXX will return a list of examples for XXX. Along the right side of each page of /manpages.debian.org/... there is a list of links to various topics. Would it be proper/reasonable/practical/??? to add an entry of the form https://cht.sh/XXX ? Comments? TIA I just checked. That page does not explicitly address Greg Wooledge's comment[1] in another thread about handling one command with conflicting implementations. [e.g. "parallel"] [1] https://lists.debian.org/debian-user/2021/06/msg00496.html
A feasible method to add examples to man pages?
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 https://cht.sh/XXX will return a list of examples for XXX. Along the right side of each page of /manpages.debian.org/... there is a list of links to various topics. Would it be proper/reasonable/practical/??? to add an entry of the form https://cht.sh/XXX ? Comments? TIA
Re: examples for man pages
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 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 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-
Re: examples for man pages
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 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 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-
Re: examples for man pages
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 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 only.
Re: examples for man pages
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
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?"
Re: examples for man pages
* 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 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 signature.asc Description: PGP signature
Re: examples for man pages
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.
Re: examples for man pages
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 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.
Re: examples for man pages
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.
Re: examples for man pages
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.
Re: examples for man pages
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 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 signature.asc Description: PGP signature
Re: examples for man pages
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.
Re: examples for man pages
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.
examples for man pages
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
