What is the proper indent style for FDP?

Hoyoung Kim trig4800 at gmail.com
Sat Jul 18 23:08:05 UTC 2015


Oh, I see. Thank you for reply :)

On 07/19/2015 07:23, Allan Jude wrote:
> 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:
>>>
>>>        <para>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.</para>
>>>
>>> This is another example:
>>>
>>>      <listitem>
>>>        <para>Introduce you to X, the &unix; windowing system, and
>>>          detail how to configure a desktop environment that makes
>>>          you more productive.</para>
>>>      </listitem>
>>>
>>> However, when I press P in Vim Visual mode to reformat selected text,
>>> the style changes like this:
>>>
>>>        <para>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.</para>
>>>
>>> And this:
>>>
>>>      <listitem> <para>Introduce you to X, the &unix; windowing
>>>      system, and detail how to configure a desktop environment that
>>>      makes you more productive.</para> </listitem>
>>>
>>> All the original files follow the former style, but FDP Primer suggests
>>> the latter style.
>>> (https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/editor-config.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 at freebsd.org mailing list
>>> http://lists.freebsd.org/mailman/listinfo/freebsd-doc
>>> To unsubscribe, send any mail to "freebsd-doc-unsubscribe at freebsd.org"
>> https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/writing-style-guide.html#writing-style-indentation
>>
>> two spaces per indent, one indent per tag. 8 spaces = a real tab. No
>> spaces before a real tab. No whitespace at the end of the line.
>>
> To answer your question better, the content of the <para> should be
> indented, so the vim auto-formatting is not doing it correctly.
>
> The first 2 examples are correct
>



More information about the freebsd-doc mailing list