[Laszlo-dev] For Review: Change 40495 Summary: Integrate 39317 and parse-tree printer from legals

[John Sundman]

I don't think we need a doctools person, at  least not to implement the 
current regime.  We just need a few tweaks here and there.

If we were to move over to pure docbook and generalize the tools for 
community use, why yes, then we could use some more dedicated tools 
help.
However, what I'm suggesting should be pretty simple, I think, and it 
would prevent the case, which we have seen from time to time, when new 
tags get into the language and don't have any documentation at all.   
Sometimes I myself haven't known they existed.  If the tools checked, 
then at least we would be guaranteed that the minimal docs would be 
there, and I could flesh them out as time permitted.

jrs

On Mar 13, 2006, at 5:25 PM, P T Withington wrote:

> If wishes were horses, Jim would hire you a doc tool person.  :P
>
> On 2006-03-13 17:10 EST, John Sundman wrote:
>
>> I wish the tools would enforce the discipline that you can't add a new
>> tag to the schema without creating a wrapper page for the docs.
>>
>> jrs
>>
>> On Mar 13, 2006, at 4:24 PM, P T Withington wrote:
>>
>>> Did it ever complain on undoc-ed params?  I think not, because there
>>> are some 'hidden' params that we didn't want to doc.  It does
>>> complain if you doc a param that does not exist.
>>>
>>> On 2006-03-13 16:14 EST, Max Carlson wrote:
>>>
>>>> Sorry - meant to reply all before...
>>>>
>>>> I now get a warning when method documentation is missing entirely, 
>>>> but
>>>> not when method signatures don't match the comment...  To
>>>> reproduce, try
>>>> deleting one of the arguments in a method comment and the build 
>>>> should
>>>> still run successfully.
>>>>
>>>> -Max
>>>>
>>>> P T Withington wrote:
>>>>> Change 40495 by ptw at ptw-dev-four on 2006/03/13 05:38:17 *pending*
>>>>>
>>>>>     Summary: Integrate 39317 and parse-tree printer from legals
>>>>>         Technical Reviewer: max (pending)
>>>>>     QA Reviewer: frisco (pending)
>>>>>     Doc Reviewer: jsundman (pending)
>>>>>         Details: Makes doc errors work again
>>>>>         Tests: Got a readable error for cssColorToLong:
>>>>>     [exec] "views/LzDrawView.as":541:1:
>>>>>     org.python.proxies.__main__$DocumentationError$0:
>>>>>     LzDrawView.cssColorToLong: missing documentation
>>>>>
>>>>> Affected files ...
>>>>>
>>>>> ... //depot/lps-dev/WEB-INF/lps/server/sc/jsdoc2xml.py#5 integrate
>>>>> ...
>>>> //depot/lps-dev/WEB-INF/lps/server/src/org/openlaszlo/sc/
>>>> Compiler.java#6
>>>> edit
>>>>> ...
>>>> //depot/lps-dev/WEB-INF/lps/server/src/org/openlaszlo/sc/
>>>> CompilerError.java#1
>>>> integrate
>>>>>
>>>>>
>>>>
>>>>
>>>> -- 
>>>> Regards,
>>>> Max Carlson
>>>> OpenLaszlo.org
>>>>
>>>> _______________________________________________
>>>> Laszlo-dev mailing list
>>>> Laszlo-dev at openlaszlo.org
>>>> http://www.openlaszlo.org/mailman/listinfo/laszlo-dev
>>>
>>> _______________________________________________
>>> Laszlo-dev mailing list
>>> Laszlo-dev at openlaszlo.org
>>> http://www.openlaszlo.org/mailman/listinfo/laszlo-dev
>>
>> _______________________________________________
>> Laszlo-dev mailing list
>> Laszlo-dev at openlaszlo.org
>> http://www.openlaszlo.org/mailman/listinfo/laszlo-dev
>