Re: [PATCH v3 1/7] builtin.h: take over documentation from api-builtin.txt

2017-08-04 Thread Martin Ågren
On 4 August 2017 at 18:00, Junio C Hamano wrote: > Martin Ågren writes: > >> Since this is my first code contribution to Git, I'll ask about this part of >> SubmittingPatches: >> >> "After the list reached a consensus that it is a good idea to apply the >> patch, re-send it with "To:" set to the

Re: [PATCH v3 1/7] builtin.h: take over documentation from api-builtin.txt

2017-08-04 Thread Junio C Hamano
Martin Ågren writes: > Since this is my first code contribution to Git, I'll ask about this part of > SubmittingPatches: > > "After the list reached a consensus that it is a good idea to apply the > patch, re-send it with "To:" set to the maintainer [*1*] and "cc:" the > list [*2*] for inclusion.

Re: [PATCH v3 1/7] builtin.h: take over documentation from api-builtin.txt

2017-08-03 Thread Martin Ågren
On 3 August 2017 at 19:44, Junio C Hamano wrote: > Martin Ågren writes: >> + * . Add `builtin/foo.o` to `BUILTIN_OBJS` in `Makefile`. > > Not a new problem but it will become much easier to follow if we > moved this item between the "implement cmd_foo()" and "declare > cmd_foo in builtin.h", like

Re: [PATCH v3 1/7] builtin.h: take over documentation from api-builtin.txt

2017-08-03 Thread Junio C Hamano
Martin Ågren writes: > diff --git a/builtin.h b/builtin.h > index 498ac80d0..8d87d06da 100644 > --- a/builtin.h > +++ b/builtin.h > @@ -6,6 +6,86 @@ > #include "cache.h" > #include "commit.h" > > +/* > + * builtin API > + * === > + * > + * Adding a new built-in > + * -

[PATCH v3 1/7] builtin.h: take over documentation from api-builtin.txt

2017-08-02 Thread Martin Ågren
Delete Documentation/technical/api-builtin.txt and move its content into builtin.h. Format it as a comment. Remove a '+' which was needed when the information was formatted for AsciiDoc. Similarly, change "::" to ":". Document SUPPORT_SUPER_PREFIX, thereby bringing the documentation up to date wit