David Holdaway

The "screen shot" is a set of Young diagrams which are a graphical representations of the sets the program calculates. The image is not generated by the program, it is a publicly available file on the Wikipedia commons, it's just a lot more interesting than pasting a screen shot of a table of numbers.

I will edit the file so the help is displayed as suggested, personally I never use help and just open any file and read the comments but if other people do it seems sensible to change that.

The input checking and explanation are very nice, I almost feel bad that I would almost certainly just inline the one line of calculation
"c = floor(exp(gammaln(n+1) - sum(gammaln(k+1),dim)) + .5); "
whenever I use it though!

is it possible to use it for probabilistic Hermite?I want to integrate f(x)*exp(-(x^2)/2)dx?

The "screen shot" is a set of Young diagrams which are a graphical representations of the sets the program calculates. The image is not generated by the program, it is a publicly available file on the Wikipedia commons, it's just a lot more interesting than pasting a screen shot of a table of numbers.

I will edit the file so the help is displayed as suggested, personally I never use help and just open any file and read the comments but if other people do it seems sensible to change that.

There is still a problem with the help here. While there is a fair amount of help, what happens when you try to access it?

>> help intpartgen
lists all partitions of all integers up to N

>>

Yes, that is all you see. But if you edit the code, you find there is much more to be learned.

function intlist = intpartgen(N,maxnum,intlist)
%lists all partitions of all integers up to N

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

% i.e. all the possible ways to express N as a sum of independent integers
% e.g. 3 = {3,2+1,1+1+1}, 4={4,3+1,2+1+1,2+2,1+1+1+1}...
%stored as 1d cell array with each cell containing

... yada, yada, yada, ...

The problem is, David has left blank lines in the help block. MATLAB dumps out only the FIRST CONTIGUOUS block of comments in a file. When you leave a blank, empty line, with no % in the beginning, this is a signal to the help utility to end the help.

So the only way to learn how to use these tools is to edit the code, or type it to the command window. Enticing the user to edit your code is a bad idea, as what if they accidentally modify it?

The point is, make it easy for help to work. Instead of a blank line between paragraphs, put in a blank comment line instead. The effort you spent on writing the help is wasted otherwise, as only you know it is there.