From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <thomas.monjalon@6wind.com>
Received: from mail-wg0-f44.google.com (mail-wg0-f44.google.com [74.125.82.44])
 by dpdk.org (Postfix) with ESMTP id 0EDF0683D
 for <dev@dpdk.org>; Tue, 31 Mar 2015 14:24:03 +0200 (CEST)
Received: by wgoe14 with SMTP id e14so16917759wgo.0
 for <dev@dpdk.org>; Tue, 31 Mar 2015 05:24:02 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20130820;
 h=x-gm-message-state:from:to:cc:subject:date:message-id:organization
 :user-agent:in-reply-to:references:mime-version
 :content-transfer-encoding:content-type;
 bh=jMOAXbExKnfzImQDdZCRQbE7TrIM5WJO8Ad/ogVcj2M=;
 b=Fh7T4n+NoSXwH2KmLo7Q+zKTS5Zyl/LSUp7Gq/fo+WTkgiT/3aWL1eM7gxFAc7aLd8
 rg4qZ2Y6PCDeNRzFE4ps0MwysgGOpLvPchg5Sfzmq7zbLHdCqCF065Pej3Kiqm9ufZdr
 G/G1IuXuh9h/8UehJQEAGh2/PlAKuJerC4uRDXPSLM+KrfSu/IhRVm3+GX456jggRRL6
 84/D/1AhiBi/1eNKDz21JtvwNqben7Qn0nfboBQclUEx2ti8hoo8Er50kc2c+tbxFbBQ
 XeCiV8+HWRRefIulIOsdos+H6vakVeiUBIARrSEZPFmXPmPiwvfgFEwQvMQoadt4i5pw
 icmQ==
X-Gm-Message-State: ALoCoQkST+JESGoOWnG2y8ebrrnNKPxUBUSXBE8nIpDcXcrCYib/U4ehBgK1pL47kN/ccpdCpQmD
X-Received: by 10.194.60.203 with SMTP id j11mr74861310wjr.5.1427804642861;
 Tue, 31 Mar 2015 05:24:02 -0700 (PDT)
Received: from xps13.localnet (136-92-190-109.dsl.ovh.fr. [109.190.92.136])
 by mx.google.com with ESMTPSA id kr5sm20152494wjc.1.2015.03.31.05.24.01
 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);
 Tue, 31 Mar 2015 05:24:01 -0700 (PDT)
From: Thomas Monjalon <thomas.monjalon@6wind.com>
To: "Mcnamara, John" <john.mcnamara@intel.com>
Date: Tue, 31 Mar 2015 14:23:22 +0200
Message-ID: <7323830.CD7zFSQOoV@xps13>
Organization: 6WIND
User-Agent: KMail/4.14.4 (Linux/3.18.4-1-ARCH; KDE/4.14.4; x86_64; ; )
In-Reply-To: <B27915DBBA3421428155699D51E4CFE2F001CD@IRSMSX103.ger.corp.intel.com>
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-Transfer-Encoding: 7Bit
Content-Type: text/plain; charset="us-ascii"
Cc: dev@dpdk.org
Subject: Re: [dpdk-dev] [PATCH v2 0/3] split programmers guide a bit
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: patches and discussions about DPDK <dev.dpdk.org>
List-Unsubscribe: <http://dpdk.org/ml/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://dpdk.org/ml/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <http://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
X-List-Received-Date: Tue, 31 Mar 2015 12:24:03 -0000

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.