Re: Please remove "-i" from "%forgemeta" templates on wiki

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Tim Landscheidt kirjoitti 23.2.2021 klo 18.16:
Hi,

using "%forgemeta" with the "-i" option causes debug infor-
mation to be output which leads to %changelog entries being
garbled:

(snip)

Therefore, the templates at
https://docs.fedoraproject.org/en-US/packaging-guidelines/SourceURL/#_using_forges_hosted_revision_control
use "%forgemeta" without options and note:

| #  – remove  “-i” and “-v” before commit

However, the templates on the wiki page at
https://fedoraproject.org/wiki/Forge-hosted_projects_packaging_automation#Packaging_examples
use "%forgemeta -i" and do not clarify that this needs to be
amended before committing.

It would be nice if the wiki page could be updated to avoid
luring packagers into using these templates, perhaps with a
hatnote that the content is historical (?) and only the tem-
plates in the packaging guidelines should be used.

Hi Tim,

Unfortunately, the Fedora wiki is a documentation trap, full of outdated
or obsolete pages whose advice should not be followed. Mixed with other
pages that have useful content that cannot be found elsewhere, so you
cannot simply disregard the wiki either.

In this case, the wiki page contains a draft whose final version is in
the packaging guidelines. Even though I am not very familiar with the
forge macros, I took the liberty to add an easy to spot link from the
wiki page to the guidelines and removed the examples that misled you.
As far as I can tell, the examples did not have anything that cannot be
read from the examples in the guidelines. It could be that the whole
page could be removed, but since it contains a collection of links, some
parameters that are not mentioned in the guidelines and discussion on
how to extend the macros, I left it there.

Like I said, I am not expert in forge macros, so if anybody thinks that
my edit removal was a bad idea, wiki has an undo button.

Otto
_______________________________________________
devel mailing list -- devel@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to devel-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/devel@xxxxxxxxxxxxxxxxxxxxxxx
Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure




[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Index of Archives]     [Fedora Announce]     [Fedora Users]     [Fedora Kernel]     [Fedora Testing]     [Fedora Formulas]     [Fedora PHP Devel]     [Kernel Development]     [Fedora Legacy]     [Fedora Maintainers]     [Fedora Desktop]     [PAM]     [Red Hat Development]     [Gimp]     [Yosemite News]

  Powered by Linux