From owner-freebsd-doc@FreeBSD.ORG  Thu Feb  8 14:27:02 2007
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@freebsd.org
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 94C3816A4AB
	for <freebsd-doc@freebsd.org>; Thu,  8 Feb 2007 14:26:59 +0000 (UTC)
	(envelope-from joseph.koshy@gmail.com)
Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.172])
	by mx1.freebsd.org (Postfix) with ESMTP id C6CAC13C4A8
	for <freebsd-doc@freebsd.org>; Thu,  8 Feb 2007 14:26:57 +0000 (UTC)
	(envelope-from joseph.koshy@gmail.com)
Received: by ug-out-1314.google.com with SMTP id o2so447889uge
	for <freebsd-doc@freebsd.org>; Thu, 08 Feb 2007 06:26:56 -0800 (PST)
DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta;
	h=received:message-id:date:from:to:subject:mime-version:content-type:content-transfer-encoding:content-disposition;
	b=hC7NxzR/AhjXOt4FqItkuHnKZ7gMfj4btfG7AbO3YsXhp6Wn/f3nx7+46dRiPEi2q6jSAYWrQW3Kki7D3nacPGAbuYVzb0w3xxTvamGpAfYQep6TfWNA/ysGWORh2YXBEMrE7dS7ETfF9vT4mU5tQi+III0ZAHScZE8k36w0ARg=
Received: by 10.78.157.8 with SMTP id f8mr4118676hue.1170944816480;
	Thu, 08 Feb 2007 06:26:56 -0800 (PST)
Received: by 10.78.81.12 with HTTP; Thu, 8 Feb 2007 06:26:56 -0800 (PST)
Message-ID: <84dead720702080626x308a5bb3o5e88f0895fa438e5@mail.gmail.com>
Date: Thu, 8 Feb 2007 19:56:56 +0530
From: "Joseph Koshy" <joseph.koshy@gmail.com>
To: freebsd-doc@freebsd.org
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Subject: New tutorial: "libelf by Example"
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/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: Thu, 08 Feb 2007 14:27:02 -0000

Folks,

I've put up a draft of a tutorial introduction to the
ELF(3)/GELF(3) API in FreeBSD -current at the following
URL:

  http://people.freebsd.org/~jkoshy/download/libelf/article.html

Your comments (on the content, style, figures, etc., etc.)
are solicited.

The original DocBook/SGML source to the tutorial may be
viewed at:

http://perforce.freebsd.org/depotTreeBrowser.cgi?FSPC=//depot/user/jkoshy/projects/libbsdelf/doc/...

The figures in the tutorial have been drawn using
Metapost (which is part of the teTeX package and
thus part of our documentation toolchain).

There is a little bit of ugliness with respect to the
way <co> elements get numbered and rendered.  Using
<coref> elements could solve this problem, but <coref>
is not part of DocBook v4.1.  We'll need to bring in
DocBook v4.5 and update our freebsd.dsl macros to
cope.

--
FreeBSD Volunteer,     http://people.freebsd.org/~jkoshy