Groups > linux.debian.user > #201856

Re: Online copies of textinfo content available?

From	Michael Stone <mstone@debian.org>
Newsgroups	linux.debian.user
Subject	Re: Online copies of textinfo content available?
Date	2018-10-29 22:20 +0100
Message-ID	<wOn73-7dO-3@gated-at.bofh.it> (permalink)
References	(2 earlier) <wNi9s-zT-5@gated-at.bofh.it> <wO9nr-7tS-1@gated-at.bofh.it> <wOhEl-3Uv-1@gated-at.bofh.it> <wOmkF-6IB-5@gated-at.bofh.it> <wOmNH-6Sd-3@gated-at.bofh.it>
Organization	linux.* mail to news gateway

Show all headers | View raw

On Mon, Oct 29, 2018 at 08:57:50PM +0000, Brian wrote:
>On Mon 29 Oct 2018 at 16:27:13 -0400, Michael Stone wrote:
>
>> On Mon, Oct 29, 2018 at 10:20:30AM -0500, David Wright wrote:
>> > What Brian asked for is an example of a man page that ends with
>> > "The full documentation for foo is maintained as a Texinfo manual"
>> > but the   info foo   output has no more information than   man foo.
>>
>> This used to be more of a problem because dpkg provided an install-info that
>> couldn't parse the info header used in newer versions of texinfo.  This was
>> obviously a bug but hung around for a while before it was solved. E.g., in
>> etch the ls man page would point people to the ls info page, but since
>> install-info didn't parse the index properly, "info ls" couldn't find any ls
>> info and fell back to displaying the ls man page. It was possible to run
>> "info coreutils ls", and the coreutils man page tried that later on. This
>> failed in other cases, which led to the current (awkward) formulation in
>> which the ls man page references "info '(coreutils) ls invocation'".
>> Eventually, dpkg's install-info was replaced by the actual texinfo
>> install-info, so a simple "info ls" also works again.
>>
>> TL;DR: man pages referencing info pages which are just man pages shouldn't
>> be a thing anymore.
>
>Does 'info make' giving a man page fit your explanation?

No, that's a different case. make suggests, but does not require, 
make-doc. If you don't have make-doc installed, you won't get the info 
page. Splitting them is for practical reasons--because a lot more people 
have make installed as a dependency than actually write makefiles, and 
the info docs are actually larger than the entire make package--and 
policy reasons--the make docs have a non-free license. I will file a bug 
suggesting that the man page reference the online docs.

Mike Stone

Thread

Online copies of textinfo content available? Richard Owlett <rowlett@cloud85.net> - 2018-10-26 16:50 +0200
  Re: Online copies of textinfo content available? Brian <ad44@cityscape.co.uk> - 2018-10-26 17:10 +0200
  Re: Online copies of textinfo content available? Michael Stone <mstone@debian.org> - 2018-10-26 17:10 +0200
  Re: Online copies of textinfo content available? David Wright <deblis@lionunicorn.co.uk> - 2018-10-26 17:50 +0200
  Re: Online copies of textinfo content available? Gene Heskett <gheskett@shentel.net> - 2018-10-26 19:30 +0200
    Re: Online copies of textinfo content available? Brian <ad44@cityscape.co.uk> - 2018-10-26 20:20 +0200
      Re: Online copies of textinfo content available? mick crane <mick.crane@gmail.com> - 2018-10-27 10:20 +0200
        Re: Online copies of textinfo content available? David Wright <deblis@lionunicorn.co.uk> - 2018-10-29 17:00 +0100
          Re: Online copies of textinfo content available? Erik Christiansen <dvalin@internode.on.net> - 2018-11-02 05:00 +0100
      Re: Online copies of textinfo content available? Erik Christiansen <dvalin@internode.on.net> - 2018-10-29 07:30 +0100
    Re: Online copies of textinfo content available? rhkramer@gmail.com - 2018-10-26 20:20 +0200
      Re: Online copies of textinfo content available? Greg Wooledge <wooledg@eeg.ccf.org> - 2018-10-26 20:30 +0200
        Re: Online copies of textinfo content available? rhkramer@gmail.com - 2018-10-26 22:00 +0200
          Re: Online copies of textinfo content available? David <bouncingcats@gmail.com> - 2018-10-27 00:50 +0200
    Re: Online copies of textinfo content available? Erik Christiansen <dvalin@internode.on.net> - 2018-10-29 07:30 +0100
  Re: Online copies of textinfo content available? Dennis Wicks <wix@mgssub.com> - 2018-10-26 22:20 +0200
    Re: Online copies of textinfo content available? Greg Wooledge <wooledg@eeg.ccf.org> - 2018-10-26 22:20 +0200
      Re: Online copies of textinfo content available? Dennis Wicks <wix@mgssub.com> - 2018-10-26 22:30 +0200
    Re: Online copies of textinfo content available? John Hasler <jhasler@newsguy.com> - 2018-10-26 22:30 +0200
    Re: Online copies of textinfo content available? Brian <ad44@cityscape.co.uk> - 2018-10-26 23:50 +0200
      Re: Online copies of textinfo content available? rhkramer@gmail.com - 2018-10-27 00:10 +0200
        Re: Online copies of textinfo content available? Brian <ad44@cityscape.co.uk> - 2018-10-27 00:20 +0200
          Re: Online copies of textinfo content available? rhkramer@gmail.com - 2018-10-27 03:40 +0200
            Re: Online copies of textinfo content available? Curt <curty@free.fr> - 2018-10-27 11:10 +0200
              Re: Online copies of textinfo content available? rhkramer@gmail.com - 2018-10-27 15:30 +0200
        Re: Online copies of textinfo content available? John Hasler <jhasler@newsguy.com> - 2018-10-27 01:10 +0200
      Re: Online copies of textinfo content available? Erik Christiansen <dvalin@internode.on.net> - 2018-10-29 07:40 +0100
        Re: Online copies of textinfo content available? David Wright <deblis@lionunicorn.co.uk> - 2018-10-29 16:30 +0100
          Re: Online copies of textinfo content available? Brian <ad44@cityscape.co.uk> - 2018-10-29 21:20 +0100
          Re: Online copies of textinfo content available? Michael Stone <mstone@debian.org> - 2018-10-29 21:30 +0100
            Re: Online copies of textinfo content available? Brian <ad44@cityscape.co.uk> - 2018-10-29 22:00 +0100
              Re: Online copies of textinfo content available? Michael Stone <mstone@debian.org> - 2018-10-29 22:20 +0100
            Re: Online copies of textinfo content available? Curt <curty@free.fr> - 2018-10-30 09:40 +0100

csiph-web