Team2890/allwpilib
4
0
Fork 0
mirror of https://github.com/wpilibsuite/allwpilib synced 2026-06-21 01:01:43 +00:00
Code Issues Packages Projects Releases Wiki Activity

Fix warnings for javadocs

Browse Source 
Change-Id: I818c2086d69eff098543b4d5a554ba9d703e01e8
This commit is contained in:
Joe Ross
2014-10-19 16:38:27 -07:00
parent c52e29432c
commit fc7c015823
14 changed files with 48 additions and 52 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
wpilibj/wpilibJavaDevices/src/main/java/edu/wpi/first/wpilibj/ADXL345_I2C.java
View File

@@ -91,19 +91,19 @@ public class ADXL345_I2C extends SensorBase implements Accelerometer {
m_i2c.write(kDataFormatRegister, kDataFormat_FullRes | value);
}
/** {@inheritdoc} */
/** {@inheritDoc} */
@Override
public double getX() {
return getAcceleration(Axes.kX);
}
/** {@inheritdoc} */
/** {@inheritDoc} */
@Override
public double getY() {
return getAcceleration(Axes.kY);
}
/** {@inheritdoc} */
/** {@inheritDoc} */
@Override
public double getZ() {
return getAcceleration(Axes.kZ);

13
wpilibj/wpilibJavaDevices/src/main/java/edu/wpi/first/wpilibj/ADXL345_SPI.java
View File

@@ -64,12 +64,9 @@ public class ADXL345_SPI extends SensorBase implements Accelerometer {
private SPI m_spi;
/**
* Constructor. Use this when the device is the first/only device on the bus
* Constructor.
*
* @param clk The clock channel
* @param mosi The mosi (output) channel
* @param miso The miso (input) channel
* @param cs The chip select channel
* @param port the Port that the accelerometer is connected to
* @param range The range (+ or -) that the accelerometer will measure.
*/
public ADXL345_SPI(SPI.Port port, Range range) {
@@ -132,19 +129,19 @@ public class ADXL345_SPI extends SensorBase implements Accelerometer {
m_spi.write(commands, commands.length);
}
/** {@inheritdoc} */
/** {@inheritDoc} */
@Override
public double getX() {
return getAcceleration(Axes.kX);
}
/** {@inheritdoc} */
/** {@inheritDoc} */
@Override
public double getY() {
return getAcceleration(Axes.kY);
}
/** {@inheritdoc} */
/** {@inheritDoc} */
@Override
public double getZ() {
return getAcceleration(Axes.kZ);

10
wpilibj/wpilibJavaDevices/src/main/java/edu/wpi/first/wpilibj/CANJaguar.java
View File

@@ -1157,7 +1157,7 @@ public class CANJaguar implements MotorSafety, PIDOutput, SpeedController, LiveW
* position sensing from a quadrature encoder.<br>
* After calling this you must call {@link CANJaguar#enableControl()} or {@link CANJaguar#enableControl(double)} to enable the device.
*
* @param endoer The constant {@link CANJaguar#kQuadEncoder}
* @param tag The constant {@link CANJaguar#kQuadEncoder}
* @param p The proportional gain of the Jaguar's PID controller.
* @param i The integral gain of the Jaguar's PID controller.
* @param d The differential gain of the Jaguar's PID controller.
@@ -1800,7 +1800,7 @@ public class CANJaguar implements MotorSafety, PIDOutput, SpeedController, LiveW
* is added internally)
* @param data The up to 8 bytes of data to be sent with the message
* @param dataSize Specify how much of the data in "data" to send
* @param periodic If positive, tell Network Communications to send the
* @param period If positive, tell Network Communications to send the
* message every "period" milliseconds.
*/
protected void sendMessage(int messageID, byte[] data, int dataSize, int period) {
@@ -1808,7 +1808,7 @@ public class CANJaguar implements MotorSafety, PIDOutput, SpeedController, LiveW
}
/**
* Send a message to the Jaguar, non-periodly
* Send a message to the Jaguar, non-periodically
*
* @param messageID The messageID to be used on the CAN bus (device number
* is added internally)
@@ -1823,7 +1823,7 @@ public class CANJaguar implements MotorSafety, PIDOutput, SpeedController, LiveW
* Request a message from the Jaguar, but don't wait for it to arrive.
*
* @param messageID The message to request
* @param periodic If positive, tell Network Communications to request the
* @param period If positive, tell Network Communications to request the
* message every "period" milliseconds.
*/
protected void requestMessage(int messageID, int period) {
@@ -1847,7 +1847,7 @@ public class CANJaguar implements MotorSafety, PIDOutput, SpeedController, LiveW
* @param messageID The messageID to read from the CAN bus (device number is added internally)
* @param data The up to 8 bytes of data that was received with the message
*
* @throw CANMessageNotFoundException if there's not new message available
* @throws CANMessageNotFoundException if there's not new message available
*/
protected void getMessage(int messageID, int messageMask, byte[] data) throws CANMessageNotFoundException {
messageID |= m_deviceNumber;

4
wpilibj/wpilibJavaDevices/src/main/java/edu/wpi/first/wpilibj/Compressor.java
View File

@@ -26,7 +26,7 @@ public class Compressor extends SensorBase implements LiveWindowSendable {
/**
* Create an instance of the Compressor
* @param pcmID
* @param pcmId
* The PCM CAN device ID. Most robots that use PCM will have a single module. Use this
* for supporting a second module other than the default.
*/
@@ -71,7 +71,7 @@ public class Compressor extends SensorBase implements LiveWindowSendable {
/**
* Get the enabled status of the compressor
* @returns true if the compressor is on
* @return true if the compressor is on
*/
public boolean enabled() {
ByteBuffer status = ByteBuffer.allocateDirect(4);

4
wpilibj/wpilibJavaDevices/src/main/java/edu/wpi/first/wpilibj/Counter.java
View File

@@ -466,7 +466,7 @@ public class Counter extends SensorBase implements CounterBase,
* Read the current scaled counter value. Read the value at this instant,
* scaled by the distance per pulse (defaults to 1).
*
* @return
* @return The distance since the last reset
*/
public double getDistance() {
return get() * m_distancePerPulse;
@@ -581,7 +581,7 @@ public class Counter extends SensorBase implements CounterBase,
* most recent count. This can be used for velocity calculations to
* determine shaft speed.
*
* @returns The period of the last two pulses in units of seconds.
* @return The period of the last two pulses in units of seconds.
*/
@Override
public double getPeriod() {

8
wpilibj/wpilibJavaDevices/src/main/java/edu/wpi/first/wpilibj/InterruptableSensorBase.java
View File

@@ -58,17 +58,17 @@ public abstract class InterruptableSensorBase extends SensorBase {
}
/**
* @return
* @return true if this is an analog trigger
*/
abstract boolean getAnalogTriggerForRouting();
/**
* @return
* @return channel routing number
*/
abstract int getChannelForRouting();
/**
* @return
* @return module routing number
*/
abstract byte getModuleForRouting();
@@ -76,7 +76,7 @@ public abstract class InterruptableSensorBase extends SensorBase {
* Request interrupts asynchronously on this digital input.
*
* @param handler
* The {@link #InterruptHandlerFunction} that contains the method
* The {@link InterruptHandlerFunction} that contains the method
* {@link InterruptHandlerFunction#interruptFired(int, Object)} that
* will be called whenever there is an interrupt on this device.
* Request interrupts in synchronus mode where the user program

2
wpilibj/wpilibJavaDevices/src/main/java/edu/wpi/first/wpilibj/SPI.java
View File

@@ -46,7 +46,7 @@ public class SPI extends SensorBase {
/**
* Constructor
*
* @param SPIport the physical SPI port
* @param port the physical SPI port
*/
public SPI(Port port) {
ByteBuffer status = ByteBuffer.allocateDirect(4);

4
wpilibj/wpilibJavaDevices/src/main/java/edu/wpi/first/wpilibj/Servo.java
View File

@@ -24,8 +24,8 @@ public class Servo extends PWM {
private static final double kMaxServoAngle = 180.0;
private static final double kMinServoAngle = 0.0;
private static final double kDefaultMaxServoPWM = 2.4;
private static final double kDefaultMinServoPWM = .6;
protected static final double kDefaultMaxServoPWM = 2.4;
protected static final double kDefaultMinServoPWM = .6;
/**
* Common initialization code called by all constructors.