[Date Prev][Date Next][Thread Prev][Thread Next]
[Date Index]
[Thread Index]
- Subject: Re: Steve Donovan's ldoc: recognized function declaration formats and possible bug
- From: steve donovan <steve.j.donovan@...>
- Date: Mon, 13 Jun 2011 13:54:42 +0200
On Mon, Jun 13, 2011 at 1:45 PM, Lorenzo Donati
<lorenzodonatibz@interfree.it> wrote:
> Of course not for building API documentation, but for "in-house"
> documentation. Sometimes it happens that a long module has to be
> refactored/changed/extended and some of its "private" local functions are to
> be reused (or made public).
This is a good argument. I would suggest however that such private
functions/tables/etc live in their own 'documentation namespace', e.g.
'Local Functions' so that the external user of the API won't be
confused.
steve d.