From owner-freebsd-doc@FreeBSD.ORG  Mon Apr  7 16:23:35 2014
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 7EA487C6;
 Mon,  7 Apr 2014 16:23:35 +0000 (UTC)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "wonkity.com", Issuer "wonkity.com" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id 2DF7435D;
 Mon,  7 Apr 2014 16:23:34 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.8/8.14.8) with ESMTP id s37GNX2V037656
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Mon, 7 Apr 2014 10:23:33 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.8/8.14.8/Submit) with ESMTP id s37GNXtx037653;
 Mon, 7 Apr 2014 10:23:33 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Mon, 7 Apr 2014 10:23:33 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Brad Davis <brd@FreeBSD.org>
Subject: Re: HandBook DNS Chapter
In-Reply-To: <20140407161032.GC27199@valentine.liquidneon.com>
Message-ID: <alpine.BSF.2.00.1404071013190.37586@wonkity.com>
References: <20140407161032.GC27199@valentine.liquidneon.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Mon, 07 Apr 2014 10:23:33 -0600 (MDT)
Cc: freebsd-doc@FreeBSD.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 07 Apr 2014 16:23:35 -0000

On Mon, 7 Apr 2014, Brad Davis wrote:

> Hi Everyone,
>
> I am slowly working on moderinzing the DNS chapter. One of the first
> things I need to fix is to put all the BIND content into its own sub
> section. If I do that, the indentation of almost the entire chapter will
> need to shift in one level. So I am seeking your advice for how to do
> this best. Ideally something like tidy(1) would be able to fix the
> indentation for me. What do you think is the best way to solve this
> problem?

At present, I'm not aware of an automatic way to do that.  We definitely 
have a need for a program that will take arbitrary DocBook XML files, 
parse them, and reformat them with our indentation rules.

For manual changes, editors/geany will indent or unindent sections while 
keeping track of tabs and spaces.  If configured that way, anyway, and 
I'm not sure of all the settings (but it works here).

Start highlighting and stop when you get to the first line of a <screen> 
or <programlisting> element.  Change indent level (ctrl-i, ctrl-u), then 
skip over the <screen> or <programlisting> and repeat.

Of course, this should be done as part of a whitespace-only cleanup. 
When the indent changes, lines often need to be rewrapped. 
textproc/igor can help locate problems.