docs: document that default log revset is only used when neither path…

… nor revset is specified
jj-vcs · Apr 1, 2024 · 54d954c · 54d954c
1 parent 06e2fae
commit 54d954c
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 3 deletions.
diff --git a/cli/src/commands/log.rs b/cli/src/commands/log.rs
@@ -38,8 +38,9 @@ use crate::ui::Ui;
 /// rendered as a synthetic node labeled "(elided revisions)".
 #[derive(clap::Args, Clone, Debug)]
 pub(crate) struct LogArgs {
-    /// Which revisions to show. Defaults to the `revsets.log` setting, or
-    /// `@ | ancestors(immutable_heads().., 2) | trunk()` if it is not set.
+    /// Which revisions to show. If no paths are specified, this defaults to the
+    /// `revsets.log` setting, or `@ | ancestors(immutable_heads().., 2) |
+    /// trunk()` if it is not set.
     #[arg(long, short)]
     revisions: Vec<RevisionArg>,
     /// Show revisions modifying the given paths

diff --git a/docs/config.md b/docs/config.md
@@ -215,7 +215,7 @@ immutable even if the set is empty.
 
 ### Default revisions to log
 
-You can configure the revisions `jj log` without `-r` should show.
+You can configure the revisions `jj log` without `-r` or any specified paths should show.
 
 ```toml
 # Show commits that are not in `main@origin`