From mboxrd@z Thu Jan  1 00:00:00 1970
From: Thomas Monjalon <thomas.monjalon-pdR9zngts4EAvxtiuMwx3w@public.gmane.org>
Subject: Re: [PATCH v2 0/3] split programmers guide a bit
Date: Tue, 31 Mar 2015 14:23:22 +0200
Message-ID: <7323830.CD7zFSQOoV@xps13>
References: <1422747307-13792-1-git-send-email-thomas.monjalon@6wind.com>
 <2548676.I0KaJlYG5K@xps13>
 <B27915DBBA3421428155699D51E4CFE2F001CD@IRSMSX103.ger.corp.intel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7Bit
Cc: dev-VfR2kkLFssw@public.gmane.org
To: "Mcnamara, John" <john.mcnamara-ral2JQCrhuEAvxtiuMwx3w@public.gmane.org>
Return-path: <dev-bounces-VfR2kkLFssw@public.gmane.org>
In-Reply-To: <B27915DBBA3421428155699D51E4CFE2F001CD-kPTMFJFq+rELt2AQoY/u9bfspsVTdybXVpNB7YpNyf8@public.gmane.org>
List-Id: patches and discussions about DPDK <dev.dpdk.org>
List-Unsubscribe: <http://dpdk.org/ml/options/dev>,
 <mailto:dev-request-VfR2kkLFssw@public.gmane.org?subject=unsubscribe>
List-Archive: <http://dpdk.org/ml/archives/dev/>
List-Post: <mailto:dev-VfR2kkLFssw@public.gmane.org>
List-Help: <mailto:dev-request-VfR2kkLFssw@public.gmane.org?subject=help>
List-Subscribe: <http://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request-VfR2kkLFssw@public.gmane.org?subject=subscribe>
Errors-To: dev-bounces-VfR2kkLFssw@public.gmane.org
Sender: "dev" <dev-bounces-VfR2kkLFssw@public.gmane.org>

2015-03-31 11:34, Mcnamara, John:
> Any objection to an additional patch to move the figure captions below
> the figures in the docs?

No objection.
We should use figure:: keyword instead of image:: to add a caption.

> The caption above the figure was the format used in the initial docs,
> and it looks okay in the HTML output, but in the PDF output it tends
> to get merged into the preceding paragraph and isn't always on the
> same page as the figure.

Yes, it's a bit strange.
Why moving it below will ensure to keep it in the same page?
I think figure:: keyword may solve it.