Re: [Python-checkins] CVS: python/dist/src/Doc/lib libos.tex,1.38,1.39
Barry A. Warsaw:
Update of /projects/cvsroot/python/dist/src/Doc/lib [...] libos.tex [...] Availability: Macintosh, \UNIX{}, Windows. \end{funcdesc} --- 703,712 ---- \end{funcdesc}
! \begin{funcdesc}{utime}{path, times} ! Set the access and modified times of the file specified by \var{path}. ! If \var{times} is \code{None}, then the file's access and modified ! times are set to the current time. Otherwise, \var{times} must be a ! 2-tuple of numbers, of the form \var{(atime, mtime)} which is used to ! set the access and modified times, respectively. Availability: Macintosh, \UNIX{}, Windows. \end{funcdesc}
I may have missed something, but I haven't seen a patch to the WinXX and MacOS implementation of the 'utime' function. So either the documentation should explicitly point out, that the new additional signature is only available on Unices or even better it should be implemented on all platforms so that programmers intending to write portable Python have not to worry about this. I suggest an additional note saying that this signature has been added in Python 1.6. There used to be several such notes all over the documentation saying for example: "New in version 1.5.2." which I found very useful in the past! Regards, Peter
! \begin{funcdesc}{utime}{path, times} ! Set the access and modified times of the file specified by \var{path}. ! If \var{times} is \code{None}, then the file's access and modified ! times are set to the current time. Otherwise, \var{times} must be a ! 2-tuple of numbers, of the form \var{(atime, mtime)} which is used to ! set the access and modified times, respectively. Availability: Macintosh, \UNIX{}, Windows. \end{funcdesc}
I may have missed something, but I haven't seen a patch to the WinXX and MacOS implementation of the 'utime' function. So either the documentation should explicitly point out, that the new additional signature is only available on Unices or even better it should be implemented on all platforms so that programmers intending to write portable Python have not to worry about this.
Actually, it works on WinXX (tested on 98). The utime() implementation there is the same file as on Unix, so the patch fixed both platforms. The MS C library only seems to set the mtime, but that's okay. On Mac, I hope that the utime() function in GUSI 2 does this, in which case Jack Jansen needs to copy Barry's patch.
I suggest an additional note saying that this signature has been added in Python 1.6. There used to be several such notes all over the documentation saying for example: "New in version 1.5.2." which I found very useful in the past!
Thanks, you're right! --Guido van Rossum (home page: http://www.python.org/~guido/)
"PF" == Peter Funk <pf@artcom-gmbh.de> writes:
PF> I suggest an additional note saying that this signature has PF> been added in Python 1.6. There used to be several such notes PF> all over the documentation saying for example: "New in version PF> 1.5.2." which I found very useful in the past! Good point. Fred, what is the Right Way to do this? -Barry
bwarsaw@python.org writes:
Good point. Fred, what is the Right Way to do this?
Pester me night and day until it gets done (email only!). Unless of course you've already seen the check-in messages. ;) -Fred -- Fred L. Drake, Jr. <fdrake at acm.org> Corporation for National Research Initiatives
"Fred" == Fred L Drake, Jr <fdrake@acm.org> writes:
Fred> Pester me night and day until it gets done (email only!). Okay, I'll cancel the daily delivery of angry rabid velco monkeys. Fred> Unless of course you've already seen the check-in messages. Fred> ;) Saw 'em. Thanks. -Barry Return-Path: <sc-publicity-return-3-python-dev=python.org@software-carpentry.com> Delivered-To: python-dev@python.org Received: from merlin.codesourcery.com (merlin.codesourcery.com [206.168.99.1]) by dinsdale.python.org (Postfix) with SMTP id 81F951CD8B for <python-dev@python.org>; Tue, 2 May 2000 14:45:04 -0400 (EDT) Received: (qmail 9404 invoked by uid 513); 2 May 2000 18:53:01 -0000 Mailing-List: contact sc-publicity-help@software-carpentry.com; run by ezmlm Precedence: bulk X-No-Archive: yes Delivered-To: mailing list sc-publicity@software-carpentry.com Delivered-To: moderator for sc-publicity@software-carpentry.com Received: (qmail 5829 invoked from network); 2 May 2000 18:12:54 -0000 Date: Tue, 2 May 2000 14:04:56 -0400 (EDT) From: <gvwilson@nevex.com> To: sc-discuss@software-carpentry.com, sc-announce@software-carpentry.com, sc-publicity@software-carpentry.com Message-ID: <Pine.LNX.4.10.10005021403560.30804-100000@akbar.nevex.com> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Subject: [Python-Dev] Software Carpentry Design Competition Finalists Sender: python-dev-admin@python.org Errors-To: python-dev-admin@python.org X-BeenThere: python-dev@python.org X-Mailman-Version: 2.0beta3 List-Id: Python core developers <python-dev.python.org> Software Carpentry Design Competition First-Round Results http://www.software-carpentry.com May 2, 2000 The Software Carpentry Project is pleased to announce the selection of finalists in its first Open Source Design Competition. There were many strong entries, and we would like to thank everyone who took the time to participate. We would also like to invite everyone who has been involved to contact the teams listed below, and see if there is any way to collaborate in the second round. Many of you had excellent ideas that deserve to be in the final tools, and the more involved you are in discussions over the next two months, the easier it will be for you to take part in the ensuing implementation effort. The 12 entries that are going forward in the "Configuration", "Build", and "Track" categories are listed below (in alphabetical order). The four prize-winning entries in the "Test" category are also listed, but as is explained there, we are putting this section of the competition on hold for a couple of months while we try to refine the requirements. You can inspect these entries on-line at: http://www.software-carpentry.com/first-round.html And so, without further ado... == Configuration The final four entries in the "Configuration" category are: * BuildConf Vassilis Virvilis * ConfBase Stefan Knappmann * SapCat Lindsay Todd * Tan David Ascher == Build The finalists in the "Build" category are: * Black David Ascher and Trent Mick * PyMake Rich Miller * ScCons Steven Knight * Tromey Tom Tromey Honorable mentions in this category go to: * Forge Bill Bitner, Justin Patterson, and Gilbert Ramirez * Quilt David Lamb == Track The four entries to go forward in the "Track" category are: * Egad John Martin * K2 David Belfer-Shevett * Roundup Ka-Ping Yee * Tracker Ken Manheimer There is also an honorable mention for: * TotalTrack Alex Samuel, Mark Mitchell == Test This category was the most difficult one for the judges. First-round prizes are being awarded to * AppTest Linda Timberlake * TestTalk Chang Liu * Thomas Patrick Campbell-Preston * TotalQuality Alex Samuel, Mark Mitchell However, the judges did not feel that any of these tools would have an impact on Open Source software development in general, or scientific and numerical programming in particular. This is due in large part to the vagueness of the posted requirements, for which the project coordinator (Greg Wilson) accepts full responsibility. We will therefore not be going forward with this category at the present time. Instead, the judges and others will develop narrower, more specific requirements, guidelines, and expectations. The category will be re-opened in July 2000. == Contact The aim of the Software Carpentry project is to create a new generation of easy-to-use software engineering tools, and to document both those tools and the working practices they are meant to support. The Advanced Computing Laboratory at Los Alamos National Laboratory is providing $860,000 of funding for Software Carpentry, which is being administered by Code Sourcery, LLC. For more information, contact the project coordinator, Dr. Gregory V. Wilson, at 'gvwilson@software-carpentry.com', or on +1 (416) 504 2325 ext. 229. == Footnote: Entries from CodeSourcery, LLC Two entries (TotalTrack and TotalQuality) were received from employees of CodeSourcery, LLC, the company which is hosting the Software Carpentry web site. We discussed this matter with Dr. Rod Oldehoeft, Deputy Directory of the Advanced Computing Laboratory at Los Alamos National Laboratory. His response was: John Reynders [Director of the ACL] and I have discussed this matter. We agree that since the judges who make decisions are not affiliated with Code Sourcery, there is no conflict of interest. Code Sourcery gains no advantage by hosting the Software Carpentry web pages. Please continue evaluating all the entries on their merits, and choose the best for further eligibility. Note that the project coordinator, Greg Wilson, is neither employed by CodeSourcery, nor a judge in the competition.
participants (4)
-
bwarsaw＠python.org -
Fred L. Drake, Jr. -
Guido van Rossum -
pf＠artcom-gmbh.de