You are viewing a plain text version of this content. The canonical link for it is here.
Posted to github@arrow.apache.org by GitBox <gi...@apache.org> on 2022/03/02 00:47:23 UTC
[GitHub] [arrow] davisusanibar opened a new pull request #12538: [JAVA]: WIP - Java Tutorial: Getting Started Section
davisusanibar opened a new pull request #12538:
URL: https://github.com/apache/arrow/pull/12538
Jira ticket related: https://issues.apache.org/jira/browse/ARROW-15572
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] davisusanibar commented on a change in pull request #12538: [JAVA][DOC]: WIP - Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
davisusanibar commented on a change in pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#discussion_r818203225
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,148 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules is currently compatible with JDK 8 / 9 / 10 / 11.
+
+Using Maven
+-----------
+
+Downloading in Maven is triggered by a project declaring a dependency that is not present in the local repository.
Review comment:
Deleted
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] ursabot commented on pull request #12538: ARROW-15572: [Java][Docs] Add Installation section to Java documentation
Posted by GitBox <gi...@apache.org>.
ursabot commented on pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#issuecomment-1058425859
Benchmark runs are scheduled for baseline = 9719eae66dcf38c966ae769215d27020a6dd5550 and contender = 650f111b524fb1c5bfbfa6f533d15929c90ddc40. 650f111b524fb1c5bfbfa6f533d15929c90ddc40 is a master commit associated with this PR. Results will be available as each benchmark for each run completes.
Conbench compare runs links:
[Scheduled] [ec2-t3-xlarge-us-east-2](https://conbench.ursa.dev/compare/runs/0caa28678d194dc0b298bad2a2b53ca3...e17e5589de7c4e00b33733d718138f35/)
[Scheduled] [test-mac-arm](https://conbench.ursa.dev/compare/runs/f85c32d499a944df8a229a51f0aa8efb...8b3aad60d4784caf88bd24111053e0c9/)
[Scheduled] [ursa-i9-9960x](https://conbench.ursa.dev/compare/runs/5a56a8e391904fa38b23a33f43ab61d6...740b1d2fac264ce59165fbf91385f495/)
[Scheduled] [ursa-thinkcentre-m75q](https://conbench.ursa.dev/compare/runs/8ea69c725c34424e867ffbbafe2533e4...4bd7016c20f944ff9d12bf8f8ad05aa8/)
Supported benchmarks:
ec2-t3-xlarge-us-east-2: Supported benchmark langs: Python. Runs only benchmarks with cloud = True
test-mac-arm: Supported benchmark langs: C++, Python, R
ursa-i9-9960x: Supported benchmark langs: Python, R, JavaScript
ursa-thinkcentre-m75q: Supported benchmark langs: C++, Java
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] ursabot edited a comment on pull request #12538: ARROW-15572: [Java][Docs] Add Installation section to Java documentation
Posted by GitBox <gi...@apache.org>.
ursabot edited a comment on pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#issuecomment-1058425859
Benchmark runs are scheduled for baseline = 9719eae66dcf38c966ae769215d27020a6dd5550 and contender = 650f111b524fb1c5bfbfa6f533d15929c90ddc40. 650f111b524fb1c5bfbfa6f533d15929c90ddc40 is a master commit associated with this PR. Results will be available as each benchmark for each run completes.
Conbench compare runs links:
[Finished :arrow_down:0.0% :arrow_up:0.0%] [ec2-t3-xlarge-us-east-2](https://conbench.ursa.dev/compare/runs/0caa28678d194dc0b298bad2a2b53ca3...e17e5589de7c4e00b33733d718138f35/)
[Finished :arrow_down:0.08% :arrow_up:0.0%] [test-mac-arm](https://conbench.ursa.dev/compare/runs/f85c32d499a944df8a229a51f0aa8efb...8b3aad60d4784caf88bd24111053e0c9/)
[Scheduled] [ursa-i9-9960x](https://conbench.ursa.dev/compare/runs/5a56a8e391904fa38b23a33f43ab61d6...740b1d2fac264ce59165fbf91385f495/)
[Finished :arrow_down:0.34% :arrow_up:0.09%] [ursa-thinkcentre-m75q](https://conbench.ursa.dev/compare/runs/8ea69c725c34424e867ffbbafe2533e4...4bd7016c20f944ff9d12bf8f8ad05aa8/)
Supported benchmarks:
ec2-t3-xlarge-us-east-2: Supported benchmark langs: Python. Runs only benchmarks with cloud = True
test-mac-arm: Supported benchmark langs: C++, Python, R
ursa-i9-9960x: Supported benchmark langs: Python, R, JavaScript
ursa-thinkcentre-m75q: Supported benchmark langs: C++, Java
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] ursabot edited a comment on pull request #12538: ARROW-15572: [Java][Docs] Add Installation section to Java documentation
Posted by GitBox <gi...@apache.org>.
ursabot edited a comment on pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#issuecomment-1058425859
Benchmark runs are scheduled for baseline = 9719eae66dcf38c966ae769215d27020a6dd5550 and contender = 650f111b524fb1c5bfbfa6f533d15929c90ddc40. 650f111b524fb1c5bfbfa6f533d15929c90ddc40 is a master commit associated with this PR. Results will be available as each benchmark for each run completes.
Conbench compare runs links:
[Finished :arrow_down:0.0% :arrow_up:0.0%] [ec2-t3-xlarge-us-east-2](https://conbench.ursa.dev/compare/runs/0caa28678d194dc0b298bad2a2b53ca3...e17e5589de7c4e00b33733d718138f35/)
[Finished :arrow_down:0.08% :arrow_up:0.0%] [test-mac-arm](https://conbench.ursa.dev/compare/runs/f85c32d499a944df8a229a51f0aa8efb...8b3aad60d4784caf88bd24111053e0c9/)
[Finished :arrow_down:0.71% :arrow_up:0.0%] [ursa-i9-9960x](https://conbench.ursa.dev/compare/runs/5a56a8e391904fa38b23a33f43ab61d6...740b1d2fac264ce59165fbf91385f495/)
[Finished :arrow_down:0.34% :arrow_up:0.09%] [ursa-thinkcentre-m75q](https://conbench.ursa.dev/compare/runs/8ea69c725c34424e867ffbbafe2533e4...4bd7016c20f944ff9d12bf8f8ad05aa8/)
Supported benchmarks:
ec2-t3-xlarge-us-east-2: Supported benchmark langs: Python. Runs only benchmarks with cloud = True
test-mac-arm: Supported benchmark langs: C++, Python, R
ursa-i9-9960x: Supported benchmark langs: Python, R, JavaScript
ursa-thinkcentre-m75q: Supported benchmark langs: C++, Java
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] davisusanibar commented on a change in pull request #12538: [JAVA][DOC]: WIP - Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
davisusanibar commented on a change in pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#discussion_r818203315
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,148 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules is currently compatible with JDK 8 / 9 / 10 / 11.
+
+Using Maven
+-----------
+
+Downloading in Maven is triggered by a project declaring a dependency that is not present in the local repository.
+
+Central Repository
+******************
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed. For example:
+
+.. code-block::
+
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-vector</artifactId>
+ <version>7.0.0</version>
+ </dependency
Review comment:
Added libraries and xml demo
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] lidavidm commented on a change in pull request #12538: [JAVA][DOC]: Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
lidavidm commented on a change in pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#discussion_r818639104
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,118 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+.. contents::
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules are currently compatible with Java 8 / 9 / 10 / 11.
+
+Installing from Maven
+---------------------
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed, for example for: memory-netty, format, and vector
Review comment:
This is something that would be good to explain (though probably elsewhere in the docs): what is the difference between memory-netty and memory-unsafe
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] github-actions[bot] commented on pull request #12538: [JAVA]: WIP - Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
github-actions[bot] commented on pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#issuecomment-1056017602
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
Thanks for opening a pull request!
If this is not a [minor PR](https://github.com/apache/arrow/blob/master/CONTRIBUTING.md#Minor-Fixes). Could you open an issue for this pull request on JIRA? https://issues.apache.org/jira/browse/ARROW
Opening JIRAs ahead of time contributes to the [Openness](http://theapacheway.com/open/#:~:text=Openness%20allows%20new%20users%20the,must%20happen%20in%20the%20open.) of the Apache Arrow project.
Then could you also rename pull request title in the following format?
ARROW-${JIRA_ID}: [${COMPONENT}] ${SUMMARY}
or
MINOR: [${COMPONENT}] ${SUMMARY}
See also:
* [Other pull requests](https://github.com/apache/arrow/pulls/)
* [Contribution Guidelines - How to contribute patches](https://arrow.apache.org/docs/developers/contributing.html#how-to-contribute-patches)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] davisusanibar commented on a change in pull request #12538: [JAVA][DOC]: Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
davisusanibar commented on a change in pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#discussion_r818639237
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,148 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules is currently compatible with JDK 8 / 9 / 10 / 11.
+
+Using Maven
+-----------
+
+Downloading in Maven is triggered by a project declaring a dependency that is not present in the local repository.
+
+Central Repository
+******************
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed. For example:
+
+.. code-block::
+
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-vector</artifactId>
+ <version>7.0.0</version>
+ </dependency
+
+Staging Repository
+******************
+
+Configure your maven settings.xml to download artifacts from staging repository with:
+
+.. code-block:: xml
+
+ $ cat ~/.m2/settings.xml
+ <?xml version="1.0" encoding="UTF-8"?>
+ <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+ <profiles>
+ <profile>
+ <repositories>
+ <repository>
+ <id>staged</id>
+ <name>staged-releases</name>
+ <url>https://repository.apache.org/content/repositories/staging/</url>
+ <releases>
+ <enabled>true</enabled>
+ </releases>
+ <snapshots>
+ <enabled>true</enabled>
+ </snapshots>
+ </repository>
+ </repositories>
+ <id>arrowrc</id>
+ </profile>
+ </profiles>
+ </settings>
+ $ mvn -Parrowrc clean install -X
+ Downloading from staged: https://repository.apache.org/content/repositories/staging/
+
+Installing from source
+----------------------
+
+See :ref:`java-development`.
+
+Installing Nightly Packages
Review comment:
Clear, deleted staging maven section
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] davisusanibar commented on a change in pull request #12538: [JAVA][DOC]: Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
davisusanibar commented on a change in pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#discussion_r818640420
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,118 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+.. contents::
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules are currently compatible with Java 8 / 9 / 10 / 11.
+
+Installing from Maven
+---------------------
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed, for example for: memory-netty, format, and vector
Review comment:
Yes, this is part of this ticket https://issues.apache.org/jira/browse/ARROW-15573, working on that
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] lidavidm commented on a change in pull request #12538: ARROW-15572: [Java][Docs] Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
lidavidm commented on a change in pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#discussion_r818878870
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,118 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+.. contents::
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules are currently compatible with Java 8 / 9 / 10 / 11.
+
+Installing from Maven
+---------------------
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed, for example for: memory-netty, format, and vector
+
+.. code-block::
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <project xmlns="http://maven.apache.org/POM/4.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>org.example</groupId>
+ <artifactId>demo</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ <properties>
+ <arrow.version>7.0.0</arrow.version>
+ </properties>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-vector</artifactId>
+ <version>${arrow.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-memory-netty</artifactId>
+ <version>${arrow.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-format</artifactId>
+ <version>${arrow.version}</version>
+ </dependency>
+ </dependencies>
+ </project>
+
+Installing from Source
+----------------------
+
+See :ref:`java-development`.
+
+Installing Nightly Packages
+---------------------------
+
+.. warning::
+ These packages are not official releases. Use them at your own risk.
+
+All arrow nightly version are uploaded to github assets for example for March 01 it is uploading to `Github Nightly`_
Review comment:
```suggestion
Arrow nightly builds are uploaded to GitHub. For example, for 2022/03/01, they can be found at `Github Nightly`_.
```
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,118 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+.. contents::
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules are currently compatible with Java 8 / 9 / 10 / 11.
+
+Installing from Maven
+---------------------
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed, for example for: memory-netty, format, and vector
Review comment:
```suggestion
Configure your pom.xml with the Java modules needed, for example:
``arrow-memory-netty``, ``arrow-format``, and ``arrow-vector``.
```
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,118 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+.. contents::
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules are currently compatible with Java 8 / 9 / 10 / 11.
+
+Installing from Maven
+---------------------
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed, for example for: memory-netty, format, and vector
+
+.. code-block::
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <project xmlns="http://maven.apache.org/POM/4.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>org.example</groupId>
+ <artifactId>demo</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ <properties>
+ <arrow.version>7.0.0</arrow.version>
+ </properties>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-vector</artifactId>
+ <version>${arrow.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-memory-netty</artifactId>
+ <version>${arrow.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-format</artifactId>
+ <version>${arrow.version}</version>
+ </dependency>
+ </dependencies>
+ </project>
+
+Installing from Source
+----------------------
+
+See :ref:`java-development`.
+
+Installing Nightly Packages
+---------------------------
+
+.. warning::
+ These packages are not official releases. Use them at your own risk.
+
+All arrow nightly version are uploaded to github assets for example for March 01 it is uploading to `Github Nightly`_
+
+For example if you need to test your code with these artifacts, then, you need to configure maven settings with:
Review comment:
```suggestion
To test your code with these artifacts, then configure Maven with:
```
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,118 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+.. contents::
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules are currently compatible with Java 8 / 9 / 10 / 11.
+
+Installing from Maven
+---------------------
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed, for example for: memory-netty, format, and vector
+
+.. code-block::
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <project xmlns="http://maven.apache.org/POM/4.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>org.example</groupId>
+ <artifactId>demo</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ <properties>
+ <arrow.version>7.0.0</arrow.version>
+ </properties>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-vector</artifactId>
+ <version>${arrow.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-memory-netty</artifactId>
+ <version>${arrow.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-format</artifactId>
+ <version>${arrow.version}</version>
+ </dependency>
+ </dependencies>
+ </project>
+
+Installing from Source
+----------------------
+
+See :ref:`java-development`.
+
+Installing Nightly Packages
+---------------------------
+
+.. warning::
+ These packages are not official releases. Use them at your own risk.
+
+All arrow nightly version are uploaded to github assets for example for March 01 it is uploading to `Github Nightly`_
+
+For example if you need to test your code with these artifacts, then, you need to configure maven settings with:
+
+.. code-block:: xml
+
+ $ cat ~/.m2/settings.xml
+ <?xml version="1.0" encoding="UTF-8"?>
+ <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+ <profiles>
+ <profile>
+ <repositories>
+ <repository>
+ <id>staged</id>
+ <name>staged-releases</name>
+ <url>https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/</url>
+ <releases>
+ <enabled>true</enabled>
+ </releases>
+ <snapshots>
+ <enabled>true</enabled>
+ </snapshots>
+ </repository>
+ </repositories>
+ <id>arrownightly</id>
+ </profile>
+ </profiles>
+ </settings>
+ $ mvn -Parrownightly clean install -X
+ Downloading from staged: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/org/apache/arrow/arrow-vector/8.0.0.dev143/arrow-vector-8.0.0.dev143.pom
+
+Consider that you could see arrow nightly builds at `Arrow Nightly`_.
+
+.. _Arrow Nightly: https://lists.apache.org/list.html?builds@arrow.apache.org
Review comment:
```suggestion
.. _builds@arrow.apache.org: https://lists.apache.org/list.html?builds@arrow.apache.org
```
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,118 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+.. contents::
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules are currently compatible with Java 8 / 9 / 10 / 11.
+
+Installing from Maven
+---------------------
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed, for example for: memory-netty, format, and vector
+
+.. code-block::
+
+ <?xml version="1.0" encoding="UTF-8"?>
+ <project xmlns="http://maven.apache.org/POM/4.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>org.example</groupId>
+ <artifactId>demo</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ <properties>
+ <arrow.version>7.0.0</arrow.version>
+ </properties>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-vector</artifactId>
+ <version>${arrow.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-memory-netty</artifactId>
+ <version>${arrow.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-format</artifactId>
+ <version>${arrow.version}</version>
+ </dependency>
+ </dependencies>
+ </project>
+
+Installing from Source
+----------------------
+
+See :ref:`java-development`.
+
+Installing Nightly Packages
+---------------------------
+
+.. warning::
+ These packages are not official releases. Use them at your own risk.
+
+All arrow nightly version are uploaded to github assets for example for March 01 it is uploading to `Github Nightly`_
+
+For example if you need to test your code with these artifacts, then, you need to configure maven settings with:
+
+.. code-block:: xml
+
+ $ cat ~/.m2/settings.xml
+ <?xml version="1.0" encoding="UTF-8"?>
+ <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+ <profiles>
+ <profile>
+ <repositories>
+ <repository>
+ <id>staged</id>
+ <name>staged-releases</name>
+ <url>https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/</url>
+ <releases>
+ <enabled>true</enabled>
+ </releases>
+ <snapshots>
+ <enabled>true</enabled>
+ </snapshots>
+ </repository>
+ </repositories>
+ <id>arrownightly</id>
+ </profile>
+ </profiles>
+ </settings>
+ $ mvn -Parrownightly clean install -X
+ Downloading from staged: https://github.com/ursacomputing/crossbow/releases/tag/nightly-2022-03-01-0-github-java-jars/org/apache/arrow/arrow-vector/8.0.0.dev143/arrow-vector-8.0.0.dev143.pom
+
+Consider that you could see arrow nightly builds at `Arrow Nightly`_.
Review comment:
```suggestion
Arrow nightly builds are posted on the mailing list at `builds@arrow.apache.org`_.
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] davisusanibar commented on a change in pull request #12538: [JAVA][DOC]: WIP - Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
davisusanibar commented on a change in pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#discussion_r818205469
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,148 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules is currently compatible with JDK 8 / 9 / 10 / 11.
+
+Using Maven
+-----------
+
+Downloading in Maven is triggered by a project declaring a dependency that is not present in the local repository.
+
+Central Repository
+******************
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed. For example:
+
+.. code-block::
+
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-vector</artifactId>
+ <version>7.0.0</version>
+ </dependency
+
+Staging Repository
+******************
+
+Configure your maven settings.xml to download artifacts from staging repository with:
+
+.. code-block:: xml
+
+ $ cat ~/.m2/settings.xml
+ <?xml version="1.0" encoding="UTF-8"?>
+ <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+ <profiles>
+ <profile>
+ <repositories>
+ <repository>
+ <id>staged</id>
+ <name>staged-releases</name>
+ <url>https://repository.apache.org/content/repositories/staging/</url>
+ <releases>
+ <enabled>true</enabled>
+ </releases>
+ <snapshots>
+ <enabled>true</enabled>
+ </snapshots>
+ </repository>
+ </repositories>
+ <id>arrowrc</id>
+ </profile>
+ </profiles>
+ </settings>
+ $ mvn -Parrowrc clean install -X
+ Downloading from staged: https://repository.apache.org/content/repositories/staging/
+
+Installing from source
+----------------------
+
+See :ref:`java-development`.
+
+Installing Nightly Packages
Review comment:
Nightly packages are added by arrow nightly jobs and uploaded to github assets.
For staging it is not aligned with github assets and it depend of dev/release/06-java-upload.sh.
If RC on nexus is closed, the artifacts will be available in the staging repository.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] lidavidm commented on a change in pull request #12538: [JAVA][DOC]: Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
lidavidm commented on a change in pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#discussion_r818628107
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,148 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules is currently compatible with JDK 8 / 9 / 10 / 11.
+
+Using Maven
+-----------
+
+Downloading in Maven is triggered by a project declaring a dependency that is not present in the local repository.
+
+Central Repository
+******************
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed. For example:
+
+.. code-block::
+
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-vector</artifactId>
+ <version>7.0.0</version>
+ </dependency
+
+Staging Repository
+******************
+
+Configure your maven settings.xml to download artifacts from staging repository with:
+
+.. code-block:: xml
+
+ $ cat ~/.m2/settings.xml
+ <?xml version="1.0" encoding="UTF-8"?>
+ <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+ <profiles>
+ <profile>
+ <repositories>
+ <repository>
+ <id>staged</id>
+ <name>staged-releases</name>
+ <url>https://repository.apache.org/content/repositories/staging/</url>
+ <releases>
+ <enabled>true</enabled>
+ </releases>
+ <snapshots>
+ <enabled>true</enabled>
+ </snapshots>
+ </repository>
+ </repositories>
+ <id>arrowrc</id>
+ </profile>
+ </profiles>
+ </settings>
+ $ mvn -Parrowrc clean install -X
+ Downloading from staged: https://repository.apache.org/content/repositories/staging/
+
+Installing from source
+----------------------
+
+See :ref:`java-development`.
+
+Installing Nightly Packages
Review comment:
I still don't see why a developer should care about staging artifacts. Either they want the latest stable release or they want to test nightlies.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] lidavidm edited a comment on pull request #12538: ARROW-15572: [Java][Docs] Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
lidavidm edited a comment on pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#issuecomment-1058049938
@davisusanibar just a note for the future, try to make sure the PR title follows the expected format (`ARROW-12345: [Java][Docs] ...`)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] lidavidm commented on pull request #12538: ARROW-15572: [Java][Docs] Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
lidavidm commented on pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#issuecomment-1058049938
@davisusanibar just a note for the future, try to make sure the PR title follows the expected format (`ARROW-12345: [Java][Doc] ...`)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] lidavidm commented on a change in pull request #12538: [JAVA][DOC]: WIP - Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
lidavidm commented on a change in pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#discussion_r817674075
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,148 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules is currently compatible with JDK 8 / 9 / 10 / 11.
+
+Using Maven
+-----------
+
+Downloading in Maven is triggered by a project declaring a dependency that is not present in the local repository.
+
+Central Repository
+******************
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed. For example:
+
+.. code-block::
+
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-vector</artifactId>
+ <version>7.0.0</version>
+ </dependency
Review comment:
There's a missing bracket here, also, shouldn't we show the 'full' set of dependencies needed? i.e. memory-netty, format, and vector? We also don't need to explain Maven or pom.xml here. Just state what modules are needed and show the example XML.
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,148 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules is currently compatible with JDK 8 / 9 / 10 / 11.
Review comment:
```suggestion
Java modules are currently compatible with Java 8 / 9 / 10 / 11.
```
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,148 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules is currently compatible with JDK 8 / 9 / 10 / 11.
+
+Using Maven
+-----------
+
+Downloading in Maven is triggered by a project declaring a dependency that is not present in the local repository.
Review comment:
I don't think we need to explain how Maven works to Java developers.
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,148 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules is currently compatible with JDK 8 / 9 / 10 / 11.
+
+Using Maven
+-----------
+
+Downloading in Maven is triggered by a project declaring a dependency that is not present in the local repository.
+
+Central Repository
+******************
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed. For example:
+
+.. code-block::
+
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-vector</artifactId>
+ <version>7.0.0</version>
+ </dependency
+
+Staging Repository
+******************
+
+Configure your maven settings.xml to download artifacts from staging repository with:
+
+.. code-block:: xml
+
+ $ cat ~/.m2/settings.xml
+ <?xml version="1.0" encoding="UTF-8"?>
+ <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+ <profiles>
+ <profile>
+ <repositories>
+ <repository>
+ <id>staged</id>
+ <name>staged-releases</name>
+ <url>https://repository.apache.org/content/repositories/staging/</url>
+ <releases>
+ <enabled>true</enabled>
+ </releases>
+ <snapshots>
+ <enabled>true</enabled>
+ </snapshots>
+ </repository>
+ </repositories>
+ <id>arrowrc</id>
+ </profile>
+ </profiles>
+ </settings>
+ $ mvn -Parrowrc clean install -X
+ Downloading from staged: https://repository.apache.org/content/repositories/staging/
+
+Installing from source
+----------------------
+
+See :ref:`java-development`.
+
+Installing Nightly Packages
+---------------------------
+
+.. warning::
+ These packages are not official releases. Use them at your own risk.
+
+All arrow nightly version are uploaded to github assets for example for March 01 it is uploading to `Github Nightly`_
+
+.. image:: img/java_nightly_github_asset.png
Review comment:
I don't think we need the image. Also, we can just link to GitHub.
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,148 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules is currently compatible with JDK 8 / 9 / 10 / 11.
+
+Using Maven
+-----------
+
+Downloading in Maven is triggered by a project declaring a dependency that is not present in the local repository.
+
+Central Repository
+******************
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed. For example:
+
+.. code-block::
+
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-vector</artifactId>
+ <version>7.0.0</version>
+ </dependency
+
+Staging Repository
+******************
+
+Configure your maven settings.xml to download artifacts from staging repository with:
+
+.. code-block:: xml
+
+ $ cat ~/.m2/settings.xml
+ <?xml version="1.0" encoding="UTF-8"?>
+ <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+ <profiles>
+ <profile>
+ <repositories>
+ <repository>
+ <id>staged</id>
+ <name>staged-releases</name>
+ <url>https://repository.apache.org/content/repositories/staging/</url>
+ <releases>
+ <enabled>true</enabled>
+ </releases>
+ <snapshots>
+ <enabled>true</enabled>
+ </snapshots>
+ </repository>
+ </repositories>
+ <id>arrowrc</id>
+ </profile>
+ </profiles>
+ </settings>
+ $ mvn -Parrowrc clean install -X
+ Downloading from staged: https://repository.apache.org/content/repositories/staging/
+
+Installing from source
+----------------------
+
+See :ref:`java-development`.
+
+Installing Nightly Packages
Review comment:
If these are the nightly packages, then what is the purpose of the staging repository above?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] davisusanibar commented on a change in pull request #12538: [JAVA][DOC]: WIP - Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
davisusanibar commented on a change in pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#discussion_r818203378
##########
File path: docs/source/java/install.rst
##########
@@ -0,0 +1,148 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements. See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership. The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License. You may obtain a copy of the License at
+
+.. http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied. See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Installing Java Modules
+=======================
+
+System Compatibility
+--------------------
+
+Java modules are regularly built and tested on macOS and Linux distributions.
+
+Java Compatibility
+------------------
+
+Java modules is currently compatible with JDK 8 / 9 / 10 / 11.
+
+Using Maven
+-----------
+
+Downloading in Maven is triggered by a project declaring a dependency that is not present in the local repository.
+
+Central Repository
+******************
+
+By default, Maven will download from the central repository: https://repo.maven.apache.org/maven2/org/apache/arrow/
+
+Configure your pom.xml with java module version needed. For example:
+
+.. code-block::
+
+ <dependency>
+ <groupId>org.apache.arrow</groupId>
+ <artifactId>arrow-vector</artifactId>
+ <version>7.0.0</version>
+ </dependency
+
+Staging Repository
+******************
+
+Configure your maven settings.xml to download artifacts from staging repository with:
+
+.. code-block:: xml
+
+ $ cat ~/.m2/settings.xml
+ <?xml version="1.0" encoding="UTF-8"?>
+ <settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd" xmlns="http://maven.apache.org/SETTINGS/1.1.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+ <profiles>
+ <profile>
+ <repositories>
+ <repository>
+ <id>staged</id>
+ <name>staged-releases</name>
+ <url>https://repository.apache.org/content/repositories/staging/</url>
+ <releases>
+ <enabled>true</enabled>
+ </releases>
+ <snapshots>
+ <enabled>true</enabled>
+ </snapshots>
+ </repository>
+ </repositories>
+ <id>arrowrc</id>
+ </profile>
+ </profiles>
+ </settings>
+ $ mvn -Parrowrc clean install -X
+ Downloading from staged: https://repository.apache.org/content/repositories/staging/
+
+Installing from source
+----------------------
+
+See :ref:`java-development`.
+
+Installing Nightly Packages
+---------------------------
+
+.. warning::
+ These packages are not official releases. Use them at your own risk.
+
+All arrow nightly version are uploaded to github assets for example for March 01 it is uploading to `Github Nightly`_
+
+.. image:: img/java_nightly_github_asset.png
Review comment:
Deleted
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] lidavidm closed pull request #12538: ARROW-15572: [Java][Docs] Add Installation section to Java documentation
Posted by GitBox <gi...@apache.org>.
lidavidm closed pull request #12538:
URL: https://github.com/apache/arrow/pull/12538
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] github-actions[bot] commented on pull request #12538: ARROW-15572: [Java][Docs] Java Tutorial: Getting Started Section
Posted by GitBox <gi...@apache.org>.
github-actions[bot] commented on pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#issuecomment-1058049834
https://issues.apache.org/jira/browse/ARROW-15572
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow] ursabot edited a comment on pull request #12538: ARROW-15572: [Java][Docs] Add Installation section to Java documentation
Posted by GitBox <gi...@apache.org>.
ursabot edited a comment on pull request #12538:
URL: https://github.com/apache/arrow/pull/12538#issuecomment-1058425859
Benchmark runs are scheduled for baseline = 9719eae66dcf38c966ae769215d27020a6dd5550 and contender = 650f111b524fb1c5bfbfa6f533d15929c90ddc40. 650f111b524fb1c5bfbfa6f533d15929c90ddc40 is a master commit associated with this PR. Results will be available as each benchmark for each run completes.
Conbench compare runs links:
[Finished :arrow_down:0.0% :arrow_up:0.0%] [ec2-t3-xlarge-us-east-2](https://conbench.ursa.dev/compare/runs/0caa28678d194dc0b298bad2a2b53ca3...e17e5589de7c4e00b33733d718138f35/)
[Scheduled] [test-mac-arm](https://conbench.ursa.dev/compare/runs/f85c32d499a944df8a229a51f0aa8efb...8b3aad60d4784caf88bd24111053e0c9/)
[Scheduled] [ursa-i9-9960x](https://conbench.ursa.dev/compare/runs/5a56a8e391904fa38b23a33f43ab61d6...740b1d2fac264ce59165fbf91385f495/)
[Scheduled] [ursa-thinkcentre-m75q](https://conbench.ursa.dev/compare/runs/8ea69c725c34424e867ffbbafe2533e4...4bd7016c20f944ff9d12bf8f8ad05aa8/)
Supported benchmarks:
ec2-t3-xlarge-us-east-2: Supported benchmark langs: Python. Runs only benchmarks with cloud = True
test-mac-arm: Supported benchmark langs: C++, Python, R
ursa-i9-9960x: Supported benchmark langs: Python, R, JavaScript
ursa-thinkcentre-m75q: Supported benchmark langs: C++, Java
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org