|
4 | 4 | \title{What's New in Python 2.3} |
5 | 5 | \release{0.03} |
6 | 6 | \author{A.M. Kuchling} |
7 | | -\authoraddress{ \email{ [email protected]}} |
| 7 | +\authoraddress{ \email{ [email protected]}} |
8 | 8 |
|
9 | 9 | \begin{document} |
10 | 10 | \maketitle |
|
19 | 19 | %\section{Introduction \label{intro}} |
20 | 20 |
|
21 | 21 | {\large This article is a draft, and is currently up to date for some |
22 | | -random version of the CVS tree around mid-July 2002. Please send any |
| 22 | +random version of the CVS tree from early November 2002. Please send any |
23 | 23 | additions, comments or errata to the author.} |
24 | 24 |
|
25 | 25 | This article explains the new features in Python 2.3. The tentative |
@@ -1072,29 +1072,32 @@ \section{New and Improved Modules} |
1072 | 1072 | particular encoding, by specifying an optional encoding argument to |
1073 | 1073 | the \method{toxml()} and \method{toprettyxml()} methods of DOM nodes. |
1074 | 1074 |
|
1075 | | -\item The \function{stat} family of functions can now report fractions |
1076 | | -of a second in a time stamp. Similar to \function{time.time}, such |
1077 | | -time stamps are represented as floats. |
| 1075 | +\item The \function{*stat()} family of functions can now report |
| 1076 | +fractions of a second in a timestamp. Such time stamps are |
| 1077 | +represented as floats, similar to \function{time.time()}. |
1078 | 1078 |
|
1079 | | -During testing, it was found that some applications break if time |
1080 | | -stamps are floats. For compatibility, when using the tuple interface |
| 1079 | +During testing, it was found that some applications will break if time |
| 1080 | +stamps are floats. For compatibility, when using the tuple interface |
1081 | 1081 | of the \class{stat_result}, time stamps are represented as integers. |
1082 | | -When using named fields (first introduced in Python 2.2), time stamps |
1083 | | -are still represented as ints, unless \function{os.stat_float_times} |
1084 | | -is invoked: |
| 1082 | +When using named fields (a feature first introduced in Python 2.2), |
| 1083 | +time stamps are still represented as ints, unless |
| 1084 | +\function{os.stat_float_times()} is invoked to enable float return |
| 1085 | +values: |
1085 | 1086 |
|
1086 | 1087 | \begin{verbatim} |
| 1088 | +>>> os.stat("/tmp").st_mtime |
| 1089 | +1034791200 |
1087 | 1090 | >>> os.stat_float_times(True) |
1088 | 1091 | >>> os.stat("/tmp").st_mtime |
1089 | 1092 | 1034791200.6335014 |
1090 | 1093 | \end{verbatim} |
1091 | 1094 |
|
1092 | | -In Python 2.4, the default will change to return floats. |
| 1095 | +In Python 2.4, the default will change to always returning floats. |
1093 | 1096 |
|
1094 | 1097 | Application developers should use this feature only if all their |
1095 | 1098 | libraries work properly when confronted with floating point time |
1096 | | -stamps (or use the tuple API). If used, the feature should be |
1097 | | -activated on application level, instead of trying to activate it on a |
| 1099 | +stamps, or if they use the tuple API. If used, the feature should be |
| 1100 | +activated on an application level instead of trying to enable it on a |
1098 | 1101 | per-use basis. |
1099 | 1102 |
|
1100 | 1103 | \end{itemize} |
@@ -1345,6 +1348,7 @@ \section{Acknowledgements \label{acks}} |
1345 | 1348 | suggestions, corrections and assistance with various drafts of this |
1346 | 1349 | article: Simon Brunning, Michael Chermside, Scott David Daniels, Fred~L. Drake, Jr., |
1347 | 1350 | Michael Hudson, Detlef Lannert, Martin von L\"owis, Andrew MacIntyre, |
1348 | | -Lalo Martins, Gustavo Niemeyer, Neal Norwitz, Jason Tishler. |
| 1351 | +Lalo Martins, Gustavo Niemeyer, Neal Norwitz, Neil Schemenauer, Jason |
| 1352 | +Tishler. |
1349 | 1353 |
|
1350 | 1354 | \end{document} |
0 commit comments