How do port man pages get into https://www.freebsd.org/cgi/man.cgi?

2020-08-26 Thread Michael Gmelin
Hi,

I maintain at least one port that installs a man page that doesn't show
up in https://www.freebsd.org/cgi/man.cgi. Also, there seem to be cases
where man pages of ports are outdated (e.g.,
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=248927 was opened
today, the man page of the port in question was fixed on May 3rd 2020).

Is there any documentation explaining how port man pages are generated
for man.cgi 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)?

Cheers,
Michael

-- 
Michael Gmelin
___
freebsd-ports@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-ports
To unsubscribe, send any mail to "freebsd-ports-unsubscr...@freebsd.org"


Re: How do port man pages get into https://www.freebsd.org/cgi/man.cgi?

2020-08-26 Thread Kurt Jaeger
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 ?

-- 
p...@opsec.eu+49 171 3101372Now what ?
___
freebsd-ports@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-ports
To unsubscribe, send any mail to "freebsd-ports-unsubscr...@freebsd.org"


Re: How do port man pages get into https://www.freebsd.org/cgi/man.cgi?

2020-08-26 Thread Michael Gmelin



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
___
freebsd-ports@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-ports
To unsubscribe, send any mail to "freebsd-ports-unsubscr...@freebsd.org"


Re: How do port man pages get into https://www.freebsd.org/cgi/man.cgi?

2020-08-26 Thread Kurt Jaeger
Hi!

> > 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. [...]

man.cgi has provisions for most of this already, it's only missing
some job to regulary extract the latest

ftp://ftp.freebsd.org/pub/FreeBSD/snapshots/amd64/13.0-CURRENT/ports.txz

for the current tree of the manuals.

-- 
p...@freebsd.org +49 171 3101372  Now what ?
___
freebsd-ports@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-ports
To unsubscribe, send any mail to "freebsd-ports-unsubscr...@freebsd.org"


Re: How do port man pages get into https://www.freebsd.org/cgi/man.cgi?

2020-08-26 Thread Michael Gmelin



On Wed, 26 Aug 2020 18:37:51 +0200
Kurt Jaeger  wrote:

> Hi!
> 
> > > 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. [...]  
> 
> man.cgi has provisions for most of this already, it's only missing
> some job to regulary extract the latest
> 
> ftp://ftp.freebsd.org/pub/FreeBSD/snapshots/amd64/13.0-CURRENT/ports.txz
> 
> for the current tree of the manuals.

How does it actually create the pages though? E.g., the
man page paperless(7) created by deskutils/py-paperless [0] still isn't
available over man.cgi, even though the port was created a long time
before 12.1 was released and is in 12.1's ports.txz.

Cheers,
Michael

[0]https://svnweb.freebsd.org/ports/head/deskutils/py-paperless/

-- 
Michael Gmelin
___
freebsd-ports@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-ports
To unsubscribe, send any mail to "freebsd-ports-unsubscr...@freebsd.org"


Re: How do port man pages get into https://www.freebsd.org/cgi/man.cgi?

2020-08-26 Thread Kurt Jaeger
Hi!

> > man.cgi has provisions for most of this already, it's only missing
> > some job to regulary extract the latest
> > 
> > ftp://ftp.freebsd.org/pub/FreeBSD/snapshots/amd64/13.0-CURRENT/ports.txz
> > 
> > for the current tree of the manuals.
> 
> How does it actually create the pages though?

wosch probably knows this.

> E.g., the
> man page paperless(7) created by deskutils/py-paperless [0] still isn't
> available over man.cgi, even though the port was created a long time
> before 12.1 was released and is in 12.1's ports.txz.

Interesting.

-- 
p...@freebsd.org +49 171 3101372  Now what ?
___
freebsd-ports@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-ports
To unsubscribe, send any mail to "freebsd-ports-unsubscr...@freebsd.org"


poudriere complains of "Duplicated origin" for a couple of ports

2020-08-26 Thread tech-lists

Hi,

Where would I report an issue with "Duplicated origin" causing poudriere bulk
-a to fail? I temporarily got around the problem by manually deleting the
problematic ports from the downloaded ports tree. These were:

lang/ocaml-nox11
misc/mc-nox11

ports tree is head@546297

basically do I make a PR to the maintainers of these ports or does someone
else look after the ports tree itself?

thanks
--
J.


signature.asc
Description: PGP signature