|
|
Subscribe / Log in / New account

Emacs and changing documentation formats

Emacs and changing documentation formats

Posted Dec 11, 2014 11:08 UTC (Thu) by drothlis (guest, #89727)
In reply to: Emacs and changing documentation formats by dgm
Parent article: Emacs and changing documentation formats

What IDE do you use at the moment, and how does its context help for Makefiles and Bash work?


to post comments

Emacs and changing documentation formats

Posted Dec 11, 2014 11:24 UTC (Thu) by drothlis (guest, #89727) [Link]

To tie this back to the grandparent commenter asking "are indices really that useful?": For a language like Python the IDE can offer some degree of contextual help based on introspecting the standard library. For Bash, Make, C++, and many others, this isn't possible so you need indexed documentation.

Furthermore, indexed documentation gives you things that introspection doesn't -- I often find myself looking up the documentation for Python keywords, standard exception hierarchy, etc etc etc. None of which I can get from ipython's contextual help, at least.

Emacs and changing documentation formats

Posted Dec 11, 2014 15:11 UTC (Thu) by nix (subscriber, #2304) [Link]

I use Emacs, of course. Its context help for makefiles and bash... well, if they were usefully parsable, it would use their Info manuals (since of course they have Info manuals). They're not, so I have to open the manuals myself and hit 'i' to look in the index. The horror!


Copyright © 2025, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds