From gherman at darwin.in-berlin.de  Thu Sep  4 18:46:53 2003
From: gherman at darwin.in-berlin.de (Dinu Gherman)
Date: Thu Sep  4 18:01:21 2003
Subject: [Doc-SIG] Online article about HeyHeyWickie using Docutils
Message-ID: <01449CEC-DEEF-11D7-8726-00039345C610@darwin.in-berlin.de>

Hi,

I'm glad the folks at Linux-Magazine.com have put an article of mine
(appearing in the october 2003 issue) on their site for people to
download. It's about an experimental WikiWiki which builds on Doc-
utils and EmPy. It describes neither of these two in detail, but
shows instead what you can do with them.

Subsequent versions of HeyHeyWickie will also be available. My web
pages on the Starship Python were also generated using it (not en-
tirely converted yet...). This is also where you can find a link to
the online PDF document:

   http://python.net/~gherman/Publications.html

I hope you enjoy reading it,

Dinu

--
Dinu C. Gherman
......................................................................
"Even if you do learn to speak correct English, whom are you going
to speak it to?" (Clarence Darrow)


From pb829hkq at bigfoot.com  Mon Sep 22 17:39:12 2003
From: pb829hkq at bigfoot.com (Rosanna Mcnair)
Date: Sun Sep 21 22:39:50 2003
Subject: [Doc-SIG] High Potenbt female attractant  gqky lyjjpfqam
Message-ID: <2npr5ajs1f$-a$u6@w75.ed6itu7.ci>

An HTML attachment was scrubbed...
URL: http://mail.python.org/pipermail/doc-sig/attachments/20030922/03b4b231/attachment.html
From fdrake01 at comcast.net  Tue Sep 23 01:39:53 2003
From: fdrake01 at comcast.net (fdrake01@comcast.net)
Date: Tue Sep 23 01:40:09 2003
Subject: [Doc-SIG] Doc freeze for Python 2.3.1
Message-ID: <E1A1fu3-000486-3o@mail.python.org>

Python's Doc/ tree should be considered frozen on the release23-maint branch.
I've made the version number updates, but the machine I normally build the
documentation on is having some connectivity problems (which hopefully can be
resolved tomorrow morning).  Using what I have available to me now, I should
be able to build everything but the iSilo version of the docs; I don't think
a delay for those is needed; they can be added when available.


  -Fred

-- 
Fred L. Drake, Jr.  <fdrake at acm.org>
PythonLabs at Zope Corporation

From theller at python.net  Sat Sep 27 15:16:50 2003
From: theller at python.net (Thomas Heller)
Date: Sat Sep 27 15:17:04 2003
Subject: [Doc-SIG] Re: [Python-Dev] [development doc updates]
In-Reply-To: <20030927190724.DDC8818F3E6@grendel.zope.com> (Fred L. Drake's
	message of "Sat, 27 Sep 2003 15:07:24 -0400 (EDT)")
References: <20030927190724.DDC8818F3E6@grendel.zope.com>
Message-ID: <vfreujml.fsf@python.net>

"Fred L. Drake" <fdrake@acm.org> writes:

> The development version of the documentation has been updated:
>
>     http://www.python.org/dev/doc/devel/
>
> The new glossary in the tutorial is really nice!

Sure, but the hyperlinks don't work ;-)

Thomas


From jdavid at itaapy.com  Mon Sep 29 11:06:51 2003
From: jdavid at itaapy.com (J. David Ibanez)
Date: Mon Sep 29 10:59:27 2003
Subject: [Doc-SIG] Re: [Python-Dev] [development doc updates]
In-Reply-To: <20030927190724.DDC8818F3E6@grendel.zope.com>
References: <20030927190724.DDC8818F3E6@grendel.zope.com>
Message-ID: <3F784A8B.7020904@itaapy.com>

Fred L. Drake wrote:

>The development version of the documentation has been updated:
>
>    http://www.python.org/dev/doc/devel/
>
>The new glossary in the tutorial is really nice!
>Thanks, Skip and Raymond!
>
>  
>

a suggestion: it would be nice if the "Global Module Index" showed the
deprecated modules clearly separated from the non deprecated modules.

david


From fdrake at acm.org  Mon Sep 29 11:36:47 2003
From: fdrake at acm.org (Fred L. Drake, Jr.)
Date: Mon Sep 29 11:37:46 2003
Subject: [Doc-SIG] Re: [Python-Dev] [development doc updates]
In-Reply-To: <3F784A8B.7020904@itaapy.com>
References: <20030927190724.DDC8818F3E6@grendel.zope.com>
	<3F784A8B.7020904@itaapy.com>
Message-ID: <16248.20879.357230.102681@grendel.zope.com>


J. David Ibanez writes:
 > a suggestion: it would be nice if the "Global Module Index" showed the
 > deprecated modules clearly separated from the non deprecated modules.

David,

It certainly makes sense to provide some sort of status mark for
this.  Can you file a bug report on SourceForge about this?  The URL
for the bug reporting form is:

http://sourceforge.net/tracker/?func=add&group_id=5470&atid=305470

Thanks!


  -Fred

-- 
Fred L. Drake, Jr.  <fdrake at acm.org>
PythonLabs at Zope Corporation

From delza at blastradius.com  Mon Sep 29 11:48:06 2003
From: delza at blastradius.com (Dethe Elza)
Date: Mon Sep 29 11:48:09 2003
Subject: [Doc-SIG] Re: [Python-Dev] [development doc updates]
In-Reply-To: <3F784A8B.7020904@itaapy.com>
Message-ID: <5169B8D0-F294-11D7-951F-0003939B59E8@blastradius.com>


On Monday, September 29, 2003, at 08:06 AM, J. David Ibanez wrote:

> a suggestion: it would be nice if the "Global Module Index" showed the
> deprecated modules clearly separated from the non deprecated modules.

It would also be nice if the string and list ("mutable sequences") were 
linked from the library table of contents.  String and list methods are 
so frequently used that it gets tedious going through 
library->sequences->string methods each time.

--Dethe


From Paul.Moore at atosorigin.com  Mon Sep 29 11:54:27 2003
From: Paul.Moore at atosorigin.com (Moore, Paul)
Date: Mon Sep 29 11:55:12 2003
Subject: [Doc-SIG] Re: [Python-Dev] [development doc updates]
Message-ID: <16E1010E4581B049ABC51D4975CEDB8803060CA2@UKDCX001.uk.int.atosorigin.com>

From: Dethe Elza [mailto:delza@blastradius.com]
> It would also be nice if the string and list ("mutable sequences")
> were linked from the library table of contents.  String and list
> methods are so frequently used that it gets tedious going through 
> library->sequences->string methods each time.

Agreed. This also affects the Windows "HTML Help" format documentation,
where the string and list methods don't make it into the contents "tree"
display in the left hand pane.

Paul.

From fdrake at acm.org  Mon Sep 29 12:08:56 2003
From: fdrake at acm.org (Fred L. Drake, Jr.)
Date: Mon Sep 29 12:09:16 2003
Subject: [Doc-SIG] Re: [Python-Dev] [development doc updates]
In-Reply-To: <16E1010E4581B049ABC51D4975CEDB8803060CA2@UKDCX001.uk.int.atosorigin.com>
References: <16E1010E4581B049ABC51D4975CEDB8803060CA2@UKDCX001.uk.int.atosorigin.com>
Message-ID: <16248.22808.619129.9969@grendel.zope.com>


Moore, Paul writes:
 > Agreed. This also affects the Windows "HTML Help" format documentation,
 > where the string and list methods don't make it into the contents "tree"
 > display in the left hand pane.

This is such an oft-requested change that we really need to find a
better solution than we have now.  These pages also don't lend
themselves to being moved up the hierarchy, which is what drives the
table of contents.

Perhaps what we need is a list of probably no more than 20 links from
the top of the document tree (parallel to the Python Documentation
Index and the Global Module Index) of "quick links" into the tree.

Does anyone want to volunteer to collect a list of candidate links?


  -Fred

-- 
Fred L. Drake, Jr.  <fdrake at acm.org>
PythonLabs at Zope Corporation

From jdavid at itaapy.com  Mon Sep 29 13:03:29 2003
From: jdavid at itaapy.com (=?ISO-8859-1?Q?=22J=2E_David_Ib=E1=F1ez=22?=)
Date: Mon Sep 29 12:56:13 2003
Subject: [Doc-SIG] Re: [Python-Dev] [development doc updates]
In-Reply-To: <16248.20879.357230.102681@grendel.zope.com>
References: <20030927190724.DDC8818F3E6@grendel.zope.com>	<3F784A8B.7020904@itaapy.com>
	<16248.20879.357230.102681@grendel.zope.com>
Message-ID: <3F7865E1.8060306@itaapy.com>

Fred L. Drake, Jr. wrote:

>J. David Ibanez writes:
> > a suggestion: it would be nice if the "Global Module Index" showed the
> > deprecated modules clearly separated from the non deprecated modules.
>
>David,
>
>It certainly makes sense to provide some sort of status mark for
>this.  Can you file a bug report on SourceForge about this?  The URL
>for the bug reporting form is:
>
>http://sourceforge.net/tracker/?func=add&group_id=5470&atid=305470
>
>Thanks!
>
>
>  -Fred
>
>  
>

done, thank you

-- 
J. David Ib??ez
Founder and CTO of Itaapy <http://www.itaapy.com>
Creator of Localizer <http://www.localizer.org>
Lead developer of IKAARO <http://www.ikaaro.org>



From fdrake at acm.org  Mon Sep 29 13:54:33 2003
From: fdrake at acm.org (Fred L. Drake, Jr.)
Date: Mon Sep 29 13:54:52 2003
Subject: [Doc-SIG] Distribution formats
Message-ID: <16248.29145.25782.862817@grendel.zope.com>


We're currently distributing 21 different files for the documentation
for a single Python release.  This includes 3 compression formats for
the HTML, LaTeX, PDF (2 paper sizes), and PostScript (2 paper sizes)
formats, 2 compression formats for the GNU info, and 1 for the iSilo
format.

I'd like to cut back a little.  ;-)

Is there anyone currently relying on the gzipped archives who can't
use the bzip2 archives?  (How about the ZIP users?  Can they rely on
gzip or bzip2 archives?)

I'd appreciate feedback on this.  Thanks!


  -Fred

-- 
Fred L. Drake, Jr.  <fdrake at acm.org>
PythonLabs at Zope Corporation

From aahz at pythoncraft.com  Mon Sep 29 15:49:32 2003
From: aahz at pythoncraft.com (Aahz)
Date: Mon Sep 29 15:49:42 2003
Subject: [Doc-SIG] Distribution formats
In-Reply-To: <16248.29145.25782.862817@grendel.zope.com>
References: <16248.29145.25782.862817@grendel.zope.com>
Message-ID: <20030929194932.GA18699@panix.com>

On Mon, Sep 29, 2003, Fred L. Drake, Jr. wrote:
>
> Is there anyone currently relying on the gzipped archives who can't
> use the bzip2 archives?  (How about the ZIP users?  Can they rely on
> gzip or bzip2 archives?)

WinZip (one of the standard Windows utilities) supports gzip, but I
can't find any sign that they support bzip2.
-- 
Aahz (aahz@pythoncraft.com)           <*>         http://www.pythoncraft.com/

"It is easier to optimize correct code than to correct optimized code."
--Bill Harlan

From cben at users.sf.net  Mon Sep 29 16:23:08 2003
From: cben at users.sf.net (Beni Cherniavsky)
Date: Mon Sep 29 16:23:22 2003
Subject: [Doc-SIG] Distribution formats
In-Reply-To: <20030929194932.GA18699@panix.com>
References: <16248.29145.25782.862817@grendel.zope.com>
	<20030929194932.GA18699@panix.com>
Message-ID: <Pine.GSO.4.51.0309292322090.18016@techunix.technion.ac.il>

Aahz wrote on 2003-09-29:

> On Mon, Sep 29, 2003, Fred L. Drake, Jr. wrote:
> >
> > Is there anyone currently relying on the gzipped archives who can't
> > use the bzip2 archives?  (How about the ZIP users?  Can they rely on
> > gzip or bzip2 archives?)
>
> WinZip (one of the standard Windows utilities) supports gzip, but I
> can't find any sign that they support bzip2.
>
For windows, the Free `7-Zip`__ supports them all.

__ www.7-zip.org

-- 
Beni Cherniavsky <cben@users.sf.net>

Python - the best programming diet.

From aahz at pythoncraft.com  Mon Sep 29 17:19:44 2003
From: aahz at pythoncraft.com (Aahz)
Date: Mon Sep 29 17:20:18 2003
Subject: [Doc-SIG] Distribution formats
In-Reply-To: <Pine.GSO.4.51.0309292322090.18016@techunix.technion.ac.il>
References: <16248.29145.25782.862817@grendel.zope.com>
	<20030929194932.GA18699@panix.com>
	<Pine.GSO.4.51.0309292322090.18016@techunix.technion.ac.il>
Message-ID: <20030929211944.GA26915@panix.com>

On Mon, Sep 29, 2003, Beni Cherniavsky wrote:
> Aahz wrote on 2003-09-29:
>> On Mon, Sep 29, 2003, Fred L. Drake, Jr. wrote:
>>>
>>> Is there anyone currently relying on the gzipped archives who can't
>>> use the bzip2 archives?  (How about the ZIP users?  Can they rely on
>>> gzip or bzip2 archives?)
>>
>> WinZip (one of the standard Windows utilities) supports gzip, but I
>> can't find any sign that they support bzip2.
>
> For windows, the Free `7-Zip`__ supports them all.
> 
> __ www.7-zip.org

While that's a Good Thing, I'm not sure it addresses the issue.  Should
we be in a position where in order to access material on python.org,
people have to download additional software?  I think it's reasonable to
assume that people have either ZIP or bzip2, but I think that we'll get
lots of whining if we only make bzip2 available.  (I'm already not
looking forward to the complaints to webmaster if we remove gzip, but
that's at least manageable.)
-- 
Aahz (aahz@pythoncraft.com)           <*>         http://www.pythoncraft.com/

"It is easier to optimize correct code than to correct optimized code."
--Bill Harlan

From pf_moore at yahoo.co.uk  Mon Sep 29 15:09:23 2003
From: pf_moore at yahoo.co.uk (Paul Moore)
Date: Tue Sep 30 04:50:39 2003
Subject: [Doc-SIG] Re: Distribution formats
References: <16248.29145.25782.862817@grendel.zope.com>
Message-ID: <he2vza1o.fsf@yahoo.co.uk>

"Fred L. Drake, Jr." <fdrake@acm.org> writes:

> We're currently distributing 21 different files for the documentation
> for a single Python release.  This includes 3 compression formats for
> the HTML, LaTeX, PDF (2 paper sizes), and PostScript (2 paper sizes)
> formats, 2 compression formats for the GNU info, and 1 for the iSilo
> format.
>
> I'd like to cut back a little.  ;-)
>
> Is there anyone currently relying on the gzipped archives who can't
> use the bzip2 archives?  (How about the ZIP users?  Can they rely on
> gzip or bzip2 archives?)
>
> I'd appreciate feedback on this.  Thanks!

One annoying factor is that WinZip doesn't support the bzip2 format. I
don't know how many (if any) users rely on .tar.gz format archives on
Windows (I don't!), but as WinZip is fairly commonly used, there may
be an issue there...

I think that, as long as you supply *one* of .tar.gz or .zip formats,
WinZip users will be OK.

Hope this helps,
Paul.
-- 
This signature intentionally left blank


From fdrake at acm.org  Tue Sep 30 17:08:06 2003
From: fdrake at acm.org (Fred L. Drake, Jr.)
Date: Tue Sep 30 17:09:29 2003
Subject: [Doc-SIG] Re: Distribution formats
In-Reply-To: <he2vza1o.fsf@yahoo.co.uk>
References: <16248.29145.25782.862817@grendel.zope.com>
	<he2vza1o.fsf@yahoo.co.uk>
Message-ID: <16249.61622.32210.389455@grendel.zope.com>


Paul Moore writes:
 > I think that, as long as you supply *one* of .tar.gz or .zip formats,
 > WinZip users will be OK.

Ok, here's what I'll plan to do:

I'll send a note to python-dev to see if anyone there has strong
objections to dropping the .tar.gz format.  If that flies, we can ask
the larger community to chime in on python-list (comp.lang.python).  I
won't have time to read python-list to guage the reaction myself; I'll
ask that comments be directed here instead.


  -Fred

-- 
Fred L. Drake, Jr.  <fdrake at acm.org>
PythonLabs at Zope Corporation