On Sun, Sep 30, 2018 at 10:24 PM Björn Persson <Bjorn@rombobjörn.se> wrote:
> Zbigniew Jędrzejewski-Szmek wrote: > > On Fri, Sep 28, 2018 at 02:02:37PM +0200, Igor Gnatenko wrote: > > > We have moved packaging guidelines onto docs.fedoraproject.org[0]. > > > If you find any error or would like to change something, don't > hesitate to > > > open ticket or submit pull request for packaging committee repo[1]. > > > > Hmmm, comparing > https://docs.fedoraproject.org/en-US/packaging-guidelines/Python/#_automatically_generated_dependencies > > and > https://fedoraproject.org/wiki/Packaging:Python#Automatically_generated_dependencies > > doesn't make me happy. > > That doesn't look too bad compared to > https://docs.fedoraproject.org/en-US/packaging-guidelines/Ada/. > Raw markup is displayed instead of links, wildcard characters have been > turned into stretches of bold font, while asterisks that were supposed > to become bold font are displayed instead, HTML var tags have been > removed and replaced with nothing at all, and there is inconsistent use > of monospace font, inconsistent quotation marks, and a stray grave accent > as a cherry on top. > > That's what happens when one writes documents in a haphazard ad-hoc > markup language tied to a certain tool, and then tries to switch to > another tool that expects another haphazard ad-hoc markup language. > > I was going to try to fix up the Ada guidelines. Obviously I need to be > able to generate HTML from the .adoc file, because the only way to write > in a haphazard ad-hoc language is to make haphazard ad-hoc changes, > preview the result, and repeat until it looks good. Following the > instructions in README.md I installed the package "podman" and ran > "make". After downloading six blobs of unknown contents it failed with > these error messages: > > ERRO[0232] could not find slirp4netns, the network namespace won't be > configured: exec: "slirp4netns": executable file not found in $PATH > error: getaddrinfo EAI_AGAIN asamalik.fedorapeople.org:443 Seems that podman is broken (it is also broken for tibbs in some other way), this is really sad. Just wondering which version of fedora you are running and is there really no package called "slirp4netns" (I can see it in F28/F29/F30). > I couldn't find any package that provides "slirp4netns", so that was a > dead end. Then I tried the command "asciidoc", because README.md says > that the guidelines are supposed to be written in Asciidoc. That > produced even worse HTML than that at docs.fedoraproject.org, with plus > signs everywhere and a partially mangled bullet list. Apparently the > Asciidoc that these documents are written in isn't the Asciidoc that > asciidoc understands. > > This was a disappointing experience. I thought the ability to merge > changes with Git would make it easier to submit changes to the > guidelines. Instead it seems to have become harder. In the wiki I could > at least preview my changes. > I'm sorry to hear this, try using `sudo docker` in Make file instead of `podman`. Reason I choose to use podman is that you don't have to be root in order to run it. > By the way, the way that Pagure tries to syntax-highlight the .adoc > files is very confusing. I don't know which language Pagure tries to > syntax-highlight – or rather which two languages, because the way it > sprinkles colors over the file in the "blame" view is entirely different > from what it does in the "blob" view – but it needs to be taught that > these files aren't either of those languages. > I think this is known and should be improved (soon?). There was a ticket about this in pagure, but I can't find it right now. > Björn Persson > _______________________________________________ > devel mailing list -- devel@lists.fedoraproject.org > To unsubscribe send an email to devel-le...@lists.fedoraproject.org > Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html > List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines > List Archives: > https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org > -- -Igor Gnatenko
_______________________________________________ devel mailing list -- devel@lists.fedoraproject.org To unsubscribe send an email to devel-le...@lists.fedoraproject.org Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org
