edoc and -compile(export_all)
Michael McDaniel
erlangX@REDACTED
Fri Aug 18 17:27:15 CEST 2006
On Fri, Aug 18, 2006 at 05:23:17PM +0200, Richard Carlsson wrote:
> Michael McDaniel wrote:
> > I would like to see edoc recognize -compile(export_all) when using
> > a (your choice) option.
> >
> > There are times when I would like to make my docs for *all* funs.
> > Enabling the special case using an option would be useful to me.
> > That way I can make my "internal docs" that I then remove from the
> > public doc package I deliver.
>
> Note that there already is an option for generating 'private'
> documentation (i.e., that also lists non-exported functions).
>
> The option in question here would cause functions in modules
> that contain -compile(export_all) to be shown exactly as if
> they were listed in proper -export([...]) declarations, even
> in the public documentation.
>
> > I also like that edoc reminds me when I forget to drop the export_all
> > so I like the default case of empty page.
>
> If you just use export_all to tweak the behaviour of edoc,
> then try using the 'private' option instead.
>
> /Richard
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Thanks, Richard. Looks like my comments/desires are all addressed
with the current edoc. It may be apparent from my previous comments
that I have not used edoc heavily (though have used it some).
~M
More information about the erlang-questions
mailing list