[docs] Tag arg auto-finding question

Jon Jensen jon at endpoint.com
Thu Oct 27 01:21:13 EDT 2005


On Thu, 27 Oct 2005, Davor Ocelic wrote:

>> Doesn't your xmldocs code automatically dig through usertags to look for
>> references to %$opt and then generate stubs for the various arguments?
>> Maybe I'm imagining you put more magic there than really happened. Mike's
>> recent changes to [email] (the "html" arg, for example) aren't in xmldocs,
>> even as stubs.
>>
>> If not, that's fine -- I just wanted to check.
>
> No, see, there is a script for such a thing, 'bin/findtagopts', but it
> works in offline mode.
>
> I used it once to generate stubs, and I supposed the initial results would be
> manually monitored for changes.
>
> The thing is that the script can't possibly catch all uses (without becoming
> a philosophy in itself), because at many places you have $opt->{$name} and
> $name is almost never $name = 'somename' but comes from all kinds of sources;.

Ok, that makes sense.

Thanks,
Jon


More information about the docs mailing list