Mirror of the gdb-patches mailing list
 help / color / mirror / Atom feed
From: Eli Zaretskii <eliz@gnu.org>
To: Jan Kratochvil <jan.kratochvil@redhat.com>
Cc: gdb-patches@sourceware.org
Subject: Re: [patch] doc-python: Pretty Printing split user / developer
Date: Thu, 22 Apr 2010 03:19:00 -0000	[thread overview]
Message-ID: <83aasw41ka.fsf@gnu.org> (raw)
In-Reply-To: <20100421205046.GA25787@host0.dyn.jankratochvil.net>

> Date: Wed, 21 Apr 2010 22:50:46 +0200
> From: Jan Kratochvil <jan.kratochvil@redhat.com>
> 
> which I try to address by the attachment.  Is it OK this way?

Thanks.

> +@smallexample
> +(@value{GDBP}) print s
> +$1 = @{
> +  static npos = 4294967295, 
> +  _M_dataplus = @{
> +    <std::allocator<char>> = @{
> +      <__gnu_cxx::new_allocator<char>> = @{<No data fields>@}, <No data fields>@}, 
> +    members of std::basic_string<char, std::char_traits<char>, std::allocator<char> >::_Alloc_hider: 
> +    _M_p = 0x804a014 "abcd"
> +  @}
> +@}
> +@end smallexample

The long lines here need to be wrapped, to become shorter than 72
characters.

>  * Auto-loading::                Automatically loading Python code.
>  * Values From Inferior::
>  * Types In Python::		Python representation of types.
> -* Pretty Printing::		Pretty-printing values.
> +* Pretty Printing API::		Pretty-printing values.
>  * Selecting Pretty-Printers::   How GDB chooses a pretty-printer.
>  * Commands In Python::          Implementing new commands in Python.
>  * Functions In Python::         Writing new convenience functions.

This menu uses TAB characters.  Please convert all of them to spaces
("M-x untabify" in Emacs).  Using TABs in a Texinfo file is a no-no,
because it causes line misalignment in the Info output.

> +@value{GDBN} provides a mechanism to allow pretty-printing of values using
> +Python code.  The pretty-printer API allows application-specific code to
> +greatly simplify the display of complex objects.

This repeats what you just said in the "Pretty Printing" section.  I
don't think we need to repeat that.

Okay with these changes.


  reply	other threads:[~2010-04-22  3:19 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2010-04-21 20:50 Jan Kratochvil
2010-04-22  3:19 ` Eli Zaretskii [this message]
2010-04-22 17:00   ` Jan Kratochvil

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=83aasw41ka.fsf@gnu.org \
    --to=eliz@gnu.org \
    --cc=gdb-patches@sourceware.org \
    --cc=jan.kratochvil@redhat.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox