From owner-freebsd-doc@FreeBSD.ORG Thu Nov 25 21:55:47 2004 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 AAE1716A4CE for ; Thu, 25 Nov 2004 21:55:47 +0000 (GMT) Received: from kane.otenet.gr (kane.otenet.gr [195.170.0.27]) by mx1.FreeBSD.org (Postfix) with ESMTP id AA72843D2F for ; Thu, 25 Nov 2004 21:55:45 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from gothmog.gr (patr530-a039.otenet.gr [212.205.215.39]) iAPLtfN2014102; Thu, 25 Nov 2004 23:55:43 +0200 Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.13.1/8.13.1) with ESMTP id iAPLtWc0000748; Thu, 25 Nov 2004 23:55:32 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) Received: (from giorgos@localhost) by gothmog.gr (8.13.1/8.13.1/Submit) id iAPLsmgJ000729; Thu, 25 Nov 2004 23:54:48 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) Date: Thu, 25 Nov 2004 23:54:48 +0200 From: Giorgos Keramidas To: Tillman Hodgson Message-ID: <20041125215448.GA703@gothmog.gr> References: <20041124174258.GA28061@seekingfire.com> <20041125093510.GA4043@orion.daedalusnetworks.priv> <20041125153527.GA36101@seekingfire.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20041125153527.GA36101@seekingfire.com> cc: freebsd-doc@freebsd.org Subject: Re: [RFC] Kerberos5 chapter re-write 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: Thu, 25 Nov 2004 21:55:47 -0000 On 2004-11-25 09:35, Tillman Hodgson wrote: > On Thu, Nov 25, 2004 at 11:35:10AM +0200, Giorgos Keramidas wrote: > > On 2004-11-24 11:42, Tillman Hodgson wrote: > > > For the impatient: > > > =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- > > > The patch is at http://www.seekingfire.com/patches/kerberos5.patch > > > > Hi Tillman, > > I've locally made several changes to that patch. > > Sorry for not mailing you more often :-/ > > Hey, no problem. I wanted to get some exposure for the patch Good move. I still have in my =drafts folder a post to freebsd-doc with a copy of your patch. No wait, that's not needed anymore :-) > > The version I am working on can be found at: > > http://people.freebsd.org/~keramida/tillman-kerberos5.patch > > I've pulled a copy of that down and started to hand-compare it to the > original I had to see if I could pick up on areas where I had > technical docbook problems. Don't worry too much about this. I can send you a commented version of the patch you have at: http://www.seekingfire.com/patches/kerberos5.patch Then you can pick whatever suits you and integrate it to your copy :-) > It's kind of an awkward process, and diff'ing two patches is kind of > useless. Is there a better method than applying each copy to it's own > copy of the target file and then diff'ing the resulting patched files? I usually diff the two patches using the -T option of diff. It uses a TAB for indenting the diff output (which makes the output pretty useless for patch(1) input) so the two patches would look like this: - - original original line - + first patch version - original original line + - original original line + + second patch version + original original line The changes I did was mostly the change/addition of a few tags. Some foo stuff was replaced with &man.foo.8; entities. I've added a "Synopsis" section to sections that rendered like this: * Section title + Subsection title Text Text + Subsection title and fixed a few typos (s/In principal/In principle/ is one that I can remember off the top of my head. - Giorgos