public inbox for git@vger.kernel.org 
 help / color / mirror / Atom feed
From: Junio C Hamano <gitster@pobox•com>
To: Christian Couder <chriscool@tuxfamily•org>
Cc: git@vger•kernel.org, Johan Herland <johan@herland•net>,
	Josh Triplett <josh@joshtriplett•org>,
	Thomas Rast <tr@thomasrast•ch>,
	Michael Haggerty <mhagger@alum•mit.edu>,
	Eric Sunshine <sunshine@sunshineco•com>,
	Dan Carpenter <dan.carpenter@oracle•com>,
	Greg Kroah-Hartman <greg@kroah•com>, Jeff King <peff@peff•net>
Subject: Re: [PATCH v5 01/14] Add data structures and basic functions for commit trailers
Date: Thu, 06 Feb 2014 15:44:32 -0800	[thread overview]
Message-ID: <xmqqzjm3x0v3.fsf@gitster.dls.corp.google.com> (raw)
In-Reply-To: <20140206202004.325.80557.chriscool@tuxfamily.org> (Christian Couder's message of "Thu, 06 Feb 2014 21:19:50 +0100")

Christian Couder <chriscool@tuxfamily•org> writes:

> We will use a doubly linked list to store all information
> about trailers and their configuration.
>
> This way we can easily remove or add trailers to or from
> trailer lists while traversing the lists in either direction.
>
> Signed-off-by: Christian Couder <chriscool@tuxfamily•org>
> ---
>  Makefile  |  1 +
>  trailer.c | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
>  2 files changed, 49 insertions(+)
>  create mode 100644 trailer.c
>
> diff --git a/Makefile b/Makefile
> index b4af1e2..ec90feb 100644
> --- a/Makefile
> +++ b/Makefile
> @@ -871,6 +871,7 @@ LIB_OBJS += submodule.o
>  LIB_OBJS += symlinks.o
>  LIB_OBJS += tag.o
>  LIB_OBJS += trace.o
> +LIB_OBJS += trailer.o
>  LIB_OBJS += transport.o
>  LIB_OBJS += transport-helper.o
>  LIB_OBJS += tree-diff.o
> diff --git a/trailer.c b/trailer.c
> new file mode 100644
> index 0000000..f129b5a
> --- /dev/null
> +++ b/trailer.c
> @@ -0,0 +1,48 @@
> +#include "cache.h"
> +/*
> + * Copyright (c) 2013 Christian Couder <chriscool@tuxfamily•org>
> + */
> +
> +enum action_where { WHERE_AFTER, WHERE_BEFORE };
> +enum action_if_exist { EXIST_ADD_IF_DIFFERENT, EXIST_ADD_IF_DIFFERENT_NEIGHBOR,
> +		       EXIST_ADD, EXIST_OVERWRITE, EXIST_DO_NOTHING };
> +enum action_if_missing { MISSING_ADD, MISSING_DO_NOTHING };

All these names and "conf_info" below are not named to be specific
to this little tool.  Can I assume that these will never be exposed
to the rest of the system?  If so, they are fine.

> +struct conf_info {
> +	char *name;
> +	char *key;
> +	char *command;
> +	enum action_where where;
> +	enum action_if_exist if_exist;
> +	enum action_if_missing if_missing;

It still feels somewhat strange.  It is true that an item can be
either "exist" or "missing" and it is understandable that it tempts
you to split that into two, but EXIST_OVERWRITE will not trigger
either WHERE_AFTER or WHERE_BEFORE action.



> +};
> +
> +struct trailer_item {
> +	struct trailer_item *previous;
> +	struct trailer_item *next;
> +	const char *token;
> +	const char *value;
> +	struct conf_info *conf;
> +};
> +
> +static inline int same_token(struct trailer_item *a, struct trailer_item *b, int alnum_len)
> +{
> +	return !strncasecmp(a->token, b->token, alnum_len);
> +}
> +
> +static inline int same_value(struct trailer_item *a, struct trailer_item *b)
> +{
> +	return !strcasecmp(a->value, b->value);
> +}
> +
> +static inline int same_trailer(struct trailer_item *a, struct trailer_item *b, int alnum_len)
> +{
> +	return same_token(a, b, alnum_len) && same_value(a, b);
> +}

All these "inlines" look premature optimization that can be
delegated to any decent compiler, don't they?

> +/* Get the length of buf from its beginning until its last alphanumeric character */
> +static inline size_t alnum_len(const char *buf, int len)
> +{
> +	while (--len >= 0 && !isalnum(buf[len]));

Style:

	while (--len >= 0 && !isalnum(buf[len]))
        	;

You may add a comment on the empty statement to make it stand out
even more, i.e.

		; /* nothing */

> +	return (size_t) len + 1;

This is somewhat unfortunate.  if the caller wants to receive
size_t, perhaps it should be passing in size_t (or ssize_t) to the
function?  Hard to guess without an actual caller, though.

> +}

  reply	other threads:[~2014-02-06 23:44 UTC|newest]

Thread overview: 48+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2014-02-06 20:19 [PATCH v5 00/14] Add interpret-trailers builtin Christian Couder
2014-02-06 20:19 ` [PATCH v5 01/14] Add data structures and basic functions for commit trailers Christian Couder
2014-02-06 23:44   ` Junio C Hamano [this message]
2014-02-09 13:48     ` Christian Couder
2014-02-10  7:27       ` Eric Sunshine
2014-02-06 23:46   ` Junio C Hamano
2014-02-09 13:51     ` Christian Couder
2014-02-06 20:19 ` [PATCH v5 02/14] trailer: process trailers from file and arguments Christian Couder
2014-02-07  0:03   ` Junio C Hamano
2014-02-09 13:52     ` Christian Couder
2014-02-10 18:14       ` Junio C Hamano
2014-02-10 19:59         ` Christian Couder
2014-02-10 20:51           ` Junio C Hamano
2014-02-11 15:02             ` Christian Couder
2014-02-11 18:07               ` Junio C Hamano
2014-02-14 21:41                 ` Christian Couder
2014-02-14 21:46                   ` Junio C Hamano
2014-02-14 23:29                     ` Christian Couder
2014-02-14 23:39                       ` Junio C Hamano
2014-02-14 23:57                   ` Junio C Hamano
2014-02-15  0:16                     ` Junio C Hamano
2014-02-21  0:22                       ` Junio C Hamano
2014-02-23 10:44                         ` Christian Couder
2014-02-06 20:19 ` [PATCH v5 03/14] trailer: read and process config information Christian Couder
2014-02-06 20:19 ` [PATCH v5 04/14] trailer: process command line trailer arguments Christian Couder
2014-02-07  0:08   ` Junio C Hamano
2014-02-09 14:06     ` Christian Couder
2014-02-06 20:19 ` [PATCH v5 05/14] trailer: parse trailers from input file Christian Couder
2014-02-06 20:19 ` [PATCH v5 06/14] trailer: put all the processing together and print Christian Couder
2014-02-06 20:19 ` [PATCH v5 07/14] trailer: add interpret-trailers command Christian Couder
2014-02-07  0:10   ` Junio C Hamano
2014-02-07  8:34     ` Christian Couder
2014-02-07 18:09       ` Junio C Hamano
2014-02-07 20:35         ` Junio C Hamano
2014-02-06 20:19 ` [PATCH v5 08/14] trailer: add tests for "git interpret-trailers" Christian Couder
2014-02-07  0:11   ` Junio C Hamano
2014-02-06 20:19 ` [PATCH v5 09/14] trailer: if no input file is passed, read from stdin Christian Couder
2014-02-07  0:12   ` Junio C Hamano
2014-02-06 20:19 ` [PATCH v5 10/14] trailer: execute command from 'trailer.<name>.command' Christian Couder
2014-02-07  0:18   ` Junio C Hamano
2014-02-07 18:17   ` Junio C Hamano
2014-02-06 20:20 ` [PATCH v5 11/14] trailer: add tests for trailer command Christian Couder
2014-02-06 20:20 ` [PATCH v5 12/14] trailer: set author and committer env variables Christian Couder
2014-02-07  0:20   ` Junio C Hamano
2014-02-07  0:26   ` Junio C Hamano
2014-02-06 20:20 ` [PATCH v5 13/14] trailer: add tests for commands using " Christian Couder
2014-02-06 20:20 ` [PATCH v5 14/14] Documentation: add documentation for 'git interpret-trailers' Christian Couder
2014-02-10  7:17   ` Eric Sunshine

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=xmqqzjm3x0v3.fsf@gitster.dls.corp.google.com \
    --to=gitster@pobox$(echo .)com \
    --cc=chriscool@tuxfamily$(echo .)org \
    --cc=dan.carpenter@oracle$(echo .)com \
    --cc=git@vger$(echo .)kernel.org \
    --cc=greg@kroah$(echo .)com \
    --cc=johan@herland$(echo .)net \
    --cc=josh@joshtriplett$(echo .)org \
    --cc=mhagger@alum$(echo .)mit.edu \
    --cc=peff@peff$(echo .)net \
    --cc=sunshine@sunshineco$(echo .)com \
    --cc=tr@thomasrast$(echo .)ch \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox