From owner-freebsd-doc@freebsd.org  Sun Jul 19 14:58:57 2015
Return-Path: <owner-freebsd-doc@freebsd.org>
Delivered-To: freebsd-doc@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id BA31F9A5155
 for <freebsd-doc@mailman.ysv.freebsd.org>;
 Sun, 19 Jul 2015 14:58:57 +0000 (UTC)
 (envelope-from benedict@reuschling.org)
Received: from mxout1.bln1.prohost.de (mxout1.bln1.prohost.de [91.233.87.26])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256
 bits)) (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id 3F4DF18ED
 for <freebsd-doc@freebsd.org>; Sun, 19 Jul 2015 14:58:56 +0000 (UTC)
 (envelope-from benedict@reuschling.org)
Received: from Voyager.fritz.box (p4FC711CB.dip0.t-ipconnect.de
 [79.199.17.203]) (authenticated bits=0)
 by mx1.bln1.prohost.de (8.14.9/8.14.9) with ESMTP id t6JEwkY0016346
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO)
 for <freebsd-doc@freebsd.org>; Sun, 19 Jul 2015 16:58:47 +0200
Subject: Re: What is the proper indent style for FDP?
To: freebsd-doc@freebsd.org
References: <55AACF8D.3060000@gmail.com>
 <alpine.BSF.2.20.1507181653320.62620@wonkity.com>
From: Benedict Reuschling <benedict@reuschling.org>
X-Enigmail-Draft-Status: N1110
Message-ID: <55ABBB26.7050302@reuschling.org>
Date: Sun, 19 Jul 2015 16:58:46 +0200
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.10; rv:38.0)
 Gecko/20100101 Thunderbird/38.1.0
MIME-Version: 1.0
In-Reply-To: <alpine.BSF.2.20.1507181653320.62620@wonkity.com>
Content-Type: text/plain; charset=windows-1252
Content-Transfer-Encoding: 7bit
X-Null-Tag: da3aac1eaf1e34ea40c1904dbb0a1129
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.20
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 19 Jul 2015 14:58:57 -0000



Am 19.07.15 um 00:57 schrieb Warren Block:
> On Sun, 19 Jul 2015, Hoyoung Kim wrote:
>> Should I manually indent paragraphs after pressing P?
> 
> If the editor does not do it correctly, yes.
> 

It does not do it for the first line in the paragraph, but the rest is
fine. So what I do is I break the line with the <para> in it when the
number of characters per line are exceeded as normal. Then, I indent the
line below the <para> manually. Then, you can hit P and the rest of the
line and all those that follow in that paragraph should indent correctly.
It's not perfect, but still better than nothing, especially when there
are long paragraphs.

> Providing a default editor config does not suggest that editor does
> everything correctly.  vim users might be able to help more.  I have yet
> to find any editor that really does our indenting correctly.  Maybe some
> programming can improve on what vim or emacs does by default.

Yes, that would be great. Having some kind of formatter that
knows/follows our indentation rules would be good to have.