sravan/system76-edk2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Refine comments and two code style.

Browse Source 
Signed-off-by: ydong10

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@12263 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
ydong10
2011-09-02 08:05:34 +00:00
parent 6709bbd17f
commit 4ff7e37b4f
51 changed files with 498 additions and 495 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
ShellPkg/Application/Shell/ConsoleLogger.h
View File

@ -80,7 +80,7 @@ ConsoleLoggerInstall(
Return the system to the state it was before InstallConsoleLogger
was installed.
@param[in,out] ConsoleInfo The object from the install function.
@param[in, out] ConsoleInfo The object from the install function.
@retval EFI_SUCCESS The operation was successful
@return other The operation failed. This was from UninstallProtocolInterface.

2
ShellPkg/Application/Shell/ConsoleWrappers.c
View File

@ -82,7 +82,7 @@ FileBasedSimpleTextInReset(
ReadKeyStroke function for the fake simple text input.
@param[in] This A pointer to the SimpleTextIn structure.
@param[in,out] Key A pointer to the Key structure to fill.
@param[in, out] Key A pointer to the Key structure to fill.
@retval EFI_SUCCESS The read was successful.
**/

8
ShellPkg/Application/Shell/FileHandleInternal.h
View File

@ -19,8 +19,8 @@
Move the cursor position one character backward.
@param[in] LineLength Length of a line. Get it by calling QueryMode
@param[in,out] Column Current column of the cursor position
@param[in,out] Row Current row of the cursor position
@param[in, out] Column Current column of the cursor position
@param[in, out] Row Current row of the cursor position
**/
VOID
EFIAPI
@ -35,8 +35,8 @@ MoveCursorBackward (
@param[in] LineLength Length of a line.
@param[in] TotalRow Total row of a screen
@param[in,out] Column Current column of the cursor position
@param[in,out] Row Current row of the cursor position
@param[in, out] Column Current column of the cursor position
@param[in, out] Row Current row of the cursor position
**/
VOID
EFIAPI

36
ShellPkg/Application/Shell/FileHandleWrappers.c
View File

@ -97,7 +97,7 @@ FileInterfaceNopSetPosition(
@param[in] This Ignored.
@param[in] InformationType Ignored.
@param[in,out] BufferSize Ignored.
@param[in, out] BufferSize Ignored.
@param[out] Buffer Ignored.
@retval EFI_UNSUPPORTED
@ -142,7 +142,7 @@ FileInterfaceNopSetInfo(
Writes data to the screen.
@param[in] This The pointer to the EFI_FILE_PROTOCOL object.
@param[in,out] BufferSize Size in bytes of Buffer.
@param[in, out] BufferSize Size in bytes of Buffer.
@param[in] Buffer The pointer to the buffer to write.
@retval EFI_UNSUPPORTED No output console is supported.
@ -167,7 +167,7 @@ FileInterfaceStdOutWrite(
File style interface for StdIn (Write).
@param[in] This Ignored.
@param[in,out] BufferSize Ignored.
@param[in, out] BufferSize Ignored.
@param[in] Buffer Ignored.
@retval EFI_UNSUPPORTED
@ -189,7 +189,7 @@ FileInterfaceStdInWrite(
Writes error to the error output.
@param[in] This The pointer to the EFI_FILE_PROTOCOL object.
@param[in,out] BufferSize Size in bytes of Buffer.
@param[in, out] BufferSize Size in bytes of Buffer.
@param[in] Buffer The pointer to the buffer to write.
@return A return value from gST->StdErr->OutputString.
@ -209,7 +209,7 @@ FileInterfaceStdErrWrite(
File style interface for console StdOut (Read).
@param[in] This Ignored.
@param[in,out] BufferSize Ignored.
@param[in, out] BufferSize Ignored.
@param[out] Buffer Ignored.
@retval EFI_UNSUPPORTED
@ -229,7 +229,7 @@ FileInterfaceStdOutRead(
File style interface for console StdErr (Read).
@param[in] This Ignored.
@param[in,out] BufferSize Ignored.
@param[in, out] BufferSize Ignored.
@param[out] Buffer Ignored.
@retval EFI_UNSUPPORTED Always.
@ -249,7 +249,7 @@ FileInterfaceStdErrRead(
File style interface for NUL file (Read).
@param[in] This Ignored.
@param[in,out] BufferSize Poiner to 0 upon return.
@param[in, out] BufferSize Poiner to 0 upon return.
@param[out] Buffer Ignored.
@retval EFI_SUCCESS Always.
@ -270,7 +270,7 @@ FileInterfaceNulRead(
File style interface for NUL file (Write).
@param[in] This Ignored.
@param[in,out] BufferSize Ignored.
@param[in, out] BufferSize Ignored.
@param[in] Buffer Ignored.
@retval EFI_SUCCESS
@ -975,7 +975,7 @@ FileInterfaceEnvDelete(
File style interface for Environment Variable (Read).
@param[in] This The pointer to the EFI_FILE_PROTOCOL object.
@param[in,out] BufferSize Size in bytes of Buffer.
@param[in, out] BufferSize Size in bytes of Buffer.
@param[out] Buffer The pointer to the buffer to fill.
@retval EFI_SUCCESS The data was read.
@ -998,7 +998,7 @@ FileInterfaceEnvRead(
File style interface for Volatile Environment Variable (Write).
@param[in] This The pointer to the EFI_FILE_PROTOCOL object.
@param[in,out] BufferSize Size in bytes of Buffer.
@param[in, out] BufferSize Size in bytes of Buffer.
@param[in] Buffer The pointer to the buffer to write.
@retval EFI_SUCCESS The data was read.
@ -1045,7 +1045,7 @@ FileInterfaceEnvVolWrite(
File style interface for Non Volatile Environment Variable (Write).
@param[in] This The pointer to the EFI_FILE_PROTOCOL object.
@param[in,out] BufferSize Size in bytes of Buffer.
@param[in, out] BufferSize Size in bytes of Buffer.
@param[in] Buffer The pointer to the buffer to write.
@retval EFI_SUCCESS The data was read.
@ -1144,8 +1144,8 @@ CreateFileInterfaceEnv(
Move the cursor position one character backward.
@param[in] LineLength Length of a line. Get it by calling QueryMode
@param[in,out] Column Current column of the cursor position
@param[in,out] Row Current row of the cursor position
@param[in, out] Column Current column of the cursor position
@param[in, out] Row Current row of the cursor position
**/
VOID
EFIAPI
@ -1174,8 +1174,8 @@ MoveCursorBackward (
@param[in] LineLength Length of a line.
@param[in] TotalRow Total row of a screen
@param[in,out] Column Current column of the cursor position
@param[in,out] Row Current row of the cursor position
@param[in, out] Column Current column of the cursor position
@param[in, out] Row Current row of the cursor position
**/
VOID
EFIAPI
@ -1324,7 +1324,7 @@ FileInterfaceMemGetPosition(
File style interface for Mem (Write).
@param[in] This The pointer to the EFI_FILE_PROTOCOL object.
@param[in,out] BufferSize Size in bytes of Buffer.
@param[in, out] BufferSize Size in bytes of Buffer.
@param[in] Buffer The pointer to the buffer to write.
@retval EFI_SUCCESS The data was written.
@ -1370,7 +1370,7 @@ FileInterfaceMemWrite(
File style interface for Mem (Read).
@param[in] This The pointer to the EFI_FILE_PROTOCOL object.
@param[in,out] BufferSize Size in bytes of Buffer.
@param[in, out] BufferSize Size in bytes of Buffer.
@param[in] Buffer The pointer to the buffer to fill.
@retval EFI_SUCCESS The data was read.
@ -1719,7 +1719,7 @@ FileInterfaceFileClose(
AsciiSPrint before writing.
@param[in] This The pointer to the EFI_FILE_PROTOCOL object.
@param[in,out] BufferSize Size in bytes of Buffer.
@param[in, out] BufferSize Size in bytes of Buffer.
@param[in] Buffer The pointer to the buffer to write.
@retval EFI_SUCCESS The data was written.

6
ShellPkg/Application/Shell/Shell.c
View File

@ -566,8 +566,8 @@ IsScriptOnlyCommand(
loaded image protocol installed on it. The FilePath will point to the device path
for the file that was loaded.
@param[in,out] DevPath On a sucessful return the device path to the loaded image.
@param[in,out] FilePath On a sucessful return the device path to the file.
@param[in, out] DevPath On a sucessful return the device path to the loaded image.
@param[in, out] FilePath On a sucessful return the device path to the file.
@retval EFI_SUCCESS The 2 device paths were sucessfully returned.
@retval other A error from gBS->HandleProtocol.
@ -1016,7 +1016,7 @@ AddLineToCommandHistory(
Checks if a string is an alias for another command. If yes, then it replaces the alias name
with the correct command name.
@param[in,out] CommandString Upon entry the potential alias. Upon return the
@param[in, out] CommandString Upon entry the potential alias. Upon return the
command name if it was an alias. If it was not
an alias it will be unchanged. This function may
change the buffer to fit the command name.

4
ShellPkg/Application/Shell/Shell.h
View File

@ -137,8 +137,8 @@ SetBuiltInAlias(
loaded image protocol installed on it. the FilePath will point to the device path
for the file that was loaded.
@param[in,out] DevPath on a sucessful return the device path to the loaded image
@param[in,out] FilePath on a sucessful return the device path to the file
@param[in, out] DevPath on a sucessful return the device path to the loaded image
@param[in, out] FilePath on a sucessful return the device path to the file
@retval EFI_SUCCESS the 2 device paths were sucessfully returned.
@return other a error from gBS->HandleProtocol

2
ShellPkg/Application/Shell/ShellEnvVar.c
View File

@ -123,7 +123,7 @@ FreeEnvironmentVariableList(
/**
Creates a list of all Shell-Guid-based environment variables.
@param[in,out] ListHead The pointer to pointer to LIST ENTRY object for
@param[in, out] ListHead The pointer to pointer to LIST ENTRY object for
storing this list.
@retval EFI_SUCCESS the list was created sucessfully.

2
ShellPkg/Application/Shell/ShellEnvVar.h
View File

@ -145,7 +145,7 @@ IsVolatileEnv (
/**
Creates a list of all Shell-Guid-based environment variables.
@param[in,out] List The pointer to pointer to LIST_ENTRY object for
@param[in, out] List The pointer to pointer to LIST_ENTRY object for
storing this list.
@retval EFI_SUCCESS the list was created sucessfully.

2
ShellPkg/Application/Shell/ShellManParser.c
View File

@ -427,7 +427,7 @@ ManBufferFindTitleSection(
@param[in] Command name of command's section to find
@param[out] BriefDesc pointer to pointer to string where description goes.
@param[out] BriefSize pointer to size of allocated BriefDesc
@param[in,out] Ascii TRUE if the file is ASCII, FALSE otherwise, will be
@param[in, out] Ascii TRUE if the file is ASCII, FALSE otherwise, will be
set if the file handle is at the 0 position.
@retval EFI_OUT_OF_RESOURCES a memory allocation failed.

22
ShellPkg/Application/Shell/ShellParametersProtocol.c
View File

@ -26,9 +26,9 @@
Temp Parameter must be large enough to hold the parameter before calling this
function.
@param[in,out] Walker pointer to string of command line. Adjusted to
@param[in, out] Walker pointer to string of command line. Adjusted to
reminaing command line on return
@param[in,out] TempParameter pointer to string of command line item extracted.
@param[in, out] TempParameter pointer to string of command line item extracted.
**/
VOID
@ -138,8 +138,8 @@ GetNextParameter(
delimited and quote surrounded parameter definition.
@param[in] CommandLine String of command line to parse
@param[in,out] Argv pointer to array of strings; one for each parameter
@param[in,out] Argc pointer to number of strings in Argv array
@param[in, out] Argv pointer to array of strings; one for each parameter
@param[in, out] Argc pointer to number of strings in Argv array
@return EFI_SUCCESS the operation was sucessful
@return EFI_OUT_OF_RESOURCES a memory allocation failed.
@ -215,9 +215,9 @@ ParseCommandLineToArgs(
installs it on our handle and if there is an existing version of the protocol
that one is cached for removal later.
@param[in,out] NewShellParameters on a successful return, a pointer to pointer
@param[in, out] NewShellParameters on a successful return, a pointer to pointer
to the newly installed interface.
@param[in,out] RootShellInstance on a successful return, pointer to boolean.
@param[in, out] RootShellInstance on a successful return, pointer to boolean.
TRUE if this is the root shell instance.
@retval EFI_SUCCESS the operation completed successfully.
@ -449,7 +449,7 @@ IsUnicodeFile(
All of the characters between quotes is replaced with spaces.
@param[in,out] TheString A pointer to the string to update.
@param[in, out] TheString A pointer to the string to update.
**/
VOID
EFIAPI
@ -477,7 +477,7 @@ StripQuotes (
This will also update the system table.
@param[in,out] ShellParameters Pointer to parameter structure to modify.
@param[in, out] ShellParameters Pointer to parameter structure to modify.
@param[in] NewCommandLine The new command line to parse and use.
@param[out] OldStdIn Pointer to old StdIn.
@param[out] OldStdOut Pointer to old StdOut.
@ -1049,7 +1049,7 @@ UpdateStdInStdOutStdErr(
Funcion will replace the current StdIn and StdOut in the ShellParameters protocol
structure with StdIn and StdOut. The current values are de-allocated.
@param[in,out] ShellParameters Pointer to parameter structure to modify.
@param[in, out] ShellParameters Pointer to parameter structure to modify.
@param[in] OldStdIn Pointer to old StdIn.
@param[in] OldStdOut Pointer to old StdOut.
@param[in] OldStdErr Pointer to old StdErr.
@ -1121,7 +1121,7 @@ RestoreStdInStdOutStdErr (
If OldArgv or OldArgc is NULL then that value is not returned.
@param[in,out] ShellParameters Pointer to parameter structure to modify.
@param[in, out] ShellParameters Pointer to parameter structure to modify.
@param[in] NewCommandLine The new command line to parse and use.
@param[out] OldArgv Pointer to old list of parameters.
@param[out] OldArgc Pointer to old number of items in Argv list.
@ -1155,7 +1155,7 @@ UpdateArgcArgv(
structure with Argv and Argc. The current values are de-allocated and the
OldArgv must not be deallocated by the caller.
@param[in,out] ShellParameters pointer to parameter structure to modify
@param[in, out] ShellParameters pointer to parameter structure to modify
@param[in] OldArgv pointer to old list of parameters
@param[in] OldArgc pointer to old number of items in Argv list
**/

20
ShellPkg/Application/Shell/ShellParametersProtocol.h
View File

@ -43,9 +43,9 @@
installs it on our handle and if there is an existing version of the protocol
that one is cached for removal later.
@param[in,out] NewShellParameters on a successful return, a pointer to pointer
@param[in, out] NewShellParameters on a successful return, a pointer to pointer
to the newly installed interface.
@param[in,out] RootShellInstance on a successful return, pointer to boolean.
@param[in, out] RootShellInstance on a successful return, pointer to boolean.
TRUE if this is the root shell instance.
@retval EFI_SUCCESS the operation completed successfully.
@ -84,7 +84,7 @@ CleanUpShellParametersProtocol (
structure by parsing NewCommandLine. The current values are returned to the
user.
@param[in,out] ShellParameters pointer to parameter structure to modify
@param[in, out] ShellParameters pointer to parameter structure to modify
@param[in] NewCommandLine the new command line to parse and use
@param[out] OldArgv pointer to old list of parameters
@param[out] OldArgc pointer to old number of items in Argv list
@ -106,7 +106,7 @@ UpdateArgcArgv(
structure with Argv and Argc. The current values are de-allocated and the
OldArgv must not be deallocated by the caller.
@param[in,out] ShellParameters pointer to parameter structure to modify
@param[in, out] ShellParameters pointer to parameter structure to modify
@param[in] OldArgv pointer to old list of parameters
@param[in] OldArgc pointer to old number of items in Argv list
**/
@ -134,7 +134,7 @@ typedef struct {
This will also update the system table.
@param[in,out] ShellParameters Pointer to parameter structure to modify.
@param[in, out] ShellParameters Pointer to parameter structure to modify.
@param[in] NewCommandLine The new command line to parse and use.
@param[out] OldStdIn Pointer to old StdIn.
@param[out] OldStdOut Pointer to old StdOut.
@ -159,7 +159,7 @@ UpdateStdInStdOutStdErr(
Funcion will replace the current StdIn and StdOut in the ShellParameters protocol
structure with StdIn and StdOut. The current values are de-allocated.
@param[in,out] ShellParameters Pointer to parameter structure to modify.
@param[in, out] ShellParameters Pointer to parameter structure to modify.
@param[in] OldStdIn Pointer to old StdIn.
@param[in] OldStdOut Pointer to old StdOut.
@param[in] OldStdErr Pointer to old StdErr.
@ -183,8 +183,8 @@ RestoreStdInStdOutStdErr (
delimited and quote surrounded parameter definition.
@param[in] CommandLine String of command line to parse
@param[in,out] Argv pointer to array of strings; one for each parameter
@param[in,out] Argc pointer to number of strings in Argv array
@param[in, out] Argv pointer to array of strings; one for each parameter
@param[in, out] Argc pointer to number of strings in Argv array
@return EFI_SUCCESS the operation was sucessful
@return EFI_OUT_OF_RESOURCES a memory allocation failed.
@ -207,9 +207,9 @@ ParseCommandLineToArgs(
Temp Parameter must be large enough to hold the parameter before calling this
function.
@param[in,out] Walker pointer to string of command line. Adjusted to
@param[in, out] Walker pointer to string of command line. Adjusted to
reminaing command line on return
@param[in,out] TempParameter pointer to string of command line item extracted.
@param[in, out] TempParameter pointer to string of command line item extracted.
**/
VOID

8
ShellPkg/Application/Shell/ShellProtocol.c
View File

@ -1946,7 +1946,7 @@ EfiShellFindFilesInDir(
Updates a file name to be preceeded by the mapped drive name
@param[in] BasePath the Mapped drive name to prepend
@param[in,out] Path pointer to pointer to the file name to update.
@param[in, out] Path pointer to pointer to the file name to update.
@retval EFI_SUCCESS
@retval EFI_OUT_OF_RESOURCES
@ -2004,7 +2004,7 @@ UpdateFileName(
@param[in] FilePattern The FilePattern to check against.
@param[in] UnicodeCollation The pointer to EFI_UNICODE_COLLATION_PROTOCOL structure
@param[in] FileHandle The FileHandle to start with
@param[in,out] FileList pointer to pointer to list of found files.
@param[in, out] FileList pointer to pointer to list of found files.
@param[in] ParentNode The node for the parent. Same file as identified by HANDLE.
@param[in] MapName The file system name this file is on.
@ -3124,7 +3124,7 @@ EFI_SHELL_PROTOCOL mShellProtocol = {
This must be removed via calling CleanUpShellProtocol().
@param[in,out] NewShell The pointer to the pointer to the structure
@param[in, out] NewShell The pointer to the pointer to the structure
to install.
@retval EFI_SUCCESS The operation was successful.
@ -3253,7 +3253,7 @@ CreatePopulateInstallShellProtocol (
Free all memory and restore the system to the state it was in before calling
CreatePopulateInstallShellProtocol.
@param[in,out] NewShell The pointer to the new shell protocol structure.
@param[in, out] NewShell The pointer to the new shell protocol structure.
@retval EFI_SUCCESS The operation was successful.
**/

4
ShellPkg/Application/Shell/ShellProtocol.h
View File

@ -68,7 +68,7 @@ typedef struct {
This must be removed via calling CleanUpShellProtocol().
@param[in,out] NewShell The pointer to the pointer to the structure
@param[in, out] NewShell The pointer to the pointer to the structure
to install.
@retval EFI_SUCCESS The operation was successful.
@ -86,7 +86,7 @@ CreatePopulateInstallShellProtocol (
Free all memory and restore the system to the state it was in before calling
CreatePopulateInstallShellProtocol.
@param[in,out] NewShell The pointer to the new shell protocol structure.
@param[in, out] NewShell The pointer to the new shell protocol structure.
@retval EFI_SUCCESS The operation was successful.
**/

4
ShellPkg/Application/ShellSortTestApp/ShellSortTestApp.c
View File

@ -38,8 +38,8 @@ Test(CONST VOID*b1, CONST VOID*b2)
The ShellCEntryLib library instance wrappers the actual UEFI application
entry point and calls this ShellAppMain function.
@param ImageHandle The image handle of the UEFI Application.
@param SystemTable A pointer to the EFI System Table.
@param Argc Argument count
@param Argv The parsed arguments
@retval 0 The application exited normally.
@retval Other An error occurred.

12
ShellPkg/Include/Library/FileHandleLib.h
View File

@ -83,7 +83,7 @@ FileHandleSetInfo (
EFI_FILE_INFO is the structure returned as the directory entry.
@param[in] FileHandle The opened file handle.
@param[in,out] BufferSize On input, the size of buffer in bytes. On return,
@param[in, out] BufferSize On input, the size of buffer in bytes. On return,
the number of bytes written.
@param[out] Buffer The buffer to put read data into.
@ -114,7 +114,7 @@ FileHandleRead(
opened directories are not supported.
@param[in] FileHandle The opened file for writing.
@param[in,out] BufferSize On input, the number of bytes in Buffer. On output,
@param[in, out] BufferSize On input, the number of bytes in Buffer. On output,
the number of bytes written.
@param[in] Buffer The buffer containing data to write is stored.
@ -380,15 +380,15 @@ FileHandleGetFileName (
maintained and not changed for all operations with the same file.
@param[in] Handle FileHandle to read from.
@param[in,out] Buffer The pointer to buffer to read into.
@param[in,out] Size The pointer to number of bytes in Buffer.
@param[in, out] Buffer The pointer to buffer to read into.
@param[in, out] Size The pointer to number of bytes in Buffer.
@param[in] Truncate If the buffer is large enough, this has no effect.
If the buffer is is too small and Truncate is TRUE,
the line will be truncated.
If the buffer is is too small and Truncate is FALSE,
then no read will occur.
@param[in,out] Ascii Boolean value for indicating whether the file is
@param[in, out] Ascii Boolean value for indicating whether the file is
Ascii (TRUE) or UCS2 (FALSE).
@retval EFI_SUCCESS The operation was successful. The line is stored in
@ -417,7 +417,7 @@ FileHandleReadLine(
maintained and not changed for all operations with the same file.
@param[in] Handle FileHandle to read from.
@param[in,out] Ascii Boolean value for indicating whether the file is
@param[in, out] Ascii Boolean value for indicating whether the file is
Ascii (TRUE) or UCS2 (FALSE).
@return The line of text from the file.

2
ShellPkg/Include/Library/PathLib.h
View File

@ -21,7 +21,7 @@
Removes the last directory or file entry in a path by changing the last
L'\' to a CHAR_NULL.
@param[in,out] Path The pointer to the path to modify.
@param[in, out] Path The pointer to the path to modify.
@retval FALSE Nothing was found to remove.
@retval TRUE A directory or file was removed.

4
ShellPkg/Include/Library/ShellCommandLib.h
View File

@ -161,9 +161,9 @@ ShellCommandRegisterCommandName (
@param[in] CommandString The pointer to the command name. This is the name
found on the command line in the shell.
@param[in,out] RetVal The pointer to the return value from the command handler.
@param[in, out] RetVal The pointer to the return value from the command handler.
@param[in,out] CanAffectLE Indicates whether this command's return value
@param[in, out] CanAffectLE Indicates whether this command's return value
needs to be placed into LASTERROR environment variable.
@retval RETURN_SUCCESS The handler was run.

30
ShellPkg/Include/Library/ShellLib.h
View File

@ -82,7 +82,7 @@ ShellSetFileInfo (
This function opens a file with the open mode according to the file path. The
Attributes is valid only for EFI_FILE_MODE_CREATE.
@param[in,out] FilePath On input, the device path to the file. On output,
@param[in, out] FilePath On input, the device path to the file. On output,
the remaining device path.
@param[out] DeviceHandle Pointer to the system device handle.
@param[out] FileHandle Pointer to the file handle.
@ -205,7 +205,7 @@ ShellCreateDirectory(
EFI_FILE_INFO is the structure returned as the directory entry.
@param[in] FileHandle The opened file handle.
@param[in,out] ReadSize On input the size of buffer in bytes. On return
@param[in, out] ReadSize On input the size of buffer in bytes. On return
the number of bytes written.
@param[out] Buffer The buffer to put read data into.
@ -237,7 +237,7 @@ ShellReadFile(
@param[in] FileHandle The opened file for writing.
@param[in,out] BufferSize On input the number of bytes in Buffer. On output
@param[in, out] BufferSize On input the number of bytes in Buffer. On output
the number of bytes written.
@param[in] Buffer The buffer containing data to write is stored.
@ -403,8 +403,8 @@ ShellFindFirstFile (
data in Buffer is meaningless.
@param[in] DirHandle The file handle of the directory.
@param[in,out] Buffer The pointer to buffer for file's information.
@param[in,out] NoFile The pointer to boolean when last file is found.
@param[in, out] Buffer The pointer to buffer for file's information.
@param[in, out] NoFile The pointer to boolean when last file is found.
@retval EFI_SUCCESS Found the next file.
@retval EFI_NO_MEDIA The device has no media.
@ -585,7 +585,7 @@ ShellSetPageBreakMode (
@param[in] Arg The pointer to path string.
@param[in] OpenMode Mode to open files with.
@param[in,out] ListHead Head of linked list of results.
@param[in, out] ListHead Head of linked list of results.
@retval EFI_SUCCESS The operation was sucessful and the list head
contains the list of opened files.
@ -604,7 +604,7 @@ ShellOpenFileMetaArg (
/**
Free the linked list returned from ShellOpenFileMetaArg.
@param[in,out] ListHead The pointer to free.
@param[in, out] ListHead The pointer to free.
@retval EFI_SUCCESS The operation was sucessful.
@retval EFI_INVALID_PARAMETER A parameter was invalid.
@ -1024,8 +1024,8 @@ ShellStrToUintn(
If Destination's current length (including NULL terminator) is already more than
CurrentSize, then ASSERT().
@param[in,out] Destination The String to append onto.
@param[in,out] CurrentSize On call, the number of bytes in Destination. On
@param[in, out] Destination The String to append onto.
@param[in, out] CurrentSize On call, the number of bytes in Destination. On
return, possibly the new size (still in bytes). If NULL,
then allocate whatever is needed.
@param[in] Source The String to append from.
@ -1052,7 +1052,7 @@ StrnCatGrow (
If the string would grow bigger than NewSize it will halt and return error.
@param[in] SourceString The string with source buffer.
@param[in,out] NewString The string with resultant buffer.
@param[in, out] NewString The string with resultant buffer.
@param[in] NewSize The size in bytes of NewString.
@param[in] FindTarget The string to look for.
@param[in] ReplaceWith The string to replace FindTarget with.
@ -1191,7 +1191,7 @@ ShellPromptForResponse (
to prevent invalid answers to question.
@param[in] HiiFormatStringId The format string Id for getting from Hii.
@param[in] HiiFormatHandle The format string Handle for getting from Hii.
@param[in,out] Response The pointer to Response, which will be populated upon return.
@param[in, out] Response The pointer to Response, which will be populated upon return.
@retval EFI_SUCCESS The operation was sucessful.
@return other The operation failed.
@ -1274,7 +1274,7 @@ ShellFileExists(
maintained and not changed for all operations with the same file.
@param[in] Handle SHELL_FILE_HANDLE to read from.
@param[in,out] Ascii Boolean value for indicating whether the file is
@param[in, out] Ascii Boolean value for indicating whether the file is
Ascii (TRUE) or UCS2 (FALSE).
@return The line of text from the file.
@ -1295,15 +1295,15 @@ ShellFileHandleReturnLine(
maintained and not changed for all operations with the same file.
@param[in] Handle SHELL_FILE_HANDLE to read from.
@param[in,out] Buffer The pointer to buffer to read into.
@param[in,out] Size The pointer to number of bytes in Buffer.
@param[in, out] Buffer The pointer to buffer to read into.
@param[in, out] Size The pointer to number of bytes in Buffer.
@param[in] Truncate If the buffer is large enough, this has no effect.
If the buffer is is too small and Truncate is TRUE,
the line will be truncated.
If the buffer is is too small and Truncate is FALSE,
then no read will occur.
@param[in,out] Ascii Boolean value for indicating whether the file is
@param[in, out] Ascii Boolean value for indicating whether the file is
Ascii (TRUE) or UCS2 (FALSE).
@retval EFI_SUCCESS The operation was successful. The line is stored in

2
ShellPkg/Include/Library/SortLib.h
View File

@ -43,7 +43,7 @@ INTN
If Count is < 2 , then perform no action.
If Size is < 1 , then perform no action.
@param[in,out] BufferToSort On call, a Buffer of (possibly sorted) elements;
@param[in, out] BufferToSort On call, a Buffer of (possibly sorted) elements;
on return, a buffer of sorted elements.
@param[in] Count The number of elements in the buffer to sort.
@param[in] ElementSize The size of an element in bytes.

8
ShellPkg/Include/Protocol/EfiShell.h
View File

@ -531,7 +531,7 @@ EFI_STATUS
If there are multiple map names they will be semi-colon seperated in the
NULL-terminated string.
@param[in,out] DevicePath On entry, points to a device path pointer. On
@param[in, out] DevicePath On entry, points to a device path pointer. On
exit, updates the pointer to point to the
portion of the device path after the mapping.
@ -643,7 +643,7 @@ EFI_STATUS
@param[in] Path A pointer to the path string.
@param[in] OpenMode Specifies the mode used to open each file, EFI_FILE_MODE_READ or
EFI_FILE_MODE_WRITE.
@param[in,out] FileList Points to the start of a list of files opened.
@param[in, out] FileList Points to the start of a list of files opened.
@retval EFI_SUCCESS Create the file list successfully.
@return Can't create the file list.
@ -712,7 +712,7 @@ EFI_STATUS
@param[in] FileHandle The opened file handle for read.
@param[in] ReadSize On input, the size of Buffer, in bytes. On output, the amount of data read.
@param[in,out] Buffer The buffer in which data is read.
@param[in, out] Buffer The buffer in which data is read.
@retval EFI_SUCCESS Data was read.
@retval EFI_NO_MEDIA The device has no media.
@ -930,7 +930,7 @@ EFI_STATUS
Direct writes to opened directories are not supported.
@param[in] FileHandle The opened file handle for writing.
@param[in,out] BufferSize On input, size of Buffer.
@param[in, out] BufferSize On input, size of Buffer.
@param[in] Buffer The buffer in which data to write.
@retval EFI_SUCCESS Data was written.

18
ShellPkg/Include/Protocol/EfiShellEnvironment2.h
View File

@ -61,7 +61,7 @@ EFI_STATUS
This is used when programatically adding shell commands. Upon successful return
the memory allocated is up to the caller to free.
@param[in,out] Str Pointer to pointer to string to display for help.
@param[in, out] Str Pointer to pointer to string to display for help.
@retval EFI_SUCCESS The help string is in the parameter Str.
@ -271,7 +271,7 @@ CHAR16*
SHELLENV_FREE_FILE_LIST.
@param[in] Arg The pointer Path to files to open.
@param[in,out] ListHead The pointer to the allocated and initialized list head
@param[in, out] ListHead The pointer to the allocated and initialized list head
upon which to append all opened file structures.
@retval EFI_SUCCESS One or more files was opened and a struct of each file's
@ -289,7 +289,7 @@ EFI_STATUS
/**
This frees all of the nodes under the ListHead, but not ListHead itself.
@param[in,out] ListHead Pointer to list to free all nodes of.
@param[in, out] ListHead Pointer to list to free all nodes of.
@retval EFI_SUCCESS This function always returns EFI_SUCCESS.
**/
@ -474,10 +474,10 @@ BOOLEAN
original set of console protocols.
@param[in] ConInHandle The handle of ConIn.
@param[in,out] ConIn The pointer to the location to return the pointer to
@param[in, out] ConIn The pointer to the location to return the pointer to
the original console input.
@param[in] ConOutHandle The handle of ConOut
@param[in,out] ConOut The pointer to the location to return the pointer to
@param[in, out] ConOut The pointer to the location to return the pointer to
the original console output.
**/
typedef
@ -512,7 +512,7 @@ VOID
This must be called after INIT_HANDLE_ENUMERATOR and before CLOSE_HANDLE_ENUMERATOR.
@param[in,out] Handle The pointer to pointer to Handle. It is set
@param[in, out] Handle The pointer to pointer to Handle. It is set
on a sucessful return.
@retval EFI_SUCCESS The next handle in the handle database is *Handle.
@ -656,7 +656,7 @@ VOID
This cannot be called after CLOSE_PROTOCOL_INFO_ENUMERATOR, but it must be
called after INIT_PROTOCOL_INFO_ENUMERATOR.
@param[in,out] ProtocolInfo The pointer to pointer to protocol information structure.
@param[in, out] ProtocolInfo The pointer to pointer to protocol information structure.
@retval EFI_SUCCESS The next protocol's information was sucessfully returned.
@retval NULL There are no more protocols.
@ -748,7 +748,7 @@ typedef struct {
@param[in] UseComponentName Whether to use the ComponentName protocol at all.
@param[in] UseDevicePath Whether to use the DevicePath protocol at all.
@param[in] Language The pointer to the language string to use.
@param[in,out] BestDeviceName The pointer to pointer to string allocated with the name.
@param[in, out] BestDeviceName The pointer to pointer to string allocated with the name.
@param[out] ConfigurationStatus The pointer to status for opening a Configuration protocol.
@param[out] DiagnosticsStatus The pointer to status for opening a Diagnostics protocol.
@param[in] Display Whether to Print this out to default Print location.
@ -850,7 +850,7 @@ EFI_STATUS
SHELLENV_FREE_FILE_LIST.
@param[in] Arg The pointer to the path of the files to be opened.
@param[in,out] ListHead The pointer to allocated and initialized list head
@param[in, out] ListHead The pointer to allocated and initialized list head
upon which to append all the opened file structures.
@retval EFI_SUCCESS One or more files was opened and a struct of each file's

2
ShellPkg/Library/BasePathLib/BasePathLib.c
View File

@ -20,7 +20,7 @@
Removes the last directory or file entry in a path by changing the last
L'\' to a CHAR_NULL.
@param[in,out] Path The pointer to the path to modify.
@param[in, out] Path The pointer to the path to modify.
@retval FALSE Nothing was found to remove.
@retval TRUE A directory or file was removed.

4
ShellPkg/Library/BaseSortLib/BaseSortLib.c
View File

@ -34,7 +34,7 @@
if Count is < 2 then perform no action.
if Size is < 1 then perform no action.
@param[in,out] BufferToSort on call a Buffer of (possibly sorted) elements
@param[in, out] BufferToSort on call a Buffer of (possibly sorted) elements
on return a buffer of sorted elements
@param[in] Count the number of elements in the buffer to sort
@param[in] ElementSize Size of an element in bytes
@ -139,7 +139,7 @@ QuickSortWorker (
if Count is < 2 then perform no action.
if Size is < 1 then perform no action.
@param[in,out] BufferToSort on call a Buffer of (possibly sorted) elements
@param[in, out] BufferToSort on call a Buffer of (possibly sorted) elements
on return a buffer of sorted elements
@param[in] Count the number of elements in the buffer to sort
@param[in] ElementSize Size of an element in bytes

12
ShellPkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
View File

@ -698,8 +698,8 @@ FileHandleSetSize (
if Destination's current length (including NULL terminator) is already more then
CurrentSize, then ASSERT()
@param[in,out] Destination The String to append onto
@param[in,out] CurrentSize on call the number of bytes in Destination. On
@param[in, out] Destination The String to append onto
@param[in, out] CurrentSize on call the number of bytes in Destination. On
return possibly the new size (still in bytes). if NULL
then allocate whatever is needed.
@param[in] Source The String to append from
@ -880,7 +880,7 @@ FileHandleGetFileName (
maintained and not changed for all operations with the same file.
@param[in] Handle FileHandle to read from.
@param[in,out] Ascii Boolean value for indicating whether the file is Ascii (TRUE) or UCS2 (FALSE);
@param[in, out] Ascii Boolean value for indicating whether the file is Ascii (TRUE) or UCS2 (FALSE);
@return The line of text from the file.
@ -920,12 +920,12 @@ FileHandleReturnLine(
maintained and not changed for all operations with the same file.
@param[in] Handle FileHandle to read from
@param[in,out] Buffer pointer to buffer to read into
@param[in,out] Size pointer to number of bytes in buffer
@param[in, out] Buffer pointer to buffer to read into
@param[in, out] Size pointer to number of bytes in buffer
@param[in] Truncate if TRUE then allows for truncation of the line to fit.
if FALSE will reset the position to the begining of the
line if the buffer is not large enough.
@param[in,out] Ascii Boolean value for indicating whether the file is Ascii (TRUE) or UCS2 (FALSE);
@param[in, out] Ascii Boolean value for indicating whether the file is Ascii (TRUE) or UCS2 (FALSE);
@retval EFI_SUCCESS the operation was sucessful. the line is stored in
Buffer.

4
ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.c
View File

@ -1179,8 +1179,8 @@ ParseHandleDatabaseForChildControllers(
If DestinationBuffer is NULL, then ASSERT().
@param[in,out] DestinationBuffer The pointer to the pointer to the buffer to append onto.
@param[in,out] DestinationSize The pointer to the size of DestinationBuffer.
@param[in, out] DestinationBuffer The pointer to the pointer to the buffer to append onto.
@param[in, out] DestinationSize The pointer to the size of DestinationBuffer.
@param[in] SourceBuffer The pointer to the buffer to append onto DestinationBuffer.
@param[in] SourceSize The number of bytes of SourceBuffer to append.

8
ShellPkg/Library/UefiShellCommandLib/ConsistMapping.c
View File

@ -131,7 +131,7 @@ MTD_NAME mMTDName[] = {
/**
Function to append a 64 bit number / 25 onto the string.
@param[in,out] Str The string so append onto.
@param[in, out] Str The string so append onto.
@param[in] Num The number to divide and append.
@retval EFI_INVALID_PARAMETER A parameter was NULL.
@ -163,7 +163,7 @@ AppendCSDNum2 (
/**
Function to append a 64 bit number onto the mapping info.
@param[in,out] MappingItem The mapping info object to append onto.
@param[in, out] MappingItem The mapping info object to append onto.
@param[in] Num The info to append.
@retval EFI_INVALID_PARAMETER A parameter was NULL.
@ -194,7 +194,7 @@ AppendCSDNum (
/**
Function to append string into the mapping info.
@param[in,out] MappingItem The mapping info object to append onto.
@param[in, out] MappingItem The mapping info object to append onto.
@param[in] Str The info to append.
@retval EFI_INVALID_PARAMETER A parameter was NULL.
@ -281,7 +281,7 @@ AppendCSDStr (
/**
Function to append a Guid to the mapping item.
@param[in,out] MappingItem The item to append onto.
@param[in, out] MappingItem The item to append onto.
@param[in] Guid The guid to append.
@retval EFI_SUCCESS The appending operation was successful.

4
ShellPkg/Library/UefiShellCommandLib/UefiShellCommandLib.c
View File

@ -426,9 +426,9 @@ ShellCommandGetProfileList (
@param[in] CommandString Pointer to the command name. This is the name
found on the command line in the shell.
@param[in,out] RetVal Pointer to the return vaule from the command handler.
@param[in, out] RetVal Pointer to the return vaule from the command handler.
@param[in,out] CanAffectLE indicates whether this command's return value
@param[in, out] CanAffectLE indicates whether this command's return value
needs to be placed into LASTERROR environment variable.
@retval RETURN_SUCCESS The handler was run.

3
ShellPkg/Library/UefiShellDebug1CommandsLib/Bcfg.c
View File

@ -50,7 +50,8 @@ typedef struct {
/**
This function will populate the device path protocol parameter based on TheHandle.
@param[in,out] DevPath On a sucessful return the device path to the handle.
@param[in] TheHandle Driver handle.
@param[in, out] FilePath On a sucessful return the device path to the handle.
@retval EFI_SUCCESS The device path was sucessfully returned.
@retval other A error from gBS->HandleProtocol.

2
ShellPkg/Library/UefiShellDebug1CommandsLib/Compress.c
View File

@ -1327,7 +1327,7 @@ Encode (
@param[in] SrcBuffer The buffer containing the source data.
@param[in] SrcSize The number of bytes in SrcBuffer.
@param[in] DstBuffer The buffer to put the compressed image in.
@param[in,out] DstSize On input the size (in bytes) of DstBuffer, on
@param[in, out] DstSize On input the size (in bytes) of DstBuffer, on
return the number of bytes placed in DstBuffer.
@retval EFI_SUCCESS The compression was sucessful.

2
ShellPkg/Library/UefiShellDebug1CommandsLib/Compress.h
View File

@ -21,7 +21,7 @@
@param[in] SrcBuffer The buffer containing the source data.
@param[in] SrcSize Number of bytes in SrcBuffer.
@param[in] DstBuffer The buffer to put the compressed image in.
@param[in,out] DstSize On input the size (in bytes) of DstBuffer, on
@param[in, out] DstSize On input the size (in bytes) of DstBuffer, on
return the number of bytes placed in DstBuffer.
@retval EFI_SUCCESS The compression was sucessful.

8
ShellPkg/Library/UefiShellDebug1CommandsLib/Edit/FileBuffer.c
View File

@ -1685,7 +1685,7 @@ FileBufferScrollLeft (
/**
Delete a char in line
@param[in,out] Line The line to delete in.
@param[in, out] Line The line to delete in.
@param[in] Pos Position to delete the char at ( start from 0 ).
**/
VOID
@ -1710,7 +1710,7 @@ LineDeleteAt (
/**
Concatenate Src into Dest.
@param[in,out] Dest Destination string
@param[in, out] Dest Destination string
@param[in] Src Src String.
**/
VOID
@ -2981,7 +2981,7 @@ FileBufferSearch (
//
// found
//
if (Found == TRUE) {
if (Found) {
Column = (Position - 1) + FileBuffer.FilePosition.Column + Offset;
Row = FileBuffer.FilePosition.Row;
} else {
@ -3000,7 +3000,7 @@ FileBufferSearch (
Found = TRUE;
}
if (Found == TRUE) {
if (Found) {
//
// found
//

3
ShellPkg/Library/UefiShellDebug1CommandsLib/HexEdit/MainHexEditor.c
View File

@ -106,10 +106,11 @@ HMainCommandDisplayHelp (
VOID
)
{
INT32 CurrentLine=0;
INT32 CurrentLine;
CHAR16 * InfoString;
EFI_INPUT_KEY Key;
CurrentLine = 0;
// print helpInfo
for (CurrentLine = 0; 0 != HexMainMenuHelpInfo[CurrentLine]; CurrentLine++) {
InfoString = HiiGetString(gShellDebug1HiiHandle, HexMainMenuHelpInfo[CurrentLine]

4
ShellPkg/Library/UefiShellDebug1CommandsLib/HexEdit/MemImage.c
View File

@ -45,7 +45,7 @@ HEFI_EDITOR_MEM_IMAGE HMemImageConst = {
@param[in] Width Ignored.
@param[in] Address Ignored.
@param[in] Count Ignored.
@param[in,out] Buffer Ignored.
@param[in, out] Buffer Ignored.
@retval EFI_UNSUPPORTED.
**/
@ -69,7 +69,7 @@ DummyMemRead (
@param[in] Width Ignored.
@param[in] Address Ignored.
@param[in] Count Ignored.
@param[in,out] Buffer Ignored.
@param[in, out] Buffer Ignored.
@retval EFI_UNSUPPORTED.
**/

14
ShellPkg/Library/UefiShellDebug1CommandsLib/Pci.c
View File

@ -1268,7 +1268,7 @@ PCI_CLASS_ENTRY PCIPIFClass_0e00[] = {
bits 23:16 - Base Class Code
bits 15:8 - Sub-Class Code
bits 7:0 - Programming Interface
@param[in,out] ClassStrings Pointer of PCI_CLASS_STRINGS structure, which contains
@param[in, out] ClassStrings Pointer of PCI_CLASS_STRINGS structure, which contains
printable class strings corresponding to ClassCode. The
caller must not modify the strings that are pointed by
the fields in ClassStrings.
@ -1474,10 +1474,10 @@ PciGetProtocolAndResource (
It also moves the pointer backward a node, to get prepared to be called
again.
@param[in,out] Descriptors Points to current position of a serial of address space
@param[in, out] Descriptors Points to current position of a serial of address space
descriptors.
@param[out] MinBus The lower range of bus number.
@param[out] ManBus The upper range of bus number.
@param[out] MaxBus The upper range of bus number.
@param[out] IsEnd Meet end of the serial of descriptors.
@retval EFI_SUCCESS The command completed successfully.
@ -1547,7 +1547,7 @@ PciExplainBridgeData (
@param[in] Command Points to the register Command.
@param[in] Address Address used to access configuration space of this PCI device.
@param[in] IoDev Handle used to access configuration space of PCI device.
@param[in,out] Index The Index.
@param[in, out] Index The Index.
@retval EFI_SUCCESS The command completed successfully.
**/
@ -2564,10 +2564,10 @@ PciGetProtocolAndResource (
It also moves the pointer backward a node, to get prepared to be called
again.
@param[in,out] Descriptors Points to current position of a serial of address space
@param[in, out] Descriptors Points to current position of a serial of address space
descriptors.
@param[out] MinBus The lower range of bus number.
@param[out] ManBus The upper range of bus number.
@param[out] MaxBus The upper range of bus number.
@param[out] IsEnd Meet end of the serial of descriptors.
@retval EFI_SUCCESS The command completed successfully.
@ -3152,7 +3152,7 @@ PciExplainBridgeData (
@param[in] Command Points to the register Command.
@param[in] Address Address used to access configuration space of this PCI device.
@param[in] IoDev Handle used to access configuration space of PCI device.
@param[in,out] Index The Index.
@param[in, out] Index The Index.
@retval EFI_SUCCESS The command completed successfully.
**/

4
ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/LibSmbiosView.c
View File

@ -104,9 +104,9 @@ LibSmbiosGetEPS (
Handle is changed to the next handle or 0xFFFF when the end is
reached or the handle is not found.
@param[in,out] Handle 0xFFFF: get the first structure
@param[in, out] Handle 0xFFFF: get the first structure
Others: get a structure according to this value.
@param[in,out] Buffer The pointer to the caller's memory buffer.
@param[in, out] Buffer The pointer to the caller's memory buffer.
@param[out] Length Length of return buffer in bytes.
@retval DMI_SUCCESS Buffer contains the required structure data

4
ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/LibSmbiosView.h
View File

@ -72,9 +72,9 @@ LibSmbiosGetEPS (
Handle is changed to the next handle or 0xFFFF when the end is
reached or the handle is not found.
@param[in,out] Handle 0xFFFF: get the first structure
@param[in, out] Handle 0xFFFF: get the first structure
Others: get a structure according to this value.
@param[in,out] Buffer The pointer to the caller's memory buffer.
@param[in, out] Buffer The pointer to the caller's memory buffer.
@param[out] Length Length of return buffer in bytes.
@retval DMI_SUCCESS Buffer contains the required structure data

2
ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/PrintInfo.c
View File

@ -82,7 +82,7 @@
Copy Length of Src buffer to Dest buffer,
add a NULL termination to Dest buffer.
@param[in,out] Dest Destination buffer head.
@param[in, out] Dest Destination buffer head.
@param[in] Src Source buffer head.
@param[in] Length Length of buffer to be copied.
**/

2
ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/QueryTable.c
View File

@ -2939,7 +2939,7 @@ TABLE_ITEM StructureTypeInfoTable[] = {
@param[in] Table The begin address of table.
@param[in] Number The number of table items.
@param[in] Key The query Key.
@param[in,out] Info Input as empty buffer; output as data buffer.
@param[in, out] Info Input as empty buffer; output as data buffer.
@param[in] InfoLen The max number of characters for Info.
@return the found Key and Info is valid.

2
ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/QueryTable.h
View File

@ -55,7 +55,7 @@ typedef struct TABLE_ITEM {
@param[in] Table The begin address of table.
@param[in] Number The number of table items.
@param[in] Key The query Key.
@param[in,out] Info Input as empty buffer; output as data buffer.
@param[in, out] Info Input as empty buffer; output as data buffer.
@param[in] InfoLen The max number of characters for Info.
@return the found Key and Info is valid.

4
ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.c
View File

@ -227,7 +227,7 @@ CharToUpper (
EFI System Table based on the provided GUID.
@param[in] TableGuid A pointer to the table's GUID type.
@param[in,out] Table On exit, a pointer to a system configuration table.
@param[in, out] Table On exit, a pointer to a system configuration table.
@retval EFI_SUCCESS A configuration table matching TableGuid was found.
@retval EFI_NOT_FOUND A configuration table matching TableGuid was not found.
@ -282,7 +282,7 @@ HexCharToUintn (
Convert a string representation of a guid to a Guid value.
@param[in] StringGuid The pointer to the string of a guid.
@param[in,out] Guid The pointer to the GUID structure to populate.
@param[in, out] Guid The pointer to the GUID structure to populate.
@retval EFI_INVALID_PARAMETER A parameter was invalid.
@retval EFI_SUCCESS The conversion was successful.

4
ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.h
View File

@ -83,7 +83,7 @@ DumpHex (
EFI System Table based on the provided GUID.
@param[in] TableGuid A pointer to the table's GUID type.
@param[in,out] Table On exit, a pointer to a system configuration table.
@param[in, out] Table On exit, a pointer to a system configuration table.
@retval EFI_SUCCESS A configuration table matching TableGuid was found.
@retval EFI_NOT_FOUND A configuration table matching TableGuid was not found.
@ -99,7 +99,7 @@ GetSystemConfigurationTable (
Convert a string representation of a GUID to the GUID value.
@param[in] StringGuid The pointer to the string containing a GUID printed.
@param[in,out] Guid The pointer to the buffer to get the GUID value.
@param[in, out] Guid The pointer to the buffer to get the GUID value.
**/
EFI_STATUS
EFIAPI

12
ShellPkg/Library/UefiShellDriver1CommandsLib/Devices.c
View File

@ -18,19 +18,19 @@
Get lots of info about a device from its handle.
@param[in] TheHandle The device handle to get info on.
@param[in,out] Type On successful return R, B, or D (root, bus, or
@param[in, out] Type On successful return R, B, or D (root, bus, or
device) will be placed in this buffer.
@param[in,out] Cfg On successful return this buffer will be
@param[in, out] Cfg On successful return this buffer will be
TRUE if the handle has configuration, FALSE
otherwise.
@param[in,out] Diag On successful return this buffer will be
@param[in, out] Diag On successful return this buffer will be
TRUE if the handle has disgnostics, FALSE
otherwise.
@param[in,out] Parents On successful return this buffer will be
@param[in, out] Parents On successful return this buffer will be
contain the number of parent handles.
@param[in,out] Devices On successful return this buffer will be
@param[in, out] Devices On successful return this buffer will be
contain the number of devices controlled.
@param[in,out] Children On successful return this buffer will be
@param[in, out] Children On successful return this buffer will be
contain the number of child handles.
@param[out] Name The pointer to a buffer that will be allocated
and contain the string name of the handle.

3
ShellPkg/Library/UefiShellInstall1CommandsLib/Bcfg.c
View File

@ -50,7 +50,8 @@ typedef struct {
/**
This function will populate the device path protocol parameter based on TheHandle.
@param[in,out] DevPath On a sucessful return the device path to the handle.
@param[in] TheHandle Driver handle.
@param[in, out] FilePath On a sucessful return the device path to the handle.
@retval EFI_SUCCESS The device path was sucessfully returned.
@retval other A error from gBS->HandleProtocol.

4
ShellPkg/Library/UefiShellLevel1CommandsLib/For.c
View File

@ -122,7 +122,7 @@ typedef struct {
@param[in] Alias The alias to test for.
@param[in] CommandString The updated command string.
@param[in,out] List The list to search.
@param[in, out] List The list to search.
@retval EFI_SUCCESS The operation was completed successfully.
@retval EFI_OUT_OF_RESOURCES There was not enough free memory.
@ -217,7 +217,7 @@ InternalIsAliasOnList(
Remove an alias from the given list.
@param[in] Alias The alias to remove.
@param[in,out] List The list to search.
@param[in, out] List The list to search.
**/
BOOLEAN
EFIAPI

4
ShellPkg/Library/UefiShellLevel1CommandsLib/If.c
View File

@ -40,7 +40,7 @@ typedef enum {
/**
Extract the next fragment, if there is one.
@param[in,out] Statement The current remaining statement.
@param[in, out] Statement The current remaining statement.
@param[in] Fragment The current fragment.
@retval FALSE There is not another fragment.
@ -338,7 +338,7 @@ TestOperation (
/**
Process an if statement and determine if its is valid or not.
@param[in,out] PassingState Opon entry, the current state. Upon exit,
@param[in, out] PassingState Opon entry, the current state. Upon exit,
the new state.
@param[in] StartParameterNumber The number of the first parameter of
this statement.

6
ShellPkg/Library/UefiShellLevel1CommandsLib/UefiShellLevel1CommandsLib.c
View File

@ -117,12 +117,12 @@ ShellLevel1CommandsLibDestructor (
@param[in] DecrementerTag The tag to decrement the count at.
@param[in] IncrementerTag The tag to increment the count at.
@param[in] Label A label to look for.
@param[in,out] ScriptFile The pointer to the current script file structure.
@param[in, out] ScriptFile The pointer to the current script file structure.
@param[in] MovePast TRUE makes function return 1 past the found
location.
@param[in] FindOnly TRUE to not change the ScriptFile.
@param[in] CommandNode The pointer to the Node to test.
@param[in,out] TargetCount The pointer to the current count.
@param[in, out] TargetCount The pointer to the current count.
**/
BOOLEAN
EFIAPI
@ -234,7 +234,7 @@ TestNodeForMove (
@param[in] DecrementerTag The tag to decrement the count at.
@param[in] IncrementerTag The tag to increment the count at.
@param[in] Label A label to look for.
@param[in,out] ScriptFile The pointer to the current script file structure.
@param[in, out] ScriptFile The pointer to the current script file structure.
@param[in] MovePast TRUE makes function return 1 past the found
location.
@param[in] FindOnly TRUE to not change the ScriptFile.

2
ShellPkg/Library/UefiShellLevel1CommandsLib/UefiShellLevel1CommandsLib.h
View File

@ -187,7 +187,7 @@ LIST_ENTRY *
@param[in] DecrementerTag The tag to decrement the count at.
@param[in] IncrementerTag The tag to increment the count at.
@param[in] Label A label to look for.
@param[in,out] ScriptFile The pointer to the current script file structure.
@param[in, out] ScriptFile The pointer to the current script file structure.
@param[in] MovePast TRUE makes function return 1 past the found
location.
@param[in] FindOnly TRUE to not change the ScriptFile.

2
ShellPkg/Library/UefiShellLevel2CommandsLib/Mv.c
View File

@ -117,7 +117,7 @@ IsValidMove(
if the result is sucessful the caller must free *DestPathPointer.
@param[in] DestDir The original path to the destination.
@param[in,out] DestPathPointer A pointer to the callee allocated final path.
@param[in, out] DestPathPointer A pointer to the callee allocated final path.
@param[in] Cwd A pointer to the current working directory.
@retval EFI_INVALID_PARAMETR The DestDir could not be resolved to a location.

16
ShellPkg/Library/UefiShellLib/UefiShellLib.c
View File

@ -1314,7 +1314,7 @@ typedef struct {
the ShellCloseFileMetaArg function.
@param[in] FileList the EFI shell list type
@param[in,out] ListHead the list to add to
@param[in, out] ListHead the list to add to
@retval the resultant head of the double linked new format list;
**/
@ -2454,7 +2454,7 @@ ShellCommandLineCheckDuplicate (
If the string would grow bigger than NewSize it will halt and return error.
@param[in] SourceString The string with source buffer.
@param[in,out] NewString The string with resultant buffer.
@param[in, out] NewString The string with resultant buffer.
@param[in] NewSize The size in bytes of NewString.
@param[in] FindTarget The string to look for.
@param[in] ReplaceWith The string to replace FindTarget with.
@ -3020,8 +3020,8 @@ ShellStrToUintn(
if Destination's current length (including NULL terminator) is already more then
CurrentSize, then ASSERT()
@param[in,out] Destination The String to append onto
@param[in,out] CurrentSize on call the number of bytes in Destination. On
@param[in, out] Destination The String to append onto
@param[in, out] CurrentSize on call the number of bytes in Destination. On
return possibly the new size (still in bytes). if NULL
then allocate whatever is needed.
@param[in] Source The String to append from
@ -3825,7 +3825,7 @@ ShellIsHexOrDecimalNumber (
maintained and not changed for all operations with the same file.
@param[in] Handle SHELL_FILE_HANDLE to read from.
@param[in,out] Ascii Boolean value for indicating whether the file is
@param[in, out] Ascii Boolean value for indicating whether the file is
Ascii (TRUE) or UCS2 (FALSE).
@return The line of text from the file.
@ -3866,15 +3866,15 @@ ShellFileHandleReturnLine(
maintained and not changed for all operations with the same file.
@param[in] Handle SHELL_FILE_HANDLE to read from.
@param[in,out] Buffer The pointer to buffer to read into.
@param[in,out] Size The pointer to number of bytes in Buffer.
@param[in, out] Buffer The pointer to buffer to read into.
@param[in, out] Size The pointer to number of bytes in Buffer.
@param[in] Truncate If the buffer is large enough, this has no effect.
If the buffer is is too small and Truncate is TRUE,
the line will be truncated.
If the buffer is is too small and Truncate is FALSE,
then no read will occur.
@param[in,out] Ascii Boolean value for indicating whether the file is
@param[in, out] Ascii Boolean value for indicating whether the file is
Ascii (TRUE) or UCS2 (FALSE).
@retval EFI_SUCCESS The operation was successful. The line is stored in

2
ShellPkg/Library/UefiShellNetwork1CommandsLib/Ifconfig.c
View File

@ -249,7 +249,7 @@ GetChildHandle (
/**
Append OFFSET/WIDTH/VALUE items at the beginning of string.
@param[in,out] String The pointer to the string to append onto.
@param[in, out] String The pointer to the string to append onto.
@param[in] Offset Offset value.
@param[in] Width Width value.
@param[in] Block Point to data buffer.

4
ShellPkg/Library/UefiSortLib/UefiSortLib.c
View File

@ -43,7 +43,7 @@ STATIC EFI_UNICODE_COLLATION_PROTOCOL *mUnicodeCollation = NULL;
if Count is < 2 then perform no action.
if Size is < 1 then perform no action.
@param[in,out] BufferToSort on call a Buffer of (possibly sorted) elements
@param[in, out] BufferToSort on call a Buffer of (possibly sorted) elements
on return a buffer of sorted elements
@param[in] Count the number of elements in the buffer to sort
@param[in] ElementSize Size of an element in bytes
@ -149,7 +149,7 @@ QuickSortWorker (
if Count is < 2 then perform no action.
if Size is < 1 then perform no action.
@param[in,out] BufferToSort on call a Buffer of (possibly sorted) elements
@param[in, out] BufferToSort on call a Buffer of (possibly sorted) elements
on return a buffer of sorted elements
@param[in] Count the number of elements in the buffer to sort
@param[in] ElementSize Size of an element in bytes