fix issue-75743

Author: akash-manna-sky

src/main/java/edu/hm/hafner/analysis/registry/Gcc4Descriptor.java

@@ -10,14 +10,20 @@
 /**
  * A descriptor for the GNU C Compiler (gcc).
  *
- * Supports GCC version 4 and newer (modern GCC output).
- * For legacy GCC (<3), use the GCC3 parser.
+ * <p>
+ * Supports GCC version 4 and newer, including modern versions up to GCC 15+.
+ * This parser handles the standard GCC output format introduced in GCC 4.
+ * </p>
+ *
+ * <p>
+ * For legacy GCC versions (pre-GCC 4), use the "gcc3" parser instead.
+ * </p>
  *
  * @author Lorenz Munsch
  */
 class Gcc4Descriptor extends CompositeParserDescriptor {
     private static final String ID = "gcc";
-    private static final String NAME = "GNU C Compiler (GCC 4 and newer)";
+    private static final String NAME = "GNU C Compiler (GCC)";
 
     Gcc4Descriptor() {
         super(ID, NAME);
@@ -31,9 +37,9 @@ protected Collection<? extends IssueParser> createParsers() {
     @Override
     public String getHelp() {
         return "Parses warnings and errors generated by GCC version 4 and newer "
-             + "(including GCC 5–15). Use this parser for modern GCC compilers "
-             + "that output messages like:\n"
-             + "file.c:10:5: warning: unused variable ‘x’ [-Wunused-variable]\n\n"
-             + "For very old GCC (<3) logs, use the legacy GCC3 parser.";
+                + "(including GCC 5–15+). Use this parser for modern GCC compilers "
+                + "that output messages in the standard format like:\n"
+                + "file.c:10:5: warning: unused variable 'x' [-Wunused-variable]\n\n"
+                + "For very old GCC versions (pre-GCC 4), use the 'gcc3' parser instead.";
     }
 }

src/main/java/edu/hm/hafner/analysis/registry/GccDescriptor.java

@@ -4,13 +4,21 @@
 import edu.hm.hafner.analysis.parser.GccParser;
 
 /**
- * A descriptor for GNU C Compiler 3 (gcc).
+ * A descriptor for legacy GNU C Compiler (gcc) versions older than GCC 4.
+ *
+ * <p>
+ * This parser is designed for very old GCC compilers (pre-GCC 4) that use a
+ * different
+ * output format. For modern GCC versions (4 and newer, including GCC 5–15), use
+ * the
+ * "gcc" parser instead.
+ * </p>
  *
  * @author Lorenz Munsch
  */
 class GccDescriptor extends ParserDescriptor {
     private static final String ID = "gcc3";
-    private static final String NAME = "GNU C Compiler 3 (gcc)";
+    private static final String NAME = "GNU C Compiler (Legacy, pre-GCC 4)";
 
     GccDescriptor() {
         super(ID, NAME);
@@ -20,4 +28,13 @@ class GccDescriptor extends ParserDescriptor {
     public IssueParser create(final Option... options) {
         return new GccParser();
     }
+
+    @Override
+    public String getHelp() {
+        return "Parses warnings and errors from legacy GCC compilers (versions older than GCC 4). "
+                + "This parser uses an older, simpler warning format.\n\n"
+                + "For modern GCC versions (GCC 4 and newer, including GCC 5–15), use the 'gcc' parser instead, "
+                + "which supports the newer format with additional context like:\n"
+                + "file.c:10:5: warning: unused variable 'x' [-Wunused-variable]";
+    }
 }