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

--tVmo9FyGdCe4F4YN
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

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 lin=
e.

[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
--=20
Enjoy the beauty and power of root

--tVmo9FyGdCe4F4YN
Content-Type: application/pgp-signature
Content-Disposition: inline

-----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-----

--tVmo9FyGdCe4F4YN--

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message




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