From owner-freebsd-doc@freebsd.org Sat Jul 18 23:10:10 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 706759A4B82 for ; Sat, 18 Jul 2015 23:10:10 +0000 (UTC) (envelope-from trig4800@gmail.com) Received: from mail-pa0-x231.google.com (mail-pa0-x231.google.com [IPv6:2607:f8b0:400e:c03::231]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 41A311069 for ; Sat, 18 Jul 2015 23:10:10 +0000 (UTC) (envelope-from trig4800@gmail.com) Received: by pabkd10 with SMTP id kd10so8526211pab.2 for ; Sat, 18 Jul 2015 16:10:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=aeiT9sqB17e/OcHY9HDJP+I02eJIWcole+wdEVnraZ8=; b=xdqhlcKxvyGGCfT5qKEkACOboUxMXUOaXoxCXr9Qi7yl7dGkv3d2HYIVomRxpyjusH LaErMoDxUPnqtrrBlappedS7q6qwjtJgwvclr5+nWXQI2Q7tv1nWiMlkJ1XzQnG20BQm zroFVcIuXUfPp1MualJEICAUV5kskl4Wq5o7wrXAiZlrZeeS3SFWRx82oQay867zeAo5 kH0DPV6hF82Pk7at0Elm6QrSWpGYmFdaYl9vmNuwV0f+dWl/ocnYDi4mzZfaWnzfiReS FDWYLwreANL0c7VJ9vj5/u2ZBbshc7YUe93P+fWA1Zw4oIZ/3ZhalWD6b+GE157WAdEj lBKQ== X-Received: by 10.66.62.163 with SMTP id z3mr42723416par.12.1437261009867; Sat, 18 Jul 2015 16:10:09 -0700 (PDT) Received: from [10.0.1.5] ([121.167.148.73]) by smtp.googlemail.com with ESMTPSA id qs5sm15317202pbb.37.2015.07.18.16.10.08 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 18 Jul 2015 16:10:09 -0700 (PDT) Message-ID: <55AADCCE.1030909@gmail.com> Date: Sun, 19 Jul 2015 08:10:06 +0900 From: Hoyoung Kim User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:31.0) Gecko/20100101 Thunderbird/31.7.0 MIME-Version: 1.0 To: Warren Block CC: freebsd-doc@freebsd.org Subject: Re: What is the proper indent style for FDP? References: <55AACF8D.3060000@gmail.com> In-Reply-To: Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit 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 23:10:10 -0000 I got it. Thank you! On 07/19/2015 08:08, Warren Block wrote: > On Sat, 18 Jul 2015, Warren Block wrote: > >> On Sun, 19 Jul 2015, 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. >>> >> >> These are correct. > > To add to this, if editing an existing section, see > https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/writing-style-guide.html#writing-style-whitespace-changes > > > In short, whitespace-only changes to existing documents (indenting, > blank lines, adding spaces) should be kept separate from content > changes. Save them in a separate patch, for example.