Date: Sat, 18 Jul 2015 16:57:56 -0600 (MDT) From: Warren Block <wblock@wonkity.com> To: Hoyoung Kim <trig4800@gmail.com> Cc: freebsd-doc@freebsd.org Subject: Re: What is the proper indent style for FDP? Message-ID: <alpine.BSF.2.20.1507181653320.62620@wonkity.com> In-Reply-To: <55AACF8D.3060000@gmail.com> References: <55AACF8D.3060000@gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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: > > <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> These are correct. > 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> These are not correct. > 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. No, the first style is the correct way. > Should I manually indent paragraphs after pressing P? If the editor does not do it correctly, yes. 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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.BSF.2.20.1507181653320.62620>