[Laszlo-dev] LzName to lz.name

[Lou Iorio]

Hi Don,

This sounds like a good solution. I did know about the processing  
instruction:

<?dbhtml filename="name.html" ?>

but I did not know until now that it took precedence over the id.

I won't make any changes until you finish yours.

thanks,

Lou

On Sep 10, 2008, at 5:28 PM, Donald Anderson wrote:

> Hi Lou,
>
> Good news.  After some time prodding and experimenting, I think the  
> best way to do this without
> breaking the world is in our xsl templates.
>
> The filename is currently keying on the id attribute in the parent  
> property of the class.
> Changing js2doc to emit a different id didn't work out very well,  
> the for js2doc to work
> as currently designed, the id needs to be predictable based on the  
> original type name.
> Changing that would need some more js2doc hacking and perhaps lots  
> of lfc changes.
>
> Anyway, there is a docbook processing instruction that leaves the  
> ids intact and allows
> us to control the output file name separately, and we can generate  
> that processing instruction
> in the xsl.  That only breaks a few things, and I'm in the middle of  
> fixing them.
>
> I don't expect I'll be finished before I'm out for a long weekend,  
> so it should be sometime
> Tues or Wed next week before I have something for review.  I can't  
> publish a partial fix
> since it will break the build (one of the things broken is the  
> toc.xml/classes.xml/tags.xml
> generation and checking).
>
> - Don
>
> On Sep 7, 2008, at 9:57 AM, Lou Iorio wrote:
>
>>
>> On Sep 3, 2008, at 10:13 AM, Donald Anderson wrote:
>>>
>>> Does that do the trick?
>>
>> It only solves a small part of the problem, since a class name may  
>> be inside a <code> or
>> <literal> tag, and it might have no markup at all (or markup I  
>> don't know about). Also, the reference
>> may be to a class method, like LzClass.method().
>>
>> It would be much easier if the file names matched the class and tag  
>> names, for example,
>> lz.BrowserService would be in lz.BrowserService.html instead of  
>> LzBrowserService.html.
>>
>> I'm not clever enough to figure out how the file names are  
>> constructed, but I suspect it's part
>> of the JS2Doc process (JS2Doc.java perhaps?). Also, whatever is  
>> generating, for example, this:
>>
>> <div class="refentry" lang="en"><a name="LzBrowserService"></a><div  
>> class="titlepage"></div>
>>
>> in the HTML would need to change.
>>
>> This change would make a global search and replace possible, and  
>> wouldn't break any
>> links. Without this change, I need to go through all the .lzs  
>> and .lzx files and deal with each
>> occurrence of Lz[a-zA-Z0-9] one at a time. I suspect this process  
>> would take weeks, and
>> be highly error prone, but I also have no idea how much work it is  
>> to change the file names
>> and ids.
>>
>> Lou
>
>
> --
>
> Don Anderson
> Java/C/C++, Berkeley DB, systems consultant
>
> voice: 617-547-7881
> email: dda at ddanderson.com
> www: http://www.ddanderson.com
>
>
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.openlaszlo.org/pipermail/laszlo-dev/attachments/20080911/c08cc061/attachment-0001.html