Hi, 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. Comment are welcome. http://orgmode.org/worg/org-customization-guide.php - Carsten
Carsten,
I can see that org-clock-persistence-insinuate appeared in 6.11 but I
can't find it in the manual. Does it need to be added?
Regards
David Lord
2009/2/5 Carsten Dominik <dominik@science.uva.nl>:
> Hi,
>
> 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.
>
> Comment are welcome.
>
> http://orgmode.org/worg/org-customization-guide.php
>
>
> - Carsten
Yes, you are right.
This is done.
- Carsten
On Feb 5, 2009, at 2:25 PM, David Lord wrote:
> Carsten,
>
> I can see that org-clock-persistence-insinuate appeared in 6.11 but I
> can't find it in the manual. Does it need to be added?
>
> Regards
> David Lord
>
> 2009/2/5 Carsten Dominik <dominik@science.uva.nl>:
>> Hi,
>>
>> 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.
>>
>> Comment are welcome.
>>
>> http://orgmode.org/worg/org-customization-guide.php
>>
>>
>> - Carsten
Carsten Dominik <dominik@science.uva.nl> 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
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 <dominik@science.uva.nl> 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
I have my home^h^h^h^h trainwork up as a new attempt for the "Beginners Guide". A lot more appropriate now, I think. Bernt? - Carsten http://orgmode.org/worg/org-customization-guide.php On Feb 5, 2009, at 3:21 PM, Bernt Hansen wrote: > Carsten Dominik <dominik@science.uva.nl> 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
Carsten,
That looks really good! (except for the FIXME at the bottom ;) )
I really like this version :)
I haven't verified that the setup steps you described actually work.
Somebody(tm) should probably do that with a minimal emacs setup.
I also haven't verified all the links referenced in the document go to
appropriate places.
Hmmm my setup doesn't have (org-remember-insinuate) (well it does
now!) -- I wonder what breaks if that is missing.
-Bernt
Carsten Dominik <dominik@science.uva.nl> writes:
> I have my home^h^h^h^h trainwork up as a new
> attempt for the "Beginners Guide".
> A lot more appropriate now, I think. Bernt?
>
> - Carsten
>
> http://orgmode.org/worg/org-customization-guide.php
>
>
> On Feb 5, 2009, at 3:21 PM, Bernt Hansen wrote:
>
>> Carsten Dominik <dominik@science.uva.nl> 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
Carsten,
Wearing my beginner to Emacs and Orgmode, this looks really useful.
Graham
2009/2/5 Carsten Dominik <dominik@science.uva.nl>:
> I have my home^h^h^h^h trainwork up as a new
> attempt for the "Beginners Guide".
> A lot more appropriate now, I think. Bernt?
>
> - Carsten
>
> http://orgmode.org/worg/org-customization-guide.php
>
>
> On Feb 5, 2009, at 3:21 PM, Bernt Hansen wrote:
>
>> Carsten Dominik <dominik@science.uva.nl> 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
>
>
>
> _______________________________________________
> Emacs-orgmode mailing list
> Remember: use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
>
On Feb 5, 2009, at 7:01 PM, Bernt Hansen wrote: > Carsten, > > That looks really good! (except for the FIXME at the bottom ;) ) > > I really like this version :) > > I haven't verified that the setup steps you described actually work. > Somebody(tm) should probably do that with a minimal emacs setup. > > I also haven't verified all the links referenced in the document go to > appropriate places. > > Hmmm my setup doesn't have (org-remember-insinuate) (well it does > now!) -- I wonder what breaks if that is missing. org-remember-insinuate is simply a shortcut for the old setup where you had to add functions to hooks yourself. The definition of it is: (defun org-remember-insinuate () "Setup remember.el for use with Org-mode." (org-require-remember) (setq remember-annotation-functions '(org-remember-annotation)) (setq remember-handler-functions '(org-remember-handler)) (add-hook 'remember-mode-hook 'org-remember-apply-template)) It actually does one more thing: If remember.el is not found, it defines a miniature, just functional version of it. - Carsten > > > -Bernt > > Carsten Dominik <dominik@science.uva.nl> writes: > >> I have my home^h^h^h^h trainwork up as a new >> attempt for the "Beginners Guide". >> A lot more appropriate now, I think. Bernt? >> >> - Carsten >> >> http://orgmode.org/worg/org-customization-guide.php >> >> >> On Feb 5, 2009, at 3:21 PM, Bernt Hansen wrote: >> >>> Carsten Dominik <dominik@science.uva.nl> 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
The idea of helping to ease org customizations is good and will reduce the barrier to entry to new persons. But it seems that 40 is too large for the new user and too small for the power user. Instead if we split up org usage into some broad categories, the relevant customizations for that would be less bulky and so more accessible. Here is a tentative list of categories with some example customizations * Web publishing #+AUTHOR #+OPTIONS : toc:nil * Latex publishing * Brainstorming (setq org-odd-levels-only t) (setq org-hide-leading-stars t) * My-own-private hyperlink system (define-key global-map "\C-cr" 'org-remember) (define-key global-map "\C-cl" 'org-store-link) * Time/project mgmt *** Agenda-ing *** Time tracking *** GTD-ing *** Journalling * Tables and spreadsheets