Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Rely on XML_CATALOG_FILES variable for DocBook #30189

Merged
merged 7 commits into from Oct 7, 2017

Conversation

jtojnar
Copy link
Contributor

@jtojnar jtojnar commented Oct 7, 2017

Motivation for this change

Previously DocBook DTD and XSL files were not added to XML_CATALOG_FILES variable, so the path had to be adjusted manually in the configuration script for each derivation if we did not want xmllint and xsltproc to download them from network.

I cherry picked this from GNOME 3.26 PR since it overloaded the hydra jobset there.

Things done

I successfully compiled flatpak and gnome-dictionary with the patched gtk-doc, the documentation was built without any attempts to access network. The other modified packages also built without any problem.

  • Tested using sandboxing (nix.useSandbox on NixOS, or option build-use-sandbox in nix.conf on non-NixOS)
  • Built on platform(s)
    • NixOS
    • macOS
    • Linux
  • Tested via one or more NixOS test(s) if existing and applicable for the change (look inside nixos/tests)
  • Tested compilation of all pkgs that depend on this change using nix-shell -p nox --run "nox-review wip"
  • Tested execution of all binary files (usually in ./result/bin/)
  • Fits CONTRIBUTING.md.

cc @pSub (gtk_doc), @edolstra (docbook_xsl)

@jtojnar jtojnar mentioned this pull request Oct 7, 2017
71 tasks
@Mic92
Copy link
Member

Mic92 commented Oct 7, 2017

The packages changed here, seems to build all fine. So only resolving merge conflicts is left.

In the previous commit, we added a setup hook to docbook dtd and xsl
packages, that adds derivation’s catalog file to an environment variable.
That should, in theory, remove the need for declaring their catalogs manually.
Unfortunately, xmlcatalog utility expects exactly one catalog file, completely
disregarding the environment variable in non-interactive context. In the same
spirit, the design of gtk-doc m4 files only admits a single catalog file,
resulting in another ugly hack.
@jtojnar
Copy link
Contributor Author

jtojnar commented Oct 7, 2017

@Mic92 rebased.

@Mic92 Mic92 merged commit ca72096 into NixOS:staging Oct 7, 2017
@jtojnar jtojnar deleted the docbook-xml-catalogs-hook branch October 8, 2017 00:51
@jtojnar jtojnar mentioned this pull request Oct 16, 2017
8 tasks
@jtojnar jtojnar mentioned this pull request Mar 24, 2019
10 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants