From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 14310 invoked by alias); 22 Apr 2012 15:33:13 -0000 Received: (qmail 14282 invoked by uid 22791); 22 Apr 2012 15:33:12 -0000 X-SWARE-Spam-Status: No, hits=-6.3 required=5.0 tests=AWL,BAYES_00,KHOP_RCVD_UNTRUST,RCVD_IN_DNSWL_HI,RCVD_IN_HOSTKARMA_W,SPF_HELO_PASS,T_RP_MATCHES_RCVD X-Spam-Check-By: sourceware.org Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Sun, 22 Apr 2012 15:32:55 +0000 Received: from int-mx12.intmail.prod.int.phx2.redhat.com (int-mx12.intmail.prod.int.phx2.redhat.com [10.5.11.25]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id q3MFWsp1002989 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sun, 22 Apr 2012 11:32:54 -0400 Received: from host2.jankratochvil.net (ovpn-116-17.ams2.redhat.com [10.36.116.17]) by int-mx12.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id q3MFWoRG021527 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO) for ; Sun, 22 Apr 2012 11:32:53 -0400 Date: Sun, 22 Apr 2012 15:41:00 -0000 From: Jan Kratochvil To: gdb-patches@sourceware.org Subject: [doc patch] auto-load safe-path formatting fix Message-ID: <20120422153250.GA13101@host2.jankratochvil.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.21 (2010-09-15) X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2012-04/txt/msg00717.txt.bz2 Hi Eli, the first line was not separate from its text, in both .info and in .pdf, mostly obvious. I would prefer just '@table' without formatting (not '@table @code') but one has to put something there. Most of the items override the formatting anyway. Thanks, Jan gdb/doc/ 2012-04-22 Jan Kratochvil * gdb.texinfo (Auto-loading safe path): Replace @itemize @bullet by @table @code. Fix formatting of one item. --- ./gdb/doc/gdb.texinfo 18 Apr 2012 07:03:58 -0000 1.945 +++ ./gdb/doc/gdb.texinfo 22 Apr 2012 15:21:35 -0000 @@ -21136,8 +21136,8 @@ init file in the current directory To force @value{GDBN} to load the files it declined to load in the previous example, you could use one of the following ways: -@itemize @bullet -@item ~/.gdbinit: add-auto-load-safe-path ~/src/gdb +@table @code +@item @file{~/.gdbinit}: @samp{add-auto-load-safe-path ~/src/gdb} Specify this trusted directory (or a file) as additional component of the list. You have to specify also any existing directories displayed by by @samp{show auto-load safe-path} (such as @samp{/usr:/bin} in this example). @@ -21155,20 +21155,20 @@ from trusted sources. During compilation of @value{GDBN} you may disable any auto-loading safety. This assumes all the files you will ever debug with this @value{GDBN} come from trusted sources. -@end itemize +@end table On the other hand you can also explicitly forbid automatic files loading which also suppresses any such warning messages: -@itemize @bullet +@table @code @item @kbd{gdb -iex "set auto-load no" [@dots{}]} You can use @value{GDBN} command-line option for a single @value{GDBN} session. -@item @samp{~/.gdbinit}: @samp{set auto-load no} +@item @file{~/.gdbinit}: @samp{set auto-load no} Disable auto-loading globally for the user (@pxref{Home Directory Init File}). While it is improbable, you could also use system init file instead (@pxref{System-wide configuration}). -@end itemize +@end table This setting applies to the file names as entered by user. If no entry matches @value{GDBN} tries as a last resort to also resolve all the file names into