3 ms·
Info is the best documentation system so far. Use 's' for search (or '/'). Try 'm' for menu,'i' for index, or 'g' for go-to node. 't' for top. Info manuals a
by spit2wind 3y ago
Info is the best documentation system so far.
Use 's' for search (or '/').
Try 'm' for menu,'i' for index, or 'g' for go-to node. 't' for top.
Info manuals are like HTML websites except actually navigable. No menu on the left that contains 10,000 hits for the search term. It's paginated, yet searchable across pages. Well written Info docs (anything core GNU) are indexed so that pressing 'i' usually gets you there.
For example, ever try to find something in the Python docs? Almost impossible and the HTML search is useless. Using Info format, you can bind together related information that's spread across separate parts of the documentation. And that's using a converted version, not something intended for Info. (Sphinx has Info as an output option.)
It feels like people's reactions to Info is often, "I don't know this, therefore it's dumb". That's a shame because it's hand-down the best format. "Modern" development could learn a few things from it.