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@freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscr...@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.

-- 
Allan Jude

Attachment: signature.asc
Description: OpenPGP digital signature

Reply via email to