From owner-freebsd-hackers@FreeBSD.ORG Sun Aug 24 20:07:40 2008 Return-Path: Delivered-To: freebsd-hackers@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id AF7AC1065670 for ; Sun, 24 Aug 2008 20:07:40 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: from nf-out-0910.google.com (nf-out-0910.google.com [64.233.182.186]) by mx1.freebsd.org (Postfix) with ESMTP id 4C2F48FC14 for ; Sun, 24 Aug 2008 20:07:40 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: by nf-out-0910.google.com with SMTP id h3so702120nfh.33 for ; Sun, 24 Aug 2008 13:07:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :organization:user-agent:mime-version:to:subject:x-enigmail-version :content-type:content-transfer-encoding:sender; bh=83Fd66ENSNp5Mi+1GoP/KEI0PcjxzzP9SpM3+a3XWz4=; b=yH6k9sIIuR67Ozjq7N/PFkmzEj7ZgeAYmLHK52B17CTyLCivO+SC1l63m70r8g57il dz6IqHYsyQzO+YS8T8ogjvPMVtm4wFisTvoelgKFGZgDgHYjfjA06mkBxVK+K04ooIIx K9HIE6EOL+cUNKxztZ26bdsykjKcTqKip9FLg= DomainKey-Signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=gamma; h=message-id:date:from:organization:user-agent:mime-version:to :subject:x-enigmail-version:content-type:content-transfer-encoding :sender; b=Lubr/YzA/rlaGT7bOcdhXZYxRcXegGnTpPNn0fBfAwkN7hHVvPFPQFJPg4n09PMtmo 8YjQdzeTj/n/sWqLdTpfLo7CingO9XPJ2R9DciB1AKaceC+qp18n9xtzTaHHFTKS57Zy sI2v/qzEUgKIKQ+MKgGATxGPhRuzJ6cxOi1Q8= Received: by 10.210.119.5 with SMTP id r5mr5409801ebc.17.1219606926150; Sun, 24 Aug 2008 12:42:06 -0700 (PDT) Received: from ?192.168.0.1? ( [80.99.205.120]) by mx.google.com with ESMTPS id f6sm23326917nfh.12.2008.08.24.12.41.59 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sun, 24 Aug 2008 12:42:05 -0700 (PDT) Message-ID: <48B1B972.1090500@FreeBSD.org> Date: Sun, 24 Aug 2008 21:41:38 +0200 From: Gabor PALI Organization: The FreeBSD Project User-Agent: Thunderbird 2.0.0.14 (X11/20080521) MIME-Version: 1.0 To: freebsd-hackers@freebsd.org X-Enigmail-Version: 0.95.1 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= Subject: Request for Comments: Update to developers-handbook/policies X-BeenThere: freebsd-hackers@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Technical Discussions relating to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 24 Aug 2008 20:07:40 -0000 Dear Members, A few weeks ago, I started to work on docs/126030 [1] in cooperation with Gavin Atkinson (gavin@) and Giorgos Keramidas (keramida@) to update chapter ``Source Tree Guidelines and Policies'' of the ``FreeBSD Developers' Handbook'' [2]. Based on Gavin's original patch, I created drafts on how to fix the sections in question (and I linked them below). During the update, I found useful to include a section of Dag-Erling's Subversion Primer on the Wiki [3] about vendor imports. At the moment, I do not erase the old text (about vendor imports with CVS) but I kept it for compatibility reasons (and moved to a separate subsection as des@ advised). However, if somebody says it is deemed to be removed I will do that. Because I am not so experienced in vendor imports (as a doc committer) but I would like to help Gavin (and others who want this book updated), I ask you to review my changes and express your ideas, comments and suggestion. Note: This mail was posted to -doc a few days ago. I have not received any answer to it (maybe due to its highly technical nature), but I hope members of list will comment on this. Draft of section (5.1) MAINTAINER on Makefiles: http://people.freebsd.org/~pgj/for_review/2008-08-21/html/policies.html Draft of section (5.2) Contributed Software: http://people.freebsd.org/~pgj/for_review/2008-08-21/html/policies-contributed.html Diff for the curious: http://people.freebsd.org/~pgj/for_review/2008-08-21/books.developers-handbook.policies.diff Thank you in advance. Cheers, :g [1] http://www.freebsd.org/cgi/query-pr.cgi?pr=docs%2F126030 [2] http://www.freebsd.org/doc/en/books/developers-handbook [3] http://wiki.freebsd.org/SubversionPrimer/VendorImports