Re: git: b7f05445c00f - main - Add WWW entries to port Makefiles

* Stefan Eßer (se@freebsd.org) wrote:

> > Why weren't all urls moved to WWW? For my ports, if there were multiple
> > WWW's, all of them important and thus all of them should be moved to
> > WWW=. Is there a policy which disallows multiple URLs in WWW?
> 
> The contents of the WWW variable are made available in the INDEX
> and in the package manifests.
> 
> If multiple lines starting with "WWW:" were present in pkg-descr,
> then only the URL from the first line was used for that purpose.
> 
> But there were quite a number of ports that added a generic
> framework URL (e.g. to rubyonrails.org), and the order of WWW:
> lines was not always correct (e.g. with some less important URL
> in the first line).
> 
> All URLs have been preserved, either in the Makefile or in the
> pkg-descr file. If the one in the Makefile is not the one you
> want to be copied into the INDEX, then put another one in.
> 
> No decision has been made whether more than URL may be defined
> in WWW, but in that case the order of entries becomes arbitrary,
> again, and it will be impossible to identify the most relevant
> URL from its presence in the WWW variable.

The order was and will remain defined as pkg-descr lines and WWW
items are ordered. For the cases where only a single item is allowed,
taking the first item was and is the obvious option.

> In ports you maintain I see additional URLs only referencing the
> repository directory where a port is maintained (e.g. on GitHub),
> and only in a very small fraction of your ports.
> 
> There generally is one official project website and other relevant
> information is linked to that starting point.

Sometimes that's the case, sometimes not. For instance, most python
modules have both PyPI url and git repository, none of these is in
fact an "offical homepage" and both are equally important.

> The only exception appears to be https://mg.pov.lt/objgraph/ and
> that URL is easily found on the website in the WWW field of that
> port's Makefile.
> 
> I really do not see your point. It is hard enough to have a single
> valid URL in the WWW field of each port, and I plan to add a tool
> that tests for stale URLs.

There already is, it's repology.org

> Having multiple URLs in WWW instead of the one that is most
> relevant of a prospective user of the package will lessen the
> value of this information, IMHO.

That sounds like a nonsence to me. Instead, leaving only one URL
where there can be multiple URLs is losing important information,
and having urls in different places is a pessimization.

Summarizing, I assume it's allowed to have multiple entries in WWW
and I plan to move all remaining urls there. It's also great news
that these WWWs will make their way into INDEX, as the named repology
uses these URLs to match projects, and having multiple URLs will
increase connectivity of the graph.

-- 
Dmitry Marakasov   .
amdmi3@amdmi3.ru  ..:  https://github.com/AMDmi3  https://amdmi3.ru/