Mailman 3 May 2003 - Doc-SIG

chunk in docutils CVS
by Pearu Peterson May 31, 2003

May 31, 2003

Hi, I just updated my local docutils CVS repository and got also lots of chunk that appears to be the contents of CVSROOT directory. Thought you should know.. Regards, Pearu

1 0

Re: [Tutor] Documentation concerns.
by Magnus Lyckå May 27, 2003

May 27, 2003

There is currently a discussion about the Python documentation in the Tutor mailing list. One issue in particular is whether the main documentation for the module should be in the module itself, rather than in a separate document. What are the attitudes about this today? In PEP 287 it says: "10. Will the docstrings in the Python standard library modules be converted to reStructuredText? No. Python's library reference documentation is maintained separately from the source. Docstrings in the Python standard library should not try to duplicate the library reference documentation. The current policy for docstrings in the Python standard library is that they should be no more than concise hints, simple and markup-free (although many do contain ad-hoc implicit markup)." Is this still gospel? Any further thoughts around this? -- Magnus Lycka (It's really Lyckå), magnus(a)thinkware.se Thinkware AB, Sweden, www.thinkware.se I code Python ~ The shortest path from thought to working program

6 11

Updates to Docutils
by David Goodger May 24, 2003

May 24, 2003

A burst of creativity over the last few days has resulted in a slew of checkins. The snapshot has all the latest code: http://docutils.sf.net/docutils-snapshot.tgz New doctree elements implemented: "rubric", "admonition", and "attribution" (part of block quotes; see <http://docutils.sf.net/spec/rst/reStructuredText.html#block-quotes>). New directives implemented: "admonition", "rubric", "epigraph", "highlights", "unicode" and "class". Also added "class" options to "topic", "sidebar", "line-block", "parsed-literal", "contents", and "image"; and "figclass" to "figure". See <http://docutils.sf.net/spec/rst/directives.html>. The change to "line-block" and "parsed-literal" may cause problems; a blank line is now required before the directive content. The HTML Writer and default.css stylesheet have been updated to support all of this. Please give the latest code a try and report any problems you encounter. Enjoy! -- David Goodger http://starship.python.net/~goodger Programmer/sysadmin for hire: http://starship.python.net/~goodger/cv

1 0

Preparing docs for Python 2.2.3
by Fred L. Drake, Jr. May 22, 2003

May 22, 2003

I'll be preparing the Python docs for the 2.2.3 release today. If there are any fixes for 2.2.3 that absolutely *must* go in, we need to get them in over the next four hours. I don't expect to have any sort of Internet access from Friday (tomorrow) through next Tuesday, so the docs really need to be finished today. -Fred -- Fred L. Drake, Jr. <fdrake at acm.org> PythonLabs at Zope Corporation

1 0

Re: Mortgage Interest Rates Drop Again bfpvbczfjhzdf
by Sammie Porter May 20, 2003

May 20, 2003

FREE MORTGAGE QUOTE & BEST POSSIBLE RATES ! ------------------------------------------- Home Improvement Refinance Second Mortgage Home Equity Loans and More Even with less than perfect or NO credit! You will qualify for the best possible rate. Do NOT miss the chance to refinance at record low rates, so act now... http://www.wuyi-shop.com/3/index.asp?RefID=383102 remove http://gethelpu.com/Auto/index.htm f wkdtmy ncvnkfo iofg

1 0

Free Cable, save some extra money. qsunbcdmael rc ew jk
by Rachael Nicholson May 19, 2003

May 19, 2003

FREE CABLE PPV's FOR LIFE - Only $45 one-time fee ! Think about the $1000's you will save in Free Tv for only $45. * Free Adult Movies * Free PPV Movies * Free Sporting Events like Wrestling & Boxing * ETC *Bonus: Get a Free cell/cordless Phone Shield/Booster with your order! This reduces the chances of cancer when using your phone & increases your signal quality drastically. A $20 value FREE with order. ACT NOW !!! Click Here as offer expires soon--> http://www.a6zing29.com/xcart/customer/product.php?productid=16144&partner=… ""OPT-OUT"" system in compliance with state laws. If you wish to "OPT-OUT" from this mailing as well as the lists of thousands of other email providers please visit http://www.a6zing29.com/1/ 2va loen ghztodru wjgdnzviiagonpflpll hnpajt

1 0

why no macros for DOS/Windows and MacOS?
by Anthony Baxter May 19, 2003

May 19, 2003

We have a standard macro for Posix, for Unix, but none for DOS/Windows or for MacOS. Is this deliberate? Should it be added?

2 1

Re: [Python-Dev] [development doc updates]
by Barry Warsaw May 16, 2003

May 16, 2003

On Fri, 2003-05-16 at 11:35, Fred L. Drake wrote: > The development version of the documentation has been updated: > > http://www.python.org/dev/doc/devel/ > > Various updates, including Jim Fulton's efforts on updating the Extending & > Embedding manual. I think this one's gonna make my Python quotes file: "So, if you want to define a new object type, you need to create a new type object." :) -Barry

2 1

optparse docs need proofreading
by Greg Ward May 3, 2003

May 3, 2003

So you're sitting around, wondering what to do with your weekend, and worrying that the Python 2.3 documentation is not perfect yet. Well, you could proofread the documentation for optparse (currently section 6.20 of the "lib" manual), which was converted wholesale from reStructuredText to LaTeX, and still bears some scars. Both the DVI/PS/PDF output and HTML bear close examination. I'm working on it now, but will undoubtedly miss stuff, so feel free to email any glitches you notice in the latest CVS version to me. Greg -- Greg Ward <gward(a)python.net> http://www.gerg.ca/

1 0