Date: Tue, 24 Jul 2007 14:43:56 +0200 From: "Simon L. Nielsen" <simon@FreeBSD.org> To: "Peter N. M. Hansteen" <peter@bsdly.net>, freebsd-doc@freebsd.org, Giorgos Keramidas <keramida@freebsd.org>, Mark Linimon <linimon@lonesome.com>, Chin-San Huang <chinsan@freebsd.org> Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml Message-ID: <20070724124356.GB1065@zaphod.nitro.dk> In-Reply-To: <20070724123159.GA37556@abigail.blackend.org> References: <200707190121.l6J1LOvd007607@repoman.freebsd.org> <20070719054803.GA1002@gothic.blackend.org> <469F1D0F.2090307@FreeBSD.org> <20070719125410.GA9766@kobe.laptop> <20070720101143.GB1002@gothic.blackend.org> <20070724081342.GA32106@soaustin.net> <20070724094216.GA1003@zaphod.nitro.dk> <87vecam7ym.fsf@thingy.datadok.no> <20070724123159.GA37556@abigail.blackend.org>
next in thread | previous in thread | raw e-mail | index | archive | help
[Moved entirely to doc since his is certainly a general discussion now] On 2007.07.24 14:32:00 +0200, Marc Fonvieille wrote: > I also agree but Giorgos and Mark's ideas are interesting. > Adding, removing, upgrading applications is one of the most important > managing task for the normal user. I would even add this task is maybe > the only one a normal user will use to perform on a frequent basis, once > the system has been installed. So, it's difficult to imagine the > Handbook without a chapter about these operations. Indeed. > But this normal user > doesn't need to become a ports system expert, he just need to know > simple/general methods to install, remove and upgrade his applications. > The specific/expert methods (and tools?) should be the subject of > specific articles or parts of the Porters Handbook. I think at least one tool should be documented in the Handbook so the common user will be able to get by just reading the Handbook. I don't have a problem at with more advanced stuff or other more uncommon tools being moved out of the Handbook. Note that the Porters Handbook is for port maintainers / developers / committers so this information for users really doesn't belong there, as Mark already has pointed out. In any case, as usual, the person / people who decide to actually do some cleanup in the area will get to decide what to do, and I doubt that will be me. -- Simon L. Nielsen
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20070724124356.GB1065>