{"action":"created","issue":{"url":"https://api.github.com/repos/company-mode/company-mode/issues/411","labels_url":"https://api.github.com/repos/company-mode/company-mode/issues/411/labels{/name}","comments_url":"https://api.github.com/repos/company-mode/company-mode/issues/411/comments","events_url":"https://api.github.com/repos/company-mode/company-mode/issues/411/events","html_url":"https://github.com/company-mode/company-mode/issues/411","id":109871268,"number":411,"title":"Filtering the result of 'company-filter-candidates' (nesting) ?","user":{"login":"Antoine-Patel","id":12051598,"avatar_url":"https://avatars.githubusercontent.com/u/12051598?v=3","gravatar_id":"","url":"https://api.github.com/users/Antoine-Patel","html_url":"https://github.com/Antoine-Patel","followers_url":"https://api.github.com/users/Antoine-Patel/followers","following_url":"https://api.github.com/users/Antoine-Patel/following{/other_user}","gists_url":"https://api.github.com/users/Antoine-Patel/gists{/gist_id}","starred_url":"https://api.github.com/users/Antoine-Patel/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Antoine-Patel/subscriptions","organizations_url":"https://api.github.com/users/Antoine-Patel/orgs","repos_url":"https://api.github.com/users/Antoine-Patel/repos","events_url":"https://api.github.com/users/Antoine-Patel/events{/privacy}","received_events_url":"https://api.github.com/users/Antoine-Patel/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/company-mode/company-mode/labels/duplicate","name":"duplicate","color":"fbca04"}],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":5,"created_at":"2015-10-05T19:42:35Z","updated_at":"2015-10-08T11:55:38Z","closed_at":"2015-10-07T03:14:04Z","body":"I filter completion candidates a lot (`company-filter-candidates`). Sometimes I would like to filter some more the already filtered candidates list, for example when it's still too big. Is it possible ? \r\n\r\nIt seems triggering `company-filter-candidates`, while already filtering candidates, resets the filter string (search string). I tried to use `company-search-candidates` while filtering, to achieve a similar effect, but it doesn't work.\r\n\r\nThe most problematic is: I never know if I can filter \"early\" and get a limited filtered candidates list, or have to go \"the long way\" preemptively in order to make sure I won't get a huge list. Because if it does happen, I have to cancel the filtering, then somewhat do something else (possibly before re-doing the filtering...), which almost always ends up being much slower and painful than it should.\r\n\r\nThat, or I'm missing the \"right\" thing to do when filtering did not narrow the candidates list enough.\r\n"},"comment":{"url":"https://api.github.com/repos/company-mode/company-mode/issues/comments/146515966","html_url":"https://github.com/company-mode/company-mode/issues/411#issuecomment-146515966","issue_url":"https://api.github.com/repos/company-mode/company-mode/issues/411","id":146515966,"user":{"login":"dgutov","id":271877,"avatar_url":"https://avatars.githubusercontent.com/u/271877?v=3","gravatar_id":"","url":"https://api.github.com/users/dgutov","html_url":"https://github.com/dgutov","followers_url":"https://api.github.com/users/dgutov/followers","following_url":"https://api.github.com/users/dgutov/following{/other_user}","gists_url":"https://api.github.com/users/dgutov/gists{/gist_id}","starred_url":"https://api.github.com/users/dgutov/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dgutov/subscriptions","organizations_url":"https://api.github.com/users/dgutov/orgs","repos_url":"https://api.github.com/users/dgutov/repos","events_url":"https://api.github.com/users/dgutov/events{/privacy}","received_events_url":"https://api.github.com/users/dgutov/received_events","type":"User","site_admin":false},"created_at":"2015-10-08T11:55:38Z","updated_at":"2015-10-08T11:55:38Z","body":"> However (I don't know if it was intentional or not) this new feature is a bit \"hidden\" and hard to find.\r\n\r\nPossibly. In the end, we don't have a manual, only docstrings, and it's not good to be too verbose in docstrings.\r\n\r\n> Having company-search-regexp-function be at least mentioned by company-filter-candidates's docstring (and maybe company-search-candidates's docstring too).\r\n\r\nI've added the mention in `company-search-candidates`. As you say `company-filter-candidates` already refers to it.\r\n\r\n> Having somewhere in some docstring something like (the exact wording to choose depends on where it will be put if it happens)\r\n\r\nThat sounds like manual-level material. It would be great if someone would work on one. But alternatively, you can create a wiki page describing the Company search function in more detail.\r\n\r\n> I had to check the commit cec8779 diff view on github\r\n\r\nThat's what I thought you would start with (after all, GitHub tells you which commit closed the issue). Another option would be to look inside NEWS.md."}}