From owner-freebsd-ports@freebsd.org  Wed Aug 26 14:53:41 2020
Return-Path: <owner-freebsd-ports@freebsd.org>
Delivered-To: freebsd-ports@mailman.nyi.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1])
 by mailman.nyi.freebsd.org (Postfix) with ESMTP id 95AFE3D6D2C
 for <freebsd-ports@mailman.nyi.freebsd.org>;
 Wed, 26 Aug 2020 14:53:41 +0000 (UTC) (envelope-from pi@freebsd.org)
Received: from home.opsec.eu (home.opsec.eu [IPv6:2001:14f8:200::1])
 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
 key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256)
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id 4Bc84j1kNkz463C
 for <freebsd-ports@freebsd.org>; Wed, 26 Aug 2020 14:53:41 +0000 (UTC)
 (envelope-from pi@freebsd.org)
Received: from pi by home.opsec.eu with local (Exim 4.92.3 (FreeBSD))
 (envelope-from <pi@freebsd.org>)
 id 1kAwnq-0000J7-Hb; Wed, 26 Aug 2020 16:53:30 +0200
Date: Wed, 26 Aug 2020 16:53:30 +0200
From: Kurt Jaeger <pi@freebsd.org>
To: Michael Gmelin <freebsd@grem.de>
Cc: "freebsd-ports@freebsd.org" <freebsd-ports@freebsd.org>
Subject: Re: How do port man pages get into
 https://www.freebsd.org/cgi/man.cgi?
Message-ID: <20200826145330.GN3539@home.opsec.eu>
References: <20200826162041.2f7f9676@bsd64.grem.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20200826162041.2f7f9676@bsd64.grem.de>
X-Rspamd-Queue-Id: 4Bc84j1kNkz463C
X-Spamd-Bar: /
Authentication-Results: mx1.freebsd.org;
	none
X-Spamd-Result: default: False [0.00 / 15.00];
 local_wl_from(0.00)[freebsd.org];
 ASN(0.00)[asn:12502, ipnet:2001:14f8::/32, country:DE]
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.33
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, 26 Aug 2020 14:53:41 -0000

Hi!

> Is there any documentation explaining how port man pages are generated
> for man.cgi

The man.cgi script itself is in the docs svn repo:

https://svnweb.freebsd.org/doc/head/en_US.ISO8859-1/htdocs/cgi/man.cgi?revision=54262&view=markup

We find that each released version has that version's ports tree.

> and how frequently they're updated? Like, are they taken
> from binary packages every few months or are they maybe created from the
> ports tree that's current at the time of a release (so "FreeBSD
> 12.1-RELEASE and Ports" contains man pages based on
> https://download.freebsd.org/ftp/releases/amd64/12.1-RELEASE/ports.txz)?

Yes, exactly.

Any ideas on how man.cgi can be made to also display ports head man pages ?

-- 
pi@opsec.eu            +49 171 3101372                    Now what ?