From owner-freebsd-doc@FreeBSD.ORG Wed Apr 30 06:29:42 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B2DBA37B40F; Wed, 30 Apr 2003 06:29:42 -0700 (PDT) Received: from www.reppep.com (www.reppep.com [66.92.104.200]) by mx1.FreeBSD.org (Postfix) with ESMTP id ECE1643F3F; Wed, 30 Apr 2003 06:29:41 -0700 (PDT) (envelope-from pepper@reppep.com) Received: from [129.85.219.160] (salt.rockefeller.edu [129.85.219.160]) by www.reppep.com (Postfix) with ESMTP id 5A808FDC9; Wed, 30 Apr 2003 09:29:44 -0400 (EDT) Mime-Version: 1.0 X-Sender: pepper@mail.reppep.com Message-Id: In-Reply-To: <20030430090032.GL32395@clan.nothing-going-on.org> References: <20030428183759.M89408@pakastelohi.cypherpunks.to> <20030430090032.GL32395@clan.nothing-going-on.org> Date: Wed, 30 Apr 2003 09:28:44 -0400 To: Nik Clayton From: Chris Pepper Content-Type: text/plain; charset="us-ascii" ; format="flowed" cc: Lucky Green cc: freebsd-docs@freebsd.org Subject: Re: "PROGRAMLISTING", "TITLE" not permitted X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 30 Apr 2003 13:29:43 -0000 At 10:00 AM +0100 2003/04/30, Nik Clayton wrote: >[1] >http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/writing-style.html#AEN3228 A good reference, but it confuses me a bit. According to "Content within elements should be indented by two spaces if the content runs over more than one line.", shouldn't the 'which' inside the be indented two more spaces, or should it say "Content within BLOCK elements"? Chris Pepper >10.1.2 Indentation > >Each file starts with indentation set at column 0, regardless of the >indentation level of the file which might contain this one. > >Opening tags increase the indentation level by 2 spaces. >Closing tags decrease the indentation level by 2 spaces. >Blocks of 8 spaces at the start of a line should be >replaced with a tab. Do not use spaces in front of tabs, >and do not add extraneous whitespace at the end of a line. >Content within elements should be indented by two spaces >if the content runs over more than one line. > >For example, the source for this section looks something like: >+--- This is column 0 >V > > ... > > > ... > > > Indentation > > Each file starts with indentation set at column 0, > regardless of the indentation level of the file > which might contain this one. -- Chris Pepper: Rockefeller University: