From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Scott Goodwin" To: "Bill Brooks" , Subject: RE: marking up Java constructors in docbook Date: Wed, 27 Dec 2000 06:36:00 -0000 Message-id: <000101bff106$c3ef4940$0201a8c0@fountainhead.internal.com> References: X-SW-Source: 2000/msg00286.html Hmmm...although I haven't looked closely at DocBook 4, I did read something about it supporting newer object-oriented languages - yep, here it is in the release notes: - Added synopsis markup for modern programming languages (e.g, object oriented languages like Java, C++, and IDL) And here's the url: http://www.oasis-open.org/docbook/sgml/4.1/40chg.txt s. -----Original Message----- From: Bill Brooks [ mailto:wbrooks@lug.ee.calpoly.edu ] Sent: Tuesday, July 18, 2000 4:49 PM To: docbook-tools-discuss@sourceware.cygnus.com Subject: marking up Java constructors in docbook Hi, How are people doing API-level documentation in DocBook? My immediate need is to produce some documentation of a Java class, in the same way that JavaDoc does, but I need it to play nice inside an overall DocBook manual, so just inserting the HTML that javadoc generates won't do. Eventually, when I get the DocBook markup the way I want it, I'll figure out how to use the XML javadoc doclet and XSLT to transform what javadoc spits out into what I want (in)directly. Anyway, what I'm trying to figure out how to markup a constructor in Java. Here's what I have: StatusCheck ...unfortunately, the appears to be mandatory because if I leave it out I get a syntax error. The Java language doesn't allow one to indicate that a method takes no argument by writing Foo(void). One simply writes Foo(). Does anyone have any suggestions for how to approach marking up a Java class' constructor? Thanks in advance. Bill From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Scott Goodwin" To: "Bill Brooks" , Subject: RE: marking up Java constructors in docbook Date: Tue, 18 Jul 2000 15:23:00 -0000 Message-ID: <000101bff106$c3ef4940$0201a8c0@fountainhead.internal.com> References: X-SW-Source: 2000-q3/msg00084.html Message-ID: <20000718152300.sYX_qE-kYEqRPlBFmqp2PsKpyeqYe0TCIQgS3l4QMx4@z> Hmmm...although I haven't looked closely at DocBook 4, I did read something about it supporting newer object-oriented languages - yep, here it is in the release notes: - Added synopsis markup for modern programming languages (e.g, object oriented languages like Java, C++, and IDL) And here's the url: http://www.oasis-open.org/docbook/sgml/4.1/40chg.txt s. -----Original Message----- From: Bill Brooks [ mailto:wbrooks@lug.ee.calpoly.edu ] Sent: Tuesday, July 18, 2000 4:49 PM To: docbook-tools-discuss@sourceware.cygnus.com Subject: marking up Java constructors in docbook Hi, How are people doing API-level documentation in DocBook? My immediate need is to produce some documentation of a Java class, in the same way that JavaDoc does, but I need it to play nice inside an overall DocBook manual, so just inserting the HTML that javadoc generates won't do. Eventually, when I get the DocBook markup the way I want it, I'll figure out how to use the XML javadoc doclet and XSLT to transform what javadoc spits out into what I want (in)directly. Anyway, what I'm trying to figure out how to markup a constructor in Java. Here's what I have: StatusCheck ...unfortunately, the appears to be mandatory because if I leave it out I get a syntax error. The Java language doesn't allow one to indicate that a method takes no argument by writing Foo(void). One simply writes Foo(). Does anyone have any suggestions for how to approach marking up a Java class' constructor? Thanks in advance. Bill