emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: John Hendy <jw.hendy@gmail.com>
To: Ihor Radchenko <yantar92@gmail.com>
Cc: emacs-orgmode <emacs-orgmode@gnu.org>
Subject: Re: Clarification on org-startup-fold behavior vs. docs
Date: Tue, 19 Oct 2021 13:23:30 -0500	[thread overview]
Message-ID: <CA+M2ft9ywp45rs+6OjgC-NALJ4wPt3XTj8SVw+GOM-iVA=uRKw@mail.gmail.com> (raw)
In-Reply-To: <87wnm8gbyb.fsf@localhost>

On Tue, Oct 19, 2021 at 12:28 PM Ihor Radchenko <yantar92@gmail.com> wrote:
>
> John Hendy <jw.hendy@gmail.com> writes:
> The value should be a symbol, not a string:
>
> (setq org-startup-folded 'overview)
>
> customise interface even tries to warn you that something is wrong:
>
> > In addition, M-x customize-variable for org-startup-folded says:
> >
> > #+begin_quote
> > org-startup-folded: "overview"
> >     State : CHANGED outside Customize. (mismatch) <--- this is a clue
> >    Non-nil means entering Org mode will switch to OVERVIEW. Hide

Thanks, this is helpful. I would, then, chalk this up to my ignorance
on emacs variables and such. This note also appeared when I was using
emacs -Q and it said I couldn't change it because I might have started
with -q, so I thought the "mismatch" might have just been some
artifact of that. I didn't know what "mismatch" meant and suspected it
might merely mean that I'd set this in a config, not with M-x
customize-variable.

> If you select the value from customise interface, Emacs would set it
> correctly.  Direct setting is indeed possible, but you need to consult
> how the variable is defined.  Note the :type specifier below (also, see
> 15.4 Customization Types section of Elisp manual).

This is a good reminder and I've done this before (see what it does to
my config custom variable section, then replicate directly). I didn't
think to do it this time.

My remaining question is why anything except nil (string or not) isn't
non-nil? Like I get that to set a specific setting, you'd need to
match a defined variable... but is it the case that non-parseable
types (expected var, got string) evaluates to nil?

I think the docs still throw me off. Note that showeverthing in the
lead up to the options is fontified as a variable (no backticks), but
below they are all backticked. I actually thought those were all
quoted, only realizing now they are [probably] backticks. I didn't
expect  both fixed width (which my brain reads as "code/variable")
*and* backticks on top.
https://orgmode.org/manual/In_002dbuffer-Settings.html

Actually, now I'm realizing these backticks go in the opposite slant
as what I'm used to? Or are they really single quotes, indeed?


Thanks again,
John
>
> Best,
> Ihor


      reply	other threads:[~2021-10-19 18:25 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-10-19 16:58 Clarification on org-startup-fold behavior vs. docs John Hendy
2021-10-19 17:29 ` Ihor Radchenko
2021-10-19 18:23   ` John Hendy [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='CA+M2ft9ywp45rs+6OjgC-NALJ4wPt3XTj8SVw+GOM-iVA=uRKw@mail.gmail.com' \
    --to=jw.hendy@gmail.com \
    --cc=emacs-orgmode@gnu.org \
    --cc=yantar92@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).