This is the mail archive of the gdb-patches@sourceware.org mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [doc RFA] Misc. fixes to Python docs


> From: Doug Evans <xdje42@gmail.com>
> Date: Sun, 22 Dec 2013 17:58:10 -0800
> 
> I found this collection of fixes.
> 
> The @tindex is for consistency with all other such entries.
> 
> The @code{"charset"} instead of @samp{charset} is for consistency with
> earlier use.

I question the second issue.  IMO @samp looks much better in print
than @code{".."}.

> +@findex gdb.VERSION
> +@defvar gdb.VERSION

@defvar inserts its argument into the index automatically, so no need
for @findex (which is wrong anyway, since this is a variable, not a
function).

> @@ -26482,7 +26499,6 @@ this function returns @code{None}.
>  @findex gdb.objfiles
>  @defun gdb.objfiles ()
>  Return a sequence of all the objfiles current known to @value{GDBN}.
> -@xref{Objfiles In Python}.
>  @end defun

Why did you remove the cross-reference?

OK with those changes.

Thanks.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]