[Laszlo-dev] For Review: Change 20080710-dda-6 Summary: doc navbar: fix Classes tab for classes that have tagnames

[Donald Anderson]

Tucker - can you review this?  I just committed it,
so you'd be able to see the results in a doc build tonight.

I also wanted to restart the discussion on lz.* naming -
perhaps a phone call to make some decisions.
   (i.e. for classes that have no tagname, camelcase vs. lowercase?)

There are also some oddities - tagnames that start with upper case.

$ grep -nH -e '<title>&lt;[A-Z]' *.html
lz.DebugObject.html:8:      <title>&lt;DebugObject&gt;</title>
lz.LzTextFormat.html:8:      <title>&lt;LzTextFormat&gt;</title>
lz.SyncTester.html:8:      <title>&lt;SyncTester&gt;</title>
lz.Test.html:8:      <title>&lt;Test&gt;</title>
lz.TestCase.html:8:      <title>&lt;TestCase&gt;</title>
lz.TestResult.html:8:      <title>&lt;TestResult&gt;</title>
lz.TestSuite.html:8:      <title>&lt;TestSuite&gt;</title>
lz.XMLHttpRequest.html:8:      <title>&lt;XMLHttpRequest&gt;</title>


<LzTextFormat> looks like it may be a javadoc error?
Also if we look at the page for LzContextMenu, the text of
the javadoc talks about <LzContextMenu>, which seems like an
error.  <LzContextMenuItem> is the same way.

- Don

On Jul 10, 2008, at 11:22 AM, Donald Anderson wrote:

> Change 20080710-dda-6 by dda at lester.local on 2008-07-10 10:52:01 EDT
>     in /Users/dda/laszlo/src/svn/openlaszlo/trunk-doc5
>     for http://svn.openlaszlo.org/openlaszlo/trunk
>
> Summary: doc navbar: fix Classes tab for classes that have tagnames
>
> New Features:
>
> Bugs Fixed: LPP-6588 (Clean up reference 'left nav' to uniformly use  
> <tagname> and lz.classname) (partial)
>
> Technical Reviewer: ptw (pending)
> QA Reviewer: (pending)
> Doc Reviewer: (pending)
>
> Documentation:
>
> Release Notes:
>
> Details:
>     Changed doc script so that when building the 'Classes' nav tag,
>     we always use the name lz.tagname whenever there is an existing  
> tagname.
>
>     Leaving other classes as lz.ClassName until we come to a  
> consensus on naming these.
>
> Tests:
>
> Files:
> M      docs/src/reference/navbuilder/navxmlbuilder.rb
>
> Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20080710-dda-6.tar
>
>
>
> --
>
> Don Anderson
> Java/C/C++, Berkeley DB, systems consultant
>
> voice: 617-547-7881
> email: dda at ddanderson.com
> www: http://www.ddanderson.com
>
>
>


--

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/20080714/b5e1d4f5/attachment.html