From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: Bug: second batch of small documentation problems [9.0 (9.0-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/)] Date: Sat, 12 Nov 2016 01:47:36 +0100 Message-ID: <8760nted7b.fsf@nicolasgoaziou.fr> 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]:46783) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c5MTr-00072g-D5 for emacs-orgmode@gnu.org; Fri, 11 Nov 2016 19:47:40 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c5MTn-0007T4-GX for emacs-orgmode@gnu.org; Fri, 11 Nov 2016 19:47:39 -0500 Received: from relay4-d.mail.gandi.net ([217.70.183.196]:37406) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1c5MTn-0007Rr-9p for emacs-orgmode@gnu.org; Fri, 11 Nov 2016 19:47:35 -0500 In-Reply-To: (Jorge Morais Neto's message of "Mon, 7 Nov 2016 08:57:59 -0200") 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 Cc: org mode Hello, Jorge Morais Neto writes: > 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. `org-tag-persistent-alist' is about "characters". I think it is clear that characters are case-sensitive already. > 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? AFAICT any character is allow, but how could we formulate this?. > > 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 any= thing. > #+END_QUOTE > > The last added sentence seems to actually describe "C-u C-c c" instead= of > "C-u C-c C-c". Fixed. > 3. The new docstring of org-startup-folded > > #+BEGIN_QUOTE > Set `org-agenda-inhibit-startup' to a non-nil value so as to ignore th= is > 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 recom= mends > setting org-agenda-inhibit-startup to a non-nil value. We could repla= ce "so > as to" =E2=86=92 "if you want to". But maybe this is me misunderstand= ing English =E2=80=93 > my second language =E2=80=93 or just being pedantic, I don=E2=80=99t k= now. Done. Thank you. Regards, --=20 Nicolas Goaziou