This is an automated email from the ASF dual-hosted git repository. Cole-Greer pushed a commit to branch docs-3.7 in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
commit f53f3f3b0bd4a848758d2db873774edc43d85be1 Author: Cole Greer <[email protected]> AuthorDate: Thu Jun 4 19:42:15 2026 -0700 Scope Hadoop hdfs.ls() docs examples to the copied file (tinkerpop-6jq.7) The docs build runs the Hadoop-Gremlin OLTP/OLAP examples against the local filesystem (fs.defaultFS=file:///). Hadoop's RawLocalFileSystem resolves a bare hdfs.ls() to getHomeDirectory(), which reads the JVM user.home, so the rendered docs listed the entire contents of the build machine's home directory instead of the clean HDFS home the published docs show. Change the bare hdfs.ls() calls in implementations-hadoop-start and implementations-hadoop-end to hdfs.ls('tinkerpop-modern.kryo') so they list only the graph file the example just copied -- deterministic output with no home-directory leakage, and no change to the shared hadoop-gryo input location. (A full MiniDFSCluster would reproduce the published HDFS output exactly; that is tracked separately under tinkerpop-6jq.12.) Assisted-by: Kiro:claude-opus-4.8 [kiro-cli] --- CHANGELOG.asciidoc | 1 + docs/src/reference/implementations-hadoop-end.asciidoc | 4 ++-- docs/src/reference/implementations-hadoop-start.asciidoc | 2 +- 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index 898725b565..9eda62efb4 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -28,6 +28,7 @@ image::https://raw.githubusercontent.com/apache/tinkerpop/master/docs/static/ima * Restart the documentation build's Gremlin Console with conflicting plugins excluded per-book (via the `gremlin-docs-plugins-exclude` attribute), so Neo4j (Scala 2.11) and Spark (Scala 2.12) no longer collide on a shared classpath. * Updated the developer documentation to describe the Maven/AsciidoctorJ documentation build and removed references to the retired shell/AWK preprocessor. * Apply syntax highlighting to standalone and manual language-variant tab blocks in the documentation build, matching the highlighting already applied to `gremlin-groovy` tabs. +* Scope the Hadoop-Gremlin documentation `hdfs.ls()` examples to the copied graph file so the rendered docs no longer list the build machine's local home directory. * Fixed conjoin has incorrect null handling. * Expanded `gremlin-python` CI matrix to test against Python 3.9, 3.10, 3.11, 3.12, and 3.13. diff --git a/docs/src/reference/implementations-hadoop-end.asciidoc b/docs/src/reference/implementations-hadoop-end.asciidoc index e0711af0d2..338792d6fe 100644 --- a/docs/src/reference/implementations-hadoop-end.asciidoc +++ b/docs/src/reference/implementations-hadoop-end.asciidoc @@ -163,12 +163,12 @@ The results of any OLAP operation are stored in HDFS accessible via `hdfs`. For ---- graph = GraphFactory.open('conf/hadoop/hadoop-gryo.properties') graph.compute(SparkGraphComputer).program(PeerPressureVertexProgram.build().create(graph)).mapReduce(ClusterCountMapReduce.build().memoryKey('clusterCount').create()).submit().get(); -hdfs.ls() +hdfs.ls('tinkerpop-modern.kryo') hdfs.ls('output') hdfs.head('output', GryoInputFormat) hdfs.head('output', 'clusterCount', SequenceFileInputFormat) hdfs.rm('output') -hdfs.ls() +hdfs.ls('tinkerpop-modern.kryo') ---- [[interacting-with-spark]] diff --git a/docs/src/reference/implementations-hadoop-start.asciidoc b/docs/src/reference/implementations-hadoop-start.asciidoc index 6ca4f65a93..686eaaf47e 100644 --- a/docs/src/reference/implementations-hadoop-start.asciidoc +++ b/docs/src/reference/implementations-hadoop-start.asciidoc @@ -151,7 +151,7 @@ which is the OLAP Gremlin machine. [gremlin-groovy] ---- hdfs.copyFromLocal('data/tinkerpop-modern.kryo', 'tinkerpop-modern.kryo') -hdfs.ls() +hdfs.ls('tinkerpop-modern.kryo') graph = GraphFactory.open('conf/hadoop/hadoop-gryo.properties') g = traversal().withEmbedded(graph) g.V().count()
