how to wrangle the "doc" system when writing a class?

조회 수: 1 (최근 30일)
Ben Mitch
Ben Mitch 2011년 10월 13일
Hi
I have written a class which is quite complex (hundred or so methods). It exposes two public interfaces; one is to the framework within which it functions, the other is to the user. When I run "doc MyClass", the "Method Summary" provides an alphabetical list of all public methods.
Now, the ability to to "doc MyClass" and have HTML help automatically generated is fantastic, saves me a lot of double-documenting. But... my users are only supposed to see a handful of the methods.
i) Can I hide all the framework methods? They do not appear under Method Summary if I make them private, but that makes them inaccessible to the framework.
ii) Can I generally take more control of what appears on the front page of "doc MyClass"? If I could author all of that myself, the nice linked-to pages for each method would make for a natty set of documentation. At least, can I take control over what appears (and in what order) under Method Summary?
Thanks!
  댓글 수: 1
Ben Mitch
Ben Mitch 2011년 10월 13일
ps. i realise that i can author the top section of the doc page by providing comments at the top of the file, but if i have to list all the methods manually there that kind of takes the automatisation out of the process. plus, i'll still be left with the "Method Summary" section underneath with all the spurious methods - what am I to do, tell the reader "do not read below this line!"? :)

댓글을 달려면 로그인하십시오.

답변 (0개)

카테고리

Help CenterFile Exchange에서 Whos에 대해 자세히 알아보기

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!

Translated by