From owner-freebsd-doc@freebsd.org Sat Jul 18 22:22:52 2015 Return-Path: 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 D65049A4389 for ; Sat, 18 Jul 2015 22:22:52 +0000 (UTC) (envelope-from allanjude@freebsd.org) Received: from mx1.scaleengine.net (mx1.scaleengine.net [209.51.186.6]) by mx1.freebsd.org (Postfix) with ESMTP id 97C441DE6 for ; Sat, 18 Jul 2015 22:22:52 +0000 (UTC) (envelope-from allanjude@freebsd.org) Received: from [10.1.1.2] (unknown [10.1.1.2]) (Authenticated sender: allanjude.freebsd@scaleengine.com) by mx1.scaleengine.net (Postfix) with ESMTPSA id C455293BB for ; Sat, 18 Jul 2015 22:22:51 +0000 (UTC) Subject: Re: What is the proper indent style for FDP? To: freebsd-doc@freebsd.org References: <55AACF8D.3060000@gmail.com> <55AAD0CC.5030001@freebsd.org> From: Allan Jude Message-ID: <55AAD1DB.6000903@freebsd.org> Date: Sat, 18 Jul 2015 18:23:23 -0400 User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:38.0) Gecko/20100101 Thunderbird/38.1.0 MIME-Version: 1.0 In-Reply-To: <55AAD0CC.5030001@freebsd.org> Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="qWLg8Gr4HHxjrOwJEtf0WnXVbJNrIJSoO" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 18 Jul 2015 22:22:53 -0000 This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --qWLg8Gr4HHxjrOwJEtf0WnXVbJNrIJSoO Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: quoted-printable On 2015-07-18 18:18, Allan Jude wrote: > On 2015-07-18 18:13, Hoyoung Kim wrote: >> Hello. I'm curious about indentation style. >> Which is the proper one when dealing with FDP xml files? >> >> The original FDP files follow the style like this: >> >> We have tried to keep the number of forward references in >> the text to a minimum so that you can read this section of the= >> Handbook from front to back with the minimum page flipping >> required. >> >> This is another example: >> >> >> Introduce you to X, the &unix; windowing system, and >> detail how to configure a desktop environment that makes >> you more productive. >> >> >> However, when I press P in Vim Visual mode to reformat selected text, >> the style changes like this: >> >> We have tried to keep the number of forward references in >> the text to a minimum so that you can read this section of the >> Handbook from front to back with the minimum page flipping >> required. >> >> And this: >> >> Introduce you to X, the &unix; windowing >> system, and detail how to configure a desktop environment that >> makes you more productive. >> >> All the original files follow the former style, but FDP Primer suggest= s >> the latter style. >> (https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/editor-c= onfig.html#editor-config-vim) >> >> >> I want to know whether the latter style is allowed or not. Should I >> manually indent paragraphs after pressing P? >> >> Thanks. >> _______________________________________________ >> freebsd-doc@freebsd.org mailing list >> http://lists.freebsd.org/mailman/listinfo/freebsd-doc >> To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"= >=20 > https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/writing-st= yle-guide.html#writing-style-indentation >=20 > two spaces per indent, one indent per tag. 8 spaces =3D a real tab. No > spaces before a real tab. No whitespace at the end of the line. >=20 To answer your question better, the content of the should be indented, so the vim auto-formatting is not doing it correctly. The first 2 examples are correct --=20 Allan Jude --qWLg8Gr4HHxjrOwJEtf0WnXVbJNrIJSoO Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.22 (MingW32) iQIcBAEBAgAGBQJVqtHbAAoJEBmVNT4SmAt+DpEP/A8g7SM/RqowZCZN8l8mqtqI ey60wisjYpxrJQTWjmKOU3GaBE3p/gHSIT3p0ghEABiyGmKf3Ur6gPVaR99v2lri ZIDdkUkpjOafWjY4Bu9YWoB79Tas6PHlXS6Zpf3LaSUBlsWscfDRRDswHSVnRuuu N5SsgTbc4zfzJkoeeq9WPYhW7VS8XvgCItidKlIEryOWKK40S4jNTl/IEBm3k5pG S/hXU8kLu3B5ABUIchmTh46JsGHnLWVnoR3outxpcTUb4Am0xxUeQzPVbYj97kxU sr9lXJcSbHA88Vt+g8HOgmpKzpcTMiqQZQwZL6yUN+VIFy7OC1m/NA7ukVOcX0e/ iNDD9vwhcXpLKJfxhwcX+ryUP3oWXO4AJj1YQRDp/KlBz/FwzB4aDAfqUUG4vN1t KntjaslPeQv8bUMn74p1hF6KBBFSWv2b5M+ednCII2K6JuGpJ7gfbKiM9vf3lOU3 RuyX0W5IXHjml0WZZjz2vzF66gtjzg24ioHJRgzK134jYBAvt0WenzQnmTC6ljvi D2caJ6u/AjBqEgNBJt7FBQf406yDo53X2CiONIosms4BUZLXH664RQE+AoY4todT QmX3afGtYfatSuV8CHB9cdFapHkcXgR1P0+DbokX9SIgswFEdG3DAgfRUT1Lv47P /2PmIKvz+Eifs1kSjjuV =OPy9 -----END PGP SIGNATURE----- --qWLg8Gr4HHxjrOwJEtf0WnXVbJNrIJSoO--