{"header":{"message":"doc: Update to use angle brackets and `tarball' in the same evaluation.","description":null,"timestamp":"2012-05-22T22:07:49Z","authors":[{"email":"ludo@gnu.org","name":"Ludovic Courtès"}]},"hash":"YKD7OW6TMFSUWBTWBMVCVFVHIOTTAUPVLK23MXE4GZUOWEYCKWJQC","authors":[],"deps":{"hashes":[["YKD7OW6TMFSUWBTWBMVCVFVHIOTTAUPVLK23MXE4GZUOWEYCKWJQC","doc: Update to use angle brackets and `tarball' in the same evaluation."],["AA",null],["W4LDVLQFV4NARA2L7OY6X2DIO4IDGBFK72L2HSB52WGA6EGM5FDQC","doc: Show example of `configureFlags'."],["IGXQ45S5VPEGUOCYLE6HJ7AWS4AIM6RIVQ4FELXX7E67IQAQBGPQC","doc: Fix another ID typo."],["6ZHQKBZP3ZWFXEGYR3TYRQANRLVO6PBM7X5DK6Z7JMNMPY6A6Z7AC","Fix indentation"],["PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC","doc: Import the \"Creating Projects\" chapter by Visser & Dolstra."],["NXO2ZIBUSCY5RSM6IFVU2PDHM3X66F3TH6PI6DSJGUQ3DTBJEWRAC","doc: Untabify so that the examples are correctly rendered."],["MULEHDQKGUFOKRDVFJY5A7UOPMLT32LMF2UXW6VJEDJWEY47PDPAC","doc: Mention package names."],["LW755CJKCIPO7NR7D5TP5WZNGCP5UWLBMA7KJXMHJEB6XIJJGO3QC","doc: Write \"Adding More Jobs\"."],["2LTNY56W6QEDRSI6IWRZGQPTJTAFQSGIQO6FBTU7M4VQCTF6OVNAC","doc: Add preliminary section about `release.nix'."],["EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC","doc: Write \"Building from the Command Line\"."]],"deps":["W4LDVLQFV4NARA2L7OY6X2DIO4IDGBFK72L2HSB52WGA6EGM5FDQC","IGXQ45S5VPEGUOCYLE6HJ7AWS4AIM6RIVQ4FELXX7E67IQAQBGPQC","6ZHQKBZP3ZWFXEGYR3TYRQANRLVO6PBM7X5DK6Z7JMNMPY6A6Z7AC"],"known":["PKE6I67S7TDGKEFCKIQZOZ5PSDZXCSPOQGSKDAE5NST3NOOLRUXAC","2LTNY56W6QEDRSI6IWRZGQPTJTAFQSGIQO6FBTU7M4VQCTF6OVNAC","EE53ECTSDLDTGK6RHSEZHZ42FKK2IIEMXQM5ZMDTQNFWZLR4RAIQC","LW755CJKCIPO7NR7D5TP5WZNGCP5UWLBMA7KJXMHJEB6XIJJGO3QC","NXO2ZIBUSCY5RSM6IFVU2PDHM3X66F3TH6PI6DSJGUQ3DTBJEWRAC","MULEHDQKGUFOKRDVFJY5A7UOPMLT32LMF2UXW6VJEDJWEY47PDPAC"]},"hunks":[{"Edit":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":187,"atom":{"EdgeMap":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":1506},"to":{"change":5,"start":1506,"end":1556},"introduced_by":5}],"inode":{"change":5,"pos":114}}},"contents":[{"Del":"{ nixpkgs }: \n\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":188,"ins":{"up_context":[{"change":5,"pos":1560}],"down_context":[{"change":5,"pos":4750}],"flag":"BLOCK","start":0,"end":79,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":1560},"to":{"change":5,"start":1560,"end":1631},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" pkgs = import <nixpkgs> {}; "}],"del_contents":[{"Del":" pkgs = import nixpkgs {}; \n"}]}},{"Edit":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":193,"atom":{"EdgeMap":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":1731},"to":{"change":3,"start":0,"end":61},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":61},"to":{"change":5,"start":1791,"end":1792},"introduced_by":3},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":1791},"to":{"change":5,"start":1791,"end":1792},"introduced_by":5}],"inode":{"change":5,"pos":114}}},"contents":[{"Del":" { helloSrc }: \n"},{"Del":"\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":195,"ins":{"up_context":[{"change":5,"pos":1907}],"down_context":[{"change":5,"pos":1931}],"flag":"BLOCK","start":80,"end":150,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":1907},"to":{"change":5,"start":1907,"end":1931},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" src = <hello>; "}],"del_contents":[{"Del":" src = helloSrc;\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":200,"ins":{"up_context":[{"change":5,"pos":2051}],"down_context":[{"change":5,"pos":2180}],"flag":"BLOCK","start":151,"end":234,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":2051},"to":{"change":5,"start":2051,"end":2180},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" { system ? builtins.currentSystem }: "}],"del_contents":[{"Del":" { tarball ? jobs.tarball {} \n , system ? builtins.currentSystem\n }:\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":202,"ins":{"up_context":[{"change":5,"pos":2181}],"down_context":[{"change":5,"pos":2237}],"flag":"BLOCK","start":235,"end":299,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":2181},"to":{"change":5,"start":2181,"end":2237},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" let pkgs = import <nixpkgs> { inherit system; }; in"}],"del_contents":[{"Del":" let pkgs = import nixpkgs { inherit system; }; in\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":205,"ins":{"up_context":[{"change":4,"pos":1149}],"down_context":[{"change":2,"pos":0}],"flag":"BLOCK","start":300,"end":328,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"","flag":"DELETED","from":{"change":4,"pos":1149},"to":{"change":5,"start":2335,"end":2358},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":2335},"to":{"change":5,"start":2335,"end":2358},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" src = jobs.tarball;"}],"del_contents":[{"Del":" src = tarball;\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":241,"ins":{"up_context":[{"change":5,"pos":3484}],"down_context":[{"change":5,"pos":586}],"flag":"BLOCK","start":329,"end":385,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":3484},"to":{"change":5,"start":537,"end":586},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" "}],"del_contents":[{"Del":" \n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":243,"ins":{"up_context":[{"change":5,"pos":603}],"down_context":[{"change":5,"pos":986}],"flag":"BLOCK","start":386,"end":571,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":603},"to":{"change":5,"start":603,"end":986},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" This defines a variable pkgs holding"},{"Add":" the set of packages provided by Nixpkgs."}],"del_contents":[{"Del":" This specifies a function of one named arguments,\n nixpkgs. This function and those\n defined below is called by Hydra. Here the\n nixpkgs argument is meant to be a\n checkout of the Nixpkgs\n software distribution.\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":248,"ins":{"up_context":[{"change":5,"pos":1021}],"down_context":[{"change":5,"pos":1669}],"flag":"BLOCK","start":572,"end":1044,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":1021},"to":{"change":5,"start":1021,"end":1669},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" Since nixpkgs appears in angle brackets,"},{"Add":" there must be a build input of that name in the Nix search"},{"Add":" path. In this case, the web interface should show a"},{"Add":" nixpkgs build input, which is a checkout"},{"Add":" of the Nixpkgs source code repository; Hydra then adds this"},{"Add":" and other build inputs to the Nix search path when"},{"Add":" evaluating release.nix."}],"del_contents":[{"Del":" Hydra inspects the formal argument list of the function\n (here, the nixpkgs argument) and passes\n it the corresponding parameter specified as a build input\n on Hydra's web interface. In this case, the web interface\n should show a nixpkgs build input,\n which is a checkout of the Nixpkgs source code repository.\n \n \n \n \n This defines a variable pkgs holding\n the set of packages provided by Nixpkgs.\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":274,"ins":{"up_context":[{"change":5,"pos":2285}],"down_context":[{"change":5,"pos":2540}],"flag":"BLOCK","start":1045,"end":1336,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":2285},"to":{"change":5,"start":2285,"end":2540},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" The tarball jobs expects a"},{"Add":" hello build input to be available in the"},{"Add":" Nix search path. Again, this input is passed by Hydra and"},{"Add":" is meant to be a checkout of GNU Hello's source code"},{"Add":" repository."}],"del_contents":[{"Del":" The tarball takes an additional\n argument called helloSrc. Again, this\n argument is passed by Hydra and is meant to be a checkout\n of GNU Hello's source code repository.\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":309,"ins":{"up_context":[{"change":5,"pos":3393}],"down_context":[{"change":5,"pos":3666}],"flag":"BLOCK","start":1337,"end":1472,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":3393},"to":{"change":5,"start":3393,"end":3666},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" The build function takes one"},{"Add":" parameter, system, which should be a string"}],"del_contents":[{"Del":" The build function takes two additional\n parameter: tarball, which is meant to\n be the result of the tarball job, and\n system, which should be a string\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":312,"ins":{"up_context":[{"change":5,"pos":3715}],"down_context":[{"change":5,"pos":3762}],"flag":"BLOCK","start":1473,"end":1605,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":3715},"to":{"change":5,"start":3715,"end":3762},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" \"x86_64-linux\". Additionally, it refers"},{"Add":" to jobs.tarball, seen above."}],"del_contents":[{"Del":" \"x86_64-linux\".\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":316,"ins":{"up_context":[{"change":5,"pos":3797}],"down_context":[{"change":5,"pos":4207}],"flag":"BLOCK","start":1606,"end":2087,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":3797},"to":{"change":5,"start":3797,"end":4207},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" Hydra inspects the formal argument list of the function"},{"Add":" (here, the system argument) and passes it"},{"Add":" the corresponding parameter specified as a build input on"},{"Add":" Hydra's web interface. Here, system is"},{"Add":" passed by Hydra when it calls build."},{"Add":" Thus, it must be defined as a build input of type string in"},{"Add":" Hydra, which could take one of several values."}],"del_contents":[{"Del":" Again, these parameters are passed by Hydra when it calls\n build. Thus, they must be defined as\n build inputs in Hydra: tarball should\n have type Build Output, its value being\n the latest output of the tarball job,\n and system should be a string.\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":325,"ins":{"up_context":[{"change":5,"pos":4242}],"down_context":[{"change":5,"pos":4437}],"flag":"BLOCK","start":2088,"end":2262,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":4242},"to":{"change":5,"start":4242,"end":4437},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" The question mark after system defines"},{"Add":" the default value for this argument, and is only useful when"},{"Add":" debugging locally."}],"del_contents":[{"Del":" The question mark after tarball and\n system defines default values for these\n arguments, and is only useful for debugging.\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":372,"ins":{"up_context":[{"change":4,"pos":1214}],"down_context":[{"change":4,"pos":1306}],"flag":"BLOCK","start":2263,"end":2374,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1214},"to":{"change":4,"start":1214,"end":1306},"introduced_by":4}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":"error: user-thrown exception: file `hello' was not found in the Nix search path (add it using $NIX_PATH or -I)"}],"del_contents":[{"Del":"error: cannot auto-call a function that has an argument without a default value (`nixpkgs')\n"}]}},{"Edit":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":374,"atom":{"EdgeMap":{"edges":[{"previous":"","flag":"DELETED","from":{"change":4,"pos":1316},"to":{"change":5,"start":796,"end":1543},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":796},"to":{"change":5,"start":796,"end":1543},"introduced_by":5}],"inode":{"change":5,"pos":114}}},"contents":[{"Del":"\n This is because no value was specified for the\n nixpkgs argument of the Nix expression.\n \n\n \n This is fixed by providing a default value for that argument in\n the Nix expression, which will allow nix-build\n to auto-call the function: instfead of writing { nixpkgs\n }:, we now write { nixpkgs ? <nixpkgs>\n }:. What it means is that, by default, the\n nixpkgs variable will be bound to the absolute\n path of any nixpkgs file found in the Nix\n search path. Similarly, a default value for\n helloSrc needs to be provided.\n \n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":375,"ins":{"up_context":[{"change":5,"pos":4995}],"down_context":[{"change":5,"pos":5175}],"flag":"BLOCK","start":2375,"end":2533,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":4995},"to":{"change":5,"start":1544,"end":1740},"introduced_by":5}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" The error is self-explanatory. Assuming"},{"Add":" $HOME/src/hello points to a checkout of"},{"Add":" Hello, this can be fixed this way:"}],"del_contents":[{"Del":" \n Thus, assuming a checkout of Nixpkgs is available under\n $HOME/src/nixpkgs, the\n tarball jobset can now be evaluated by running:\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":417,"ins":{"up_context":[{"change":4,"pos":1471}],"down_context":[{"change":5,"pos":960}],"flag":"BLOCK","start":2534,"end":2573,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1471},"to":{"change":4,"start":1471,"end":1542},"introduced_by":4}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" { system ? builtins.currentSystem }:"}],"del_contents":[{"Del":" { tarball ? jobs.tarball {}\n , system ? builtins.currentSystem\n }:\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":422,"ins":{"up_context":[{"change":4,"pos":1654}],"down_context":[{"change":4,"pos":1673}],"flag":"BLOCK","start":2574,"end":2598,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1654},"to":{"change":4,"start":1654,"end":1673},"introduced_by":4}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" src = jobs.tarball;"}],"del_contents":[{"Del":" src = tarball;\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":452,"ins":{"up_context":[{"change":4,"pos":1780}],"down_context":[{"change":5,"pos":2372}],"flag":"BLOCK","start":2599,"end":2638,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1780},"to":{"change":4,"start":1780,"end":1851},"introduced_by":4}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" { system ? builtins.currentSystem }:"}],"del_contents":[{"Del":" { tarball ? jobs.tarball {}\n , system ? builtins.currentSystem\n }:\n"}]}},{"Replacement":{"inode":{"change":5,"pos":114},"path":"doc/manual/projects.xml","line":456,"ins":{"up_context":[{"change":4,"pos":1905}],"down_context":[{"change":4,"pos":1957}],"flag":"BLOCK","start":2639,"end":2683,"inode":{"change":5,"pos":114}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1905},"to":{"change":4,"start":1905,"end":1957},"introduced_by":4}],"inode":{"change":5,"pos":114}},"ins_contents":[{"Add":" build = jobs.build { inherit system; };"}],"del_contents":[{"Del":" build = jobs.build { inherit tarball system; };\n"}]}}],"owner":"grahamc","repo":"hydra2","token":"0QE+7FNOlK91ucIIPTV+fJY7wWF9hmw2h2d6B8+Ds9Y=","login":null}

…

Dependencies

Change contents