From owner-freebsd-ports@freebsd.org Wed Aug 26 16:09:19 2020 Return-Path: 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 3066B3B04F4 for ; Wed, 26 Aug 2020 16:09:19 +0000 (UTC) (envelope-from freebsd@grem.de) Received: from mail.evolve.de (mail.evolve.de [213.239.217.29]) (using TLSv1.2 with cipher ECDHE-RSA-CHACHA20-POLY1305 (256/256 bits)) (Client CN "mail.evolve.de", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Bc9ly06tFz4DGb; Wed, 26 Aug 2020 16:09:17 +0000 (UTC) (envelope-from freebsd@grem.de) Received: by mail.evolve.de (OpenSMTPD) with ESMTP id 8e246147; Wed, 26 Aug 2020 16:09:15 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=grem.de; h=date:from:to:cc :subject:message-id:in-reply-to:references:mime-version :content-type:content-transfer-encoding; s=20180501; bh=sODKiZF1 HKUT+RlKf00Yr0q3J2M=; b=PE07J3uouGk4QGg+MTgQrH8RVs1U5CmgvfuqnI9U zh+K9oOolEGkRojP4UVW862SOoeQvLxagvrNM7NQLkQPJl3mCkdvLPlDLgWz11ID Lrzzf2SzvWy6TANWLslGj6QbguwKctR6MZxTBklOp2vxm5ECKUq4cYk3/4LXIInl TTHNpOEi7sWhpxq95YbHJuGIh5JVrIoqtVbPyOWgLYRFx7BiWGBzOIas667rbmgx VQCpWb4WfnBRTjAoZTeNiP+esZNPMYehIh+82FT8z+YOjZzWLUl1EFiZrN51LSN7 tD9lZm0lfwNTLypHEU/63lsj+0TH8V6lR1ruXtDTUMpcWw== DomainKey-Signature: a=rsa-sha1; c=nofws; d=grem.de; h=date:from:to:cc :subject:message-id:in-reply-to:references:mime-version :content-type:content-transfer-encoding; q=dns; s=20180501; b=no gCkzT2NtZEYbP5x3po8gmE/x6WvwxdYN4QkokwqXbFTP9FMd2nR/84YRUNFsEA3U hZm9ALM6at0tzS7xlPFy5DT4ejgE6x2zDM3BEAFPGXhq1ULKI4q+56McDHH2UO6N XD23yDhnPKAdoedRHrGjL/HDKObAWx9XxYpUz81ZyVnLc5kZscbDsKgQ9QRmUIBL YkDNSGfyt8EZsuT95cUqkdFgwZObOtNiBi+gyKOBSY9VpplGgeOwQ24wZBMTa1S5 l+YzissiCaQ9/yTCUewXgxUurOplgNtvVU2PNnKy8YBC2DZmF/JLEpibXWud0VqD cL/tjJPmwat6cuiPsCiA== Received: by mail.evolve.de (OpenSMTPD) with ESMTPSA id c9708df9 (TLSv1.2:ECDHE-RSA-CHACHA20-POLY1305:256:NO); Wed, 26 Aug 2020 16:09:13 +0000 (UTC) Date: Wed, 26 Aug 2020 18:09:11 +0200 From: Michael Gmelin To: Kurt Jaeger Cc: "freebsd-ports@freebsd.org" Subject: Re: How do port man pages get into https://www.freebsd.org/cgi/man.cgi? Message-ID: <20200826180911.6c3303ff@bsd64.grem.de> In-Reply-To: <20200826145330.GN3539@home.opsec.eu> References: <20200826162041.2f7f9676@bsd64.grem.de> <20200826145330.GN3539@home.opsec.eu> X-Face: $wrgCtfdVw_H9WAY?S&9+/F"!41z'L$uo*WzT8miX?kZ~W~Lr5W7v?j0Sde\mwB&/ypo^}> +a'4xMc^^KroE~+v^&^#[B">soBo1y6(TW6#UZiC]o>C6`ej+i Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAJFBMVEWJBwe5BQDl LASZU0/LTEWEfHbyj0Txi32+sKrp1Mv944X8/fm1rS+cAAAACXBIWXMAAAsTAAAL EwEAmpwYAAAAB3RJTUUH3wESCxwC7OBhbgAAACFpVFh0Q29tbWVudAAAAAAAQ3Jl YXRlZCB3aXRoIFRoZSBHSU1QbbCXAAAAAghJREFUOMu11DFvEzEUAGCfEhBVFzuq AKkLd0O6VrIQsLXVSZXoWE5N1K3DobBBA9fQpRWc8OkWouaIjedWKiyREOKs+3PY fvalCNjgLVHeF7/3bMtBzV8C/VsQ8tecEgCcDgrzjekwKZ7TwsJZd/ywEKwwP+ZM 8P3drTsAwWn2mpWuDDuYiK1bFs6De0KUUFw0tWxm+D4AIhuuvZqtyWYeO7jQ4Aea 7jUqI+ixhQoHex4WshEvSXdood7stlv4oSuFOC4tqGcr0NjEqXgV4mMJO38nld4+ xKNxRDon7khyKVqY7YR4d+Cg0OMrkWXZOM7YDkEfKiilCn1qYv4mighZiynuHHOA Wq9QJq+BIES7lMFUtcikMnkDGHUoncA+uHgrP0ctIEqfwLHzeSo+eUA66AqzwN6n 2ZHJhw6Qh/PoyC/QENyEyC/AyNjq74Bs+3UH0xYwzDUC4B97HgLocg1QLYgDDO1v f3UX9Y307Ew4AHh67YAFFsxEpkXwpXY3eIgMhAAE3R19L919nNnuD2wlPcDE3UeT L2ytEICQib9BXgS2fU8PrD82ToYO1OEmMSnYTjSqSv9wdC0tPYC+rQRQD9ESnldF CyqfmiYW+tlALt8gH2xrMdC/youbjzPXEun+/ReXsMCDyve3dZc09fn2Oas8oXGc Jj6/fOeK5UmSMPmf/jL+GD8BEj0k/Fn6IO4AAAAASUVORK5CYII= MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-Rspamd-Queue-Id: 4Bc9ly06tFz4DGb X-Spamd-Bar: / Authentication-Results: mx1.freebsd.org; dkim=pass header.d=grem.de header.s=20180501 header.b=PE07J3uo; dmarc=none; spf=pass (mx1.freebsd.org: domain of freebsd@grem.de designates 213.239.217.29 as permitted sender) smtp.mailfrom=freebsd@grem.de X-Spamd-Result: default: False [-0.84 / 15.00]; TO_DN_EQ_ADDR_SOME(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; URL_IN_SUBJECT(1.00)[www.freebsd.org]; R_DKIM_ALLOW(-0.20)[grem.de:s=20180501]; FROM_HAS_DN(0.00)[]; TO_DN_SOME(0.00)[]; TO_MATCH_ENVRCPT_ALL(0.00)[]; R_SPF_ALLOW(-0.20)[+ip4:213.239.217.29/32]; MIME_GOOD(-0.10)[text/plain]; DMARC_NA(0.00)[grem.de]; ARC_NA(0.00)[]; NEURAL_HAM_LONG(-1.00)[-0.997]; RCVD_COUNT_THREE(0.00)[3]; NEURAL_HAM_MEDIUM(-0.99)[-0.988]; DKIM_TRACE(0.00)[grem.de:+]; RCPT_COUNT_TWO(0.00)[2]; NEURAL_HAM_SHORT(-0.36)[-0.357]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; SUBJECT_ENDS_QUESTION(1.00)[]; ASN(0.00)[asn:24940, ipnet:213.239.192.0/18, country:DE]; RCVD_TLS_ALL(0.00)[]; MAILMAN_DEST(0.00)[freebsd-ports] X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.33 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 26 Aug 2020 16:09:19 -0000 On Wed, 26 Aug 2020 16:53:30 +0200 Kurt Jaeger wrote: > 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 Thanks. > > 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 ? One way would be to extract man pages from the binary packages we provide - this would allow to have man pages for head and quarterly branches. This could be implemented as a poudriere feature while building (so it collects man pages as a side effect of bulk builds), or based on the artifacts/binary package produced by poudriere. The former would probably be more elegant and less resource intensive, but also more intrusive. Naive implementation: Get list of man pages: find /usr/local/poudriere/data/packages/121amd64-default/All/ \ -name "*.txz" -exec tar -tf {} /usr/local/man 2>/dev/null \; Extract man pages to /tmp/manpages: find /usr/local/poudriere/data/packages/121amd64-default/All/ \ -name "*.txz" -exec tar \ -C /tmp/manpages \ --strip-components 4 \ -xf {} \ /usr/local/man 2>/dev/null \; Test if it works: MANPATH=/tmp/manpages man XGrabButton Cheers, Michael -- Michael Gmelin