Re: [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 [EMAIL PROTECTED] 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: [EMAIL PROTECTED]
www: http://www.ddanderson.com

--

Don Anderson
Java/C/C++, Berkeley DB, systems consultant

voice: 617-547-7881
email: [EMAIL PROTECTED]
www: http://www.ddanderson.com