From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: Missing `Specific Header Arguments' in Manual Date: Wed, 02 May 2018 14:47:21 +0200 Message-ID: <87a7tifcme.fsf@nicolasgoaziou.fr> References: <8D4BA262-9F3F-412B-8DF1-5F6A6E3E671C@ucsd.edu> <87o9hzf3mu.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:34316) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fDrAS-0006d9-0Q for emacs-orgmode@gnu.org; Wed, 02 May 2018 08:47:32 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fDrAN-0003Aa-3j for emacs-orgmode@gnu.org; Wed, 02 May 2018 08:47:32 -0400 Received: from relay10.mail.gandi.net ([217.70.178.230]:46455) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fDrAM-00039a-Se for emacs-orgmode@gnu.org; Wed, 02 May 2018 08:47:27 -0400 In-Reply-To: (Kaushal Modi's message of "Tue, 01 May 2018 22:10:48 +0000") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Kaushal Modi Cc: emacs-orgmode , "Berry, Charles" Hello, Kaushal Modi writes: > In the Org 9.1 version manual, it was possible to search ":eval" and find > what I was looking for. In 9.2 manual, very few of the header arguments are > documented with the colon prefix. I removed all colon prefixes, so it is a bug if any header argument is prefixed with a colon. > So searching is not consistent any more. Of course, it is. Now, you can search by topic. E.g., `eval' header argument belongs to "Limit Code block evaluation", which is a sub-topic of "Evaluation Code Blocks". This was clearly not possible before, because unrelated arguments were located in the same section. You can also search the index alphabetically. > I was able to do this earlier.. open Org Info manual, C-s :eval, keep on > C-s as it found *all hits* in the manual. Now in 9.2, the only hits are in > (org) Exporting Code Blocks, which is not very useful. C-s is a poor way to navigate through an Info document. I'd rather improve the index than make it easier to use C-s. > Can we prefix all the header arg references in the manual with ":" so > that while searching, I can easily find the (org) Evaluating Code > Blocks node? This is a false good idea, because many index entries would have the same prefix. Besides, many syntactic elements start with colons: properties, tags, drawers. OTOH, you can search for "header argument" in the main index, as you experienced. It is much more efficient. > I was having trouble finding this node as "eval" is too generic of a string.. > thankfully I remembered the "never-export" value, searched for that and > found that node. See above. Regards, -- Nicolas Goaziou