From owner-freebsd-ports@FreeBSD.ORG  Mon Jul  7 03:16:02 2014
Return-Path: <owner-freebsd-ports@FreeBSD.ORG>
Delivered-To: freebsd-ports@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 376578A0
 for <freebsd-ports@freebsd.org>; Mon,  7 Jul 2014 03:16:02 +0000 (UTC)
Received: from astart2.astart.com
 (108-248-95-193.lightspeed.sndgca.sbcglobal.net [108.248.95.193])
 (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id 0EB712179
 for <freebsd-ports@freebsd.org>; Mon,  7 Jul 2014 03:16:01 +0000 (UTC)
Received: from laptop_84.private (localhost [127.0.0.1])
 by astart2.astart.com (8.14.4/8.14.4) with ESMTP id s673FwhN067440
 for <freebsd-ports@freebsd.org>; Sun, 6 Jul 2014 20:15:59 -0700 (PDT)
 (envelope-from papowell@astart.com)
Message-ID: <53BA10EE.2000302@astart.com>
Date: Sun, 06 Jul 2014 20:15:58 -0700
From: Patrick Powell <papowell@astart.com>
Reply-To: papowell@astart.com
Organization: Astart Technologies
User-Agent: Mozilla/5.0 (X11; FreeBSD amd64;
 rv:17.0) Gecko/20130714 Thunderbird/17.0.7
MIME-Version: 1.0
To: freebsd-ports@freebsd.org
Subject: Re: Some suggestions about PKGNG documentation
References: <201407051018.s65AIAsn011613@chilled.skew.org>
In-Reply-To: <201407051018.s65AIAsn011613@chilled.skew.org>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-ports>,
 <mailto:freebsd-ports-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-ports/>
List-Post: <mailto:freebsd-ports@freebsd.org>
List-Help: <mailto:freebsd-ports-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
 <mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 07 Jul 2014 03:16:02 -0000

On 07/05/14 03:18, Mike Brown wrote:
> Warren Block wrote:
>> The documentation team has a standing offer to either assist with markup
>> or accept content-only submissions and do the markup on them.
> That's good to know. I was under the impression it had to be submitted as
> DocBook XML. Thanks!
> _______________________________________________
> freebsd-ports@freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-ports
> To unsuXMbscribe, send any mail to "freebsd-ports-unsubscribe@freebsd.org"
>
OK.  Its been 10 years since I lasted looked at the FBSD documents. 
Nowever, I know SGML, XML,
and have written documents in them.

1. Point me to the source of one of the documents as a starting point.
2. Point me to the tools that I need to use to massage the document.
     (There used to be a Documenter's Handbook, is it still around?)

I will take one of these documents as a starting point and then update it.

HOWEVER...  I am hoping that one of the document team will 'proof' this 
for format and content.