MdePkg/Library/BaseLib/AArch64: Comment style harmonization

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Pete Batard <pete@akeo.ie>
Reviewed-by: Liming Gao <liming.gao@intel.com>
This commit is contained in:
Pete Batard 2018-03-19 20:48:15 +08:00 committed by Liming Gao
parent 8d8c487fb9
commit ec66159475
2 changed files with 98 additions and 94 deletions

View File

@ -1,17 +1,17 @@
//------------------------------------------------------------------------------ #------------------------------------------------------------------------------
// #
// Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.<BR> # Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.<BR>
// Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR> # Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
// Portions copyright (c) 2011 - 2013, ARM Limited. All rights reserved.<BR> # Portions copyright (c) 2011 - 2013, ARM Limited. All rights reserved.<BR>
// This program and the accompanying materials # This program and the accompanying materials
// are licensed and made available under the terms and conditions of the BSD License # are licensed and made available under the terms and conditions of the BSD License
// which accompanies this distribution. The full text of the license may be found at # which accompanies this distribution. The full text of the license may be found at
// http://opensource.org/licenses/bsd-license.php. # http://opensource.org/licenses/bsd-license.php.
// #
// THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, # THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
// WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. # WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
// #
//------------------------------------------------------------------------------ #------------------------------------------------------------------------------
.text .text
.align 5 .align 5
@ -19,26 +19,27 @@
GCC_ASM_EXPORT(InternalSwitchStackAsm) GCC_ASM_EXPORT(InternalSwitchStackAsm)
GCC_ASM_EXPORT(CpuPause) GCC_ASM_EXPORT(CpuPause)
/** #/**
// #
// This allows the caller to switch the stack and goes to the new entry point # This allows the caller to switch the stack and goes to the new entry point
// #
// @param EntryPoint The pointer to the location to enter # @param EntryPoint The pointer to the location to enter
// @param Context Parameter to pass in # @param Context Parameter to pass in
// @param Context2 Parameter2 to pass in # @param Context2 Parameter2 to pass in
// @param NewStack New Location of the stack # @param NewStack New Location of the stack
// #
// @return Nothing. Goes to the Entry Point passing in the new parameters # @return Nothing. Goes to the Entry Point passing in the new parameters
// #
VOID #**/
EFIAPI #VOID
InternalSwitchStackAsm ( #EFIAPI
SWITCH_STACK_ENTRY_POINT EntryPoint, #InternalSwitchStackAsm (
VOID *Context, # SWITCH_STACK_ENTRY_POINT EntryPoint,
VOID *Context2, # VOID *Context,
VOID *NewStack # VOID *Context2,
); # VOID *NewStack
**/ # );
#
ASM_PFX(InternalSwitchStackAsm): ASM_PFX(InternalSwitchStackAsm):
mov x29, #0 mov x29, #0
mov x30, x0 mov x30, x0
@ -47,19 +48,20 @@ ASM_PFX(InternalSwitchStackAsm):
mov x1, x2 mov x1, x2
ret ret
/** #/**
// #
// Requests CPU to pause for a short period of time. # Requests CPU to pause for a short period of time.
// #
// Requests CPU to pause for a short period of time. Typically used in MP # Requests CPU to pause for a short period of time. Typically used in MP
// systems to prevent memory starvation while waiting for a spin lock. # systems to prevent memory starvation while waiting for a spin lock.
// #
VOID #**/
EFIAPI #VOID
CpuPause ( #EFIAPI
VOID #CpuPause (
) # VOID
**/ # )
#
ASM_PFX(CpuPause): ASM_PFX(CpuPause):
nop nop
nop nop

View File

@ -1,42 +1,43 @@
//------------------------------------------------------------------------------ ;------------------------------------------------------------------------------
// ;
// Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.<BR> ; Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.<BR>
// Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR> ; Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
// Portions copyright (c) 2011 - 2013, ARM Limited. All rights reserved.<BR> ; Portions copyright (c) 2011 - 2013, ARM Limited. All rights reserved.<BR>
// This program and the accompanying materials ; This program and the accompanying materials
// are licensed and made available under the terms and conditions of the BSD License ; are licensed and made available under the terms and conditions of the BSD License
// which accompanies this distribution. The full text of the license may be found at ; which accompanies this distribution. The full text of the license may be found at
// http://opensource.org/licenses/bsd-license.php. ; http://opensource.org/licenses/bsd-license.php.
// ;
// THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, ; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
// WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. ; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
// ;
//------------------------------------------------------------------------------ ;------------------------------------------------------------------------------
EXPORT InternalSwitchStackAsm EXPORT InternalSwitchStackAsm
EXPORT CpuPause EXPORT CpuPause
AREA BaseLib_LowLevel, CODE, READONLY AREA BaseLib_LowLevel, CODE, READONLY
/** ;/**
// ;
// This allows the caller to switch the stack and goes to the new entry point ; This allows the caller to switch the stack and goes to the new entry point
// ;
// @param EntryPoint The pointer to the location to enter ; @param EntryPoint The pointer to the location to enter
// @param Context Parameter to pass in ; @param Context Parameter to pass in
// @param Context2 Parameter2 to pass in ; @param Context2 Parameter2 to pass in
// @param NewStack New Location of the stack ; @param NewStack New Location of the stack
// ;
// @return Nothing. Goes to the Entry Point passing in the new parameters ; @return Nothing. Goes to the Entry Point passing in the new parameters
// ;
VOID ;**/
EFIAPI ;VOID
InternalSwitchStackAsm ( ;EFIAPI
SWITCH_STACK_ENTRY_POINT EntryPoint, ;InternalSwitchStackAsm (
VOID *Context, ; SWITCH_STACK_ENTRY_POINT EntryPoint,
VOID *Context2, ; VOID *Context,
VOID *NewStack ; VOID *Context2,
); ; VOID *NewStack
**/ ; );
;
InternalSwitchStackAsm InternalSwitchStackAsm
mov x29, #0 mov x29, #0
mov x30, x0 mov x30, x0
@ -45,19 +46,20 @@ InternalSwitchStackAsm
mov x1, x2 mov x1, x2
ret ret
/** ;/**
// ;
// Requests CPU to pause for a short period of time. ; Requests CPU to pause for a short period of time.
// ;
// Requests CPU to pause for a short period of time. Typically used in MP ; Requests CPU to pause for a short period of time. Typically used in MP
// systems to prevent memory starvation while waiting for a spin lock. ; systems to prevent memory starvation while waiting for a spin lock.
// ;
VOID ;**/
EFIAPI ;VOID
CpuPause ( ;EFIAPI
VOID ;CpuPause (
) ; VOID
**/ ; )
;
CpuPause CpuPause
nop nop
nop nop