From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <thomas.monjalon@6wind.com>
Received: from mail-wg0-f51.google.com (mail-wg0-f51.google.com [74.125.82.51])
 by dpdk.org (Postfix) with ESMTP id 880F57EB0
 for <dev@dpdk.org>; Wed,  3 Dec 2014 14:24:09 +0100 (CET)
Received: by mail-wg0-f51.google.com with SMTP id k14so19593576wgh.24
 for <dev@dpdk.org>; Wed, 03 Dec 2014 05:24:09 -0800 (PST)
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=6KWfRDZCgeQ5e2mTVoE6oqP8otUXCigt6DIE06Ga2DU=;
 b=LaDQQRnHDhJIIxbwZ2irCYeyKmeaj68X1WmE4vRbhwtW0NIVK4/5ywtzy+rC+db0gw
 ArigSNIsNYerCD5KP7Xv64QZxOeqdVqc+aMZ6d7BrJMiJVMe6bZe4uKWE3mvu4WCstp6
 QKgGFSYrfMeRIMDVUgckiS4e+6qXvq/IOq9Oytu1TIrfLPqj07KRJ8lAJVP431OqKAXA
 gPa6ZWdmstJ28fbYrfVwataMsSccBTl/1MM4+vLTt1xa31Z+2pLQXq50EN5mu7GnH/sD
 SaW8c+eL0pjqsqxaqkcz+HrY2RAt2Ewkyv53wN4Z49qT6IfmbaWYPFRqSd6PpZ47jdTz
 4aIg==
X-Gm-Message-State: ALoCoQlzItvqboTMZhi2dBQWRNX9fLDqqGL9wLKQCnXag0Z/8hg7HJSZq7xPkSsBLP4/FK1j+kdF
X-Received: by 10.194.193.2 with SMTP id hk2mr7273714wjc.40.1417613049332;
 Wed, 03 Dec 2014 05:24:09 -0800 (PST)
Received: from xps13.localnet (guy78-3-82-239-227-177.fbx.proxad.net.
 [82.239.227.177])
 by mx.google.com with ESMTPSA id iz19sm50758493wic.8.2014.12.03.05.24.08
 for <multiple recipients>
 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);
 Wed, 03 Dec 2014 05:24:08 -0800 (PST)
From: Thomas Monjalon <thomas.monjalon@6wind.com>
To: Bruce Richardson <bruce.richardson@intel.com>
Date: Wed, 03 Dec 2014 14:23:44 +0100
Message-ID: <2191619.2K2FXEFzNY@xps13>
Organization: 6WIND
User-Agent: KMail/4.14.3 (Linux/3.17.4-1-ARCH; KDE/4.14.3; x86_64; ; )
In-Reply-To: <1416844136-4604-1-git-send-email-bruce.richardson@intel.com>
References: <1416839034-26652-1-git-send-email-bruce.richardson@intel.com>
 <1416844136-4604-1-git-send-email-bruce.richardson@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 2/3] docs: adjust line lengths in FreeBSD GSG
	rst files
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: Wed, 03 Dec 2014 13:24:09 -0000

2014-11-24 15:48, Bruce Richardson:
> The FreeBSD GSG rst files had very inconsistent line lengths for text
> within paragraph blocks. Sometimes a line would be very short, while often
> lines would be quite long.
> This patch adjusts the formatting of the rst files so that lines break
> at approx the 80-character mark, as is standard in the DPDK source code.

I'm not sure we should be strict with line lengths in the doc.
The most important thing is to limit the wrapping impact of future patches.
Starting a new sentence at the beginning of the line is often a good way
to keep context lines unchanged when updating only one sentence.
Don't forget that a carriage return in rst has no impact on generated doc.

-- 
Thomas