You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by luc <lu...@spaceroots.org> on 2014/10/07 15:17:27 UTC
Re: [Math] Apache/Git question (Was: [1/2] git commit: Updated developers documentation [...])
Hi 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 <lu...@apache.org>
>> Authored: Mon Oct 6 14:22:00 2014 +0200
>> Committer: Luc Maisonobe <lu...@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 <lu...@apache.org>
Commit: Luc Maisonobe <lu...@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 <lu...@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
>
>
> Thanks,
> Gilles
>
>> </p>
>> </subsection>
>> <subsection name='Documentation'>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org
Re: [Math] Apache/Git question (Was: [1/2] git commit: Updated
developers documentation [...])
Posted by Gilles <gi...@harfang.homelinux.org>.
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 <lu...@apache.org>
>>> Authored: Mon Oct 6 14:22:00 2014 +0200
>>> Committer: Luc Maisonobe <lu...@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 <lu...@apache.org>
> Commit: Luc Maisonobe <lu...@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 <lu...@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