{"action":"created","issue":{"url":"https://api.github.com/repos/fish-shell/fish-shell/issues/2382","labels_url":"https://api.github.com/repos/fish-shell/fish-shell/issues/2382/labels{/name}","comments_url":"https://api.github.com/repos/fish-shell/fish-shell/issues/2382/comments","events_url":"https://api.github.com/repos/fish-shell/fish-shell/issues/2382/events","html_url":"https://github.com/fish-shell/fish-shell/issues/2382","id":106076647,"number":2382,"title":"Better document differences from bash","user":{"login":"faho","id":5185367,"avatar_url":"https://avatars.githubusercontent.com/u/5185367?v=3","gravatar_id":"","url":"https://api.github.com/users/faho","html_url":"https://github.com/faho","followers_url":"https://api.github.com/users/faho/followers","following_url":"https://api.github.com/users/faho/following{/other_user}","gists_url":"https://api.github.com/users/faho/gists{/gist_id}","starred_url":"https://api.github.com/users/faho/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/faho/subscriptions","organizations_url":"https://api.github.com/users/faho/orgs","repos_url":"https://api.github.com/users/faho/repos","events_url":"https://api.github.com/users/faho/events{/privacy}","received_events_url":"https://api.github.com/users/faho/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/fish-shell/fish-shell/labels/needsdocs","name":"needsdocs","color":"fef2c0"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/fish-shell/fish-shell/milestones/4","html_url":"https://github.com/fish-shell/fish-shell/milestones/fish-future","labels_url":"https://api.github.com/repos/fish-shell/fish-shell/milestones/4/labels","id":130257,"number":4,"title":"fish-future","description":"These are bugs that are not targeted for an upcoming release. After a release, we will reexamine these bugs and pull any in that we think are good targets.\r\n\r\nIf you can provide a fix for a bug in this milestone, we'll generally accept it for the next release even if the bug is not in the release.","creator":{"login":"ridiculousfish","id":920838,"avatar_url":"https://avatars.githubusercontent.com/u/920838?v=3","gravatar_id":"","url":"https://api.github.com/users/ridiculousfish","html_url":"https://github.com/ridiculousfish","followers_url":"https://api.github.com/users/ridiculousfish/followers","following_url":"https://api.github.com/users/ridiculousfish/following{/other_user}","gists_url":"https://api.github.com/users/ridiculousfish/gists{/gist_id}","starred_url":"https://api.github.com/users/ridiculousfish/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ridiculousfish/subscriptions","organizations_url":"https://api.github.com/users/ridiculousfish/orgs","repos_url":"https://api.github.com/users/ridiculousfish/repos","events_url":"https://api.github.com/users/ridiculousfish/events{/privacy}","received_events_url":"https://api.github.com/users/ridiculousfish/received_events","type":"User","site_admin":false},"open_issues":389,"closed_issues":129,"state":"open","created_at":"2012-06-11T02:25:13Z","updated_at":"2015-10-02T07:32:21Z","due_on":null,"closed_at":null},"comments":19,"created_at":"2015-09-11T19:22:48Z","updated_at":"2015-10-02T17:42:30Z","closed_at":null,"body":"We should better document fish's differences with bash (and to a lesser degree zsh, because knowledge of bash is common even among zsh users), maybe even to the point of having an entire section in our documentation dedicated to it.\r\n\r\nSome of this is already in the FAQ (\"!!\"), but some isn't.\r\n\r\nIn #2379 we see that process expansion is one thing (an equivalent to \"$!\").\r\n\r\nThere's of course more, but a slight difficulty here is deciding what goes into \"different from bash\", and what goes into \"general tutorial\" (which is already geared at converts) - where does \"set X Y\" vs \"X=Y\" go? Both? One of them? What about \"$argv\"?\r\n\r\nSo the questions are (in a somewhat overlapping manner):\r\n\r\n- Which differences haven't we adequately covered?\r\n\r\nand\r\n\r\n- How do we better draw attention to the fact which of fish's slightly different constructs is an equivalent to bash's $thing?"},"comment":{"url":"https://api.github.com/repos/fish-shell/fish-shell/issues/comments/145095276","html_url":"https://github.com/fish-shell/fish-shell/issues/2382#issuecomment-145095276","issue_url":"https://api.github.com/repos/fish-shell/fish-shell/issues/2382","id":145095276,"user":{"login":"JoshCheek","id":77495,"avatar_url":"https://avatars.githubusercontent.com/u/77495?v=3","gravatar_id":"","url":"https://api.github.com/users/JoshCheek","html_url":"https://github.com/JoshCheek","followers_url":"https://api.github.com/users/JoshCheek/followers","following_url":"https://api.github.com/users/JoshCheek/following{/other_user}","gists_url":"https://api.github.com/users/JoshCheek/gists{/gist_id}","starred_url":"https://api.github.com/users/JoshCheek/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/JoshCheek/subscriptions","organizations_url":"https://api.github.com/users/JoshCheek/orgs","repos_url":"https://api.github.com/users/JoshCheek/repos","events_url":"https://api.github.com/users/JoshCheek/events{/privacy}","received_events_url":"https://api.github.com/users/JoshCheek/received_events","type":"User","site_admin":false},"created_at":"2015-10-02T17:42:30Z","updated_at":"2015-10-02T17:42:30Z","body":"@faho is that table anywhere we can edit it / copy its source so we can maintain our own?"}}