[Bug libstdc++/57226] New: The installation of pretty printers is not documented

public inbox for gcc-bugs@sourceware.org
help / color / mirror / Atom feed

* [Bug libstdc++/57226] New: The installation of pretty printers is not documented
@ 2013-05-09 10:46 morandini at aero dot polimi.it
  2013-05-09 12:49 ` [Bug libstdc++/57226] " redi at gcc dot gnu.org
                   ` (8 more replies)
  0 siblings, 9 replies; 10+ messages in thread
From: morandini at aero dot polimi.it @ 2013-05-09 10:46 UTC (permalink / raw)
  To: gcc-bugs

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57226

             Bug #: 57226
           Summary: The installation of pretty printers is not documented
    Classification: Unclassified
           Product: gcc
           Version: 4.8.0
            Status: UNCONFIRMED
          Severity: minor
          Priority: P3
         Component: libstdc++
        AssignedTo: unassigned@gcc.gnu.org
        ReportedBy: morandini@aero.polimi.it


I'd expect some instructions on how to enable the pretty printers in the gcc
info manual.


^ permalink raw reply	[flat|nested] 10+ messages in thread

* [Bug libstdc++/57226] The installation of pretty printers is not documented
  2013-05-09 10:46 [Bug libstdc++/57226] New: The installation of pretty printers is not documented morandini at aero dot polimi.it
@ 2013-05-09 12:49 ` redi at gcc dot gnu.org
  2013-05-09 13:32 ` marco.morandini at polimi dot it
                   ` (7 subsequent siblings)
  8 siblings, 0 replies; 10+ messages in thread
From: redi at gcc dot gnu.org @ 2013-05-09 12:49 UTC (permalink / raw)
  To: gcc-bugs

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57226

--- Comment #1 from Jonathan Wakely <redi at gcc dot gnu.org> ---
You install GCC and the printers get installed alongside them, and when gdb
loads libstdc++.so.6.0.16 it automatically loads libstdc++.so.6.0.16-gdb.py ...
what more do you need to know? What needs to be documented?


^ permalink raw reply	[flat|nested] 10+ messages in thread

* [Bug libstdc++/57226] The installation of pretty printers is not documented
  2013-05-09 10:46 [Bug libstdc++/57226] New: The installation of pretty printers is not documented morandini at aero dot polimi.it
  2013-05-09 12:49 ` [Bug libstdc++/57226] " redi at gcc dot gnu.org
@ 2013-05-09 13:32 ` marco.morandini at polimi dot it
  2013-05-09 13:34 ` marco.morandini at polimi dot it
                   ` (6 subsequent siblings)
  8 siblings, 0 replies; 10+ messages in thread
From: marco.morandini at polimi dot it @ 2013-05-09 13:32 UTC (permalink / raw)
  To: gcc-bugs

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57226

--- Comment #2 from marco.morandini at polimi dot it ---
On 05/09/2013 02:48 PM, redi at gcc dot gnu.org wrote:
> http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57226
>
> --- Comment #1 from Jonathan Wakely <redi at gcc dot gnu.org> ---
> You install GCC and the printers get installed alongside them, and when gdb
> loads libstdc++.so.6.0.16 it automatically loads libstdc++.so.6.0.16-gdb.py ...
> what more do you need to know? What needs to be documented?
>

First, mentioning that the pretty printers existst, and are installed 
with gcc, and not with gdb.

Second, what to do if someone installs gcc in a non-standard location 
that is not known by gdb.
I agree that by reading the gdb info one can come up with these commands 
in his .gdbinit,

add-auto-load-safe-path /home/marco/local/gcc-4.8.0/share/gcc-4.8.0/python

python
import sys
sys.path.insert(0, '/home/marco/local/gcc-4.8.0/share/gcc-4.8.0/python')
from libstdcxx.v6.printers import register_libstdcxx_printers
register_libstdcxx_printers (None)
end

but reporting them in gcc's manual would help.


^ permalink raw reply	[flat|nested] 10+ messages in thread

* [Bug libstdc++/57226] The installation of pretty printers is not documented
  2013-05-09 10:46 [Bug libstdc++/57226] New: The installation of pretty printers is not documented morandini at aero dot polimi.it
  2013-05-09 12:49 ` [Bug libstdc++/57226] " redi at gcc dot gnu.org
  2013-05-09 13:32 ` marco.morandini at polimi dot it
@ 2013-05-09 13:34 ` marco.morandini at polimi dot it
  2013-05-09 13:46 ` redi at gcc dot gnu.org
                   ` (5 subsequent siblings)
  8 siblings, 0 replies; 10+ messages in thread
From: marco.morandini at polimi dot it @ 2013-05-09 13:34 UTC (permalink / raw)
  To: gcc-bugs

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57226

--- Comment #3 from marco.morandini at polimi dot it ---
On 05/09/2013 02:48 PM, redi at gcc dot gnu.org wrote:
> http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57226
>
> --- Comment #1 from Jonathan Wakely <redi at gcc dot gnu.org> ---
> You install GCC and the printers get installed alongside them, and when gdb
> loads libstdc++.so.6.0.16 it automatically loads libstdc++.so.6.0.16-gdb.py ...
> what more do you need to know? What needs to be documented?
>

First, mentioning that the pretty printers do exist and that they are 
installed with gcc, not with gdb.

Second, what to do if someone installs gcc in a non-standard location 
that is not known by gdb.
I agree that by reading the gdb info one can come up with these commands 
in his .gdbinit,

-------------
add-auto-load-safe-path GCC_INSTALL_PREFIX/share/gcc-4.8.0/python

python
import sys
sys.path.insert(0, 'GCC_INSTALL_PREFIX/share/gcc-4.8.0/python')
from libstdcxx.v6.printers import register_libstdcxx_printers
register_libstdcxx_printers (None)
end
------------

but reporting them in gcc's manual would help.


^ permalink raw reply	[flat|nested] 10+ messages in thread

* [Bug libstdc++/57226] The installation of pretty printers is not documented
  2013-05-09 10:46 [Bug libstdc++/57226] New: The installation of pretty printers is not documented morandini at aero dot polimi.it
                   ` (2 preceding siblings ...)
  2013-05-09 13:34 ` marco.morandini at polimi dot it
@ 2013-05-09 13:46 ` redi at gcc dot gnu.org
  2013-05-09 15:55 ` morandini at aero dot polimi.it
                   ` (4 subsequent siblings)
  8 siblings, 0 replies; 10+ messages in thread
From: redi at gcc dot gnu.org @ 2013-05-09 13:46 UTC (permalink / raw)
  To: gcc-bugs

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57226

Jonathan Wakely <redi at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Keywords|                            |documentation

--- Comment #4 from Jonathan Wakely <redi at gcc dot gnu.org> ---
(In reply to marco.morandini from comment #3)
> Second, what to do if someone installs gcc in a non-standard location 
> that is not known by gdb.

Then the executable will not find libstdc++.so and will not work anyway.

If the executable finds the correct libstdc++.so then GDB will find it too.
It's automatic.

> I agree that by reading the gdb info one can come up with these commands 
> in his .gdbinit,
> 
> -------------
> add-auto-load-safe-path GCC_INSTALL_PREFIX/share/gcc-4.8.0/python
> 
> python
> import sys
> sys.path.insert(0, 'GCC_INSTALL_PREFIX/share/gcc-4.8.0/python')
> from libstdcxx.v6.printers import register_libstdcxx_printers
> register_libstdcxx_printers (None)
> end
> ------------
> 
> but reporting them in gcc's manual would help.

Those commands are not necessary if your executable links to the right
libstdc++.so


^ permalink raw reply	[flat|nested] 10+ messages in thread

* [Bug libstdc++/57226] The installation of pretty printers is not documented
  2013-05-09 10:46 [Bug libstdc++/57226] New: The installation of pretty printers is not documented morandini at aero dot polimi.it
                   ` (3 preceding siblings ...)
  2013-05-09 13:46 ` redi at gcc dot gnu.org
@ 2013-05-09 15:55 ` morandini at aero dot polimi.it
  2013-05-09 16:16 ` redi at gcc dot gnu.org
                   ` (3 subsequent siblings)
  8 siblings, 0 replies; 10+ messages in thread
From: morandini at aero dot polimi.it @ 2013-05-09 15:55 UTC (permalink / raw)
  To: gcc-bugs

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57226

morandini at aero dot polimi.it changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|UNCONFIRMED                 |RESOLVED
         Resolution|---                         |INVALID

--- Comment #5 from morandini at aero dot polimi.it ---
(In reply to Jonathan Wakely from comment #4)

I've misread your comment #1.
Apologize for the noise.

I'm still convinced that it would be worth mentioning them in the doc.
At the very least because this gdb warning

warning: File "/home/marco/local/gcc-4.8.0/lib64/libstdc++.so.6.0.18-gdb.py"
auto-loading has been declined by your `auto-load safe-path' set to
"$debugdir:$datadir/auto-load".
To enable execution of this file add
        add-auto-load-safe-path
/home/marco/local/gcc-4.8.0/lib64/libstdc++.so.6.0.18-gdb.py

could be somewhat cryptic if someone does not know that these pretty printers
are installed by gcc.

Anyway, I'm closing this as invalid.


^ permalink raw reply	[flat|nested] 10+ messages in thread

* [Bug libstdc++/57226] The installation of pretty printers is not documented
  2013-05-09 10:46 [Bug libstdc++/57226] New: The installation of pretty printers is not documented morandini at aero dot polimi.it
                   ` (4 preceding siblings ...)
  2013-05-09 15:55 ` morandini at aero dot polimi.it
@ 2013-05-09 16:16 ` redi at gcc dot gnu.org
  2013-10-07 12:31 ` redi at gcc dot gnu.org
                   ` (2 subsequent siblings)
  8 siblings, 0 replies; 10+ messages in thread
From: redi at gcc dot gnu.org @ 2013-05-09 16:16 UTC (permalink / raw)
  To: gcc-bugs

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57226

--- Comment #6 from Jonathan Wakely <redi at gcc dot gnu.org> ---
Ah, I haven't seen that warning.  If you'd mentioned that warning I would have
agreed it might be worth documenting, but as you only talked about how to
install them (which happens automatically) I didn't understand the issue.

I'll see what I can do to document it, maybe in the FAQ.


^ permalink raw reply	[flat|nested] 10+ messages in thread

* [Bug libstdc++/57226] The installation of pretty printers is not documented
  2013-05-09 10:46 [Bug libstdc++/57226] New: The installation of pretty printers is not documented morandini at aero dot polimi.it
                   ` (5 preceding siblings ...)
  2013-05-09 16:16 ` redi at gcc dot gnu.org
@ 2013-10-07 12:31 ` redi at gcc dot gnu.org
  2014-01-29 23:47 ` redi at gcc dot gnu.org
  2014-01-29 23:48 ` redi at gcc dot gnu.org
  8 siblings, 0 replies; 10+ messages in thread
From: redi at gcc dot gnu.org @ 2013-10-07 12:31 UTC (permalink / raw)
  To: gcc-bugs

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57226

Jonathan Wakely <redi at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|RESOLVED                    |ASSIGNED
   Last reconfirmed|                            |2013-10-07
         Resolution|INVALID                     |---
           Assignee|unassigned at gcc dot gnu.org      |redi at gcc dot gnu.org
     Ever confirmed|0                           |1


^ permalink raw reply	[flat|nested] 10+ messages in thread

* [Bug libstdc++/57226] The installation of pretty printers is not documented
  2013-05-09 10:46 [Bug libstdc++/57226] New: The installation of pretty printers is not documented morandini at aero dot polimi.it
                   ` (6 preceding siblings ...)
  2013-10-07 12:31 ` redi at gcc dot gnu.org
@ 2014-01-29 23:47 ` redi at gcc dot gnu.org
  2014-01-29 23:48 ` redi at gcc dot gnu.org
  8 siblings, 0 replies; 10+ messages in thread
From: redi at gcc dot gnu.org @ 2014-01-29 23:47 UTC (permalink / raw)
  To: gcc-bugs

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57226

--- Comment #7 from Jonathan Wakely <redi at gcc dot gnu.org> ---
Author: redi
Date: Wed Jan 29 23:46:31 2014
New Revision: 207288

URL: http://gcc.gnu.org/viewcvs?rev=207288&root=gcc&view=rev
Log:
    PR libstdc++/57226
    * doc/xml/manual/debug.xml (debug.gdb): Update documentation for
    installation and use of python printers.
    * doc/xml/manual/status_cxx2011.xml: Update.
    * doc/html/*: Regenerate.

Modified:
    trunk/libstdc++-v3/ChangeLog
    trunk/libstdc++-v3/doc/html/api.html
    trunk/libstdc++-v3/doc/html/faq.html
    trunk/libstdc++-v3/doc/html/index.html
    trunk/libstdc++-v3/doc/html/manual/abi.html
    trunk/libstdc++-v3/doc/html/manual/algorithms.html
    trunk/libstdc++-v3/doc/html/manual/api.html
    trunk/libstdc++-v3/doc/html/manual/appendix_contributing.html
    trunk/libstdc++-v3/doc/html/manual/appendix_free.html
    trunk/libstdc++-v3/doc/html/manual/appendix_gpl.html
    trunk/libstdc++-v3/doc/html/manual/appendix_porting.html
    trunk/libstdc++-v3/doc/html/manual/atomics.html
    trunk/libstdc++-v3/doc/html/manual/backwards.html
    trunk/libstdc++-v3/doc/html/manual/bitmap_allocator_impl.html
    trunk/libstdc++-v3/doc/html/manual/bugs.html
    trunk/libstdc++-v3/doc/html/manual/concurrency.html
    trunk/libstdc++-v3/doc/html/manual/configure.html
    trunk/libstdc++-v3/doc/html/manual/containers.html
    trunk/libstdc++-v3/doc/html/manual/debug.html
    trunk/libstdc++-v3/doc/html/manual/debug_mode_using.html
    trunk/libstdc++-v3/doc/html/manual/diagnostics.html
    trunk/libstdc++-v3/doc/html/manual/documentation_hacking.html
    trunk/libstdc++-v3/doc/html/manual/ext_compile_checks.html
    trunk/libstdc++-v3/doc/html/manual/ext_preface.html
    trunk/libstdc++-v3/doc/html/manual/extensions.html
    trunk/libstdc++-v3/doc/html/manual/facets.html
    trunk/libstdc++-v3/doc/html/manual/index.html
    trunk/libstdc++-v3/doc/html/manual/intro.html
    trunk/libstdc++-v3/doc/html/manual/io.html
    trunk/libstdc++-v3/doc/html/manual/iterators.html
    trunk/libstdc++-v3/doc/html/manual/localization.html
    trunk/libstdc++-v3/doc/html/manual/memory.html
    trunk/libstdc++-v3/doc/html/manual/numerics.html
    trunk/libstdc++-v3/doc/html/manual/parallel_mode.html
    trunk/libstdc++-v3/doc/html/manual/parallel_mode_using.html
    trunk/libstdc++-v3/doc/html/manual/policy_data_structures.html
    trunk/libstdc++-v3/doc/html/manual/policy_data_structures_design.html
    trunk/libstdc++-v3/doc/html/manual/policy_data_structures_using.html
    trunk/libstdc++-v3/doc/html/manual/profile_mode.html
    trunk/libstdc++-v3/doc/html/manual/profile_mode_design.html
    trunk/libstdc++-v3/doc/html/manual/profile_mode_diagnostics.html
    trunk/libstdc++-v3/doc/html/manual/status.html
    trunk/libstdc++-v3/doc/html/manual/std_contents.html
    trunk/libstdc++-v3/doc/html/manual/strings.html
    trunk/libstdc++-v3/doc/html/manual/support.html
    trunk/libstdc++-v3/doc/html/manual/test.html
    trunk/libstdc++-v3/doc/html/manual/unordered_associative.html
    trunk/libstdc++-v3/doc/html/manual/using.html
    trunk/libstdc++-v3/doc/html/manual/using_exceptions.html
    trunk/libstdc++-v3/doc/html/manual/using_headers.html
    trunk/libstdc++-v3/doc/html/manual/utilities.html
    trunk/libstdc++-v3/doc/xml/manual/debug.xml
    trunk/libstdc++-v3/doc/xml/manual/status_cxx2011.xml


^ permalink raw reply	[flat|nested] 10+ messages in thread

* [Bug libstdc++/57226] The installation of pretty printers is not documented
  2013-05-09 10:46 [Bug libstdc++/57226] New: The installation of pretty printers is not documented morandini at aero dot polimi.it
                   ` (7 preceding siblings ...)
  2014-01-29 23:47 ` redi at gcc dot gnu.org
@ 2014-01-29 23:48 ` redi at gcc dot gnu.org
  8 siblings, 0 replies; 10+ messages in thread
From: redi at gcc dot gnu.org @ 2014-01-29 23:48 UTC (permalink / raw)
  To: gcc-bugs

http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57226

Jonathan Wakely <redi at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|ASSIGNED                    |RESOLVED
         Resolution|---                         |FIXED
   Target Milestone|---                         |4.9.0

--- Comment #8 from Jonathan Wakely <redi at gcc dot gnu.org> ---
fixed for 4.9.0


^ permalink raw reply	[flat|nested] 10+ messages in thread

end of thread, other threads:[~2014-01-29 23:48 UTC | newest]

Thread overview: 10+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2013-05-09 10:46 [Bug libstdc++/57226] New: The installation of pretty printers is not documented morandini at aero dot polimi.it
2013-05-09 12:49 ` [Bug libstdc++/57226] " redi at gcc dot gnu.org
2013-05-09 13:32 ` marco.morandini at polimi dot it
2013-05-09 13:34 ` marco.morandini at polimi dot it
2013-05-09 13:46 ` redi at gcc dot gnu.org
2013-05-09 15:55 ` morandini at aero dot polimi.it
2013-05-09 16:16 ` redi at gcc dot gnu.org
2013-10-07 12:31 ` redi at gcc dot gnu.org
2014-01-29 23:47 ` redi at gcc dot gnu.org
2014-01-29 23:48 ` redi at gcc dot gnu.org

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).