[doc patch] auto-load safe-path formatting fix

Eli Zaretskii eliz@gnu.org
Sun Apr 22 15:51:00 GMT 2012


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



More information about the Gdb-patches mailing list