Changeset 36def91 in rtems-docs for porting/task_context.rst


Ignore:
Timestamp:
Oct 28, 2016, 12:47:07 AM (4 years ago)
Author:
Joel Sherrill <joel@…>
Branches:
4.11, 5, master
Children:
f29b7c1c
Parents:
2b175c3
Message:

rtems-docs: Fix many unnecessary back slashes

File:
1 edited

Legend:

Unmodified
Added
Removed
  • porting/task_context.rst

    r2b175c3 r36def91  
    6565    #define CPU_STACK_ALIGNMENT        0
    6666
    67 NOTE:  This must be a power of 2 either 0 or greater than CPU_ALIGNMENT. \[XXX is this true?]
     67NOTE:  This must be a power of 2 either 0 or greater than CPU_ALIGNMENT. [XXX is this true?]
    6868
    6969Task Context
     
    150150
    151151    void _CPU_Context_Initialize(
    152     Context_Control \*_the_context,
    153     void            \*_stack_base,
    154     unsigned32       _size,
    155     unsigned32       _isr,
    156     void            \*_entry_point,
    157     unsigned32       _is_fp
     152      Context_Control *_the_context,
     153      void            *_stack_base,
     154      unsigned32       _size,
     155      unsigned32       _isr,
     156      void            *_entry_point,
     157      unsigned32       _is_fp
    158158    );
    159159
     
    187187
    188188    void _CPU_Context_switch(
    189     Context_Control  \*run,
    190     Context_Control  \*heir
     189    Context_Control  *run,
     190    Context_Control  *heir
    191191    );
    192192
     
    240240
    241241    void _CPU_Context_restore(
    242     Context_Control \*new_context
     242      Context_Control *new_context
    243243    );
    244244
     
    258258.. code:: c
    259259
    260     #define _CPU_Context_Restart_self( _the_context ) \\
    261     _CPU_Context_restore( (_the_context) )
     260    #define _CPU_Context_Restart_self( _the_context ) \
     261      _CPU_Context_restore( (_the_context) )
    262262
    263263XXX find a port which does not do it this way and include it here
     
    285285.. code:: c
    286286
    287     #if ( THIS_CPU_FAMILY_HAS_FPU == 1 ) /* where THIS_CPU_FAMILY \*/
    288     /* might be M68K \*/
    289     #define CPU_HARDWARE_FP     TRUE
     287    #if ( THIS_CPU_FAMILY_HAS_FPU == 1 ) /* where THIS_CPU_FAMILY */
     288                                         /* might be M68K */
     289      #define CPU_HARDWARE_FP     TRUE
    290290    #else
    291     #define CPU_HARDWARE_FP     FALSE
     291      #define CPU_HARDWARE_FP     FALSE
    292292    #endif
    293293
     
    439439.. code:: c
    440440
    441     #define _CPU_Context_Fp_start( _base, _offset ) \\
    442     ( (void \*) _Addresses_Add_offset( (_base), (_offset) ) )
     441    #define _CPU_Context_Fp_start( _base, _offset ) \
     442      ( (void *) _Addresses_Add_offset( (_base), (_offset) ) )
    443443
    444444In contrast, the m68k treats the floating point context area as a stack
     
    469469.. code:: c
    470470
    471     #define _CPU_Context_Initialize_fp( _destination ) \\
    472     { \\
    473     \*((Context_Control_fp \*) \*((void \**) _destination)) = \\
    474     _CPU_Null_fp_context; \\
     471    #define _CPU_Context_Initialize_fp( _destination ) \
     472    { \
     473      *((Context_Control_fp *) *((void **) _destination)) = \\
     474        _CPU_Null_fp_context; \\
    475475    }
    476476
     
    484484
    485485The _CPU_Context_save_fp_context routine is responsible for saving the FP
    486 context at \*fp_context_ptr.  If the point to load the FP context from is
     486context at *fp_context_ptr.  If the point to load the FP context from is
    487487changed then the pointer is modified by this routine.
    488488
    489489Sometimes a macro implementation of this is in cpu.h which dereferences
    490 the \** and a similarly named routine in this file is passed something like
    491 a (Context_Control_fp \*).  The general rule on making this decision is to
     490the ** and a similarly named routine in this file is passed something like
     491a (Context_Control_fp *).  The general rule on making this decision is to
    492492avoid writing assembly language.
    493493.. code:: c
    494494
    495495    void _CPU_Context_save_fp(
    496     void \**fp_context_ptr
     496      void **fp_context_ptr
    497497    )
    498498
     
    501501
    502502The _CPU_Context_restore_fp_context is responsible for restoring the FP
    503 context at \*fp_context_ptr.  If the point to load the FP context from is
     503context at *fp_context_ptr.  If the point to load the FP context from is
    504504changed then the pointer is modified by this routine.
    505505
    506506Sometimes a macro implementation of this is in cpu.h which dereferences
    507 the \** and a similarly named routine in this file is passed something like
    508 a (Context_Control_fp \*).  The general rule on making this decision is to
     507the ** and a similarly named routine in this file is passed something like
     508a (Context_Control_fp *).  The general rule on making this decision is to
    509509avoid writing assembly language.
    510510.. code:: c
    511511
    512512    void _CPU_Context_restore_fp(
    513     void \**fp_context_ptr
     513    void **fp_context_ptr
    514514    );
    515515
Note: See TracChangeset for help on using the changeset viewer.