From mboxrd@z Thu Jan 1 00:00:00 1970 From: Scott Randby Subject: Re: Stable releases Date: Wed, 12 Aug 2015 11:57:28 -0400 Message-ID: <55CB6CE8.7040102@gmail.com> References: <55CA2E6B.4060102@gmail.com> <87zj1w62yk.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:39188) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZPYPH-0005zR-FA for emacs-orgmode@gnu.org; Wed, 12 Aug 2015 11:57:37 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZPYPD-0000cY-EB for emacs-orgmode@gnu.org; Wed, 12 Aug 2015 11:57:35 -0400 Received: from mail-ig0-x229.google.com ([2607:f8b0:4001:c05::229]:35615) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZPYPD-0000bb-4s for emacs-orgmode@gnu.org; Wed, 12 Aug 2015 11:57:31 -0400 Received: by igbjg10 with SMTP id jg10so45833315igb.0 for ; Wed, 12 Aug 2015 08:57:29 -0700 (PDT) Received: from [192.168.1.109] (cpe-184-56-99-2.neo.res.rr.com. [184.56.99.2]) by smtp.gmail.com with ESMTPSA id 32sm22650ioq.17.2015.08.12.08.57.28 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 12 Aug 2015 08:57:29 -0700 (PDT) In-Reply-To: <87zj1w62yk.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-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-org list On 08/12/2015 09:39 AM, Nicolas Goaziou wrote: > Hello, > > Scott Randby writes: > >> When I started using 8.3, I discovered that the behavior of commented >> headlines had been changed---a change with which I disagree, a change >> I could not find in the release notes, and one which forces me to >> alter a huge number of files. It seems I missed the discussion about >> commented headlines on the mailing list. This is due to my limited >> knowledge of elisp and programming in general, a gap which makes it >> difficult for me to follow the more technical discussions on the >> mailing list. While it has been explained to me that the change is >> a feature, I consider it to be a serious bug since it is not backwards >> compatible. > > I think this change is good. COMMENT status of headlines was muddy > before. The only information about them was the following excerpt (from > Org 8.2.9's manual) > > Also entire subtrees starting with the word ‘COMMENT’ will never be > exported. > > which can mean many things. You extrapolated this definition to one of > its possible meanings, but your definition, AFAIU, was :noexport: > tags's. > > Now there is a clearer definition of a COMMENT headline, and a clear > distinction between COMMENT and :noexport:. > > Note that you don't have to alter any of your files. The following > function can do it for you on the fly, before each export. You can also > used it to effectively alter your files automatically for you. > > (defun my-comment-to-noexport (backend) > (interactive) > (goto-char (point-min)) > (while (re-search-forward "^\\*+.*\\( COMMENT\\)" nil t) > (when (save-match-data (org-in-commented-heading-p t)) > (replace-match "" nil nil nil 1) > (org-set-tags-to (cons "noexport" (org-get-tags)))))) > > (add-hook 'org-export-before-processing-hook #'my-comment-to-noexport) This function won't work for me because I use COMMENT in two different ways. I didn't extrapolate the meaning of COMMENT, I copied its various uses from files that other people have posted in various places. It is more flexible for COMMENT to mean various things than it is for it to be pigeonholed to one narrow function. COMMENT wasn't broken until 8.3. > > I admit it could have been notified in ORG-NEWS. > >> Another issue I had with 8.3 is the deletion of the >> org-latex-with-hyperref variable, something I could not find in the >> release notes (maybe I missed it). I understand that having Org insert >> \hypersetup{...} details is the most desirable situation, but I fail >> to see the harm in keeping org-latex-with-hyperref for those of us who >> needed it in the past. Yes, I figured out a fix, but this is a fix >> that forces me to stick with an outmoded way of doing things, and so >> I consider this deletion to be a bug. > > I'm not sure to understand. What is wrong with setting > `org-latex-hyperref-template' to the empty string? I don't understand what is wrong with keeping org-latex-with-hyperref. It is easy enough for me to set the variable locally for old files while I can use the default \hypersetup{...} for new files. Making org-latex-hyperref-template an empty string means I cannot use the built-in default template. > > This change was introduced in Feb 2014. It is a step forward since we > move from an opt-in/opt-out to a full customizable template. I'm not sure why I didn't notice a problem before 8.3. Perhaps it is due to my irregular updating. > > I overlooked the fact that this replacement wasn't signaled in ORG-NEWS, > tho. I will try to be more careful for next release. > >> I do understand that all software has bugs, and that everyone working >> on Org is doing so voluntarily (thank you so much for your wonderful >> work). But I was very surprised to find that the evaluation of table >> formulas didn't work in 8.3.1. I could see something like this >> happening in the development version, but it is somewhat mysterious to >> me how such a bug could make its way into a stable release. > > I introduced these changes a short time (three days) before release. > I made an announcement[fn:1] in order to warn there could be some > hiccups in that area. It may be obnoxious for you, but no bug was > reported before release. I don't consider the bug to be obnoxious, I'm just trying to understand what is meant by a stable release. > > Another example is the recent columns view bug report[fn:2]. The faulty > commit was pushed 2 months ago. Yet no one during development phase > complained about column view being broken. Even a feature freeze period > wouldn't have helped in that case. > > You can't really avoid small glitches after a release. Yes, I understand. > >> I guess what I want to know, and maybe there is no answer, is how long >> should I wait before upgrading to a stable release? Org is by far the >> most important piece of software I use (I hate it when I can't use >> Org), and bugs (which I know can't be avoided) make it hard, even >> impossible, for me to get my real work done. If there is a way for me >> to minimize encountering bugs, I will appreciate a description of that >> way. > > I suggest to only do regularly minor updates (e.g. 8.3.1 -> 8.3.2). For > major updates, make sure you have some time to spare for bug reporting. > I think we are usually pretty responsive when it comes to bugs. I've been extremely happy with the quick response to bug reports. > > > Regards, > > [fn:1] > > [fn:2] >