From 1c10262b18e17e3a0d15e66fbf6c5d5d92064418 Mon Sep 17 00:00:00 2001 From: neil Date: Sat, 30 Apr 2011 06:48:12 +0000 Subject: [PATCH] Improvements to comments. git-svn-id: https://svn.aros.org/svn/aros/trunk/AROS@38442 fb15a70f-31f2-0310-bbcc-cdcc74a49acc --- arch/all-unix/kernel/kernel_cpu.c | 7 ++++++- arch/i386-pc/drivers/mmakefile.src | 4 ++-- compiler/arossupport/include/libcall.h | 4 ++-- compiler/arossupport/rt_intuition.c | 4 ++-- compiler/include/dos/dos.h | 4 ++-- compiler/include/dos/filesystem.h | 7 ++++--- compiler/include/exec/lists.h | 2 +- compiler/include/exec/ports.h | 6 +++--- compiler/include/intuition/intuition.h | 4 ++-- rom/hyperlayers/createlayertaglist.c | 6 +++--- rom/hyperlayers/locklayer.c | 7 ++----- tools/genmodule/writestart.c | 2 +- 12 files changed, 30 insertions(+), 27 deletions(-) diff --git a/arch/all-unix/kernel/kernel_cpu.c b/arch/all-unix/kernel/kernel_cpu.c index b3167f7f11..aa5c8a39e9 100644 --- a/arch/all-unix/kernel/kernel_cpu.c +++ b/arch/all-unix/kernel/kernel_cpu.c @@ -1,3 +1,8 @@ +/* + Copyright © 1995-2011, The AROS Development Team. All rights reserved. + $Id$ +*/ + #include #include #include @@ -89,7 +94,7 @@ void cpu_Dispatch(regs_t *regs) AROS_HOST_BARRIER if (SysBase->SysFlags & SFF_SoftInt) - core_Cause(INTB_SOFTINT, 1l << INTB_SOFTINT); + core_Cause(INTB_SOFTINT, 1L << INTB_SOFTINT); } D(bug("[KRN] cpu_Dispatch(), task %p (%s)\n", task, task->tc_Node.ln_Name)); diff --git a/arch/i386-pc/drivers/mmakefile.src b/arch/i386-pc/drivers/mmakefile.src index 3cc5a1a69f..9e08060ab6 100644 --- a/arch/i386-pc/drivers/mmakefile.src +++ b/arch/i386-pc/drivers/mmakefile.src @@ -2,7 +2,7 @@ include $(TOP)/config/make.cfg # -# Rule's to create Kernel drivers for pc-i386 +# Rules to create Kernel drivers for pc-i386 # #MM- kernel-pc-i386-drivers : \ @@ -22,7 +22,7 @@ include $(TOP)/config/make.cfg ##MM kernel-pc-i386-usb-kobj # -# Rule's to create Support drivers for pc-i386 +# Rules to create Support drivers for pc-i386 # These are not needed as part of the kernel - and so get created seperately # diff --git a/compiler/arossupport/include/libcall.h b/compiler/arossupport/include/libcall.h index b35ab0938a..2c5ddefc8a 100644 --- a/compiler/arossupport/include/libcall.h +++ b/compiler/arossupport/include/libcall.h @@ -1,5 +1,5 @@ /* - Copyright © 1995-2008, The AROS Development Team. All rights reserved. + Copyright © 1995-2011, The AROS Development Team. All rights reserved. $Id$ */ @@ -41,7 +41,7 @@ arguments. Register names are written uppercase because they are preprocessor symbols. - Example: Define a Exec compatible RemHead function. + Example: Define an Exec-compatible RemHead function. AROS_LH1I(struct Node *, RemHead, struct List *, list, A0, diff --git a/compiler/arossupport/rt_intuition.c b/compiler/arossupport/rt_intuition.c index df66f05f91..ff16ef33bd 100644 --- a/compiler/arossupport/rt_intuition.c +++ b/compiler/arossupport/rt_intuition.c @@ -1,8 +1,8 @@ /* - Copyright © 1995-2010, The AROS Development Team. All rights reserved. + Copyright © 1995-2011, The AROS Development Team. All rights reserved. $Id$ - Desc: Basic functions for ressource tracking + Desc: Basic functions for resource tracking Lang: english */ diff --git a/compiler/include/dos/dos.h b/compiler/include/dos/dos.h index e261ed6ac4..0242d21d35 100644 --- a/compiler/include/dos/dos.h +++ b/compiler/include/dos/dos.h @@ -2,7 +2,7 @@ #define DOS_DOS_H /* - Copyright © 1995-2010, The AROS Development Team. All rights reserved. + Copyright © 1995-2011, The AROS Development Team. All rights reserved. $Id$ Desc: Basic DOS structures and constants @@ -83,7 +83,7 @@ struct FileInfoBlock }; /* Protection bits for files (fib_Protection). */ -/* Flags for owner (they a low-active, i.e. not set means the action is +/* Flags for owner (they are active-low, i.e. not set means the action is allowed!) */ #define FIBB_DELETE 0 /* File is deleteable. */ #define FIBB_EXECUTE 1 /* File is executable (no scripts!). */ diff --git a/compiler/include/dos/filesystem.h b/compiler/include/dos/filesystem.h index 30c60f2221..72dc7f85d1 100644 --- a/compiler/include/dos/filesystem.h +++ b/compiler/include/dos/filesystem.h @@ -2,7 +2,7 @@ #define DOS_FILESYSTEM_H /* - Copyright © 1995-2001, The AROS Development Team. All rights reserved. + Copyright © 1995-2011, The AROS Development Team. All rights reserved. $Id$ Desc: AROS specific structures and definitions for filesystems. @@ -92,8 +92,9 @@ struct IFS_READ_WRITE #define FSA_SEEK 5 struct IFS_SEEK { - /* Offset from position, specified as mode. This is filled by the - filehandler with the old position in the file. */ + /* Offset from position specified by mode. This is filled by the + filehandler with the old position in the file. For FSA_SET_FILE_SIZE, + it is filled with the actual new size */ QUAD io_Offset; /* Seek mode as defined in (OFFSET_#?). */ LONG io_SeekMode; diff --git a/compiler/include/exec/lists.h b/compiler/include/exec/lists.h index f5c918f32f..2bf6d3dbbc 100644 --- a/compiler/include/exec/lists.h +++ b/compiler/include/exec/lists.h @@ -40,7 +40,7 @@ struct MinList /************************************** - Makros + Macros **************************************/ #define IsListEmpty(l) \ ( (((struct List *)l)->lh_TailPred) == (struct Node *)(l) ) diff --git a/compiler/include/exec/ports.h b/compiler/include/exec/ports.h index 480e8898cd..666a9cc30f 100644 --- a/compiler/include/exec/ports.h +++ b/compiler/include/exec/ports.h @@ -2,7 +2,7 @@ #define EXEC_PORTS_H /* - Copyright 1995-2001, The AROS Development Team. All rights reserved. + Copyright © 1995-2011, The AROS Development Team. All rights reserved. $Id$ Desc: Message ports and messages @@ -41,8 +41,8 @@ struct MsgPort #define PA_FASTCALL 4 /* AROS extension. Like PA_SOFTINT, calls an Interrupt in mp_SoftInt, but passes the - message as the third argument without doesn't - add it to the message list and so doesn't + message as the third argument without + adding it to the message list and so doesn't require any locking, task switching or Disable()/Enable() pairs */ diff --git a/compiler/include/intuition/intuition.h b/compiler/include/intuition/intuition.h index 47c8040280..ade7c8e1db 100644 --- a/compiler/include/intuition/intuition.h +++ b/compiler/include/intuition/intuition.h @@ -2,7 +2,7 @@ #define INTUITION_INTUITION_H /* - Copyright 1995-2010, The AROS Development Team. All rights reserved. + Copyright © 1995-2011, The AROS Development Team. All rights reserved. $Id$ Desc: Important defines and structures for intuition.library @@ -586,7 +586,7 @@ struct NewWindow struct Gadget * FirstGadget; struct Image * CheckMark; UBYTE * Title; - struct Screen * Screen; + struct Screen * Screen; /* ignored if Type != CUSTOMSCREEN */ struct BitMap * BitMap; WORD MinWidth; diff --git a/rom/hyperlayers/createlayertaglist.c b/rom/hyperlayers/createlayertaglist.c index 2c3fd19de6..b6a75ebf90 100644 --- a/rom/hyperlayers/createlayertaglist.c +++ b/rom/hyperlayers/createlayertaglist.c @@ -1,5 +1,5 @@ /* - Copyright © 1995-2007, The AROS Development Team. All rights reserved. + Copyright © 1995-2011, The AROS Development Team. All rights reserved. $Id$ */ @@ -72,9 +72,9 @@ RESULT Pointer to the newly created layer. NULL if layer could not be created (Probably out of memory). - If the layer is created successful you must not free its shape. + If the layer is created successfully you must not free its shape. The shape is automatically freed when the layer is deleted. - + NOTES EXAMPLE diff --git a/rom/hyperlayers/locklayer.c b/rom/hyperlayers/locklayer.c index 7ccfa60bf8..a85450bf1e 100644 --- a/rom/hyperlayers/locklayer.c +++ b/rom/hyperlayers/locklayer.c @@ -1,5 +1,5 @@ /* - Copyright © 1995-2007, The AROS Development Team. All rights reserved. + Copyright © 1995-2011, The AROS Development Team. All rights reserved. $Id$ Desc: @@ -34,6 +34,7 @@ can access it. INPUTS + dummy - unused. layer - pointer to layer to be locked RESULT @@ -48,10 +49,6 @@ INTERNALS - HISTORY - 27-11-96 digulla automatically created from - layers_lib.fd and clib/layers_protos.h - *****************************************************************************/ { AROS_LIBFUNC_INIT diff --git a/tools/genmodule/writestart.c b/tools/genmodule/writestart.c index 036fddead7..40455a6b9d 100644 --- a/tools/genmodule/writestart.c +++ b/tools/genmodule/writestart.c @@ -252,7 +252,7 @@ static void writedecl(FILE *out, struct config *cfg) for (classlistit = cfg->classlist; classlistit != NULL; classlistit = classlistit->next) { - /* For the main class basename is the same a the module basename */ + /* For the main class basename is the same as the module basename */ if (strcmp(classlistit->basename, cfg->basename) == 0) { if (classlistit->classptr_var == NULL) -- 2.11.4.GIT