Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 3 Apr 2001 07:35:34 +0200
From:      Udo Erdelhoff <ue@nathan.ruhr.de>
To:        Jim Mock <jim@FreeBSD.org>
Cc:        cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org
Subject:   Re: cvs commit: doc/en_US.ISO_8859-1/books/faq book.sgml
Message-ID:  <20010403073533.E46362@nathan.ruhr.de>
In-Reply-To: <20010403011117.A2616@guinness.osdn.com>; from jim@FreeBSD.org on Tue, Apr 03, 2001 at 01:11:17AM -0400
References:  <20010402211043.A84692@dragon.nuxi.com> <20010403045455.0A3A93E09@bazooka.unixfreak.org> <20010403011117.A2616@guinness.osdn.com>

next in thread | previous in thread | raw e-mail | index | archive | help

[-- Attachment #1 --]
On Tue, Apr 03, 2001 at 01:11:17AM -0400, Jim Mock wrote:
> the markup in the FAQ was pretty mangled back then

That is an understatement...

> I haven't looked at it enough lately to comment on
> it's current state).

Things are a lot better now but there is still a lot of work to do...

> Either way, we should definitely put something in the Doc Project primer
> about this.  I could've swore there was a style section there already,
> but briefly looking now I don't see one.

The style section is in chapter 10 and chapter 10.1.2 contains the rules
for indentation. I think the rules are pretty straightforward:

1) Each file starts with indentation set at column 0, regardless of the
indentation level of the file which might contain this one.

2) Every start tag increases the indentation level by 2 SPACES, and every
end tag decreases the indentation level by 2 SPACES. Content within elements
should be indented by two SPACES if the content runs over more than one line.

[Emphasis and numbering added by me]

I do not see the word "tab" in there. But maybe it is time to add this word
to this chapter. As in "Do NOT use tabs."

/s/Udo
-- 
Enjoy the beauty and power of root

[-- Attachment #2 --]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.4 (FreeBSD)
Comment: For info see http://www.gnupg.org

iQCVAwUBOslhJUPoh1XnT6hxAQEpIQQAqYMreTzpiKDGtQgN2yI+XJG0RR+psHN9
iSuwTLm7MpemnBv1bG1Y22wpxaA/iUDCuPh9BH6ELZJ6bg1g5N4Iy8T2Ex3C+Br/
MJm76yN2h0mKeIBlCFqbm1Bsuh5GdpY8Ug4LwW2dmQo1x6FZJrdRxeXxsXdo76Wm
i0er1DSnTes=
=9TNT
-----END PGP SIGNATURE-----

Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010403073533.E46362>