mirror/ghidra
1
0
Fork 0
mirror of https://github.com/NationalSecurityAgency/ghidra.git synced 2026-09-28 17:11:11 -09:00
Code Issues Packages Projects Releases Wiki Activity

GP-0: Fixing javadoc warnings

Browse Source
This commit is contained in:
Ryan Kurtz
2024-08-19 11:39:05 -04:00
parent 2c3a815163
commit 3588ecdab7
18 changed files with 76 additions and 73 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
Ghidra/Framework/DB/src/main/java/db/BTreeNode.java
View File

@@ -4,9 +4,9 @@
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -91,9 +91,8 @@ interface BTreeNode {
* @return true if consistency check passed, else false
* @param tableName name of table containing this node
* @param monitor task monitor
* @throws IOException if IO error occured
* @throws IOException if IO error occurred
* @throws CancelledException if task cancelled
* @{@link ThrowsTag} CancelledException
*/
public boolean isConsistent(String tableName, TaskMonitor monitor)
throws IOException, CancelledException;

6
Ghidra/Framework/DB/src/main/java/db/FixedKeyVarRecNode.java
View File

@@ -4,9 +4,9 @@
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -224,7 +224,7 @@ class FixedKeyVarRecNode extends FixedKeyRecordNode {
/**
* Find the index which represents the halfway point within the record data.
* @returns key index.
* @return key index.
*/
private int getSplitIndex() {

6
Ghidra/Framework/Docking/src/main/java/docking/widgets/fieldpanel/field/EmptyTextField.java
View File

@@ -4,9 +4,9 @@
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -56,7 +56,7 @@ public class EmptyTextField implements Field {
/**
* Returns true if the cursor is allowed past the last character. This
* field always returns false since there is no text.
* @returns true if the cursor is allowed past the last character
* @return true if the cursor is allowed past the last character
*/
public boolean isAllowCursorAtEnd() {
return false;

6
Ghidra/Framework/Emulation/src/main/java/ghidra/pcode/emu/SleighInstructionDecoder.java
View File

@@ -4,9 +4,9 @@
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -56,10 +56,10 @@ public class SleighInstructionDecoder implements InstructionDecoder {
/**
* Construct a Sleigh instruction decoder
*
* @see {@link DefaultPcodeThread#createInstructionDecoder(PcodeExecutorState)}
* @param language the language to decoder
* @param state the state containing the target program, probably the shared state of the p-code
* machine. It must be possible to obtain concrete buffers on this state.
* @see DefaultPcodeThread#createInstructionDecoder(PcodeExecutorState)
*/
public SleighInstructionDecoder(Language language, PcodeExecutorState<?> state) {
this.language = language;

6
Ghidra/Framework/Emulation/src/main/java/ghidra/pcode/emu/ThreadPcodeExecutorState.java
View File

@@ -4,9 +4,9 @@
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -40,9 +40,9 @@ public class ThreadPcodeExecutorState<T> implements PcodeExecutorState<T> {
/**
* Create a multiplexed state
*
* @see {@link DefaultPcodeThread#DefaultPcodeThread(String, AbstractPcodeMachine)}
* @param sharedState the shared part of the state
* @param localState the thread-local part of the state
* @see DefaultPcodeThread#DefaultPcodeThread(String, AbstractPcodeMachine)
*/
public ThreadPcodeExecutorState(PcodeExecutorState<T> sharedState,
PcodeExecutorState<T> localState) {

16
Ghidra/Framework/Generic/src/main/java/ghidra/util/datastruct/AbstractWeakValueMap.java
View File

@@ -4,9 +4,9 @@
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -308,17 +308,20 @@ public abstract class AbstractWeakValueMap<K, V> implements Map<K, V> {
/**
* Class that provides a {@link Set} view of the entry set of this map that is backed live
* by this map. Its main job is to translate from Map.Entry<K, WeakValueRef<V>> to
* Map.Entry<K,V>. The heavy lifting is done by the EntryIterator. The super class implements
* all the rest of the methods by leveraging the iterator. We implement
* by this map. Its main job is to translate from {@code Map.Entry<K, WeakValueRef<V>>} to
* {@code Map.Entry<K,V>}. The heavy lifting is done by the {@link EntryIterator}. The super
* class implements all the rest of the methods by leveraging the iterator. We implement
* contains, remove, and clear as they can be implemented much more efficiently than the
* default implementation which iterates over all the values to do those operations.
*/
private class EntrySet extends AbstractSet<Map.Entry<K, V>> {
@Override
public Iterator<Map.Entry<K, V>> iterator() {
return new EntryIterator();
}
@Override
public boolean contains(Object o) {
if (o instanceof Map.Entry<?, ?> e) {
Object key = e.getKey();
@@ -328,6 +331,7 @@ public abstract class AbstractWeakValueMap<K, V> implements Map<K, V> {
return false;
}
@Override
public boolean remove(Object o) {
if (o instanceof Map.Entry<?, ?> e) {
Object key = e.getKey();
@@ -341,10 +345,12 @@ public abstract class AbstractWeakValueMap<K, V> implements Map<K, V> {
}
@Override
public int size() {
return AbstractWeakValueMap.this.size();
}
@Override
public void clear() {
AbstractWeakValueMap.this.clear();
}

31
Ghidra/Framework/Project/src/main/java/ghidra/framework/model/ProjectLocator.java
View File

@@ -4,9 +4,9 @@
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -143,23 +143,23 @@ public class ProjectLocator {
}
/**
* @returns true if this project URL corresponds to a transient project
* (e.g., corresponds to remote Ghidra URL)
* {@return true if this project URL corresponds to a transient project
* (e.g., corresponds to remote Ghidra URL)}
*/
public boolean isTransient() {
return false;
}
/**
* @returns the URL associated with this local project. If using a temporary transient
* project location this URL should not be used.
* {@return the URL associated with this local project. If using a temporary transient
* project location this URL should not be used.}
*/
public URL getURL() {
return url;
}
/**
* @returns the name of the project identified by this project info.
* {@return the name of the project identified by this project info.}
*/
public String getName() {
return name;
@@ -168,6 +168,7 @@ public class ProjectLocator {
/**
* Get the location of the project which will contain marker file
* ({@link #getMarkerFile()}) and project directory ({@link #getProjectDir()}).
* <p>
* Note: directory may or may not exist.
* @return project location directory
*/
@@ -176,29 +177,28 @@ public class ProjectLocator {
}
/**
* @returns the project directory
* {@return the project directory}
*/
public File getProjectDir() {
return new File(location, name + PROJECT_DIR_SUFFIX);
}
/**
* @returns the file that indicates a Ghidra project.
* {@return the file that indicates a Ghidra project.}
*/
public File getMarkerFile() {
return new File(location, name + PROJECT_FILE_SUFFIX);
}
/**
* @returns project lock file to prevent multiple accesses to the
* same project at once.
* {@return project lock file to prevent multiple accesses to the same project at once.}
*/
public File getProjectLockFile() {
return new File(location, name + LOCK_FILE_SUFFIX);
}
/**
* @returns the project directory file extension.
* {@return the project directory file extension.}
*/
public static String getProjectDirExtension() {
return PROJECT_DIR_SUFFIX;
@@ -230,23 +230,22 @@ public class ProjectLocator {
}
/**
* @returns the file extension suitable for creating file filters for the file chooser.
* {@return the file extension suitable for creating file filters for the file chooser}
*/
public static String getProjectExtension() {
return PROJECT_FILE_SUFFIX;
}
/**
* Returns whether the given file is a project directory.
* {@return whether the given file is a project directory.}
* @param file file to check
* @return true if the file is a project directory
*/
public static boolean isProjectDir(File file) {
return file.isDirectory() && file.getName().endsWith(PROJECT_DIR_SUFFIX);
}
/**
* @returns true if project storage exists
* {@return true if project storage exists}
*/
public boolean exists() {
return getMarkerFile().isFile() && getProjectDir().isDirectory();

7
Ghidra/Framework/SoftwareModeling/src/main/java/ghidra/app/util/pcode/AbstractPcodeFormatter.java
View File

@@ -4,9 +4,9 @@
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -31,10 +31,9 @@ import ghidra.util.Msg;
* {@link #formatOpTemplate(Appender, OpTpl)}. Otherwise, most formatting logic is implemented by
* the appender.
*
* @see {@link StringPcodeFormatter} for an example
* @see {@link AbstractAppender}
* @param <T> the type of this formatter's output, e.g., {@link String}
* @param <A> the type of the appender
* @see AbstractAppender
*/
public abstract class AbstractPcodeFormatter<T, A extends Appender<T>>
implements PcodeFormatter<T> {