[Webware-discuss] [Webware-devel] Webware documentation

2002-10-24 Thread Kendall Grant Clark
> "ian" == Ian Bicking <[EMAIL PROTECTED]> writes: ian> The Webware documentation isn't in very good shape, as it hasn't ian> been actively updated in a while. Ah, Ian gives me the opening I've been looking for... I've recently become the managing editor of Py, the Python print journal (

[Webware-discuss] [UPDATE] Autoreload feature in CVS

2002-10-24 Thread Jason Hildebrand
Earlier this afternoon I committed an auto-reload feature to Webware CVS. I'd like to credit Tavis Rudd, who provided the initial implementation for this feature. Here are the details: Overview The purpose of this feature is to make life easier on the developer by having the appserver n

Re: [Webware-discuss] Getting Started

2002-10-24 Thread Ian Bicking
On Thu, 2002-10-24 at 19:55, Michael Montagne wrote: > Question #2: > Where do I put the funformkit package to allow me to use it. In the > base python site-packages directory? The appdir? It goes in the Webware/ directory. If you put it in, you'll see an FFK examples context, which are servl

Re: [Webware-discuss] Getting Started

2002-10-24 Thread Michael Montagne
>On 24/10/02, from the brain of Michael Montagne tumbled: > Pardon the imposition on the documentation discussion. I certainly > don't want to slow that down. But I'm just getting up to speed with > webware and i'm trying to do some playin around. I created an Appdir > and I can successfully re

Re: [Webware-discuss] Getting Started

2002-10-24 Thread Ian Bicking
When you access /WK you're accessing the AppServer, and it's reading from the "default" context -- when you install Webware, this is the Examples context (in WebKit/Examples). And it accesses the index or Main servlet in this context (since you didn't give a servlet name either). You can add a co

[Webware-discuss] Getting Started

2002-10-24 Thread Michael Montagne
Pardon the imposition on the documentation discussion. I certainly don't want to slow that down. But I'm just getting up to speed with webware and i'm trying to do some playin around. I created an Appdir and I can successfully reach http://localhost/WK. I set httpd.conf to: WKServer localhost

[Webware-discuss] RE: [Webware-devel] Webware documentation

2002-10-24 Thread Geoffrey Talvola
I kinda like just using HTML with simple styles for documentation, as we are now. It works, it's easy to edit by hand, and it's just one less thing to learn. You're right, it's the content that's lacking, not the formatting. I don't really care one way or the other if we split it up or leave it

Re: [Webware-discuss] RE: [Webware-devel] Webware documentation

2002-10-24 Thread Aaron Held
Personally I find that I can write the fastest when I write in XML because I do not have to think at all about the layout. But the fundamental problem is the content. I would not mind compiling a list somewhere of what docs we need. I would reccomend that we all work towards a single book. Co

[Webware-discuss] Re: [Webware-discuss]Webware documentation

2002-10-24 Thread Michael Engelhart
Hi - I'm new to this list and while I just barely have scratched the surface of Webware (and python for that matter), I would be glad to take files in XML format and generate the HTML documentation using XSLT. Unfortunately I've had a lot of problems generating output with the Python XSL proc

[Webware-discuss] RE: [Webware-devel] Webware documentation

2002-10-24 Thread Ian Bicking
On Thu, 2002-10-24 at 10:37, Geoffrey Talvola wrote: > I kinda like just using HTML with simple styles for documentation, as we are > now. It works, it's easy to edit by hand, and it's just one less thing to > learn. Yeah, reST is little weird to learn thoroughly, though the basic structure is si

[Webware-discuss] Re: [Webware-devel] Re: [Webware-discuss]Webware documentation

2002-10-24 Thread Ray Leyva
Hi, I talked a few months back about a book, but it never seemed to get any traction. I'm big on Xml / Xsl, and am very willing to lend myself to a project like this. With Python you want the gnome / libxml2 & libxslt python bindings. They are fantastic. I also recommend using the Gentoo sty

Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Ian Bicking
On Thu, 2002-10-24 at 07:18, Stefan Schwarzer wrote: > > Actually, I guess my real issue is that inline documentation doesn't > > distinguish between user interfaces and internal interfaces -- > > particularly when those internal interfaces are not entirely internal, > > like methods that you may w

[Webware-discuss] RE: [Webware-devel] Webware documentation

2002-10-24 Thread Geoffrey Talvola
I'm willing to try reST or an XML format. One thing I do like about HTML with styles is that anyone can contribute to the documentation with just their favorite text editor and a web browser. Whatever solution we use should be very easy to install and use, and I'd like to see a "documentation how-

Re: [Webware-discuss] Re: [Webware-devel] Re: [Webware-discuss]Webwaredocumentation

2002-10-24 Thread Aaron Held
Ray Leyva wrote: With Python you want the gnome / libxml2 & libxslt python bindings. They are fantastic. I also recommend using the Gentoo stylesheets. I've been working with them for a year now, and have found them to be lighter / easier to write to than DocBook. I also like Gentoo, and I us

[Webware-discuss] RE: [Webware-devel] Webware documentation

2002-10-24 Thread Geoffrey Talvola
I forgot to mention, the documentation tools need to work on Windows. Not everyone uses Linux to work with Webware. - Geoff > -Original Message- > From: Geoffrey Talvola > Sent: Thursday, October 24, 2002 12:54 PM > To: 'Ian Bicking' > Cc: Webware devel; Webware discuss > Subject: RE: [

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Ian Bicking
On Thu, 2002-10-24 at 09:06, Aaron Held wrote: > >>Anyway, I've been writing lots of documentation lately, and I've been > >>using reStructuredText (http://docutils.sourceforge.net/rst.html). It's > >>worked pretty well for me -- the output looks decent, but more > >>importantly it's comfortable t

[Webware-discuss] Re: [Webware-devel] Webware documentation

2002-10-24 Thread Aaron Held
Please comment on this plan: 1) We need content to be written / collected - I will try to organize something in the next week or so 2) Docstrings will continue to be used in order to describe API's and classes. (This will be lifted into the appendix section of the Webware book) 3) Other docs

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Mike Warren
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Ian Bicking <[EMAIL PROTECTED]> writes: > I might be able to get over my annoyance with XML if I look deeper > into Emacs -- I'm sure there's something in there to make it more > pleasant (maybe abbrev...) Yes, there's sgml-mode. Supplied with a DTD,

[Webware-discuss] Documentation

2002-10-24 Thread Joel Lawhead
It sounds like there are two different needs being discussed for documentation.  The first need is an easy way for core Webware developers to quickly document the software as it develops in an organized, complete but easy to use way that doesn’t require a lot of effort. Second is a formatti

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Ian Bicking
On Thu, 2002-10-24 at 12:40, Mike Warren wrote: > > I might be able to get over my annoyance with XML if I look deeper > > into Emacs -- I'm sure there's something in there to make it more > > pleasant (maybe abbrev...) > > Yes, there's sgml-mode. Supplied with a DTD, it gives you > popups/prompts

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Aaron Held
Ian Bicking wrote: probably make a translator from a text-like markup to a particular XML schema well enough... and I might do that if we decide on a particular schema. I think that would be better than trying to deal with all the needless tags. I agree. reStruct has all the basic tags, the onl

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Ian Bicking
On Thu, 2002-10-24 at 14:43, Aaron Held wrote: > Ian Bicking wrote: > > probably make a translator from a text-like markup to a particular XML > > schema well enough... and I might do that if we decide on a particular > > schema. I think that would be better than trying to deal with all the > > ne

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Aaron Held
Anyway, I've been writing lots of documentation lately, and I've been using reStructuredText (http://docutils.sourceforge.net/rst.html). It's worked pretty well for me -- the output looks decent, but more importantly it's comfortable to write. Keeping the documentation up-to-date is the most esse

Re: [Webware-discuss] UserKit error

2002-10-24 Thread Frank Barknecht
Hi, I could solve my problem now. It was: Frank Barknecht hat gesagt: // Frank Barknecht wrote: > But if I try to create another user, this fails with: > > > File "/dos/ibm/hdc18/f/src/python/webware/workdir/thehood/Main.py", line 71, in >Create > newUser = self.hood.add(name, pa

Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Stefan Schwarzer
Hi Ian On 24 Oct 2002, Ian Bicking wrote: > Anyway, I've been writing lots of documentation lately, and I've been > using reStructuredText (http://docutils.sourceforge.net/rst.html). It's > worked pretty well for me -- the output looks decent, but more > importantly it's comfortable to write. Ke

[Webware-discuss] Webware pop-up calendar tutorial

2002-10-24 Thread Aaron Held
I just posted a new version of the Webware pop-up calendar tutorial that I mentioned here about 5 months ago. I rushed the end because I wanted to put it up, but take a look and let me know what you think. http://webware.metrony.com/tutorials/calPopUp.html -Aaron ---

[Webware-discuss] Internet listing

2002-10-24 Thread Nicole Anderson
I did an internet search for people involved with economics issues and found you listed. I wanted to find out if there could be a possible fit between the both of us. I am with the Grant Alliance. The Grant Alliance offers many exciting programs for nonprofits and ministries. The programs are

[Webware-discuss] Webware documentation

2002-10-24 Thread Ian Bicking
The Webware documentation isn't in very good shape, as it hasn't been actively updated in a while. Anyway, I've been writing lots of documentation lately, and I've been using reStructuredText (http://docutils.sourceforge.net/rst.html). It's worked pretty well for me -- the output looks decent, bu