From a684097739ec00764b83078b797b54e2b701eb15 Mon Sep 17 00:00:00 2001 From: neil Date: Thu, 19 Mar 2015 01:00:56 +0000 Subject: [PATCH] Fixes to comments. git-svn-id: https://svn.aros.org/svn/aros/trunk/AROS@50212 fb15a70f-31f2-0310-bbcc-cdcc74a49acc --- arch/all-hosted/hostlib/getinterface.c | 4 ++-- arch/all-unix/bootstrap/memory.c | 11 ++++++++--- compiler/alib/checkrexxmsg.c | 4 ++-- rom/devs/gameport/gameport.c | 10 +++++----- rom/dos/runcommand.c | 5 +++-- rom/exec/allocabs.c | 5 +++-- rom/exec/newstackswap.c | 11 ++++++----- rom/intuition/closewindow.c | 8 ++++---- workbench/tools/HDToolBox/README | 2 +- 9 files changed, 34 insertions(+), 26 deletions(-) diff --git a/arch/all-hosted/hostlib/getinterface.c b/arch/all-hosted/hostlib/getinterface.c index c2d713ee77..e675227dc0 100644 --- a/arch/all-hosted/hostlib/getinterface.c +++ b/arch/all-hosted/hostlib/getinterface.c @@ -1,5 +1,5 @@ /* - Copyright © 1995-2014, The AROS Development Team. All rights reserved. + Copyright © 1995-2015, The AROS Development Team. All rights reserved. $Id$ */ @@ -41,7 +41,7 @@ NOTES Note that the resulting array will always have as many entries as there are in symbol names array. It some symbols (or even all of them) fail - to resolve, correspondind entries will be set to NULL. You may supply + to resolve, corresponding entries will be set to NULL. You may supply a valid unresolved pointer if you want to get unresolved symbols count. Even incomplete interface needs to be freed using HostLib_DropInterface(). diff --git a/arch/all-unix/bootstrap/memory.c b/arch/all-unix/bootstrap/memory.c index b3dcb042ff..026c2fb873 100644 --- a/arch/all-unix/bootstrap/memory.c +++ b/arch/all-unix/bootstrap/memory.c @@ -1,3 +1,8 @@ +/* + Copyright © 1995-2015, The AROS Development Team. All rights reserved. + $Id$ +*/ + #include #include #include @@ -23,7 +28,7 @@ static size_t RAM_len = 0; #endif /* - * Allocate memory for kickstart's .code and .rodata. We allocate is as writable + * Allocate memory for kickstart's .code and .rodata. We allocate it as writable * because we will load the kickstart into it. We will enable execution later in SetRO(). * We have to use mmap() and not posix_memalign() here because posix_memalign() * does not pad the allocated memory up to next page boundary. As a result, setting @@ -77,8 +82,8 @@ void *AllocateRW(size_t len) } /* - * These routines allocate memory usable as AROS ram. This means it - * needs to have full permissions. + * These routines allocate memory usable as AROS RAM. This means they + * need to have full permissions. * Yes, iOS will silently mask out PROT_EXEC here. This is bad. * Well, iOS will be a little bit special story in InternalLoadSeg()... */ diff --git a/compiler/alib/checkrexxmsg.c b/compiler/alib/checkrexxmsg.c index 03ec34f71e..0885d7e9ff 100644 --- a/compiler/alib/checkrexxmsg.c +++ b/compiler/alib/checkrexxmsg.c @@ -1,5 +1,5 @@ /* - Copyright © 1995-2007, The AROS Development Team. All rights reserved. + Copyright © 1995-2015, The AROS Development Team. All rights reserved. $Id$ Desc: @@ -27,7 +27,7 @@ msg - The message to check RESULT - Wether this message is OK. + Whether this message is OK. NOTES diff --git a/rom/devs/gameport/gameport.c b/rom/devs/gameport/gameport.c index f2abfe6267..efd26b1abf 100644 --- a/rom/devs/gameport/gameport.c +++ b/rom/devs/gameport/gameport.c @@ -1,5 +1,5 @@ /* - Copyright © 1995-2010, The AROS Development Team. All rights reserved. + Copyright © 1995-2015, The AROS Development Team. All rights reserved. $Id$ Desc: Gameport device @@ -232,7 +232,7 @@ static int GM_UNIQUENAME(open) { GPBase->gp_MouseHiddBase = OpenLibrary("mouse.hidd", 0); - /* Install our own keyboard handler if opened for the first time */ + /* Install our own mouse handler if opened for the first time */ if(GPBase->gp_MouseHiddBase) { struct TagItem tags[] = { { aHidd_Mouse_IrqHandler , (IPTR)mouseCallback}, @@ -241,7 +241,7 @@ static int GM_UNIQUENAME(open) }; GPBase->gp_Hidd = OOP_NewObject(NULL, CLID_Hidd_Mouse, tags); - D(bug("keyboard.device: keyboard HIDD object 0x%p\n", GPBase->gp_Hidd)); + D(bug("gameport.device: mouse HIDD object 0x%p\n", GPBase->gp_Hidd)); if(!GPBase->gp_Hidd) { CloseLibrary(GPBase->gp_MouseHiddBase); @@ -543,7 +543,7 @@ static VOID mouseCallback(struct GameportBase *GPBase, /****************************************************************************************/ -/* nlorentz: Software interrupt to be called when keys are received +/* nlorentz: Software interrupt to be called when input is received Copied and pasted from the function above */ #undef SysBase @@ -592,7 +592,7 @@ static AROS_INTH1(gpSendQueuedEvents, struct GameportBase *, GPBase) /****************************************************************************************/ /* When this function is called, there *must* be at least one event ready for - processing. It returns TRUE as long as there are more events to preocess */ + processing. It returns TRUE as long as there are more events to process */ static BOOL fillrequest(struct IORequest *ioreq, BOOL *trigged, struct GameportBase *GPBase) diff --git a/rom/dos/runcommand.c b/rom/dos/runcommand.c index de119fb9c2..4603673fbb 100644 --- a/rom/dos/runcommand.c +++ b/rom/dos/runcommand.c @@ -1,5 +1,5 @@ /* - Copyright © 1995-2011, The AROS Development Team. All rights reserved. + Copyright © 1995-2015, The AROS Development Team. All rights reserved. $Id$ Desc: Execute a loaded command synchronously @@ -49,7 +49,8 @@ argsize - size of the arguments string. RESULT - The return code from the program. See also IoErr(). + The return code from the program, or -1 if the command could not be + started (e.g. no memory for the stack). See also IoErr(). NOTES Programs expect the argument string to end with a newline ('\n') diff --git a/rom/exec/allocabs.c b/rom/exec/allocabs.c index fbe62ff8db..2349fd9e9b 100644 --- a/rom/exec/allocabs.c +++ b/rom/exec/allocabs.c @@ -1,5 +1,5 @@ /* - Copyright © 1995-2012, The AROS Development Team. All rights reserved. + Copyright © 1995-2015, The AROS Development Team. All rights reserved. $Id$ Desc: Allocate memory at address @@ -33,6 +33,7 @@ /* FUNCTION Allocate some memory from the system memory pool at a given address. + The memory must be freed with FreeMem(). INPUTS byteSize - Number of bytes you want to get @@ -40,7 +41,7 @@ RESULT A pointer to some memory including the requested bytes or NULL if - the memory couldn't be allocated + the memory couldn't be allocated. NOTES diff --git a/rom/exec/newstackswap.c b/rom/exec/newstackswap.c index 5cf8555702..dd61f1f4ef 100644 --- a/rom/exec/newstackswap.c +++ b/rom/exec/newstackswap.c @@ -1,5 +1,5 @@ /* - Copyright © 1995-2009, The AROS Development Team. All rights reserved. + Copyright © 1995-2015, The AROS Development Team. All rights reserved. $Id$ Desc: NewStackSwap() - Call a function with swapped stack. @@ -15,7 +15,7 @@ AROS_LH3(IPTR, NewStackSwap, /* SYNOPSIS */ - AROS_LHA(struct StackSwapStruct *, sss, A0), + AROS_LHA(struct StackSwapStruct *, sss, A0), AROS_LHA(LONG_FUNC, entry, A1), AROS_LHA(struct StackSwapArgs *, args, A2), @@ -30,13 +30,14 @@ and current bounds of the stack you wish to use. entry - Address of the function to call. args - A structure (actually an array) containing up to 8 - function arguments + function arguments. May be NULL. RESULT - A value actually returned by your function. The function will be - running on a new stack. + The value returned by your function. NOTES + This function is mostly compatible with MorphOS's NewPPCStackSwap() + function. EXAMPLE diff --git a/rom/intuition/closewindow.c b/rom/intuition/closewindow.c index 12eb652a11..31dcab4c7a 100644 --- a/rom/intuition/closewindow.c +++ b/rom/intuition/closewindow.c @@ -1,5 +1,5 @@ /* - Copyright © 1995-2013, The AROS Development Team. All rights reserved. + Copyright © 1995-2015, The AROS Development Team. All rights reserved. Copyright © 2001-2003, The MorphOS Development Team. All Rights Reserved. $Id$ */ @@ -103,7 +103,7 @@ VOID int_closewindow(struct CloseWindowActionMsg *msg, #ifndef __MORPHOS__ /* We take a very simple approach to avoid race conditions with the - intuition input handler running one input.device 's task: + intuition input handler running on input.device's task: We just send it a msg about closing the window */ if (HAS_CHILDREN(window)) @@ -218,7 +218,7 @@ VOID int_closewindow(struct CloseWindowActionMsg *msg, VOID int_closewindow(struct CloseWindowActionMsg *msg, struct IntuitionBase *IntuitionBase) { - /* Free everything except the applications messageport */ + /* Free everything except the application's messageport */ struct GfxBase *GfxBase = GetPrivIBase(IntuitionBase)->GfxBase; struct LayersBase *LayersBase = GetPrivIBase(IntuitionBase)->LayersBase; struct Window *window, *win2; @@ -417,7 +417,7 @@ VOID int_closewindow(struct CloseWindowActionMsg *msg, if (((struct IntWindow *)(window))->transpregion) DisposeRegion(((struct IntWindow *)(window))->transpregion); #endif - /* Let the driver clean up. Driver wil dealloc window's rastport */ + /* Let the driver clean up. Driver will dealloc window's rastport */ intui_CloseWindow (window, IntuitionBase); /* jDc: trash the screen pointer to avoid unnecessary checks in WindowValid() and diff --git a/workbench/tools/HDToolBox/README b/workbench/tools/HDToolBox/README index e9ae5a7759..882aa0509e 100644 --- a/workbench/tools/HDToolBox/README +++ b/workbench/tools/HDToolBox/README @@ -42,7 +42,7 @@ Edit Window =========== On the left: Partition Table: - Select wether the current partition is a partition table + Select whether the current partition is a partition table or not. If checked the partition will appear as a "sub partition table" in the main screen. If you select it there you will be asked to create a new partition table. If you quit HDToolBox without creating a table -- 2.11.4.GIT