From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 19799 invoked by alias); 20 Nov 2012 03:48:12 -0000 Mailing-List: contact zsh-users-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Users List List-Post: List-Help: X-Seq: 17420 Received: (qmail 10880 invoked from network); 20 Nov 2012 03:48:10 -0000 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.2 Received-SPF: none (ns1.primenet.com.au: domain at closedmail.com does not designate permitted sender hosts) From: Bart Schaefer Message-id: <121119194806.ZM4576@torch.brasslantern.com> Date: Mon, 19 Nov 2012 19:48:06 -0800 In-reply-to: Comments: In reply to zzapper "Re: cd - not expanding to dirs" (Nov 19, 10:05pm) References: <121119133528.ZM4445@torch.brasslantern.com> X-Mailer: OpenZMail Classic (0.9.2 24April2005) To: zsh-users@zsh.org Subject: Re: cd - not expanding to dirs MIME-version: 1.0 Content-type: text/plain; charset=us-ascii On Nov 19, 10:05pm, zzapper wrote: } } But how should I have known that "cd -" depended on [compinit] ? Osmosis? More seriously, attempting to answer this question (and similar ones about how to introduce novice users to the zsh feature set) is what led to the creation of the zsh/newuser module and zsh-newuser-install function. Ideally the first time you ran the shell you should have been prompted by the newuser subsystem to initialize completion and various other setup. If you aren't the first root user, or the OS packager includes a default setup for root, then you miss out on this. } How should I have approached searching the doc? In this case it's less how you should have approached searching it than how you should have approached browsing it. The third section of the documentation is entitled "Roadmap". There is a subsection therein called "Completion". The second paragraph of that section says: Zsh has two completion systems, an old, so called compctl completion (named after the builtin command that serves as its complete and only user interface), and a new one, referred to as compsys, organized as library of builtin and user-defined functions. The two systems differ in their interface for specifying the completion behavior. The new system is more customizable and is supplied with completions for many commonly used commands; it is therefore to be preferred. The completion system must be enabled explicitly when the shell starts. For more information see Completion System. Those last two words are a link to the twentieth (!) section, which rambles a bit about contexts and styles and dispatchers, and then moves on with a section "Initialization" which explains compinit.