From: <fd...@us...> - 2009-08-16 13:47:53
|
Revision: 5652 http://jnode.svn.sourceforge.net/jnode/?rev=5652&view=rev Author: fduminy Date: 2009-08-16 13:47:45 +0000 (Sun, 16 Aug 2009) Log Message: ----------- fixed comments & warnings in javadoc Modified Paths: -------------- trunk/core/src/core/org/jnode/vm/scheduler/VmProcessor.java trunk/core/src/core/org/jnode/vm/scheduler/VmScheduler.java Modified: trunk/core/src/core/org/jnode/vm/scheduler/VmProcessor.java =================================================================== --- trunk/core/src/core/org/jnode/vm/scheduler/VmProcessor.java 2009-08-16 11:48:25 UTC (rev 5651) +++ trunk/core/src/core/org/jnode/vm/scheduler/VmProcessor.java 2009-08-16 13:47:45 UTC (rev 5652) @@ -64,27 +64,27 @@ private volatile Word threadSwitchIndicator; /** - * Reference to myself; used in assembly code + * Reference to myself; used in assembly code. */ final VmProcessor me; /** - * The current thread on this processor + * The current thread on this processor. */ protected volatile VmThread currentThread; /** - * The isolated statics table of the current thread (int[]) + * The isolated statics table of the current thread (int[]). */ private volatile Object isolatedStaticsTable; /** - * The isolated statics table of the current thread + * The isolated statics table of the current thread. */ private volatile VmIsolatedStatics isolatedStatics; /** - * The next thread to schedule on this processor + * The next thread to schedule on this processor. */ volatile VmThread nextThread; @@ -99,54 +99,54 @@ protected volatile Address kernelStackEnd; /** - * The identifier of this processor + * The identifier of this processor. */ private int id; /** - * The identifier of this processor as string + * The identifier of this processor as string. */ private String idString; /** - * IRQ manager for this processor + * IRQ manager for this processor. */ private IRQManager irqMgr; /** - * Address of threadSwitchIndicator + * Address of threadSwitchIndicator. */ private Address tsiAddress; /** - * The scheduler that is used + * The scheduler that is used. */ private final VmScheduler scheduler; /** - * The architecture of this processor + * The architecture of this processor. */ private final VmArchitecture architecture; /** - * The idle thread + * The idle thread. */ private IdleThread idleThread; private int lockCount; /** - * CPU identification + * CPU identification. */ private transient CpuID cpuId; /** - * The statics table (int[]) + * The statics table (int[]). */ private volatile Object staticsTable; /** - * The processor speed indication + * The processor speed indication. */ private float jnodeMips; @@ -155,12 +155,12 @@ private int sameThreadPriorityCount; /** - * The data specific to this processor used by the heap manager + * The data specific to this processor used by the heap manager. */ private final Object heapData; /** - * Per processor MathSupport memory structures + * Per processor MathSupport memory structures. */ private final MathSupport mathSupport = new MathSupport(); @@ -177,27 +177,27 @@ private final int[] compilerIds; /** - * Indicate the a thread switch is needed + * Indicate the a thread switch is needed. */ public static final int TSI_SWITCH_NEEDED = 0x0001; /** - * Indicate that the system is ready for thread switching + * Indicate that the system is ready for thread switching. */ public static final int TSI_SYSTEM_READY = 0x0002; /** - * Indicate the a thread switch is in progress + * Indicate the a thread switch is in progress. */ public static final int TSI_SWITCH_ACTIVE = 0x0004; /** - * Indicate the a thread switch cannot occur + * Indicate the a thread switch cannot occur. */ public static final int TSI_BLOCK_SWITCH = 0x0008; /** - * Indicate the a thread switch is requested + * Indicate the a thread switch is requested. */ public static final int TSI_SWITCH_REQUESTED = TSI_SWITCH_NEEDED | TSI_SYSTEM_READY; @@ -215,7 +215,7 @@ } /** - * Initialize this instance + * Initialize this instance. * * @param id * @param architecture @@ -256,7 +256,7 @@ } /** - * Gets the current thread on this processor + * Gets the current thread on this processor. * * @return The current thread on this processor * @throws org.vmmagic.pragma.UninterruptiblePragma @@ -298,7 +298,7 @@ } /** - * Create an ID string for the given id + * Create an ID string for the given id. * * @param id * @return the ID string @@ -501,14 +501,14 @@ } /** - * Create a new thread + * Create a new thread. * * @return The new thread */ protected abstract VmThread createThread(VmIsolatedStatics isolatedStatics); /** - * Create a new thread + * Create a new thread. * * @param javaThread * @return The new thread @@ -518,7 +518,7 @@ } /** - * Create a new thread + * Create a new thread. * * @param javaThread * @return The new thread @@ -536,7 +536,7 @@ protected abstract int[] getIrqCounters(); /** - * Mark the system are ready for thread switching + * Mark the system as ready for thread switching. */ @Internal public final void systemReadyForThreadSwitch() { @@ -548,8 +548,8 @@ } /** - * Gets the address of the threadSwitchIndicator field in this object. It is - * assumed the this field is the first field of this class! + * Gets the address of the threadSwitchIndicator field in this object. <b>It is + * assumed this field is the first field of this class!</b> * * @return The address of the thread switch indicator */ @@ -590,7 +590,7 @@ /** * Load the CPU id. * - * @param id The idenfication returned by Unsafe.getCpuID + * @param id The identification returned by Unsafe.getCpuID * @return CpuID */ protected abstract CpuID loadCPUID(int[] id); @@ -630,7 +630,7 @@ } /** - * Calculate the processor speed and delay loops. + * Calculate the processor speed in "JNodeMips" and delay loops. */ @Internal public final void calibrate() { @@ -643,7 +643,7 @@ /** * Gets the processor speed indication. * - * @return the notional processor speed. + * @return the processor speed in "JNodeMips". */ public final float getJNodeMips() { return jnodeMips; Modified: trunk/core/src/core/org/jnode/vm/scheduler/VmScheduler.java =================================================================== --- trunk/core/src/core/org/jnode/vm/scheduler/VmScheduler.java 2009-08-16 11:48:25 UTC (rev 5651) +++ trunk/core/src/core/org/jnode/vm/scheduler/VmScheduler.java 2009-08-16 13:47:45 UTC (rev 5652) @@ -43,32 +43,32 @@ public final class VmScheduler { /** - * Reference to current architecture + * Reference to current architecture. */ private final VmArchitecture architecture; /** - * Lock for the allThreadsQueue + * Lock for the allThreadsQueue. */ private final ProcessorLock allThreadsLock; /** - * Queue holding all threads + * Queue holding all threads. */ private final VmThreadQueue.AllThreadsQueue allThreadsQueue; /** - * My ready queue + * My ready queue. */ private final VmThreadQueue.ScheduleQueue readyQueue; /** - * My sleep queue + * My sleep queue. */ private final VmThreadQueue.SleepQueue sleepQueue; /** - * Lock used to protect the ready and sleep queue + * Lock used to protect the ready and sleep queue. */ private final ProcessorLock queueLock; @@ -196,7 +196,7 @@ /** * Add the given thread to the ready queue to the scheduler and remove it - * from the sleep queue (if it still was on the sleep queue) + * from the sleep queue (if it still was on the sleep queue). * * @param thread * @param ignorePriority If true, the thread is always added to the back of the list, @@ -437,7 +437,7 @@ } /** - * Unlock the queues + * Unlock the queues. */ @Inline @Uninterruptible This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |