From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: Beginners guide to Org customization Date: Thu, 5 Feb 2009 15:34:33 +0100 Message-ID: <18C7F5EB-B251-4F91-9406-654FBF305D8B@uva.nl> References: <33DFD2BB-A6FC-43AE-9DE0-5E5DE0802F4A@uva.nl> <87fxitotfy.fsf@gollum.intra.norang.ca> Mime-Version: 1.0 (Apple Message framework v930.3) Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LV5JR-0000n6-Iv for emacs-orgmode@gnu.org; Thu, 05 Feb 2009 09:34:41 -0500 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LV5JQ-0000l8-J0 for emacs-orgmode@gnu.org; Thu, 05 Feb 2009 09:34:41 -0500 Received: from [199.232.76.173] (port=50639 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LV5JQ-0000ko-CV for emacs-orgmode@gnu.org; Thu, 05 Feb 2009 09:34:40 -0500 Received: from ug-out-1314.google.com ([66.249.92.172]:35951) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1LV5JP-0006Ry-T5 for emacs-orgmode@gnu.org; Thu, 05 Feb 2009 09:34:40 -0500 Received: by ug-out-1314.google.com with SMTP id b39so232548ugd.17 for ; Thu, 05 Feb 2009 06:34:38 -0800 (PST) In-Reply-To: <87fxitotfy.fsf@gollum.intra.norang.ca> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Bernt Hansen Cc: emacs-orgmode Mailinglist Hi Bernt, good suggestions, thanks. The list I made closely adheres to the most frequently set variables. But I think you are right, we should be more restrictive here. I will do what you suggest. I think I will even remove the entire clock section, for example, and instead add documentation about clock persistence to the manual (actually, I just did that). - Carsten On Feb 5, 2009, at 3:21 PM, Bernt Hansen wrote: > Carsten Dominik writes: > >> I have made a structured list of 43 (which one can >> we remove, please????) Variables that came in as frequently >> customized variables in the customization survey. It is not >> exactly the top 43, I have used some additional judgement. > > I think a lot of these variables are things you play with _after_ > using > org-mode for awhile. Maybe the following variables should be > introduced > later? > > - org-archive-location > > the default works, and you don't archive anytime soon after > starting > to use org-mode. > > - org-startup-folded > > start with #STARTUP first? > > - org-odd-levels-only > > Talk about the conversion functions too (org-convert-to-odd-levels > and org-convert-to-oddeven-levels.) I switched my files back and > forth a few times but ended up with oddeven levels due to the depth > of some of my tasks. > > - org-special-ctrl-a/e > - org-special-ctrl-k > > I should maybe try these one day :) > > I've used org-mode for a few years now and I don't currently use these > variables. They're great to have but not essential to getting started. > > The default values for the variables work in most cases. I think the > ones that should be listed first are the ones you really have to > customize to get org-mode to work for you. Beginners will not want > nor > need this amount of detail to be productive with org-mode. Having too > many variables to set up or play with up front may just scare people > away. > > Maybe we just need to stress that customizations are optional and you > can completely ignore entire sections that don't apply to you > (clocking, > exporting, etc.) until you feel you need these additional features. > > HTH, > Bernt