This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [doc RFA] Misc. fixes to Python docs
- From: Eli Zaretskii <eliz at gnu dot org>
- To: Doug Evans <xdje42 at gmail dot com>
- Cc: gdb-patches at sourceware dot org
- Date: Mon, 23 Dec 2013 05:52:24 +0200
- Subject: Re: [doc RFA] Misc. fixes to Python docs
- Authentication-results: sourceware.org; auth=none
- References: <m3haa0tjkd dot fsf at sspiff dot org>
- Reply-to: Eli Zaretskii <eliz at gnu dot org>
> 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.