From Daniel.Larsson@vasteras.mail.telia.com  Thu Aug  6 20:55:27 1998
From: Daniel.Larsson@vasteras.mail.telia.com (Daniel Larsson)
Date: Thu, 6 Aug 1998 21:55:27 +0200
Subject: [Doc-SIG] Pythondoc, "Developer's Preview" :-)
Message-ID: <000001bdc174$2992de20$e6fd43c3@telia.com>

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



From friedrich@pythonpros.com  Fri Aug  7 16:12:56 1998
From: friedrich@pythonpros.com (Robin Friedrich)
Date: Fri, 7 Aug 1998 10:12:56 -0500
Subject: [Doc-SIG] Pythondoc, "Developer's Preview" :-)
Message-ID: <199808071513.IAA29141@ns1.lyra.org>

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@vasteras.mail.telia.com>
> To: DOC-SIG <doc-sig@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@python.org
> http://www.python.org/mailman/listinfo/doc-sig


From tim_one@email.msn.com  Fri Aug  7 16:46:04 1998
From: tim_one@email.msn.com (Tim Peters)
Date: Fri, 7 Aug 1998 11:46:04 -0400
Subject: [Doc-SIG] Pythondoc, "Developer's Preview" :-)
In-Reply-To: <199808071513.IAA29141@ns1.lyra.org>
Message-ID: <000101bdc21a$7c7ac200$679e2299@tim>

[Robin Friedrich]
> 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.

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




From skip@calendar.com (Skip Montanaro)  Fri Aug  7 17:00:47 1998
From: skip@calendar.com (Skip Montanaro) (skip@calendar.com (Skip Montanaro))
Date: Fri, 7 Aug 1998 12:00:47 -0400
Subject: [Doc-SIG] Pythondoc, "Developer's Preview" :-)
In-Reply-To: <199808071513.IAA29141@ns1.lyra.org>
References: <199808071513.IAA29141@ns1.lyra.org>
Message-ID: <199808071600.MAA27367@dt09q1n8c.nycap.rr.com>

    Robin> This is great news!  ( I just wish I could download the tgz
    Robin> file.)  Has anyone been able to do it? I'm stuck on this
    Robin> *&%$@#$#@& Internet Explorer.

You could always try using MSIE to download Netscape or Grail... :-)

Skip



From friedrich@pythonpros.com  Fri Aug  7 17:01:44 1998
From: friedrich@pythonpros.com (Robin Friedrich)
Date: Fri, 7 Aug 1998 11:01:44 -0500
Subject: [Doc-SIG] Pythondoc, "Developer's Preview" :-)
Message-ID: <199808071602.JAA29324@ns1.lyra.org>

> From: Tim Peters <tim_one@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


From Daniel.Larsson@vasteras.mail.telia.com  Fri Aug  7 19:19:01 1998
From: Daniel.Larsson@vasteras.mail.telia.com (Daniel Larsson)
Date: Fri, 7 Aug 1998 20:19:01 +0200
Subject: [Doc-SIG] Pythondoc, "Developer's Preview" :-)
In-Reply-To: <199808071602.JAA29324@ns1.lyra.org>
Message-ID: <000001bdc22f$db492fa0$01fd43c3@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).

-----Original Message-----
From: doc-sig-admin@python.org [mailto:doc-sig-admin@python.org]On
Behalf Of Robin Friedrich
Sent: den 7 augusti 1998 18:02
To: Tim Peters; Daniel Larsson; DOC-SIG
Subject: Re: [Doc-SIG] Pythondoc, "Developer's Preview" :-)



> From: Tim Peters <tim_one@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

_______________________________________________
Doc-SIG maillist  -  Doc-SIG@python.org
http://www.python.org/mailman/listinfo/doc-sig




From friedrich@pythonpros.com  Fri Aug  7 19:29:42 1998
From: friedrich@pythonpros.com (Robin Friedrich)
Date: Fri, 7 Aug 1998 13:29:42 -0500
Subject: [Doc-SIG] Pythondoc, "Developer's Preview" :-)
Message-ID: <199808071830.LAA29869@ns1.lyra.org>

Still got the IE prob. Can you mail it?? It's only 33K.

----------
> From: Daniel Larsson <Daniel.Larsson@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).



From tim_one@email.msn.com  Sun Aug  9 09:25:05 1998
From: tim_one@email.msn.com (Tim Peters)
Date: Sun, 9 Aug 1998 04:25:05 -0400
Subject: [Doc-SIG] Pythondoc, "Developer's Preview" :-)
In-Reply-To: <000001bdc22f$db492fa0$01fd43c3@telia.com>
Message-ID: <000001bdc36f$369718a0$4c9e2299@tim>

[Daniel Larsson]
> 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!

FYI, I had no problem getting the .tgz file from that address, using IE
(4.01 + SP1, specifically not to mention unbearably <wink>).

cruisingly y'rs  - tim




From Daniel.Larsson@vasteras.mail.telia.com  Wed Aug 12 18:42:10 1998
From: Daniel.Larsson@vasteras.mail.telia.com (Daniel Larsson)
Date: Wed, 12 Aug 1998 19:42:10 +0200
Subject: [Doc-SIG] pythondoc update
Message-ID: <000001bdc618$88f4c7e0$7efc43c3@telia.com>

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



From da@skivs.ski.org  Fri Aug 14 22:57:12 1998
From: da@skivs.ski.org (David Ascher)
Date: Fri, 14 Aug 1998 14:57:12 -0700 (PDT)
Subject: [Doc-SIG] SGMLtools might go Python... (fwd)
Message-ID: <Pine.SUN.3.96.980814145644.7109F-100000@skivs.ski.org>

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@bofh.cdg.acriter.nl>
Reply-To: cg@pobox.com
To: python-list@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@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@pobox.com>
SGMLtools Maintainer        http://www.sgmltools.org



From Fred L. Drake, Jr." <fdrake@acm.org  Sat Aug 15 04:45:39 1998
From: Fred L. Drake, Jr." <fdrake@acm.org (Fred L. Drake)
Date: Fri, 14 Aug 1998 23:45:39 -0400 (EDT)
Subject: [Doc-SIG] SGMLtools might go Python... (fwd)
In-Reply-To: <Pine.SUN.3.96.980814145644.7109F-100000@skivs.ski.org>
References: <Pine.SUN.3.96.980814145644.7109F-100000@skivs.ski.org>
Message-ID: <13781.1123.286520.355235@weyr.cnri.reston.va.us>

David Ascher writes:
 > FYI, in case y'all don't read the main list...


  I've already signed up!  ;-)


  -Fred

--
Fred L. Drake, Jr.	     <fdrake@acm.org>
Corporation for National Research Initiatives
1895 Preston White Dr.	    Reston, VA  20191


From larsga@ifi.uio.no  Sun Aug 30 12:35:46 1998
From: larsga@ifi.uio.no (Lars Marius Garshol)
Date: Sun, 30 Aug 1998 13:35:46 +0200
Subject: [Doc-SIG] pythondoc comments
Message-ID: <3.0.1.32.19980830133546.00b85880@ifi.uio.no>

(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.



From Daniel.Larsson@vasteras.mail.telia.com  Sun Aug 30 17:05:40 1998
From: Daniel.Larsson@vasteras.mail.telia.com (Daniel Larsson)
Date: Sun, 30 Aug 1998 18:05:40 +0200
Subject: [Doc-SIG] pythondoc comments
In-Reply-To: <3.0.1.32.19980830133546.00b85880@ifi.uio.no>
Message-ID: <000401bdd430$0900ad80$e2fc43c3@telia.com>

> 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:

Thanks!

> - 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.)

That makes a lot of sense to me, yes. I haven't fiddled with DSSSL
yet, but I meant to... (time, time).

>
> 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?

Hmm, yes... That's "historic" reasons... :-). First, the XML output
is really the internal tree printed. I added the "id" attribute
later to be able to search in the tree, and I never got around to
remove the "name" element. It will go away.

Thanks for the comments, Lars M.

/Daniel



From larsga@ifi.uio.no  Mon Aug 31 09:16:39 1998
From: larsga@ifi.uio.no (Lars Marius Garshol)
Date: Mon, 31 Aug 1998 10:16:39 +0200
Subject: [Doc-SIG] pythondoc comments
In-Reply-To: <000401bdd430$0900ad80$e2fc43c3@telia.com>
References: <3.0.1.32.19980830133546.00b85880@ifi.uio.no>
Message-ID: <3.0.1.32.19980831101639.006c7898@ifi.uio.no>

* Lars Marius Garshol
>
> - 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.)

* Daniel Larsson
>
>That makes a lot of sense to me, yes. I haven't fiddled with DSSSL
>yet, but I meant to... (time, time).

Once this becomes the official pythondoc policy you may not have
to... :-)

>Hmm, yes... That's "historic" reasons... :-). First, the XML output
>is really the internal tree printed. I added the "id" attribute
>later to be able to search in the tree, and I never got around to
>remove the "name" element. It will go away.

I think the id attribute would be much more useful if it had unique
values (Namespace1_Namespace2_name?), since it could then be defined
as an ID attribute in the DTD. This would enable us to locate entities
easily via XPointers, the DOM level 2 and even CSS/XSL.

I haven't looked very closely at the XML yet, but if I can find the
time I will (not likely this week, unfortunately).

--Lars M.