Mailman 3 August 1998 - Doc-SIG

pythondoc comments
by Lars Marius Garshol Aug. 31, 1998

Aug. 31, 1998

(This was posted quite a while ago, but never appeared on the list because I sent it to doc-sig-admin by mistake and didn't discover it before now.) I just had a look at pythondoc 0.1 and liked what I saw. I noticed that it could output XML, which raises an interesting question: - do you think gendoc should generate output in lots of different formats, or do you think DSSSL style sheets should be supplied with pythondoc instead? (That would enable RTF, TeX and MIFF conversion with Jade, and even browsing with HyBrick.) Also, something about the XML puzzled me: - all "objects" (methods, classes, variables etc) in the XML file have an attribute "id" and a child element "name" (or was it "title"?). What are the respective purposes of these two? --Lars M.

2 2

SGMLtools might go Python... (fwd)
by David Ascher Aug. 15, 1998

Aug. 15, 1998

FYI, in case y'all don't read the main list... ---------- Forwarded message ---------- Date: 14 Aug 1998 22:09:10 +0200 From: Cees de Groot <cg(a)bofh.cdg.acriter.nl> Reply-To: cg(a)pobox.com To: python-list(a)cwi.nl Subject: SGMLtools might go Python... Newsgroups: comp.lang.python On the SGMLtools mailing list (see below for an intro to SGMLtools) we have discussed dropping Perl in favour of Python. I've almost made up my mind but for one thing: I don't want the schedule of SGMLtools 2.0 to slip too much (end of September, there should be a first release), and as I'm very busy at the moment with my daytime job, this decision depends on people willing out to help doing the port from Perl to Python. Basically, the port involves three main targets: - Ken MacLeod's PkgMaker is a Perl wrapper around RPM .spec files. As the build process heavily relies on this package and I don't want to keep Perl dependencies around, the relevant parts of this package need to be ported to Python; - A number of small Perl scripts that form the Perl environment (8 scripts, a total of 1000 lines including the GNU blurb on top of every file :-)). - Last, but most important, the Perl "glue" that sits between the user and Jade, jadetex, etcetera, needs to be redone. It is only 1400 lines over 10 files (again, including GNU blurbs etcetera), but the work here will form the foundation of SGMLtools - it needs to be open, extensible, etcetera. In a word: well thought-out. I've made a mailing list for people who want to volunteer here - subscribe by sending "subscribe python-port" to <majordomo(a)evrl.xs4all.nl>. This mailing list will be temporarily and ceases to exist when a SGMLtools 1.1 version has been put out without any Perl in it. If enough people volunteer to get a solid Python foundation in a couple of weeks, I'll declare the Perl->Python move official. For people who don't know SGMLtools: it used to be called Linuxdoc-SGML, and afterwards SGML-Tools. It is a package mainly targeted at writing technical/software documentation. The 1.1 version is the first of a new generation of the software, that bases on the DocBook DTD, Jade and DSSSL. Information can be found at www.sgmltools.org Regards Cees de Groot SGMLtools maintainer -- Cees de Groot http://pobox.com/~cg <cg(a)pobox.com> SGMLtools Maintainer http://www.sgmltools.org

2 1

pythondoc update
by Daniel Larsson Aug. 12, 1998

Aug. 12, 1998

FYI, I just put up an updated version of pythondoc at http://starship.skyport.net/crew/danilo/pythondoc

1 0

Re: [Doc-SIG] Pythondoc, "Developer's Preview" :-)
by Robin Friedrich Aug. 9, 1998

Aug. 9, 1998

> From: Tim Peters <tim_one(a)email.msn.com> > > I also couldn't get it using IE 4.01, but then again I can't seem to find > > > ftp://starship.skyport.net/crew/danilo/pythondoc/pythondoc.tgz > > using FTP directly either. > > It's not that it's a tgz file, as I *can* use IE (or straight FTP) to suck > down > > ftp://starship.skyport.net/pub/crew/danilo/gendoc-0.72.tgz > > which may not be what we're after, but has the considerable virtue of > existence <wink>. > > inclined-to-believe-it's-a-bogus-url-ly y'rs - tim > Actually I telnet'ed into starship and found it right where I thought it would be. I went so far as to copy the tgz to my www subdirectory and tried again (unsuccessfully) to snag it from that path. I hope there is not a server problem but I can't think of what it is. -Robin

3 2

Re: [Doc-SIG] Pythondoc, "Developer's Preview" :-)
by Robin Friedrich Aug. 7, 1998

Aug. 7, 1998

Still got the IE prob. Can you mail it?? It's only 33K. ---------- > From: Daniel Larsson <Daniel.Larsson(a)vasteras.mail.telia.com> > > Hmm, it seems I assumed the ftp address wrong... Can't help you much with > the IE4.0 problems, though. A correct address is > http://starship.skyport.net/crew/danilo/pythondoc/ > If people still have problems, I'll email it! > > (If you've seen a similar message from me, sorry my email program died > (yeah, right, Microsoft) and I wasn't sure it got sent).

1 0

Re: [Doc-SIG] Pythondoc, "Developer's Preview" :-)
by Robin Friedrich Aug. 7, 1998

Aug. 7, 1998

This is great news! ( I just wish I could download the tgz file.) Has anyone been able to do it? I'm stuck on this *&%$@#$#@& Internet Explorer. ---------- > From: Daniel Larsson <Daniel.Larsson(a)vasteras.mail.telia.com> > To: DOC-SIG <doc-sig(a)python.org> > Subject: [Doc-SIG] Pythondoc, "Developer's Preview" :-) > Date: Thursday, August 06, 1998 2:55 PM > > Hi all, > > Spent some time during this miserable swedish summer fiddling with > pythondoc. For those not knowing what that is, it's the successor to > my old gendoc program, which generates documentation from docstrings. > > Pythondoc is a complete rewrite, and will in the end (hopefully) prove > to be more useful than gendoc. This is the first working snapshot, so > please have a look. > > You can find the package at > ftp://starship.skyport.net/crew/danilo/pythondoc/pythondoc.tgz > and some sample output at > http://starship.skyport.net/crew/danilo/pythondoc/html/pythondoc.html > > /Daniel > > > _______________________________________________ > Doc-SIG maillist - Doc-SIG(a)python.org > http://www.python.org/mailman/listinfo/doc-sig

3 2

Pythondoc, "Developer's Preview" :-)
by Daniel Larsson Aug. 6, 1998

Aug. 6, 1998

Hi all, Spent some time during this miserable swedish summer fiddling with pythondoc. For those not knowing what that is, it's the successor to my old gendoc program, which generates documentation from docstrings. Pythondoc is a complete rewrite, and will in the end (hopefully) prove to be more useful than gendoc. This is the first working snapshot, so please have a look. You can find the package at ftp://starship.skyport.net/crew/danilo/pythondoc/pythondoc.tgz and some sample output at http://starship.skyport.net/crew/danilo/pythondoc/html/pythondoc.html /Daniel

1 0