]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blobdiff - gdb/source.c
* config/sh/tm-sh.h (BELIEVE_PCC_PROMOTION): Define, so that
[thirdparty/binutils-gdb.git] / gdb / source.c
index 6126d5b1b900ebc07efa8951bb314f1aee883927..997cd1d89a6a505051b01f546bf00a50eeacb777 100644 (file)
@@ -1,35 +1,92 @@
 /* List lines of source files for GDB, the GNU debugger.
-   Copyright (C) 1986, 1987, 1988 Free Software Foundation, Inc.
-
-GDB is distributed in the hope that it will be useful, but WITHOUT ANY
-WARRANTY.  No author or distributor accepts responsibility to anyone
-for the consequences of using it or for whether it serves any
-particular purpose or works at all, unless he says so in writing.
-Refer to the GDB General Public License for full details.
-
-Everyone is granted permission to copy, modify and redistribute GDB,
-but only under the conditions described in the GDB General Public
-License.  A copy of this license is supposed to have been given to you
-along with GDB so you can know your rights and responsibilities.  It
-should be in a file named COPYING.  Among other things, the copyright
-notice and this notice must be preserved on all copies.
-
-In other words, go ahead and share GDB, but don't try to stop
-anyone else from sharing it farther.  Help stamp out software hoarding!
-*/
-
-#include <stdio.h>
-#include <sys/param.h>
-#include <sys/stat.h>
-#include <sys/file.h>
+   Copyright 1986, 87, 88, 89, 91, 92, 93, 94, 95, 96, 97, 1998
+   Free Software Foundation, Inc.
+
+This file is part of GDB.
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
+
 #include "defs.h"
-#include "initialize.h"
 #include "symtab.h"
+#include "expression.h"
+#include "language.h"
+#include "command.h"
+#include "gdbcmd.h"
+#include "frame.h"
+#include "value.h"
+
+#include <sys/types.h>
+#include "gdb_string.h"
+#include "gdb_stat.h"
+#include <fcntl.h>
+#ifdef HAVE_UNISTD_H
+#include <unistd.h>
+#endif
+#include "gdbcore.h"
+#include "gnu-regex.h"
+#include "symfile.h"
+#include "objfiles.h"
+#include "annotate.h"
+#include "gdbtypes.h"
+
+#ifdef CRLF_SOURCE_FILES
+
+/* Define CRLF_SOURCE_FILES in an xm-*.h file if source files on the
+   host use \r\n rather than just \n.  Defining CRLF_SOURCE_FILES is
+   much faster than defining LSEEK_NOT_LINEAR.  */
+
+#ifndef O_BINARY
+#define O_BINARY 0
+#endif
+
+#define OPEN_MODE (O_RDONLY | O_BINARY)
+#define FDOPEN_MODE FOPEN_RB
+
+#else /* ! defined (CRLF_SOURCE_FILES) */
+
+#define OPEN_MODE O_RDONLY
+#define FDOPEN_MODE FOPEN_RT
+
+#endif /* ! defined (CRLF_SOURCE_FILES) */
+
+/* Prototypes for local functions. */
+
+static int open_source_file PARAMS ((struct symtab *));
+
+static int get_filename_and_charpos PARAMS ((struct symtab *, char **));
+
+static void reverse_search_command PARAMS ((char *, int));
+
+static void forward_search_command PARAMS ((char *, int));
+
+static void line_info PARAMS ((char *, int));
+
+static void list_command PARAMS ((char *, int));
+
+static void ambiguous_line_spec PARAMS ((struct symtabs_and_lines *));
+
+static void source_info PARAMS ((char *, int));
+
+static void show_directories PARAMS ((char *, int));
+
+static void find_source_lines PARAMS ((struct symtab *, int));
 
 /* Path of directories to search for source files.
    Same format as the PATH environment variable's value.  */
 
-static char *source_path;
+char *source_path;
 
 /* Symtab of default file for listing lines of.  */
 
@@ -39,6 +96,14 @@ struct symtab *current_source_symtab;
 
 int current_source_line;
 
+/* Default number of lines to print with commands like "list".
+   This is based on guessing how many long (i.e. more than chars_per_line
+   characters) lines there will be.  To be completely correct, "list"
+   and friends should be rewritten to count characters and see where
+   things are wrapping, but that would be a fair amount of work.  */
+
+int lines_to_list = 10;
+
 /* Line number of last line printed.  Default for various commands.
    current_source_line is usually, but not always, the same as this.  */
 
@@ -48,170 +113,379 @@ static int last_line_listed;
 
 static int first_line_listed;
 
-START_FILE
 \f
-/* Set the source file default for the "list" command,
-   specifying a symtab.  */
+/* Set the source file default for the "list" command to be S.
+
+   If S is NULL, and we don't have a default, find one.  This
+   should only be called when the user actually tries to use the
+   default, since we produce an error if we can't find a reasonable
+   default.  Also, since this can cause symbols to be read, doing it
+   before we need to would make things slower than necessary.  */
 
 void
 select_source_symtab (s)
      register struct symtab *s;
 {
+  struct symtabs_and_lines sals;
+  struct symtab_and_line sal;
+  struct partial_symtab *ps;
+  struct partial_symtab *cs_pst = 0;
+  struct objfile *ofp;
+  
   if (s)
     {
-      struct symtabs_and_lines sals;
-      struct symtab_and_line sal;
+      current_source_symtab = s;
+      current_source_line = 1;
+      return;
+    }
+
+  if (current_source_symtab)
+    return;
 
-      /* Make the default place to list be the function `main'
-        if one exists.  */
-      if (lookup_symbol ("main", 0, VAR_NAMESPACE))
+  /* Make the default place to list be the function `main'
+     if one exists.  */
+  if (lookup_symbol ("main", 0, VAR_NAMESPACE, 0, NULL))
+    {
+      sals = decode_line_spec ("main", 1);
+      sal = sals.sals[0];
+      free (sals.sals);
+      current_source_symtab = sal.symtab;
+      current_source_line = max (sal.line - (lines_to_list - 1), 1);
+      if (current_source_symtab)
+        return;
+    }
+  
+  /* All right; find the last file in the symtab list (ignoring .h's).  */
+
+  current_source_line = 1;
+
+  for (ofp = object_files; ofp != NULL; ofp = ofp -> next)
+    {
+      for (s = ofp -> symtabs; s; s = s->next)
        {
-         sals = decode_line_spec ("main", 1);
-         sal = sals.sals[0];
-         free (sals.sals);
-         current_source_symtab = sal.symtab;
-         current_source_line = sal.line - 9;
-         return;
+         char *name = s -> filename;
+         int len = strlen (name);
+         if (! (len > 2 && (STREQ (&name[len - 2], ".h"))))
+           {
+             current_source_symtab = s;
+           }
        }
+    }
+  if (current_source_symtab)
+    return;
 
-      /* If there is no `main', use the last symtab in the list,
-        which is actually the first found in the file's symbol table.
-        But ignore .h files.  */
-      do
+  /* Howabout the partial symbol tables? */
+
+  for (ofp = object_files; ofp != NULL; ofp = ofp -> next)
+    {
+      for (ps = ofp -> psymtabs; ps != NULL; ps = ps -> next)
        {
-         char *name = s->filename;
+         char *name = ps -> filename;
          int len = strlen (name);
-         if (! (len > 2 && !strcmp (&name[len - 2], ".h")))
-           current_source_symtab = s;
-         s = s->next;
+         if (! (len > 2 && (STREQ (&name[len - 2], ".h"))))
+           {
+             cs_pst = ps;
+           }
+       }
+    }
+  if (cs_pst)
+    {
+      if (cs_pst -> readin)
+       {
+         fatal ("Internal: select_source_symtab: readin pst found and no symtabs.");
+       }
+      else
+       {
+         current_source_symtab = PSYMTAB_TO_SYMTAB (cs_pst);
        }
-      while (s);
-      current_source_line = 1;
     }
+  if (current_source_symtab)
+    return;
+
+  error ("Can't find a default source file");
 }
 \f
 static void
-directories_info ()
+show_directories (ignore, from_tty)
+     char *ignore;
+     int from_tty;
 {
-  printf ("Source directories searched: %s\n", source_path);
+  puts_filtered ("Source directories searched: ");
+  puts_filtered (source_path);
+  puts_filtered ("\n");
 }
 
+/* Forget what we learned about line positions in source files, and
+   which directories contain them; must check again now since files
+   may be found in a different directory now.  */
+
 void
-init_source_path ()
+forget_cached_source_info ()
 {
   register struct symtab *s;
+  register struct objfile *objfile;
+
+  for (objfile = object_files; objfile != NULL; objfile = objfile -> next)
+    {
+      for (s = objfile -> symtabs; s != NULL; s = s -> next)
+       {
+         if (s -> line_charpos != NULL)
+           {
+             mfree (objfile -> md, s -> line_charpos);
+             s -> line_charpos = NULL;
+           }
+         if (s -> fullname != NULL)
+           {
+             mfree (objfile -> md, s -> fullname);
+             s -> fullname = NULL;
+           }
+       }
+    }
+}
 
-  source_path = savestring (current_directory, strlen (current_directory));
+void
+init_source_path ()
+{
+  char buf[20];
 
-  /* Forget what we learned about line positions in source files;
-     must check again now since files may be found in
-     a different directory now.  */
-  for (s = symtab_list; s; s = s->next)
-    if (s->line_charpos != 0)
-      {
-       free (s->line_charpos);
-       s->line_charpos = 0;
-      }
+  sprintf (buf, "$cdir%c$cwd", DIRNAME_SEPARATOR);
+  source_path = strsave (buf);
+  forget_cached_source_info ();
 }
 
+/* Add zero or more directories to the front of the source path.  */
 void
 directory_command (dirname, from_tty)
      char *dirname;
      int from_tty;
 {
-  char *old = source_path;
-
+  dont_repeat ();
+  /* FIXME, this goes to "delete dir"... */
   if (dirname == 0)
     {
-      if (query ("Reinitialize source path to %s? ", current_directory))
+      if (query ("Reinitialize source path to empty? "))
        {
+         free (source_path);
          init_source_path ();
-         free (old);
        }
     }
   else
+    mod_path (dirname, &source_path);
+  if (from_tty)
+    show_directories ((char *)0, from_tty);
+  forget_cached_source_info ();
+}
+
+/* Add zero or more directories to the front of an arbitrary path.  */
+
+void
+mod_path (dirname, which_path)
+     char *dirname;
+     char **which_path;
+{
+  char *old = *which_path;
+  int prefix = 0;
+
+  if (dirname == 0)
+    return;
+
+  dirname = strsave (dirname);
+  make_cleanup (free, dirname);
+
+  do
     {
+      char *name = dirname;
+      register char *p;
       struct stat st;
-      register int len = strlen (dirname);
-      register char *tem;
-      extern char *index ();
 
-      if (index (dirname, ':'))
-       error ("Please add one directory at a time to the source path.");
-      if (dirname[len - 1] == '/')
-         /* Sigh. "foo/" => "foo" */
-         dirname[--len] == '\0';
+      {
+       char *separator = strchr (name, DIRNAME_SEPARATOR);
+       char *space = strchr (name, ' ');
+       char *tab = strchr (name, '\t');
+
+       if (separator == 0 && space == 0 && tab ==  0)
+         p = dirname = name + strlen (name);
+       else
+         {
+           p = 0;
+           if (separator != 0 && (p == 0 || separator < p))
+             p = separator;
+           if (space != 0 && (p == 0 || space < p))
+             p = space;
+           if (tab != 0 && (p == 0 || tab < p))
+             p = tab;
+           dirname = p + 1;
+           while (*dirname == DIRNAME_SEPARATOR
+                  || *dirname == ' '
+                  || *dirname == '\t')
+             ++dirname;
+         }
+      }
 
-      while (dirname[len - 1] == '.')
+#ifndef WIN32 
+      /* On win32 h:\ is different to h: */
+      if (SLASH_P (p[-1]))
+       /* Sigh. "foo/" => "foo" */
+       --p;
+#endif
+      *p = '\0';
+
+      while (p[-1] == '.')
        {
-         if (len == 1)
+         if (p - name == 1)
            {
-             /* "." => getwd () */
-             dirname = current_directory;
+             /* "." => getwd () */
+             name = current_directory;
              goto append;
            }
-         else if (dirname[len - 2] == '/')
+         else if (SLASH_P (p[-2]))
            {
-             if (len == 2)
+             if (p - name == 2)
                {
-                 /* "/." => "/" */
-                 dirname[--len] = '\0';
+                 /* "/." => "/" */
+                 *--p = '\0';
                  goto append;
                }
              else
                {
-                 /* "...foo/." => "...foo" */
-                 dirname[len -= 2] = '\0';
+                 /* "...foo/." => "...foo".  */
+                 p -= 2;
+                 *p = '\0';
                  continue;
                }
            }
-         break;
+         else
+           break;
        }
 
-      if (dirname[0] != '/')
-       dirname = concat (current_directory, "/", dirname);
+      if (name[0] == '~')
+       name = tilde_expand (name);
+      else if (!ROOTED_P (name) && name[0] != '$') 
+         name = concat (current_directory, SLASH_STRING, name, NULL);
       else
-       dirname = savestring (dirname, len);
-      make_cleanup (free, dirname);
-
-      if (stat (dirname, &st) < 0)
-       perror_with_name (dirname);
-      if ((st.st_mode & S_IFMT) != S_IFDIR)
-       error ("%s is not a directory.", dirname);
+       name = savestring (name, p - name);
+      make_cleanup (free, name);
+
+      /* Unless it's a variable, check existence.  */
+      if (name[0] != '$') {
+       /* These are warnings, not errors, since we don't want a
+          non-existent directory in a .gdbinit file to stop processing
+          of the .gdbinit file.
+
+          Whether they get added to the path is more debatable.  Current
+          answer is yes, in case the user wants to go make the directory
+          or whatever.  If the directory continues to not exist/not be
+          a directory/etc, then having them in the path should be
+          harmless.  */
+       if (stat (name, &st) < 0)
+         {
+           int save_errno = errno;
+           fprintf_unfiltered (gdb_stderr, "Warning: ");
+           print_sys_errmsg (name, save_errno);
+         }
+       else if ((st.st_mode & S_IFMT) != S_IFDIR)
+         warning ("%s is not a directory.", name);
+      }
 
     append:
-      len = strlen (dirname);
-      tem = source_path;
-      while (1)
-       {
-         if (!strncmp (tem, dirname, len)
-             && (tem[len] == '\0' || tem[len] == ':'))
-           {
-             printf ("\"%s\" is already in the source path.\n",
-                     dirname);
-             break;
-           }
-         tem = index (tem, ':');
-         if (tem)
-           tem++;
-         else
-           {
-             source_path = concat (old, ":", dirname);
-             free (old);
+      {
+       register unsigned int len = strlen (name);
+
+       p = *which_path;
+       while (1)
+         {
+           if (!strncmp (p, name, len)
+               && (p[len] == '\0' || p[len] == DIRNAME_SEPARATOR))
+             {
+               /* Found it in the search path, remove old copy */
+               if (p > *which_path)
+                 p--;                  /* Back over leading separator */
+               if (prefix > p - *which_path)
+                 goto skip_dup;        /* Same dir twice in one cmd */
+               strcpy (p, &p[len+1]);  /* Copy from next \0 or  : */
+             }
+           p = strchr (p, DIRNAME_SEPARATOR);
+           if (p != 0)
+             ++p;
+           else
              break;
-           }
-       }
-      if (from_tty)
-       directories_info ();
+         }
+       if (p == 0)
+         {
+           char tinybuf[2];
+
+           tinybuf[0] = DIRNAME_SEPARATOR;
+           tinybuf[1] = '\0';
+
+           /* If we have already tacked on a name(s) in this command,                     be sure they stay on the front as we tack on some more.  */
+           if (prefix)
+             {
+               char *temp, c;
+
+               c = old[prefix];
+               old[prefix] = '\0';
+               temp = concat (old, tinybuf, name, NULL);
+               old[prefix] = c;
+               *which_path = concat (temp, "", &old[prefix], NULL);
+               prefix = strlen (temp);
+               free (temp);
+             }
+           else
+             {
+               *which_path = concat (name, (old[0] ? tinybuf : old), old, NULL);
+               prefix = strlen (name);
+             }
+           free (old);
+           old = *which_path;
+         }
+      }
+  skip_dup: ;
+    } while (*dirname != '\0');
+}
+
+
+static void
+source_info (ignore, from_tty)
+     char *ignore;
+     int from_tty;
+{
+  register struct symtab *s = current_source_symtab;
+
+  if (!s)
+    {
+      printf_filtered("No current source file.\n");
+      return;
     }
+  printf_filtered ("Current source file is %s\n", s->filename);
+  if (s->dirname)
+    printf_filtered ("Compilation directory is %s\n", s->dirname);
+  if (s->fullname)
+    printf_filtered ("Located in %s\n", s->fullname);
+  if (s->nlines)
+    printf_filtered ("Contains %d line%s.\n", s->nlines,
+                    s->nlines == 1 ? "" : "s");
+
+  printf_filtered ("Source language is %s.\n", language_str (s->language));
+  printf_filtered ("Compiled with %s debugging format.\n", s->debugformat);
 }
+
+
 \f
-/* Open a file named STRING, searching path PATH (dir names sep by colons)
+/* Open a file named STRING, searching path PATH (dir names sep by some char)
    using mode MODE and protection bits PROT in the calls to open.
+
    If TRY_CWD_FIRST, try to open ./STRING before searching PATH.
-   (ie pretend the first element of PATH is ".")
+   (ie pretend the first element of PATH is ".").  This also indicates
+   that a slash in STRING disables searching of the path (this is
+   so that "exec-file ./foo" or "symbol-file ./foo" insures that you
+   get that particular version of foo or an error message).
+
    If FILENAMED_OPENED is non-null, set it to a newly allocated string naming
-   the actual file opened (this string will always start with a "/"
+   the actual file opened (this string will always start with a "/".  We
+   have to take special pains to avoid doubling the "/" between the directory
+   and the file, sigh!  Emacs gets confuzzed by this when we print the
+   source file name!!! 
 
    If a file is found, return the descriptor.
    Otherwise, return -1, with errno set for the last name we tried to open.  */
@@ -231,51 +505,217 @@ openp (path, try_cwd_first, string, mode, prot, filename_opened)
   register char *filename;
   register char *p, *p1;
   register int len;
+  int alloclen;
 
-  /* ./foo => foo */
-  while (string[0] == '.' && string[1] == '/')
-    string += 2;
+  if (!path)
+    path = ".";
 
-  if (try_cwd_first || string[0] == '/')
+#ifdef WIN32
+  mode |= O_BINARY;
+#endif
+
+  if (try_cwd_first || SLASH_P (string[0]))
     {
+      int i;
       filename = string;
       fd = open (filename, mode, prot);
-      if (fd >= 0 || string[0] == '/')
+      if (fd >= 0)
        goto done;
+      for (i = 0; string[i]; i++)
+       if (SLASH_P (string[i]))
+         goto done;
     }
 
-  filename = (char *) alloca (strlen (path) + strlen (string) + 2);
+  /* ./foo => foo */
+  while (string[0] == '.' && SLASH_P (string[1]))
+    string += 2;
+
+  alloclen = strlen (path) + strlen (string) + 2;
+  filename = (char *) alloca (alloclen);
   fd = -1;
   for (p = path; p; p = p1 ? p1 + 1 : 0)
     {
-      p1 = (char *) index (p, ':');
+      p1 = (char *) strchr (p, DIRNAME_SEPARATOR);
       if (p1)
        len = p1 - p;
       else
        len = strlen (p);
 
-      strncpy (filename, p, len);
-      filename[len] = 0;
-      strcat (filename, "/");
+      if (len == 4 && p[0] == '$' && p[1] == 'c'
+         && p[2] == 'w' && p[3] == 'd') {
+       /* Name is $cwd -- insert current directory name instead.  */
+       int newlen;
+
+       /* First, realloc the filename buffer if too short. */
+       len = strlen (current_directory);
+       newlen = len + strlen (string) + 2;
+       if (newlen > alloclen) {
+         alloclen = newlen;
+         filename = (char *) alloca (alloclen);
+       }
+       strcpy (filename, current_directory);
+      } else {
+       /* Normal file name in path -- just use it.  */
+       strncpy (filename, p, len);
+       filename[len] = 0;
+      }
+
+      /* Remove trailing slashes */
+      while (len > 0 && SLASH_P (filename[len-1]))
+       filename[--len] = 0;
+
+      strcat (filename+len, SLASH_STRING);
       strcat (filename, string);
 
-      fd = open (filename, mode, prot);
+      fd = open (filename, mode);
       if (fd >= 0) break;
     }
 
  done:
   if (filename_opened)
-    if (fd < 0)
-      *filename_opened = (char *) 0;
-    else if (filename[0] == '/')
-      *filename_opened = savestring (filename, strlen (filename));
-    else
+    {
+      if (fd < 0)
+       *filename_opened = (char *) 0;
+      else if (ROOTED_P (filename))
+       *filename_opened = savestring (filename, strlen (filename));
+      else
+       {
+         /* Beware the // my son, the Emacs barfs, the botch that catch... */
+         
+         *filename_opened = concat (current_directory, 
+                                    SLASH_CHAR
+                                    == current_directory[strlen(current_directory)-1] 
+                                    ? "": SLASH_STRING,
+                                    filename, NULL);
+        }
+    }
+#ifdef MPW
+  /* This is a debugging hack that can go away when all combinations
+     of Mac and Unix names are handled reasonably.  */
+  {
+    extern int debug_openp;
+
+    if (debug_openp)
       {
-       *filename_opened = concat (current_directory, "/", filename);
+       printf("openp on %s, path %s mode %d prot %d\n  returned %d",
+              string, path, mode, prot, fd);
+       if (*filename_opened)
+         printf(" (filename is %s)", *filename_opened);
+       printf("\n");
       }
+  }
+#endif /* MPW */
 
   return fd;
 }
+
+/* Open a source file given a symtab S.  Returns a file descriptor or
+   negative number for error.  */
+
+static int
+open_source_file (s)
+     struct symtab *s;
+{
+  char *path = source_path;
+  char *p;
+  int result;
+  char *fullname;
+
+  /* Quick way out if we already know its full name */
+  if (s->fullname) 
+    {
+      result = open (s->fullname, OPEN_MODE);
+      if (result >= 0)
+        return result;
+      /* Didn't work -- free old one, try again. */
+      mfree (s->objfile->md, s->fullname);
+      s->fullname = NULL;
+    }
+
+  if (s->dirname != NULL)
+    {
+      /* Replace a path entry of  $cdir  with the compilation directory name */
+#define        cdir_len        5
+      /* We cast strstr's result in case an ANSIhole has made it const,
+        which produces a "required warning" when assigned to a nonconst. */
+      p = (char *)strstr (source_path, "$cdir");
+      if (p && (p == path || p[-1] == DIRNAME_SEPARATOR)
+           && (p[cdir_len] == DIRNAME_SEPARATOR || p[cdir_len] == '\0'))
+       {
+         int len;
+
+         path = (char *)
+           alloca (strlen (source_path) + 1 + strlen (s->dirname) + 1);
+         len = p - source_path;
+         strncpy (path, source_path, len);             /* Before $cdir */
+         strcpy (path + len, s->dirname);              /* new stuff */
+         strcat (path + len, source_path + len + cdir_len); /* After $cdir */
+       }
+    }
+
+  result = openp (path, 0, s->filename, OPEN_MODE, 0, &s->fullname);
+  if (result < 0)
+    {
+      /* Didn't work.  Try using just the basename. */
+      p = basename (s->filename);
+      if (p != s->filename)
+       result = openp (path, 0, p, OPEN_MODE, 0, &s->fullname);
+    }
+#ifdef MPW
+  if (result < 0)
+    {
+      /* Didn't work.  Try using just the MPW basename. */
+      p = (char *) mpw_basename (s->filename);
+      if (p != s->filename)
+       result = openp (path, 0, p, OPEN_MODE, 0, &s->fullname);
+    }
+  if (result < 0)
+    {
+      /* Didn't work.  Try using the mixed Unix/MPW basename. */
+      p = (char *) mpw_mixed_basename (s->filename);
+      if (p != s->filename)
+       result = openp (path, 0, p, OPEN_MODE, 0, &s->fullname);
+    }
+#endif /* MPW */
+
+  if (result >= 0)
+    {
+      fullname = s->fullname;
+      s->fullname = mstrsave (s->objfile->md, s->fullname);
+      free (fullname);
+    }
+  return result;
+}
+
+/* Return the path to the source file associated with symtab.  Returns NULL
+   if no symtab.  */
+
+char *
+symtab_to_filename (s)
+     struct symtab *s;
+{
+  int fd;
+
+  if (!s)
+    return NULL;
+
+  /* If we've seen the file before, just return fullname. */
+
+  if (s->fullname)
+    return s->fullname;
+
+  /* Try opening the file to setup fullname */
+
+  fd = open_source_file (s);
+  if (fd < 0)
+    return s->filename;                /* File not found.  Just use short name */
+
+  /* Found the file.  Cleanup and return the full name */
+
+  close (fd);
+  return s->fullname;
+}
+
 \f
 /* Create and initialize the table S->line_charpos that records
    the positions of the lines in the source file, which is assumed
@@ -291,41 +731,103 @@ find_source_lines (s, desc)
   register char *data, *p, *end;
   int nlines = 0;
   int lines_allocated = 1000;
-  int *line_charpos = (int *) xmalloc (lines_allocated * sizeof (int));
-  extern int exec_mtime;
-
-  fstat (desc, &st);
-  if (get_exec_file (0) != 0 && exec_mtime < st.st_mtime)
-    printf ("Source file is more recent than executable.\n");
-
-  data = (char *) alloca (st.st_size);
-  myread (desc, data, st.st_size);
-  end = data + st.st_size;
-  p = data;
-  line_charpos[0] = 0;
-  nlines = 1;
-  while (p != end)
-    {
-      if (*p++ == '\n'
-         /* A newline at the end does not start a new line.  */
-         && p != end)
-       {
-         if (nlines == lines_allocated)
-           {
-             lines_allocated *= 2;
-             line_charpos = (int *) xrealloc (line_charpos,
-                                              sizeof (int) * lines_allocated);
-           }
-         line_charpos[nlines++] = p - data;
-       }
+  int *line_charpos;
+  long mtime;
+  int size;
+
+  line_charpos = (int *) xmmalloc (s -> objfile -> md,
+                                  lines_allocated * sizeof (int));
+  if (fstat (desc, &st) < 0)
+    perror_with_name (s->filename);
+
+  if (s && s->objfile && s->objfile->obfd)
+    {
+      mtime = bfd_get_mtime(s->objfile->obfd);
+      if (mtime && mtime < st.st_mtime)
+       printf_filtered ("Source file is more recent than executable.\n");
+    }
+  else if (exec_bfd)
+    {
+      mtime = bfd_get_mtime(exec_bfd);
+      if (mtime && mtime < st.st_mtime)
+       printf_filtered ("Source file is more recent than executable.\n");
     }
+
+#ifdef LSEEK_NOT_LINEAR
+  {
+    char c;
+
+    /* Have to read it byte by byte to find out where the chars live */
+
+    line_charpos[0] = lseek (desc, 0, SEEK_CUR);
+    nlines = 1;
+    while (myread(desc, &c, 1)>0) 
+      {
+       if (c == '\n') 
+         {
+           if (nlines == lines_allocated) 
+             {
+               lines_allocated *= 2;
+               line_charpos =
+                 (int *) xmrealloc (s -> objfile -> md, (char *) line_charpos,
+                                    sizeof (int) * lines_allocated);
+             }
+           line_charpos[nlines++] = lseek (desc, 0, SEEK_CUR);
+         }
+      }
+  }
+#else /* lseek linear.  */
+  {
+    struct cleanup *old_cleanups;
+
+    /* st_size might be a large type, but we only support source files whose 
+       size fits in an int.  */
+    size = (int) st.st_size;
+
+    /* Use malloc, not alloca, because this may be pretty large, and we may
+       run into various kinds of limits on stack size.  */
+    data = (char *) xmalloc (size);
+    old_cleanups = make_cleanup (free, data);
+
+    /* Reassign `size' to result of read for systems where \r\n -> \n.  */
+    size = myread (desc, data, size);
+    if (size < 0)
+      perror_with_name (s->filename);
+    end = data + size;
+    p = data;
+    line_charpos[0] = 0;
+    nlines = 1;
+    while (p != end)
+      {
+       if (*p++ == '\n'
+           /* A newline at the end does not start a new line.  */
+           && p != end)
+         {
+           if (nlines == lines_allocated)
+             {
+               lines_allocated *= 2;
+               line_charpos =
+                 (int *) xmrealloc (s -> objfile -> md, (char *) line_charpos,
+                                    sizeof (int) * lines_allocated);
+             }
+           line_charpos[nlines++] = p - data;
+         }
+      }
+    do_cleanups (old_cleanups);
+  }
+#endif /* lseek linear.  */
   s->nlines = nlines;
-  s->line_charpos = (int *) xrealloc (line_charpos, nlines * sizeof (int));
+  s->line_charpos =
+   (int *) xmrealloc (s -> objfile -> md, (char *) line_charpos,
+                     nlines * sizeof (int));
+
 }
 
 /* Return the character position of a line LINE in symtab S.
    Return 0 if anything is invalid.  */
 
+#if 0  /* Currently unused */
+
 int
 source_line_charpos (s, line)
      struct symtab *s;
@@ -360,21 +862,23 @@ source_charpos_line (s, chr)
     line = s->nlines;
   return line;
 }
+
+#endif /* 0 */
+
 \f
 /* Get full pathname and line number positions for a symtab.
    Return nonzero if line numbers may have changed.
    Set *FULLNAME to actual name of the file as found by `openp',
    or to 0 if the file is not found.  */
 
-int
-get_filename_and_charpos (s, line, fullname)
+static int
+get_filename_and_charpos (s, fullname)
      struct symtab *s;
-     int line;
      char **fullname;
 {
   register int desc, linenums_changed = 0;
   
-  desc = openp (source_path, 0, s->filename, O_RDONLY, 0, &s->fullname);
+  desc = open_source_file (s);
   if (desc < 0)
     {
       if (fullname)
@@ -399,18 +903,22 @@ get_filename_and_charpos (s, line, fullname)
    Return 1 if successful, 0 if could not find the file.  */
 
 int
-identify_source_line (s, line, mid_statement)
+identify_source_line (s, line, mid_statement, pc)
      struct symtab *s;
      int line;
      int mid_statement;
+     CORE_ADDR pc;
 {
   if (s->line_charpos == 0)
-    get_filename_and_charpos (s, line, 0);
+    get_filename_and_charpos (s, (char **)NULL);
   if (s->fullname == 0)
     return 0;
-  printf ("\032\032%s:%d:%d:%s\n", s->fullname,
-         line, s->line_charpos[line - 1],
-         mid_statement ? "middle" : "beg");
+  if (line > s->nlines)
+    /* Don't index off the end of the line_charpos array.  */
+    return 0;
+  annotate_source (s->fullname, line, s->line_charpos[line - 1],
+                  mid_statement, pc);
+
   current_source_line = line;
   first_line_listed = line;
   last_line_listed = line;
@@ -432,13 +940,19 @@ print_source_lines (s, line, stopline, noerror)
   register FILE *stream;
   int nlines = stopline - line;
 
-  desc = openp (source_path, 0, s->filename, O_RDONLY, 0, &s->fullname);
+  /* Regardless of whether we can open the file, set current_source_symtab. */
+  current_source_symtab = s;
+  current_source_line = line;
+  first_line_listed = line;
+
+  desc = open_source_file (s);
   if (desc < 0)
     {
-      extern int errno;
-      if (! noerror)
-       perror_with_name (s->filename);
-      print_sys_errmsg (s->filename, errno);
+      if (! noerror) {
+       char *name = alloca (strlen (s->filename) + 100);
+       sprintf (name, "%s:%d", s->filename, line);
+        print_sys_errmsg (name, errno);
+      }
       return;
     }
 
@@ -448,8 +962,8 @@ print_source_lines (s, line, stopline, noerror)
   if (line < 1 || line > s->nlines)
     {
       close (desc);
-      error ("Line number out of range; %s has %d lines.",
-            s->filename, s->nlines);
+      error ("Line number %d out of range; %s has %d lines.",
+            line, s->filename, s->nlines);
     }
 
   if (lseek (desc, s->line_charpos[line - 1], 0) < 0)
@@ -458,11 +972,7 @@ print_source_lines (s, line, stopline, noerror)
       perror_with_name (s->filename);
     }
 
-  current_source_symtab = s;
-  current_source_line = line;
-  first_line_listed = line;
-  
-  stream = fdopen (desc, "r");
+  stream = fdopen (desc, FDOPEN_MODE);
   clearerr (stream);
 
   while (nlines-- > 0)
@@ -470,24 +980,45 @@ print_source_lines (s, line, stopline, noerror)
       c = fgetc (stream);
       if (c == EOF) break;
       last_line_listed = current_source_line;
-      printf ("%d\t", current_source_line++);
+      printf_filtered ("%d\t", current_source_line++);
       do
        {
-         if (c < 040 && c != '\t' && c != '\n')
+         if (c < 040 && c != '\t' && c != '\n' && c != '\r')
+             printf_filtered ("^%c", c + 0100);
+         else if (c == 0177)
+           printf_filtered ("^?");
+#ifdef CRLF_SOURCE_FILES
+         else if (c == '\r')
            {
-             fputc ('^', stdout);
-             fputc (c + 0100, stdout);
+             /* Just skip \r characters.  */
            }
-         else if (c == 0177)
-           printf ("^?");
+#endif
          else
-           fputc (c, stdout);
+           printf_filtered ("%c", c);
        } while (c != '\n' && (c = fgetc (stream)) >= 0);
     }
 
   fclose (stream);
 }
 \f
+
+
+/* Print a list of files and line numbers which a user may choose from
+  in order to list a function which was specified ambiguously (as with
+  `list classname::overloadedfuncname', for example).  The vector in
+  SALS provides the filenames and line numbers.  */
+
+static void
+ambiguous_line_spec (sals)
+     struct symtabs_and_lines *sals;
+{
+  int i;
+
+  for (i = 0; i < sals->nelts; ++i)
+    printf_filtered("file: \"%s\", line number: %d\n",
+                   sals->sals[i].symtab->filename, sals->sals[i].line);
+}
+
 static void
 list_command (arg, from_tty)
      char *arg;
@@ -503,27 +1034,32 @@ list_command (arg, from_tty)
   int linenum_beg = 0;
   char *p;
 
-  if (symtab_list == 0)
-    error ("Listing source lines requires symbols.");
+  if (!have_full_symbols () && !have_partial_symbols())
+    error ("No symbol table is loaded.  Use the \"file\" command.");
+
+  /* Pull in a current source symtab if necessary */
+  if (current_source_symtab == 0 &&
+      (arg == 0 || arg[0] == '+' || arg[0] == '-'))
+    select_source_symtab (0);
 
   /* "l" or "l +" lists next ten lines.  */
 
-  if (arg == 0 || !strcmp (arg, "+"))
+  if (arg == 0 || STREQ (arg, "+"))
     {
       if (current_source_symtab == 0)
        error ("No default source file yet.  Do \"help list\".");
       print_source_lines (current_source_symtab, current_source_line,
-                         current_source_line + 10, 0);
+                         current_source_line + lines_to_list, 0);
       return;
     }
 
   /* "l -" lists previous ten lines, the ones before the ten just listed.  */
-  if (!strcmp (arg, "-"))
+  if (STREQ (arg, "-"))
     {
       if (current_source_symtab == 0)
        error ("No default source file yet.  Do \"help list\".");
       print_source_lines (current_source_symtab,
-                         max (first_line_listed - 10, 1),
+                         max (first_line_listed - lines_to_list, 1),
                          first_line_listed, 0);
       return;
     }
@@ -539,12 +1075,14 @@ list_command (arg, from_tty)
     dummy_beg = 1;
   else
     {
-      sals = decode_line_1 (&arg1, 0, 0, 0);
+      sals = decode_line_1 (&arg1, 0, 0, 0, 0);
 
       if (! sals.nelts) return;  /*  C++  */
-      if (sals.nelts != 1)
+      if (sals.nelts > 1)
        {
-         error ("Unreasonable listing request");
+         ambiguous_line_spec (&sals);
+         free (sals.sals);
+         return;
        }
 
       sal = sals.sals[0];
@@ -569,10 +1107,17 @@ list_command (arg, from_tty)
       else
        {
          if (dummy_beg)
-           sals_end = decode_line_1 (&arg1, 0, 0, 0);
+           sals_end = decode_line_1 (&arg1, 0, 0, 0, 0);
          else
-           sals_end = decode_line_1 (&arg1, 0, sal.symtab, sal.line);
-         if (! sals_end.nelts) return;  /* C++ */
+           sals_end = decode_line_1 (&arg1, 0, sal.symtab, sal.line, 0);
+         if (sals_end.nelts == 0) 
+           return;
+         if (sals_end.nelts > 1)
+           {
+             ambiguous_line_spec (&sals_end);
+             free (sals_end.sals);
+             return;
+           }
          sal_end = sals_end.sals[0];
          free (sals_end.sals);
        }
@@ -594,14 +1139,23 @@ list_command (arg, from_tty)
   if (*arg == '*')
     {
       if (sal.symtab == 0)
-       error ("No source file for address 0x%x.", sal.pc);
+       /* FIXME-32x64--assumes sal.pc fits in long.  */
+       error ("No source file for address %s.",
+               local_hex_string((unsigned long) sal.pc));
       sym = find_pc_function (sal.pc);
       if (sym)
-       printf ("0x%x is in %s (%s, line %d).\n",
-               sal.pc, SYMBOL_NAME (sym), sal.symtab->filename, sal.line);
+       {
+         print_address_numeric (sal.pc, 1, gdb_stdout);
+         printf_filtered (" is in ");
+         fputs_filtered (SYMBOL_SOURCE_NAME (sym), gdb_stdout);
+         printf_filtered (" (%s:%d).\n", sal.symtab->filename, sal.line);
+       }
       else
-       printf ("0x%x is in %s, line %d.\n",
-               sal.pc, sal.symtab->filename, sal.line);
+       {
+         print_address_numeric (sal.pc, 1, gdb_stdout);
+         printf_filtered (" is at %s:%d.\n",
+                          sal.symtab->filename, sal.line);
+       }
     }
 
   /* If line was not specified by just a line number,
@@ -620,15 +1174,21 @@ list_command (arg, from_tty)
   if (dummy_beg && sal_end.symtab == 0)
     error ("No default source file yet.  Do \"help list\".");
   if (dummy_beg)
-    print_source_lines (sal_end.symtab, max (sal_end.line - 9, 1),
+    print_source_lines (sal_end.symtab,
+                       max (sal_end.line - (lines_to_list - 1), 1),
                        sal_end.line + 1, 0);
   else if (sal.symtab == 0)
     error ("No default source file yet.  Do \"help list\".");
   else if (no_end)
-    print_source_lines (sal.symtab, max (sal.line - 5, 1), sal.line + 5, 0);
+    print_source_lines (sal.symtab,
+                       max (sal.line - (lines_to_list / 2), 1),
+                       sal.line + (lines_to_list / 2), 0);
   else
     print_source_lines (sal.symtab, sal.line,
-                       dummy_end ? sal.line + 10 : sal_end.line + 1, 0);
+                       (dummy_end
+                        ? sal.line + lines_to_list
+                        : sal_end.line + 1),
+                       0);
 }
 \f
 /* Print info on range of pc's in a specified line.  */
@@ -640,57 +1200,103 @@ line_info (arg, from_tty)
 {
   struct symtabs_and_lines sals;
   struct symtab_and_line sal;
-  int start_pc, end_pc;
+  CORE_ADDR start_pc, end_pc;
+  int i;
+
+  INIT_SAL (&sal);     /* initialize to zeroes */
 
   if (arg == 0)
     {
       sal.symtab = current_source_symtab;
       sal.line = last_line_listed;
+      sals.nelts = 1;
+      sals.sals = (struct symtab_and_line *)
+       xmalloc (sizeof (struct symtab_and_line));
+      sals.sals[0] = sal;
     }
   else
     {
-      sals = decode_line_spec (arg);
-
-      if (sals.nelts == 0)
-       return;                 /* C++ */
-      if (sals.nelts != 1)
-       error ("unreasonable line info request");
+      sals = decode_line_spec_1 (arg, 0);
       
-      sal = sals.sals[0];
-      free (sals.sals);
-      /* If this command is repeated with RET,
-        turn it into the no-arg variant.  */
-
-      if (from_tty)
-       *arg = 0;
+      dont_repeat ();
     }
 
-  if (sal.symtab == 0)
-    error ("No source file specified.");
-  if (sal.line > 0
-      && find_line_pc_range (sal.symtab, sal.line, &start_pc, &end_pc))
+  /* C++  More than one line may have been specified, as when the user
+     specifies an overloaded function name. Print info on them all. */
+  for (i = 0; i < sals.nelts; i++)
     {
-      if (start_pc == end_pc)
-       printf ("Line %d of \"%s\" is at pc 0x%x but contains no code.\n",
-               sal.line, sal.symtab->filename, start_pc);
+      sal = sals.sals[i];
+      
+      if (sal.symtab == 0)
+       {
+         printf_filtered ("No line number information available");
+         if (sal.pc != 0)
+           {
+             /* This is useful for "info line *0x7f34".  If we can't tell the
+                user about a source line, at least let them have the symbolic
+                address.  */
+             printf_filtered (" for address ");
+             wrap_here ("  ");
+             print_address (sal.pc, gdb_stdout);
+           }
+         else
+           printf_filtered (".");
+         printf_filtered ("\n");
+       }
+      else if (sal.line > 0
+              && find_line_pc_range (sal, &start_pc, &end_pc))
+       {
+         if (start_pc == end_pc)
+           {
+             printf_filtered ("Line %d of \"%s\"",
+                              sal.line, sal.symtab->filename);
+             wrap_here ("  ");
+             printf_filtered (" is at address ");
+             print_address (start_pc, gdb_stdout);
+             wrap_here ("  ");
+             printf_filtered (" but contains no code.\n");
+           }
+         else
+           {
+             printf_filtered ("Line %d of \"%s\"",
+                              sal.line, sal.symtab->filename);
+             wrap_here ("  ");
+             printf_filtered (" starts at address ");
+             print_address (start_pc, gdb_stdout);
+             wrap_here ("  ");
+             printf_filtered (" and ends at ");
+             print_address (end_pc, gdb_stdout);
+             printf_filtered (".\n");
+           }
+
+         /* x/i should display this line's code.  */
+         set_next_address (start_pc);
+
+         /* Repeating "info line" should do the following line.  */
+         last_line_listed = sal.line + 1;
+
+         /* If this is the only line, show the source code.  If it could
+            not find the file, don't do anything special.  */
+         if (annotation_level && sals.nelts == 1)
+           identify_source_line (sal.symtab, sal.line, 0, start_pc);
+       }
       else
-       printf ("Line %d of \"%s\" starts at pc 0x%x and ends at 0x%x.\n",
-               sal.line, sal.symtab->filename, start_pc, end_pc);
-      /* x/i should display this line's code.  */
-      set_next_address (start_pc);
-      /* Repeating "info line" should do the following line.  */
-      last_line_listed = sal.line + 1;
+       /* Is there any case in which we get here, and have an address
+          which the user would want to see?  If we have debugging symbols
+          and no line numbers?  */
+       printf_filtered ("Line number %d is out of range for \"%s\".\n",
+                        sal.line, sal.symtab->filename);
     }
-  else
-    printf ("Line number %d is out of range for \"%s\".\n",
-           sal.line, sal.symtab->filename);
+  free (sals.sals);
 }
 \f
 /* Commands to search the source file for a regexp.  */
 
+/* ARGSUSED */
 static void
 forward_search_command (regex, from_tty)
      char *regex;
+     int from_tty;
 {
   register int c;
   register int desc;
@@ -702,13 +1308,12 @@ forward_search_command (regex, from_tty)
   if (msg)
     error (msg);
 
-  if (current_source_symtab == 0) 
-    error ("No default source file yet.  Do \"help list\".");
+  if (current_source_symtab == 0)
+    select_source_symtab (0);
 
   /* Search from last_line_listed+1 in current_source_symtab */
 
-  desc = openp (source_path, 0, current_source_symtab->filename,
-               O_RDONLY, 0, &current_source_symtab->fullname);
+  desc = open_source_file (current_source_symtab);
   if (desc < 0)
     perror_with_name (current_source_symtab->filename);
 
@@ -727,18 +1332,30 @@ forward_search_command (regex, from_tty)
       perror_with_name (current_source_symtab->filename);
     }
 
-  stream = fdopen (desc, "r");
+  stream = fdopen (desc, FDOPEN_MODE);
   clearerr (stream);
   while (1) {
-    char buf[4096];            /* Should be reasonable??? */
-    register char *p = buf;
+    static char *buf = NULL;
+    register char *p;
+    int cursize, newsize;
+
+    cursize = 256;
+    buf = xmalloc (cursize);
+    p = buf;
 
-    c = fgetc (stream);
+    c = getc (stream);
     if (c == EOF)
       break;
     do {
       *p++ = c;
-    } while (c != '\n' && (c = fgetc (stream)) >= 0);
+      if (p - buf == cursize)
+       {
+         newsize = cursize + cursize / 2;
+         buf = xrealloc (buf, newsize);
+         p = buf + cursize;
+         cursize = newsize;
+       }
+    } while (c != '\n' && (c = getc (stream)) >= 0);
 
     /* we now have a source line in buf, null terminate and match */
     *p = 0;
@@ -746,21 +1363,25 @@ forward_search_command (regex, from_tty)
       {
        /* Match! */
        fclose (stream);
-       print_source_lines (current_source_symtab,
-                          line, line+1, 0);
-       current_source_line = max (line - 5, 1);
+       print_source_lines (current_source_symtab, line, line+1, 0);
+       set_internalvar (lookup_internalvar ("_"),
+                        value_from_longest (builtin_type_int,
+                                            (LONGEST) line));
+       current_source_line = max (line - lines_to_list / 2, 1);
        return;
       }
     line++;
   }
 
-  printf ("Expression not found\n");
+  printf_filtered ("Expression not found\n");
   fclose (stream);
 }
 
+/* ARGSUSED */
 static void
 reverse_search_command (regex, from_tty)
      char *regex;
+     int from_tty;
 {
   register int c;
   register int desc;
@@ -772,13 +1393,12 @@ reverse_search_command (regex, from_tty)
   if (msg)
     error (msg);
 
-  if (current_source_symtab == 0) 
-    error ("No default source file yet.  Do \"help list\".");
+  if (current_source_symtab == 0)
+    select_source_symtab (0);
 
   /* Search from last_line_listed-1 in current_source_symtab */
 
-  desc = openp (source_path, 0, current_source_symtab->filename,
-               O_RDONLY, 0, &current_source_symtab->fullname);
+  desc = open_source_file (current_source_symtab);
   if (desc < 0)
     perror_with_name (current_source_symtab->filename);
 
@@ -797,19 +1417,20 @@ reverse_search_command (regex, from_tty)
       perror_with_name (current_source_symtab->filename);
     }
 
-  stream = fdopen (desc, "r");
+  stream = fdopen (desc, FDOPEN_MODE);
   clearerr (stream);
-  while (1)
+  while (line > 1)
     {
+/* FIXME!!!  We walk right off the end of buf if we get a long line!!! */
       char buf[4096];          /* Should be reasonable??? */
       register char *p = buf;
 
-      c = fgetc (stream);
+      c = getc (stream);
       if (c == EOF)
        break;
       do {
        *p++ = c;
-      } while (c != '\n' && (c = fgetc (stream)) >= 0);
+      } while (c != '\n' && (c = getc (stream)) >= 0);
 
       /* We now have a source line in buf; null terminate and match.  */
       *p = 0;
@@ -819,7 +1440,10 @@ reverse_search_command (regex, from_tty)
          fclose (stream);
          print_source_lines (current_source_symtab,
                              line, line+1, 0);
-         current_source_line = max (line - 5, 1);
+         set_internalvar (lookup_internalvar ("_"),
+                          value_from_longest (builtin_type_int,
+                                              (LONGEST) line));
+         current_source_line = max (line - lines_to_list / 2, 1);
          return;
        }
       line--;
@@ -830,57 +1454,85 @@ reverse_search_command (regex, from_tty)
        }
     }
 
-  printf ("Expression not found\n");
+  printf_filtered ("Expression not found\n");
   fclose (stream);
   return;
 }
 \f
-static
-initialize ()
+void
+_initialize_source ()
 {
+  struct cmd_list_element *c;
   current_source_symtab = 0;
   init_source_path ();
 
-  add_com ("directory", class_files, directory_command,
-          "Add directory DIR to end of search path for source files.\n\
-With no argument, reset the search path to just the working directory\n\
-and forget cached info on line positions in source files.");
-
-  add_info ("directories", directories_info,
-           "Current search path for finding source files.");
+  /* The intention is to use POSIX Basic Regular Expressions.
+     Always use the GNU regex routine for consistency across all hosts.
+     Our current GNU regex.c does not have all the POSIX features, so this is
+     just an approximation.  */
+  re_set_syntax (RE_SYNTAX_GREP);
+
+  c = add_cmd ("directory", class_files, directory_command,
+          "Add directory DIR to beginning of search path for source files.\n\
+Forget cached info on source file locations and line positions.\n\
+DIR can also be $cwd for the current working directory, or $cdir for the\n\
+directory in which the source file was compiled into object code.\n\
+With no argument, reset the search path to $cdir:$cwd, the default.",
+              &cmdlist);
+  c->completer = filename_completer;
+
+  add_cmd ("directories", no_class, show_directories,
+          "Current search path for finding source files.\n\
+$cwd in the path means the current working directory.\n\
+$cdir in the path means the compilation directory of the source file.",
+          &showlist);
+
+  add_info ("source", source_info,
+           "Information about the current source file.");
 
   add_info ("line", line_info,
-           "Core addresses of the code for a source line.\n\
+           concat ("Core addresses of the code for a source line.\n\
 Line can be specified as\n\
   LINENUM, to list around that line in current file,\n\
   FILE:LINENUM, to list around that line in that file,\n\
   FUNCTION, to list around beginning of that function,\n\
   FILE:FUNCTION, to distinguish among like-named static functions.\n\
+", "\
 Default is to describe the last source line that was listed.\n\n\
 This sets the default address for \"x\" to the line's first instruction\n\
 so that \"x/i\" suffices to start examining the machine code.\n\
-The address is also stored as the value of \"$_\".");
+The address is also stored as the value of \"$_\".", NULL));
 
   add_com ("forward-search", class_files, forward_search_command,
-          "Search for regular expression (see regex(3)) from last line listed.");
+          "Search for regular expression (see regex(3)) from last line listed.\n\
+The matching line number is also stored as the value of \"$_\".");
   add_com_alias ("search", "forward-search", class_files, 0);
 
   add_com ("reverse-search", class_files, reverse_search_command,
-          "Search backward for regular expression (see regex(3)) from last line listed.");
+          "Search backward for regular expression (see regex(3)) from last line listed.\n\
+The matching line number is also stored as the value of \"$_\".");
 
   add_com ("list", class_files, list_command,
-          "List specified function or line.\n\
+          concat ("List specified function or line.\n\
 With no argument, lists ten more lines after or around previous listing.\n\
 \"list -\" lists the ten lines before a previous ten-line listing.\n\
 One argument specifies a line, and ten lines are listed around that line.\n\
 Two arguments with comma between specify starting and ending lines to list.\n\
+", "\
 Lines can be specified in these ways:\n\
   LINENUM, to list around that line in current file,\n\
   FILE:LINENUM, to list around that line in that file,\n\
   FUNCTION, to list around beginning of that function,\n\
   FILE:FUNCTION, to distinguish among like-named static functions.\n\
   *ADDRESS, to list around the line containing that address.\n\
-With two args if one is empty it stands for ten lines away from the other arg.");
-}
+With two args if one is empty it stands for ten lines away from the other arg.", NULL));
 
-END_FILE
+  add_com_alias ("l", "list", class_files, 1);
+
+  add_show_from_set
+    (add_set_cmd ("listsize", class_support, var_uinteger,
+                 (char *)&lines_to_list,
+       "Set number of source lines gdb will list by default.",
+                 &setlist),
+     &showlist);
+}