From 8ed63d63a4ac35ca8046615a06992fb6b7a0dbb1 Mon Sep 17 00:00:00 2001 From: Kurtis Rader Date: Thu, 25 May 2017 21:11:51 -0700 Subject: [PATCH] note in the tutorial the vars that are auto split Users continue to be surprised that fish auto splits/joins three env vars but not other similar vars. Mention this in the tutorial to make it less likely new users are surprised by this behavior. Fixes #4009 (cherry picked from commit 6f6d3ce520f81db2be2bd2df8dd76caabd5de90b) --- doc_src/tutorial.hdr | 2 ++ 1 file changed, 2 insertions(+) diff --git a/doc_src/tutorial.hdr b/doc_src/tutorial.hdr index 5cfabdd60..034a5035b 100644 --- a/doc_src/tutorial.hdr +++ b/doc_src/tutorial.hdr @@ -300,6 +300,8 @@ Other variables, like `$PATH`, really do have multiple values. During variable e /usr/bin /bin /usr/sbin /sbin /usr/local/bin \endfish +Note that there are three environment variables that are automatically split on colons to become lists when fish starts running: `PATH`, `CDPATH`, `MANPATH`. Conversely, they are joined on colons when exported to subcommands. All other environment variables (e.g., `LD_LIBRARY_PATH`) which have similar semantics are treated as simple strings. + Lists cannot contain other lists: there is no recursion. A variable is a list of strings, full stop. Get the length of a list with `count`: