[RFC - Python Scripting] New method Objfile.symtabs () - docs included

[Siva Chandra <sivachandra at google dot com>]

Hi all,

Attached is a patch which adds a new method Objfile.symtabs to
gdb.Objfile.  This new method returns a list of gdb.Symtab objects
associated with the underlying object file.

Code ChangeLog:

2012-04-02  Siva Chandra Reddy  <sivachandra@google.com>

	Python Scripting: New method Objfile.symtabs which returns
	the list of obj.Symtab objects associated with the underlying
	objfile.
	* NEWS: Add entery under 'Python scripting' about the new
	Objfile.symtabs method.
	* python/py-objfile.c (stpy_iterator_object): New iterator
	object type to iterate over a list of obj.Symtab objects.
	(stpy_node): New struct to aid the iterator.
	(stpy_iterator_free_symtab_list, new_stpy_iterator,
	 objfpy_symtabs, stpy_iterator_dealloc, stpy_iterator_iter,
	 stpy_iterator_iternext): New functions which manage the new
	iterator object type.
	(objfpy_dealloc, objfpy_new, objfile_to_objfile_object,
	 gdbpy_initialize_objfile): Add initializations and reference
	management for the new iterator object and type.

Docs ChangeLog:

2012-04-02  Siva Chandra Reddy  <sivachandra@google.com>

	* gdb.texinfo (Python API/Objfiles In Python): Add description
	about the new method Objfile.symtabs on gdb.Objfile objects.

Testsuite ChangeLog:

2012-04-02  Siva Chandra Reddy  <sivachandra@google.com>

	* gdb.python/py-objfile.exp: Add tests to test the method
	Objfile.symtabs.
	* gdb.python/py-objfile1.c: New file to help test the new
	method Objfile.symtabs.
	* gdb.python/py-objfile2.c: Likewise
	* gdb.python/py-objfile3.c: Likewise

Thanks,
Siva Chandra

Attachment: objfile_symtabs_patch_v1.txt
Description: Text document