Building from the Command Line

{"header":{"message":"doc: Write \"Building from the Command Line\".","description":null,"timestamp":"2011-10-12T14:20:02Z","authors":[{"email":"ludo@gnu.org","name":"Ludovic Courtès"}]},"hash":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC","authors":[],"deps":{"hashes":[["EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC","doc: Write \"Building from the Command Line\"."],["AA",null],["PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC","doc: Import the \"Creating Projects\" chapter by Visser & Dolstra."],["2LTNY56W6QEDRSI6IWRZGQPTJTAFQSGIQO6FBTU7M4VQCTF6OVNAC","doc: Add preliminary section about `release.nix'."]],"deps":["PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC"],"known":["2LTNY56W6QEDRSI6IWRZGQPTJTAFQSGIQO6FBTU7M4VQCTF6OVNAC"]},"hunks":[{"Replacement":{"inode":{"change":2,"pos":114},"path":"doc/manual/projects.xml","line":356,"ins":{"up_context":[{"change":2,"pos":4946}],"down_context":[{"change":2,"pos":4994}],"flag":"BLOCK","start":0,"end":1543,"inode":{"change":2,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":2,"pos":4946},"to":{"change":2,"start":4946,"end":4994},"introduced_by":2}],"inode":{"change":2,"pos":114}},"ins_contents":[{"Add":{"text":" Building from the Command Line","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:49"}},{"Add":{"text":"","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:50"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:61"}},{"Add":{"text":" It is often useful to test a build recipe, for instance before","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:130"}},{"Add":{"text":" it is actually used by Hydra, when testing changes, or when","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:196"}},{"Add":{"text":" debugging a build issue. Since build recipes for Hydra jobsets","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:266"}},{"Add":{"text":" are just plain Nix expressions, they can be evaluated using the","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:336"}},{"Add":{"text":" standard Nix tools.","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:362"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:374"}},{"Add":{"text":"","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:375"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:386"}},{"Add":{"text":" To evaluate the tarball jobset of , just run:","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:490"}},{"Add":{"text":"","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:491"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:506"}},{"Add":{"text":"\t$ nix-build release.nix -A tarball","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:542"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:558"}},{"Add":{"text":"","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:559"}},{"Add":{"text":" However, doing this with as is will","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:629"}},{"Add":{"text":" probably yield an error like this:","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:670"}},{"Add":{"text":"","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:671"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:686"}},{"Add":{"text":"\terror: cannot auto-call a function that has an argument without a default value (`nixpkgs')","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:779"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:795"}},{"Add":{"text":"","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:796"}},{"Add":{"text":" This is because no value was specified for the","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:849"}},{"Add":{"text":" nixpkgs argument of the Nix expression.","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:914"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:926"}},{"Add":{"text":"","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:927"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:938"}},{"Add":{"text":" This is fixed by providing a default value for that argument in","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1008"}},{"Add":{"text":" the Nix expression, which will allow nix-build","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1080"}},{"Add":{"text":" to auto-call the function: instfead of writing { nixpkgs","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1152"}},{"Add":{"text":" }:, we now write { nixpkgs ? <nixpkgs>","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1222"}},{"Add":{"text":" }:. What it means is that, by default, the","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1282"}},{"Add":{"text":" nixpkgs variable will be bound to the absolute","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1354"}},{"Add":{"text":" path of any nixpkgs file found in the Nix","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1423"}},{"Add":{"text":" search path. Similarly, a default value for","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1474"}},{"Add":{"text":" helloSrc needs to be provided.","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1530"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1542"}}],"del_contents":[{"Del":{"text":" Building on the Command Line","pos":"PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC:4993"}}]}},{"Replacement":{"inode":{"change":2,"pos":114},"path":"doc/manual/projects.xml","line":397,"ins":{"up_context":[{"change":2,"pos":4995}],"down_context":[{"change":2,"pos":5175}],"flag":"BLOCK","start":1544,"end":1740,"inode":{"change":2,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":2,"pos":4995},"to":{"change":2,"start":4995,"end":5175},"introduced_by":2}],"inode":{"change":2,"pos":114}},"ins_contents":[{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1554"}},{"Add":{"text":" Thus, assuming a checkout of Nixpkgs is available under","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1616"}},{"Add":{"text":" $HOME/src/nixpkgs, the","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1666"}},{"Add":{"text":" tarball jobset can now be evaluated by running:","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1739"}}],"del_contents":[{"Del":{"text":"Overigens zijn die helemaal niet Hydra-specifiek, je kunt ze gewoon vanaf de","pos":"PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC:5071"}},{"Del":{"text":"command line bouwen, bijv. als je een patchelf checkout hebt (met een nixpkgs","pos":"PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC:5149"}},{"Del":{"text":"checkout in ../nixpkgs):","pos":"PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC:5174"}}]}},{"Replacement":{"inode":{"change":2,"pos":114},"path":"doc/manual/projects.xml","line":402,"ins":{"up_context":[{"change":2,"pos":5176}],"down_context":[{"change":2,"pos":5239}],"flag":"BLOCK","start":1741,"end":2121,"inode":{"change":2,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":2,"pos":5176},"to":{"change":2,"start":5176,"end":5239},"introduced_by":2}],"inode":{"change":2,"pos":114}},"ins_contents":[{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1755"}},{"Add":{"text":"\t$ nix-build -I ~/src release.nix -A tarball","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1800"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1816"}},{"Add":{"text":"","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1817"}},{"Add":{"text":" Similarly, the build jobset can be evaluated:","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1888"}},{"Add":{"text":"","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1889"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1904"}},{"Add":{"text":"\t$ nix-build -I ~/src release.nix -A build","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1947"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1963"}},{"Add":{"text":"","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:1964"}},{"Add":{"text":" The build job reuses the result of the","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:2028"}},{"Add":{"text":" tarball job, rebuilding it only if it needs to.","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:2101"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:2113"}},{"Add":{"text":" ","pos":"EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC:2120"}}],"del_contents":[{"Del":{"text":"","pos":"PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC:5184"}},{"Del":{"text":"$ nix-build release.nix -A rpm_fedora10i386","pos":"PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC:5228"}},{"Del":{"text":"","pos":"PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC:5238"}}]}}],"owner":"grahamc","repo":"hydra","token":"qbyHrgQtAnkkA16ykvsFCQurVDTcGVbLY7wR68fqfM4=","login":null}

…

Dependencies

Change contents

Review