John Gilmore [Thu, 2 Apr 1992 11:56:14 +0000 (11:56 +0000)]
* buildsym.c (read_struct_type): Avoid coredump when C++
abbreviated type name is messed up. Reported by Joe Buck.
FIXME, we need to determine whether GDB or GCC needs to be
smarter to correctly locate this type name. p*927 circumvention,
needs real fix when Tiemann's back.
John Gilmore [Thu, 2 Apr 1992 10:35:19 +0000 (10:35 +0000)]
Lint.
* symfile.c (add_symbol_file_command): Initialize mapped/readnow.
John Gilmore [Thu, 2 Apr 1992 07:26:31 +0000 (07:26 +0000)]
* archive.c, bfd.c, bout.c, coffcode.h, init.c, reloc.c,
section.c, srec.c, syms.c, coff-h8300.c: Lint.
Fred Fish [Wed, 1 Apr 1992 19:49:00 +0000 (19:49 +0000)]
Add kludge to work around broken <stdlib.h> in gcc installation on Suns.
Fixup some comments in mcalloc, mfree, mmalloc, and mrealloc.
Fred Fish [Wed, 1 Apr 1992 19:46:14 +0000 (19:46 +0000)]
Many changes to procfs.c, mostly to expand the "info proc" command and to
fix a couple of small bugs. Changes to other files mostly to fix minor
things pointed out by the SGI compiler. See ChangeLog for complete details.
Fred Fish [Wed, 1 Apr 1992 03:09:02 +0000 (03:09 +0000)]
Changes in procfs.c to fix bug with inferior's siginfo struct getting
needlessly stomped. Changes in elfread.c and solib.c to fix DWARF
processing, broken by other recent changes.
Stu Grossman [Wed, 1 Apr 1992 01:50:30 +0000 (01:50 +0000)]
* mipsread.c (parse_procedure): PDR.isym should get pointer to
function name, not .gdbinfo. symbol.
John Gilmore [Wed, 1 Apr 1992 01:08:06 +0000 (01:08 +0000)]
Keep sun4os5 config files now that Sun says it's OK.
John Gilmore [Wed, 1 Apr 1992 01:07:16 +0000 (01:07 +0000)]
(breakpoint_1): Fix prototype, this time for sure!
Stu Grossman [Tue, 31 Mar 1992 20:00:06 +0000 (20:00 +0000)]
* Makefile.in: version->4.4.8
Stu Grossman [Tue, 31 Mar 1992 19:03:28 +0000 (19:03 +0000)]
* procfs.c (open_proc_file): Disable inherit-on-fork flag so that
commands in .cshrc/.profile won't get traced.
John Gilmore [Tue, 31 Mar 1992 16:16:41 +0000 (16:16 +0000)]
* elfread.c (elf_symtab_read): Use xmalloc, not bfd_xmalloc.
* exec.c (build_section_table): Don't abort if no sections.
* sparc-tdep.c (single_step): Lint.
* utils.c (mrealloc): Handle realloc (0, size) case here.
K. Richard Pixley [Tue, 31 Mar 1992 06:35:16 +0000 (06:35 +0000)]
add send_pr. remove "force" from .stmp-gprof rule. Supress echoing of all the "if [ -d ... $(MAKE)" lines.
Stu Grossman [Tue, 31 Mar 1992 06:31:05 +0000 (06:31 +0000)]
gdb.tar.Z: all-texinfo target is now .stmp-texinfo.
Stu Grossman [Tue, 31 Mar 1992 05:23:15 +0000 (05:23 +0000)]
* Makefile.in (alldeps.mak): Config files are now *.m[ht] as
opposed to m[ht]-*!
Stu Grossman [Tue, 31 Mar 1992 04:51:02 +0000 (04:51 +0000)]
Add mh-aix
Stu Grossman [Tue, 31 Mar 1992 04:49:27 +0000 (04:49 +0000)]
Add sysv4.h
Stu Grossman [Tue, 31 Mar 1992 04:46:53 +0000 (04:46 +0000)]
Add irix4.h
Stu Grossman [Tue, 31 Mar 1992 04:44:32 +0000 (04:44 +0000)]
Keep PORTING
Stu Grossman [Tue, 31 Mar 1992 02:36:24 +0000 (02:36 +0000)]
* config/irix4.mh: Don't use coredep.o. It doesn't work with procfs.
Stu Grossman [Tue, 31 Mar 1992 01:21:01 +0000 (01:21 +0000)]
* mipsread.c (parse_symbol, parse_procedure): Re-do the way that
.gdbinfo. symbols are created. Move creation from parse_procedure
to parse_symbol, where it is fairly easy to grow the symtab. This
also fixes a symtab trashing bug on all mips-based systems.
* (got_numargs, lookup_numargs, free_numargs): Delete. Not
needed anymore.
* tm-mips.h, tm-iris3.h, mips-tdep.c, mipsread.c: Re-do struct
mips_extra_func_info, and all the PROC_xxx macros that look at it.
Per Bothner [Mon, 30 Mar 1992 22:19:14 +0000 (22:19 +0000)]
c-exp.y: Add missing return type to yyparse() prototype.
John Gilmore [Sun, 29 Mar 1992 23:26:47 +0000 (23:26 +0000)]
Lint
John Gilmore [Sun, 29 Mar 1992 23:22:35 +0000 (23:22 +0000)]
New host and target.
John Gilmore [Sun, 29 Mar 1992 23:18:31 +0000 (23:18 +0000)]
* Makefile.in (VERSION): Roll to 4.4.7.
(HFILES): Add call-cmds.h.
* call-cmds.h: New header for command fns called by other files.
* breakpoint.c (watchpoints_info): Remove, same as breakpoints_info.
(breakpoint_1): Remove unused type arg. Change callers.
John Gilmore [Sun, 29 Mar 1992 23:17:36 +0000 (23:17 +0000)]
Create and use macros for iterating on symtabs, psymtabs, msymbols.
* minsyms.c (iterate_over_msymbols): Remove; clunky and slow.
* symfile.h, symtab.h (iterate_over_msymbols): Remove prototype
* coffread.c (coff_symfile_read): iterate_over_symtabs => ALL_SYMTABS.
(patch_opaque_types): Avoid dummy args and result.
* objfiles.c (have_partial_symbols, have_full_symbols,
have_minimal_symbols): explicit iteration => ALL_OBJFILES; simplify.
(iterate_over_objfiles, iterate_over_symtabs,
iterate_over_psymtabs): Remove, clunky and slow.
* objfiles.h: Replace iterate_over_* prototypes with ALL_SYMTABS,
ALL_PSYMTABS, and ALL_MSYMBOLS macros.
* symmisc.c (dump_symtab, dump_psymtab, dump_msymbols,
dump_objfile): Remove dummy args and results. Move filename
comparisons to callers.
(printsyms_command, printpsyms_command, printmsyms_command,
printobjfiles_command): iterate_over_* => ALL_*. Compare filenames.
* symtab.c (lookup_symtab_1, lookup_symtab, lookup_partial_symtab,
lookup_symbol, find_main_psymtab, find_pc_symtab, sources_info,
list_symbols, make_symbol_completion_list): Replace explicit
iteration with ALL_SYMTABS, ALL_PSYMTABS, or ALL_MSYMBOLS.
Eliminate Dijkstra flag crap, break out of loops with gotos.
(lookup_symtab_1): Protect '/' tests from short filenames.
(cplus_mangled_symbol): Move inline into lookup_symbol.
* xcoffexec.c (relocate_objfile_msymbols): Remove poor hack.
(relocate_minimal_symbol): Move inline to vmap_symtab.
(vmap_symtab): Replace iteration with ALL_OBJFILES,
iterate_over_msymbols with ALL_MSYMBOLS.
Misc cleanup prior to release.
* dwarfread.c (dwarf_build_psymtabs): Remove mainline test.
* mipsread.c (compare_symtabs, compare_psymtabs): Remove, unused.
* mipsread.c: Add prototypes for all static functions.
* symmisc.c (dump_symtab_lines, dump_symtabs, dump_last_symtab,
dump_blockvector, dump_block, dump_addrchass, dump_namespace,
dump_symbol, dump_type, dump_linetable, dump_strtbl): Remove, unused.
* xcoffread.c (dump_symtab_lines, dump_symtabs, dump_last_symtab,
dump_blockvector, dump_block, dump_addrchass, dump_namespace,
dump_symbol, dump_type, dump_linetable, dump_strtbl): Remove 2nd
unused copy!
* buildsym.c (define_symbol): Handle global register variables
(from Pierre Willard). Complain if register numbers are too large.
John Gilmore [Sun, 29 Mar 1992 23:14:34 +0000 (23:14 +0000)]
* target.c (nomemory): Now that higher levels examine errno, give EIO.
* tm-sparc.h: Don't #include <sun4/reg.h>.
* sparc-tdep.c (sparc_frame_chain, frame_saved_pc): Remove
dependency on <sun4/reg.h>. Start to handle cross-byte-order.
* language.h: Avoid forward enum declaration.
* configure.in, tm-sun4os5.h, xm-sun4os5.h, config/sun4os5.mh,
config/sun4os5.mt: New host and target.
* defs.h (errno): #include <errno.h> rather than assuming int.
From Pierre Willard.
Per Bothner [Sun, 29 Mar 1992 22:33:35 +0000 (22:33 +0000)]
Merged in latest RS6000 diffs from Metin G. Ozisik.
John Gilmore [Sun, 29 Mar 1992 18:46:10 +0000 (18:46 +0000)]
* config/sparc-elf.mt, hosts/sysv4.h: New config files.
John Gilmore [Sun, 29 Mar 1992 18:45:43 +0000 (18:45 +0000)]
* bout.c, coff-a29k.c, coff-i960.c: Lint.
* configure.in: Add new host and target configs.
* elf.c (bfd_prstatus, bfd_fpregset): Avoid typename of register
structs, which vary; just use member name.
(elf_object_p, elf_core_file_p): Lint, fix comments.
* config/sparc-elf.mt, hosts/sysv4.h: New config files.
Fred Fish [Sat, 28 Mar 1992 21:10:05 +0000 (21:10 +0000)]
Fix to use a single disposable copy of section header table and program
header table entries.
Fred Fish [Sat, 28 Mar 1992 21:06:23 +0000 (21:06 +0000)]
Add OBJF_SYMS flag and use it to decide whether or not we have already
tried to read symbols from a file, for mapped objfiles. This fixes a
memory leak (actually a constant memory growth) due to reading symbol
files with no debug info and thus generating no psymtabs or symtabs.
Most typically happened with shared libraries.
John Gilmore [Fri, 27 Mar 1992 23:56:15 +0000 (23:56 +0000)]
Misc cleanups from code review.
Sean Eric Fagan [Fri, 27 Mar 1992 22:11:14 +0000 (22:11 +0000)]
More cleanups for gprof, especially with the '386 target.
Sean Eric Fagan [Fri, 27 Mar 1992 22:10:04 +0000 (22:10 +0000)]
Added support for building on/for an embedded 386 using encapsulated coff.
Sean Eric Fagan [Fri, 27 Mar 1992 22:08:47 +0000 (22:08 +0000)]
Put in stuff necessary for gprof to be built, cleaned up, etc.
Fred Fish [Fri, 27 Mar 1992 01:11:08 +0000 (01:11 +0000)]
Document requirements for calling mmcheck to install corruption checking
hooks and set up to enforce the requirements. However, we still allow
unconditional installation until some complications are resolved.
Fred Fish [Fri, 27 Mar 1992 01:04:14 +0000 (01:04 +0000)]
Mostly changes to dbxread.c to preserve stringtab's on a per-objfile
basis, for use in expanding psymtabs to full symtabs. See ChangeLog
for other details.
John Gilmore [Fri, 27 Mar 1992 01:00:58 +0000 (01:00 +0000)]
Set MINIMIZE to 0 for a real release.
Per Bothner [Thu, 26 Mar 1992 21:22:50 +0000 (21:22 +0000)]
* rs6000-pinsn.c: Make dis-assembly output more like
other targets: Don't print instruction in hex before
the assembly; use print_address to print out jump
destinations.
Per Bothner [Thu, 26 Mar 1992 08:33:43 +0000 (08:33 +0000)]
* c-exp.y, gdbtypes.h: Add builtin_type_signed_char.
* cplus-dem.c: Support "Sc" meaning "signed char".
Stu Grossman [Wed, 25 Mar 1992 23:22:47 +0000 (23:22 +0000)]
* configure.in: fix iris/iris3.
Per Bothner [Wed, 25 Mar 1992 23:07:16 +0000 (23:07 +0000)]
* command.c, main.c (various places): Use ctype.h macros
(such as isupper(x)), instead of hard-wiring in ASCII-isms
(such as (x >= 'A' && x <= 'Z')).
(There are still more of these in other files.)
* main.c (defined_command): Lower-case the user's
new command before entering it. Needed because
command lookup is case-insensitive (and also lower-cases).
(Based on Metin's earlier patch.)
John Gilmore [Wed, 25 Mar 1992 18:47:09 +0000 (18:47 +0000)]
* history.c (stifle_history): Negative arg treated as zero.
K. Richard Pixley [Wed, 25 Mar 1992 18:34:46 +0000 (18:34 +0000)]
re-add -rm
K. Richard Pixley [Wed, 25 Mar 1992 07:52:24 +0000 (07:52 +0000)]
aix and irix4 support.
K. Richard Pixley [Wed, 25 Mar 1992 07:51:57 +0000 (07:51 +0000)]
add stamp-rcs to all
K. Richard Pixley [Wed, 25 Mar 1992 07:51:05 +0000 (07:51 +0000)]
remove gas from rs6000 build, use aix host fragment
K. Richard Pixley [Wed, 25 Mar 1992 07:49:53 +0000 (07:49 +0000)]
pass site_option to recursions
K. Richard Pixley [Wed, 25 Mar 1992 07:46:51 +0000 (07:46 +0000)]
INSTALL_PROG -> INSTALL
K. Richard Pixley [Wed, 25 Mar 1992 07:41:41 +0000 (07:41 +0000)]
added standard targets, fixed install directories
K. Richard Pixley [Wed, 25 Mar 1992 07:30:51 +0000 (07:30 +0000)]
stuff from latest install
K. Richard Pixley [Wed, 25 Mar 1992 07:29:45 +0000 (07:29 +0000)]
remove srcdir from gdb.info rule
K. Richard Pixley [Wed, 25 Mar 1992 07:27:36 +0000 (07:27 +0000)]
irix4 support
Stu Grossman [Wed, 25 Mar 1992 05:50:53 +0000 (05:50 +0000)]
* infcmd.c (step_1): Call disable_longjmp_breakpoint at the right
time.
Stu Grossman [Wed, 25 Mar 1992 01:57:29 +0000 (01:57 +0000)]
* xm-mips.h: declare strdup for ultrix.
John Gilmore [Wed, 25 Mar 1992 01:07:32 +0000 (01:07 +0000)]
Install some bug fixes from Brian Fox.
Stu Grossman [Wed, 25 Mar 1992 00:22:14 +0000 (00:22 +0000)]
* mipsread.c (fixup_sigtramp): Make sure that current_objfile is setup
when calling new_symbol.
* mips-tdep.c (mips_frame_chain): Use symfile_objfile instead of
current_objfile.
K. Richard Pixley [Tue, 24 Mar 1992 23:58:58 +0000 (23:58 +0000)]
add support for irix4
Per Bothner [Tue, 24 Mar 1992 22:54:21 +0000 (22:54 +0000)]
* config/rs6000.mh: Update (for Fred's new mmalloc)
flags to disable use of GNU malloc/mmalloc.
* munch: Change SYSV rule to allow .text before the label,
as well as after, to work for AIX.
* gdbtypes.h: Minor clarifiction.
Michael Tiemann [Tue, 24 Mar 1992 15:28:40 +0000 (15:28 +0000)]
Fixed a place where dbx symbol name continuation was appearing in an
unexpected place, causing the `Trace' type in gperf/main.o to be
mis-parsed.
Stu Grossman [Tue, 24 Mar 1992 07:02:52 +0000 (07:02 +0000)]
* mips-tdep.c: include symfile.h and objfiles.h to fix
compilation errors.
Stu Grossman [Tue, 24 Mar 1992 06:39:01 +0000 (06:39 +0000)]
* coff-msym.c (ecoff_swap_rfd_in): remove & for array ref.
Per Bothner [Mon, 23 Mar 1992 23:52:45 +0000 (23:52 +0000)]
* valops.c (value_struct_elt_for_reference): Added 'offset'
parameter to handle multiple inheritance.
* eval.c, value.h: Update accordingly.
Fred Fish [Sat, 21 Mar 1992 01:56:01 +0000 (01:56 +0000)]
Many changes, most related to creating entry point information on a per-objfile
basis. See comments in objfiles.h and details in ChangeLog. Also remove
redundant definitions of FRAME_CHAIN_VALID from most of the tm-* files and
use a default definition in frame.h.
Heinz G. Seidl [Fri, 20 Mar 1992 23:58:25 +0000 (23:58 +0000)]
changed prms to send_pr
Per Bothner [Fri, 20 Mar 1992 21:57:17 +0000 (21:57 +0000)]
More C++ improvements (pointers to members, qualified names). See ChangeLog.
Stu Grossman [Fri, 20 Mar 1992 00:53:45 +0000 (00:53 +0000)]
Add .stmp-readline to all.cross...
Stu Grossman [Fri, 20 Mar 1992 00:51:23 +0000 (00:51 +0000)]
* Makefile.in (all.cross): Add .stmp-bfd.
Fred Fish [Thu, 19 Mar 1992 21:57:15 +0000 (21:57 +0000)]
* coffread.c, mipsread.c, xcoffread.c, coffread.c, dbxread.c,
elfread.c (coff_symfile_finish): Add function, prototype, and
add to the xxxx_sym_fns struct for each file type. Also reformat
the xxxx_sym_fns vector to a standard format and add comments.
* coffread.c, mipsread.c, xcoffread.c, coffread.c, dbxread.c,
elfread.c (xxx_symfile_new_init, xxx_symfile_init, xxx_symfile_read):
Pass pointer to struct objfile rather than pointer to sym_fns.
Change references inside each function accordingly. Allocate any
symbol file specific info in the per-objfile memory region.
* dbxread.c (free_and_init_header_files): Break function into
free_header_files(), called from dbx_symfile_finish(), and
init_header_files(), called from dbx_new_init().
* dbxread.c (dbx_new_init): Move deallocation things to new
dbx_symfile_finish function.
* elfread.c (elf_new_init): Call buildsym_new_init().
* objfiles.c (free_objfile): Call the appropriate symfile_finish()
routine for the objfile before deallocating other stuff.
* sparc-tdep.c (get_longjmp_target): Cast target_read_memory arg.
* symfile.h: Move struct sym_fns to before struct objfile def.
Add sym_finish function pointer and change prototypes of other
function pointers to reflect passing struct objfile pointer rather
than struct sym_fns pointer.
* symfile.c: Remove now obsolete symtab_fns pointer.
* symfile.c (symfile_init): Renamed to find_sym_fns, and now only
locates the correct sym_fns struct for the given objfile.
* symfile.c (syms_from_objfile, symbol_file_add): Restructured
for better support of mapped symbol tables.
* symfile.c (symbol_file_command): Remove obsolete code using
symfile_fns.
* symfile.h: Remove duplicate declarations for symfile_objfile,
entry_point, and object_files.
* target.c (target_info): Compare symfile_objfile to NULL.
* xcoffread.c (aixcoff_new_init): Move deallocation stuff to
aixcoff_symfile_finish().
Fred Fish [Thu, 19 Mar 1992 02:26:25 +0000 (02:26 +0000)]
Add and use definition for IN_SOLIB_TRAMPOLINE which allows wait_for_inferior
to test whether or not it has stepped into the glue that binds an
application to a shared library routine.
Per Bothner [Thu, 19 Mar 1992 00:05:35 +0000 (00:05 +0000)]
Some improvements to g++ debugging.
* symtab.c (list_symbols): demangle before pattern matching.
* symtab.c: Other fixes to improve handing of operators.
* valprint.c (type_print_base): Fix test for constructor.
* values.c (value_static_field): Allow evaluation of
CLASS::METHOD, returning a function pointer.
Fred Fish [Wed, 18 Mar 1992 16:45:54 +0000 (16:45 +0000)]
Remove currently unused state.c and state.h files from list of files
to keep.
Fred Fish [Wed, 18 Mar 1992 16:43:25 +0000 (16:43 +0000)]
Changes to implement the -mapped and -readnow options for commands that
read symbol tables.
Per Bothner [Tue, 17 Mar 1992 22:14:18 +0000 (22:14 +0000)]
* bout.c (b_out_slurp_reloc_table): Use BFD_ASSERT macro,
not internal bfd_assert function (twice).
Steve Chamberlain [Tue, 17 Mar 1992 18:47:16 +0000 (18:47 +0000)]
* aout-target.h: change ar_max_namelen to 15 (the right value)
* coff-a29k, coffcode.h: more hangovers from the bfd_abs_section
change
Steve Chamberlain [Tue, 17 Mar 1992 00:41:11 +0000 (00:41 +0000)]
More bitrot
Steve Chamberlain [Tue, 17 Mar 1992 00:38:14 +0000 (00:38 +0000)]
Fix for new filenames
Steve Chamberlain [Mon, 16 Mar 1992 22:59:58 +0000 (22:59 +0000)]
Remove i960 b.out bitrot.
Steve Chamberlain [Mon, 16 Mar 1992 22:54:51 +0000 (22:54 +0000)]
i960 bitrot fix
Fred Fish [Sun, 15 Mar 1992 03:33:19 +0000 (03:33 +0000)]
Remove unused file mtrace.awk, remove entries from .Sanitize for
mtrace.awk and previously removed files.
Fred Fish [Sun, 15 Mar 1992 03:11:09 +0000 (03:11 +0000)]
Add mmalloc directory to list of files to preserve.
Fred Fish [Sun, 15 Mar 1992 02:16:01 +0000 (02:16 +0000)]
New memory malloc malloc library, based on GNU malloc.
Fred Fish [Sun, 15 Mar 1992 01:33:32 +0000 (01:33 +0000)]
Convert calls to bare malloc() to bfd_xmalloc().
Fred Fish [Sun, 15 Mar 1992 01:21:52 +0000 (01:21 +0000)]
Add support for mmalloc library.
Fred Fish [Sun, 15 Mar 1992 01:13:26 +0000 (01:13 +0000)]
These files are replaced by the mmalloc library.
Fred Fish [Sun, 15 Mar 1992 01:10:01 +0000 (01:10 +0000)]
Missed in last checkin.
Fred Fish [Sun, 15 Mar 1992 01:09:14 +0000 (01:09 +0000)]
Globs of changes. See the ChangeLog for details. Most related to
using the new mmalloc package.
Fred Fish [Sat, 14 Mar 1992 19:47:11 +0000 (19:47 +0000)]
Only enable compilation of debugging functions when IBM6000 is defined
as well as DEBUG. Fails to compile otherwise.
Fred Fish [Sat, 14 Mar 1992 19:41:28 +0000 (19:41 +0000)]
Add config directory to list of things to keep.
Mark Eichin [Sat, 14 Mar 1992 09:04:48 +0000 (09:04 +0000)]
missing backslash on first line of all.normal
John Gilmore [Sat, 14 Mar 1992 05:40:34 +0000 (05:40 +0000)]
* mipsread.c (mipscoff_symfile_read): Eliminate a lot of
useless code, including an lseek to an uninitialized variable.
Reported by Jim Williams <jimbo@wrs.com>.
K. Richard Pixley [Sat, 14 Mar 1992 03:47:55 +0000 (03:47 +0000)]
install man page too
K. Richard Pixley [Sat, 14 Mar 1992 03:09:49 +0000 (03:09 +0000)]
fix cvs merge detritus
K. Richard Pixley [Sat, 14 Mar 1992 03:08:29 +0000 (03:08 +0000)]
pass MAKEINFO macro on info
K. Richard Pixley [Sat, 14 Mar 1992 03:07:12 +0000 (03:07 +0000)]
use MAKEINFO macro
K. Richard Pixley [Sat, 14 Mar 1992 02:54:17 +0000 (02:54 +0000)]
pass MAKEINFO on recursion
K. Richard Pixley [Sat, 14 Mar 1992 02:45:00 +0000 (02:45 +0000)]
add stmp dependencies for a few more things
K. Richard Pixley [Sat, 14 Mar 1992 02:30:18 +0000 (02:30 +0000)]
pass MAKEINFO down on info
Roland Pesch [Sat, 14 Mar 1992 00:07:37 +0000 (00:07 +0000)]
(1) GDB 4.5: another Grossman/Gilmore co-production!
(2) Add fnf to GDB credits for SVr4 stuff. (Need to sift ChangeLog again for
more recent credits).
(3) document "mapped", "readnow" keywords (with file or symbol-file commands;
for now no mention of add-symbol-file in this context), -m and -mapped
cmd-line options, and associated explanations.