{"action":"created","comment":{"url":"https://api.github.com/repos/pypa/pip/pulls/comments/39691470","id":39691470,"diff_hunk":"@@ -128,6 +128,46 @@ You can also refer to constraints files, like this::\n \n     -c some_constraints.txt\n \n+.. _`Example Requirements File`:\n+\n+Example Requirements File\n+~~~~~~~~~~~~~~~~~~~~~~~~~\n+\n+Use ``pip install -r dev-requirements.txt`` to install::\n+\n+    #\n+    ####### dev-requirements.txt #######\n+    #\n+    # Standard installs\n+    nose\n+    nose-cov\n+    beautifulsoup4\n+    #\n+    ###### Getting Specific Versions ######","path":"docs/reference/pip_install.rst","position":null,"original_position":19,"commit_id":"950009031f70d7e830458baed8b0e5b8c6913d93","original_commit_id":"bc758193a0813d585713f66dfef1a331ec98bebb","user":{"login":"dougthor42","id":5386897,"avatar_url":"https://avatars.githubusercontent.com/u/5386897?v=3","gravatar_id":"","url":"https://api.github.com/users/dougthor42","html_url":"https://github.com/dougthor42","followers_url":"https://api.github.com/users/dougthor42/followers","following_url":"https://api.github.com/users/dougthor42/following{/other_user}","gists_url":"https://api.github.com/users/dougthor42/gists{/gist_id}","starred_url":"https://api.github.com/users/dougthor42/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dougthor42/subscriptions","organizations_url":"https://api.github.com/users/dougthor42/orgs","repos_url":"https://api.github.com/users/dougthor42/repos","events_url":"https://api.github.com/users/dougthor42/events{/privacy}","received_events_url":"https://api.github.com/users/dougthor42/received_events","type":"User","site_admin":false},"body":"Changed","created_at":"2015-09-16T22:05:20Z","updated_at":"2015-09-16T22:05:20Z","html_url":"https://github.com/pypa/pip/pull/2929#discussion_r39691470","pull_request_url":"https://api.github.com/repos/pypa/pip/pulls/2929","_links":{"self":{"href":"https://api.github.com/repos/pypa/pip/pulls/comments/39691470"},"html":{"href":"https://github.com/pypa/pip/pull/2929#discussion_r39691470"},"pull_request":{"href":"https://api.github.com/repos/pypa/pip/pulls/2929"}}},"pull_request":{"url":"https://api.github.com/repos/pypa/pip/pulls/2929","id":38497451,"html_url":"https://github.com/pypa/pip/pull/2929","diff_url":"https://github.com/pypa/pip/pull/2929.diff","patch_url":"https://github.com/pypa/pip/pull/2929.patch","issue_url":"https://api.github.com/repos/pypa/pip/issues/2929","number":2929,"state":"open","locked":false,"title":"Add example requirements.txt file to pip_install.rst","user":{"login":"dougthor42","id":5386897,"avatar_url":"https://avatars.githubusercontent.com/u/5386897?v=3","gravatar_id":"","url":"https://api.github.com/users/dougthor42","html_url":"https://github.com/dougthor42","followers_url":"https://api.github.com/users/dougthor42/followers","following_url":"https://api.github.com/users/dougthor42/following{/other_user}","gists_url":"https://api.github.com/users/dougthor42/gists{/gist_id}","starred_url":"https://api.github.com/users/dougthor42/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dougthor42/subscriptions","organizations_url":"https://api.github.com/users/dougthor42/orgs","repos_url":"https://api.github.com/users/dougthor42/repos","events_url":"https://api.github.com/users/dougthor42/events{/privacy}","received_events_url":"https://api.github.com/users/dougthor42/received_events","type":"User","site_admin":false},"body":"I find that some of the docs for ``pip install`` are lacking a bit. One of the main areas which I thought was confusing was the Requirements File Format section.\r\n\r\nI thought that this section could use an example of a requirements file, so I've added one.\r\n\r\nPlease take a look. I didn't put every option in the example since I either a) don't know how to use those options or b) never have had a need for them.","created_at":"2015-06-24T23:08:51Z","updated_at":"2015-09-16T22:05:20Z","closed_at":null,"merged_at":null,"merge_commit_sha":"1f42d28b973108e0ff9483c3f178341f83533eda","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/pypa/pip/pulls/2929/commits","review_comments_url":"https://api.github.com/repos/pypa/pip/pulls/2929/comments","review_comment_url":"https://api.github.com/repos/pypa/pip/pulls/comments{/number}","comments_url":"https://api.github.com/repos/pypa/pip/issues/2929/comments","statuses_url":"https://api.github.com/repos/pypa/pip/statuses/950009031f70d7e830458baed8b0e5b8c6913d93","head":{"label":"dougthor42:develop","ref":"develop","sha":"950009031f70d7e830458baed8b0e5b8c6913d93","user":{"login":"dougthor42","id":5386897,"avatar_url":"https://avatars.githubusercontent.com/u/5386897?v=3","gravatar_id":"","url":"https://api.github.com/users/dougthor42","html_url":"https://github.com/dougthor42","followers_url":"https://api.github.com/users/dougthor42/followers","following_url":"https://api.github.com/users/dougthor42/following{/other_user}","gists_url":"https://api.github.com/users/dougthor42/gists{/gist_id}","starred_url":"https://api.github.com/users/dougthor42/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dougthor42/subscriptions","organizations_url":"https://api.github.com/users/dougthor42/orgs","repos_url":"https://api.github.com/users/dougthor42/repos","events_url":"https://api.github.com/users/dougthor42/events{/privacy}","received_events_url":"https://api.github.com/users/dougthor42/received_events","type":"User","site_admin":false},"repo":{"id":38014162,"name":"pip","full_name":"dougthor42/pip","owner":{"login":"dougthor42","id":5386897,"avatar_url":"https://avatars.githubusercontent.com/u/5386897?v=3","gravatar_id":"","url":"https://api.github.com/users/dougthor42","html_url":"https://github.com/dougthor42","followers_url":"https://api.github.com/users/dougthor42/followers","following_url":"https://api.github.com/users/dougthor42/following{/other_user}","gists_url":"https://api.github.com/users/dougthor42/gists{/gist_id}","starred_url":"https://api.github.com/users/dougthor42/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dougthor42/subscriptions","organizations_url":"https://api.github.com/users/dougthor42/orgs","repos_url":"https://api.github.com/users/dougthor42/repos","events_url":"https://api.github.com/users/dougthor42/events{/privacy}","received_events_url":"https://api.github.com/users/dougthor42/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/dougthor42/pip","description":"The PyPA recommended tool for installing Python packages","fork":true,"url":"https://api.github.com/repos/dougthor42/pip","forks_url":"https://api.github.com/repos/dougthor42/pip/forks","keys_url":"https://api.github.com/repos/dougthor42/pip/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dougthor42/pip/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dougthor42/pip/teams","hooks_url":"https://api.github.com/repos/dougthor42/pip/hooks","issue_events_url":"https://api.github.com/repos/dougthor42/pip/issues/events{/number}","events_url":"https://api.github.com/repos/dougthor42/pip/events","assignees_url":"https://api.github.com/repos/dougthor42/pip/assignees{/user}","branches_url":"https://api.github.com/repos/dougthor42/pip/branches{/branch}","tags_url":"https://api.github.com/repos/dougthor42/pip/tags","blobs_url":"https://api.github.com/repos/dougthor42/pip/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dougthor42/pip/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dougthor42/pip/git/refs{/sha}","trees_url":"https://api.github.com/repos/dougthor42/pip/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dougthor42/pip/statuses/{sha}","languages_url":"https://api.github.com/repos/dougthor42/pip/languages","stargazers_url":"https://api.github.com/repos/dougthor42/pip/stargazers","contributors_url":"https://api.github.com/repos/dougthor42/pip/contributors","subscribers_url":"https://api.github.com/repos/dougthor42/pip/subscribers","subscription_url":"https://api.github.com/repos/dougthor42/pip/subscription","commits_url":"https://api.github.com/repos/dougthor42/pip/commits{/sha}","git_commits_url":"https://api.github.com/repos/dougthor42/pip/git/commits{/sha}","comments_url":"https://api.github.com/repos/dougthor42/pip/comments{/number}","issue_comment_url":"https://api.github.com/repos/dougthor42/pip/issues/comments{/number}","contents_url":"https://api.github.com/repos/dougthor42/pip/contents/{+path}","compare_url":"https://api.github.com/repos/dougthor42/pip/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dougthor42/pip/merges","archive_url":"https://api.github.com/repos/dougthor42/pip/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dougthor42/pip/downloads","issues_url":"https://api.github.com/repos/dougthor42/pip/issues{/number}","pulls_url":"https://api.github.com/repos/dougthor42/pip/pulls{/number}","milestones_url":"https://api.github.com/repos/dougthor42/pip/milestones{/number}","notifications_url":"https://api.github.com/repos/dougthor42/pip/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dougthor42/pip/labels{/name}","releases_url":"https://api.github.com/repos/dougthor42/pip/releases{/id}","created_at":"2015-06-24T22:22:01Z","updated_at":"2015-06-24T22:22:02Z","pushed_at":"2015-09-16T22:04:52Z","git_url":"git://github.com/dougthor42/pip.git","ssh_url":"git@github.com:dougthor42/pip.git","clone_url":"https://github.com/dougthor42/pip.git","svn_url":"https://github.com/dougthor42/pip","homepage":"https://pip.pypa.io/","size":35583,"stargazers_count":0,"watchers_count":0,"language":"Python","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"develop"}},"base":{"label":"pypa:develop","ref":"develop","sha":"8f828b4986d2f90e31b4ebce8a9e87d80dd76b12","user":{"login":"pypa","id":647025,"avatar_url":"https://avatars.githubusercontent.com/u/647025?v=3","gravatar_id":"","url":"https://api.github.com/users/pypa","html_url":"https://github.com/pypa","followers_url":"https://api.github.com/users/pypa/followers","following_url":"https://api.github.com/users/pypa/following{/other_user}","gists_url":"https://api.github.com/users/pypa/gists{/gist_id}","starred_url":"https://api.github.com/users/pypa/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pypa/subscriptions","organizations_url":"https://api.github.com/users/pypa/orgs","repos_url":"https://api.github.com/users/pypa/repos","events_url":"https://api.github.com/users/pypa/events{/privacy}","received_events_url":"https://api.github.com/users/pypa/received_events","type":"Organization","site_admin":false},"repo":{"id":1446467,"name":"pip","full_name":"pypa/pip","owner":{"login":"pypa","id":647025,"avatar_url":"https://avatars.githubusercontent.com/u/647025?v=3","gravatar_id":"","url":"https://api.github.com/users/pypa","html_url":"https://github.com/pypa","followers_url":"https://api.github.com/users/pypa/followers","following_url":"https://api.github.com/users/pypa/following{/other_user}","gists_url":"https://api.github.com/users/pypa/gists{/gist_id}","starred_url":"https://api.github.com/users/pypa/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pypa/subscriptions","organizations_url":"https://api.github.com/users/pypa/orgs","repos_url":"https://api.github.com/users/pypa/repos","events_url":"https://api.github.com/users/pypa/events{/privacy}","received_events_url":"https://api.github.com/users/pypa/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/pypa/pip","description":"The PyPA recommended tool for installing Python packages","fork":false,"url":"https://api.github.com/repos/pypa/pip","forks_url":"https://api.github.com/repos/pypa/pip/forks","keys_url":"https://api.github.com/repos/pypa/pip/keys{/key_id}","collaborators_url":"https://api.github.com/repos/pypa/pip/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/pypa/pip/teams","hooks_url":"https://api.github.com/repos/pypa/pip/hooks","issue_events_url":"https://api.github.com/repos/pypa/pip/issues/events{/number}","events_url":"https://api.github.com/repos/pypa/pip/events","assignees_url":"https://api.github.com/repos/pypa/pip/assignees{/user}","branches_url":"https://api.github.com/repos/pypa/pip/branches{/branch}","tags_url":"https://api.github.com/repos/pypa/pip/tags","blobs_url":"https://api.github.com/repos/pypa/pip/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/pypa/pip/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/pypa/pip/git/refs{/sha}","trees_url":"https://api.github.com/repos/pypa/pip/git/trees{/sha}","statuses_url":"https://api.github.com/repos/pypa/pip/statuses/{sha}","languages_url":"https://api.github.com/repos/pypa/pip/languages","stargazers_url":"https://api.github.com/repos/pypa/pip/stargazers","contributors_url":"https://api.github.com/repos/pypa/pip/contributors","subscribers_url":"https://api.github.com/repos/pypa/pip/subscribers","subscription_url":"https://api.github.com/repos/pypa/pip/subscription","commits_url":"https://api.github.com/repos/pypa/pip/commits{/sha}","git_commits_url":"https://api.github.com/repos/pypa/pip/git/commits{/sha}","comments_url":"https://api.github.com/repos/pypa/pip/comments{/number}","issue_comment_url":"https://api.github.com/repos/pypa/pip/issues/comments{/number}","contents_url":"https://api.github.com/repos/pypa/pip/contents/{+path}","compare_url":"https://api.github.com/repos/pypa/pip/compare/{base}...{head}","merges_url":"https://api.github.com/repos/pypa/pip/merges","archive_url":"https://api.github.com/repos/pypa/pip/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/pypa/pip/downloads","issues_url":"https://api.github.com/repos/pypa/pip/issues{/number}","pulls_url":"https://api.github.com/repos/pypa/pip/pulls{/number}","milestones_url":"https://api.github.com/repos/pypa/pip/milestones{/number}","notifications_url":"https://api.github.com/repos/pypa/pip/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/pypa/pip/labels{/name}","releases_url":"https://api.github.com/repos/pypa/pip/releases{/id}","created_at":"2011-03-06T14:30:46Z","updated_at":"2015-09-16T16:12:29Z","pushed_at":"2015-09-16T22:04:53Z","git_url":"git://github.com/pypa/pip.git","ssh_url":"git@github.com:pypa/pip.git","clone_url":"https://github.com/pypa/pip.git","svn_url":"https://github.com/pypa/pip","homepage":"https://pip.pypa.io/","size":53553,"stargazers_count":2330,"watchers_count":2330,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":924,"mirror_url":null,"open_issues_count":611,"forks":924,"open_issues":611,"watchers":2330,"default_branch":"develop"}},"_links":{"self":{"href":"https://api.github.com/repos/pypa/pip/pulls/2929"},"html":{"href":"https://github.com/pypa/pip/pull/2929"},"issue":{"href":"https://api.github.com/repos/pypa/pip/issues/2929"},"comments":{"href":"https://api.github.com/repos/pypa/pip/issues/2929/comments"},"review_comments":{"href":"https://api.github.com/repos/pypa/pip/pulls/2929/comments"},"review_comment":{"href":"https://api.github.com/repos/pypa/pip/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/pypa/pip/pulls/2929/commits"},"statuses":{"href":"https://api.github.com/repos/pypa/pip/statuses/950009031f70d7e830458baed8b0e5b8c6913d93"}}}}