1. Forum
  2. FidoNet
  3. comp.unix.shell

  • Re: Documentation (man, info, etc.) (was Re: The Bash Hacker?s Wiki)

    From Yeechang Lee@3:633/10 to All on Tuesday, November 04, 2025 02:37:55
    Janis Papanagnou wrote:
    (BTW; hasn't anyone yet created an info2man converter?

    I have had this in ~/.bashrc for years:

    function mani () { info $1 --subnodes --output - | less; }


    --- PyGate Linux v1.5
    * Origin: Dragon's Lair, PyGate NNTP<>Fido Gate (3:633/10)
  • From Kenny McCormack@3:633/10 to All on Tuesday, November 04, 2025 10:57:31
    In article <slrn10gjls3.591.ylee@columbia.edu>,
    Yeechang Lee <ylee@columbia.edu> wrote:
    Janis Papanagnou wrote:
    (BTW; hasn't anyone yet created an info2man converter?

    I have had this in ~/.bashrc for years:

    function mani () { info $1 --subnodes --output - | less; }


    That's not bad. A couple of notes from my "just now" testing:

    1) Needs better error handling if the node doesn't exist. I tried
    running it for "gawk" (on a system where GAWK was not installed at the
    system level) and it generated a blank screen.

    Note that "info gawk" (without the fancy options and piping as above)
    gets to a screen telling you about the nodes that do exist. But
    somehow, this screen gets lost in the shuffle when the above options and
    piping are used.

    2) You need "less -R", or else you get weird stuff displayed by less.

    P.S. Hmmm. I just tried "info gawk" on a system where GAWK *is* installed
    at the system level and it still bombed out. Weird.

    --
    https://en.wiktionary.org/wiki/res_ipsa_loquitur

    --- PyGate Linux v1.5
    * Origin: Dragon's Lair, PyGate NNTP<>Fido Gate (3:633/10)
  • From Lawrence D?Oliveiro@3:633/10 to All on Tuesday, November 04, 2025 21:04:09
    On Tue, 4 Nov 2025 02:37:55 -0800, Yeechang Lee wrote:

    I have had this in ~/.bashrc for years:

    function mani () { info $1 --subnodes --output - | less; }

    Here?s a handy example command for viewing a man page in a nicely typeset rendering:

    gunzip -c $(man -w bash) | groff -ktman -Tpdf | okular -

    What would be an equivalent for info?

    --- PyGate Linux v1.5
    * Origin: Dragon's Lair, PyGate NNTP<>Fido Gate (3:633/10)
  • From Kenny McCormack@3:633/10 to All on Tuesday, November 04, 2025 22:56:42
    In article <10edpo8$3tq9g$6@dont-email.me>,
    Lawrence DOliveiro <ldo@nz.invalid> wrote:
    On Tue, 4 Nov 2025 02:37:55 -0800, Yeechang Lee wrote:

    I have had this in ~/.bashrc for years:

    function mani () { info $1 --subnodes --output - | less; }

    Heres a handy example command for viewing a man page in a nicely typeset >rendering:

    gunzip -c $(man -w bash) | groff -ktman -Tpdf | okular -

    What would be an equivalent for info?

    I don't know, but here is a simpler version of the above pipeline:

    man -Tpdf bash | xpdf /dev/stdin

    --
    The randomly chosen signature file that would have appeared here is more than 4 lines long. As such, it violates one or more Usenet RFCs. In order to remain in compliance with said RFCs, the actual sig can be found at the following URL:
    http://user.xmission.com/~gazelle/Sigs/Aspergers

    --- PyGate Linux v1.5
    * Origin: Dragon's Lair, PyGate NNTP<>Fido Gate (3:633/10)