Re: [PATCH] documentation: add tutorial for revision walking

2019-07-16 Thread Junio C Hamano
Emily Shaffer writes: > I have been in a position of reviewing diff-of-.patch in a past life, > albeit via Gerrit, and it's not the worst when the code is simple (as we > should always hope this example tutorial code would be). I personally think a directory full of patch files is OK. I am not

Re: [PATCH] documentation: add tutorial for revision walking

2019-07-15 Thread Emily Shaffer
On Fri, Jul 12, 2019 at 05:39:48PM -0700, Josh Steadmon wrote: > On 2019.06.20 14:06, Emily Shaffer wrote: > > On Wed, Jun 19, 2019 at 08:17:29AM -0700, Junio C Hamano wrote: > > > Emily Shaffer writes: > > > > > > > Maybe there's a case for storing them as a set of patch files that are > > > > r

Re: [PATCH] documentation: add tutorial for revision walking

2019-07-12 Thread Josh Steadmon
On 2019.06.20 14:06, Emily Shaffer wrote: > On Wed, Jun 19, 2019 at 08:17:29AM -0700, Junio C Hamano wrote: > > Emily Shaffer writes: > > > > > Maybe there's a case for storing them as a set of patch files that are > > > revision-controlled somewhere within Documentation/? There was some > > > di

Re: [PATCH] documentation: add tutorial for revision walking

2019-06-23 Thread Eric Sunshine
On Wed, Jun 19, 2019 at 7:36 PM Emily Shaffer wrote: > On Wed, Jun 19, 2019 at 04:13:35AM -0400, Eric Sunshine wrote: > > Maybe I got confused because the tiny cmd_walken() snippets followed > > one another so closely (or because I got interrupted several times > > during the review), but one way

Re: [PATCH] documentation: add tutorial for revision walking

2019-06-20 Thread Emily Shaffer
On Wed, Jun 19, 2019 at 08:17:29AM -0700, Junio C Hamano wrote: > Emily Shaffer writes: > > > Maybe there's a case for storing them as a set of patch files that are > > revision-controlled somewhere within Documentation/? There was some > > discussion on the IRC a few weeks ago about trying to or

Re: [PATCH] documentation: add tutorial for revision walking

2019-06-19 Thread Emily Shaffer
On Wed, Jun 19, 2019 at 04:13:35AM -0400, Eric Sunshine wrote: > On Mon, Jun 17, 2019 at 7:20 PM Emily Shaffer wrote: > > On Fri, Jun 07, 2019 at 02:21:07AM -0400, Eric Sunshine wrote: > > > On Thu, Jun 6, 2019 at 9:08 PM Emily Shaffer > > > wrote: > > > > +int cmd_walken(int argc, const char **

Re: [PATCH] documentation: add tutorial for revision walking

2019-06-19 Thread Junio C Hamano
Emily Shaffer writes: > Maybe there's a case for storing them as a set of patch files that are > revision-controlled somewhere within Documentation/? There was some > discussion on the IRC a few weeks ago about trying to organize these > tutorials into their own directory to form a sort of "Git C

Re: [PATCH] documentation: add tutorial for revision walking

2019-06-19 Thread Eric Sunshine
On Mon, Jun 17, 2019 at 7:20 PM Emily Shaffer wrote: > On Fri, Jun 07, 2019 at 02:21:07AM -0400, Eric Sunshine wrote: > > On Thu, Jun 6, 2019 at 9:08 PM Emily Shaffer > > wrote: > > > +int cmd_walken(int argc, const char **argv, const char *prefix) > > > +{ > > > + struct option options[]

Re: [PATCH] documentation: add tutorial for revision walking

2019-06-17 Thread Emily Shaffer
On Mon, Jun 10, 2019 at 01:25:14PM -0700, Junio C Hamano wrote: > Emily Shaffer writes: > > > I'll also be mailing an RFC patchset In-Reply-To this message; the RFC > > patchset should not be merged to Git, as I intend to host it in my own > > mirror as an example. I hosted a similar example for

Re: [PATCH] documentation: add tutorial for revision walking

2019-06-17 Thread Emily Shaffer
On Mon, Jun 10, 2019 at 01:49:41PM -0700, Junio C Hamano wrote: > Emily Shaffer writes: > > > +My First Revision Walk > > +== > > + > > +== What's a Revision Walk? > > + > > +The revision walk is a key concept in Git - this is the process that > > underpins > > +operations li

Re: [PATCH] documentation: add tutorial for revision walking

2019-06-17 Thread Emily Shaffer
On Fri, Jun 07, 2019 at 02:21:07AM -0400, Eric Sunshine wrote: > On Thu, Jun 6, 2019 at 9:08 PM Emily Shaffer wrote: > > [...] > > The tutorial covers a basic overview of the structs involved during > > revision walk, setting up a basic commit walk, setting up a basic > > all-object walk, and addi

Re: [PATCH] documentation: add tutorial for revision walking

2019-06-10 Thread Eric Sunshine
On Mon, Jun 10, 2019 at 5:27 PM Junio C Hamano wrote: > Eric Sunshine writes: > >> +#include > >> +#include "builtin.h" > > > > Git source files must always include cache.h or git-compat-util.h (or, > > for builtins, builtin.h) as the very first header since those headers > > take care of differ

Re: [PATCH] documentation: add tutorial for revision walking

2019-06-10 Thread Junio C Hamano
Eric Sunshine writes: >> +/* >> + * "git walken" >> + * >> + * Part of the "My First Revision Walk" tutorial. >> + */ >> + >> +#include >> +#include "builtin.h" > > Git source files must always include cache.h or git-compat-util.h (or, > for builtins, builtin.h) as the very first header since th

Re: [PATCH] documentation: add tutorial for revision walking

2019-06-10 Thread Junio C Hamano
Emily Shaffer writes: > +My First Revision Walk > +== > + > +== What's a Revision Walk? > + > +The revision walk is a key concept in Git - this is the process that > underpins > +operations like `git log`, `git blame`, and `git reflog`. Beginning at HEAD, > the > +list of ob

Re: [PATCH] documentation: add tutorial for revision walking

2019-06-10 Thread Junio C Hamano
Emily Shaffer writes: > I'll also be mailing an RFC patchset In-Reply-To this message; the RFC > patchset should not be merged to Git, as I intend to host it in my own > mirror as an example. I hosted a similar example for the > MyFirstContribution tutorial; it's visible at > https://github.com/n

Re: [PATCH] documentation: add tutorial for revision walking

2019-06-06 Thread Eric Sunshine
On Thu, Jun 6, 2019 at 9:08 PM Emily Shaffer wrote: > [...] > The tutorial covers a basic overview of the structs involved during > revision walk, setting up a basic commit walk, setting up a basic > all-object walk, and adding some configuration changes to both walk > types. It intentionally does

[PATCH] documentation: add tutorial for revision walking

2019-06-06 Thread Emily Shaffer
Existing documentation on revision walks seems to be primarily intended as a reference for those already familiar with the procedure. This tutorial attempts to give an entry-level guide to a couple of bare-bones revision walks so that new Git contributors can learn the concepts without having to wa