<html><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">Okay Lou, this is committed (see the recent review).<div>It's all yours.</div><div><br></div><div>- Don</div><div><br><div><div>On Sep 11, 2008, at 7:25 AM, Lou Iorio wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">Hi Don,<div><br></div><div>This sounds like a good solution. I did know about the processing instruction:</div><div><br></div><div><div><?dbhtml filename="name.html" ?></div><div><br></div><div>but I did not know until now that it took precedence over the id. </div><div><br></div><div>I won't make any changes until you finish yours.</div><div><br></div><div>thanks,</div><div><br></div><div>Lou</div><div><br></div><div><div>On Sep 10, 2008, at 5:28 PM, Donald Anderson wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">Hi Lou,<div><br></div><div>Good news. After some time prodding and experimenting, I think the best way to do this without<div>breaking the world is in our xsl templates.</div><div><br></div><div>The filename is currently keying on the id attribute in the parent property of the class.</div><div>Changing js2doc to emit a different id didn't work out very well, the for js2doc to work</div><div>as currently designed, the id needs to be predictable based on the original type name.</div><div>Changing that would need some more js2doc hacking and perhaps lots of lfc changes.</div><div><br></div><div>Anyway, there is a docbook processing instruction that leaves the ids intact and allows</div><div>us to control the output file name separately, and we can generate that processing instruction</div><div><div>in the xsl. That only breaks a few things, and I'm in the middle of fixing them.</div><div><br></div><div>I don't expect I'll be finished before I'm out for a long weekend, so it should be sometime</div><div>Tues or Wed next week before I have something for review. I can't publish a partial fix</div><div>since it will break the build (one of the things broken is the toc.xml/classes.xml/tags.xml</div><div>generation and checking).</div><div><br></div><div>- Don</div><div><div><div><br><div><div>On Sep 7, 2008, at 9:57 AM, Lou Iorio wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><br><div><div>On Sep 3, 2008, at 10:13 AM, Donald Anderson wrote:</div></div><div><blockquote type="cite"><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><div><div><div><br></div><div>Does that do the trick?</div></div></div></div></div></blockquote><div><br></div>It only solves a small part of the problem, since a class name may be inside a <code> or</div><div><literal> tag, and it might have no markup at all (or markup I don't know about). Also, the reference </div><div>may be to a class method, like LzClass.method().</div><div><br></div><div>It would be much easier if the file names matched the class and tag names, for example,</div><div>lz.BrowserService would be in lz.BrowserService.html instead of LzBrowserService.html.</div><div><br></div><div>I'm not clever enough to figure out how the file names are constructed, but I suspect it's part</div><div>of the JS2Doc process (JS2Doc.java perhaps?). Also, whatever is generating, for example, this:</div><div><br></div><div><div><div class="refentry" lang="en"><a name="LzBrowserService"></a><div class="titlepage"></div></div><div><br></div><div>in the HTML would need to change.</div><div><br></div><div>This change would make a global search and replace possible, and wouldn't break any</div><div>links. Without this change, I need to go through all the .lzs and .lzx files and deal with each</div><div>occurrence of Lz[a-zA-Z0-9] one at a time. I suspect this process would take weeks, and</div><div>be highly error prone, but I also have no idea how much work it is to change the file names</div><div>and ids.</div><div><br></div><div>Lou</div></div></div></blockquote><br></div><div><br></div><div apple-content-edited="true"><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; "><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div>--</div><div><br>Don Anderson<br>Java/C/C++, Berkeley DB, systems consultant<br><br>voice: 617-547-7881<br>email: <a href="mailto:dda@ddanderson.com">dda@ddanderson.com</a><br>www: <a href="http://www.ddanderson.com/">http://www.ddanderson.com</a><br></div></div></span></span><br class="Apple-interchange-newline"></div></span></div></span><br class="Apple-interchange-newline"> </div><br></div></div></div></div></div></div></blockquote></div><br></div></div></blockquote></div><br><div> <span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; "><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><br class="Apple-interchange-newline">--</div><div><br>Don Anderson<br>Java/C/C++, Berkeley DB, systems consultant<br><br>voice: 617-547-7881<br>email: <a href="mailto:dda@ddanderson.com">dda@ddanderson.com</a><br>www: <a href="http://www.ddanderson.com/">http://www.ddanderson.com</a><br></div></div></span></span><br class="Apple-interchange-newline"></div></span></div></span><br class="Apple-interchange-newline"> </div><br></div></body></html>