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

closed as off-topic by Louis, MarcoB, RunnyKine, Öskå, m_goldberg Mar 17 at 14:11

This question appears to be off-topic. The users who voted to close gave this specific reason:

  • "The question is out of scope for this site. The answer to this question requires either advice from Wolfram support or the services of a professional consultant." – Louis, MarcoB, RunnyKine, Öskå, m_goldberg
If this question can be reworded to fit the rules in the help center, please edit the 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