I'm very happy to announce that LotusScript.doc v.2 is finally done
I'm very happy to announce that LotusScript.doc v.2 is done - finally! The official point-zero release is available for immediate download. It's been a looooooooooong process and it's taken a very long time but it's finally done. You may download it here (lsdoc_200.zip).
Thanks to all those who have supported and encouraged me during the development. A very special thanks goes out to the people who donated - thank you!
Part of this release is also the website which I'm working on. The website is currently available at blog.lsdoc.org. Once everything is done it will be moved over and replace the current www.lsdoc.org. As I've mentioned before version 2 is written in Java and you may actually use the LotusScript.doc code as a general LotusScript code parser if you wish. Quite easy actually - for a sneak peek as to how to use the API see the Using the LotusScript.doc API page.
Comments as always welcome here on the blog or by e-mail to lekkim [at] lsdoc [dot] org.
Re: I'm very happy to announce that LotusScript.doc v.2 is finally done
On your blog.lsdoc.org, change the first sentence (from "LotusScript aims to be for LotusScript what javadoc is for Java...") to "LotusScript.doc aims to be for LotusScript what javadoc is for Java..."</div> <div></div> <div>Cheers, Tony.</div>
Re: I'm very happy to announce that LotusScript.doc v.2 is finally done
But I've discovered two problems:
If a constant is just an other constant, it is omitted in output. e.g.
- Public Const ITEM_FC_CONTRACT_PARTNER = "ContractPartner" <-- is included
- Public Const ITEM_CSN_CONTRACT_PARTNER = ITEM_FC_CONTRACT_PARTNER <-- is omitted
Nearly the same happens, if a constant consists of an other constant. e.g.
- Public Const ITEM_FC_CONTRACT_PARTNER = "ContractPartner" <-- is included
- Public Const ITEM_PL_CONTRACT_PARTNER = "PL_" & ITEM_FC_CONTRACT_PARTNER <-- only returns "PL_" instead of "PL_ContractPartner"
Re: I'm very happy to announce that LotusScript.doc v.2 is finally done
Performance improvements are massive:
- v1.2: 119 min
- v2.0: 1 min
Re: I'm very happy to announce that LotusScript.doc v.2 is finally done
Hello
I get an exception for some databases. Any idea?
[ROOT ][SEVERE ]: Exception trying to parse database Exception:
org.lsdoc.Parser$NotesExceptionWrapper
at org.lsdoc.Parser.doParse(Parser.java:249)
at org.lsdoc.Parser.parseDatabase(Parser.java:98)
at org.lsdoc.runner.notes.NotesAgent.NotesMain(NotesAgent.java:156)
at org.lsdoc.runner.notes.DcNotesAgent.execute(DcNotesAgent.java:40)
at JavaAgent.NotesMain(Unknown Source)
at lotus.domino.AgentBase.runNotes(Unknown Source)
at lotus.domino.NotesThread.run(Unknown Source)
Re: I'm very happy to announce that LotusScript.doc v.2 is finally done
If that completes successfully enable logging as described here http://blog.lsdoc.org/?page_id=43 in the Debugging section.
Let me know how it goes at lekkim[at]lsdoc.org.
Re: I'm very happy to announce that LotusScript.doc v.2 is finally done
Some bugs:
1) Multi-line Sub/Function declaration (with continuity marker) is not supported:
Sample definition:
<code>Public Sub Foo(Byval s1 As String, _</code><code>Byval s2 As String, _
Byval s3 As String) </code>
2)Output HTML: Parameter(s) "<code>" is not being paired with "</code>"; it's being paired with another "<code>" and so the remaining texts (functions, subs) after it are being rendered as "<code>"
Sample output:
<code><b>Parameter(s):</b>
<dd>
<code>file<code> - String. the complete path of the file to save the generated XML file. </code>[and the rest of the content is rendered in code style...]
Re: I'm very happy to announce that LotusScript.doc v.2 is finally done
To have a better view of the points raised, please generate a LotusScript.doc output first (this code being the target) and run thru all the RED MARKS in output html, particularly in FooClass, DerivedFooClass1, DerivedFooClass2 and DerivedFooClass3.
here's the file:
http://www.fileden.com/files/2007/12/7/1629991/lsdocv2_MockObjectCode.lss
by the way, thanks for this wonderful tool. truly a winner!
tschuss!
Re: I'm very happy to announce that LotusScript.doc v.2 is finally done
Hi Mikkel. First of all thanks for great tool. I'm faced with some problems:
' * @param strIn xxxxxxxxxxxxx. generates <code>strIn<code> - xxxxxxxxxxx (... instead of <code>StrIn</code>)
when generating documentation with Notes 7.0.2, i get "<span style="FONT-FAMILY: courier; FONT-SIZE: 0.9em"><font size="3">Public ${le.class.simpleName} queryOpen" instead of "<span style="WIDOWS: 2; TEXT-TRANSFORM: none; TEXT-INDENT: 0px; BORDER-COLLAPSE: separate; FONT: medium 'Times New Roman'; WHITE-SPACE: normal; ORPHANS: 2; LETTER-SPACING: normal; COLOR: rgb(0,0,0); 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" class="Apple-style-span"><span style="FONT-FAMILY: courier; FONT-SIZE: 12px" class="Apple-style-span">Public Sub queryOpen ( docType As Integer , source As NotesUIDocument , xx As Variant )</span></span>"</font></span>
It would be also great not to scrictly parse @error as <err number> <err msg> since I often use constants ERR_... instead of number 1234...