From: Jim Kingdon <jkingdon@engr.sgi.com>
Date: Tue, 29 Jun 1993 16:55:29 +0000 (+0000)
Subject: * symtab.h: Add comments about line numbers.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=025abdfbd3a4e93dd0812c695a36ecbeeae3f1f1;p=binutils-gdb.git

* symtab.h: Add comments about line numbers.
---

diff --git a/gdb/symtab.h b/gdb/symtab.h
index 4a9406ce89e..de0d1103667 100644
--- a/gdb/symtab.h
+++ b/gdb/symtab.h
@@ -722,10 +722,9 @@ struct symtab
 
     int nlines;
 
-    /* The Nth element of this array is the position of the
-       (N-1)th line of the source file.  "position" means something
-       we can lseek() to; it is not guaranteed to be useful any other
-       way.  */
+    /* line_charpos[N] is the position of the (N-1)th line of the
+       source file.  "position" means something we can lseek() to; it
+       is not guaranteed to be useful any other way.  */
 
     int *line_charpos;
 
@@ -988,7 +987,12 @@ install_minimal_symbols PARAMS ((struct objfile *));
 struct symtab_and_line
 {
   struct symtab *symtab;
+
+  /* Line number.  Line numbers start at 1 and proceed through symtab->nlines.
+     0 is never a valid line number; it is used to indicate that line number
+     information is not available.  */
   int line;
+
   CORE_ADDR pc;
   CORE_ADDR end;
 };