I stumbled on some strange behaviour when trying out the new function template and documentation features, now purportedly working in v 9.0.1. I defined a function f and f::usage="f[x] does something to x". Typing f and then Cmd+Shift+K pulls up a tab and, as with built-in functions, there is an area marked Documentation underneath the completion section. Clicking on that (I always wanted an easy way to extend the built-in documentation; the approach described in this question is rather too much of a meal for me) I was given what looks like a notebook view on a directory (the directory shown is the working directory for my notebook): Opening a directory

Feeling foolhardy, I thought I'd try to save it (well, I do have a recent bootable backup, TM snapshots and my files are under git/Dropbox control): Undocumented feature(?) -> error message

I was relieved to find that the file could not be written, as it seems to correspond to a directory, which I don't think you can open via the front end and I hope can't be directly written in that way either? It can be "saved as", default being Consultancy.txt

So, to my question: bug or (undocumented?) feature? Can I use this to do something useful for documentation of my own functions?

  • $\begingroup$ This happens to me occassionally as well... just close the windows and reopen the documentation center. It's possibly some obscure FE bug $\endgroup$ – rm -rf Dec 12 '13 at 2:18
  • $\begingroup$ Doesn't seem to happen with the Windows FE. If I had to guess, I'd say it indeed looks like some sort of bug. $\endgroup$ – Oleksandr R. Dec 12 '13 at 8:54
  • $\begingroup$ Have you reported this to WRI? $\endgroup$ – Kuba Apr 28 '14 at 6:57
  • $\begingroup$ @Kuba no, it was some way down my stack of bugs to report at the time and the stack got deeper in the meantime :-) Also, as rm -rf seems to have misunderstood the behaviour I'm reporting I thought it might be difficult to give clear enough instructions for the problem to be reproduced. $\endgroup$ – fairflow Apr 28 '14 at 9:00
  • $\begingroup$ @rm-rf I'm not sure if you've understood me here, because this wasn't something that just happened to me, I had to work at it. To clarify: the little box that comes up with the documentation of a built-in function does not appear automatically, but Cmd+Shift+K brings it up anyway, and that's when this strange behaviour occurs if you click on "Documentation". Same issue if I start with a fresh MMA. $\endgroup$ – fairflow Apr 28 '14 at 9:11