[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Extend Outline mode with default visibility state
From: |
Eli Zaretskii |
Subject: |
Re: Extend Outline mode with default visibility state |
Date: |
Sun, 16 Jan 2022 21:21:01 +0200 |
> Date: Sun, 16 Jan 2022 20:42:07 +0200
> From: Eli Zaretskii <eliz@gnu.org>
> Cc: emacs-devel@gnu.org
>
> The doc string of outline-default-rules also "Needs Work":
>
> (defcustom outline-default-rules nil
> "Determines visibility of subtree starting at `outline-default-state'
> level.
>
> If this is only relevant to a single value of outline-default-state,
> the doc string should say so.
>
> - A lambda function or function name which will be evaluated with
> point at the beginning of the heading and the match data set
> appropriately, the function being expected to toggle the
> heading visibility."
>
> This should tell what arguments, if any, the function is called.
> Also, "function ... will be evaluated" is not our style.
In addition, the "A lambda function or function name" part seems to be
incorrect: it should be a cons cell of the form
(custom-function FUNCTION)
Right?