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


Groups > linux.debian.user > #270037

Re: info vs. man (was: Re: date for week)

Path csiph.com!fu-berlin.de!bofh.it!news.nic.it!robomod
From Greg Wooledge <greg@wooledge.org>
Newsgroups linux.debian.user
Subject Re: info vs. man (was: Re: date for week)
Date Tue, 11 Jun 2024 20:10:01 +0200
Message-ID <IOe6t-2cDo-1@gated-at.bofh.it> (permalink)
References <INWCB-21Cc-1@gated-at.bofh.it> <INWVX-21IG-5@gated-at.bofh.it> <IOcxH-2bCu-1@gated-at.bofh.it>
X-Mailbox-Line From debian-user-request@lists.debian.org Tue Jun 11 18:00:38 2024
Old-Return-Path <greg@wooledge.org>
X-Amavis-Spam-Status No, score=-5.717 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, GENDER=0.5, LDO_WHITELIST=-5, RDNS_NONE=0.793, T_SCC_BODY_TEXT_LINE=-0.01] autolearn=no autolearn_force=no
X-Policyd-Weight using cached result; rate: -4.6
Mail-Followup-To debian-user@lists.debian.org
MIME-Version 1.0
Content-Type text/plain; charset=us-ascii
Content-Disposition inline
X-Mailing-List <debian-user@lists.debian.org> archive/latest/812089
List-ID <debian-user.lists.debian.org>
List-URL <https://lists.debian.org/debian-user/>
List-Archive https://lists.debian.org/msgid-search/ZmiQr_ZIDLB8zoEL@wooledge.org
Approved robomod@news.nic.it
Lines 48
Organization linux.* mail to news gateway
Sender robomod@news.nic.it
X-Original-Date Tue, 11 Jun 2024 14:00:15 -0400
X-Original-Message-ID <ZmiQr_ZIDLB8zoEL@wooledge.org>
X-Original-References <9835a573-7594-4de2-a003-e8084f67377b@tls-mail.com> <ZmeQEE8wZSc8PArB@wooledge.org> <v49tjr$b2k$1@ciao.gmane.io>
Xref csiph.com linux.debian.user:270037

Show key headers only | View raw


On Tue, Jun 11, 2024 at 11:22:17PM +0700, Max Nikulin wrote:
> On 11/06/2024 06:45, Greg Wooledge wrote:
> > Should you ever feel a need to read the longer version of the
> > documentation, it's in GNU info pages.  So you would need to type
> > the command "info coreutils date" to get to it.  And then you'd need
> > to figure out the user interface of the "info" program, which is not
> > intuitive unless you happen to be an emacs power user already.
> 
> Emacs power users can type
>     M-x info RET
> or
>     M-: (info "(coreutils) date conversion specifiers") RET
> or at least
>     emacs -f info-standalone '(coreutils) date conversion specifiers'
> 
> I do not mind that info browsers have usability issues. For beginners I
> would recommend tkinfo instead of terminal "info". I have not tried pinfo.
> 
> Texinfo, unlike man, has a notion of hyperlink. In the case of man it is
> just formatting that suggests that some part of text is a reference to
> another document or another section.

See, this is all fine -- you've searched for the appropriate section, and
you've generated a cryptic command that someone else could type inside
emacs to get to that same section.  I'm sure there's an "info" equivalent
that can be done from a shell without invoking emacs.

None of that's useful to a person who wants to search for that information
in the first place without consulting an expert who's already done the
work.

What I was trying to do in my reply was "teach them how to fish" -- to
show them how to bring up the man page themselves, and look for basic
information like "how do I get the name of the day of the week, instead
of the numeric index of the day of the week" without having to bother
an international mailing list.

So, I gave basic instructions for how to bring up the man page, and a
hint about searching for a key word related to their question.  I even
provided a small piece of the man page, which happens to include the
answer they're looking for, because I'm also a pessimist who knows
that they probably won't look it up themselves, and may become angry
if we don't spoon-feed them the actual answer.

I also provided a reference to the info page, and a command that would
bring that up, should the need ever arise.  More importantly, I revealed
that info pages *exist* and *are a thing* that they need to know about.
It's planting a seed for the future.

Back to linux.debian.user | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread


Thread

date for week Jeff Peng <jeff@tls-mail.com> - 2024-06-11 01:30 +0200
  Re: date for week Roberto C. Sánchez <roberto@debian.org> - 2024-06-11 01:30 +0200
    Re: date for week Jeff Peng <jeff@tls-mail.com> - 2024-06-11 01:50 +0200
  Re: date for week Greg Wooledge <greg@wooledge.org> - 2024-06-11 01:50 +0200
    info vs. man (was: Re: date for week) Max Nikulin <manikulin@gmail.com> - 2024-06-11 18:30 +0200
      Re: info vs. man (was: Re: date for week) Greg Wooledge <greg@wooledge.org> - 2024-06-11 20:10 +0200
        Re: info vs. man Max Nikulin <manikulin@gmail.com> - 2024-06-12 18:10 +0200
  Re: date for week "rtnetzlof@windstream.net" <rtnetzlof@windstream.net> - 2024-06-11 01:50 +0200

csiph-web