From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-90183-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 10905 invoked by alias); 22 Apr 2012 15:41:24 -0000
Received: (qmail 10885 invoked by uid 22791); 22 Apr 2012 15:41:23 -0000
X-SWARE-Spam-Status: No, hits=-2.3 required=5.0	tests=AWL,BAYES_00,KHOP_THREADED,RCVD_IN_DNSWL_NONE,RCVD_IN_HOSTKARMA_NO,SPF_SOFTFAIL
X-Spam-Check-By: sourceware.org
Received: from mtaout21.012.net.il (HELO mtaout21.012.net.il) (80.179.55.169)    by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Sun, 22 Apr 2012 15:41:07 +0000
Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0M2W00H000RR0X00@a-mtaout21.012.net.il> for gdb-patches@sourceware.org; Sun, 22 Apr 2012 18:41:00 +0300 (IDT)
Received: from HOME-C4E4A596F7 ([84.229.249.186]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0M2W00GUF0WBYX20@a-mtaout21.012.net.il>; Sun, 22 Apr 2012 18:41:00 +0300 (IDT)
Date: Sun, 22 Apr 2012 15:51:00 -0000
From: Eli Zaretskii <eliz@gnu.org>
Subject: Re: [doc patch] auto-load safe-path formatting fix
In-reply-to: <20120422153250.GA13101@host2.jankratochvil.net>
To: Jan Kratochvil <jan.kratochvil@redhat.com>
Cc: gdb-patches@sourceware.org
Reply-to: Eli Zaretskii <eliz@gnu.org>
Message-id: <838vhnhizu.fsf@gnu.org>
References: <20120422153250.GA13101@host2.jankratochvil.net>
X-IsSubscribed: yes
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb-patches.sourceware.org>
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
X-SW-Source: 2012-04/txt/msg00718.txt.bz2

> Date: Sun, 22 Apr 2012 17:32:50 +0200
> From: Jan Kratochvil <jan.kratochvil@redhat.com>
> 
> the first line was not separate from its text, in both .info and in .pdf,
> mostly obvious.

Thanks.

> I would prefer just '@table' without formatting (not '@table @code') but one
> has to put something there.

That's what "@asis" is for.

However,...

> -@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.

The problem here was that the formatting of the original @item line
was incorrect.  In an itemized list, @item should be on a line by
itself, like this:

  @itemize @bullet
  @item
  In @file{~/.gdbinit}: @code{add-auto-load-safe-path ~/src/gdb}.
  Specify this trusted directory (or a file) as additional component of the list.

Etc.

I don't mind going to @table, if you find that prettier.  But please
do use @asis, and then give each part its correct markup (@file,
@code, @kbd, etc.).

Thanks.