From owner-freebsd-ports@freebsd.org  Wed Dec  6 16:04:14 2017
Return-Path: <owner-freebsd-ports@freebsd.org>
Delivered-To: freebsd-ports@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 04870E840BD
 for <freebsd-ports@mailman.ysv.freebsd.org>;
 Wed,  6 Dec 2017 16:04:14 +0000 (UTC) (envelope-from lars@e.0x20.net)
Received: from mail.0x20.net (mail.0x20.net [46.251.251.56])
 (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
 (Client CN "0x20.net",
 Issuer "COMODO RSA Domain Validation Secure Server CA" (verified OK))
 by mx1.freebsd.org (Postfix) with ESMTPS id B4545778CE
 for <freebsd-ports@freebsd.org>; Wed,  6 Dec 2017 16:04:13 +0000 (UTC)
 (envelope-from lars@e.0x20.net)
Received: from e.0x20.net (mail.0x20.net [46.251.251.56])
 (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
 (No client certificate requested)
 by mail.0x20.net (Postfix) with ESMTPS id E1CDAA1BDF;
 Wed,  6 Dec 2017 17:04:09 +0100 (CET)
Received: (from lars@localhost)
 by e.0x20.net (8.15.2/8.15.2/Submit) id vB6G49E4030609;
 Wed, 6 Dec 2017 17:04:09 +0100 (CET) (envelope-from lars)
Date: Wed, 6 Dec 2017 17:04:09 +0100
From: Lars Engels <lars.engels@0x20.net>
To: Ultima <ultima1252@gmail.com>
Cc: FreeBSD Mailing List <freebsd-ports@freebsd.org>
Subject: Re: Flavors *COMPLETELY* break the port system (synth and poudriere
 are useless)
Message-ID: <20171206160409.GN19238@e.0x20.net>
References: <CAGBxaXmwzXqZXSKX4-_qe15L3Xa8bVx+sFnFrxoksY8Ka3gS3w@mail.gmail.com>
 <7a9a2753-6460-a2bf-5156-5eab92a0b2f8@FreeBSD.org>
 <0a06d3dd-10a7-fd87-9348-f520f3dfc175@columbus.rr.com>
 <20171205233014.GA11173@lonesome.com>
 <CANJ8om4m1g_kcz3HU3SAu-RyetB4RXw+wK36UkMoid6RjRF09g@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
In-Reply-To: <CANJ8om4m1g_kcz3HU3SAu-RyetB4RXw+wK36UkMoid6RjRF09g@mail.gmail.com>
X-Editor: VIM - Vi IMproved 8.0
User-Agent: Mutt/1.9.1 (2017-09-22)
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.25
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <https://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: <https://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
 <mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 06 Dec 2017 16:04:14 -0000

On Tue, Dec 05, 2017 at 04:09:06PM -0800, Ultima wrote:
> I wonder if making a simple man page for general users would be wise and
> referencing the fully featured man page in it for more experienced users?
> It seems that many users want a simple route and the current man page is
> simply too intimidating for them to even consider attempting to use. A
> small how to at the bottom like how Bryan suggested would be helpful as
> well. (Maybe leave out the amount of characters used bit =)
> 
> Poudriere is a powerful beast and I personally love it because of this. I
> felt very overwhelmed when I first started using it but not everyone is
> willing to take the time to get up to speed.
> 

I like the idea. Maybe even add it to tldr[1]?
Web version at [2]

[1] https://github.com/tldr-pages/tldr
[2] https://tldr.ostera.io/