Mathematica Stack Exchange is a question and answer site for users of Mathematica. It's 100% free, no registration required.

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

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?

share|improve this question
This happens to me occassionally as well... just close the windows and reopen the documentation center. It's possibly some obscure FE bug – R. M. Dec 12 '13 at 2:18
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. – Oleksandr R. Dec 12 '13 at 8:54
Have you reported this to WRI? – Kuba Apr 28 '14 at 6:57
@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. – fairflow Apr 28 '14 at 9:00
@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. – fairflow Apr 28 '14 at 9:11

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Browse other questions tagged or ask your own question.