From owner-freebsd-ports@FreeBSD.ORG Sat Jun 12 08:04:12 2004 Return-Path: Delivered-To: freebsd-ports@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E071516A4CE; Sat, 12 Jun 2004 08:04:12 +0000 (GMT) Received: from fillmore.dyndns.org (port-212-202-50-15.dynamic.qsc.de [212.202.50.15]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5A23F43D41; Sat, 12 Jun 2004 08:04:12 +0000 (GMT) (envelope-from eikemeier@fillmore-labs.com) Received: from [172.16.0.13] (helo=localhost) by fillmore.dyndns.org with esmtp (TLSv1:DES-CBC3-SHA:168) (Exim 4.34 (FreeBSD)) id 1BZ3UV-000KJw-7V; Sat, 12 Jun 2004 10:03:53 +0200 Date: Sat, 12 Jun 2004 10:03:52 +0200 Content-Type: text/plain; charset=WINDOWS-1252; format=flowed Mime-Version: 1.0 (Apple Message framework v482) To: Mark Linimon From: Oliver Eikemeier In-Reply-To: Message-Id: <0B22E3DA-BC47-11D8-B633-00039312D914@fillmore-labs.com> Content-Transfer-Encoding: quoted-printable User-Agent: KMail/1.5.9 cc: ports-developers@FreeBSD.org cc: freebsd-ports@FreeBSD.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/faq book.sgml (fwd) X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 12 Jun 2004 08:04:13 -0000 Am Samstag den, 12. Juni 2004, um 04:06, schrieb Mark Linimon: > FYI. This should be publically available in the next 24 hours. > > I do not think it will be controversial so I skipped the pre-review, > but I won't object if it needs to be reworded. You should call it "why I should not try to build the INDEX and don't complain when I'm failing to do so". Just a joke. Honestly, great job. You might want to mention downloading the INDEX as an alternative (there is a fetchindex target in the queue, otherwise you could always do fetch -o /usr/ports/INDEX http://www.freebsd.org/ports/INDEX on -STABLE) and possible problems someone can run into when installing the ports tree from a release CD and CVSup it afterwards, find /usr/ports -name README.html -delete should help here (not tested, ask lofi for more input). Also, people should be told to check whether they have an *up-to-date* *complete* ports collection twice (possibly with the explanation _why_ moved to an extra clause, at least I had problems following it which may be my fault). The most common problems to look for are having some language categorie in the CVSup refuse file, which either results in not having this categorie at all (easy to spot) or this part of the tree to be out of date and excluded from updating (harder to spot, because stuff does not fail immediately). I know this is mentioned in the article, but it can't hurt to mention the most common case, since this is a FAQ. Generally one should ask himself why one needs to build the INDEX (instead of just downloading it), and, if deciding to do so, consider this to be part of a sanity check of the local ports tree. Just my 2 =A2 (0.02=80) -Oliver