summaryrefslogtreecommitdiff
path: root/share/man/just.1.md
AgeCommit message (Collapse)Author
2025-02-14just(1): Document add-to-cas --resolve-special optionPaul Cristian Sarbu
2025-01-09just build: add new option -pKlaus Aehlig
... allowing to print the unique artifact built (if any). This allows convenient inspection of the build result of targets that define precisely one artifact.
2025-01-09just(1): Add missing paragraph endKlaus Aehlig
2024-12-09just.1: Extend analysis command line...Paul Cristian Sarbu
...with local and remote build arguments required to support computed roots.
2024-10-08just analyse: support dumping the action graph without originsKlaus Aehlig
The origins of actions are useful for understanding the action graph; if, however, the action graph is only to be used for further computaiton, this is unnecessary information. Therefore, add an option to dump the action graph without origins.
2024-07-19just: Fix operation cache threshold exponent maximum valuePaul Cristian Sarbu
The threshold exponent cannot pass the log2 of the maximum internal map size, of type size_t, thus it cannot be larger than 63. Update the documentation and enforce the upper limit of this argument during parsing of the command line.
2024-05-03Update man page and CHANGELOG to reflect blob splittingKlaus Aehlig
2024-04-24just analyse: add --dump-result command line optionAlberto Sartori
The result of the analysis is a JSON object containing the keys `"artifacts"`, `"runfiles"`, and `"provides"`. This JSON object, by default, is logged. However, it might be useful to process the data contained in it, while, for example, developing new rules. This patch adds a new command line option (`--dump-result`), reserved to the subcommand `analyse`, to dump the analysis result to the given file or stdout (if `-` is given).
2024-04-23just describe: support retry argumentsKlaus Aehlig
... as also just describe can communicate to grpc endpoints.
2024-04-16just: support writing the error blobs from serve into a json fileKlaus Aehlig
... so that they are available in machine-readable form. In this way, all logs can automatically be collected without the need of parsing human-targeted error messages.
2024-04-10Add command-line option to restrict log limit on stderrKlaus Aehlig
2024-03-28just install-cas: add option --archiveKlaus Aehlig
Trees are first-class objects for justbuild. To allow interoperation with other tools, it is necessary to provide those objects in a standard format; for directories, those are archives. Hence procive a corresponding option.
2024-03-20Add new subcommand add-to-casKlaus Aehlig
2024-03-11gc: add option --no-rotationKlaus Aehlig
... to clean up what can be done without losing cache information.
2024-03-07just: 'analyse' and 'describe' require client-side authenticationPaul Cristian Sarbu
As these subcommands can access the serve endpoint, it is not enough anymore to just know the remote-execution endpoint, but one must also try to connect to it. Thus, the client-side authentication arguments need to be supported and read. The just.1 man page is also updated accordingly.
2024-02-01describe: support -RKlaus Aehlig
... as, for absent repositories, we need to get the description from the serve end point. As a consequence, also support -r and --compatible, as the remote-execution endpoint needs to fit with the one for the serve endpoint.
2024-02-01describe: accept local-build-rootKlaus Aehlig
... as even this command now adds entries to CAS, e.g., the shard for the target-level cache. Also, this command block gc by keeping a lock (also in the local build root).
2024-01-30Drop unused -R from install-cas and traverse subcommandsKlaus Aehlig
2023-12-14just analyse: support dumping the provides map of a targetKlaus Aehlig
2023-12-13Add command line options to tune the retry strategy for rpc callsAlberto Sartori
Three new command line options have been added: - `--max-attempts` - `--initial-backoff-seconds` - `--max-backoff-seconds`
2023-12-06install-cas cli: Remove remote execution properties and dispatch file...Paul Cristian Sarbu
...options from the generated help messages, as these are not used for the install-cas subcommand. This also updates the man page accordingly, where the dispatch file was marked as supported, as well as update any test affected by these changes.
2023-12-06Add CLI option to set write strategy for target-level cacheKlaus Aehlig
2023-11-16Add -R as short option for --remote-serve-addressKlaus Aehlig
The `just serve` command defaults to also provide the remote-execution endpoint if none is specified. The `just build` implicitly uses the serve endpoint as remote-execution endpoint if no other endpoint is specified. In this way, the serve endpoint has become the universal endpoint for simple set ups. Simplify that usage further by providing a short command-line option.
2023-11-02Document the new featuresPaul Cristian Sarbu
2023-09-13Document 'just serve' protocol and implementationPaul Cristian Sarbu
2023-09-05just.1: Disambiguate short name of optionPaul Cristian Sarbu
Add missing support list for --print-to-stdout option, which thus also disambiguates the -P short version.
2023-08-28man: Fix missing quoting of literalsPaul Cristian Sarbu
2023-08-16just.1 man: fix typosPaul Cristian Sarbu
2023-08-16man: Fix typosPaul Cristian Sarbu
2023-07-27Add option -P to just-install-casKlaus Aehlig
... to allow selecting a sub object of a specified tree.
2023-07-05Add CLI argument to dispatch endpointKlaus Aehlig
In this way, the user can specify which execution endpoint to use depending on the execution properties.
2023-06-26man pages: use consistent git spellingSascha Roloff
Use Git with capital G, when referring to Git in general. Use git with small g, when referring to the git command.
2023-06-26man pages: minor fixesSascha Roloff
2023-06-26man pages: consistent command referencesSascha Roloff
2023-06-26man pages: unify emphasis of just commands for man and markdown viewersSascha Roloff
2023-06-23man pages: properly emphasize and quote arguments and other keywords in man ↵Sascha Roloff
pages In order to consistently emphasize arguments and other keywords in man page as well as markdown viewers, they should be wrapped in single asterisks and single backticks like *`<argument>`*.
2023-06-23man pages: properly emphasize and quote options in man pagesSascha Roloff
In order to consistently emphasize options in man page as well as markdown viewers, they should be wrapped in double asterisks and single backticks like **`<option>`**.
2023-06-20man pages: add more cross referencesKlaus Aehlig
2023-06-20man pages: properly quote optionsKlaus Aehlig
... in order to preserve the minus signs.
2023-06-01man: Minor format and consistency improvementsOliver Reiche
2023-06-01man: Convert man pages to markdownOliver Reiche
... for easy processing with pandoc.