[erlang-questions] Edoc question

Robert Virding rvirding@REDACTED
Thu Sep 25 02:24:52 CEST 2008


2008/9/22 Richard Carlsson <richardc@REDACTED>

> Robert Virding wrote:
> > - For my applications I would like to write an extended description of
> > the system in the overview and need the full formatting in the overview.
> > Edoc itself does this by having a user's guide, this would be
> > acceptable, while yecc puts everything into description of the yecc
> > module, which I think is the wrong place for it.
>
> I also think that the high-level description should go in the overview,
> and that is how I write my docs. I just wonder what you mean by "the
> full formatting"? The contents of the overview file are parsed just like
> a source code comment (without the leading % characters), and there is
> not much difference between what you can do in a module @doc and an
> overview @doc. You have the same wiki expansion, macros, and of course
> full xhtml for anything else you might need, such as tables. The
> overview.edoc file for edoc itself should be a decent reference.


I will try it some more and see if I can get it to work. There is no
overview.edoc file for edoc in the distribution, from where can I get it?

How do I setup edoc so it will not look in my src directory but use the
.edoc files in my doc directory instead?

Robert
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://erlang.org/pipermail/erlang-questions/attachments/20080925/d6e4ff74/attachment.htm>


More information about the erlang-questions mailing list