[
https://issues.apache.org/jira/browse/CASSANDRA-21444?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18087636#comment-18087636
]
Maxim Muzafarov commented on CASSANDRA-21444:
---------------------------------------------
With these changes we are able to save ~ 40 sec of the build time.
*CASSANDRA-21444*
{code:bash}
maxim.muzafarov@MMP cassandra % ant gen-asciidoc -Dno-build-accord=true
jar:
gen-nodetool-text:
[java] OpenJDK 64-Bit Server VM warning: Option UseConcMarkSweepGC was
deprecated in version 9.0 and will likely be removed in a future release.
gen-asciidoc:
[exec] python3 ./scripts/gen-antora-yml.py
[exec] python3 ./scripts/gen-nodetool-docs.py
[exec] python3 ./scripts/convert_yaml_to_adoc.py ../conf/cassandra.yaml
./modules/cassandra/pages/managing/configuration/cass_yaml_file.adoc
[exec] ./scripts/gen-native-protocol-docs.sh
[exec] Processing native protocol specs...
[exec] -> modules/cassandra/attachments/native_protocol_v5.html
[exec] -> modules/cassandra/attachments/native_protocol_v4.html
[exec] -> modules/cassandra/attachments/native_protocol_v3.html
[exec] -> modules/cassandra/pages/reference/native-protocol.adoc
[exec] Done
BUILD SUCCESSFUL
Total time: 23 seconds
{code}
*trunk*
{code:bash}
maxim.muzafarov@MMP cassandra % ant gen-asciidoc -Dno-build-accord=true
jar:
gen-asciidoc:
[exec] python3 ./scripts/gen-antora-yml.py
[exec] python3 ./scripts/gen-nodetool-docs.py
[exec] python3 ./scripts/convert_yaml_to_adoc.py ../conf/cassandra.yaml
./modules/cassandra/pages/managing/configuration/cass_yaml_file.adoc
[exec] ./scripts/gen-native-protocol-docs.sh
[exec] Processing native protocol specs...
[exec] -> modules/cassandra/attachments/native_protocol_v5.html
[exec] -> modules/cassandra/attachments/native_protocol_v4.html
[exec] -> modules/cassandra/attachments/native_protocol_v3.html
[exec] -> modules/cassandra/pages/reference/native-protocol.adoc
[exec] Done
BUILD SUCCESSFUL
Total time: 1 minute 8 seconds
{code}
> Speed up nodetool documentation generation by producing all command help in a
> single jvm
> ----------------------------------------------------------------------------------------
>
> Key: CASSANDRA-21444
> URL: https://issues.apache.org/jira/browse/CASSANDRA-21444
> Project: Apache Cassandra
> Issue Type: Task
> Components: Build
> Reporter: Maxim Muzafarov
> Assignee: Maxim Muzafarov
> Priority: Normal
> Fix For: 6.x, 7.x
>
>
> Generating the nodetool AsciiDoc documentation is slow as the
> gen-nodetool-docs script uses the nodetool command-line wrapper to capture
> help text for eac command. Each invocation starts a brand-new jvm, so
> building the documentation incurs the jvm startup cost over a hundred times
> (100+ node tool commands).
> This makes the documentation build unnecessarily slow and ties it to the
> shell wrapper and its environment setup. The solution: Generate the raw
> {{nodetool help}} text for every command in a single jvm.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
