--- Leif W <[EMAIL PROTECTED]> wrote:
> Hey,
>
> This thought just occured to me since I'm working on
> the server side stuff at
> the moment. What about the documentation there?
> For example, the client side
> docs for IOElement look pretty complete, but there's
> no server-side docs, just
>
Hey,
This thought just occured to me since I'm working on the server side stuff at
the moment. What about the documentation there? For example, the client side
docs for IOElement look pretty complete, but there's no server-side docs, just
source code with sparse documentation. But in the dialog
--- Dan Willemsen <[EMAIL PROTECTED]> wrote:
>
> Quoting Darin Kadrioski
> <[EMAIL PROTECTED]>:
>
> > http://sourceforge.net/projects/jsdoc/
>
> nice... the only question i have is whether it will
> parse some of the javascript
> that we use in dynapi, some of it isn't all so
> well-formed acco
this is the type of thing I have been planning to do to generate the quickref
documentation, but haven't been able to yet. I just found phpDocumentor
yesterday, and was thinking about writing another parser for it, javascript, but
that looks like to much work for me.
--
Dan Willemsen
http://dan.wi
Quoting Darin Kadrioski <[EMAIL PROTECTED]>:
> http://sourceforge.net/projects/jsdoc/
nice... the only question i have is whether it will parse some of the javascript
that we use in dynapi, some of it isn't all so well-formed according to it's
definition i don't think
--
Dan Willemsen
--
--- Darin Kadrioski <[EMAIL PROTECTED]>
wrote:
> http://sourceforge.net/projects/jsdoc/
Well this is something to look into for those working
on the Docs for DynAPI.
--
Raymond Irving
>
> -Original Message-
> From: [EMAIL PROTECTED]
> [mailto:[EMAIL PROTECTED]
> Behalf Of
> [EMAIL PRO
I like the following layout..
Name Object etc
Syntax
object.method and so on...
Collections and etc.
Methods
Events
Remarks
Howto... and issues
Example
code...
Just my tip of the coin :)
/Daniel
> Documentation Stratagy for DynApi; is there one??
> =
>
>
http://sourceforge.net/projects/jsdoc/
-Original Message-
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED] Behalf Of
[EMAIL PROTECTED]
Sent: Thursday, June 26, 2003 4:36 PM
To: [EMAIL PROTECTED]
Subject: [Dynapi-Dev] Documentation Stratagy for DynApi; is there one??
Documentation Strata
Have you looked at docs/index.html? I've started a
quick reference section that gives some information
about the libraries. That I think is a good place to
start. We could also update documentation the same way
we not do the library files.
PS. I think Juho is also doing some work on the docs,
so
my 2 cents
Christopher Strolia-Davis
-Original Message-
From: Laszlo Teglas [mailto:[EMAIL PROTECTED]]
Sent: Wednesday, November 28, 2001 10:14 AM
To: Dynapi-Dev@lists. sourceforge. net
Subject: RE: [Dynapi-Dev] Documentation structure candidate (was Dan's
widget discussion)
...
B
:
Do we want widgets with our distro???
Once this issue is resolved, I will continue with the documentation.
Hopefully with some help.
NanoFace =;^)
-Original Message-
From: Richard Bennett [mailto:[EMAIL PROTECTED]]
Sent: November 28, 2001 8:31 AM
To: Laszlo Teglas; Dynapi-Dev
Hi
Ok Laszlo, a few comments on the documentation proposal:
The basic layout scheme seems good. I guess some of the parts will change as
they are filled in, but this offers an idea of what still needs to be done.
I'm not so keen on the color choices, I can not really read the red on
orange text,
>You may have misunderstood my post.
Yes, I did. My apologies =;^)
>so the question is, is documentation that looks like this:
> http://www.your-site.com/~rinfo//examples/apiNew/dynapi_8js.html
>In a usable format or not. (Bear in mind that I tried every available
>command, so the output is not p
and
I'll get on with other things in the meantime.
Cheers,
Richard.
- Original Message -
From: "Laszlo Teglas" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Sent: Wednesday, November 21, 2001 5:01 PM
Subject: RE: [Dynapi-Dev] documentation
> >I presume it&#
PROTECTED]
Subject: RE: [Dynapi-Dev] documentation
Totally agree with you. two versions is one too much to maintain
and since DynAPI requires some Javascript-knowledge it shouldn't
be too hard to understand the Doxygen-generated docs.
we could extend the documentation with own keywords, not y
Totally agree with you. two versions is one too much to maintain
and since DynAPI requires some Javascript-knowledge it shouldn't
be too hard to understand the Doxygen-generated docs.
we could extend the documentation with own keywords, not yet
supported by Doxygenm, but could be supported if we
>I presume it's a little quite around the documentation topic because
>everyone's busy writing the docs :o)
Accually I have been coding the documentation structure as I have originally
outlined with the different modules (intro, reference, examples, tuturials).
I don't have enough coded to provid
Keep on doing the rest of the documentation this way. It's perfect! :)
__
Do You Yahoo!?
Yahoo! GeoCities - quick and easy web site hosting, just $8.95/month.
http://geocities.yahoo.com/ps/info1
___
Dynap
wow, I'm impressed.
___
Dynapi-Dev mailing list
[EMAIL PROTECTED]
http://www.mail-archive.com/[email protected]/
myLoadPanel.setURL(fileNames[intPageIndex]);
}
ta-da.
- Original Message -
From:
Laszlo Teglas
To: Doug Melvin
Sent: Thursday, November 15, 2001 5:43
PM
Subject: RE: [Dynapi-Dev] Documentation
Project
Have
you done this before? Can a widget access files after
lf Of Richard
BennettSent: November 15, 2001 7:02 PMTo: Laszlo Teglas;
[EMAIL PROTECTED]Subject: Re: [Dynapi-Dev]
Documentation Project
Our content should simply be on separate XHTML pages, which
can then either be loaded into a frame-set, or into a dynapi page using
loadpanel.
--
Example: "http://...",
SubData[]
}
]
}
-Original Message-From: Laszlo Teglas
[mailto:[EMAIL PROTECTED]]Sent: Thursday, November
15, 2001 5:12 PMTo:
[EMAIL PROTECTED]Subject: RE: [Dynapi-Dev]
Documentation Project
I
[EMAIL PROTECTED]]On Behalf Of
Strolia-Davis Christopher Contr MSG MAMSent: November 15, 2001
4:24 PMTo: 'Laszlo Teglas';
[EMAIL PROTECTED]Subject: RE: [Dynapi-Dev]
Documentation Project
You
could just have all the information in a data file, and create a widget in
Dy
loadpanel and a multi-dimentional array of
file names...
- Original Message -
From:
Laszlo Teglas
To: [EMAIL PROTECTED]
Sent: Thursday, November 15, 2001 5:12
PM
Subject: RE: [Dynapi-Dev] Documentation
Project
I
like the idea.
Lets
look at the
TECTED]]On Behalf Of
Strolia-Davis Christopher Contr MSG MAMSent: November 15, 2001
4:24 PMTo: 'Laszlo Teglas';
[EMAIL PROTECTED]Subject: RE: [Dynapi-Dev]
Documentation Project
You
could just have all the information in a data file, and create a widget in
DynApi to display it.
ify the current steps once
we settle on this new doc structure.
NanoFace =;^)
-Original Message-
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED]]On Behalf Of Richard
Bennett
Sent: November 15, 2001 12:58 PM
To: martin ström; [EMAIL PROTECTED]
Subject: Re: [Dynapi-Dev] Documentation Proje
t; <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Sent: Thursday, November 15, 2001 6:32 PM
Subject: RE: [Dynapi-Dev] Documentation Project
> > 1) We could either setup two directories under the CVS (src
> > for commented
> > and js for uncommented) and be forced to strip out t
> 1) We could either setup two directories under the CVS (src
> for commented
> and js for uncommented) and be forced to strip out the
> comments every time
> we make a CVS update.
>
> or my preferred way:
> 2) We could maintain just the src CVS folder fully commented
> and strip out
> the com
-Dev]
Documentation Project
frames? FRAMES?!
Um, this a DHTML library, why not
use Layers..?
- Original Message -
From:
Laszlo Teglas
To: [EMAIL PROTECTED]
Sent: Wednesday, November 14, 2001 5:29
PM
Subject: RE: [Dynapi-Dev] Documentation
AM
To: Doug Melvin; [EMAIL PROTECTED]
Subject: Re: [Dynapi-Dev] Documentation Project
I think we can scrap full XML, as server-side parsing is a pain.. (if we
want the docs to function offline)
I think frames are the easiest solution - no browser problems, no script,
and the pages are reusable
>Dan made a Perl comment-stripper, that would run online, there were still
>some bugs though.
>And Thomas Loo made a script one, very cool called ESC, I'm not sure where
>it is online, his email was:
>[EMAIL PROTECTED]
>This is exactly why we are ending all lines with semi-colons in the script.
I
To: [EMAIL PROTECTED]
Subject: Re: [Dynapi-Dev] Documentation Project
Question: When we talk about using XML or XHTML.. are we talking
server-side?
I certainly hope so seeing as how NS4.x does ont have an XML parser..
I will not agree to forcing someone to download a plugin just to rea
- Original Message -
From: "Doug Melvin" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Sent: Thursday, November 15, 2001 3:46 PM
Subject: Re: [Dynapi-Dev] Documentation Project
> What's the benifit then?
>
>
> > When I talk about using XHTML, I a
ork from the users
> stand point.
> (No plugin required, batteries included) =;^)
>
> -Original Message-
> From: [EMAIL PROTECTED]
> [mailto:[EMAIL PROTECTED]]On Behalf Of Doug Melvin
> Sent: November 15, 2001 9:18 AM
> To: [EMAIL PROTECTED]
> Subject: Re: [Dynapi-De
t; To: [EMAIL PROTECTED]
> Subject: Re: [Dynapi-Dev] Documentation Project
>
>
> If you're going to keep pushing wiki-wiki, maybe you could
> provide a link?
>
>
> > If we do this, we could use Oxygen, this is usable for the whole
> > documentatio
Help is always welcome, in any form..
My question tho, is, who DOES have full admin access to the site?
Anyone? Anyone at all?
- Original Message -
From: "Henrik Våglin" <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>
Sent: Wednesday, November 14, 2001 9:08 PM
Su
info.com/examples/Richardinfo_Developer_Docs/
>
> http://www.stack.nl/~dimitri/doxygen/index.html.
>
>
> Cheers,
> Richard.
>
>
>
>
>
> - Original Message -
> From: "Laszlo Teglas" <[EMAIL PROTECTED]>
> To: <[EMAIL PROTECTED]>
> Sent: Wed
> From: "Matt Fair" <[EMAIL PROTECTED]>
> To: "Laszlo Teglas" <[EMAIL PROTECTED]>
> Cc: <[EMAIL PROTECTED]>
> Sent: Wednesday, November 14, 2001 10:39 PM
> Subject: RE: [Dynapi-Dev] Documentation Project
>
>
> > Are we think
frames? FRAMES?!
Um, this a DHTML library, why not
use Layers..?
- Original Message -
From:
Laszlo Teglas
To: [EMAIL PROTECTED]
Sent: Wednesday, November 14, 2001 5:29
PM
Subject: RE: [Dynapi-Dev] Documentation
Project
php
/ asp / cgi / jsp / cfm
EMAIL PROTECTED]>
Cc: <[EMAIL PROTECTED]>
Sent: Wednesday, November 14, 2001 4:39 PM
Subject: RE: [Dynapi-Dev] Documentation Project
> Are we thinking of puting together source documentation like what java
> has with its javadocs?
> A javadoc style would be:
> /**
> I put my d
>tried this, I'm just thinking out loud) I
don't know much about Win2PDF.
>Does it take a graphical snap shot, or does it copy the text of
the document
>and format it into pdf? If it copies the text, does it ignore
HTML tags?
>What would it do to a navsys that is made up of tags mixed wi
Question: When we talk about using XML or XHTML.. are we talking
server-side?
I certainly hope so seeing as how NS4.x does ont have an XML parser..
I will not agree to forcing someone to download a plugin just to read our
docs..
___
Dynapi-Dev mailin
o be bound closely. the best documentation is worthless,
if diffucult to use ( and vice versa ).
.jens.
> -Original Message-
> From: [EMAIL PROTECTED]
>[mailto:[EMAIL PROTECTED]]On Behalf Of Michael
>Pemberton
> Sent: November 14, 2001 4:48 PM
> To: [EMAIL PRO
as meant to contain
compressed .js files)
/martin
> -Original Message-
> From: [EMAIL PROTECTED]
> [mailto:[EMAIL PROTECTED]] On Behalf Of
> Richard Bennett
> Sent: den 15 november 2001 00:47
> To: Laszlo Teglas; [EMAIL PROTECTED]
> Subject: Re: [Dynapi-Dev] Docume
Richard Bennett" <[EMAIL PROTECTED]> wrote:
> I think Hendrik Vaglin is still is still adminning the website, so if you
> want to set up a new documentation section, get in touch with him.
>
> Richard.
>
>
To be clear and correct I only co-administrate the main website. I don't have SFTP or
efore they are downloaded. Thus this effects performance
>
> 2) You have to build a doc compiler. This is a project of its own. I don't
> think we have the resources for that.
>
> NanoFace =;^)
>
> -Original Message-
> From: Matt Fair [mailto:[EMAIL PROTECTED]]
>
D]]On Behalf Of Michael
> Pemberton
> Sent: November 14, 2001 4:48 PM
> To: [EMAIL PROTECTED]
> Subject: RE: [Dynapi-Dev] Documentation Project
>
>
> >I vote for Frames =;^)
>
> >Using frames may also help when we want to update different formats o
t
think we have the resources for that.
NanoFace =;^)
-Original Message-
From: Matt Fair [mailto:[EMAIL PROTECTED]]
Sent: November 14, 2001 4:39 PM
To: Laszlo Teglas
Cc: [EMAIL PROTECTED]
Subject: RE: [Dynapi-Dev] Documentation Project
Are we thinking of puting together source documentation
Sent: Wednesday, November 14, 2001 10:39 PM
Subject: RE: [Dynapi-Dev] Documentation Project
> Are we thinking of puting together source documentation like what java
> has with its javadocs?
> A javadoc style would be:
> /**
> I put my documentation here for this metho
[EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED]]On Behalf Of Michael
PembertonSent: November 14, 2001 4:48 PMTo:
[EMAIL PROTECTED]Subject: RE: [Dynapi-Dev]
Documentation Project
>I vote for Frames =;^)
>Using frames may also help when we want to update different
format
ebsite, as this is
> a separate system all together.
> I think Hendrik Vaglin is still is still adminning the website, so if you
> want to set up a new documentation section, get in touch with him.
>
> Richard.
>
>
>
> - Original Message -
> From: "Dou
>I vote for Frames =;^)
>Using frames may also help when we want to update different formats of the
>documentation. i.e. pdf files can be set up to list the content files
>consecutively without the need to strip out the navsys from every page. We
>could then replicate the navsys as a table o
?
NanoFace =;^)
-Original Message-
From: Richard Bennett [mailto:[EMAIL PROTECTED]]
Sent: November 14, 2001 2:56 PM
To: Doug Melvin; Laszlo Teglas; [EMAIL PROTECTED]
Subject: Re: [Dynapi-Dev] Documentation Project
The documentation specs look a little complicated, but I guess that's
inevi
TED]>;
<[EMAIL PROTECTED]>
Sent: Wednesday, November 14, 2001 7:37 PM
Subject: Re: [Dynapi-Dev] Documentation Project
> I like the structure, and will adopt it.
> It should be in HTML, but can be in pdf as well..
> search for and download Win2PDF.. this is a virtual
> printer w
I like the structure, and will adopt it.
It should be in HTML, but can be in pdf as well..
search for and download Win2PDF.. this is a virtual
printer which 'prints' to a PDF file.
This printer can be used from ANY windows application that can print..
so.. we build the docs in HTML,
then we offer
Its been updated in CVS. I'm sure more errors as well. Also, I we
need to add the other packages to the documentation. If you get the
config files from cvs you can see how easy it is to document.
--
// Robert Rainwater
On 2/12/2001, 8:42:10 PM EST, robelix wrote about "[Dynapi-Dev] document
56 matches
Mail list logo
