On 09/08/2016 03:09 PM, Waldek Hebisch wrote:
> Commit messages are essentialy titles of changes.  They are
> used to produce various "tables of content".  To work well
> for this purpose they should be short, preferably below
> 50 characters.

Wrong. Read the links that I have sent and learn that with

  git log --oneline

one gets exactly those 50-character subject lines, but still can have
more information stored in the commit message.

Additionally, with today's tools I find the ChangeLog file somewhat
redundant.

For example.

git log -3 --oneline 631fa1ac41aaae361610c85d4a6e47b69cf97de6
631fa1a fix aldor compilation
1d8cf06 Eliminate use of sets in lodof2
eb8d7fe Generalize nonassociative rings

but

git log -3 631fa1ac41aaae361610c85d4a6e47b69cf97de6
commit 631fa1ac41aaae361610c85d4a6e47b69cf97de6
Author: Ralf Hemmecke <[email protected]>
Date:   Tue Sep 15 19:27:03 2015 +0000

    fix aldor compilation

    After generalization of the coefficient domain of polynomials from
    Ring to Join(SemiRng, AbelianMonoid)
    (r1933 "Generalize polynomials to semirings", 2015-08-21 02:41:11),
    also the initlist must be generalized.

    git-svn-id:
https://fricas.svn.sourceforge.net/svnroot/fricas/trunk@1946
b0c55286-4f34-0410-a049-a1e7e93b0762

commit 1d8cf06fa717f3924736d89bbaa094a5228cc589
Author: Waldek Hebisch <[email protected]>
Date:   Mon Sep 14 22:39:53 2015 +0000

    Eliminate use of sets in lodof2


    git-svn-id:
https://fricas.svn.sourceforge.net/svnroot/fricas/trunk@1945
b0c55286-4f34-0410-a049-a1e7e93b0762

commit eb8d7fe9e23258df0d123285b490781cc40b11e9
Author: Waldek Hebisch <[email protected]>
Date:   Fri Sep 11 17:48:56 2015 +0000

    Generalize nonassociative rings


    git-svn-id:
https://fricas.svn.sourceforge.net/svnroot/fricas/trunk@1944
b0c55286-4f34-0410-a049-a1e7e93b0762


It's all a matter of how much one developer wants to communicate to
his/her fellow followers/collaborators.

Where else (if not in the commit message) would you write about the WHY
of the commit?

Ralf

-- 
You received this message because you are subscribed to the Google Groups 
"FriCAS - computer algebra system" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/fricas-devel.
For more options, visit https://groups.google.com/d/optout.

Reply via email to