This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [doc patch] auto-load safe-path formatting fix
- From: Eli Zaretskii <eliz at gnu dot org>
- To: Jan Kratochvil <jan dot kratochvil at redhat dot com>
- Cc: gdb-patches at sourceware dot org
- Date: Sun, 22 Apr 2012 18:41:09 +0300
- Subject: Re: [doc patch] auto-load safe-path formatting fix
- References: <20120422153250.GA13101@host2.jankratochvil.net>
- Reply-to: Eli Zaretskii <eliz at gnu dot org>
> 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.