~ubuntu-branches/ubuntu/lucid/python2.6/lucid

« back to all changes in this revision

Viewing changes to Doc/library/sys.rst

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Klose
  • Date: 2010-03-11 13:30:19 UTC
  • mto: (10.1.13 sid)
  • mto: This revision was merged to the branch mainline in revision 44.
  • Revision ID: james.westby@ubuntu.com-20100311133019-sblbooa3uqrkoe70
Tags: upstream-2.6.5~rc2
ImportĀ upstreamĀ versionĀ 2.6.5~rc2

Show diffs side-by-side

added added

removed removed

Lines of Context:
275
275
   +------------------------------+------------------------------------------+
276
276
   | :const:`dont_write_bytecode` | -B                                       |
277
277
   +------------------------------+------------------------------------------+
 
278
   | :const:`no_user_site`        | -s                                       |
 
279
   +------------------------------+------------------------------------------+
278
280
   | :const:`no_site`             | -S                                       |
279
281
   +------------------------------+------------------------------------------+
280
282
   | :const:`ignore_environment`  | -E                                       |
285
287
   +------------------------------+------------------------------------------+
286
288
   | :const:`unicode`             | -U                                       |
287
289
   +------------------------------+------------------------------------------+
 
290
   | :const:`bytes_warning`       | -b                                       |
 
291
   +------------------------------+------------------------------------------+
288
292
 
289
293
   .. versionadded:: 2.6
290
294
 
417
421
   that is deeper than the call stack, :exc:`ValueError` is raised.  The default
418
422
   for *depth* is zero, returning the frame at the top of the call stack.
419
423
 
420
 
   This function should be used for internal and specialized purposes only.
 
424
   .. impl-detail::
 
425
 
 
426
      This function should be used for internal and specialized purposes only.
 
427
      It is not guaranteed to exist in all implementations of Python.
421
428
 
422
429
 
423
430
.. function:: getprofile()
439
446
 
440
447
   Get the trace function as set by :func:`settrace`.
441
448
 
442
 
   .. note::
 
449
   .. impl-detail::
443
450
 
444
451
      The :func:`gettrace` function is intended only for implementing debuggers,
445
 
      profilers, coverage tools and the like. Its behavior is part of the
446
 
      implementation platform, rather than part of the language definition,
447
 
      and thus may not be available in all Python implementations.
 
452
      profilers, coverage tools and the like.  Its behavior is part of the
 
453
      implementation platform, rather than part of the language definition, and
 
454
      thus may not be available in all Python implementations.
448
455
 
449
456
   .. versionadded:: 2.6
450
457
 
795
802
 
796
803
   ``'c_call'``
797
804
      A C function is about to be called.  This may be an extension function or
798
 
      a builtin.  *arg* is the C function object.
 
805
      a built-in.  *arg* is the C function object.
799
806
 
800
807
   ``'c_return'``
801
808
      A C function has returned. *arg* is ``None``.
808
815
 
809
816
   For more information on code and frame objects, refer to :ref:`types`.
810
817
 
811
 
   .. note::
 
818
   .. impl-detail::
812
819
 
813
820
      The :func:`settrace` function is intended only for implementing debuggers,
814
 
      profilers, coverage tools and the like. Its behavior is part of the
815
 
      implementation platform, rather than part of the language definition, and thus
816
 
      may not be available in all Python implementations.
 
821
      profilers, coverage tools and the like.  Its behavior is part of the
 
822
      implementation platform, rather than part of the language definition, and
 
823
      thus may not be available in all Python implementations.
817
824
 
818
825
 
819
826
.. function:: settscdump(on_flag)