commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gilles <gil...@harfang.homelinux.org>
Subject Re: [Math] Apache/Git question (Was: [1/2] git commit: Updated developers documentation [...])
Date Tue, 07 Oct 2014 14:20:21 GMT
On Tue, 07 Oct 2014 15:17:27 +0200, luc wrote:

Thanks for the explanations.

Gilles

>
> Le 2014-10-07 12:12, Gilles a écrit :
>> Hello Luc.
>> On Mon, 06 Oct 2014 20:03:28 -0000, luc@apache.org wrote:
>>> Repository: commons-math
>>> Updated Branches:
>>>   refs/heads/master 026af89ce -> e99b9ef25
>>>
>>> Updated developers documentation after migration to Git.
>>> Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
>>> Commit: 
>>> http://git-wip-us.apache.org/repos/asf/commons-math/commit/58ecf6b9
>>> Tree: 
>>> http://git-wip-us.apache.org/repos/asf/commons-math/tree/58ecf6b9
>>> Diff: 
>>> http://git-wip-us.apache.org/repos/asf/commons-math/diff/58ecf6b9
>>> Branch: refs/heads/master
>>> Commit: 58ecf6b9543e0b5edc2bef8c4f4b4965d0a70f24
>>> Parents: 026af89
>>> Author: Luc Maisonobe <luc@apache.org>
>>> Authored: Mon Oct 6 14:22:00 2014 +0200
>>> Committer: Luc Maisonobe <luc@apache.org>
>>> Committed: Mon Oct 6 14:25:09 2014 +0200
>>>
>>> 
>>> ----------------------------------------------------------------------
>>>  src/site/xdoc/developers.xml | 28 ++++++++++++++++------------
>>>  1 file changed, 16 insertions(+), 12 deletions(-)
>>> 
>>> ----------------------------------------------------------------------
>>>
>>>
>>> 
>>> http://git-wip-us.apache.org/repos/asf/commons-math/blob/58ecf6b9/src/site/xdoc/developers.xml
>>> 
>>> ----------------------------------------------------------------------
>>> diff --git a/src/site/xdoc/developers.xml 
>>> b/src/site/xdoc/developers.xml
>>> index 825fc22..d74595b 100644
>>> --- a/src/site/xdoc/developers.xml
>>> +++ b/src/site/xdoc/developers.xml
>>> @@ -47,14 +47,14 @@
>>>              founded.
>>>          </li>
>>>          <li>Download the Commons Math source code.  Follow the 
>>> instructions
>>> -        under the heading "Anonymous Subversion" on the
>>> -        <a 
>>> href="http://www.apache.org/dev/version-control.html">Apache version
>>> -         control page</a>  (Also have a look at the
>>> -        <a href="http://wiki.apache.org/commons/UsingSVN">Commons 
>>> wiki
>>> -        svn page </a>) to check out the Commons Math code base 
>>> from Subversion.
>>> -        The svn url for the current development sources of Commons 
>>> Math
>>> -        is
>>> 
>>> -<source>https://svn.apache.org/repos/asf/commons/proper/math/trunk</source>
>>> +        under the heading "Repository Checkout" on the
>>> +        <a href="https://git-wip-us.apache.org/">Git at the ASF 
>>> page</a>.
>>> +        The git url for the current development sources of Commons 
>>> Math
>>> +        is 
>>> <source>http://apacheid@git-wip-us.apache.org/repos/asf/commons-math.git</source>
>>> +        for anonymous read-only access and
>>> +        
>>> <source>https://apacheid@git-wip-us.apache.org/repos/asf/commons-math.git</source>
>>> +        (where apacheid should be replaced by each committer 
>>> Apache ID) for committers
>>> +        read-write access.
>>>          </li>
>>>          <li>Like most commons components, Commons Math uses Apache
>>> Maven as our
>>>              build tool. The sources can also be built using Ant (a 
>>> working
>>> @@ -152,10 +152,14 @@
>>>       Please make sure to set your IDE or editor to use spaces
>>> instead of tabs.
>>>      </p>
>>>      <p>
>>> -      Committers should make sure that svn properties are 
>>> correctly set on
>>> -      files added to the repository.  See the section on Committer 
>>> Subversion
>>> -      Access on the <a 
>>> href="http://www.apache.org/dev/version-control.html">
>>> -      Apache Source Code Repositories</a> page.
>>> +     Committers should configure the <source>user.name</source>,
>>> +     <source>user.email</source> and 
>>> <source>core.autocrlf</source>
>>> +     git repository or global options with <source>git 
>>> config</source>.
>>> +     The first two options set the identity and mail of the 
>>> committer.
>>> +     The third option deals with line endings to achieve 
>>> consistency
>>> +     in line endings. Windows users should configure this option 
>>> to
>>> +     <source>true</source> while OS X and Linux users should 
>>> configure
>> Is the "user.name" the Apache id or just the real name? [I.e. what 
>> is this
>> setting used for?]
>
> It is the real name. It is used to populate the various fields in the 
> commit.
> If for example I run "git log -1 --format=full" in a command window 
> after
> the last commit I made a few minutes ago, I get:
>
> commit a67f0a33e68abf1c985db28b19ce70f427fd48bd
> Author: Luc Maisonobe <luc@apache.org>
> Commit: Luc Maisonobe <luc@apache.org>
>
>     Added all Java 8 StrictMath methods to FastMath.
>
>     This change allows FastMath to remain compatible with newer Java
>     versions, despite it stiil requires only Java 5 to compile and 
> run.
>
>     JIRA: MATH-1156
>
>
> So user.name was used to put Luc Maisonobe at the start of the Author
> and Commit fields,
> and user.email was used to append <luc@apache.org> in the same fields 
> (note
> that the property value is luc@apache.org for me, the brackets have 
> been
> inserted automatically by Git when the commit was created.
>
>> Perhaps the documentation should show how one does actually set the
>> values. [The first few newbie documentation I came across did not
>> mention "git config".]
>
> I did not include it because it was already described in the Apache 
> page I
> linked to: <https://git-wip-us.apache.org/>, in the "Committers:
> Getting Started"
> section near the beginning of the page.
>
> I'll add a reference to the Git book too. Here it is:
> <http://www.git-scm.com/book/en/Customizing-Git-Git-Configuration>.
>
>
>>
>>> +     it to <source>input</source>.
>> What is "input" and how does it differ from "true"?
>
> A ggod explanation is in the Git book page on configuration, here is
> a direct link:
> 
> <http://www.git-scm.com/book/en/Customizing-Git-Git-Configuration#Formatting-and-Whitespace>.
>
> Basically, the core.autocrlf setting can take several different
> values: "true", "false", "input".
> True means that you always convert from the repository LF to
> workspace CRLF, which is useful for Windows.
> Input means that you convert only in one direction (from workspace to
> repository, stripping accidental
> CRLF so the repository is always clear with LF only), anf false means
> you don't convert anything, so
> it works only when everyone uses the same patform (i.e. all Windows
> or all Linux/OS-X). It is clearly
> irrelevant for us.
>
> best regards,
> Luc



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Mime
View raw message