From Fred L. Drake, Jr." References: <199801062151.QAA11514@lemur.magnet.com> Message-ID: <199801070338.WAA01393@weyr.cnri.reston.va.us> Andrew Kuchling writes: > [Doc-SIG note: I suppose there's no work being done on > changing the format of the docs? Weren't we going to move toward a > DocBook-like SGML markup? See Andrew, Aside from being distracted by Python 1.5 documentation issues (there's a lot of nits that got handled, mostly, plus info support in 1.5), I've been working on getting a reasonable libref->sgml conversion script running. I've gotten a lot done on it, but there are still a few issues with the basic conversion and then I need to finish the output DTD and make sure the output of the script validates against that. Once that's done, Paul Prescod will work on transforming that intermediate form into DocBook. We don't have a fixed schedule. At least for me, it's all personal time, with scheduling issues calling for me to play with them on evenings and weekends. Acceptance of the SGML conversion is determined by Guido *after* the work is done. I really think he wants to know that it'll work and not create a lot of maintainance problems or introduce more problematic tool issues (esp. availability). Of course, that's at least partially controlled by my willingness to dive into Perl for the latex2html support in the current HTML generation process. ;-) Perhaps I should post an update to the doc-sig, but the time to do that comes out of the time to get the job done. So I'll cc: this message to the doc-sig. -Fred -- Fred L. Drake, Jr. fdrake@cnri.reston.va.us Corporation for National Research Initiatives 1895 Preston White Drive Reston, VA 20191-5434 _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig@python.org administrivia to: doc-sig-request@python.org _______________ From bsd@scripps.edu Thu Jan 8 11:23:09 1998 From: bsd@scripps.edu (Bruce Duncan) Date: Thu, 8 Jan 1998 03:23:09 -0800 (PST) Subject: [DOC-SIG] Gendoc problems Message-ID: <199801081123.DAA08463@joseph.scripps.edu> Subject: Gendoc problems Greetings, We have been unable to get gendoc to run under python 1.5 (or even python 1.4). The problems seem to be caused by differences between the ni module and python 1.5 packages. Is there a version of gendoc that runs under python 1.5? Also, is gendoc still under active development? We are very interested in using this package and appreciate any help in getting it running. Thanks, Bruce Duncan _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig@python.org administrivia to: doc-sig-request@python.org _______________ From Robin.K.Friedrich@USAHQ.UnitedSpaceAlliance.com Thu Jan 8 20:55:47 1998 From: Robin.K.Friedrich@USAHQ.UnitedSpaceAlliance.com (Friedrich, Robin K) Date: Thu, 8 Jan 1998 14:55:47 -0600 Subject: [DOC-SIG] Gendoc problems Message-ID: OK Guys, since this has been discussed before I know there is some interest in this matter. Gendoc needs to be redesigned (although it's great) to make it more flexible. Let's restart the thread discussing a design for the classes which describe the structure of documentation and start work on them (and the code which populates them). With 1.5's new package system we ought to be able to structure an extensible autogenerator of Python source documentation with plugins for multiple output formats. >It's time for the doc-sig to deliver something! _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig@python.org administrivia to: doc-sig-request@python.org _______________ From 8dmBBpwUT@a1oI.com Wed Jan 14 03:36:30 1998 From: 8dmBBpwUT@a1oI.com (8dmBBpwUT@a1oI.com) Date: 14 Jan 98 3:36:30 PM Subject: [DOC-SIG] Let Us Do It For You! Message-ID: LET US DO YOUR BULK MAILINGS!!! ..$350 PER MILLION ADDRESSES SENT ..$250 PER 1/2 MILLION ADDRESSES SENT THE WAY OF THE FUTURE FOR SUCCESS IN YOUR BUSINESS! Our company will do bulk emailing for your product/service. Addresses are extracted daily by six of our computers, which run 24 hours a day 7 days a week, scanning the net for new addresses. Estimated 60-80,000 addresses extracted daily. They are fresh! Over 40 million addresses on file. No more than 2 pages (50 lines), no porn and no foul language. $50 per page/25 lines per page beyond 2 pages. We do not do targeted mailings at this price. Targeted mailings: $150 per 50,000 addresses extracted or less. We can extract by country, occupation, organizations, associations, product, etc. If we can not search and extract what you need, then nobody can. There are no lower prices on the net. Your mailing can be done in a matter of hours. We have 6 computers extracting addresses 24/7. For the fastest service, cheapest prices and cleanest mailings call our processing and new accounts office at 904-282-0945, Monday - Friday 9 - 5 EST. If the line is busy, please keep trying, as bulk mailing is growing fast. We do want to work with you to advertise your product. To have your name removed, call our processing office. Any negative responses will be dealt with accordingly. _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig@python.org administrivia to: doc-sig-request@python.org _______________ From da@skivs.ski.org Fri Jan 16 17:53:09 1998 From: da@skivs.ski.org (David Ascher) Date: Fri, 16 Jan 1998 09:53:09 -0800 (PST) Subject: [DOC-SIG] gendoc/HTMLgen & extension modules... Message-ID: Just a query -- is there any tool out there which would make it possible to blend together the doc from a set of Python scripts (as generated by HTMLgen) and the doc from an annotated C file (for extension modules)? --da _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig@python.org administrivia to: doc-sig-request@python.org _______________ From Robin.K.Friedrich@USAHQ.UnitedSpaceAlliance.com Fri Jan 16 19:01:56 1998 From: Robin.K.Friedrich@USAHQ.UnitedSpaceAlliance.com (Friedrich, Robin K) Date: Fri, 16 Jan 1998 13:01:56 -0600 Subject: [DOC-SIG] gendoc/HTMLgen & extension modules... Message-ID: Well gendoc (when using import mode -i) derives most of it's info from the doc strings. So if the C extension has doc strings exported it should be transparent, (or if it isn't now it could be made so). If you are referring to C source comment annotation as the info source then that would require the use of some other tool (parsers for which I'm sure exist already). Although I would discourage that in favor of standard use of doc strings. I'll consider this a requirement upon Gendoc - TNG. Robin >---------- >From: David Ascher[SMTP:da@skivs.ski.org] >Sent: Friday, January 16, 1998 11:53 AM >To: doc-sig@python.org >Subject: [DOC-SIG] gendoc/HTMLgen & extension modules... > >Just a query -- is there any tool out there which would make it possible >to blend together the doc from a set of Python scripts (as generated by >HTMLgen) and the doc from an annotated C file (for extension modules)? > >--da > _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig@python.org administrivia to: doc-sig-request@python.org _______________ From jim.fulton@digicool.com Fri Jan 16 19:21:32 1998 From: jim.fulton@digicool.com (Jim Fulton) Date: Fri, 16 Jan 1998 14:21:32 -0500 Subject: [DOC-SIG] gendoc/HTMLgen & extension modules... References: Message-ID: <34BFB33C.3472@digicool.com> Friedrich, Robin K wrote: > > Well gendoc (when using import mode -i) derives most of it's info from > the doc strings. So if the C extension has doc strings exported it > should be transparent, (or if it isn't now it could be made so). Ah. Cool. If you build your extension with ExtensionClass, then the doc strings of your extension types and their methods will be accessable too. How does gendoc tell that it's found a class? If it checks for type(o) is ClassType, then it won't find ExtensionClasses, but if it checks for __bases__ it will. :-) Jim -- Jim Fulton mailto:jim@digicool.com Technical Director (888) 344-4332 Python Powered! Digital Creations http://www.digicool.com http://www.python.org _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig@python.org administrivia to: doc-sig-request@python.org _______________ From bkIpxv2w9@stak1ed.net Thu Jan 22 11:03:38 1998 From: bkIpxv2w9@stak1ed.net (bkIpxv2w9@stak1ed.net) Date: 22 Jan 98 11:03:38 PM Subject: [DOC-SIG] Are You Happy? Message-ID: There is brilliant information available to you, that will enable you to fully understand yourself and everybody else. This knowledge can benefit you tremendously in many ways. It can help you to get the very best out of your career, or discover your most suitable new career, and of course being happy at work, really improves the finances. It can also really enhance your love life. If you're in a relationship, it works great, because you are able to fully understand your own and your partner's emotions and motivations. If you're not, you will know exactly what you want from your perfect mate and what they will find attractive about you. Another big advantage to becoming balanced and happy is that good health runs hand in hand. Take a closer look two free pages of information at: http://www.po9.com _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig@python.org administrivia to: doc-sig-request@python.org _______________ From esikes@anet-dfw.com Mon Jan 26 03:55:42 1998 From: esikes@anet-dfw.com (esikes@anet-dfw.com) Date: Sun, 25 Jan 1998 21:55:42 -0600 (CST) Subject: [DOC-SIG] Home Bussiness Message-ID: We understand that you are interested in, or are already involved in marketing. We are searching for people to get into the highest paying plan in the world. Contact me for all the details. I have 28yrs. in the business world. 1-(972) 557-0955 Ed Sikes You may also visit my website at: http://www.admaxsilver.com/sikes/ **(( You have recieved this message because you have visited one of our business opportunity sites in the past. If you have recieved this message in error or simply wish to be removed from our list please reply with the word "remove" in the subject header. We apologize for any inconvience if we have sent this to you in error.))** _______________ DOC-SIG - SIG for the Python Documentation Project send messages to: doc-sig@python.org administrivia to: doc-sig-request@python.org _______________