unofficial mirror of guile-devel@gnu.org 
 help / color / mirror / Atom feed
From: Christopher Allan Webber <cwebber@dustycloud.org>
To: "Taylan Ulrich Bayırlı/Kammer" <taylanbayirli@gmail.com>
Cc: guile-devel <guile-devel@gnu.org>
Subject: Re: Elisp branch ready for merge (??)
Date: Sat, 12 Mar 2016 09:15:58 -0800	[thread overview]
Message-ID: <87ziu3y5v5.fsf@dustycloud.org> (raw)
In-Reply-To: <87k2l727jq.fsf@T420.taylan>

Taylan Ulrich Bayırlı/Kammer writes:

> Christopher Allan Webber <cwebber@dustycloud.org> writes:
>
>> Taylan Ulrich Bayırlı/Kammer writes:
>>
>>> Christopher Allan Webber <cwebber@dustycloud.org> writes:
>>>
>>>> Well, I didn't think I'd have time to do this (and in a sense I didn't)
>>>> but:
>>>>   https://gitlab.com/dustyweb/guile/tree/merge-bipt-elisp-wip
>>>>
>>>> I've rebased the whole branch against git master and added ChangeLog
>>>> style entries.  "make check" is passing.  It seems to me that it's ready
>>>> for merge.  I did the best I could on the ChangeLog additions, both with
>>>> my limited ChangeLog experience and from my limited Guile internals
>>>> experience.  So, corrections welcome, but otherwise...
>>>
>>> Exciting!
>>>
>>> Small remark: the "title" line of the commit messages should be complete
>>> sentences.
>>
>> Yes, though I didn't write them.  I also don't know in each case what a
>> complete sentence would be.  I did my best job by filling in the
>> ChangeLog style part.  Often times my figuring out the ChangeLog stuff
>> was based on some sentence fragment.
>>
>> Changing the one part that is the original author's writing to something
>> different... I can do it by attempting to guess, but I'm worried about
>> removing that context.
>>
>> One thing I could do is leave in the description: "Original title: foo"
>>
>> What do you think of that?
>
> In some cases it seems the title is already a sentence, just lacking
> capitalization and punctuation.  (It seems Guile doesn't have a strict
> rule about the punctuation though.)
>
> In other cases it seems like titles that should be "Add foobar" are
> shortened to just "foobar", e.g.:
>
> - guile-backtrace function
> - eval-when
> - fset macro
> - defsubst
> - compiler macros
> - elisp @@ macro
>
> All in all it looks like most titles should be straightforward to fix.
> Fixing any would be better than fixing none IMO.

You are probably right.

> And I'd say mentioning the original title is unnecessary for the
> obvious ones, though we should get Robin's sanctioning for what we do.
> Is Robin perhaps available for some basic feedback?

I haven't heard from them, but if they chose to reach out it would be of
course most welcome!

 - Chris



  reply	other threads:[~2016-03-12 17:15 UTC|newest]

Thread overview: 20+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-03-06  8:32 Guile & Emacs chat at emacs hackathon/bug-crush SF Christopher Allan Webber
2016-03-06 16:53 ` Christopher Allan Webber
2016-03-07  1:01   ` What's needed to get elisp updates into Guile master? Christopher Allan Webber
2016-03-07 10:14     ` Mathieu Lirzin
2016-03-07 18:06       ` Christopher Allan Webber
2016-03-07 19:12         ` Mathieu Lirzin
2016-03-08  1:23           ` Christopher Allan Webber
2016-03-09  9:07             ` Taylan Ulrich Bayırlı/Kammer
2016-03-09 17:22               ` Christopher Allan Webber
2016-03-11  1:51         ` Elisp branch ready for merge (??) Christopher Allan Webber
2016-03-11  9:44           ` Taylan Ulrich Bayırlı/Kammer
2016-03-11 16:33             ` Christopher Allan Webber
2016-03-12 12:40               ` Taylan Ulrich Bayırlı/Kammer
2016-03-12 17:15                 ` Christopher Allan Webber [this message]
2016-03-11 13:14           ` Mathieu Lirzin
2016-03-11 16:30             ` Christopher Allan Webber
2016-03-11 17:56               ` Mathieu Lirzin
2016-03-25 19:06           ` Christopher Allan Webber
2016-03-16 11:55 ` Guile & Emacs chat at emacs hackathon/bug-crush SF Mikael Djurfeldt
2016-03-16 18:58   ` Stefan Husmann

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

  List information: https://www.gnu.org/software/guile/

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

  git send-email \
    --in-reply-to=87ziu3y5v5.fsf@dustycloud.org \
    --to=cwebber@dustycloud.org \
    --cc=guile-devel@gnu.org \
    --cc=taylanbayirli@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
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;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).