Re: [PLUG] Quick question on linux man page coverage
Ubuntu has "oneko" still. I recall xfishtank from the first X11 install I ever did, on an early SLS install of Linux. In similar-era news, I just set up bsdgames on a Raspberry Pi with mgetty, and some dialup modems to deploy at ToorCamp later this week, so that other people in their tents can dial in and play "trek" or maybe hunt the wumpus. On Mon, Jun 18, 2018 at 3:28 AM, Tomas K wrote: > Did you check if you could install some of the missing man/manuals you > care about? Not all man pages are selected for default install. > > on my opensuse 42.3: > installed: > sudo zypper search man | awk '$1 !~ /^i/ && $2 ~ /(^|-)(man|manual)$/ > {print} $1 ~ /^i/ && $3 ~ /(^|-)(man|manual)$/ {print}' | grep -c '^i' > 1 > not-installed: > sudo zypper search man | awk '$1 !~ /^i/ && $2 ~ /(^|-)(man|manual)$/ > {print} $1 ~ /^i/ && $3 ~ /(^|-)(man|manual)$/ {print}' | grep -cv '^i' > 47 > > I looked for the sl utility - no joy finding it, SAD! > no xsnow either, SAD! > found xeyes, huraaahhh! > > Tomas > > On Sun, 2018-06-17 at 15:50 -0700, logical american wrote: > > A brief question on sparse linux documentation for executable > > programs > > > > I did a survey of the 15,000+ executables on my openSuse Leap v42.3 > > OS > > which has about 8869 software packages loaded according to zypper, > > but > > 76% of them have no man page at all. I did find dozens of programs > > running, such as gvfs, which are intrinsic to the OS and some > > apparently > > embedded in the kernal, most running under systemctl control, but > > with > > no documentation. > > > > For openSuse Leap v42.3, it appears that the linux developers just > > want > > the product out the door and have not documented the /etc folder very > > well. > > > > Should we be concerned that 3/4 of the programs running on a linux OS > > do > > not have a man page? > > > > I was a bit surprised to find this rather high ratio. Is it > > surprising? > > > > Randall > > > > ___ > > PLUG mailing list > > PLUG@pdxlinux.org > > http://lists.pdxlinux.org/mailman/listinfo/plug > ___ > PLUG mailing list > PLUG@pdxlinux.org > http://lists.pdxlinux.org/mailman/listinfo/plug > ___ PLUG mailing list PLUG@pdxlinux.org http://lists.pdxlinux.org/mailman/listinfo/plug
Re: [PLUG] Quick question on linux man page coverage
Did you check if you could install some of the missing man/manuals you care about? Not all man pages are selected for default install. on my opensuse 42.3: installed: sudo zypper search man | awk '$1 !~ /^i/ && $2 ~ /(^|-)(man|manual)$/ {print} $1 ~ /^i/ && $3 ~ /(^|-)(man|manual)$/ {print}' | grep -c '^i' 1 not-installed: sudo zypper search man | awk '$1 !~ /^i/ && $2 ~ /(^|-)(man|manual)$/ {print} $1 ~ /^i/ && $3 ~ /(^|-)(man|manual)$/ {print}' | grep -cv '^i' 47 I looked for the sl utility - no joy finding it, SAD! no xsnow either, SAD! found xeyes, huraaahhh! Tomas On Sun, 2018-06-17 at 15:50 -0700, logical american wrote: > A brief question on sparse linux documentation for executable > programs > > I did a survey of the 15,000+ executables on my openSuse Leap v42.3 > OS > which has about 8869 software packages loaded according to zypper, > but > 76% of them have no man page at all. I did find dozens of programs > running, such as gvfs, which are intrinsic to the OS and some > apparently > embedded in the kernal, most running under systemctl control, but > with > no documentation. > > For openSuse Leap v42.3, it appears that the linux developers just > want > the product out the door and have not documented the /etc folder very > well. > > Should we be concerned that 3/4 of the programs running on a linux OS > do > not have a man page? > > I was a bit surprised to find this rather high ratio. Is it > surprising? > > Randall > > ___ > PLUG mailing list > PLUG@pdxlinux.org > http://lists.pdxlinux.org/mailman/listinfo/plug ___ PLUG mailing list PLUG@pdxlinux.org http://lists.pdxlinux.org/mailman/listinfo/plug
Re: [PLUG] Quick question on linux man page coverage
I lived in the Kelso/Longview area, I did field service up and down I-5 from N CA to WA and on up into BC (went all the way up to Port Hardy on Vancouver Is. I was active with the local club in Cowlitz Co. also active with the Peak repeater system as I used it a lot on the road on I-5 in OR. They meet in Corvallis but have repeaters from Mt Shasta all the way up to PDX. and out on the coast, there are some places there is no cellular but the Peak system does have coverage. Here is the web site, used to get on the network there and enjoy the tech talk. https://www.w7pra.com/ I see you are in Tualatin. You should be able to hit both KGW tower repeater (PDX) and the Prospect Hill (Salem) repeaters. On Sun, Jun 17, 2018 at 10:40 PM, Tyrell Jentink wrote: > KD7TKJ... Although, I haven't done any of the things I'm supposed to do > since getting a vanity call, like update my APRS-IS and EchoLink > registrations, register the new domain name, or actually transmit... > > I was really active in the community when I was studying at the University > of Nevada, but just haven't found a home in the ham community since moving > to Oregon :/ > > On Jun 17, 2018 19:01, "Chuck Hast" wrote: > > On Sun, Jun 17, 2018 at 5:58 PM, Tyrell Jentink > wrote: > > > I'm occasionally surprised by man pages that say "This was written for > > Debian, as no man page existed..." Granted, I normally stumble on them in > > amateur radio contexts, and I blamed ham radio for being bad at > > documentation rather than Linux... > > > > What is your call sign? > > -- > > Chuck Hast -- KP4DJT -- > I can do all things through Christ which strengtheneth me. > Ph 4:13 KJV > Todo lo puedo en Cristo que me fortalece. > Fil 4:13 RVR1960 > > ___ > PLUG mailing list > PLUG@pdxlinux.org > http://lists.pdxlinux.org/mailman/listinfo/plug > ___ > PLUG mailing list > PLUG@pdxlinux.org > http://lists.pdxlinux.org/mailman/listinfo/plug > -- Chuck Hast -- KP4DJT -- I can do all things through Christ which strengtheneth me. Ph 4:13 KJV Todo lo puedo en Cristo que me fortalece. Fil 4:13 RVR1960 ___ PLUG mailing list PLUG@pdxlinux.org http://lists.pdxlinux.org/mailman/listinfo/plug
Re: [PLUG] Quick question on linux man page coverage
KD7TKJ... Although, I haven't done any of the things I'm supposed to do since getting a vanity call, like update my APRS-IS and EchoLink registrations, register the new domain name, or actually transmit... I was really active in the community when I was studying at the University of Nevada, but just haven't found a home in the ham community since moving to Oregon :/ On Jun 17, 2018 19:01, "Chuck Hast" wrote: On Sun, Jun 17, 2018 at 5:58 PM, Tyrell Jentink wrote: > I'm occasionally surprised by man pages that say "This was written for > Debian, as no man page existed..." Granted, I normally stumble on them in > amateur radio contexts, and I blamed ham radio for being bad at > documentation rather than Linux... > What is your call sign? -- Chuck Hast -- KP4DJT -- I can do all things through Christ which strengtheneth me. Ph 4:13 KJV Todo lo puedo en Cristo que me fortalece. Fil 4:13 RVR1960 ___ PLUG mailing list PLUG@pdxlinux.org http://lists.pdxlinux.org/mailman/listinfo/plug ___ PLUG mailing list PLUG@pdxlinux.org http://lists.pdxlinux.org/mailman/listinfo/plug
Re: [PLUG] Quick question on linux man page coverage
Also, there may (or may not) be more extensive documentation under /usr/share/doc. > I've run into a few instances where a program has no man page, but it does > have an 'info' page. However I don't see it very often. > > On Sun, Jun 17, 2018 at 7:00 PM, Chuck Hast wrote: > > > On Sun, Jun 17, 2018 at 5:58 PM, Tyrell Jentink > > wrote: > > > > > I'm occasionally surprised by man pages that say "This was written for > > > Debian, as no man page existed..." Granted, I normally stumble on them in > > > amateur radio contexts, and I blamed ham radio for being bad at > > > documentation rather than Linux... > > > ___ PLUG mailing list PLUG@pdxlinux.org http://lists.pdxlinux.org/mailman/listinfo/plug
Re: [PLUG] Quick question on linux man page coverage
I've run into a few instances where a program has no man page, but it does have an 'info' page. However I don't see it very often. On Sun, Jun 17, 2018 at 7:00 PM, Chuck Hast wrote: > On Sun, Jun 17, 2018 at 5:58 PM, Tyrell Jentink > wrote: > > > I'm occasionally surprised by man pages that say "This was written for > > Debian, as no man page existed..." Granted, I normally stumble on them in > > amateur radio contexts, and I blamed ham radio for being bad at > > documentation rather than Linux... > > > > What is your call sign? > -- > > Chuck Hast -- KP4DJT -- > I can do all things through Christ which strengtheneth me. > Ph 4:13 KJV > Todo lo puedo en Cristo que me fortalece. > Fil 4:13 RVR1960 > ___ > PLUG mailing list > PLUG@pdxlinux.org > http://lists.pdxlinux.org/mailman/listinfo/plug > ___ PLUG mailing list PLUG@pdxlinux.org http://lists.pdxlinux.org/mailman/listinfo/plug
Re: [PLUG] Quick question on linux man page coverage
On Sun, 17 Jun 2018, logical american wrote: ... such as gvfs, which are intrinsic to the OS and some apparently embedded in the kernal, most running under systemctl control, but with no documentation. L.A., You don't need a man page for a tool over which you have no control. Your example of gvfs is the Gnome virtual file system. Unless you're an application or system developer, and need to know the API, a man page would have no value to us reg'lar users. Wikipedia has an article about gvfs. Should we be concerned that 3/4 of the programs running on a linux OS do not have a man page? Nah. Rich ___ PLUG mailing list PLUG@pdxlinux.org http://lists.pdxlinux.org/mailman/listinfo/plug
Re: [PLUG] Quick question on linux man page coverage
I'm occasionally surprised by man pages that say "This was written for Debian, as no man page existed..." Granted, I normally stumble on them in amateur radio contexts, and I blamed ham radio for being bad at documentation rather than Linux... But as a contradiction to my point... The 'sl' "utility" displays a steam locomotive scrolling across your terminal window. It's cute. But it's undocumented on most systems... So maybe it IS a Linux problem... Anyway, my "Answer" is to use Google to search for man pages... More often then not, it will bring up what I need. On Sun, Jun 17, 2018, 15:51 logical american wrote: > A brief question on sparse linux documentation for executable programs > > I did a survey of the 15,000+ executables on my openSuse Leap v42.3 OS > which has about 8869 software packages loaded according to zypper, but > 76% of them have no man page at all. I did find dozens of programs > running, such as gvfs, which are intrinsic to the OS and some apparently > embedded in the kernal, most running under systemctl control, but with > no documentation. > > For openSuse Leap v42.3, it appears that the linux developers just want > the product out the door and have not documented the /etc folder very well. > > Should we be concerned that 3/4 of the programs running on a linux OS do > not have a man page? > > I was a bit surprised to find this rather high ratio. Is it surprising? > > Randall > > ___ > PLUG mailing list > PLUG@pdxlinux.org > http://lists.pdxlinux.org/mailman/listinfo/plug > ___ PLUG mailing list PLUG@pdxlinux.org http://lists.pdxlinux.org/mailman/listinfo/plug