From mboxrd@z Thu Jan 1 00:00:00 1970 From: Alain.Cochard@unistra.fr Subject: Re: Should org-complete-tags-always-offer-all-agenda-tags be documented in the manual? [was: Tag completion does not work well with ...] Date: Thu, 17 May 2018 13:17:19 +0200 Message-ID: <23293.25791.381801.813233@frac.u-strasbg.fr> References: <23292.16161.349325.297641@frac.u-strasbg.fr> <877eo3tl5o.fsf@nicolasgoaziou.fr> Reply-To: alain.cochard@unistra.fr Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:38026) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fJGue-0006S9-Ne for emacs-orgmode@gnu.org; Thu, 17 May 2018 07:17:38 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fJGua-0004la-Ed for emacs-orgmode@gnu.org; Thu, 17 May 2018 07:17:36 -0400 Received: from smr2.u-strasbg.fr ([130.79.222.218]:38236 helo=mailhost.u-strasbg.fr) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fJGua-0004j0-6e for emacs-orgmode@gnu.org; Thu, 17 May 2018 07:17:32 -0400 In-Reply-To: <877eo3tl5o.fsf@nicolasgoaziou.fr> 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: Nicolas Goaziou Cc: emacs-orgmode@gnu.org Nicolas Goaziou writes on Wed 16 May 2018 22:12: > > Consider this excerpt from section "6.2 Setting tags": > > > > Org supports tag insertion based on a =5Flist of tags=5F. B= y > > default this list is constructed dynamically, containing all ta= gs > > currently used in the buffer. You may also globally specify a = hard > > list of tags with the variable =E2=80=98org-tag-alist=E2=80=99.= Finally you can > > set the default tags for a given file [...] > > > > One could have a footnote after "currently used in the buffer" whi= ch > > could be something like: > > > > One can have this list contain all tags used in all agenda file= s > > (see [[link to section "6.4 Tag searches"]]) by customizing > > variable org-complete-tags-always-offer-all-agenda-tags. > [...] why is the link to section "Tag searches" on topic here=3F My reasoning was that, at section "6.2" and upon sequential reading, the user does not really know what agenda files are yet. I was hoping that the excerpt: =E2=80=98C-c a m (org-tags-view)=E2=80=99 Create a global list of tag matches from all agenda files. =09 *Note Matching tags and properties::. could him to get acquainted with the concept. In fact I hesitated between this link and, as is sometimes done in similar cases, the link to "10 Agenda views"[fn:1], but which I found too general. But perhaps it is not pertinent to assume sequential reading. Or perhaps (a digest of) "10 Agenda views" should appear earlier in the manual. Regards, alain [fn:1] e.g., in "5.1 Basic TODO functionality": =E2=80=98C-c a t (org-todo-list)=E2=80=99 Show the global TODO list. Collects the TODO items (with not-DONE= states) from all agenda files (*note Agenda views::) into a single= buffer. --=20 EOST (=C3=89cole et Observatoire des Sciences de la Terre)=20 IPG (Institut de Physique du Globe) | alain.cochard@unistra.fr 5 rue Ren=C3=A9 Descartes [bureau 106] | Phone: +33 (0)3 68 85 50 44=20= F-67084 Strasbourg Cedex, France | Fax: +33 (0)3 68 85 01 25 =20=