| OLD | NEW |
| 1 .. _devcycle-progress-events: | 1 .. _devcycle-progress-events: |
| 2 | 2 |
| 3 :template: standard_nacl_api | 3 :template: standard_nacl_api |
| 4 | 4 |
| 5 ############### | 5 ############### |
| 6 Progress Events | 6 Progress Events |
| 7 ############### | 7 ############### |
| 8 | 8 |
| 9 .. contents:: | 9 .. contents:: |
| 10 :local: | 10 :local: |
| 11 :backlinks: none | 11 :backlinks: none |
| 12 :depth: 2 | 12 :depth: 2 |
| 13 | 13 |
| 14 There are five types of events that developers can respond to in Native Client: | 14 There are five types of events that developers can respond to in Native Client: |
| 15 progress, message, view change, focus, and input events (each described in the | 15 progress, message, view change, focus, and input events (each described in the |
| 16 glossary below). This chapter describes how to monitor progress events (events | 16 glossary below). This chapter describes how to monitor progress events (events |
| 17 that occur during the loading and execution of a Native Client module). This | 17 that occur during the loading and execution of a Native Client module). This |
| 18 chapter assumes you are familiar with the material presented in the | 18 chapter assumes you are familiar with the material presented in the |
| 19 :doc:`Technical Overview <../../overview>`. | 19 :doc:`Technical Overview <../../overview>`. |
| 20 | 20 |
| 21 .. Note:: | 21 .. Note:: |
| 22 :class: note | 22 :class: note |
| 23 | 23 |
| 24 The load_progress example illustrates progress event handling. You can find | 24 The load_progress example illustrates progress event handling. You can find |
| 25 this code in the ``/examples/tutorial/load_progress/`` directory in the Native | 25 this code in the ``/pepper_<version>/examples/tutorial/load_progress/`` |
| 26 Client SDK download. | 26 directory in the Native Client SDK download. |
| 27 | 27 |
| 28 Module loading and progress events | 28 Module loading and progress events |
| 29 ================================== | 29 ================================== |
| 30 | 30 |
| 31 The Native Client runtime reports a set of state changes during the module | 31 The Native Client runtime reports a set of state changes during the module |
| 32 loading process by means of DOM progress events. This set of events is a direct | 32 loading process by means of DOM progress events. This set of events is a direct |
| 33 port of the proposed W3C `Progress Events | 33 port of the proposed W3C `Progress Events |
| 34 <http://www.w3.org/TR/progress-events/>`_ standard (except for the ``crash`` | 34 <http://www.w3.org/TR/progress-events/>`_ standard (except for the ``crash`` |
| 35 event which is an extension of the W3C standard). The following table lists the | 35 event which is an extension of the W3C standard). The following table lists the |
| 36 events types reported by the Native Client runtime: | 36 events types reported by the Native Client runtime: |
| (...skipping 277 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 314 crash, the ``crash`` progress event is issued and the ``exitStatus`` attribute | 314 crash, the ``crash`` progress event is issued and the ``exitStatus`` attribute |
| 315 will contain the numeric value of the exit status: | 315 will contain the numeric value of the exit status: |
| 316 | 316 |
| 317 * In the case of explicit calls to ``exit(n)``, the numeric value will be | 317 * In the case of explicit calls to ``exit(n)``, the numeric value will be |
| 318 ``n`` (between 0 and 255). | 318 ``n`` (between 0 and 255). |
| 319 * In the case of crashes and calls to ``abort()``, the numeric value will | 319 * In the case of crashes and calls to ``abort()``, the numeric value will |
| 320 be non-zero, but the exact value will depend on the chosen libc and the | 320 be non-zero, but the exact value will depend on the chosen libc and the |
| 321 target architecture, and may change in the future. Applications should not | 321 target architecture, and may change in the future. Applications should not |
| 322 rely on the ``exitStatus`` value being stable in these cases, but the value | 322 rely on the ``exitStatus`` value being stable in these cases, but the value |
| 323 may nevertheless be useful for temporary debugging. | 323 may nevertheless be useful for temporary debugging. |
| OLD | NEW |