This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: devguide: hg bisect section could be clearer
Type: enhancement Stage: resolved
Components: Devguide Versions:
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: ezio.melotti Nosy List: ezio.melotti, numerodix, pitrou, python-dev
Priority: normal Keywords:

Created on 2013-10-20 10:57 by numerodix, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Messages (4)
msg200565 - (view) Author: Martin Matusiak (numerodix) * Date: 2013-10-20 10:57
The offending section:
http://docs.python.org/devguide/faq.html#how-do-i-find-which-changeset-introduced-a-bug-or-regression

I think this could be improved a bit. The key point is that "hg bisect --bad/good" is a command relative to the checked out changeset. So the instructions tell me to run "hg bisect --bad" and then "hg bisect --good", but they could do with a more explicit instruction to run "hg update <ref-id>" in between.

- You can conveniently choose a faraway changeset (for example a former release), and check that it is indeed “good”

This could be construed as just peeking at the changeset using hg log or whatever, not actually checking it out.

- Mercurial will automatically bisect so as to narrow the range of possible culprits, until a single changeset is isolated.

Here too it could be made more explicit that mercurial will navigate to (ie. check out each changeset) as it's doing this, so that at every invocation of "hg bisect --bad/good" the changeset to be tested is checked out for you, not merely computed.
msg200618 - (view) Author: Antoine Pitrou (pitrou) * (Python committer) Date: 2013-10-20 19:13
I don't think we want the devguide to become a Mercurial manual.
Also, it is easy to get help for a Mercurial command: just type "hg help bisect".
msg200645 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2013-10-20 22:38
New changeset 24c2cfee3b06 by Ezio Melotti in branch 'default':
#19311: mention hg update in the bisect faq.
http://hg.python.org/devguide/rev/24c2cfee3b06
msg200646 - (view) Author: Ezio Melotti (ezio.melotti) * (Python committer) Date: 2013-10-20 22:40
I agree with Antoine, but mentioning hg update is a good idea so I changed that.
History
Date User Action Args
2022-04-11 14:57:52adminsetgithub: 63510
2013-10-20 22:40:44ezio.melottisetstatus: open -> closed
type: enhancement
messages: + msg200646

assignee: ezio.melotti
resolution: wont fix -> fixed
stage: resolved
2013-10-20 22:38:43python-devsetstatus: pending -> open
nosy: + python-dev
messages: + msg200645

2013-10-20 19:13:58pitrousetstatus: open -> pending

nosy: + pitrou
messages: + msg200618

resolution: wont fix
2013-10-20 10:57:20numerodixcreate