From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jorge Morais Neto Subject: Re: Bug: second batch of small documentation problems [9.0 (9.0-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/)] Date: Mon, 7 Nov 2016 08:57:59 -0200 Message-ID: References: <87twbkkunk.fsf@nicolasgoaziou.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]:37201) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c3hcn-00070A-HW for emacs-orgmode@gnu.org; Mon, 07 Nov 2016 05:58:07 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c3hcm-0007oJ-HM for emacs-orgmode@gnu.org; Mon, 07 Nov 2016 05:58:01 -0500 Received: from mail-qt0-x22d.google.com ([2607:f8b0:400d:c0d::22d]:34238) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1c3hcm-0007o7-DQ for emacs-orgmode@gnu.org; Mon, 07 Nov 2016 05:58:00 -0500 Received: by mail-qt0-x22d.google.com with SMTP id n6so84643292qtd.1 for ; Mon, 07 Nov 2016 02:58:00 -0800 (PST) In-Reply-To: <87twbkkunk.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: Jorge Morais Neto , org mode I have some observations about your fixes: 1. Tag keys (for fast selection) 1) When clarifying that tag keys are case-sensitive letters, we forgot to adjust org-tag-persistent-alist=E2=80=99s docstring. Please adjust it. 2) And now that I think of it, is it appropriate to write "a-zA-Z" in [[info:org#Setting tags]]? Are only these characters allowed and no others? 2. Your changes to [[info:org#The very busy C-c C-c key]]: #+BEGIN_QUOTE -If the current buffer is a capture buffer, close the note and file it. -With a prefix argument, file it, without further interaction, to the -default location. +If the current buffer is a capture buffer, close the note and file it. = With +a prefix argument, jump to the target location, without capturing anyth= ing. #+END_QUOTE The last added sentence seems to actually describe "C-u C-c c" instead o= f "C-u C-c C-c". 3. The new docstring of org-startup-folded #+BEGIN_QUOTE Set `org-agenda-inhibit-startup' to a non-nil value so as to ignore this option when Org opens agenda files for the first time. #+END_QUOTE The way that excerpt is written, it seems to me that it actively recomme= nds setting org-agenda-inhibit-startup to a non-nil value. We could replace= "so as to" =E2=86=92 "if you want to". But maybe this is me misunderstandin= g English =E2=80=93 my second language =E2=80=93 or just being pedantic, I don=E2=80=99t kno= w. And thank you very much for helping Org! When the Brazilian real gains a l= ittle more value, I intend to make a donation. And when I become less overloaded= , I intend to study Emacs Lisp and start writing some patches. Regards. --=20 =E2=80=A2 I am Brazilian. I hope my English is correct and I welcome corre= ctions. =E2=80=A2 Please adopt free formats like PDF, ODF, Org, LaTeX, Opus, WebM a= nd 7z. =E2=80=A2 Free (as in free speech) software for Android: https://f-droid.or= g/